Yandex Cloud
Search
Contact UsGet started
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • AI for business
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
© 2025 Direct Cursus Technology L.L.C.
Yandex Cloud Registry
  • Getting started
  • Access management
  • Pricing policy
    • API authentication
      • Overview
        • Overview
        • Create
        • Update
        • Delete
        • Get
        • List
        • ChangeState
  • Audit Trails events

In this article:

  • gRPC request
  • ListLifecyclePolicyRequest
  • ListLifecyclePolicyResponse
  • LifecyclePolicy
  • LifecycleRule
  • KeepByAgeLifecycleRule
  • KeepByVersionLifecycleRule
  • DeleteLifecycleRule
  • DeleteByVersionCondition
  • DockerFilters
  • MavenFilters
  1. API reference
  2. gRPC
  3. LifecyclePolicy
  4. List

Yandex Cloud Registry API, gRPC: LifecyclePolicyService.List

Written by
Yandex Cloud
Updated at October 30, 2025
  • gRPC request
  • ListLifecyclePolicyRequest
  • ListLifecyclePolicyResponse
  • LifecyclePolicy
  • LifecycleRule
  • KeepByAgeLifecycleRule
  • KeepByVersionLifecycleRule
  • DeleteLifecycleRule
  • DeleteByVersionCondition
  • DockerFilters
  • MavenFilters

Retrieves the list of lifecycle policies in the specified registry.

gRPC requestgRPC request

rpc List (ListLifecyclePolicyRequest) returns (ListLifecyclePolicyResponse)

ListLifecyclePolicyRequestListLifecyclePolicyRequest

{
  "registry_id": "string",
  "page_size": "int64",
  "page_token": "string"
}

Field

Description

registry_id

string

ID of the registry to list lifecycle policies in.

page_size

int64

The maximum number of results per page to return.

page_token

string

Page token. To get the next page of results, set page_token to the
ListLifecyclePolicyResponse.next_page_token returned by a previous list request.

ListLifecyclePolicyResponseListLifecyclePolicyResponse

{
  "policies": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "rules": [
        {
          "path_prefix": "string",
          // 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": {
            "type": "DeleteLifecycleRuleKind",
            "cooldown_period_days": "int64",
            // 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
          },
          // 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
        }
      ],
      "state": "LifecyclePolicyState",
      "registry_id": "string",
      "created_at": "google.protobuf.Timestamp",
      "modified_at": "google.protobuf.Timestamp",
      "created_by": "string",
      "modified_by": "string"
    }
  ],
  "next_page_token": "string"
}

Field

Description

policies[]

LifecyclePolicy

List of lifecycle policy resources.

next_page_token

string

This token allows you to get the next page of results for list requests.

LifecyclePolicyLifecyclePolicy

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[]

LifecycleRule

List of lifecycle rules.

state

enum LifecyclePolicyState

Current state of the lifecycle policy.

  • LIFECYCLE_POLICY_STATE_UNSPECIFIED
  • DISABLED: Policy is disabled and won't be executed.
  • ENABLED: Policy is enabled and will be executed according to schedule.

registry_id

string

ID of the registry that the lifecycle policy belongs to.

created_at

google.protobuf.Timestamp

Output only. Creation timestamp.

modified_at

google.protobuf.Timestamp

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.

LifecycleRuleLifecycleRule

A rule that defines lifecycle policy behavior.

Field

Description

path_prefix

string

Path prefix to which the rule applies.

keep_by_age

KeepByAgeLifecycleRule

Rule that keeps artifacts by age.

Includes only one of the fields keep_by_age, keep_by_version, delete.

Type of lifecycle rule.

keep_by_version

KeepByVersionLifecycleRule

Rule that keeps artifacts by version count.

Includes only one of the fields keep_by_age, keep_by_version, delete.

Type of lifecycle rule.

delete

DeleteLifecycleRule

Rule that deletes artifacts.

Includes only one of the fields keep_by_age, keep_by_version, delete.

Type of lifecycle rule.

docker_filters

DockerFilters

Docker-specific filters.

Includes only one of the fields docker_filters, maven_filters.

Filters to determine which artifacts the rule applies to.

maven_filters

MavenFilters

Maven-specific filters.

Includes only one of the fields docker_filters, maven_filters.

Filters to determine which artifacts the rule applies to.

KeepByAgeLifecycleRuleKeepByAgeLifecycleRule

Rule that keeps artifacts younger than specified age.

Field

Description

younger_than_days

int64

Keep artifacts younger than this number of days.

KeepByVersionLifecycleRuleKeepByVersionLifecycleRule

Rule that keeps a specified number of recent versions.

Field

Description

keep_versions_count

int64

Number of versions to keep.

DeleteLifecycleRuleDeleteLifecycleRule

Rule that deletes artifacts based on specified conditions.

Field

Description

type

enum DeleteLifecycleRuleKind

Type of deletion.

  • DELETE_LIFECYCLE_RULE_KIND_UNSPECIFIED
  • HARD_DELETE: Hard delete - artifacts are permanently removed.
  • SOFT_DELETE: Soft delete - artifacts are marked for deletion but can be recovered.

cooldown_period_days

int64

Cooldown period in days before deletion.

older_than_days

int64

Delete artifacts older than specified days.

Includes only one of the fields older_than_days, version_condition, always.

Condition that triggers deletion.

version_condition

DeleteByVersionCondition

Delete artifacts by version count condition.

Includes only one of the fields older_than_days, version_condition, always.

Condition that triggers deletion.

always

bool

Always delete (use with caution).

Includes only one of the fields older_than_days, version_condition, always.

Condition that triggers deletion.

DeleteByVersionConditionDeleteByVersionCondition

Condition for deletion based on version count.

Field

Description

versions_count_greater_than

int64

Delete when version count exceeds this number.

DockerFiltersDockerFilters

Docker-specific filters for lifecycle rules.

Field

Description

tag_status

enum TagStatus

Filter by tag status.

  • TAG_STATUS_UNSPECIFIED
  • TAG_STATUS_ANY: Any tag status.
  • TAGGED: Only tagged images.
  • UNTAGGED: Only untagged images.

MavenFiltersMavenFilters

Maven-specific filters for lifecycle rules.

Field

Description

version_type

enum VersionType

Filter by version type.

  • VERSION_TYPE_UNSPECIFIED
  • VERSION_TYPE_ANY: Any version type.
  • RELEASE: Only release versions.
  • SNAPSHOT: Only snapshot versions.

Was the article helpful?

Previous
Get
Next
ChangeState
© 2025 Direct Cursus Technology L.L.C.