Google Cloud v8.25.1, Apr 9 25

Google Cloud v8.25.1 published on Wednesday, Apr 9, 2025 by Pulumi

gcp.compute.getInstanceGroupManager

Explore with Pulumi AI

Google Cloud v8.25.1 published on Wednesday, Apr 9, 2025 by Pulumi

Example Usage

TypeScript
Python
Go
C#
Java
YAML

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.

TypeScript
Python
Go
C#
Java
YAML

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: Specifies the action that a MIG performs on a failed VM. If the value of the "on_failed_health_check" field is DEFAULT_ACTION, then the same action also applies to the VMs on which your application fails a health check. Valid values are: REPAIR, DO_NOTHING. If REPAIR (default), then MIG automatically repairs a failed VM by recreating it. For more information, see about repairing VMs in a MIG. If DO_NOTHING, then MIG does not repair a failed VM.
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.
OnFailedHealthCheck string: Specifies the action that a MIG performs on an unhealthy VM. A VM is marked as unhealthy when the application running on that VM fails a health check. Valid values are: DEFAULT_ACTION, DO_NOTHING, REPAIR. If DEFAULT_ACTION (default), then MIG uses the same action configured for the "default_action_on_failure" field. If DO_NOTHING, then MIG does not repair unhealthy VM. If REPAIR, then MIG automatically repairs an unhealthy VM by recreating it.

DefaultActionOnFailure string: Specifies the action that a MIG performs on a failed VM. If the value of the "on_failed_health_check" field is DEFAULT_ACTION, then the same action also applies to the VMs on which your application fails a health check. Valid values are: REPAIR, DO_NOTHING. If REPAIR (default), then MIG automatically repairs a failed VM by recreating it. For more information, see about repairing VMs in a MIG. If DO_NOTHING, then MIG does not repair a failed VM.
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.
OnFailedHealthCheck string: Specifies the action that a MIG performs on an unhealthy VM. A VM is marked as unhealthy when the application running on that VM fails a health check. Valid values are: DEFAULT_ACTION, DO_NOTHING, REPAIR. If DEFAULT_ACTION (default), then MIG uses the same action configured for the "default_action_on_failure" field. If DO_NOTHING, then MIG does not repair unhealthy VM. If REPAIR, then MIG automatically repairs an unhealthy VM by recreating it.

defaultActionOnFailure String: Specifies the action that a MIG performs on a failed VM. If the value of the "on_failed_health_check" field is DEFAULT_ACTION, then the same action also applies to the VMs on which your application fails a health check. Valid values are: REPAIR, DO_NOTHING. If REPAIR (default), then MIG automatically repairs a failed VM by recreating it. For more information, see about repairing VMs in a MIG. If DO_NOTHING, then MIG does not repair a failed VM.
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.
onFailedHealthCheck String: Specifies the action that a MIG performs on an unhealthy VM. A VM is marked as unhealthy when the application running on that VM fails a health check. Valid values are: DEFAULT_ACTION, DO_NOTHING, REPAIR. If DEFAULT_ACTION (default), then MIG uses the same action configured for the "default_action_on_failure" field. If DO_NOTHING, then MIG does not repair unhealthy VM. If REPAIR, then MIG automatically repairs an unhealthy VM by recreating it.

defaultActionOnFailure string: Specifies the action that a MIG performs on a failed VM. If the value of the "on_failed_health_check" field is DEFAULT_ACTION, then the same action also applies to the VMs on which your application fails a health check. Valid values are: REPAIR, DO_NOTHING. If REPAIR (default), then MIG automatically repairs a failed VM by recreating it. For more information, see about repairing VMs in a MIG. If DO_NOTHING, then MIG does not repair a failed VM.
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.
onFailedHealthCheck string: Specifies the action that a MIG performs on an unhealthy VM. A VM is marked as unhealthy when the application running on that VM fails a health check. Valid values are: DEFAULT_ACTION, DO_NOTHING, REPAIR. If DEFAULT_ACTION (default), then MIG uses the same action configured for the "default_action_on_failure" field. If DO_NOTHING, then MIG does not repair unhealthy VM. If REPAIR, then MIG automatically repairs an unhealthy VM by recreating it.

default_action_on_failure str: Specifies the action that a MIG performs on a failed VM. If the value of the "on_failed_health_check" field is DEFAULT_ACTION, then the same action also applies to the VMs on which your application fails a health check. Valid values are: REPAIR, DO_NOTHING. If REPAIR (default), then MIG automatically repairs a failed VM by recreating it. For more information, see about repairing VMs in a MIG. If DO_NOTHING, then MIG does not repair a failed VM.
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.
on_failed_health_check str: Specifies the action that a MIG performs on an unhealthy VM. A VM is marked as unhealthy when the application running on that VM fails a health check. Valid values are: DEFAULT_ACTION, DO_NOTHING, REPAIR. If DEFAULT_ACTION (default), then MIG uses the same action configured for the "default_action_on_failure" field. If DO_NOTHING, then MIG does not repair unhealthy VM. If REPAIR, then MIG automatically repairs an unhealthy VM by recreating it.

defaultActionOnFailure String: Specifies the action that a MIG performs on a failed VM. If the value of the "on_failed_health_check" field is DEFAULT_ACTION, then the same action also applies to the VMs on which your application fails a health check. Valid values are: REPAIR, DO_NOTHING. If REPAIR (default), then MIG automatically repairs a failed VM by recreating it. For more information, see about repairing VMs in a MIG. If DO_NOTHING, then MIG does not repair a failed VM.
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.
onFailedHealthCheck String: Specifies the action that a MIG performs on an unhealthy VM. A VM is marked as unhealthy when the application running on that VM fails a health check. Valid values are: DEFAULT_ACTION, DO_NOTHING, REPAIR. If DEFAULT_ACTION (default), then MIG uses the same action configured for the "default_action_on_failure" field. If DO_NOTHING, then MIG does not repair unhealthy VM. If REPAIR, then MIG automatically repairs an unhealthy VM by recreating it.

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.

Google Cloud v8.25.1 published on Wednesday, Apr 9, 2025 by Pulumi

pulumi/pulumi-gcp

gcp.compute.getInstanceGroupManager

On this page

On this page

Example Usage

Using getInstanceGroupManager

getInstanceGroupManager Result

Supporting Types

GetInstanceGroupManagerAllInstancesConfig

GetInstanceGroupManagerAutoHealingPolicy

GetInstanceGroupManagerInstanceLifecyclePolicy

GetInstanceGroupManagerNamedPort

GetInstanceGroupManagerParam

GetInstanceGroupManagerStandbyPolicy

GetInstanceGroupManagerStatefulDisk

GetInstanceGroupManagerStatefulExternalIp

GetInstanceGroupManagerStatefulInternalIp

GetInstanceGroupManagerStatus

GetInstanceGroupManagerStatusAllInstancesConfig

GetInstanceGroupManagerStatusStateful

GetInstanceGroupManagerStatusStatefulPerInstanceConfig

GetInstanceGroupManagerStatusVersionTarget

GetInstanceGroupManagerUpdatePolicy

GetInstanceGroupManagerVersion

GetInstanceGroupManagerVersionTargetSize

Package Details

On this page

On this page