REST: Artifacts and repositories¶
Use these paths together with API reference authentication and models. For the full schema and parameter reference, see the Workloads API reference.
アーティファクト¶
These endpoints create, read, update, clone, and delete artifacts.
| Verb | パス | 説明 |
|---|---|---|
GET |
/artifacts |
List artifacts. Filter by type, status, repositoryId, tagKeys, tagValues, createdBy, search, ids. Sort with orderBy (name, createdAt, updatedAt, status; prefix - for descending). |
POST |
/artifacts |
Create a new artifact in draft status. Set artifactRepositoryId in the body to add it to a repository (the platform creates the repository automatically if it does not exist). |
GET |
/artifacts/{artifact_id} |
Get a single artifact. |
PUT |
/artifacts/{artifact_id} |
Replace all artifact fields. |
PATCH |
/artifacts/{artifact_id} |
Partial update. Use to lock the artifact: {"status": "locked"}. |
DELETE |
/artifacts/{artifact_id} |
Delete an artifact. Returns 409 if the artifact is locked or in use by a Workload. |
POST |
/artifacts/{artifact_id}/clone |
Clone an existing artifact into a new draft. Body: {"name": "new-artifact-name"}. |
Image builds¶
These endpoints manage container image builds for artifacts that use imageBuildConfig instead of a pre-built imageUri.
| Verb | パス | 説明 |
|---|---|---|
POST |
/artifacts/{artifact_id}/builds |
Trigger an image build. Returns 202 with an ImageBuildTriggerResponse containing buildIds. |
GET |
/artifacts/{artifact_id}/builds |
List image builds for the artifact. |
GET |
/artifacts/{artifact_id}/builds/{build_id} |
Get a specific build's status and details. |
GET |
/artifacts/{artifact_id}/builds/{build_id}/logs |
Stream build logs (plain text). |
DELETE |
/artifacts/{artifact_id}/builds/{build_id} |
Cancel or delete a build. |
Artifact sharing¶
These endpoints list and replace the roles granted on an individual artifact.
| Verb | パス | 説明 |
|---|---|---|
GET |
/artifacts/{artifact_id}/sharedRoles |
List roles granted on an artifact. |
PATCH |
/artifacts/{artifact_id}/sharedRoles |
Replace the artifact role list (up to 100 entries). |
Artifact repositories¶
These endpoints manage repositories that group artifact versions and govern shared access.
| Verb | パス | 説明 |
|---|---|---|
GET |
/artifactRepositories |
List repositories. |
GET |
/artifactRepositories/{artifact_repository_id} |
Get a repository. |
DELETE |
/artifactRepositories/{artifact_repository_id} |
Delete a repository. Cascades to non-locked, unused artifacts; returns 409 otherwise. |
GET |
/artifactRepositories/{artifact_repository_id}/sharedRoles |
List repository roles. |
PATCH |
/artifactRepositories/{artifact_repository_id}/sharedRoles |
Replace the repository role list. |
The platform creates a repository automatically the first time you create an artifact with artifactRepositoryId set.