Yandex Cloud Registry API, gRPC: ArtifactService.GetByPath
Returns the specified artifact resource by path within the registry.
gRPC request
rpc GetByPath (GetArtifactByPathRequest) returns (Artifact)
GetArtifactByPathRequest
{
"registry_id": "string",
"path": "string"
}
|
Field |
Description |
|
registry_id |
string Required field. ID of the registry that contains the artifact. The maximum string length in characters is 50. |
|
path |
string Required field. The path to a specific node where the registry artifact is located. |
Artifact
{
"id": "string",
"path": "string",
"name": "string",
"kind": "Kind",
"status": "Status",
"created_at": "google.protobuf.Timestamp",
"created_by": "string",
"modified_at": "google.protobuf.Timestamp",
"modified_by": "string",
"properties": "map<string, string>",
"content": {
// Includes only one of the fields `docker`
"docker": {
// Includes only one of the fields `image_manifest`, `manifest_list`
"image_manifest": {
"config": {
"digest": "string",
"size": "int64"
},
"layers": [
{
"digest": "string",
"size": "int64"
}
]
},
"manifest_list": {
"manifests": [
{
"manifest_descriptor": {
"digest": "string",
"size": "int64"
},
"platform": {
"architecture": "string",
"os": "string",
"os_version": "string",
"variant": "string"
}
}
]
},
// end of the list of possible fields
"manifest_digest": "string"
}
// end of the list of possible fields
}
}
A Artifact resource.
|
Field |
Description |
|
id |
string Output only. ID of the artifact. |
|
path |
string Path where the artifact is located. |
|
name |
string Name of the artifact. |
|
kind |
enum Kind Kind of the artifact.
|
|
status |
enum Status Output only. Status of the artifact.
|
|
created_at |
Output only. Creation timestamp in RFC3339 text format. |
|
created_by |
string Output only. ID of the user or service account who created the artifact. |
|
modified_at |
Output only. Modification timestamp in RFC3339 text format. |
|
modified_by |
string Output only. ID of the user or service account who last modified the artifact. |
|
properties |
object (map<string, string>) Key-value properties associated with the artifact. |
|
content |
Content of the artifact. |
Content
Content of the artifact, specific to its type.
|
Field |
Description |
|
docker |
Docker-specific content. Includes only one of the fields |
DockerContent
Docker-specific content of the artifact.
|
Field |
Description |
|
image_manifest |
Single-platform image manifest. Includes only one of the fields |
|
manifest_list |
Multi-platform manifest list. Includes only one of the fields |
|
manifest_digest |
string Digest of the manifest. |
ImageManifest
Image manifest describing a single-platform Docker image.
|
Field |
Description |
|
config |
Descriptor of the image configuration. |
|
layers[] |
Descriptors of the image layers. |
Descriptor
Descriptor of a content blob (config, layer, or manifest).
|
Field |
Description |
|
digest |
string Digest of the content. |
|
size |
int64 Size of the content in bytes. |
ManifestList
Manifest list describing a multi-platform Docker image.
|
Field |
Description |
|
manifests[] |
List of platform-specific manifests. |
PlatformManifest
Platform-specific manifest entry within a manifest list.
|
Field |
Description |
|
manifest_descriptor |
Descriptor of the platform-specific manifest. |
|
platform |
Platform this manifest targets. |
Platform
Platform describes the target OS and architecture of an image.
|
Field |
Description |
|
architecture |
string CPU architecture. |
|
os |
string Operating system. |
|
os_version |
string OS version. |
|
variant |
string CPU variant. |