Arkvory

リポジトリ ​

呼び出し元が参照できるリポジトリと、個々のリポジトリの詳細。

このグループの操作と、それぞれのアクセスルール、再試行ルール、パラメーター、レスポンスです。すべてのリクエストにはキーを付けます：Authorization: Bearer <key>（「認証」を参照）。

操作 ​

アクセスできるリポジトリの一覧表示 ​

GET HEAD /api/v1/repositories

アクセス: 呼び出し元が参照できるリポジトリ（repository.read） · 再試行: 再試行しても安全（読み取り）

呼び出し元が権限を持つリポジトリを名前順に列挙します。各項目には、リポジトリの形式（upack、assets）と、そのリポジトリでの呼び出し元自身の権限が含まれます。マネージドサービスキーには、repository.readを持つリポジトリのみが表示されます。リポジトリは呼び出し元に付与された権限の範囲であり、サーバー全体のレジストリのエントリではありません。ページにはlimit件のカード（1〜100、既定は50）が含まれ、続きはafterにnextを設定して取得します。

パラメーター

名前場所型必須ルール
afterクエリstringいいえ^[a-z0-9][a-z0-9_-]{0,63}$に一致; Exclusive repository ID boundary; authorization is rechecked on every page.
limitクエリintegerいいえ1～100; 既定値：50

レスポンス 200

フィールド型必須ルール
itemsobjectの配列はい100個以内の要素
items[].idstringはい^[a-z0-9][a-z0-9_-]{0,63}$に一致
items[].formatsstringの配列はい2～2個の要素; 要素の重複なし; 各要素：次のいずれか：upack, assets
items[].permissionsstringの配列はい1～24個の要素; 要素の重複なし; 各要素：次のいずれか：repository.read, storage.read, storage.manage, diagnostics.read, artifact.read, artifact.list, artifact.delete, artifact.promote, content.read, upload.create, upload.read, upload.write, upload.complete, upload.cancel, job.read, package.read, package.publish, asset.read, asset.write, asset.restore, annotation.read, annotation.write, reference.write, audit.read
nextstringはい^[a-z0-9][a-z0-9_-]{0,63}$に一致; nullも可

レスポンス: 200, 400, 401, 403, 404, 409, 422, 503, 507

例

bash
curl -X GET "$ARKVORY_URL/api/v1/repositories" \
  -H "Authorization: Bearer $ARKVORY_TOKEN"

リポジトリカードの取得 ​

GET HEAD /api/v1/repositories/{repository}

アクセス: 呼び出し元が参照できるリポジトリ（repository.read） · 再試行: 再試行しても安全（読み取り）

1つのリポジトリについて、呼び出し元のカードを返します。カードには、そのリポジトリの形式と、呼び出し元の権限が含まれます。呼び出し元から見えないリポジトリは、存在しないリポジトリとまったく同じく404で応答します。HEADを使うと軽量なアクセス確認になります。リポジトリが見えることは、そのコンテンツや設定へのアクセス権を与えるものではありません。

パラメーター

名前場所型必須ルール
repositoryパスstringはい^[a-z0-9][a-z0-9_-]{0,63}$に一致

レスポンス 200

フィールド型必須ルール
idstringはい^[a-z0-9][a-z0-9_-]{0,63}$に一致
formatsstringの配列はい2～2個の要素; 要素の重複なし; 各要素：次のいずれか：upack, assets
permissionsstringの配列はい1～24個の要素; 要素の重複なし; 各要素：次のいずれか：repository.read, storage.read, storage.manage, diagnostics.read, artifact.read, artifact.list, artifact.delete, artifact.promote, content.read, upload.create, upload.read, upload.write, upload.complete, upload.cancel, job.read, package.read, package.publish, asset.read, asset.write, asset.restore, annotation.read, annotation.write, reference.write, audit.read

レスポンス: 200, 400, 401, 403, 404, 409, 422, 503, 507

例

bash
curl -X GET "$ARKVORY_URL/api/v1/repositories/$REPOSITORY" \
  -H "Authorization: Bearer $ARKVORY_TOKEN"

Arkvory · ProAnimaStudio