컨테이너 이미지 액세스 제어

이미지를 pull하고 push할 수 있는 권한은 저장소의 가시성과 조직 내 각 멤버의 역할에 따라 결정됩니다. 공개 이미지는 누구나 pull할 수 있고, 비공개 이미지는 멤버만 pull할 수 있으며, push하려면 write 역할이 필요합니다. 토큰도 동일한 규칙을 따릅니다. read가 있는 User Access Token은 pull하고, write가 있는 토큰은 push합니다.

리소스 그룹을 통한 액세스 제어

Team 또는 Enterprise 플랜의 조직에서 이미지는 Resource Group에 속할 수 있습니다. 이 경우 그룹 내 멤버의 역할이 해당 이미지에 대해 조직 역할을 대체하며, read는 pull, write는 push 권한을 부여합니다. Resource Group의 비공개 이미지는 그룹 멤버와 조직 관리자만 pull할 수 있습니다.

리포지토리를 생성할 때, 이미지의 설정에서, 또는 그룹의 Resources 탭에서 그룹을 선택합니다. API를 사용하는 경우, 리포지토리를 생성할 때 resourceGroupId를 전달하거나 기존 리포지토리를 이동합니다(그룹의 ID는 해당 페이지 URL의 끝부분에 있으며, GET /api/organizations/my-org/resource-groups으로 목록을 조회할 수 있습니다):

curl -X POST https://huggingface.co/api/containers/my-org/my-app/resource-group \
  -H "Authorization: Bearer $HF_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"resourceGroupId": "<resource-group-id>"}'