Serverless Containers Service, gRPC: ContainerService.GetRevision
Returns the specified revision of a container.
To get the list of available revision, make a ListRevisions request.
gRPC request
rpc GetRevision (GetContainerRevisionRequest) returns (Revision)
GetContainerRevisionRequest
{
"containerRevisionId": "string"
}
|
Field |
Description |
|
containerRevisionId |
string Required field. ID of the revision to return. To get a revision ID make a ContainerService.ListRevisions request. |
Revision
{
"id": "string",
"containerId": "string",
"description": "string",
"createdAt": "google.protobuf.Timestamp",
"image": {
"imageUrl": "string",
"imageDigest": "string",
"command": {
"command": [
"string"
]
},
"args": {
"args": [
"string"
]
},
"environment": "string",
"workingDir": "string"
},
"resources": {
"memory": "int64",
"cores": "int64",
"coreFraction": "int64"
},
"executionTimeout": "google.protobuf.Duration",
"concurrency": "int64",
"serviceAccountId": "string",
"status": "Status",
"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": "int64"
},
"scalingPolicy": {
"zoneInstancesLimit": "int64",
"zoneRequestsLimit": "int64"
},
"logOptions": {
"disabled": "bool",
// Includes only one of the fields `logGroupId`, `folderId`
"logGroupId": "string",
"folderId": "string",
// end of the list of possible fields
"minLevel": "Level"
},
"storageMounts": [
{
"bucketId": "string",
"prefix": "string",
"readOnly": "bool",
"mountPointPath": "string"
}
],
"mounts": [
{
"mountPointPath": "string",
"mode": "Mode",
// Includes only one of the fields `objectStorage`, `ephemeralDiskSpec`
"objectStorage": {
"bucketId": "string",
"prefix": "string"
},
"ephemeralDiskSpec": {
"size": "int64",
"blockSize": "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
}
}
|
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 |
Creation timestamp for the revision. |
|
image |
Image configuration for the revision. |
|
resources |
Resources allocated to the revision. |
|
executionTimeout |
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. |
|
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. |
|
runtime |
The container's execution mode |
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 |
int64 Amount of memory available to the revision, specified in bytes, multiple of 128MB. |
|
cores |
int64 Number of cores available to the revision. |
|
coreFraction |
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 |
int64 Minimum number of guaranteed provisioned container instances for all zones |
ScalingPolicy
|
Field |
Description |
|
zoneInstancesLimit |
int64 Upper limit for instance count in each zone. |
|
zoneRequestsLimit |
int64 Upper limit of requests count in each zone. |
LogOptions
|
Field |
Description |
|
disabled |
bool 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 |
bool 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 |
int64 The size of disk for mount in bytes |
|
blockSize |
int64 Optional block size of disk for mount in bytes |
Runtime
The container's execution mode
|
Field |
Description |
|
http |
The classic one. You need to run an HTTP server inside the container. Includes only one of the fields |
|
task |
We run a process from ENTRYPOINT inside the container for each user request. Includes only one of the fields |
Http
|
Field |
Description |
|
Empty |
|
Task
|
Field |
Description |
|
Empty |
|