Docs Home Pulumi IaC Pulumi ESC Pulumi Cloud Packages Tutorials
  1. Packages
  2. Google Cloud (GCP) Classic
  3. API Docs
  4. compute
  5. getInstanceGroupManager
Google Cloud v8.21.0 published on Wednesday, Mar 5, 2025 by Pulumi
pulumi/pulumi-gcp

gcp.compute.getInstanceGroupManager

Explore with Pulumi AI

gcp logo
Google Cloud v8.21.0 published on Wednesday, Mar 5, 2025 by Pulumi
pulumi/pulumi-gcp

    Get a Compute Instance Group Manager within GCE. For more information, see the official documentation and API

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";

const igm1 = gcp.compute.getInstanceGroupManager({
    name: "my-igm",
    zone: "us-central1-a",
});
const igm2 = gcp.compute.getInstanceGroupManager({
    selfLink: "https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroupManagers/my-igm",
});

    import pulumi
import pulumi_gcp as gcp

igm1 = gcp.compute.get_instance_group_manager(name="my-igm",
    zone="us-central1-a")
igm2 = gcp.compute.get_instance_group_manager(self_link="https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroupManagers/my-igm")

    package main

import (
	"github.com/pulumi/pulumi-gcp/sdk/v8/go/gcp/compute"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := compute.LookupInstanceGroupManager(ctx, &compute.LookupInstanceGroupManagerArgs{
			Name: pulumi.StringRef("my-igm"),
			Zone: pulumi.StringRef("us-central1-a"),
		}, nil)
		if err != nil {
			return err
		}
		_, err = compute.LookupInstanceGroupManager(ctx, &compute.LookupInstanceGroupManagerArgs{
			SelfLink: pulumi.StringRef("https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroupManagers/my-igm"),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;

return await Deployment.RunAsync(() => 
{
    var igm1 = Gcp.Compute.GetInstanceGroupManager.Invoke(new()
    {
        Name = "my-igm",
        Zone = "us-central1-a",
    });

    var igm2 = Gcp.Compute.GetInstanceGroupManager.Invoke(new()
    {
        SelfLink = "https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroupManagers/my-igm",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.compute.ComputeFunctions;
import com.pulumi.gcp.compute.inputs.GetInstanceGroupManagerArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        final var igm1 = ComputeFunctions.getInstanceGroupManager(GetInstanceGroupManagerArgs.builder()
            .name("my-igm")
            .zone("us-central1-a")
            .build());

        final var igm2 = ComputeFunctions.getInstanceGroupManager(GetInstanceGroupManagerArgs.builder()
            .selfLink("https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroupManagers/my-igm")
            .build());

    }
}

    variables:
  igm1:
    fn::invoke:
      function: gcp:compute:getInstanceGroupManager
      arguments:
        name: my-igm
        zone: us-central1-a
  igm2:
    fn::invoke:
      function: gcp:compute:getInstanceGroupManager
      arguments:
        selfLink: https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroupManagers/my-igm

    Using getInstanceGroupManager

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getInstanceGroupManager(args: GetInstanceGroupManagerArgs, opts?: InvokeOptions): Promise<GetInstanceGroupManagerResult>
function getInstanceGroupManagerOutput(args: GetInstanceGroupManagerOutputArgs, opts?: InvokeOptions): Output<GetInstanceGroupManagerResult>
    def get_instance_group_manager(name: Optional[str] = None,
                               project: Optional[str] = None,
                               self_link: Optional[str] = None,
                               zone: Optional[str] = None,
                               opts: Optional[InvokeOptions] = None) -> GetInstanceGroupManagerResult
def get_instance_group_manager_output(name: Optional[pulumi.Input[str]] = None,
                               project: Optional[pulumi.Input[str]] = None,
                               self_link: Optional[pulumi.Input[str]] = None,
                               zone: Optional[pulumi.Input[str]] = None,
                               opts: Optional[InvokeOptions] = None) -> Output[GetInstanceGroupManagerResult]
    func LookupInstanceGroupManager(ctx *Context, args *LookupInstanceGroupManagerArgs, opts ...InvokeOption) (*LookupInstanceGroupManagerResult, error)
func LookupInstanceGroupManagerOutput(ctx *Context, args *LookupInstanceGroupManagerOutputArgs, opts ...InvokeOption) LookupInstanceGroupManagerResultOutput

    > Note: This function is named LookupInstanceGroupManager in the Go SDK.

    public static class GetInstanceGroupManager 
{
    public static Task<GetInstanceGroupManagerResult> InvokeAsync(GetInstanceGroupManagerArgs args, InvokeOptions? opts = null)
    public static Output<GetInstanceGroupManagerResult> Invoke(GetInstanceGroupManagerInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetInstanceGroupManagerResult> getInstanceGroupManager(GetInstanceGroupManagerArgs args, InvokeOptions options)
public static Output<GetInstanceGroupManagerResult> getInstanceGroupManager(GetInstanceGroupManagerArgs args, InvokeOptions options)

    fn::invoke:
  function: gcp:compute/getInstanceGroupManager:getInstanceGroupManager
  arguments:
    # arguments dictionary

    The following arguments are supported:

    Name string
    The name of the instance group. Either name or self_link must be provided.
    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 self link of the instance group. Either name or self_link must be provided.
    Zone string
    The zone of the instance group. If referencing the instance group by name and zone is not provided, the provider zone is used.
    Name string
    The name of the instance group. Either name or self_link must be provided.
    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 self link of the instance group. Either name or self_link must be provided.
    Zone string
    The zone of the instance group. If referencing the instance group by name and zone is not provided, the provider zone is used.
    name String
    The name of the instance group. Either name or self_link must be provided.
    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 self link of the instance group. Either name or self_link must be provided.
    zone String
    The zone of the instance group. If referencing the instance group by name and zone is not provided, the provider zone is used.
    name string
    The name of the instance group. Either name or self_link must be provided.
    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 self link of the instance group. Either name or self_link must be provided.
    zone string
    The zone of the instance group. If referencing the instance group by name and zone is not provided, the provider zone is used.
    name str
    The name of the instance group. Either name or self_link must be provided.
    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 self link of the instance group. Either name or self_link must be provided.
    zone str
    The zone of the instance group. If referencing the instance group by name and zone is not provided, the provider zone is used.
    name String
    The name of the instance group. Either name or self_link must be provided.
    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 self link of the instance group. Either name or self_link must be provided.
    zone String
    The zone of the instance group. If referencing the instance group by name and zone is not provided, the provider zone is used.

    getInstanceGroupManager Result

    The following output properties are available:

    AllInstancesConfigs List<GetInstanceGroupManagerAllInstancesConfig>
    AutoHealingPolicies List<GetInstanceGroupManagerAutoHealingPolicy>
    BaseInstanceName string
    CreationTimestamp string
    Description string
    Fingerprint string
    Id string
    The provider-assigned unique ID for this managed resource.
    InstanceGroup string
    InstanceGroupManagerId int
    InstanceLifecyclePolicies List<GetInstanceGroupManagerInstanceLifecyclePolicy>
    ListManagedInstancesResults string
    NamedPorts List<GetInstanceGroupManagerNamedPort>
    Operation string
    Params List<GetInstanceGroupManagerParam>
    StandbyPolicies List<GetInstanceGroupManagerStandbyPolicy>
    StatefulDisks List<GetInstanceGroupManagerStatefulDisk>
    StatefulExternalIps List<GetInstanceGroupManagerStatefulExternalIp>
    StatefulInternalIps List<GetInstanceGroupManagerStatefulInternalIp>
    Statuses List<GetInstanceGroupManagerStatus>
    TargetPools List<string>
    TargetSize int
    TargetStoppedSize int
    TargetSuspendedSize int
    UpdatePolicies List<GetInstanceGroupManagerUpdatePolicy>
    Versions List<GetInstanceGroupManagerVersion>
    WaitForInstances bool
    WaitForInstancesStatus string
    Name string
    Project string
    SelfLink string
    Zone string
    AllInstancesConfigs []GetInstanceGroupManagerAllInstancesConfig
    AutoHealingPolicies []GetInstanceGroupManagerAutoHealingPolicy
    BaseInstanceName string
    CreationTimestamp string
    Description string
    Fingerprint string
    Id string
    The provider-assigned unique ID for this managed resource.
    InstanceGroup string
    InstanceGroupManagerId int
    InstanceLifecyclePolicies []GetInstanceGroupManagerInstanceLifecyclePolicy
    ListManagedInstancesResults string
    NamedPorts []GetInstanceGroupManagerNamedPort
    Operation string
    Params []GetInstanceGroupManagerParam
    StandbyPolicies []GetInstanceGroupManagerStandbyPolicy
    StatefulDisks []GetInstanceGroupManagerStatefulDisk
    StatefulExternalIps []GetInstanceGroupManagerStatefulExternalIp
    StatefulInternalIps []GetInstanceGroupManagerStatefulInternalIp
    Statuses []GetInstanceGroupManagerStatus
    TargetPools []string
    TargetSize int
    TargetStoppedSize int
    TargetSuspendedSize int
    UpdatePolicies []GetInstanceGroupManagerUpdatePolicy
    Versions []GetInstanceGroupManagerVersion
    WaitForInstances bool
    WaitForInstancesStatus string
    Name string
    Project string
    SelfLink string
    Zone string
    allInstancesConfigs List<GetInstanceGroupManagerAllInstancesConfig>
    autoHealingPolicies List<GetInstanceGroupManagerAutoHealingPolicy>
    baseInstanceName String
    creationTimestamp String
    description String
    fingerprint String
    id String
    The provider-assigned unique ID for this managed resource.
    instanceGroup String
    instanceGroupManagerId Integer
    instanceLifecyclePolicies List<GetInstanceGroupManagerInstanceLifecyclePolicy>
    listManagedInstancesResults String
    namedPorts List<GetInstanceGroupManagerNamedPort>
    operation String
    params List<GetInstanceGroupManagerParam>
    standbyPolicies List<GetInstanceGroupManagerStandbyPolicy>
    statefulDisks List<GetInstanceGroupManagerStatefulDisk>
    statefulExternalIps List<GetInstanceGroupManagerStatefulExternalIp>
    statefulInternalIps List<GetInstanceGroupManagerStatefulInternalIp>
    statuses List<GetInstanceGroupManagerStatus>
    targetPools List<String>
    targetSize Integer
    targetStoppedSize Integer
    targetSuspendedSize Integer
    updatePolicies List<GetInstanceGroupManagerUpdatePolicy>
    versions List<GetInstanceGroupManagerVersion>
    waitForInstances Boolean
    waitForInstancesStatus String
    name String
    project String
    selfLink String
    zone String
    allInstancesConfigs GetInstanceGroupManagerAllInstancesConfig[]
    autoHealingPolicies GetInstanceGroupManagerAutoHealingPolicy[]
    baseInstanceName string
    creationTimestamp string
    description string
    fingerprint string
    id string
    The provider-assigned unique ID for this managed resource.
    instanceGroup string
    instanceGroupManagerId number
    instanceLifecyclePolicies GetInstanceGroupManagerInstanceLifecyclePolicy[]
    listManagedInstancesResults string
    namedPorts GetInstanceGroupManagerNamedPort[]
    operation string
    params GetInstanceGroupManagerParam[]
    standbyPolicies GetInstanceGroupManagerStandbyPolicy[]
    statefulDisks GetInstanceGroupManagerStatefulDisk[]
    statefulExternalIps GetInstanceGroupManagerStatefulExternalIp[]
    statefulInternalIps GetInstanceGroupManagerStatefulInternalIp[]
    statuses GetInstanceGroupManagerStatus[]
    targetPools string[]
    targetSize number
    targetStoppedSize number
    targetSuspendedSize number
    updatePolicies GetInstanceGroupManagerUpdatePolicy[]
    versions GetInstanceGroupManagerVersion[]
    waitForInstances boolean
    waitForInstancesStatus string
    name string
    project string
    selfLink string
    zone string
    all_instances_configs Sequence[GetInstanceGroupManagerAllInstancesConfig]
    auto_healing_policies Sequence[GetInstanceGroupManagerAutoHealingPolicy]
    base_instance_name str
    creation_timestamp str
    description str
    fingerprint str
    id str
    The provider-assigned unique ID for this managed resource.
    instance_group str
    instance_group_manager_id int
    instance_lifecycle_policies Sequence[GetInstanceGroupManagerInstanceLifecyclePolicy]
    list_managed_instances_results str
    named_ports Sequence[GetInstanceGroupManagerNamedPort]
    operation str
    params Sequence[GetInstanceGroupManagerParam]
    standby_policies Sequence[GetInstanceGroupManagerStandbyPolicy]
    stateful_disks Sequence[GetInstanceGroupManagerStatefulDisk]
    stateful_external_ips Sequence[GetInstanceGroupManagerStatefulExternalIp]
    stateful_internal_ips Sequence[GetInstanceGroupManagerStatefulInternalIp]
    statuses Sequence[GetInstanceGroupManagerStatus]
    target_pools Sequence[str]
    target_size int
    target_stopped_size int
    target_suspended_size int
    update_policies Sequence[GetInstanceGroupManagerUpdatePolicy]
    versions Sequence[GetInstanceGroupManagerVersion]
    wait_for_instances bool
    wait_for_instances_status str
    name str
    project str
    self_link str
    zone str
    allInstancesConfigs List<Property Map>
    autoHealingPolicies List<Property Map>
    baseInstanceName String
    creationTimestamp String
    description String
    fingerprint String
    id String
    The provider-assigned unique ID for this managed resource.
    instanceGroup String
    instanceGroupManagerId Number
    instanceLifecyclePolicies List<Property Map>
    listManagedInstancesResults String
    namedPorts List<Property Map>
    operation String
    params List<Property Map>
    standbyPolicies List<Property Map>
    statefulDisks List<Property Map>
    statefulExternalIps List<Property Map>
    statefulInternalIps List<Property Map>
    statuses List<Property Map>
    targetPools List<String>
    targetSize Number
    targetStoppedSize Number
    targetSuspendedSize Number
    updatePolicies List<Property Map>
    versions List<Property Map>
    waitForInstances Boolean
    waitForInstancesStatus String
    name String
    project String
    selfLink String
    zone String

    Supporting Types

    GetInstanceGroupManagerAllInstancesConfig

    Labels Dictionary<string, string>
    The label key-value pairs that you want to patch onto the instance,
    Metadata Dictionary<string, string>
    The metadata key-value pairs that you want to patch onto the instance. For more information, see Project and instance metadata,
    Labels map[string]string
    The label key-value pairs that you want to patch onto the instance,
    Metadata map[string]string
    The metadata key-value pairs that you want to patch onto the instance. For more information, see Project and instance metadata,
    labels Map<String,String>
    The label key-value pairs that you want to patch onto the instance,
    metadata Map<String,String>
    The metadata key-value pairs that you want to patch onto the instance. For more information, see Project and instance metadata,
    labels {[key: string]: string}
    The label key-value pairs that you want to patch onto the instance,
    metadata {[key: string]: string}
    The metadata key-value pairs that you want to patch onto the instance. For more information, see Project and instance metadata,
    labels Mapping[str, str]
    The label key-value pairs that you want to patch onto the instance,
    metadata Mapping[str, str]
    The metadata key-value pairs that you want to patch onto the instance. For more information, see Project and instance metadata,
    labels Map<String>
    The label key-value pairs that you want to patch onto the instance,
    metadata Map<String>
    The metadata key-value pairs that you want to patch onto the instance. For more information, see Project and instance metadata,

    GetInstanceGroupManagerAutoHealingPolicy

    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 Integer
    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.
    health_check str
    The health check resource that signals autohealing.
    initial_delay_sec 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.

    GetInstanceGroupManagerInstanceLifecyclePolicy

    DefaultActionOnFailure string
    Default behavior for all instance or health check failures.
    ForceUpdateOnRepair string
    Specifies whether to apply the group's latest configuration when repairing a VM. Valid options are: YES, NO. If YES and you updated the group's instance template or per-instance configurations after the VM was created, then these changes are applied when VM is repaired. If NO (default), then updates are applied in accordance with the group's update policy type.
    DefaultActionOnFailure string
    Default behavior for all instance or health check failures.
    ForceUpdateOnRepair string
    Specifies whether to apply the group's latest configuration when repairing a VM. Valid options are: YES, NO. If YES and you updated the group's instance template or per-instance configurations after the VM was created, then these changes are applied when VM is repaired. If NO (default), then updates are applied in accordance with the group's update policy type.
    defaultActionOnFailure String
    Default behavior for all instance or health check failures.
    forceUpdateOnRepair String
    Specifies whether to apply the group's latest configuration when repairing a VM. Valid options are: YES, NO. If YES and you updated the group's instance template or per-instance configurations after the VM was created, then these changes are applied when VM is repaired. If NO (default), then updates are applied in accordance with the group's update policy type.
    defaultActionOnFailure string
    Default behavior for all instance or health check failures.
    forceUpdateOnRepair string
    Specifies whether to apply the group's latest configuration when repairing a VM. Valid options are: YES, NO. If YES and you updated the group's instance template or per-instance configurations after the VM was created, then these changes are applied when VM is repaired. If NO (default), then updates are applied in accordance with the group's update policy type.
    default_action_on_failure str
    Default behavior for all instance or health check failures.
    force_update_on_repair str
    Specifies whether to apply the group's latest configuration when repairing a VM. Valid options are: YES, NO. If YES and you updated the group's instance template or per-instance configurations after the VM was created, then these changes are applied when VM is repaired. If NO (default), then updates are applied in accordance with the group's update policy type.
    defaultActionOnFailure String
    Default behavior for all instance or health check failures.
    forceUpdateOnRepair String
    Specifies whether to apply the group's latest configuration when repairing a VM. Valid options are: YES, NO. If YES and you updated the group's instance template or per-instance configurations after the VM was created, then these changes are applied when VM is repaired. If NO (default), then updates are applied in accordance with the group's update policy type.

    GetInstanceGroupManagerNamedPort

    Name string
    The name of the instance group. Either name or self_link must be provided.
    Port int
    The port number.
    Name string
    The name of the instance group. Either name or self_link must be provided.
    Port int
    The port number.
    name String
    The name of the instance group. Either name or self_link must be provided.
    port Integer
    The port number.
    name string
    The name of the instance group. Either name or self_link must be provided.
    port number
    The port number.
    name str
    The name of the instance group. Either name or self_link must be provided.
    port int
    The port number.
    name String
    The name of the instance group. Either name or self_link must be provided.
    port Number
    The port number.

    GetInstanceGroupManagerParam

    ResourceManagerTags Dictionary<string, string>
    Resource manager tags to bind to the managed instance group. The tags are key-value pairs. Keys must be in the format tagKeys/123 and values in the format tagValues/456.
    ResourceManagerTags map[string]string
    Resource manager tags to bind to the managed instance group. The tags are key-value pairs. Keys must be in the format tagKeys/123 and values in the format tagValues/456.
    resourceManagerTags Map<String,String>
    Resource manager tags to bind to the managed instance group. The tags are key-value pairs. Keys must be in the format tagKeys/123 and values in the format tagValues/456.
    resourceManagerTags {[key: string]: string}
    Resource manager tags to bind to the managed instance group. The tags are key-value pairs. Keys must be in the format tagKeys/123 and values in the format tagValues/456.
    resource_manager_tags Mapping[str, str]
    Resource manager tags to bind to the managed instance group. The tags are key-value pairs. Keys must be in the format tagKeys/123 and values in the format tagValues/456.
    resourceManagerTags Map<String>
    Resource manager tags to bind to the managed instance group. The tags are key-value pairs. Keys must be in the format tagKeys/123 and values in the format tagValues/456.

    GetInstanceGroupManagerStandbyPolicy

    InitialDelaySec int
    Specifies the number of seconds that the MIG should wait to suspend or stop a VM after that VM was created. The initial delay gives the initialization script the time to prepare your VM for a quick scale out. The value of initial delay must be between 0 and 3600 seconds. The default value is 0.
    Mode string
    Defines how a MIG resumes or starts VMs from a standby pool when the group scales out. The default mode is "MANUAL".
    InitialDelaySec int
    Specifies the number of seconds that the MIG should wait to suspend or stop a VM after that VM was created. The initial delay gives the initialization script the time to prepare your VM for a quick scale out. The value of initial delay must be between 0 and 3600 seconds. The default value is 0.
    Mode string
    Defines how a MIG resumes or starts VMs from a standby pool when the group scales out. The default mode is "MANUAL".
    initialDelaySec Integer
    Specifies the number of seconds that the MIG should wait to suspend or stop a VM after that VM was created. The initial delay gives the initialization script the time to prepare your VM for a quick scale out. The value of initial delay must be between 0 and 3600 seconds. The default value is 0.
    mode String
    Defines how a MIG resumes or starts VMs from a standby pool when the group scales out. The default mode is "MANUAL".
    initialDelaySec number
    Specifies the number of seconds that the MIG should wait to suspend or stop a VM after that VM was created. The initial delay gives the initialization script the time to prepare your VM for a quick scale out. The value of initial delay must be between 0 and 3600 seconds. The default value is 0.
    mode string
    Defines how a MIG resumes or starts VMs from a standby pool when the group scales out. The default mode is "MANUAL".
    initial_delay_sec int
    Specifies the number of seconds that the MIG should wait to suspend or stop a VM after that VM was created. The initial delay gives the initialization script the time to prepare your VM for a quick scale out. The value of initial delay must be between 0 and 3600 seconds. The default value is 0.
    mode str
    Defines how a MIG resumes or starts VMs from a standby pool when the group scales out. The default mode is "MANUAL".
    initialDelaySec Number
    Specifies the number of seconds that the MIG should wait to suspend or stop a VM after that VM was created. The initial delay gives the initialization script the time to prepare your VM for a quick scale out. The value of initial delay must be between 0 and 3600 seconds. The default value is 0.
    mode String
    Defines how a MIG resumes or starts VMs from a standby pool when the group scales out. The default mode is "MANUAL".

    GetInstanceGroupManagerStatefulDisk

    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 - detach the disk when the VM is deleted, but do 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 - detach the disk when the VM is deleted, but do 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 - detach the disk when the VM is deleted, but do 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 - detach the disk when the VM is deleted, but do 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.
    delete_rule 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 - detach the disk when the VM is deleted, but do 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 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 - detach the disk when the VM is deleted, but do 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.

    GetInstanceGroupManagerStatefulExternalIp

    DeleteRule string
    A value that prescribes what should happen to an associated static Address resource when a VM instance is permanently deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER - detach the IP when the VM is deleted, but do not delete the address resource. ON_PERMANENT_INSTANCE_DELETION will delete the stateful address when the VM is permanently deleted from the instance group. The default is NEVER.
    InterfaceName string
    The network interface name
    DeleteRule string
    A value that prescribes what should happen to an associated static Address resource when a VM instance is permanently deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER - detach the IP when the VM is deleted, but do not delete the address resource. ON_PERMANENT_INSTANCE_DELETION will delete the stateful address when the VM is permanently deleted from the instance group. The default is NEVER.
    InterfaceName string
    The network interface name
    deleteRule String
    A value that prescribes what should happen to an associated static Address resource when a VM instance is permanently deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER - detach the IP when the VM is deleted, but do not delete the address resource. ON_PERMANENT_INSTANCE_DELETION will delete the stateful address when the VM is permanently deleted from the instance group. The default is NEVER.
    interfaceName String
    The network interface name
    deleteRule string
    A value that prescribes what should happen to an associated static Address resource when a VM instance is permanently deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER - detach the IP when the VM is deleted, but do not delete the address resource. ON_PERMANENT_INSTANCE_DELETION will delete the stateful address when the VM is permanently deleted from the instance group. The default is NEVER.
    interfaceName string
    The network interface name
    delete_rule str
    A value that prescribes what should happen to an associated static Address resource when a VM instance is permanently deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER - detach the IP when the VM is deleted, but do not delete the address resource. ON_PERMANENT_INSTANCE_DELETION will delete the stateful address when the VM is permanently deleted from the instance group. The default is NEVER.
    interface_name str
    The network interface name
    deleteRule String
    A value that prescribes what should happen to an associated static Address resource when a VM instance is permanently deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER - detach the IP when the VM is deleted, but do not delete the address resource. ON_PERMANENT_INSTANCE_DELETION will delete the stateful address when the VM is permanently deleted from the instance group. The default is NEVER.
    interfaceName String
    The network interface name

    GetInstanceGroupManagerStatefulInternalIp

    DeleteRule string
    A value that prescribes what should happen to an associated static Address resource when a VM instance is permanently deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER - detach the IP when the VM is deleted, but do not delete the address resource. ON_PERMANENT_INSTANCE_DELETION will delete the stateful address when the VM is permanently deleted from the instance group. The default is NEVER.
    InterfaceName string
    The network interface name
    DeleteRule string
    A value that prescribes what should happen to an associated static Address resource when a VM instance is permanently deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER - detach the IP when the VM is deleted, but do not delete the address resource. ON_PERMANENT_INSTANCE_DELETION will delete the stateful address when the VM is permanently deleted from the instance group. The default is NEVER.
    InterfaceName string
    The network interface name
    deleteRule String
    A value that prescribes what should happen to an associated static Address resource when a VM instance is permanently deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER - detach the IP when the VM is deleted, but do not delete the address resource. ON_PERMANENT_INSTANCE_DELETION will delete the stateful address when the VM is permanently deleted from the instance group. The default is NEVER.
    interfaceName String
    The network interface name
    deleteRule string
    A value that prescribes what should happen to an associated static Address resource when a VM instance is permanently deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER - detach the IP when the VM is deleted, but do not delete the address resource. ON_PERMANENT_INSTANCE_DELETION will delete the stateful address when the VM is permanently deleted from the instance group. The default is NEVER.
    interfaceName string
    The network interface name
    delete_rule str
    A value that prescribes what should happen to an associated static Address resource when a VM instance is permanently deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER - detach the IP when the VM is deleted, but do not delete the address resource. ON_PERMANENT_INSTANCE_DELETION will delete the stateful address when the VM is permanently deleted from the instance group. The default is NEVER.
    interface_name str
    The network interface name
    deleteRule String
    A value that prescribes what should happen to an associated static Address resource when a VM instance is permanently deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER - detach the IP when the VM is deleted, but do not delete the address resource. ON_PERMANENT_INSTANCE_DELETION will delete the stateful address when the VM is permanently deleted from the instance group. The default is NEVER.
    interfaceName String
    The network interface name

    GetInstanceGroupManagerStatus

    AllInstancesConfigs List<GetInstanceGroupManagerStatusAllInstancesConfig>
    Status of all-instances configuration on the group.
    IsStable bool
    A bit indicating whether the managed instance group is in a stable state. A stable state means that: none of the instances in the managed instance group is currently undergoing any type of change (for example, creation, restart, or deletion); no future changes are scheduled for instances in the managed instance group; and the managed instance group itself is not being modified.
    Statefuls List<GetInstanceGroupManagerStatusStateful>
    Stateful status of the given Instance Group Manager.
    VersionTargets List<GetInstanceGroupManagerStatusVersionTarget>
    A status of consistency of Instances' versions with their target version specified by version field on Instance Group Manager.
    AllInstancesConfigs []GetInstanceGroupManagerStatusAllInstancesConfig
    Status of all-instances configuration on the group.
    IsStable bool
    A bit indicating whether the managed instance group is in a stable state. A stable state means that: none of the instances in the managed instance group is currently undergoing any type of change (for example, creation, restart, or deletion); no future changes are scheduled for instances in the managed instance group; and the managed instance group itself is not being modified.
    Statefuls []GetInstanceGroupManagerStatusStateful
    Stateful status of the given Instance Group Manager.
    VersionTargets []GetInstanceGroupManagerStatusVersionTarget
    A status of consistency of Instances' versions with their target version specified by version field on Instance Group Manager.
    allInstancesConfigs List<GetInstanceGroupManagerStatusAllInstancesConfig>
    Status of all-instances configuration on the group.
    isStable Boolean
    A bit indicating whether the managed instance group is in a stable state. A stable state means that: none of the instances in the managed instance group is currently undergoing any type of change (for example, creation, restart, or deletion); no future changes are scheduled for instances in the managed instance group; and the managed instance group itself is not being modified.
    statefuls List<GetInstanceGroupManagerStatusStateful>
    Stateful status of the given Instance Group Manager.
    versionTargets List<GetInstanceGroupManagerStatusVersionTarget>
    A status of consistency of Instances' versions with their target version specified by version field on Instance Group Manager.
    allInstancesConfigs GetInstanceGroupManagerStatusAllInstancesConfig[]
    Status of all-instances configuration on the group.
    isStable boolean
    A bit indicating whether the managed instance group is in a stable state. A stable state means that: none of the instances in the managed instance group is currently undergoing any type of change (for example, creation, restart, or deletion); no future changes are scheduled for instances in the managed instance group; and the managed instance group itself is not being modified.
    statefuls GetInstanceGroupManagerStatusStateful[]
    Stateful status of the given Instance Group Manager.
    versionTargets GetInstanceGroupManagerStatusVersionTarget[]
    A status of consistency of Instances' versions with their target version specified by version field on Instance Group Manager.
    all_instances_configs Sequence[GetInstanceGroupManagerStatusAllInstancesConfig]
    Status of all-instances configuration on the group.
    is_stable bool
    A bit indicating whether the managed instance group is in a stable state. A stable state means that: none of the instances in the managed instance group is currently undergoing any type of change (for example, creation, restart, or deletion); no future changes are scheduled for instances in the managed instance group; and the managed instance group itself is not being modified.
    statefuls Sequence[GetInstanceGroupManagerStatusStateful]
    Stateful status of the given Instance Group Manager.
    version_targets Sequence[GetInstanceGroupManagerStatusVersionTarget]
    A status of consistency of Instances' versions with their target version specified by version field on Instance Group Manager.
    allInstancesConfigs List<Property Map>
    Status of all-instances configuration on the group.
    isStable Boolean
    A bit indicating whether the managed instance group is in a stable state. A stable state means that: none of the instances in the managed instance group is currently undergoing any type of change (for example, creation, restart, or deletion); no future changes are scheduled for instances in the managed instance group; and the managed instance group itself is not being modified.
    statefuls List<Property Map>
    Stateful status of the given Instance Group Manager.
    versionTargets List<Property Map>
    A status of consistency of Instances' versions with their target version specified by version field on Instance Group Manager.

    GetInstanceGroupManagerStatusAllInstancesConfig

    CurrentRevision string
    Current all-instances configuration revision. This value is in RFC3339 text format.
    Effective bool
    A bit indicating whether this configuration has been applied to all managed instances in the group.
    CurrentRevision string
    Current all-instances configuration revision. This value is in RFC3339 text format.
    Effective bool
    A bit indicating whether this configuration has been applied to all managed instances in the group.
    currentRevision String
    Current all-instances configuration revision. This value is in RFC3339 text format.
    effective Boolean
    A bit indicating whether this configuration has been applied to all managed instances in the group.
    currentRevision string
    Current all-instances configuration revision. This value is in RFC3339 text format.
    effective boolean
    A bit indicating whether this configuration has been applied to all managed instances in the group.
    current_revision str
    Current all-instances configuration revision. This value is in RFC3339 text format.
    effective bool
    A bit indicating whether this configuration has been applied to all managed instances in the group.
    currentRevision String
    Current all-instances configuration revision. This value is in RFC3339 text format.
    effective Boolean
    A bit indicating whether this configuration has been applied to all managed instances in the group.

    GetInstanceGroupManagerStatusStateful

    HasStatefulConfig bool
    A bit indicating whether the managed instance group has stateful configuration, that is, if you have configured any items in a stateful policy or in per-instance configs. The group might report that it has no stateful config even when there is still some preserved state on a managed instance, for example, if you have deleted all PICs but not yet applied those deletions.
    PerInstanceConfigs List<GetInstanceGroupManagerStatusStatefulPerInstanceConfig>
    Status of per-instance configs on the instances.
    HasStatefulConfig bool
    A bit indicating whether the managed instance group has stateful configuration, that is, if you have configured any items in a stateful policy or in per-instance configs. The group might report that it has no stateful config even when there is still some preserved state on a managed instance, for example, if you have deleted all PICs but not yet applied those deletions.
    PerInstanceConfigs []GetInstanceGroupManagerStatusStatefulPerInstanceConfig
    Status of per-instance configs on the instances.
    hasStatefulConfig Boolean
    A bit indicating whether the managed instance group has stateful configuration, that is, if you have configured any items in a stateful policy or in per-instance configs. The group might report that it has no stateful config even when there is still some preserved state on a managed instance, for example, if you have deleted all PICs but not yet applied those deletions.
    perInstanceConfigs List<GetInstanceGroupManagerStatusStatefulPerInstanceConfig>
    Status of per-instance configs on the instances.
    hasStatefulConfig boolean
    A bit indicating whether the managed instance group has stateful configuration, that is, if you have configured any items in a stateful policy or in per-instance configs. The group might report that it has no stateful config even when there is still some preserved state on a managed instance, for example, if you have deleted all PICs but not yet applied those deletions.
    perInstanceConfigs GetInstanceGroupManagerStatusStatefulPerInstanceConfig[]
    Status of per-instance configs on the instances.
    has_stateful_config bool
    A bit indicating whether the managed instance group has stateful configuration, that is, if you have configured any items in a stateful policy or in per-instance configs. The group might report that it has no stateful config even when there is still some preserved state on a managed instance, for example, if you have deleted all PICs but not yet applied those deletions.
    per_instance_configs Sequence[GetInstanceGroupManagerStatusStatefulPerInstanceConfig]
    Status of per-instance configs on the instances.
    hasStatefulConfig Boolean
    A bit indicating whether the managed instance group has stateful configuration, that is, if you have configured any items in a stateful policy or in per-instance configs. The group might report that it has no stateful config even when there is still some preserved state on a managed instance, for example, if you have deleted all PICs but not yet applied those deletions.
    perInstanceConfigs List<Property Map>
    Status of per-instance configs on the instances.

    GetInstanceGroupManagerStatusStatefulPerInstanceConfig

    AllEffective bool
    A bit indicating if all of the group's per-instance configs (listed in the output of a listPerInstanceConfigs API call) have status EFFECTIVE or there are no per-instance-configs.
    AllEffective bool
    A bit indicating if all of the group's per-instance configs (listed in the output of a listPerInstanceConfigs API call) have status EFFECTIVE or there are no per-instance-configs.
    allEffective Boolean
    A bit indicating if all of the group's per-instance configs (listed in the output of a listPerInstanceConfigs API call) have status EFFECTIVE or there are no per-instance-configs.
    allEffective boolean
    A bit indicating if all of the group's per-instance configs (listed in the output of a listPerInstanceConfigs API call) have status EFFECTIVE or there are no per-instance-configs.
    all_effective bool
    A bit indicating if all of the group's per-instance configs (listed in the output of a listPerInstanceConfigs API call) have status EFFECTIVE or there are no per-instance-configs.
    allEffective Boolean
    A bit indicating if all of the group's per-instance configs (listed in the output of a listPerInstanceConfigs API call) have status EFFECTIVE or there are no per-instance-configs.

    GetInstanceGroupManagerStatusVersionTarget

    IsReached bool
    A bit indicating whether version target has been reached in this managed instance group, i.e. all instances are in their target version. Instances' target version are specified by version field on Instance Group Manager.
    IsReached bool
    A bit indicating whether version target has been reached in this managed instance group, i.e. all instances are in their target version. Instances' target version are specified by version field on Instance Group Manager.
    isReached Boolean
    A bit indicating whether version target has been reached in this managed instance group, i.e. all instances are in their target version. Instances' target version are specified by version field on Instance Group Manager.
    isReached boolean
    A bit indicating whether version target has been reached in this managed instance group, i.e. all instances are in their target version. Instances' target version are specified by version field on Instance Group Manager.
    is_reached bool
    A bit indicating whether version target has been reached in this managed instance group, i.e. all instances are in their target version. Instances' target version are specified by version field on Instance Group Manager.
    isReached Boolean
    A bit indicating whether version target has been reached in this managed instance group, i.e. all instances are in their target version. Instances' target version are specified by version field on Instance Group Manager.

    GetInstanceGroupManagerUpdatePolicy

    MaxSurgeFixed int
    Specifies a fixed number of VM instances. This must be a positive integer. Conflicts with max_surge_percent. Both cannot be 0
    MaxSurgePercent int
    Specifies a percentage of instances between 0 to 100%, inclusive. For example, specify 80 for 80%. Conflicts with max_surge_fixed.
    MaxUnavailableFixed int
    Specifies a fixed number of VM instances. This must be a positive integer.
    MaxUnavailablePercent int
    Specifies a percentage of instances between 0 to 100%, inclusive. For example, specify 80 for 80%.
    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 NONE to forbid any actions, REFRESH to update without stopping instances, RESTART to restart existing instances or REPLACE to delete and create new instances from the target template. If you specify a REFRESH, 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.
    MostDisruptiveAllowedAction string
    Most disruptive action that is allowed to be taken on an instance. You can specify either NONE to forbid any actions, REFRESH to allow actions that do not need instance restart, RESTART to allow actions that can be applied without instance replacing or REPLACE to allow all possible actions. If the Updater determines that the minimal update action needed is more disruptive than most disruptive allowed action you specify it will not perform the update at all.
    ReplacementMethod string
    The instance replacement method for managed instance groups. Valid values are: "RECREATE", "SUBSTITUTE". If SUBSTITUTE (default), the group replaces VM instances with new instances that have randomly generated names. If RECREATE, instance names are preserved. You must also set max_unavailable_fixed or max_unavailable_percent to be greater than 0.
    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
    Specifies a fixed number of VM instances. This must be a positive integer. Conflicts with max_surge_percent. Both cannot be 0
    MaxSurgePercent int
    Specifies a percentage of instances between 0 to 100%, inclusive. For example, specify 80 for 80%. Conflicts with max_surge_fixed.
    MaxUnavailableFixed int
    Specifies a fixed number of VM instances. This must be a positive integer.
    MaxUnavailablePercent int
    Specifies a percentage of instances between 0 to 100%, inclusive. For example, specify 80 for 80%.
    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 NONE to forbid any actions, REFRESH to update without stopping instances, RESTART to restart existing instances or REPLACE to delete and create new instances from the target template. If you specify a REFRESH, 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.
    MostDisruptiveAllowedAction string
    Most disruptive action that is allowed to be taken on an instance. You can specify either NONE to forbid any actions, REFRESH to allow actions that do not need instance restart, RESTART to allow actions that can be applied without instance replacing or REPLACE to allow all possible actions. If the Updater determines that the minimal update action needed is more disruptive than most disruptive allowed action you specify it will not perform the update at all.
    ReplacementMethod string
    The instance replacement method for managed instance groups. Valid values are: "RECREATE", "SUBSTITUTE". If SUBSTITUTE (default), the group replaces VM instances with new instances that have randomly generated names. If RECREATE, instance names are preserved. You must also set max_unavailable_fixed or max_unavailable_percent to be greater than 0.
    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 Integer
    Specifies a fixed number of VM instances. This must be a positive integer. Conflicts with max_surge_percent. Both cannot be 0
    maxSurgePercent Integer
    Specifies a percentage of instances between 0 to 100%, inclusive. For example, specify 80 for 80%. Conflicts with max_surge_fixed.
    maxUnavailableFixed Integer
    Specifies a fixed number of VM instances. This must be a positive integer.
    maxUnavailablePercent Integer
    Specifies a percentage of instances between 0 to 100%, inclusive. For example, specify 80 for 80%.
    minReadySec Integer
    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 NONE to forbid any actions, REFRESH to update without stopping instances, RESTART to restart existing instances or REPLACE to delete and create new instances from the target template. If you specify a REFRESH, 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.
    mostDisruptiveAllowedAction String
    Most disruptive action that is allowed to be taken on an instance. You can specify either NONE to forbid any actions, REFRESH to allow actions that do not need instance restart, RESTART to allow actions that can be applied without instance replacing or REPLACE to allow all possible actions. If the Updater determines that the minimal update action needed is more disruptive than most disruptive allowed action you specify it will not perform the update at all.
    replacementMethod String
    The instance replacement method for managed instance groups. Valid values are: "RECREATE", "SUBSTITUTE". If SUBSTITUTE (default), the group replaces VM instances with new instances that have randomly generated names. If RECREATE, instance names are preserved. You must also set max_unavailable_fixed or max_unavailable_percent to be greater than 0.
    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
    Specifies a fixed number of VM instances. This must be a positive integer. Conflicts with max_surge_percent. Both cannot be 0
    maxSurgePercent number
    Specifies a percentage of instances between 0 to 100%, inclusive. For example, specify 80 for 80%. Conflicts with max_surge_fixed.
    maxUnavailableFixed number
    Specifies a fixed number of VM instances. This must be a positive integer.
    maxUnavailablePercent number
    Specifies a percentage of instances between 0 to 100%, inclusive. For example, specify 80 for 80%.
    minReadySec number
    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 NONE to forbid any actions, REFRESH to update without stopping instances, RESTART to restart existing instances or REPLACE to delete and create new instances from the target template. If you specify a REFRESH, 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.
    mostDisruptiveAllowedAction string
    Most disruptive action that is allowed to be taken on an instance. You can specify either NONE to forbid any actions, REFRESH to allow actions that do not need instance restart, RESTART to allow actions that can be applied without instance replacing or REPLACE to allow all possible actions. If the Updater determines that the minimal update action needed is more disruptive than most disruptive allowed action you specify it will not perform the update at all.
    replacementMethod string
    The instance replacement method for managed instance groups. Valid values are: "RECREATE", "SUBSTITUTE". If SUBSTITUTE (default), the group replaces VM instances with new instances that have randomly generated names. If RECREATE, instance names are preserved. You must also set max_unavailable_fixed or max_unavailable_percent to be greater than 0.
    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).
    max_surge_fixed int
    Specifies a fixed number of VM instances. This must be a positive integer. Conflicts with max_surge_percent. Both cannot be 0
    max_surge_percent int
    Specifies a percentage of instances between 0 to 100%, inclusive. For example, specify 80 for 80%. Conflicts with max_surge_fixed.
    max_unavailable_fixed int
    Specifies a fixed number of VM instances. This must be a positive integer.
    max_unavailable_percent int
    Specifies a percentage of instances between 0 to 100%, inclusive. For example, specify 80 for 80%.
    min_ready_sec int
    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 NONE to forbid any actions, REFRESH to update without stopping instances, RESTART to restart existing instances or REPLACE to delete and create new instances from the target template. If you specify a REFRESH, 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.
    most_disruptive_allowed_action str
    Most disruptive action that is allowed to be taken on an instance. You can specify either NONE to forbid any actions, REFRESH to allow actions that do not need instance restart, RESTART to allow actions that can be applied without instance replacing or REPLACE to allow all possible actions. If the Updater determines that the minimal update action needed is more disruptive than most disruptive allowed action you specify it will not perform the update at all.
    replacement_method str
    The instance replacement method for managed instance groups. Valid values are: "RECREATE", "SUBSTITUTE". If SUBSTITUTE (default), the group replaces VM instances with new instances that have randomly generated names. If RECREATE, instance names are preserved. You must also set max_unavailable_fixed or max_unavailable_percent to be greater than 0.
    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 Number
    Specifies a fixed number of VM instances. This must be a positive integer. Conflicts with max_surge_percent. Both cannot be 0
    maxSurgePercent Number
    Specifies a percentage of instances between 0 to 100%, inclusive. For example, specify 80 for 80%. Conflicts with max_surge_fixed.
    maxUnavailableFixed Number
    Specifies a fixed number of VM instances. This must be a positive integer.
    maxUnavailablePercent Number
    Specifies a percentage of instances between 0 to 100%, inclusive. For example, specify 80 for 80%.
    minReadySec Number
    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 NONE to forbid any actions, REFRESH to update without stopping instances, RESTART to restart existing instances or REPLACE to delete and create new instances from the target template. If you specify a REFRESH, 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.
    mostDisruptiveAllowedAction String
    Most disruptive action that is allowed to be taken on an instance. You can specify either NONE to forbid any actions, REFRESH to allow actions that do not need instance restart, RESTART to allow actions that can be applied without instance replacing or REPLACE to allow all possible actions. If the Updater determines that the minimal update action needed is more disruptive than most disruptive allowed action you specify it will not perform the update at all.
    replacementMethod String
    The instance replacement method for managed instance groups. Valid values are: "RECREATE", "SUBSTITUTE". If SUBSTITUTE (default), the group replaces VM instances with new instances that have randomly generated names. If RECREATE, instance names are preserved. You must also set max_unavailable_fixed or max_unavailable_percent to be greater than 0.
    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).

    GetInstanceGroupManagerVersion

    InstanceTemplate string
    The full URL to an instance template from which all new instances of this version will be created.
    Name string
    The name of the instance group. Either name or self_link must be provided.
    TargetSizes List<GetInstanceGroupManagerVersionTargetSize>
    The number of instances calculated as a fixed number or a percentage depending on the settings.
    InstanceTemplate string
    The full URL to an instance template from which all new instances of this version will be created.
    Name string
    The name of the instance group. Either name or self_link must be provided.
    TargetSizes []GetInstanceGroupManagerVersionTargetSize
    The number of instances calculated as a fixed number or a percentage depending on the settings.
    instanceTemplate String
    The full URL to an instance template from which all new instances of this version will be created.
    name String
    The name of the instance group. Either name or self_link must be provided.
    targetSizes List<GetInstanceGroupManagerVersionTargetSize>
    The number of instances calculated as a fixed number or a percentage depending on the settings.
    instanceTemplate string
    The full URL to an instance template from which all new instances of this version will be created.
    name string
    The name of the instance group. Either name or self_link must be provided.
    targetSizes GetInstanceGroupManagerVersionTargetSize[]
    The number of instances calculated as a fixed number or a percentage depending on the settings.
    instance_template str
    The full URL to an instance template from which all new instances of this version will be created.
    name str
    The name of the instance group. Either name or self_link must be provided.
    target_sizes Sequence[GetInstanceGroupManagerVersionTargetSize]
    The number of instances calculated as a fixed number or a percentage depending on the settings.
    instanceTemplate String
    The full URL to an instance template from which all new instances of this version will be created.
    name String
    The name of the instance group. Either name or self_link must be provided.
    targetSizes List<Property Map>
    The number of instances calculated as a fixed number or a percentage depending on the settings.

    GetInstanceGroupManagerVersionTargetSize

    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 Integer
    The number of instances which are managed for this version. Conflicts with percent.
    percent Integer
    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 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.

    Package Details

    Repository
    Google Cloud (GCP) Classic pulumi/pulumi-gcp
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the google-beta Terraform Provider.
    gcp logo
    Google Cloud v8.21.0 published on Wednesday, Mar 5, 2025 by Pulumi
    pulumi/pulumi-gcp