REST：アーティファクトとリポジトリ¶
これらのパスは、APIリファレンスの認証およびモデルとともに使用します。 完全なスキーマおよびパラメーターのリファレンスについては、Workload APIリファレンスを参照してください。
アーティファクト¶
これらのエンドポイントは、アーティファクトを作成、読み取り、更新、クローン、および削除します。
| Verb | パス | 説明 |
|---|---|---|
GET |
/artifacts |
アーティファクトを一覧表示します。 type、status、repositoryId、tagKeys、tagValues、createdBy、search、idsでフィルタリングします。 orderBy（name、createdAt、updatedAt、status、降順の場合はプレフィックス-を使用）で並べ替えます。 |
POST |
/artifacts |
draftステータスで新しいアーティファクトを作成します。 本文でartifactRepositoryIdを設定してリポジトリに追加します（リポジトリが存在しない場合、プラットフォームは自動的に作成します）。 |
GET |
/artifacts/{artifact_id} |
単一のアーティファクトを取得します。 |
PUT |
/artifacts/{artifact_id} |
すべてのアーティファクトフィールドを置き換えます。 |
PATCH |
/artifacts/{artifact_id} |
部分的な更新を行います。 アーティファクトをロックするために使用します：{"status": "locked"}。 |
DELETE |
/artifacts/{artifact_id} |
アーティファクトを削除します。 アーティファクトがロックされているか、Workloadによって使用されている場合は409を返します。 |
POST |
/artifacts/{artifact_id}/clone |
既存のアーティファクトのクローンを新しいドラフトとして作成します。 本文：{"name": "new-artifact-name"}。 |
イメージビルド¶
これらのエンドポイントは、あらかじめ構築済みのimageUriの代わりにimageBuildConfigを使用するアーティファクトのコンテナイメージビルドを管理します。
| Verb | パス | 説明 |
|---|---|---|
POST |
/artifacts/{artifact_id}/builds |
イメージビルドをトリガーします。 buildIdsを含むImageBuildTriggerResponseとともに202を返します。 |
GET |
/artifacts/{artifact_id}/builds |
アーティファクトのイメージビルドを一覧表示します。 |
GET |
/artifacts/{artifact_id}/builds/{build_id} |
特定のビルドのステータスと詳細を取得します。 |
GET |
/artifacts/{artifact_id}/builds/{build_id}/logs |
ビルドログ（プレーンテキスト）をストリーミングします。 |
DELETE |
/artifacts/{artifact_id}/builds/{build_id} |
ビルドをキャンセルまたは削除します。 |
アーティファクトの共有¶
これらのエンドポイントは、個々のアーティファクトに付与されたロールを一覧表示し、置き換えます。
| Verb | パス | 説明 |
|---|---|---|
GET |
/artifacts/{artifact_id}/sharedRoles |
アーティファクトに付与されたロールを一覧表示します。 |
PATCH |
/artifacts/{artifact_id}/sharedRoles |
アーティファクトのロールリストを置き換えます（最大100エントリー）。 |
アーティファクトリポジトリ¶
これらのエンドポイントは、アーティファクトのバージョンをグループ化し、共有アクセスを管理するリポジトリを管理します。
| Verb | パス | 説明 |
|---|---|---|
GET |
/artifactRepositories |
リポジトリを一覧表示します。 |
GET |
/artifactRepositories/{artifact_repository_id} |
リポジトリを取得します。 |
DELETE |
/artifactRepositories/{artifact_repository_id} |
リポジトリを削除します。 ロックされていない未使用のアーティファクトにカスケードします。それ以外の場合は409を返します。 |
GET |
/artifactRepositories/{artifact_repository_id}/sharedRoles |
リポジトリのロールを一覧表示します。 |
PATCH |
/artifactRepositories/{artifact_repository_id}/sharedRoles |
リポジトリのロールリストを置き換えます。 |
artifactRepositoryIdを設定してアーティファクトを初めて作成する際に、プラットフォームは自動的にリポジトリを作成します。