Google Cloud v8.26.0, Apr 10 25

Google Cloud v8.26.0 published on Thursday, Apr 10, 2025 by Pulumi

gcp.compute.getRegionInstanceGroupManager

Explore with Pulumi AI

Google Cloud v8.26.0 published on Thursday, Apr 10, 2025 by Pulumi

Example Usage

TypeScript
Python
Go
C#
Java
YAML

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

const rigm = gcp.compute.getRegionInstanceGroupManager({
    name: "my-igm",
    region: "us-central1",
});

import pulumi
import pulumi_gcp as gcp

rigm = gcp.compute.get_region_instance_group_manager(name="my-igm",
    region="us-central1")

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.LookupRegionInstanceGroupManager(ctx, &compute.LookupRegionInstanceGroupManagerArgs{
			Name:   pulumi.StringRef("my-igm"),
			Region: pulumi.StringRef("us-central1"),
		}, 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 rigm = Gcp.Compute.GetRegionInstanceGroupManager.Invoke(new()
    {
        Name = "my-igm",
        Region = "us-central1",
    });

});

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.GetRegionInstanceGroupManagerArgs;
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 rigm = ComputeFunctions.getRegionInstanceGroupManager(GetRegionInstanceGroupManagerArgs.builder()
            .name("my-igm")
            .region("us-central1")
            .build());

    }
}

variables:
  rigm:
    fn::invoke:
      function: gcp:compute:getRegionInstanceGroupManager
      arguments:
        name: my-igm
        region: us-central1

Using getRegionInstanceGroupManager

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 getRegionInstanceGroupManager(args: GetRegionInstanceGroupManagerArgs, opts?: InvokeOptions): Promise<GetRegionInstanceGroupManagerResult>
function getRegionInstanceGroupManagerOutput(args: GetRegionInstanceGroupManagerOutputArgs, opts?: InvokeOptions): Output<GetRegionInstanceGroupManagerResult>

def get_region_instance_group_manager(name: Optional[str] = None,
                                      project: Optional[str] = None,
                                      region: Optional[str] = None,
                                      self_link: Optional[str] = None,
                                      opts: Optional[InvokeOptions] = None) -> GetRegionInstanceGroupManagerResult
def get_region_instance_group_manager_output(name: Optional[pulumi.Input[str]] = None,
                                      project: Optional[pulumi.Input[str]] = None,
                                      region: Optional[pulumi.Input[str]] = None,
                                      self_link: Optional[pulumi.Input[str]] = None,
                                      opts: Optional[InvokeOptions] = None) -> Output[GetRegionInstanceGroupManagerResult]

func LookupRegionInstanceGroupManager(ctx *Context, args *LookupRegionInstanceGroupManagerArgs, opts ...InvokeOption) (*LookupRegionInstanceGroupManagerResult, error)
func LookupRegionInstanceGroupManagerOutput(ctx *Context, args *LookupRegionInstanceGroupManagerOutputArgs, opts ...InvokeOption) LookupRegionInstanceGroupManagerResultOutput

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

public static class GetRegionInstanceGroupManager 
{
    public static Task<GetRegionInstanceGroupManagerResult> InvokeAsync(GetRegionInstanceGroupManagerArgs args, InvokeOptions? opts = null)
    public static Output<GetRegionInstanceGroupManagerResult> Invoke(GetRegionInstanceGroupManagerInvokeArgs args, InvokeOptions? opts = null)
}

public static CompletableFuture<GetRegionInstanceGroupManagerResult> getRegionInstanceGroupManager(GetRegionInstanceGroupManagerArgs args, InvokeOptions options)
public static Output<GetRegionInstanceGroupManagerResult> getRegionInstanceGroupManager(GetRegionInstanceGroupManagerArgs args, InvokeOptions options)

fn::invoke:
  function: gcp:compute/getRegionInstanceGroupManager:getRegionInstanceGroupManager
  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.

Region - (Optional) The region where the managed instance group resides. If not provided, the provider region is used.

Region string

SelfLink string

The self link of the instance group. Either name or self_link must be provided.

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.

Region - (Optional) The region where the managed instance group resides. If not provided, the provider region is used.

Region string

SelfLink string

The self link of the instance group. Either name or self_link must be provided.

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.

Region - (Optional) The region where the managed instance group resides. If not provided, the provider region is used.

region String

selfLink String

The self link of the instance group. Either name or self_link must be provided.

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.

Region - (Optional) The region where the managed instance group resides. If not provided, the provider region is used.

region string

selfLink string

The self link of the instance group. Either name or self_link must be provided.

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.

Region - (Optional) The region where the managed instance group resides. If not provided, the provider region is used.

region str

self_link str

The self link of the instance group. Either name or self_link must be provided.

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.

Region - (Optional) The region where the managed instance group resides. If not provided, the provider region is used.

region String

selfLink String

The self link of the instance group. Either name or self_link must be provided.

getRegionInstanceGroupManager Result

The following output properties are available:

AllInstancesConfigs List<GetRegionInstanceGroupManagerAllInstancesConfig>
AutoHealingPolicies List<GetRegionInstanceGroupManagerAutoHealingPolicy>
BaseInstanceName string
CreationTimestamp string
Description string
DistributionPolicyTargetShape string
DistributionPolicyZones List<string>
Fingerprint string
Id string: The provider-assigned unique ID for this managed resource.
InstanceFlexibilityPolicies List<GetRegionInstanceGroupManagerInstanceFlexibilityPolicy>
InstanceGroup string
InstanceGroupManagerId int
InstanceLifecyclePolicies List<GetRegionInstanceGroupManagerInstanceLifecyclePolicy>
ListManagedInstancesResults string
NamedPorts List<GetRegionInstanceGroupManagerNamedPort>
Params List<GetRegionInstanceGroupManagerParam>
StandbyPolicies List<GetRegionInstanceGroupManagerStandbyPolicy>
StatefulDisks List<GetRegionInstanceGroupManagerStatefulDisk>
StatefulExternalIps List<GetRegionInstanceGroupManagerStatefulExternalIp>
StatefulInternalIps List<GetRegionInstanceGroupManagerStatefulInternalIp>
Statuses List<GetRegionInstanceGroupManagerStatus>
TargetPools List<string>
TargetSize int
TargetStoppedSize int
TargetSuspendedSize int
UpdatePolicies List<GetRegionInstanceGroupManagerUpdatePolicy>
Versions List<GetRegionInstanceGroupManagerVersion>
WaitForInstances bool
WaitForInstancesStatus string
Name string
Project string
Region string
SelfLink string

AllInstancesConfigs []GetRegionInstanceGroupManagerAllInstancesConfig
AutoHealingPolicies []GetRegionInstanceGroupManagerAutoHealingPolicy
BaseInstanceName string
CreationTimestamp string
Description string
DistributionPolicyTargetShape string
DistributionPolicyZones []string
Fingerprint string
Id string: The provider-assigned unique ID for this managed resource.
InstanceFlexibilityPolicies []GetRegionInstanceGroupManagerInstanceFlexibilityPolicy
InstanceGroup string
InstanceGroupManagerId int
InstanceLifecyclePolicies []GetRegionInstanceGroupManagerInstanceLifecyclePolicy
ListManagedInstancesResults string
NamedPorts []GetRegionInstanceGroupManagerNamedPort
Params []GetRegionInstanceGroupManagerParam
StandbyPolicies []GetRegionInstanceGroupManagerStandbyPolicy
StatefulDisks []GetRegionInstanceGroupManagerStatefulDisk
StatefulExternalIps []GetRegionInstanceGroupManagerStatefulExternalIp
StatefulInternalIps []GetRegionInstanceGroupManagerStatefulInternalIp
Statuses []GetRegionInstanceGroupManagerStatus
TargetPools []string
TargetSize int
TargetStoppedSize int
TargetSuspendedSize int
UpdatePolicies []GetRegionInstanceGroupManagerUpdatePolicy
Versions []GetRegionInstanceGroupManagerVersion
WaitForInstances bool
WaitForInstancesStatus string
Name string
Project string
Region string
SelfLink string

allInstancesConfigs List<GetRegionInstanceGroupManagerAllInstancesConfig>
autoHealingPolicies List<GetRegionInstanceGroupManagerAutoHealingPolicy>
baseInstanceName String
creationTimestamp String
description String
distributionPolicyTargetShape String
distributionPolicyZones List<String>
fingerprint String
id String: The provider-assigned unique ID for this managed resource.
instanceFlexibilityPolicies List<GetRegionInstanceGroupManagerInstanceFlexibilityPolicy>
instanceGroup String
instanceGroupManagerId Integer
instanceLifecyclePolicies List<GetRegionInstanceGroupManagerInstanceLifecyclePolicy>
listManagedInstancesResults String
namedPorts List<GetRegionInstanceGroupManagerNamedPort>
params List<GetRegionInstanceGroupManagerParam>
standbyPolicies List<GetRegionInstanceGroupManagerStandbyPolicy>
statefulDisks List<GetRegionInstanceGroupManagerStatefulDisk>
statefulExternalIps List<GetRegionInstanceGroupManagerStatefulExternalIp>
statefulInternalIps List<GetRegionInstanceGroupManagerStatefulInternalIp>
statuses List<GetRegionInstanceGroupManagerStatus>
targetPools List<String>
targetSize Integer
targetStoppedSize Integer
targetSuspendedSize Integer
updatePolicies List<GetRegionInstanceGroupManagerUpdatePolicy>
versions List<GetRegionInstanceGroupManagerVersion>
waitForInstances Boolean
waitForInstancesStatus String
name String
project String
region String
selfLink String

allInstancesConfigs GetRegionInstanceGroupManagerAllInstancesConfig[]
autoHealingPolicies GetRegionInstanceGroupManagerAutoHealingPolicy[]
baseInstanceName string
creationTimestamp string
description string
distributionPolicyTargetShape string
distributionPolicyZones string[]
fingerprint string
id string: The provider-assigned unique ID for this managed resource.
instanceFlexibilityPolicies GetRegionInstanceGroupManagerInstanceFlexibilityPolicy[]
instanceGroup string
instanceGroupManagerId number
instanceLifecyclePolicies GetRegionInstanceGroupManagerInstanceLifecyclePolicy[]
listManagedInstancesResults string
namedPorts GetRegionInstanceGroupManagerNamedPort[]
params GetRegionInstanceGroupManagerParam[]
standbyPolicies GetRegionInstanceGroupManagerStandbyPolicy[]
statefulDisks GetRegionInstanceGroupManagerStatefulDisk[]
statefulExternalIps GetRegionInstanceGroupManagerStatefulExternalIp[]
statefulInternalIps GetRegionInstanceGroupManagerStatefulInternalIp[]
statuses GetRegionInstanceGroupManagerStatus[]
targetPools string[]
targetSize number
targetStoppedSize number
targetSuspendedSize number
updatePolicies GetRegionInstanceGroupManagerUpdatePolicy[]
versions GetRegionInstanceGroupManagerVersion[]
waitForInstances boolean
waitForInstancesStatus string
name string
project string
region string
selfLink string

all_instances_configs Sequence[GetRegionInstanceGroupManagerAllInstancesConfig]
auto_healing_policies Sequence[GetRegionInstanceGroupManagerAutoHealingPolicy]
base_instance_name str
creation_timestamp str
description str
distribution_policy_target_shape str
distribution_policy_zones Sequence[str]
fingerprint str
id str: The provider-assigned unique ID for this managed resource.
instance_flexibility_policies Sequence[GetRegionInstanceGroupManagerInstanceFlexibilityPolicy]
instance_group str
instance_group_manager_id int
instance_lifecycle_policies Sequence[GetRegionInstanceGroupManagerInstanceLifecyclePolicy]
list_managed_instances_results str
named_ports Sequence[GetRegionInstanceGroupManagerNamedPort]
params Sequence[GetRegionInstanceGroupManagerParam]
standby_policies Sequence[GetRegionInstanceGroupManagerStandbyPolicy]
stateful_disks Sequence[GetRegionInstanceGroupManagerStatefulDisk]
stateful_external_ips Sequence[GetRegionInstanceGroupManagerStatefulExternalIp]
stateful_internal_ips Sequence[GetRegionInstanceGroupManagerStatefulInternalIp]
statuses Sequence[GetRegionInstanceGroupManagerStatus]
target_pools Sequence[str]
target_size int
target_stopped_size int
target_suspended_size int
update_policies Sequence[GetRegionInstanceGroupManagerUpdatePolicy]
versions Sequence[GetRegionInstanceGroupManagerVersion]
wait_for_instances bool
wait_for_instances_status str
name str
project str
region str
self_link str

allInstancesConfigs List<Property Map>
autoHealingPolicies List<Property Map>
baseInstanceName String
creationTimestamp String
description String
distributionPolicyTargetShape String
distributionPolicyZones List<String>
fingerprint String
id String: The provider-assigned unique ID for this managed resource.
instanceFlexibilityPolicies List<Property Map>
instanceGroup String
instanceGroupManagerId Number
instanceLifecyclePolicies List<Property Map>
listManagedInstancesResults String
namedPorts List<Property Map>
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
region String
selfLink String

Supporting Types

GetRegionInstanceGroupManagerAllInstancesConfig

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,

GetRegionInstanceGroupManagerAutoHealingPolicy

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.

GetRegionInstanceGroupManagerInstanceFlexibilityPolicy

InstanceSelections List<GetRegionInstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection>: Named instance selections configuring properties that the group will use when creating new VMs.

InstanceSelections []GetRegionInstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection: Named instance selections configuring properties that the group will use when creating new VMs.

instanceSelections List<GetRegionInstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection>: Named instance selections configuring properties that the group will use when creating new VMs.

instanceSelections GetRegionInstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection[]: Named instance selections configuring properties that the group will use when creating new VMs.

instance_selections Sequence[GetRegionInstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection]: Named instance selections configuring properties that the group will use when creating new VMs.

instanceSelections List<Property Map>: Named instance selections configuring properties that the group will use when creating new VMs.

GetRegionInstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection

MachineTypes List<string>: Full machine-type names, e.g. "n1-standard-16"
Name string: The name of the instance group. Either name or self_link must be provided.
Rank int: Preference of this instance selection. Lower number means higher preference. MIG will first try to create a VM based on the machine-type with lowest rank and fallback to next rank based on availability. Machine types and instance selections with the same rank have the same preference.

MachineTypes []string: Full machine-type names, e.g. "n1-standard-16"
Name string: The name of the instance group. Either name or self_link must be provided.
Rank int: Preference of this instance selection. Lower number means higher preference. MIG will first try to create a VM based on the machine-type with lowest rank and fallback to next rank based on availability. Machine types and instance selections with the same rank have the same preference.

machineTypes List<String>: Full machine-type names, e.g. "n1-standard-16"
name String: The name of the instance group. Either name or self_link must be provided.
rank Integer: Preference of this instance selection. Lower number means higher preference. MIG will first try to create a VM based on the machine-type with lowest rank and fallback to next rank based on availability. Machine types and instance selections with the same rank have the same preference.

machineTypes string[]: Full machine-type names, e.g. "n1-standard-16"
name string: The name of the instance group. Either name or self_link must be provided.
rank number: Preference of this instance selection. Lower number means higher preference. MIG will first try to create a VM based on the machine-type with lowest rank and fallback to next rank based on availability. Machine types and instance selections with the same rank have the same preference.

machine_types Sequence[str]: Full machine-type names, e.g. "n1-standard-16"
name str: The name of the instance group. Either name or self_link must be provided.
rank int: Preference of this instance selection. Lower number means higher preference. MIG will first try to create a VM based on the machine-type with lowest rank and fallback to next rank based on availability. Machine types and instance selections with the same rank have the same preference.

machineTypes List<String>: Full machine-type names, e.g. "n1-standard-16"
name String: The name of the instance group. Either name or self_link must be provided.
rank Number: Preference of this instance selection. Lower number means higher preference. MIG will first try to create a VM based on the machine-type with lowest rank and fallback to next rank based on availability. Machine types and instance selections with the same rank have the same preference.

GetRegionInstanceGroupManagerInstanceLifecyclePolicy

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.

GetRegionInstanceGroupManagerNamedPort

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.

GetRegionInstanceGroupManagerParam

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.

GetRegionInstanceGroupManagerStandbyPolicy

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".

GetRegionInstanceGroupManagerStatefulDisk

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.

GetRegionInstanceGroupManagerStatefulExternalIp

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

GetRegionInstanceGroupManagerStatefulInternalIp

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

GetRegionInstanceGroupManagerStatus

AllInstancesConfigs List<GetRegionInstanceGroupManagerStatusAllInstancesConfig>: 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<GetRegionInstanceGroupManagerStatusStateful>: Stateful status of the given Instance Group Manager.
VersionTargets List<GetRegionInstanceGroupManagerStatusVersionTarget>: A status of consistency of Instances' versions with their target version specified by version field on Instance Group Manager.

AllInstancesConfigs []GetRegionInstanceGroupManagerStatusAllInstancesConfig: 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 []GetRegionInstanceGroupManagerStatusStateful: Stateful status of the given Instance Group Manager.
VersionTargets []GetRegionInstanceGroupManagerStatusVersionTarget: A status of consistency of Instances' versions with their target version specified by version field on Instance Group Manager.

allInstancesConfigs List<GetRegionInstanceGroupManagerStatusAllInstancesConfig>: 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<GetRegionInstanceGroupManagerStatusStateful>: Stateful status of the given Instance Group Manager.
versionTargets List<GetRegionInstanceGroupManagerStatusVersionTarget>: A status of consistency of Instances' versions with their target version specified by version field on Instance Group Manager.

allInstancesConfigs GetRegionInstanceGroupManagerStatusAllInstancesConfig[]: 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 GetRegionInstanceGroupManagerStatusStateful[]: Stateful status of the given Instance Group Manager.
versionTargets GetRegionInstanceGroupManagerStatusVersionTarget[]: A status of consistency of Instances' versions with their target version specified by version field on Instance Group Manager.

all_instances_configs Sequence[GetRegionInstanceGroupManagerStatusAllInstancesConfig]: 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[GetRegionInstanceGroupManagerStatusStateful]: Stateful status of the given Instance Group Manager.
version_targets Sequence[GetRegionInstanceGroupManagerStatusVersionTarget]: 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.

GetRegionInstanceGroupManagerStatusAllInstancesConfig

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.

GetRegionInstanceGroupManagerStatusStateful

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<GetRegionInstanceGroupManagerStatusStatefulPerInstanceConfig>: 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 []GetRegionInstanceGroupManagerStatusStatefulPerInstanceConfig: 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<GetRegionInstanceGroupManagerStatusStatefulPerInstanceConfig>: 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 GetRegionInstanceGroupManagerStatusStatefulPerInstanceConfig[]: 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[GetRegionInstanceGroupManagerStatusStatefulPerInstanceConfig]: 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.

GetRegionInstanceGroupManagerStatusStatefulPerInstanceConfig

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.

GetRegionInstanceGroupManagerStatusVersionTarget

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.

GetRegionInstanceGroupManagerUpdatePolicy

InstanceRedistributionType string: The instance redistribution policy for regional managed instance groups. Valid values are: "PROACTIVE", "NONE". If PROACTIVE (default), the group attempts to maintain an even distribution of VM instances across zones in the region. If NONE, proactive redistribution is disabled.
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 regional 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).

InstanceRedistributionType string: The instance redistribution policy for regional managed instance groups. Valid values are: "PROACTIVE", "NONE". If PROACTIVE (default), the group attempts to maintain an even distribution of VM instances across zones in the region. If NONE, proactive redistribution is disabled.
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 regional 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).

instanceRedistributionType String: The instance redistribution policy for regional managed instance groups. Valid values are: "PROACTIVE", "NONE". If PROACTIVE (default), the group attempts to maintain an even distribution of VM instances across zones in the region. If NONE, proactive redistribution is disabled.
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 regional 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).

instanceRedistributionType string: The instance redistribution policy for regional managed instance groups. Valid values are: "PROACTIVE", "NONE". If PROACTIVE (default), the group attempts to maintain an even distribution of VM instances across zones in the region. If NONE, proactive redistribution is disabled.
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 regional 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).

instance_redistribution_type str: The instance redistribution policy for regional managed instance groups. Valid values are: "PROACTIVE", "NONE". If PROACTIVE (default), the group attempts to maintain an even distribution of VM instances across zones in the region. If NONE, proactive redistribution is disabled.
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 regional 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).

instanceRedistributionType String: The instance redistribution policy for regional managed instance groups. Valid values are: "PROACTIVE", "NONE". If PROACTIVE (default), the group attempts to maintain an even distribution of VM instances across zones in the region. If NONE, proactive redistribution is disabled.
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 regional 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).

GetRegionInstanceGroupManagerVersion

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<GetRegionInstanceGroupManagerVersionTargetSize>: 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 []GetRegionInstanceGroupManagerVersionTargetSize: 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<GetRegionInstanceGroupManagerVersionTargetSize>: 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 GetRegionInstanceGroupManagerVersionTargetSize[]: 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[GetRegionInstanceGroupManagerVersionTargetSize]: 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.

GetRegionInstanceGroupManagerVersionTargetSize

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.26.0 published on Thursday, Apr 10, 2025 by Pulumi

pulumi/pulumi-gcp

gcp.compute.getRegionInstanceGroupManager

On this page

On this page

Example Usage

Using getRegionInstanceGroupManager

getRegionInstanceGroupManager Result

Supporting Types

GetRegionInstanceGroupManagerAllInstancesConfig

GetRegionInstanceGroupManagerAutoHealingPolicy

GetRegionInstanceGroupManagerInstanceFlexibilityPolicy

GetRegionInstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection

GetRegionInstanceGroupManagerInstanceLifecyclePolicy

GetRegionInstanceGroupManagerNamedPort

GetRegionInstanceGroupManagerParam

GetRegionInstanceGroupManagerStandbyPolicy

GetRegionInstanceGroupManagerStatefulDisk

GetRegionInstanceGroupManagerStatefulExternalIp

GetRegionInstanceGroupManagerStatefulInternalIp

GetRegionInstanceGroupManagerStatus

GetRegionInstanceGroupManagerStatusAllInstancesConfig

GetRegionInstanceGroupManagerStatusStateful

GetRegionInstanceGroupManagerStatusStatefulPerInstanceConfig

GetRegionInstanceGroupManagerStatusVersionTarget

GetRegionInstanceGroupManagerUpdatePolicy

GetRegionInstanceGroupManagerVersion

GetRegionInstanceGroupManagerVersionTargetSize

Package Details

On this page

On this page