# REST：アーティファクトとリポジトリ

> REST：アーティファクトとリポジトリ - APIリファレンスへのリンクを含む、アーティファクトのHTTPサーフェス。

This Markdown file sits beside the HTML page at the same path (with a `.md` suffix). It summarizes the topic and lists links for tools and LLM context.

Companion generated at `2026-09-02T14:28:12.969026+00:00` (UTC).

## Primary page

- [REST：アーティファクトとリポジトリ](https://docs.datarobot.com/ja/docs/workload-api/build-artifacts/artifacts-rest-endpoints.html.md): Full documentation for this topic (Markdown sidecar).

## Sections on this page

- [アーティファクト](https://docs.datarobot.com/ja/docs/workload-api/build-artifacts/artifacts-rest-endpoints.html.md#artifacts): In-page section heading.
- [イメージビルド](https://docs.datarobot.com/ja/docs/workload-api/build-artifacts/artifacts-rest-endpoints.html.md#image-builds): In-page section heading.
- [アーティファクトの共有](https://docs.datarobot.com/ja/docs/workload-api/build-artifacts/artifacts-rest-endpoints.html.md#artifact-sharing): In-page section heading.
- [アーティファクトリポジトリ](https://docs.datarobot.com/ja/docs/workload-api/build-artifacts/artifacts-rest-endpoints.html.md#artifact-repositories): In-page section heading.

## Documentation content

これらのパスは、 [APIリファレンス](https://docs.datarobot.com/ja/docs/workload-api/get-started-workloads/api-quick-reference.html.md) の認証およびモデルとともに使用します。 完全なスキーマおよびパラメーターのリファレンスについては、 [Workload APIリファレンス](https://docs.datarobot.com/ja/docs/api/reference/public-api/tag-workloads.html.md) を参照してください。

## アーティファクト

これらのエンドポイントは、アーティファクトを作成、読み取り、更新、クローン、および削除します。

| 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` を設定してアーティファクトを初めて作成する際に、プラットフォームは自動的にリポジトリを作成します。