コンテナイメージのアクセス制御

イメージのプルとプッシュが可能なユーザーは、リポジトリの公開設定と組織内での各メンバーのロールによって決まります。公開イメージは誰でもプルできますが、非公開イメージはメンバーのみがプルでき、プッシュにはwriteロールが必要です。トークンも同じルールが適用されます。readを持つUser Access Tokenはプルに、writeを持つものはプッシュに使用できます。

リソースグループによるアクセス制御

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>"}'