BulkInsertInstanceResource

A transient resource used in compute.instances.bulkInsert and compute.regionInstances.bulkInsert . This resource is not persisted anywhere, it is used only for processing the requests.

JSON representation
{
  "count": string,
  "minCount": string,
  "namePattern": string,
  "perInstanceProperties": {
    string: {
      object (PerInstanceProperties)
    },
    ...
  },
  "sourceInstanceTemplate": string,
  "instanceProperties": {
    object (InstanceProperties)
  },
  "locationPolicy": {
    object (LocationPolicy)
  }
}
Fields
count

string (int64 format)

The maximum number of instances to create.

minCount

string (int64 format)

The minimum number of instances to create. If no

minCount

is specified then

count

is used as the default value. If

minCount

instances cannot be created, then no instances will be created and instances already created will be deleted.

namePattern

string

The string pattern used for the names of the VMs. Either

namePattern

or

perInstanceProperties

must be set. The pattern must contain one continuous sequence of placeholder hash characters (#) with each character corresponding to one digit of the generated instance name. Example: a

namePattern

of

inst-####

generates instance names such as

inst-0001

and

inst-0002

. If existing instances in the same project and zone have names that match the name pattern then the generated instance numbers start after the biggest existing number. For example, if there exists an instance with name

inst-0050

, then instance names generated using the pattern

inst-####

begin with

inst-0051

. The name pattern placeholder

#...#

can contain up to 18 characters.

perInstanceProperties

map (key: string, value: object (PerInstanceProperties))

Per-instance properties to be set on individual instances. Keys of this map specify requested instance names. Can be empty if

namePattern

is used.

sourceInstanceTemplate

string

Specifies the instance template from which to create instances. You may combine

sourceInstanceTemplate

with

instanceProperties

to override specific values from an existing instance template. Bulk API follows the semantics of JSON Merge Patch described by RFC 7396.

It can be a full or partial URL. For example, the following are all valid URLs to an instance template:

This field is optional.

instanceProperties

object (InstanceProperties)

The instance properties defining the VM instances to be created. Required if

sourceInstanceTemplate

is not provided.

locationPolicy

object (LocationPolicy)

Policy for choosing target zone. For more information, see Create VMs in bulk.

PerInstanceProperties

Per-instance properties to be set on individual instances. To be extended in the future.

JSON representation
{
  "name": string,
  "hostname": string
}
Fields
name

string

This field is only temporary. It will be removed. Do not use it.

hostname

string

Specifies the hostname of the instance. More details in: https://cloud.google.com/compute/docs/instances/custom-hostname-vm#naming_convention