Serverless Containers Service, REST: Container.GetRevision
Returns the specified revision of a container.
To get the list of available revision, make a ListRevisions request.
HTTP request
GET https://serverless-containers.api.cloud.yandex.net/containers/v1/revisions/{containerRevisionId}
Path parameters
Field |
Description |
containerRevisionId |
string Required field. ID of the revision to return. To get a revision ID make a ContainerService.ListRevisions request. |
Response
HTTP Code: 200 - OK
{
"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
}
]
}
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 |