Compute Cloud Instance Groups API, REST: InstanceGroup.Create

Field

Description

folderId

string

Required field. ID of the folder to create an instance group in.
To get the folder ID, use a yandex.cloud.resourcemanager.v1.FolderService.List request.
This field is required.

name

string

Name of the instance group.
The value must match the regular expression: |[a-z]([-a-z0-9]{0,61}[a-z0-9])?.

Value must match the regular expression |[a-z]([-a-z0-9]{0,61}[a-z0-9])?.

description

string

Description of the instance group.
The length must be less than or equal to 256.

labels

object (map<string, string>)

Resource labels as key:value pairs.
Each map key must match the regular expression: [a-z][-_./\\@0-9a-z]*.
Each map value must match the regular expression: [-_./\\@0-9a-z]*.
The length of each map key must be between 1 and 63.
The length of each map value must be less than or equal to 63.
The number of elements must be less than or equal to 64.

Each value must match the regular expression [-_./\@0-9a-z]*.

instanceTemplate

InstanceTemplate

Required field. Instance template that the instance group belongs to.
This field is required.

scalePolicy

ScalePolicy

Required field. Scaling policy of the instance group.
This field is required.

deployPolicy

DeployPolicy

Required field. Deployment policy of the instance group.
This field is required.

allocationPolicy

AllocationPolicy

Required field. Allocation policy of the instance group by zones and regions.
This field is required.

loadBalancerSpec

LoadBalancerSpec

Settings for balancing load between instances via Network Load Balancer
(OSI model layer 3).
If specified, a Network Load Balancer target group containing all instances from the instance group will be created
and attributed to the instance group.

healthChecksSpec

HealthChecksSpec

Health checking specification. For more information, see Health check.

serviceAccountId

string

Required field. ID of the service account. The service account will be used for all API calls
made by the Instance Groups component on behalf of the user (for example, creating instances, adding them to load balancer target group, etc.). For more information, see Service accounts.
To get the service account ID, use a yandex.cloud.iam.v1.ServiceAccountService.List request.

variables[]

Variable

deletionProtection

boolean

Flag prohibiting deletion of the instance group.
Allowed values:
- false: The instance group can be deleted.
- true: The instance group cannot be deleted.
The default is false.

applicationLoadBalancerSpec

ApplicationLoadBalancerSpec

Settings for balancing load between instances via Application Load Balancer
(OSI model layer 7).
If specified, an Application Load Balancer target group containing all instances from the instance group will be created
and attributed to the instance group.

autoHealingPolicy

AutoHealingPolicy

AutoHealingPolicy policy of the instance group.

Field

Description

description

string

Description of the instance template.
The length must be less than or equal to 256.

labels

object (map<string, string>)

Resource labels as key:value pairs.
Each map key must match the regular expression: [a-z][-_./\\@0-9a-z]*.
The length of each map key must be between 1 and 63.
The length of each map value must be less than or equal to 128.
The number of elements must be less than or equal to 64.

platformId

string

Required field. ID of the hardware platform configuration for the instance.
Platforms allows you to create various types of instances: with a large amount of memory,
with a large number of cores, with a burstable performance.
For more information, see Platforms.
This field is required.

resourcesSpec

ResourcesSpec

Required field. Computing resources of the instance such as the amount of memory and number of cores.
This field is required.

metadata

object (map<string, string>)

The metadata key:value pairs assigned to this instance template. This includes custom metadata and predefined keys.
Metadata values may contain one of the supported placeholders:
{instance_group.id}
{instance.short_id}
{instance.index}
{instance.index_in_zone}
{instance.zone_id}
InstanceGroup and Instance labels may be copied to metadata following way:
{instance_group.labels.some_label_key}
{instance.labels.another_label_key}
These placeholders will be substituted for each created instance anywhere in the value text.
In the rare case the value requires to contain this placeholder explicitly,
it must be escaped with double brackets, in example {instance.index}.
For example, you may use the metadata in order to provide your public SSH key to the instance.
For more information, see Metadata.
Each map key must match the regular expression: [a-z][-_0-9a-z]*.
The length of each map key must be between 1 and 63.
The length of each map value must be less than or equal to 262144.
The number of elements must be less than or equal to 128.

bootDiskSpec

AttachedDiskSpec

Boot disk specification that will be attached to the instance.
This field is required.

secondaryDiskSpecs[]

AttachedDiskSpec

Array of secondary disks that will be attached to the instance.
The number of elements must be less than or equal to 3.

networkInterfaceSpecs[]

NetworkInterfaceSpec

Array of network interfaces that will be attached to the instance.
This field is required.

schedulingPolicy

SchedulingPolicy

Scheduling policy for the instance.

serviceAccountId

string

Service account ID for the instance.

name

string

Name of the instance.
In order to be unique it must contain at least on of instance unique placeholders:
{instance.short_id}
{instance.index}
combination of {instance.zone_id} and {instance.index_in_zone}
Example: my-instance-{instance.index}
If not set, default is used: {instance_group.id}-{instance.short_id}
It may also contain another placeholders, see metadata doc for full list.
The length must be less than or equal to 128.

hostname

string

Host name for the instance.
This field is used to generate the yandex.cloud.compute.v1.Instance.fqdn value.
The host name must be unique within the network and region.
If not specified, the host name will be equal to yandex.cloud.compute.v1.Instance.id of the instance
and FQDN will be <id>.auto.internal. Otherwise FQDN will be <hostname>.<region_id>.internal.
In order to be unique it must contain at least on of instance unique placeholders:
{instance.short_id}
{instance.index}
combination of {instance.zone_id} and {instance.index_in_zone}
Example: my-instance-{instance.index}
If not set, name value will be used
It may also contain another placeholders, see metadata doc for full list.
The length must be less than or equal to 128.

networkSettings

NetworkSettings

Network settings for the instance.

placementPolicy

PlacementPolicy

Placement Group

filesystemSpecs[]

AttachedFilesystemSpec

Array of filesystems to attach to the instance.
The filesystems must reside in the same availability zone as the instance.
To use the instance with an attached filesystem, the latter must be mounted.
For details, see documentation.

reservedInstancePoolId

string

ID of the reserved instance pool that the instance should belong to.
Attaching/detaching running instance will increase/decrease the size of the reserved instance pool.
Attaching/detaching stopped instance will leave the size of the reserved instance pool unchanged. Starting such attached instance will use resources from the reserved instance pool.
Reserved instance pool resource configuration must match the resource configuration of the instance.

metadataOptions

MetadataOptions

Metadata options for the instance

Field

Description

memory

string (int64)

The amount of memory available to the instance, specified in bytes.
The value must be less than or equal to 824633720832.

cores

string (int64)

The number of cores available to the instance.
The value must satisfy: 2,4,6,8,10,12,14,16,18,20,22,24,26,28,30,32,34,36,40,44,48,52,56,60,64,68,72,76,80.

coreFraction

string (int64)

Baseline level of CPU performance with the ability to burst performance above that baseline level.
This field sets baseline performance for each core.
The value must satisfy: 0,5,20,50,100.

gpus

string (int64)

The number of GPUs available to the instance.
The value must satisfy: 0,1,2,4.

Field

Description

mode

enum (Mode)

Required field. Access mode to the Disk resource.
This field is required.

• READ_ONLY: Read-only access.
• READ_WRITE: Read/Write access.

deviceName

string

Serial number that is reflected in the /dev/disk/by-id/ tree
of a Linux operating system running within the instance.
This value can be used to reference the device for mounting, resizing, and so on, from within the instance.
The value must match the regular expression: |[a-z][-_0-9a-z]{0,19}.

Value must match the regular expression |[a-z][-_0-9a-z]{0,19}.

diskSpec

DiskSpec

oneof disk_spec or disk_id
Disk specification that is attached to the instance. For more information, see Disks.
This field is required.

diskId

string

Set to use an existing disk. To set use variables.
The length must be less than or equal to 128.
The value must match the regular expression: [-a-zA-Z0-9._{}]*.

Value must match the regular expression [-a-zA-Z0-9._{}]*.

name

string

When set can be later used to change DiskSpec of actual disk.
The length must be less than or equal to 128.

Field

Description

description

string

Description of the disk.
The length must be less than or equal to 256.

typeId

string

Required field. ID of the disk type.
This field is required.

size

string (int64)

Size of the disk, specified in bytes.
The value must be between 4194304 and 28587302322176.

imageId

string

ID of the image that will be used for disk creation.
The length must be less than or equal to 50.

Includes only one of the fields imageId, snapshotId.

snapshotId

string

ID of the snapshot that will be used for disk creation.
The length must be less than or equal to 50.

Includes only one of the fields imageId, snapshotId.

preserveAfterInstanceDelete

boolean

When set to true, disk will not be deleted even after managed instance is deleted.
It will be a user's responsibility to delete such disks.

Field

Description

networkId

string

ID of the network.

subnetIds[]

string

IDs of the subnets.

primaryV4AddressSpec

PrimaryAddressSpec

Primary IPv4 address that is assigned to the instance for this network interface.

primaryV6AddressSpec

PrimaryAddressSpec

Primary IPv6 address that is assigned to the instance for this network interface. IPv6 not available yet.

securityGroupIds[]

string

IDs of security groups.

Field

Description

oneToOneNatSpec

OneToOneNatSpec

An external IP address configuration.
If not specified, then this managed instance will have no external internet access.

address

string

Optional. Manual set static internal IP. To set use variables.

Value must match the regular expression [-a-zA-Z0-9._{}:]*.

dnsRecordSpecs[]

DnsRecordSpec

Internal DNS configuration

Field

Description

ipVersion

enum (IpVersion)

IP version for the public IP address.

• IPV4: IPv4 address, for example 192.168.0.0.
• IPV6: IPv6 address, not available yet.

address

string

Manual set static public IP. To set use variables. (optional)

Value must match the regular expression [-a-zA-Z0-9._{}]*.

dnsRecordSpecs[]

DnsRecordSpec

External DNS configuration

Field

Description

fqdn

string

FQDN (required)
This field is required.

dnsZoneId

string

DNS zone id (optional, if not set, private zone used)

ttl

string (int64)

DNS record ttl, values in 0-86400 (optional)
The value must be between 0 and 86400.

ptr

boolean

When set to true, also create PTR DNS record (optional)

Field

Description

preemptible

boolean

Preemptible instances are stopped at least once every 24 hours, and can be stopped at any time
if their resources are needed by Compute.
For more information, see Preemptible Virtual Machines.

Field

Description

type

enum (Type)

Required field. Type of instance network.

• STANDARD: Standard network.
• SOFTWARE_ACCELERATED: Software accelerated network.
• HARDWARE_ACCELERATED: Hardware accelerated network.

Field

Description

placementGroupId

string

Identifier of placement group

hostAffinityRules[]

HostAffinityRule

List of affinity rules. Scheduler will attempt to allocate instances according to order of rules.

Field

Description

key

string

Required field. Affinity label or one of reserved values - 'yc.hostId', 'yc.hostGroupId'

op

enum (Operator)

Include or exclude action

• IN: Include action
• NOT_IN: Exclude action

values[]

string

Affinity value or host ID or host group ID

Field

Description

mode

enum (Mode)

Mode of access to the filesystem that should be attached.

• READ_ONLY: Read-only access.
• READ_WRITE: Read/Write access. Default value.

deviceName

string

Name of the device representing the filesystem on the instance.
The name should be used for referencing the filesystem from within the instance
when it's being mounted, resized etc.
If not specified, a random value will be generated.
The value must match the regular expression: |[a-z][-_0-9a-z]{0,19}.

Value must match the regular expression |[a-z][-_0-9a-z]{0,19}.

filesystemId

string

ID of the filesystem that should be attached.
The length must be less than or equal to 128.
The value must match the regular expression: [-a-zA-Z0-9._{}]*.

Value must match the regular expression [-a-zA-Z0-9._{}]*.

Field

Description

gceHttpEndpoint

enum (MetadataOption)

Enabled access to GCE flavored metadata

• ENABLED: Option is enabled
• DISABLED: Option is disabled

awsV1HttpEndpoint

enum (MetadataOption)

Enabled access to AWS flavored metadata (IMDSv1)

• ENABLED: Option is enabled
• DISABLED: Option is disabled

gceHttpToken

enum (MetadataOption)

Enabled access to IAM credentials with GCE flavored metadata

• ENABLED: Option is enabled
• DISABLED: Option is disabled

awsV1HttpToken

enum (MetadataOption)

Enabled access to IAM credentials with AWS flavored metadata (IMDSv1)

• ENABLED: Option is enabled
• DISABLED: Option is disabled

awsV2HttpEndpoint

enum (MetadataOption)

Enabled access to AWS flavored metadata with session token (IMDSv2)

• ENABLED: Option is enabled
• DISABLED: Option is disabled

awsV2HttpToken

enum (MetadataOption)

Enabled access to STS credentials with AWS flavored metadata with session token (IMDSv2)

• ENABLED: Option is enabled
• DISABLED: Option is disabled

Field

Description

fixedScale

FixedScale

Manual scaling policy of the instance group.

Includes only one of the fields fixedScale, autoScale.

autoScale

AutoScale

Automatic scaling policy of the instance group.

Includes only one of the fields fixedScale, autoScale.

testAutoScale

AutoScale

Test spec for automatic scaling policy of the instance group.

Field

Description

size

string (int64)

Number of instances in the instance group.
The value must be between 1 and 100.

Field

Description

minZoneSize

string (int64)

Lower limit for instance count in each zone.
The value must be between 0 and 100.

maxSize

string (int64)

Upper limit for total instance count (across all zones).
0 means maximum limit = 100.
The value must be between 0 and 100.

measurementDuration

string (duration)

Time in seconds allotted for averaging metrics.
1 minute by default.
The value must satisfy: 1m-10m.

warmupDuration

string (duration)

The warmup time of the instance in seconds. During this time,
traffic is sent to the instance, but instance metrics are not collected.
The value must satisfy: <=10m.

stabilizationDuration

string (duration)

Minimum amount of time in seconds allotted for monitoring before
Instance Groups can reduce the number of instances in the group.
During this time, the group size doesn't decrease, even if the new metric values
indicate that it should.
The value must satisfy: 1m-30m.

initialSize

string (int64)

Target group size.
The value must be greater than or equal to 1.

cpuUtilizationRule

CpuUtilizationRule

Defines an autoscaling rule based on the average CPU utilization of the instance group.
If more than one rule is specified, e.g. CPU utilization and one or more Monitoring metrics (customRules),
the size of the instance group will be equal to the maximum of sizes calculated according to each metric.

customRules[]

CustomRule

Defines an autoscaling rule based on a custom metric from Monitoring.
If more than one rule is specified, e.g. CPU utilization (cpuUtilizationRule) and one or more Monitoring
metrics, the size of the instance group will be equal to the maximum of sizes calculated according to each metric.
The number of elements must be less than or equal to 3.

autoScaleType

enum (AutoScaleType)

Autoscaling type.

• ZONAL: Scale each zone independently. This is the default.
• REGIONAL: Scale group as a whole.

Field

Description

utilizationTarget

string

Target CPU utilization level. Instance Groups maintains this level for each availability zone.
The value must be between 10 and 100.

Field

Description

ruleType

enum (RuleType)

Required field. Custom metric rule type. This field affects which label from
the custom metric should be used: zone_id or instance_id.
This field is required.

• UTILIZATION: This type means that the metric applies to one instance.
  First, Instance Groups calculates the average metric value for each instance,
  then averages the values for instances in one availability zone or in whole group depends on autoscaling type.
  This type of metric must have the instance_id label.
• WORKLOAD: This type means that the metric applies to instances in one availability zone or to whole group depends on autoscaling type.
  This type of metric must have the zone_id label if ZONAL autoscaling type is chosen.

metricType

enum (MetricType)

Required field. Type of custom metric. This field affects how Instance Groups calculates the average metric value.
This field is required.

• GAUGE: This type is used for metrics that show the metric value at a certain point in time,
  such as requests per second to the server on an instance.
  Instance Groups calculates the average metric value for the period
  specified in the AutoScale.measurementDuration field.
• COUNTER: This type is used for metrics that monotonically increase over time,
  such as the total number of requests to the server on an instance.
  Instance Groups calculates the average value increase for the period
  specified in the AutoScale.measurementDuration field.

metricName

string

Required field. Name of custom metric in Monitoring that should be used for scaling.
The value must match the regular expression: [a-zA-Z0-9./@_][ 0-9a-zA-Z./@_,:;()\\[\\]<>-]{0,198}.
This field is required.

Value must match the regular expression [a-zA-Z0-9./@_][ 0-9a-zA-Z./@_,:;()\[\]<>-]{0,198}.

labels

object (map<string, string>)

Labels of custom metric in Monitoring that should be used for scaling.
Each map key must match the regular expression: ^[a-zA-Z][0-9a-zA-Z_]{0,31}$.
Each map value must match the regular expression: [a-zA-Z0-9./@_][ 0-9a-zA-Z./@_,:;()\\[\\]<>-]{0,198}.

Each value must match the regular expression [a-zA-Z0-9./@_][ 0-9a-zA-Z./@_,:;()\[\]<>-]{0,198}.

target

string

Target value for the custom metric. Instance Groups maintains this level for each availability zone.
The value must be greater than 0.

folderId

string

Folder id of custom metric in Monitoring that should be used for scaling.
The length must be less than or equal to 50.

service

string

Service of custom metric in Monitoring that should be used for scaling.
The length must be less than or equal to 200.

Field

Description

maxUnavailable

string (int64)

The maximum number of running instances that can be taken offline (i.e., stopped or deleted) at the same time
during the update process.
If maxExpansion is not specified or set to zero, maxUnavailable must be set to a non-zero value.
The value must be between 0 and 100.

maxDeleting

string (int64)

The maximum number of instances that can be deleted at the same time.
The value 0 is any number of virtual machines within the allowed values.
The value must be between 0 and 100.

maxCreating

string (int64)

The maximum number of instances that can be created at the same time.
The value 0 is any number of virtual machines within the allowed values.
The value must be between 0 and 100.

maxExpansion

string (int64)

The maximum number of instances that can be temporarily allocated above the group's target size
during the update process.
If maxUnavailable is not specified or set to zero, maxExpansion must be set to a non-zero value.
The value must be between 0 and 100.

startupDuration

string (duration)

Instance startup duration.
Instance will be considered up and running (and start receiving traffic) only after startup_duration
has elapsed and all health checks are passed.
See ManagedInstance.Status for more information.
The value must satisfy: 0m-1h.

strategy

enum (Strategy)

Affects the lifecycle of the instance during deployment.

• PROACTIVE: Instance Groups can forcefully stop a running instance. This is the default.
• OPPORTUNISTIC: Instance Groups does not stop a running instance.
  Instead, it will wait until the instance stops itself or becomes unhealthy.

minimalAction

enum (MinimalAction)

If instance update requires a less disruptive action than minimalAction,
Instance Groups performs minimalAction to execute the update

• LIVE_UPDATE: Updating an instance without stopping. This is the default.
• RESTART: Updating an instance with restart: stopping and then starting the instance.
• RECREATE: Re-creating an instance: deleting an instance and creating a new one.

Field

Description

zones[]

Zone

List of availability zones.
The number of elements must be greater than or equal to 1.

Field

Description

zoneId

string

Required field. ID of the availability zone where the instance resides.
This field is required.

instanceTagsPool[]

string

Each instance in a zone will be associated with exactly one of a tag from a pool below.
All specified tags must be unique across the whole group not only the zone.
It is guaranteed that during whole deploy only tags from prefix of the specified list will be used.
It is possible to use tag associated with instance in templating via {instance.tag}.
The elements must be unique.
The length of each element must be between 3 and 50.

Field

Description

targetGroupSpec

TargetGroupSpec

Required field. Specification of the target group that the instance group will be added to. For more information, see Target groups and resources.

maxOpeningTrafficDuration

string (duration)

Timeout for waiting for the VM to be checked by the load balancer. If the timeout is exceeded,
the VM will be turned off based on the deployment policy. Specified in seconds.
The value must satisfy: >=1s.

ignoreHealthChecks

boolean

Do not wait load balancer health checks.

Field

Description

name

string

Name of the target group.
The value must match the regular expression: |[a-z]([-a-z0-9]{0,61}[a-z0-9])?.

Value must match the regular expression |[a-z]([-a-z0-9]{0,61}[a-z0-9])?.

description

string

Description of the target group.
The length must be less than or equal to 256.

labels

object (map<string, string>)

Resource labels as key:value pairs.
Each map key must match the regular expression: [a-z][-_./\\@0-9a-z]*.
Each map value must match the regular expression: [-_./\\@0-9a-z]*.
The length of each map key must be between 1 and 63.
The length of each map value must be less than or equal to 63.
The number of elements must be less than or equal to 64.

Each value must match the regular expression [-_./\@0-9a-z]*.

Field

Description

healthCheckSpecs[]

HealthCheckSpec

Health checking specification. For more information, see Health check.
The number of elements must be greater than or equal to 1.

maxCheckingHealthDuration

string (duration)

Timeout for waiting for the VM to become healthy. If the timeout is exceeded,
the VM will be turned off based on the deployment policy. Specified in seconds.
The value must satisfy: >=1s.

Field

Description

interval

string (duration)

The interval between health checks. The default is 2 seconds.
The value must satisfy: 1s-300s.

timeout

string (duration)

Timeout for the managed instance to return a response for the health check. The default is 1 second.
The value must satisfy: 1s-60s.

unhealthyThreshold

string (int64)

The number of failed health checks for the managed instance to be considered unhealthy. The default (0) is 2.
The value must satisfy: 0,2,3,4,5,6,7,8,9,10.

healthyThreshold

string (int64)

The number of successful health checks required in order for the managed instance to be considered healthy. The default (0) is 2.
The value must satisfy: 0,2,3,4,5,6,7,8,9,10.

tcpOptions

TcpOptions

Configuration options for a TCP health check.

Includes only one of the fields tcpOptions, httpOptions.

httpOptions

HttpOptions

Configuration options for an HTTP health check.

Includes only one of the fields tcpOptions, httpOptions.

Field

Description

port

string (int64)

Port to use for TCP health checks.
The value must be between 1 and 65535.

Field

Description

port

string (int64)

Port to use for HTTP health checks.
The value must be between 1 and 65535.

path

string

URL path to set for health checking requests.

Field

Description

key

string

Name of the variable.
The length must be between 1 and 128.
The value must match the regular expression: [a-zA-Z0-9._-]*.

Value must match the regular expression [a-zA-Z0-9._-]*.

value

string

Value of the variable.
The length must be less than or equal to 128.

Field

Description

targetGroupSpec

ApplicationTargetGroupSpec

Required field. Basic properties of the Application Load Balancer target group attributed to the instance group.
This field is required.

maxOpeningTrafficDuration

string (duration)

Timeout for waiting for the VM to be checked by the load balancer. If the timeout is exceeded,
the VM will be turned off based on the deployment policy. Specified in seconds.
The value must satisfy: >=1s.

ignoreHealthChecks

boolean

Do not wait load balancer health checks.

Field

Description

name

string

Name of the target group.

Value must match the regular expression |[a-z]([-a-z0-9]{0,61}[a-z0-9])?.

description

string

Description of the target group.

labels

object (map<string, string>)

Resource labels as key:value pairs.

Each value must match the regular expression [-_./\@0-9a-z]*.

Field

Description

autoHealingAction

enum (AutoHealingAction)

Instance Groups performs autoHealingAction when instance becomes unhealthy.

• NONE: No action
• RESTART: Re-starting an instance with restart: stopping and then starting the instance.
• RECREATE: Re-creating an instance: deleting an instance and creating a new one.

Field

Description

id

string

ID of the operation.

description

string

Description of the operation. 0-256 characters long.

createdAt

string (date-time)

Creation timestamp.

String in RFC3339 text format. The range of possible values is from
0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, i.e. from 0 to 9 digits for fractions of a second.

To work with values in this field, use the APIs described in the
Protocol Buffers reference.
In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).

createdBy

string

ID of the user or service account who initiated the operation.

modifiedAt

string (date-time)

The time when the Operation resource was last modified.

String in RFC3339 text format. The range of possible values is from
0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, i.e. from 0 to 9 digits for fractions of a second.

To work with values in this field, use the APIs described in the
Protocol Buffers reference.
In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).

done

boolean

If the value is false, it means the operation is still in progress.
If true, the operation is completed, and either error or response is available.

metadata

object

Service-specific metadata associated with the operation.
It typically contains the ID of the target resource that the operation is performed on.
Any method that returns a long-running operation should document the metadata type, if any.

error

Status

The error result of the operation in case of failure or cancellation.

Includes only one of the fields error, response.

The operation result.
If done == false and there was no failure detected, neither error nor response is set.
If done == false and there was a failure detected, error is set.
If done == true, exactly one of error or response is set.

response

object

The normal response of the operation in case of success.
If the original method returns no data on success, such as Delete,
the response is google.protobuf.Empty.
If the original method is the standard Create/Update,
the response should be the target resource of the operation.
Any method that returns a long-running operation should document the response type, if any.

Includes only one of the fields error, response.

The operation result.
If done == false and there was no failure detected, neither error nor response is set.
If done == false and there was a failure detected, error is set.
If done == true, exactly one of error or response is set.

Field

Description

code

integer (int32)

Error code. An enum value of google.rpc.Code.

message

string

An error message.

details[]

object

A list of messages that carry the error details.