Yandex Cloud Registry API, gRPC: LifecyclePolicyService.Get
Returns the specified lifecycle policy.
gRPC request
rpc Get (GetLifecyclePolicyRequest) returns (LifecyclePolicy)
GetLifecyclePolicyRequest
{
"policy_id": "string"
}
|
Field |
Description |
|
policy_id |
string Required field. ID of the lifecycle policy to return. The maximum string length in characters is 50. |
LifecyclePolicy
{
"id": "string",
"name": "string",
"description": "string",
"rules": [
{
// Includes only one of the fields `keep_by_age`, `keep_by_version`, `delete`
"keep_by_age": {
"younger_than_days": "int64"
},
"keep_by_version": {
"keep_versions_count": "int64"
},
"delete": {
// Includes only one of the fields `older_than_days`, `version_condition`, `always`
"older_than_days": "int64",
"version_condition": {
"versions_count_greater_than": "int64"
},
"always": "bool",
// end of the list of possible fields
"type": "DeleteLifecycleRuleKind",
"cooldown_period_days": "int64"
},
// end of the list of possible fields
// Includes only one of the fields `docker_filters`, `maven_filters`
"docker_filters": {
"tag_status": "TagStatus"
},
"maven_filters": {
"version_type": "VersionType"
},
// end of the list of possible fields
"path_prefix": "string",
"version_regexp": "string",
"description": "string"
}
],
"state": "LifecyclePolicyState",
"registry_id": "string",
"created_at": "google.protobuf.Timestamp",
"modified_at": "google.protobuf.Timestamp",
"created_by": "string",
"modified_by": "string"
}
A LifecyclePolicy resource.
|
Field |
Description |
|
id |
string ID of the lifecycle policy. |
|
name |
string Name of the lifecycle policy. |
|
description |
string Description of the lifecycle policy. 0-1024 characters long. |
|
rules[] |
List of lifecycle rules. |
|
state |
enum LifecyclePolicyState Current state of the lifecycle policy.
|
|
registry_id |
string ID of the registry that the lifecycle policy belongs to. |
|
created_at |
Output only. Creation timestamp. |
|
modified_at |
Output only. Modification timestamp. |
|
created_by |
string Output only. ID of the user who created the lifecycle policy. |
|
modified_by |
string Output only. ID of the user who last modified the lifecycle policy. |
LifecycleRule
A rule that defines lifecycle policy behavior.
|
Field |
Description |
|
keep_by_age |
Rule that keeps artifacts by age. Includes only one of the fields Type of lifecycle rule. |
|
keep_by_version |
Rule that keeps artifacts by version count. Includes only one of the fields Type of lifecycle rule. |
|
delete |
Rule that deletes artifacts. Includes only one of the fields Type of lifecycle rule. |
|
docker_filters |
Docker-specific filters. Includes only one of the fields Filters to determine which artifacts the rule applies to. |
|
maven_filters |
Maven-specific filters. Includes only one of the fields Filters to determine which artifacts the rule applies to. |
|
path_prefix |
string Path prefix to which the rule applies. |
|
version_regexp |
string Regular expression pattern to match package version or docker tag. |
|
description |
string Description of the lifecycle policy rule |
KeepByAgeLifecycleRule
Rule that keeps artifacts younger than specified age.
|
Field |
Description |
|
younger_than_days |
int64 Keep artifacts younger than this number of days. |
KeepByVersionLifecycleRule
Rule that keeps a specified number of recent versions.
|
Field |
Description |
|
keep_versions_count |
int64 Number of versions to keep. |
DeleteLifecycleRule
Rule that deletes artifacts based on specified conditions.
|
Field |
Description |
|
older_than_days |
int64 Delete artifacts older than specified days. Includes only one of the fields Condition that triggers deletion. |
|
version_condition |
Delete artifacts by version count condition. Includes only one of the fields Condition that triggers deletion. |
|
always |
bool Always delete (use with caution). Includes only one of the fields Condition that triggers deletion. |
|
type |
enum DeleteLifecycleRuleKind Type of deletion.
|
|
cooldown_period_days |
int64 Cooldown period in days before deletion. |
DeleteByVersionCondition
Condition for deletion based on version count.
|
Field |
Description |
|
versions_count_greater_than |
int64 Delete when version count exceeds this number. |
DockerFilters
Docker-specific filters for lifecycle rules.
|
Field |
Description |
|
tag_status |
enum TagStatus Filter by tag status.
|
MavenFilters
Maven-specific filters for lifecycle rules.
|
Field |
Description |
|
version_type |
enum VersionType Filter by version type.
|