Serverless Containers Service, REST: Container.ListRevisions
Retrieves the list of revisions for the specified container, or of all container revisions
in the specified folder.
HTTP request
GET https://serverless-containers.api.cloud.yandex.net/containers/v1/revisions
Query parameters
Field |
Description |
folderId |
string ID of the folder to list container revisions for. Includes only one of the fields |
containerId |
string ID of the container to list revisions for. Includes only one of the fields |
pageSize |
string (int64) The maximum number of results per page to return. If the number of available results Default value: 100. |
pageToken |
string Page token. To get the next page of results, set |
filter |
string A filter expression that filters resources listed in the response. The expression must specify:
|
Response
HTTP Code: 200 - OK
{
"revisions": [
{
"id": "string",
"containerId": "string",
"description": "string",
"createdAt": "string",
"image": {
"imageUrl": "string",
"imageDigest": "string",
"command": {
"command": [
"string"
]
},
"args": {
"args": [
"string"
]
},
"environment": "string",
"workingDir": "string"
},
"resources": {
"memory": "string",
"cores": "string",
"coreFraction": "string"
},
"executionTimeout": "string",
"concurrency": "string",
"serviceAccountId": "string",
"status": "string",
"secrets": [
{
"id": "string",
"versionId": "string",
"key": "string",
// Includes only one of the fields `environmentVariable`
"environmentVariable": "string"
// end of the list of possible fields
}
],
"connectivity": {
"networkId": "string",
"subnetIds": [
"string"
]
},
"provisionPolicy": {
"minInstances": "string"
},
"scalingPolicy": {
"zoneInstancesLimit": "string",
"zoneRequestsLimit": "string"
},
"logOptions": {
"disabled": "boolean",
// Includes only one of the fields `logGroupId`, `folderId`
"logGroupId": "string",
"folderId": "string",
// end of the list of possible fields
"minLevel": "string"
},
"storageMounts": [
{
"bucketId": "string",
"prefix": "string",
"readOnly": "boolean",
"mountPointPath": "string"
}
],
"mounts": [
{
"mountPointPath": "string",
"mode": "string",
// Includes only one of the fields `objectStorage`, `ephemeralDiskSpec`
"objectStorage": {
"bucketId": "string",
"prefix": "string"
},
"ephemeralDiskSpec": {
"size": "string",
"blockSize": "string"
}
// end of the list of possible fields
}
]
}
],
"nextPageToken": "string"
}
Field |
Description |
revisions[] |
List of revisions for the specified folder or container. |
nextPageToken |
string Token for getting the next page of the list. If the number of results is greater than Each subsequent page will have its own |
Revision
Field |
Description |
id |
string ID of the revision. |
containerId |
string ID of the container that the revision belongs to. |
description |
string Description of the revision. |
createdAt |
string (date-time) Creation timestamp for the revision. String in RFC3339 To work with values in this field, use the APIs described in the |
image |
Image configuration for the revision. |
resources |
Resources allocated to the revision. |
executionTimeout |
string (duration) Timeout for the execution of the revision. If the timeout is exceeded, Serverless Containers responds with a 504 HTTP code. |
concurrency |
string (int64) The number of concurrent requests allowed per container instance. |
serviceAccountId |
string ID of the service account associated with the revision. |
status |
enum (Status) Status of the revision.
|
secrets[] |
Yandex Lockbox secrets to be used by the revision. |
connectivity |
Network access. If specified the revision will be attached to specified network/subnet(s). |
provisionPolicy |
Policy for provisioning instances of the revision. The policy is only applied when the revision is ACTIVE. |
scalingPolicy |
Policy for scaling instances of the revision. |
logOptions |
Options for logging from the container. |
storageMounts[] |
S3 mounts to be used by the revision. |
mounts[] |
Mounts to be used by the revision. |
Image
Revision image specification.
Field |
Description |
imageUrl |
string Image URL, that is used by the revision. |
imageDigest |
string Digest of the image. Calculated at creation time. |
command |
Override for the image's ENTRYPOINT. |
args |
Override for the image's CMD. |
environment |
string Additional environment for the container. |
workingDir |
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 |
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 |
Resources
Resources allocated to a revision.
Field |
Description |
memory |
string (int64) Amount of memory available to the revision, specified in bytes, multiple of 128MB. |
cores |
string (int64) Number of cores available to the revision. |
coreFraction |
string (int64) Specifies baseline performance for a core in percent, multiple of 5%. |
Secret
Secret that is available to the container at run time.
Field |
Description |
id |
string ID of Yandex Lockbox secret. |
versionId |
string ID of Yandex Lockbox secret. |
key |
string Key in secret's payload, which value to be delivered into container environment. |
environmentVariable |
string Environment variable in which secret's value is delivered. Includes only one of the fields |
Connectivity
Revision connectivity specification.
Field |
Description |
networkId |
string Network the revision will have access to. |
subnetIds[] |
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 |
minInstances |
string (int64) Minimum number of guaranteed provisioned container instances for all zones |
ScalingPolicy
Field |
Description |
zoneInstancesLimit |
string (int64) Upper limit for instance count in each zone. |
zoneRequestsLimit |
string (int64) Upper limit of requests count in each zone. |
LogOptions
Field |
Description |
disabled |
boolean Is logging from container disabled. |
logGroupId |
string Entry should be written to log group resolved by ID. Includes only one of the fields Log entries destination. |
folderId |
string Entry should be written to default log group for specified folder. Includes only one of the fields Log entries destination. |
minLevel |
enum (Level) Minimum log entry level. See LogLevel.Level for details.
|
StorageMount
Field |
Description |
bucketId |
string Required field. S3 bucket name for mounting. |
prefix |
string S3 bucket prefix for mounting. |
readOnly |
boolean Is mount read only. |
mountPointPath |
string Required field. Mount point path inside the container for mounting. |
Mount
Mount contains an information about version's external storage mount
Field |
Description |
mountPointPath |
string Required field. The absolute mount point path inside the container for mounting. |
mode |
enum (Mode) Mount's mode
|
objectStorage |
Object storage mounts Includes only one of the fields Target mount option |
ephemeralDiskSpec |
Working disk (worker-local non-shared read-write NBS disk templates) Includes only one of the fields Target mount option |
ObjectStorage
ObjectStorage as a mount
Field |
Description |
bucketId |
string Required field. ObjectStorage bucket name for mounting. |
prefix |
string ObjectStorage bucket prefix for mounting. |
DiskSpec
Disk as a mount
Field |
Description |
size |
string (int64) The size of disk for mount in bytes |
blockSize |
string (int64) Optional block size of disk for mount in bytes |