1. Docs
  2. Reference
  3. API
  4. GCP
  5. compute
  6. InstanceGroupManager

InstanceGroupManager

The Google Compute Engine Instance Group Manager API creates and manages pools of homogeneous Compute Engine virtual machine instances from a common instance template. For more information, see the official documentation and API

Note: Use gcp.compute.RegionInstanceGroupManager to create a regional (multi-zone) instance group manager.

Create a InstanceGroupManager Resource

new InstanceGroupManager(name: string, args: InstanceGroupManagerArgs, opts?: CustomResourceOptions);
def InstanceGroupManager(resource_name, opts=None, auto_healing_policies=None, base_instance_name=None, description=None, name=None, named_ports=None, project=None, stateful_disks=None, target_pools=None, target_size=None, update_policy=None, versions=None, wait_for_instances=None, zone=None, __props__=None);
func NewInstanceGroupManager(ctx *Context, name string, args InstanceGroupManagerArgs, opts ...ResourceOption) (*InstanceGroupManager, error)
public InstanceGroupManager(string name, InstanceGroupManagerArgs args, CustomResourceOptions? opts = null)
name string
The unique name of the resource.
args InstanceGroupManagerArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
resource_name str
The unique name of the resource.
opts ResourceOptions
A bag of options that control this resource's behavior.
ctx Context
Context object for the current deployment.
name string
The unique name of the resource.
args InstanceGroupManagerArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name string
The unique name of the resource.
args InstanceGroupManagerArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.

InstanceGroupManager Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Programming Model docs.

Inputs

The InstanceGroupManager resource accepts the following input properties:

BaseInstanceName string

The base instance name to use for instances in this group. The value must be a valid RFC1035 name. Supported characters are lowercase letters, numbers, and hyphens (-). Instances are named by appending a hyphen and a random four-character string to the base instance name.

Versions List<InstanceGroupManagerVersionArgs>

Application versions managed by this instance group. Each version deals with a specific instance template, allowing canary release scenarios. Structure is documented below.

AutoHealingPolicies InstanceGroupManagerAutoHealingPoliciesArgs

The autohealing policies for this managed instance group. You can specify only one value. Structure is documented below. For more information, see the official documentation.

Description string

An optional textual description of the instance group manager.

Name string
  • Version name.
NamedPorts List<InstanceGroupManagerNamedPortArgs>

The named port configuration. See the section below for details on configuration.

Project string

The ID of the project in which the resource belongs. If it is not provided, the provider project is used.

StatefulDisks List<InstanceGroupManagerStatefulDiskArgs>

Disks created on the instances that will be preserved on instance delete, update, etc. Structure is documented below. For more information see the official documentation.

TargetPools List<string>

The full URL of all target pools to which new instances in the group are added. Updating the target pools attribute does not affect existing instances.

TargetSize int
  • The number of instances calculated as a fixed number or a percentage depending on the settings. Structure is documented below.
UpdatePolicy InstanceGroupManagerUpdatePolicyArgs

The update policy for this managed instance group. Structure is documented below. For more information, see the official documentation and API

WaitForInstances bool

Whether to wait for all instances to be created/updated before returning. Note that if this is set to true and the operation does not succeed, this provider will continue trying until it times out.

Zone string

The zone that instances in this group should be created in.

BaseInstanceName string

The base instance name to use for instances in this group. The value must be a valid RFC1035 name. Supported characters are lowercase letters, numbers, and hyphens (-). Instances are named by appending a hyphen and a random four-character string to the base instance name.

Versions []InstanceGroupManagerVersion

Application versions managed by this instance group. Each version deals with a specific instance template, allowing canary release scenarios. Structure is documented below.

AutoHealingPolicies InstanceGroupManagerAutoHealingPolicies

The autohealing policies for this managed instance group. You can specify only one value. Structure is documented below. For more information, see the official documentation.

Description string

An optional textual description of the instance group manager.

Name string
  • Version name.
NamedPorts []InstanceGroupManagerNamedPort

The named port configuration. See the section below for details on configuration.

Project string

The ID of the project in which the resource belongs. If it is not provided, the provider project is used.

StatefulDisks []InstanceGroupManagerStatefulDisk

Disks created on the instances that will be preserved on instance delete, update, etc. Structure is documented below. For more information see the official documentation.

TargetPools []string

The full URL of all target pools to which new instances in the group are added. Updating the target pools attribute does not affect existing instances.

TargetSize int
  • The number of instances calculated as a fixed number or a percentage depending on the settings. Structure is documented below.
UpdatePolicy InstanceGroupManagerUpdatePolicy

The update policy for this managed instance group. Structure is documented below. For more information, see the official documentation and API

WaitForInstances bool

Whether to wait for all instances to be created/updated before returning. Note that if this is set to true and the operation does not succeed, this provider will continue trying until it times out.

Zone string

The zone that instances in this group should be created in.

baseInstanceName string

The base instance name to use for instances in this group. The value must be a valid RFC1035 name. Supported characters are lowercase letters, numbers, and hyphens (-). Instances are named by appending a hyphen and a random four-character string to the base instance name.

versions InstanceGroupManagerVersion[]

Application versions managed by this instance group. Each version deals with a specific instance template, allowing canary release scenarios. Structure is documented below.

autoHealingPolicies InstanceGroupManagerAutoHealingPolicies

The autohealing policies for this managed instance group. You can specify only one value. Structure is documented below. For more information, see the official documentation.

description string

An optional textual description of the instance group manager.

name string
  • Version name.
namedPorts InstanceGroupManagerNamedPort[]

The named port configuration. See the section below for details on configuration.

project string

The ID of the project in which the resource belongs. If it is not provided, the provider project is used.

statefulDisks InstanceGroupManagerStatefulDisk[]

Disks created on the instances that will be preserved on instance delete, update, etc. Structure is documented below. For more information see the official documentation.

targetPools string[]

The full URL of all target pools to which new instances in the group are added. Updating the target pools attribute does not affect existing instances.

targetSize number
  • The number of instances calculated as a fixed number or a percentage depending on the settings. Structure is documented below.
updatePolicy InstanceGroupManagerUpdatePolicy

The update policy for this managed instance group. Structure is documented below. For more information, see the official documentation and API

waitForInstances boolean

Whether to wait for all instances to be created/updated before returning. Note that if this is set to true and the operation does not succeed, this provider will continue trying until it times out.

zone string

The zone that instances in this group should be created in.

base_instance_name str

The base instance name to use for instances in this group. The value must be a valid RFC1035 name. Supported characters are lowercase letters, numbers, and hyphens (-). Instances are named by appending a hyphen and a random four-character string to the base instance name.

versions List[InstanceGroupManagerVersion]

Application versions managed by this instance group. Each version deals with a specific instance template, allowing canary release scenarios. Structure is documented below.

auto_healing_policies Dict[InstanceGroupManagerAutoHealingPolicies]

The autohealing policies for this managed instance group. You can specify only one value. Structure is documented below. For more information, see the official documentation.

description str

An optional textual description of the instance group manager.

name str
  • Version name.
named_ports List[InstanceGroupManagerNamedPort]

The named port configuration. See the section below for details on configuration.

project str

The ID of the project in which the resource belongs. If it is not provided, the provider project is used.

stateful_disks List[InstanceGroupManagerStatefulDisk]

Disks created on the instances that will be preserved on instance delete, update, etc. Structure is documented below. For more information see the official documentation.

target_pools List[str]

The full URL of all target pools to which new instances in the group are added. Updating the target pools attribute does not affect existing instances.

target_size float
  • The number of instances calculated as a fixed number or a percentage depending on the settings. Structure is documented below.
update_policy Dict[InstanceGroupManagerUpdatePolicy]

The update policy for this managed instance group. Structure is documented below. For more information, see the official documentation and API

wait_for_instances bool

Whether to wait for all instances to be created/updated before returning. Note that if this is set to true and the operation does not succeed, this provider will continue trying until it times out.

zone str

The zone that instances in this group should be created in.

Outputs

All input properties are implicitly available as output properties. Additionally, the InstanceGroupManager resource produces the following output properties:

Fingerprint string

The fingerprint of the instance group manager.

Id string
The provider-assigned unique ID for this managed resource.
InstanceGroup string

The full URL of the instance group created by the manager.

SelfLink string

The URL of the created resource.

Fingerprint string

The fingerprint of the instance group manager.

Id string
The provider-assigned unique ID for this managed resource.
InstanceGroup string

The full URL of the instance group created by the manager.

SelfLink string

The URL of the created resource.

fingerprint string

The fingerprint of the instance group manager.

id string
The provider-assigned unique ID for this managed resource.
instanceGroup string

The full URL of the instance group created by the manager.

selfLink string

The URL of the created resource.

fingerprint str

The fingerprint of the instance group manager.

id str
The provider-assigned unique ID for this managed resource.
instance_group str

The full URL of the instance group created by the manager.

self_link str

The URL of the created resource.

Look up an Existing InstanceGroupManager Resource

Get an existing InstanceGroupManager resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

public static get(name: string, id: Input<ID>, state?: InstanceGroupManagerState, opts?: CustomResourceOptions): InstanceGroupManager
static get(resource_name, id, opts=None, auto_healing_policies=None, base_instance_name=None, description=None, fingerprint=None, instance_group=None, name=None, named_ports=None, project=None, self_link=None, stateful_disks=None, target_pools=None, target_size=None, update_policy=None, versions=None, wait_for_instances=None, zone=None, __props__=None);
func GetInstanceGroupManager(ctx *Context, name string, id IDInput, state *InstanceGroupManagerState, opts ...ResourceOption) (*InstanceGroupManager, error)
public static InstanceGroupManager Get(string name, Input<string> id, InstanceGroupManagerState? state, CustomResourceOptions? opts = null)
name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
resource_name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.

The following state arguments are supported:

AutoHealingPolicies InstanceGroupManagerAutoHealingPoliciesArgs

The autohealing policies for this managed instance group. You can specify only one value. Structure is documented below. For more information, see the official documentation.

BaseInstanceName string

The base instance name to use for instances in this group. The value must be a valid RFC1035 name. Supported characters are lowercase letters, numbers, and hyphens (-). Instances are named by appending a hyphen and a random four-character string to the base instance name.

Description string

An optional textual description of the instance group manager.

Fingerprint string

The fingerprint of the instance group manager.

InstanceGroup string

The full URL of the instance group created by the manager.

Name string
  • Version name.
NamedPorts List<InstanceGroupManagerNamedPortArgs>

The named port configuration. See the section below for details on configuration.

Project string

The ID of the project in which the resource belongs. If it is not provided, the provider project is used.

SelfLink string

The URL of the created resource.

StatefulDisks List<InstanceGroupManagerStatefulDiskArgs>

Disks created on the instances that will be preserved on instance delete, update, etc. Structure is documented below. For more information see the official documentation.

TargetPools List<string>

The full URL of all target pools to which new instances in the group are added. Updating the target pools attribute does not affect existing instances.

TargetSize int
  • The number of instances calculated as a fixed number or a percentage depending on the settings. Structure is documented below.
UpdatePolicy InstanceGroupManagerUpdatePolicyArgs

The update policy for this managed instance group. Structure is documented below. For more information, see the official documentation and API

Versions List<InstanceGroupManagerVersionArgs>

Application versions managed by this instance group. Each version deals with a specific instance template, allowing canary release scenarios. Structure is documented below.

WaitForInstances bool

Whether to wait for all instances to be created/updated before returning. Note that if this is set to true and the operation does not succeed, this provider will continue trying until it times out.

Zone string

The zone that instances in this group should be created in.

AutoHealingPolicies InstanceGroupManagerAutoHealingPolicies

The autohealing policies for this managed instance group. You can specify only one value. Structure is documented below. For more information, see the official documentation.

BaseInstanceName string

The base instance name to use for instances in this group. The value must be a valid RFC1035 name. Supported characters are lowercase letters, numbers, and hyphens (-). Instances are named by appending a hyphen and a random four-character string to the base instance name.

Description string

An optional textual description of the instance group manager.

Fingerprint string

The fingerprint of the instance group manager.

InstanceGroup string

The full URL of the instance group created by the manager.

Name string
  • Version name.
NamedPorts []InstanceGroupManagerNamedPort

The named port configuration. See the section below for details on configuration.

Project string

The ID of the project in which the resource belongs. If it is not provided, the provider project is used.

SelfLink string

The URL of the created resource.

StatefulDisks []InstanceGroupManagerStatefulDisk

Disks created on the instances that will be preserved on instance delete, update, etc. Structure is documented below. For more information see the official documentation.

TargetPools []string

The full URL of all target pools to which new instances in the group are added. Updating the target pools attribute does not affect existing instances.

TargetSize int
  • The number of instances calculated as a fixed number or a percentage depending on the settings. Structure is documented below.
UpdatePolicy InstanceGroupManagerUpdatePolicy

The update policy for this managed instance group. Structure is documented below. For more information, see the official documentation and API

Versions []InstanceGroupManagerVersion

Application versions managed by this instance group. Each version deals with a specific instance template, allowing canary release scenarios. Structure is documented below.

WaitForInstances bool

Whether to wait for all instances to be created/updated before returning. Note that if this is set to true and the operation does not succeed, this provider will continue trying until it times out.

Zone string

The zone that instances in this group should be created in.

autoHealingPolicies InstanceGroupManagerAutoHealingPolicies

The autohealing policies for this managed instance group. You can specify only one value. Structure is documented below. For more information, see the official documentation.

baseInstanceName string

The base instance name to use for instances in this group. The value must be a valid RFC1035 name. Supported characters are lowercase letters, numbers, and hyphens (-). Instances are named by appending a hyphen and a random four-character string to the base instance name.

description string

An optional textual description of the instance group manager.

fingerprint string

The fingerprint of the instance group manager.

instanceGroup string

The full URL of the instance group created by the manager.

name string
  • Version name.
namedPorts InstanceGroupManagerNamedPort[]

The named port configuration. See the section below for details on configuration.

project string

The ID of the project in which the resource belongs. If it is not provided, the provider project is used.

selfLink string

The URL of the created resource.

statefulDisks InstanceGroupManagerStatefulDisk[]

Disks created on the instances that will be preserved on instance delete, update, etc. Structure is documented below. For more information see the official documentation.

targetPools string[]

The full URL of all target pools to which new instances in the group are added. Updating the target pools attribute does not affect existing instances.

targetSize number
  • The number of instances calculated as a fixed number or a percentage depending on the settings. Structure is documented below.
updatePolicy InstanceGroupManagerUpdatePolicy

The update policy for this managed instance group. Structure is documented below. For more information, see the official documentation and API

versions InstanceGroupManagerVersion[]

Application versions managed by this instance group. Each version deals with a specific instance template, allowing canary release scenarios. Structure is documented below.

waitForInstances boolean

Whether to wait for all instances to be created/updated before returning. Note that if this is set to true and the operation does not succeed, this provider will continue trying until it times out.

zone string

The zone that instances in this group should be created in.

auto_healing_policies Dict[InstanceGroupManagerAutoHealingPolicies]

The autohealing policies for this managed instance group. You can specify only one value. Structure is documented below. For more information, see the official documentation.

base_instance_name str

The base instance name to use for instances in this group. The value must be a valid RFC1035 name. Supported characters are lowercase letters, numbers, and hyphens (-). Instances are named by appending a hyphen and a random four-character string to the base instance name.

description str

An optional textual description of the instance group manager.

fingerprint str

The fingerprint of the instance group manager.

instance_group str

The full URL of the instance group created by the manager.

name str
  • Version name.
named_ports List[InstanceGroupManagerNamedPort]

The named port configuration. See the section below for details on configuration.

project str

The ID of the project in which the resource belongs. If it is not provided, the provider project is used.

self_link str

The URL of the created resource.

stateful_disks List[InstanceGroupManagerStatefulDisk]

Disks created on the instances that will be preserved on instance delete, update, etc. Structure is documented below. For more information see the official documentation.

target_pools List[str]

The full URL of all target pools to which new instances in the group are added. Updating the target pools attribute does not affect existing instances.

target_size float
  • The number of instances calculated as a fixed number or a percentage depending on the settings. Structure is documented below.
update_policy Dict[InstanceGroupManagerUpdatePolicy]

The update policy for this managed instance group. Structure is documented below. For more information, see the official documentation and API

versions List[InstanceGroupManagerVersion]

Application versions managed by this instance group. Each version deals with a specific instance template, allowing canary release scenarios. Structure is documented below.

wait_for_instances bool

Whether to wait for all instances to be created/updated before returning. Note that if this is set to true and the operation does not succeed, this provider will continue trying until it times out.

zone str

The zone that instances in this group should be created in.

Supporting Types

InstanceGroupManagerAutoHealingPolicies

See the input and output API doc for this type.

See the input and output API doc for this type.

See the input and output API doc for this type.

HealthCheck string

The health check resource that signals autohealing.

InitialDelaySec int

The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. Between 0 and 3600.

HealthCheck string

The health check resource that signals autohealing.

InitialDelaySec int

The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. Between 0 and 3600.

healthCheck string

The health check resource that signals autohealing.

initialDelaySec number

The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. Between 0 and 3600.

healthCheck str

The health check resource that signals autohealing.

initialDelaySec float

The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. Between 0 and 3600.

InstanceGroupManagerNamedPort

See the input and output API doc for this type.

See the input and output API doc for this type.

See the input and output API doc for this type.

Name string
  • Version name.
Port int

The port number.

Name string
  • Version name.
Port int

The port number.

name string
  • Version name.
port number

The port number.

name str
  • Version name.
port float

The port number.

InstanceGroupManagerStatefulDisk

See the input and output API doc for this type.

See the input and output API doc for this type.

See the input and output API doc for this type.

DeviceName string

, The device name of the disk to be attached.

DeleteRule string

, A value that prescribes what should happen to the stateful disk when the VM instance is deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER detatch the disk when the VM is deleted, but not delete the disk. ON_PERMANENT_INSTANCE_DELETION will delete the stateful disk when the VM is permanently deleted from the instance group. The default is NEVER.

DeviceName string

, The device name of the disk to be attached.

DeleteRule string

, A value that prescribes what should happen to the stateful disk when the VM instance is deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER detatch the disk when the VM is deleted, but not delete the disk. ON_PERMANENT_INSTANCE_DELETION will delete the stateful disk when the VM is permanently deleted from the instance group. The default is NEVER.

deviceName string

, The device name of the disk to be attached.

deleteRule string

, A value that prescribes what should happen to the stateful disk when the VM instance is deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER detatch the disk when the VM is deleted, but not delete the disk. ON_PERMANENT_INSTANCE_DELETION will delete the stateful disk when the VM is permanently deleted from the instance group. The default is NEVER.

device_name str

, The device name of the disk to be attached.

deleteRule str

, A value that prescribes what should happen to the stateful disk when the VM instance is deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER detatch the disk when the VM is deleted, but not delete the disk. ON_PERMANENT_INSTANCE_DELETION will delete the stateful disk when the VM is permanently deleted from the instance group. The default is NEVER.

InstanceGroupManagerUpdatePolicy

See the input and output API doc for this type.

See the input and output API doc for this type.

See the input and output API doc for this type.

MinimalAction string
  • Minimal action to be taken on an instance. You can specify either RESTART to restart existing instances or REPLACE to delete and create new instances from the target template. If you specify a RESTART, the Updater will attempt to perform that action only. However, if the Updater determines that the minimal action you specify is not enough to perform the update, it might perform a more disruptive action.
Type string
  • The type of update process. You can specify either PROACTIVE so that the instance group manager proactively executes actions in order to bring instances to their target versions or OPPORTUNISTIC so that no action is proactively executed but the update will be performed as part of other actions (for example, resizes or recreateInstances calls).
MaxSurgeFixed int

, The maximum number of instances that can be created above the specified targetSize during the update process. Conflicts with max_surge_percent. If neither is set, defaults to 1

MaxSurgePercent int

, The maximum number of instances(calculated as percentage) that can be created above the specified targetSize during the update process. Conflicts with max_surge_fixed.

MaxUnavailableFixed int

, The maximum number of instances that can be unavailable during the update process. Conflicts with max_unavailable_percent. If neither is set, defaults to 1

MaxUnavailablePercent int

, The maximum number of instances(calculated as percentage) that can be unavailable during the update process. Conflicts with max_unavailable_fixed.

MinReadySec int

, Minimum number of seconds to wait for after a newly created instance becomes available. This value must be from range [0, 3600]

MinimalAction string
  • Minimal action to be taken on an instance. You can specify either RESTART to restart existing instances or REPLACE to delete and create new instances from the target template. If you specify a RESTART, the Updater will attempt to perform that action only. However, if the Updater determines that the minimal action you specify is not enough to perform the update, it might perform a more disruptive action.
Type string
  • The type of update process. You can specify either PROACTIVE so that the instance group manager proactively executes actions in order to bring instances to their target versions or OPPORTUNISTIC so that no action is proactively executed but the update will be performed as part of other actions (for example, resizes or recreateInstances calls).
MaxSurgeFixed int

, The maximum number of instances that can be created above the specified targetSize during the update process. Conflicts with max_surge_percent. If neither is set, defaults to 1

MaxSurgePercent int

, The maximum number of instances(calculated as percentage) that can be created above the specified targetSize during the update process. Conflicts with max_surge_fixed.

MaxUnavailableFixed int

, The maximum number of instances that can be unavailable during the update process. Conflicts with max_unavailable_percent. If neither is set, defaults to 1

MaxUnavailablePercent int

, The maximum number of instances(calculated as percentage) that can be unavailable during the update process. Conflicts with max_unavailable_fixed.

MinReadySec int

, Minimum number of seconds to wait for after a newly created instance becomes available. This value must be from range [0, 3600]

minimalAction string
  • Minimal action to be taken on an instance. You can specify either RESTART to restart existing instances or REPLACE to delete and create new instances from the target template. If you specify a RESTART, the Updater will attempt to perform that action only. However, if the Updater determines that the minimal action you specify is not enough to perform the update, it might perform a more disruptive action.
type string
  • The type of update process. You can specify either PROACTIVE so that the instance group manager proactively executes actions in order to bring instances to their target versions or OPPORTUNISTIC so that no action is proactively executed but the update will be performed as part of other actions (for example, resizes or recreateInstances calls).
maxSurgeFixed number

, The maximum number of instances that can be created above the specified targetSize during the update process. Conflicts with max_surge_percent. If neither is set, defaults to 1

maxSurgePercent number

, The maximum number of instances(calculated as percentage) that can be created above the specified targetSize during the update process. Conflicts with max_surge_fixed.

maxUnavailableFixed number

, The maximum number of instances that can be unavailable during the update process. Conflicts with max_unavailable_percent. If neither is set, defaults to 1

maxUnavailablePercent number

, The maximum number of instances(calculated as percentage) that can be unavailable during the update process. Conflicts with max_unavailable_fixed.

minReadySec number

, Minimum number of seconds to wait for after a newly created instance becomes available. This value must be from range [0, 3600]

minimal_action str
  • Minimal action to be taken on an instance. You can specify either RESTART to restart existing instances or REPLACE to delete and create new instances from the target template. If you specify a RESTART, the Updater will attempt to perform that action only. However, if the Updater determines that the minimal action you specify is not enough to perform the update, it might perform a more disruptive action.
type str
  • The type of update process. You can specify either PROACTIVE so that the instance group manager proactively executes actions in order to bring instances to their target versions or OPPORTUNISTIC so that no action is proactively executed but the update will be performed as part of other actions (for example, resizes or recreateInstances calls).
maxSurgeFixed float

, The maximum number of instances that can be created above the specified targetSize during the update process. Conflicts with max_surge_percent. If neither is set, defaults to 1

maxSurgePercent float

, The maximum number of instances(calculated as percentage) that can be created above the specified targetSize during the update process. Conflicts with max_surge_fixed.

maxUnavailableFixed float

, The maximum number of instances that can be unavailable during the update process. Conflicts with max_unavailable_percent. If neither is set, defaults to 1

maxUnavailablePercent float

, The maximum number of instances(calculated as percentage) that can be unavailable during the update process. Conflicts with max_unavailable_fixed.

minReadySec float

, Minimum number of seconds to wait for after a newly created instance becomes available. This value must be from range [0, 3600]

InstanceGroupManagerVersion

See the input and output API doc for this type.

See the input and output API doc for this type.

See the input and output API doc for this type.

InstanceTemplate string
  • The full URL to an instance template from which all new instances of this version will be created.
Name string
  • Version name.
TargetSize InstanceGroupManagerVersionTargetSizeArgs
  • The number of instances calculated as a fixed number or a percentage depending on the settings. Structure is documented below.
InstanceTemplate string
  • The full URL to an instance template from which all new instances of this version will be created.
Name string
  • Version name.
TargetSize InstanceGroupManagerVersionTargetSize
  • The number of instances calculated as a fixed number or a percentage depending on the settings. Structure is documented below.
instanceTemplate string
  • The full URL to an instance template from which all new instances of this version will be created.
name string
  • Version name.
targetSize InstanceGroupManagerVersionTargetSize
  • The number of instances calculated as a fixed number or a percentage depending on the settings. Structure is documented below.
instanceTemplate str
  • The full URL to an instance template from which all new instances of this version will be created.
name str
  • Version name.
target_size Dict[InstanceGroupManagerVersionTargetSize]
  • The number of instances calculated as a fixed number or a percentage depending on the settings. Structure is documented below.

InstanceGroupManagerVersionTargetSize

See the input and output API doc for this type.

See the input and output API doc for this type.

See the input and output API doc for this type.

Fixed int

, The number of instances which are managed for this version. Conflicts with percent.

Percent int

, The number of instances (calculated as percentage) which are managed for this version. Conflicts with fixed. Note that when using percent, rounding will be in favor of explicitly set target_size values; a managed instance group with 2 instances and 2 versions, one of which has a target_size.percent of 60 will create 2 instances of that version.

Fixed int

, The number of instances which are managed for this version. Conflicts with percent.

Percent int

, The number of instances (calculated as percentage) which are managed for this version. Conflicts with fixed. Note that when using percent, rounding will be in favor of explicitly set target_size values; a managed instance group with 2 instances and 2 versions, one of which has a target_size.percent of 60 will create 2 instances of that version.

fixed number

, The number of instances which are managed for this version. Conflicts with percent.

percent number

, The number of instances (calculated as percentage) which are managed for this version. Conflicts with fixed. Note that when using percent, rounding will be in favor of explicitly set target_size values; a managed instance group with 2 instances and 2 versions, one of which has a target_size.percent of 60 will create 2 instances of that version.

fixed float

, The number of instances which are managed for this version. Conflicts with percent.

percent float

, The number of instances (calculated as percentage) which are managed for this version. Conflicts with fixed. Note that when using percent, rounding will be in favor of explicitly set target_size values; a managed instance group with 2 instances and 2 versions, one of which has a target_size.percent of 60 will create 2 instances of that version.

Package Details

Repository
https://github.com/pulumi/pulumi-gcp
License
Apache-2.0
Notes
This Pulumi package is based on the google-beta Terraform Provider.