Serverless Containers Service, gRPC: ContainerService.ListRevisions

Written by

Yandex Cloud

Updated at December 17, 2024

gRPC request
ListContainersRevisionsRequest
ListContainersRevisionsResponse
Revision
Image
Command
Args
Resources
Secret
Connectivity
ProvisionPolicy
ScalingPolicy
LogOptions
StorageMount
Mount
ObjectStorage
DiskSpec
Runtime
Http
Task
MetadataOptions

Retrieves the list of revisions for the specified container, or of all container revisions
in the specified folder.

gRPC request

rpc ListRevisions (ListContainersRevisionsRequest) returns (ListContainersRevisionsResponse)

ListContainersRevisionsRequest

{
  // Includes only one of the fields `folder_id`, `container_id`
  "folder_id": "string",
  "container_id": "string",
  // end of the list of possible fields
  "page_size": "int64",
  "page_token": "string",
  "filter": "string"
}

Field	Description
folder_id	string ID of the folder to list container revisions for. To get a folder ID make a yandex.cloud.resourcemanager.v1.FolderService.List request. Includes only one of the fields `folder_id`, `container_id`.
container_id	string ID of the container to list revisions for. To get a container ID use a ContainerService.List request. Includes only one of the fields `folder_id`, `container_id`.
page_size	int64 The maximum number of results per page to return. If the number of available results is larger than `pageSize`, the service returns a ListContainersRevisionsResponse.next_page_token that can be used to get the next page of results in subsequent list requests. Default value: 100.
page_token	string Page token. To get the next page of results, set `pageToken` to the ListContainersRevisionsResponse.next_page_token returned by a previous list request.
filter	string A filter expression that filters resources listed in the response. The expression must specify: The field name. Currently filtering can only be applied to the Revision.status and Revision.runtime fields. An `=` operator. The value in double quotes (`"`). Must be 3-63 characters long and match the regular expression `[a-z][-a-z0-9]{1,61}[a-z0-9]`. Example of a filter: `status="ACTIVE"`.

ListContainersRevisionsResponse

{
  "revisions": [
    {
      "id": "string",
      "container_id": "string",
      "description": "string",
      "created_at": "google.protobuf.Timestamp",
      "image": {
        "image_url": "string",
        "image_digest": "string",
        "command": {
          "command": [
            "string"
          ]
        },
        "args": {
          "args": [
            "string"
          ]
        },
        "environment": "map<string, string>",
        "working_dir": "string"
      },
      "resources": {
        "memory": "int64",
        "cores": "int64",
        "core_fraction": "int64"
      },
      "execution_timeout": "google.protobuf.Duration",
      "concurrency": "int64",
      "service_account_id": "string",
      "status": "Status",
      "secrets": [
        {
          "id": "string",
          "version_id": "string",
          "key": "string",
          // Includes only one of the fields `environment_variable`
          "environment_variable": "string"
          // end of the list of possible fields
        }
      ],
      "connectivity": {
        "network_id": "string",
        "subnet_ids": [
          "string"
        ]
      },
      "provision_policy": {
        "min_instances": "int64"
      },
      "scaling_policy": {
        "zone_instances_limit": "int64",
        "zone_requests_limit": "int64"
      },
      "log_options": {
        "disabled": "bool",
        // Includes only one of the fields `log_group_id`, `folder_id`
        "log_group_id": "string",
        "folder_id": "string",
        // end of the list of possible fields
        "min_level": "Level"
      },
      "storage_mounts": [
        {
          "bucket_id": "string",
          "prefix": "string",
          "read_only": "bool",
          "mount_point_path": "string"
        }
      ],
      "mounts": [
        {
          "mount_point_path": "string",
          "mode": "Mode",
          // Includes only one of the fields `object_storage`, `ephemeral_disk_spec`
          "object_storage": {
            "bucket_id": "string",
            "prefix": "string"
          },
          "ephemeral_disk_spec": {
            "size": "int64",
            "block_size": "int64"
          }
          // end of the list of possible fields
        }
      ],
      "runtime": {
        // Includes only one of the fields `http`, `task`
        "http": "Http",
        "task": "Task"
        // end of the list of possible fields
      },
      "metadata_options": {
        "gce_http_endpoint": "MetadataOption",
        "aws_v1_http_endpoint": "MetadataOption"
      }
    }
  ],
  "next_page_token": "string"
}

Field

Description

revisions[]

Revision

List of revisions for the specified folder or container.

next_page_token

string

Token for getting the next page of the list. If the number of results is greater than
the specified ListContainersRevisionsRequest.page_size, use nextPageToken as the value
for the ListContainersRevisionsRequest.page_token parameter in the next list request.

Each subsequent page will have its own nextPageToken to continue paging through the results.

Revision

Field	Description
id	string ID of the revision.
container_id	string ID of the container that the revision belongs to.
description	string Description of the revision.
created_at	google.protobuf.Timestamp Creation timestamp for the revision.
image	Image Image configuration for the revision.
resources	Resources Resources allocated to the revision.
execution_timeout	google.protobuf.Duration Timeout for the execution of the revision. If the timeout is exceeded, Serverless Containers responds with a 504 HTTP code.
concurrency	int64 The number of concurrent requests allowed per container instance.
service_account_id	string ID of the service account associated with the revision.
status	enum Status Status of the revision. `STATUS_UNSPECIFIED` `CREATING`: Revision is being created. `ACTIVE`: Revision is currently used by the container. `OBSOLETE`: Revision is not used by the container. May be deleted later.
secrets[]	Secret Yandex Lockbox secrets to be used by the revision.
connectivity	Connectivity Network access. If specified the revision will be attached to specified network/subnet(s).
provision_policy	ProvisionPolicy Policy for provisioning instances of the revision. The policy is only applied when the revision is ACTIVE.
scaling_policy	ScalingPolicy Policy for scaling instances of the revision.
log_options	LogOptions Options for logging from the container.
storage_mounts[]	StorageMount S3 mounts to be used by the revision.
mounts[]	Mount Mounts to be used by the revision.
runtime	Runtime The container's execution mode
metadata_options	MetadataOptions Metadata options for the revision.

Image

Revision image specification.

Field	Description
image_url	string Image URL, that is used by the revision.
image_digest	string Digest of the image. Calculated at creation time.
command	Command Override for the image's ENTRYPOINT.
args	Args Override for the image's CMD.
environment	object (map<string, string>) Additional environment for the container.
working_dir	string Override for the image's WORKDIR.

Command

Field

Description

command[]

string

Command that will override ENTRYPOINT of an image.

Commands will be executed as is. The runtime will not substitute environment
variables or execute shell commands. If one wants to do that, they should
invoke shell interpreter with an appropriate shell script.

Args

Field

Description

args[]

string

Arguments that will override CMD of an image.

Arguments will be passed as is. The runtime will not substitute environment
variables or execute shell commands. If one wants to do that, they should
invoke shell interpreter with an appropriate shell script.

Resources

Resources allocated to a revision.

Field	Description
memory	int64 Amount of memory available to the revision, specified in bytes, multiple of 128MB.
cores	int64 Number of cores available to the revision.
core_fraction	int64 Specifies baseline performance for a core in percent, multiple of 5%. Should be 100% for cores > 1.

Secret

Secret that is available to the container at run time.

Field	Description
id	string ID of Yandex Lockbox secret.
version_id	string ID of Yandex Lockbox secret.
key	string Key in secret's payload, which value to be delivered into container environment.
environment_variable	string Environment variable in which secret's value is delivered. Includes only one of the fields `environment_variable`.

Connectivity

Revision connectivity specification.

Field

Description

network_id

string

Network the revision will have access to.

subnet_ids[]

string

The list of subnets (from the same network) the revision can be attached to.

Deprecated, it is sufficient to specify only network_id, without the list of subnet_ids.

ProvisionPolicy

Field

Description

min_instances

int64

Minimum number of guaranteed provisioned container instances for all zones
in total.

ScalingPolicy

Field

Description

zone_instances_limit

int64

Upper limit for instance count in each zone.
0 means no limit.

zone_requests_limit

int64

Upper limit of requests count in each zone.
0 means no limit.

LogOptions

Field	Description
disabled	bool Is logging from container disabled.
log_group_id	string Entry should be written to log group resolved by ID. Includes only one of the fields `log_group_id`, `folder_id`. Log entries destination.
folder_id	string Entry should be written to default log group for specified folder. Includes only one of the fields `log_group_id`, `folder_id`. Log entries destination.
min_level	enum Level Minimum log entry level. See LogLevel.Level for details. `LEVEL_UNSPECIFIED`: Default log level. Equivalent to not specifying log level at all. `TRACE`: Trace log level. Possible use case: verbose logging of some business logic. `DEBUG`: Debug log level. Possible use case: debugging special cases in application logic. `INFO`: Info log level. Mostly used for information messages. `WARN`: Warn log level. May be used to alert about significant events. `ERROR`: Error log level. May be used to alert about errors in infrastructure, logic, etc. `FATAL`: Fatal log level. May be used to alert about unrecoverable failures and events.

StorageMount

Field	Description
bucket_id	string Required field. S3 bucket name for mounting.
prefix	string S3 bucket prefix for mounting.
read_only	bool Is mount read only.
mount_point_path	string Required field. Mount point path inside the container for mounting.

Mount

Mount contains an information about version's external storage mount

Field	Description
mount_point_path	string Required field. The absolute mount point path inside the container for mounting.
mode	enum Mode Mount's mode `MODE_UNSPECIFIED` `READ_ONLY` `READ_WRITE`
object_storage	ObjectStorage Object storage mounts Includes only one of the fields `object_storage`, `ephemeral_disk_spec`. Target mount option
ephemeral_disk_spec	DiskSpec Working disk (worker-local non-shared read-write NBS disk templates) Includes only one of the fields `object_storage`, `ephemeral_disk_spec`. Target mount option

ObjectStorage

ObjectStorage as a mount

Field

Description

bucket_id

string

Required field. ObjectStorage bucket name for mounting.

prefix

string

ObjectStorage bucket prefix for mounting.

DiskSpec

Disk as a mount

Field

Description

size

int64

The size of disk for mount in bytes

block_size

int64

Optional block size of disk for mount in bytes

Runtime

The container's execution mode

Field

Description

http

Http

The classic one. You need to run an HTTP server inside the container.

Includes only one of the fields http, task.

task

Task

We run a process from ENTRYPOINT inside the container for each user request.

Includes only one of the fields http, task.

Http

Field	Description
Empty

Task

Field	Description
Empty

MetadataOptions

Field

Description

gce_http_endpoint

enum MetadataOption

Enabled access to GCE flavored metadata

METADATA_OPTION_UNSPECIFIED: Option is default
ENABLED: Option is enabled
DISABLED: Option is disabled

aws_v1_http_endpoint

enum MetadataOption

Enabled access to AWS flavored metadata (IMDSv1)

METADATA_OPTION_UNSPECIFIED: Option is default
ENABLED: Option is enabled
DISABLED: Option is disabled

Serverless Containers Service, gRPC: ContainerService.ListRevisions

gRPC requestgRPC request

ListContainersRevisionsRequestListContainersRevisionsRequest

ListContainersRevisionsResponseListContainersRevisionsResponse

RevisionRevision

ImageImage

CommandCommand

ArgsArgs

ResourcesResources

SecretSecret

ConnectivityConnectivity

ProvisionPolicyProvisionPolicy

ScalingPolicyScalingPolicy

LogOptionsLogOptions

StorageMountStorageMount

MountMount

ObjectStorageObjectStorage

DiskSpecDiskSpec

RuntimeRuntime

HttpHttp

TaskTask

MetadataOptionsMetadataOptions

Was the article helpful?

gRPC request

ListContainersRevisionsRequest

ListContainersRevisionsResponse

Revision

Image

Command

Args

Resources

Secret

Connectivity

ProvisionPolicy

ScalingPolicy

LogOptions

StorageMount

Mount

ObjectStorage

DiskSpec

Runtime

Http

Task

MetadataOptions