gcp.compute.InstanceGroupManager
Explore with Pulumi AI
The Google Compute Engine Instance Group Manager API creates and manages pools of homogeneous Compute Engine virtual machine instances from a common instance template. For more information, see the official documentation and API
Note: Use gcp.compute.RegionInstanceGroupManager to create a regional (multi-zone) instance group manager.
Example Usage
With Top Level Instance Template (Google Provider)
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const autohealing = new gcp.compute.HealthCheck("autohealing", {
    name: "autohealing-health-check",
    checkIntervalSec: 5,
    timeoutSec: 5,
    healthyThreshold: 2,
    unhealthyThreshold: 10,
    httpHealthCheck: {
        requestPath: "/healthz",
        port: 8080,
    },
});
const appserver = new gcp.compute.InstanceGroupManager("appserver", {
    name: "appserver-igm",
    baseInstanceName: "app",
    zone: "us-central1-a",
    versions: [{
        instanceTemplate: appserverGoogleComputeInstanceTemplate.selfLinkUnique,
    }],
    allInstancesConfig: {
        metadata: {
            metadata_key: "metadata_value",
        },
        labels: {
            label_key: "label_value",
        },
    },
    targetPools: [appserverGoogleComputeTargetPool.id],
    targetSize: 2,
    namedPorts: [{
        name: "customhttp",
        port: 8888,
    }],
    autoHealingPolicies: {
        healthCheck: autohealing.id,
        initialDelaySec: 300,
    },
});
import pulumi
import pulumi_gcp as gcp
autohealing = gcp.compute.HealthCheck("autohealing",
    name="autohealing-health-check",
    check_interval_sec=5,
    timeout_sec=5,
    healthy_threshold=2,
    unhealthy_threshold=10,
    http_health_check={
        "request_path": "/healthz",
        "port": 8080,
    })
appserver = gcp.compute.InstanceGroupManager("appserver",
    name="appserver-igm",
    base_instance_name="app",
    zone="us-central1-a",
    versions=[{
        "instance_template": appserver_google_compute_instance_template["selfLinkUnique"],
    }],
    all_instances_config={
        "metadata": {
            "metadata_key": "metadata_value",
        },
        "labels": {
            "label_key": "label_value",
        },
    },
    target_pools=[appserver_google_compute_target_pool["id"]],
    target_size=2,
    named_ports=[{
        "name": "customhttp",
        "port": 8888,
    }],
    auto_healing_policies={
        "health_check": autohealing.id,
        "initial_delay_sec": 300,
    })
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 {
		autohealing, err := compute.NewHealthCheck(ctx, "autohealing", &compute.HealthCheckArgs{
			Name:               pulumi.String("autohealing-health-check"),
			CheckIntervalSec:   pulumi.Int(5),
			TimeoutSec:         pulumi.Int(5),
			HealthyThreshold:   pulumi.Int(2),
			UnhealthyThreshold: pulumi.Int(10),
			HttpHealthCheck: &compute.HealthCheckHttpHealthCheckArgs{
				RequestPath: pulumi.String("/healthz"),
				Port:        pulumi.Int(8080),
			},
		})
		if err != nil {
			return err
		}
		_, err = compute.NewInstanceGroupManager(ctx, "appserver", &compute.InstanceGroupManagerArgs{
			Name:             pulumi.String("appserver-igm"),
			BaseInstanceName: pulumi.String("app"),
			Zone:             pulumi.String("us-central1-a"),
			Versions: compute.InstanceGroupManagerVersionArray{
				&compute.InstanceGroupManagerVersionArgs{
					InstanceTemplate: pulumi.Any(appserverGoogleComputeInstanceTemplate.SelfLinkUnique),
				},
			},
			AllInstancesConfig: &compute.InstanceGroupManagerAllInstancesConfigArgs{
				Metadata: pulumi.StringMap{
					"metadata_key": pulumi.String("metadata_value"),
				},
				Labels: pulumi.StringMap{
					"label_key": pulumi.String("label_value"),
				},
			},
			TargetPools: pulumi.StringArray{
				appserverGoogleComputeTargetPool.Id,
			},
			TargetSize: pulumi.Int(2),
			NamedPorts: compute.InstanceGroupManagerNamedPortArray{
				&compute.InstanceGroupManagerNamedPortArgs{
					Name: pulumi.String("customhttp"),
					Port: pulumi.Int(8888),
				},
			},
			AutoHealingPolicies: &compute.InstanceGroupManagerAutoHealingPoliciesArgs{
				HealthCheck:     autohealing.ID(),
				InitialDelaySec: pulumi.Int(300),
			},
		})
		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 autohealing = new Gcp.Compute.HealthCheck("autohealing", new()
    {
        Name = "autohealing-health-check",
        CheckIntervalSec = 5,
        TimeoutSec = 5,
        HealthyThreshold = 2,
        UnhealthyThreshold = 10,
        HttpHealthCheck = new Gcp.Compute.Inputs.HealthCheckHttpHealthCheckArgs
        {
            RequestPath = "/healthz",
            Port = 8080,
        },
    });
    var appserver = new Gcp.Compute.InstanceGroupManager("appserver", new()
    {
        Name = "appserver-igm",
        BaseInstanceName = "app",
        Zone = "us-central1-a",
        Versions = new[]
        {
            new Gcp.Compute.Inputs.InstanceGroupManagerVersionArgs
            {
                InstanceTemplate = appserverGoogleComputeInstanceTemplate.SelfLinkUnique,
            },
        },
        AllInstancesConfig = new Gcp.Compute.Inputs.InstanceGroupManagerAllInstancesConfigArgs
        {
            Metadata = 
            {
                { "metadata_key", "metadata_value" },
            },
            Labels = 
            {
                { "label_key", "label_value" },
            },
        },
        TargetPools = new[]
        {
            appserverGoogleComputeTargetPool.Id,
        },
        TargetSize = 2,
        NamedPorts = new[]
        {
            new Gcp.Compute.Inputs.InstanceGroupManagerNamedPortArgs
            {
                Name = "customhttp",
                Port = 8888,
            },
        },
        AutoHealingPolicies = new Gcp.Compute.Inputs.InstanceGroupManagerAutoHealingPoliciesArgs
        {
            HealthCheck = autohealing.Id,
            InitialDelaySec = 300,
        },
    });
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.compute.HealthCheck;
import com.pulumi.gcp.compute.HealthCheckArgs;
import com.pulumi.gcp.compute.inputs.HealthCheckHttpHealthCheckArgs;
import com.pulumi.gcp.compute.InstanceGroupManager;
import com.pulumi.gcp.compute.InstanceGroupManagerArgs;
import com.pulumi.gcp.compute.inputs.InstanceGroupManagerVersionArgs;
import com.pulumi.gcp.compute.inputs.InstanceGroupManagerAllInstancesConfigArgs;
import com.pulumi.gcp.compute.inputs.InstanceGroupManagerNamedPortArgs;
import com.pulumi.gcp.compute.inputs.InstanceGroupManagerAutoHealingPoliciesArgs;
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) {
        var autohealing = new HealthCheck("autohealing", HealthCheckArgs.builder()
            .name("autohealing-health-check")
            .checkIntervalSec(5)
            .timeoutSec(5)
            .healthyThreshold(2)
            .unhealthyThreshold(10)
            .httpHealthCheck(HealthCheckHttpHealthCheckArgs.builder()
                .requestPath("/healthz")
                .port("8080")
                .build())
            .build());
        var appserver = new InstanceGroupManager("appserver", InstanceGroupManagerArgs.builder()
            .name("appserver-igm")
            .baseInstanceName("app")
            .zone("us-central1-a")
            .versions(InstanceGroupManagerVersionArgs.builder()
                .instanceTemplate(appserverGoogleComputeInstanceTemplate.selfLinkUnique())
                .build())
            .allInstancesConfig(InstanceGroupManagerAllInstancesConfigArgs.builder()
                .metadata(Map.of("metadata_key", "metadata_value"))
                .labels(Map.of("label_key", "label_value"))
                .build())
            .targetPools(appserverGoogleComputeTargetPool.id())
            .targetSize(2)
            .namedPorts(InstanceGroupManagerNamedPortArgs.builder()
                .name("customhttp")
                .port(8888)
                .build())
            .autoHealingPolicies(InstanceGroupManagerAutoHealingPoliciesArgs.builder()
                .healthCheck(autohealing.id())
                .initialDelaySec(300)
                .build())
            .build());
    }
}
resources:
  autohealing:
    type: gcp:compute:HealthCheck
    properties:
      name: autohealing-health-check
      checkIntervalSec: 5
      timeoutSec: 5
      healthyThreshold: 2
      unhealthyThreshold: 10 # 50 seconds
      httpHealthCheck:
        requestPath: /healthz
        port: '8080'
  appserver:
    type: gcp:compute:InstanceGroupManager
    properties:
      name: appserver-igm
      baseInstanceName: app
      zone: us-central1-a
      versions:
        - instanceTemplate: ${appserverGoogleComputeInstanceTemplate.selfLinkUnique}
      allInstancesConfig:
        metadata:
          metadata_key: metadata_value
        labels:
          label_key: label_value
      targetPools:
        - ${appserverGoogleComputeTargetPool.id}
      targetSize: 2
      namedPorts:
        - name: customhttp
          port: 8888
      autoHealingPolicies:
        healthCheck: ${autohealing.id}
        initialDelaySec: 300
With Multiple Versions (Google-Beta Provider)
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const appserver = new gcp.compute.InstanceGroupManager("appserver", {
    name: "appserver-igm",
    baseInstanceName: "app",
    zone: "us-central1-a",
    targetSize: 5,
    versions: [
        {
            name: "appserver",
            instanceTemplate: appserverGoogleComputeInstanceTemplate.selfLinkUnique,
        },
        {
            name: "appserver-canary",
            instanceTemplate: appserver_canary.selfLinkUnique,
            targetSize: {
                fixed: 1,
            },
        },
    ],
});
import pulumi
import pulumi_gcp as gcp
appserver = gcp.compute.InstanceGroupManager("appserver",
    name="appserver-igm",
    base_instance_name="app",
    zone="us-central1-a",
    target_size=5,
    versions=[
        {
            "name": "appserver",
            "instance_template": appserver_google_compute_instance_template["selfLinkUnique"],
        },
        {
            "name": "appserver-canary",
            "instance_template": appserver_canary["selfLinkUnique"],
            "target_size": {
                "fixed": 1,
            },
        },
    ])
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.NewInstanceGroupManager(ctx, "appserver", &compute.InstanceGroupManagerArgs{
			Name:             pulumi.String("appserver-igm"),
			BaseInstanceName: pulumi.String("app"),
			Zone:             pulumi.String("us-central1-a"),
			TargetSize:       pulumi.Int(5),
			Versions: compute.InstanceGroupManagerVersionArray{
				&compute.InstanceGroupManagerVersionArgs{
					Name:             pulumi.String("appserver"),
					InstanceTemplate: pulumi.Any(appserverGoogleComputeInstanceTemplate.SelfLinkUnique),
				},
				&compute.InstanceGroupManagerVersionArgs{
					Name:             pulumi.String("appserver-canary"),
					InstanceTemplate: pulumi.Any(appserver_canary.SelfLinkUnique),
					TargetSize: &compute.InstanceGroupManagerVersionTargetSizeArgs{
						Fixed: pulumi.Int(1),
					},
				},
			},
		})
		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 appserver = new Gcp.Compute.InstanceGroupManager("appserver", new()
    {
        Name = "appserver-igm",
        BaseInstanceName = "app",
        Zone = "us-central1-a",
        TargetSize = 5,
        Versions = new[]
        {
            new Gcp.Compute.Inputs.InstanceGroupManagerVersionArgs
            {
                Name = "appserver",
                InstanceTemplate = appserverGoogleComputeInstanceTemplate.SelfLinkUnique,
            },
            new Gcp.Compute.Inputs.InstanceGroupManagerVersionArgs
            {
                Name = "appserver-canary",
                InstanceTemplate = appserver_canary.SelfLinkUnique,
                TargetSize = new Gcp.Compute.Inputs.InstanceGroupManagerVersionTargetSizeArgs
                {
                    Fixed = 1,
                },
            },
        },
    });
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.compute.InstanceGroupManager;
import com.pulumi.gcp.compute.InstanceGroupManagerArgs;
import com.pulumi.gcp.compute.inputs.InstanceGroupManagerVersionArgs;
import com.pulumi.gcp.compute.inputs.InstanceGroupManagerVersionTargetSizeArgs;
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) {
        var appserver = new InstanceGroupManager("appserver", InstanceGroupManagerArgs.builder()
            .name("appserver-igm")
            .baseInstanceName("app")
            .zone("us-central1-a")
            .targetSize(5)
            .versions(            
                InstanceGroupManagerVersionArgs.builder()
                    .name("appserver")
                    .instanceTemplate(appserverGoogleComputeInstanceTemplate.selfLinkUnique())
                    .build(),
                InstanceGroupManagerVersionArgs.builder()
                    .name("appserver-canary")
                    .instanceTemplate(appserver_canary.selfLinkUnique())
                    .targetSize(InstanceGroupManagerVersionTargetSizeArgs.builder()
                        .fixed(1)
                        .build())
                    .build())
            .build());
    }
}
resources:
  appserver:
    type: gcp:compute:InstanceGroupManager
    properties:
      name: appserver-igm
      baseInstanceName: app
      zone: us-central1-a
      targetSize: 5
      versions:
        - name: appserver
          instanceTemplate: ${appserverGoogleComputeInstanceTemplate.selfLinkUnique}
        - name: appserver-canary
          instanceTemplate: ${["appserver-canary"].selfLinkUnique}
          targetSize:
            fixed: 1
With Standby Policy (Google Provider)
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const igm_sr = new gcp.compute.InstanceGroupManager("igm-sr", {
    name: "tf-sr-igm",
    baseInstanceName: "tf-sr-igm-instance",
    zone: "us-central1-a",
    targetSize: 5,
    versions: [{
        instanceTemplate: sr_igm.selfLink,
        name: "primary",
    }],
    standbyPolicy: {
        initialDelaySec: 30,
        mode: "MANUAL",
    },
    targetSuspendedSize: 2,
    targetStoppedSize: 1,
});
import pulumi
import pulumi_gcp as gcp
igm_sr = gcp.compute.InstanceGroupManager("igm-sr",
    name="tf-sr-igm",
    base_instance_name="tf-sr-igm-instance",
    zone="us-central1-a",
    target_size=5,
    versions=[{
        "instance_template": sr_igm["selfLink"],
        "name": "primary",
    }],
    standby_policy={
        "initial_delay_sec": 30,
        "mode": "MANUAL",
    },
    target_suspended_size=2,
    target_stopped_size=1)
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.NewInstanceGroupManager(ctx, "igm-sr", &compute.InstanceGroupManagerArgs{
			Name:             pulumi.String("tf-sr-igm"),
			BaseInstanceName: pulumi.String("tf-sr-igm-instance"),
			Zone:             pulumi.String("us-central1-a"),
			TargetSize:       pulumi.Int(5),
			Versions: compute.InstanceGroupManagerVersionArray{
				&compute.InstanceGroupManagerVersionArgs{
					InstanceTemplate: pulumi.Any(sr_igm.SelfLink),
					Name:             pulumi.String("primary"),
				},
			},
			StandbyPolicy: &compute.InstanceGroupManagerStandbyPolicyArgs{
				InitialDelaySec: pulumi.Int(30),
				Mode:            pulumi.String("MANUAL"),
			},
			TargetSuspendedSize: pulumi.Int(2),
			TargetStoppedSize:   pulumi.Int(1),
		})
		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 igm_sr = new Gcp.Compute.InstanceGroupManager("igm-sr", new()
    {
        Name = "tf-sr-igm",
        BaseInstanceName = "tf-sr-igm-instance",
        Zone = "us-central1-a",
        TargetSize = 5,
        Versions = new[]
        {
            new Gcp.Compute.Inputs.InstanceGroupManagerVersionArgs
            {
                InstanceTemplate = sr_igm.SelfLink,
                Name = "primary",
            },
        },
        StandbyPolicy = new Gcp.Compute.Inputs.InstanceGroupManagerStandbyPolicyArgs
        {
            InitialDelaySec = 30,
            Mode = "MANUAL",
        },
        TargetSuspendedSize = 2,
        TargetStoppedSize = 1,
    });
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.compute.InstanceGroupManager;
import com.pulumi.gcp.compute.InstanceGroupManagerArgs;
import com.pulumi.gcp.compute.inputs.InstanceGroupManagerVersionArgs;
import com.pulumi.gcp.compute.inputs.InstanceGroupManagerStandbyPolicyArgs;
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) {
        var igm_sr = new InstanceGroupManager("igm-sr", InstanceGroupManagerArgs.builder()
            .name("tf-sr-igm")
            .baseInstanceName("tf-sr-igm-instance")
            .zone("us-central1-a")
            .targetSize(5)
            .versions(InstanceGroupManagerVersionArgs.builder()
                .instanceTemplate(sr_igm.selfLink())
                .name("primary")
                .build())
            .standbyPolicy(InstanceGroupManagerStandbyPolicyArgs.builder()
                .initialDelaySec(30)
                .mode("MANUAL")
                .build())
            .targetSuspendedSize(2)
            .targetStoppedSize(1)
            .build());
    }
}
resources:
  igm-sr:
    type: gcp:compute:InstanceGroupManager
    properties:
      name: tf-sr-igm
      baseInstanceName: tf-sr-igm-instance
      zone: us-central1-a
      targetSize: 5
      versions:
        - instanceTemplate: ${["sr-igm"].selfLink}
          name: primary
      standbyPolicy:
        initialDelaySec: 30
        mode: MANUAL
      targetSuspendedSize: 2
      targetStoppedSize: 1
Create InstanceGroupManager Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new InstanceGroupManager(name: string, args: InstanceGroupManagerArgs, opts?: CustomResourceOptions);@overload
def InstanceGroupManager(resource_name: str,
                         args: InstanceGroupManagerArgs,
                         opts: Optional[ResourceOptions] = None)
@overload
def InstanceGroupManager(resource_name: str,
                         opts: Optional[ResourceOptions] = None,
                         base_instance_name: Optional[str] = None,
                         versions: Optional[Sequence[InstanceGroupManagerVersionArgs]] = None,
                         standby_policy: Optional[InstanceGroupManagerStandbyPolicyArgs] = None,
                         stateful_internal_ips: Optional[Sequence[InstanceGroupManagerStatefulInternalIpArgs]] = None,
                         instance_lifecycle_policy: Optional[InstanceGroupManagerInstanceLifecyclePolicyArgs] = None,
                         list_managed_instances_results: Optional[str] = None,
                         name: Optional[str] = None,
                         named_ports: Optional[Sequence[InstanceGroupManagerNamedPortArgs]] = None,
                         params: Optional[InstanceGroupManagerParamsArgs] = None,
                         project: Optional[str] = None,
                         all_instances_config: Optional[InstanceGroupManagerAllInstancesConfigArgs] = None,
                         stateful_disks: Optional[Sequence[InstanceGroupManagerStatefulDiskArgs]] = None,
                         stateful_external_ips: Optional[Sequence[InstanceGroupManagerStatefulExternalIpArgs]] = None,
                         description: Optional[str] = None,
                         target_pools: Optional[Sequence[str]] = None,
                         target_size: Optional[int] = None,
                         target_stopped_size: Optional[int] = None,
                         target_suspended_size: Optional[int] = None,
                         update_policy: Optional[InstanceGroupManagerUpdatePolicyArgs] = None,
                         auto_healing_policies: Optional[InstanceGroupManagerAutoHealingPoliciesArgs] = None,
                         wait_for_instances: Optional[bool] = None,
                         wait_for_instances_status: Optional[str] = None,
                         zone: Optional[str] = None)func NewInstanceGroupManager(ctx *Context, name string, args InstanceGroupManagerArgs, opts ...ResourceOption) (*InstanceGroupManager, error)public InstanceGroupManager(string name, InstanceGroupManagerArgs args, CustomResourceOptions? opts = null)
public InstanceGroupManager(String name, InstanceGroupManagerArgs args)
public InstanceGroupManager(String name, InstanceGroupManagerArgs args, CustomResourceOptions options)
type: gcp:compute:InstanceGroupManager
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args InstanceGroupManagerArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args InstanceGroupManagerArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args InstanceGroupManagerArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args InstanceGroupManagerArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args InstanceGroupManagerArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var instanceGroupManagerResource = new Gcp.Compute.InstanceGroupManager("instanceGroupManagerResource", new()
{
    BaseInstanceName = "string",
    Versions = new[]
    {
        new Gcp.Compute.Inputs.InstanceGroupManagerVersionArgs
        {
            InstanceTemplate = "string",
            Name = "string",
            TargetSize = new Gcp.Compute.Inputs.InstanceGroupManagerVersionTargetSizeArgs
            {
                Fixed = 0,
                Percent = 0,
            },
        },
    },
    StandbyPolicy = new Gcp.Compute.Inputs.InstanceGroupManagerStandbyPolicyArgs
    {
        InitialDelaySec = 0,
        Mode = "string",
    },
    StatefulInternalIps = new[]
    {
        new Gcp.Compute.Inputs.InstanceGroupManagerStatefulInternalIpArgs
        {
            DeleteRule = "string",
            InterfaceName = "string",
        },
    },
    InstanceLifecyclePolicy = new Gcp.Compute.Inputs.InstanceGroupManagerInstanceLifecyclePolicyArgs
    {
        DefaultActionOnFailure = "string",
        ForceUpdateOnRepair = "string",
    },
    ListManagedInstancesResults = "string",
    Name = "string",
    NamedPorts = new[]
    {
        new Gcp.Compute.Inputs.InstanceGroupManagerNamedPortArgs
        {
            Name = "string",
            Port = 0,
        },
    },
    Params = new Gcp.Compute.Inputs.InstanceGroupManagerParamsArgs
    {
        ResourceManagerTags = 
        {
            { "string", "string" },
        },
    },
    Project = "string",
    AllInstancesConfig = new Gcp.Compute.Inputs.InstanceGroupManagerAllInstancesConfigArgs
    {
        Labels = 
        {
            { "string", "string" },
        },
        Metadata = 
        {
            { "string", "string" },
        },
    },
    StatefulDisks = new[]
    {
        new Gcp.Compute.Inputs.InstanceGroupManagerStatefulDiskArgs
        {
            DeviceName = "string",
            DeleteRule = "string",
        },
    },
    StatefulExternalIps = new[]
    {
        new Gcp.Compute.Inputs.InstanceGroupManagerStatefulExternalIpArgs
        {
            DeleteRule = "string",
            InterfaceName = "string",
        },
    },
    Description = "string",
    TargetPools = new[]
    {
        "string",
    },
    TargetSize = 0,
    TargetStoppedSize = 0,
    TargetSuspendedSize = 0,
    UpdatePolicy = new Gcp.Compute.Inputs.InstanceGroupManagerUpdatePolicyArgs
    {
        MinimalAction = "string",
        Type = "string",
        MaxSurgeFixed = 0,
        MaxSurgePercent = 0,
        MaxUnavailableFixed = 0,
        MaxUnavailablePercent = 0,
        MinReadySec = 0,
        MostDisruptiveAllowedAction = "string",
        ReplacementMethod = "string",
    },
    AutoHealingPolicies = new Gcp.Compute.Inputs.InstanceGroupManagerAutoHealingPoliciesArgs
    {
        HealthCheck = "string",
        InitialDelaySec = 0,
    },
    WaitForInstances = false,
    WaitForInstancesStatus = "string",
    Zone = "string",
});
example, err := compute.NewInstanceGroupManager(ctx, "instanceGroupManagerResource", &compute.InstanceGroupManagerArgs{
	BaseInstanceName: pulumi.String("string"),
	Versions: compute.InstanceGroupManagerVersionArray{
		&compute.InstanceGroupManagerVersionArgs{
			InstanceTemplate: pulumi.String("string"),
			Name:             pulumi.String("string"),
			TargetSize: &compute.InstanceGroupManagerVersionTargetSizeArgs{
				Fixed:   pulumi.Int(0),
				Percent: pulumi.Int(0),
			},
		},
	},
	StandbyPolicy: &compute.InstanceGroupManagerStandbyPolicyArgs{
		InitialDelaySec: pulumi.Int(0),
		Mode:            pulumi.String("string"),
	},
	StatefulInternalIps: compute.InstanceGroupManagerStatefulInternalIpArray{
		&compute.InstanceGroupManagerStatefulInternalIpArgs{
			DeleteRule:    pulumi.String("string"),
			InterfaceName: pulumi.String("string"),
		},
	},
	InstanceLifecyclePolicy: &compute.InstanceGroupManagerInstanceLifecyclePolicyArgs{
		DefaultActionOnFailure: pulumi.String("string"),
		ForceUpdateOnRepair:    pulumi.String("string"),
	},
	ListManagedInstancesResults: pulumi.String("string"),
	Name:                        pulumi.String("string"),
	NamedPorts: compute.InstanceGroupManagerNamedPortArray{
		&compute.InstanceGroupManagerNamedPortArgs{
			Name: pulumi.String("string"),
			Port: pulumi.Int(0),
		},
	},
	Params: &compute.InstanceGroupManagerParamsArgs{
		ResourceManagerTags: pulumi.StringMap{
			"string": pulumi.String("string"),
		},
	},
	Project: pulumi.String("string"),
	AllInstancesConfig: &compute.InstanceGroupManagerAllInstancesConfigArgs{
		Labels: pulumi.StringMap{
			"string": pulumi.String("string"),
		},
		Metadata: pulumi.StringMap{
			"string": pulumi.String("string"),
		},
	},
	StatefulDisks: compute.InstanceGroupManagerStatefulDiskArray{
		&compute.InstanceGroupManagerStatefulDiskArgs{
			DeviceName: pulumi.String("string"),
			DeleteRule: pulumi.String("string"),
		},
	},
	StatefulExternalIps: compute.InstanceGroupManagerStatefulExternalIpArray{
		&compute.InstanceGroupManagerStatefulExternalIpArgs{
			DeleteRule:    pulumi.String("string"),
			InterfaceName: pulumi.String("string"),
		},
	},
	Description: pulumi.String("string"),
	TargetPools: pulumi.StringArray{
		pulumi.String("string"),
	},
	TargetSize:          pulumi.Int(0),
	TargetStoppedSize:   pulumi.Int(0),
	TargetSuspendedSize: pulumi.Int(0),
	UpdatePolicy: &compute.InstanceGroupManagerUpdatePolicyArgs{
		MinimalAction:               pulumi.String("string"),
		Type:                        pulumi.String("string"),
		MaxSurgeFixed:               pulumi.Int(0),
		MaxSurgePercent:             pulumi.Int(0),
		MaxUnavailableFixed:         pulumi.Int(0),
		MaxUnavailablePercent:       pulumi.Int(0),
		MinReadySec:                 pulumi.Int(0),
		MostDisruptiveAllowedAction: pulumi.String("string"),
		ReplacementMethod:           pulumi.String("string"),
	},
	AutoHealingPolicies: &compute.InstanceGroupManagerAutoHealingPoliciesArgs{
		HealthCheck:     pulumi.String("string"),
		InitialDelaySec: pulumi.Int(0),
	},
	WaitForInstances:       pulumi.Bool(false),
	WaitForInstancesStatus: pulumi.String("string"),
	Zone:                   pulumi.String("string"),
})
var instanceGroupManagerResource = new InstanceGroupManager("instanceGroupManagerResource", InstanceGroupManagerArgs.builder()
    .baseInstanceName("string")
    .versions(InstanceGroupManagerVersionArgs.builder()
        .instanceTemplate("string")
        .name("string")
        .targetSize(InstanceGroupManagerVersionTargetSizeArgs.builder()
            .fixed(0)
            .percent(0)
            .build())
        .build())
    .standbyPolicy(InstanceGroupManagerStandbyPolicyArgs.builder()
        .initialDelaySec(0)
        .mode("string")
        .build())
    .statefulInternalIps(InstanceGroupManagerStatefulInternalIpArgs.builder()
        .deleteRule("string")
        .interfaceName("string")
        .build())
    .instanceLifecyclePolicy(InstanceGroupManagerInstanceLifecyclePolicyArgs.builder()
        .defaultActionOnFailure("string")
        .forceUpdateOnRepair("string")
        .build())
    .listManagedInstancesResults("string")
    .name("string")
    .namedPorts(InstanceGroupManagerNamedPortArgs.builder()
        .name("string")
        .port(0)
        .build())
    .params(InstanceGroupManagerParamsArgs.builder()
        .resourceManagerTags(Map.of("string", "string"))
        .build())
    .project("string")
    .allInstancesConfig(InstanceGroupManagerAllInstancesConfigArgs.builder()
        .labels(Map.of("string", "string"))
        .metadata(Map.of("string", "string"))
        .build())
    .statefulDisks(InstanceGroupManagerStatefulDiskArgs.builder()
        .deviceName("string")
        .deleteRule("string")
        .build())
    .statefulExternalIps(InstanceGroupManagerStatefulExternalIpArgs.builder()
        .deleteRule("string")
        .interfaceName("string")
        .build())
    .description("string")
    .targetPools("string")
    .targetSize(0)
    .targetStoppedSize(0)
    .targetSuspendedSize(0)
    .updatePolicy(InstanceGroupManagerUpdatePolicyArgs.builder()
        .minimalAction("string")
        .type("string")
        .maxSurgeFixed(0)
        .maxSurgePercent(0)
        .maxUnavailableFixed(0)
        .maxUnavailablePercent(0)
        .minReadySec(0)
        .mostDisruptiveAllowedAction("string")
        .replacementMethod("string")
        .build())
    .autoHealingPolicies(InstanceGroupManagerAutoHealingPoliciesArgs.builder()
        .healthCheck("string")
        .initialDelaySec(0)
        .build())
    .waitForInstances(false)
    .waitForInstancesStatus("string")
    .zone("string")
    .build());
instance_group_manager_resource = gcp.compute.InstanceGroupManager("instanceGroupManagerResource",
    base_instance_name="string",
    versions=[{
        "instance_template": "string",
        "name": "string",
        "target_size": {
            "fixed": 0,
            "percent": 0,
        },
    }],
    standby_policy={
        "initial_delay_sec": 0,
        "mode": "string",
    },
    stateful_internal_ips=[{
        "delete_rule": "string",
        "interface_name": "string",
    }],
    instance_lifecycle_policy={
        "default_action_on_failure": "string",
        "force_update_on_repair": "string",
    },
    list_managed_instances_results="string",
    name="string",
    named_ports=[{
        "name": "string",
        "port": 0,
    }],
    params={
        "resource_manager_tags": {
            "string": "string",
        },
    },
    project="string",
    all_instances_config={
        "labels": {
            "string": "string",
        },
        "metadata": {
            "string": "string",
        },
    },
    stateful_disks=[{
        "device_name": "string",
        "delete_rule": "string",
    }],
    stateful_external_ips=[{
        "delete_rule": "string",
        "interface_name": "string",
    }],
    description="string",
    target_pools=["string"],
    target_size=0,
    target_stopped_size=0,
    target_suspended_size=0,
    update_policy={
        "minimal_action": "string",
        "type": "string",
        "max_surge_fixed": 0,
        "max_surge_percent": 0,
        "max_unavailable_fixed": 0,
        "max_unavailable_percent": 0,
        "min_ready_sec": 0,
        "most_disruptive_allowed_action": "string",
        "replacement_method": "string",
    },
    auto_healing_policies={
        "health_check": "string",
        "initial_delay_sec": 0,
    },
    wait_for_instances=False,
    wait_for_instances_status="string",
    zone="string")
const instanceGroupManagerResource = new gcp.compute.InstanceGroupManager("instanceGroupManagerResource", {
    baseInstanceName: "string",
    versions: [{
        instanceTemplate: "string",
        name: "string",
        targetSize: {
            fixed: 0,
            percent: 0,
        },
    }],
    standbyPolicy: {
        initialDelaySec: 0,
        mode: "string",
    },
    statefulInternalIps: [{
        deleteRule: "string",
        interfaceName: "string",
    }],
    instanceLifecyclePolicy: {
        defaultActionOnFailure: "string",
        forceUpdateOnRepair: "string",
    },
    listManagedInstancesResults: "string",
    name: "string",
    namedPorts: [{
        name: "string",
        port: 0,
    }],
    params: {
        resourceManagerTags: {
            string: "string",
        },
    },
    project: "string",
    allInstancesConfig: {
        labels: {
            string: "string",
        },
        metadata: {
            string: "string",
        },
    },
    statefulDisks: [{
        deviceName: "string",
        deleteRule: "string",
    }],
    statefulExternalIps: [{
        deleteRule: "string",
        interfaceName: "string",
    }],
    description: "string",
    targetPools: ["string"],
    targetSize: 0,
    targetStoppedSize: 0,
    targetSuspendedSize: 0,
    updatePolicy: {
        minimalAction: "string",
        type: "string",
        maxSurgeFixed: 0,
        maxSurgePercent: 0,
        maxUnavailableFixed: 0,
        maxUnavailablePercent: 0,
        minReadySec: 0,
        mostDisruptiveAllowedAction: "string",
        replacementMethod: "string",
    },
    autoHealingPolicies: {
        healthCheck: "string",
        initialDelaySec: 0,
    },
    waitForInstances: false,
    waitForInstancesStatus: "string",
    zone: "string",
});
type: gcp:compute:InstanceGroupManager
properties:
    allInstancesConfig:
        labels:
            string: string
        metadata:
            string: string
    autoHealingPolicies:
        healthCheck: string
        initialDelaySec: 0
    baseInstanceName: string
    description: string
    instanceLifecyclePolicy:
        defaultActionOnFailure: string
        forceUpdateOnRepair: string
    listManagedInstancesResults: string
    name: string
    namedPorts:
        - name: string
          port: 0
    params:
        resourceManagerTags:
            string: string
    project: string
    standbyPolicy:
        initialDelaySec: 0
        mode: string
    statefulDisks:
        - deleteRule: string
          deviceName: string
    statefulExternalIps:
        - deleteRule: string
          interfaceName: string
    statefulInternalIps:
        - deleteRule: string
          interfaceName: string
    targetPools:
        - string
    targetSize: 0
    targetStoppedSize: 0
    targetSuspendedSize: 0
    updatePolicy:
        maxSurgeFixed: 0
        maxSurgePercent: 0
        maxUnavailableFixed: 0
        maxUnavailablePercent: 0
        minReadySec: 0
        minimalAction: string
        mostDisruptiveAllowedAction: string
        replacementMethod: string
        type: string
    versions:
        - instanceTemplate: string
          name: string
          targetSize:
            fixed: 0
            percent: 0
    waitForInstances: false
    waitForInstancesStatus: string
    zone: string
InstanceGroupManager Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The InstanceGroupManager resource accepts the following input properties:
- BaseInstance stringName 
- The base instance name to use for instances in this group. The value must be a valid RFC1035 name. Supported characters are lowercase letters, numbers, and hyphens (-). Instances are named by appending a hyphen and a random four-character string to the base instance name.
- Versions
List<InstanceGroup Manager Version> 
- Application versions managed by this instance group. Each version deals with a specific instance template, allowing canary release scenarios. Structure is documented below.
- AllInstances InstanceConfig Group Manager All Instances Config 
- Properties to set on all instances in the group. After setting allInstancesConfig on the group, you must update the group's instances to apply the configuration.
- AutoHealing InstancePolicies Group Manager Auto Healing Policies 
- The autohealing policies for this managed instance group. You can specify only one value. Structure is documented below. For more information, see the official documentation.
- Description string
- An optional textual description of the instance group manager.
- InstanceLifecycle InstancePolicy Group Manager Instance Lifecycle Policy 
- The instance lifecycle policy for this managed instance group.
- ListManaged stringInstances Results 
- Pagination behavior of the listManagedInstancesAPI method for this managed instance group. Valid values are:PAGELESS,PAGINATED. IfPAGELESS(default), Pagination is disabled for the group'slistManagedInstancesAPI method.maxResultsandpageTokenquery parameters are ignored and all instances are returned in a single response. IfPAGINATED, pagination is enabled,maxResultsandpageTokenquery parameters are respected.
- Name string
- The name of the instance group manager. Must be 1-63 characters long and comply with RFC1035. Supported characters include lowercase letters, numbers, and hyphens.
- NamedPorts List<InstanceGroup Manager Named Port> 
- The named port configuration. See the section below for details on configuration.
- Params
InstanceGroup Manager Params 
- Input only additional params for instance group manager creation. Structure is documented below. For more information, see API.
- Project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- StandbyPolicy InstanceGroup Manager Standby Policy 
- The standby policy for stopped and suspended instances. Structure is documented below. For more information, see the official documentation.
- StatefulDisks List<InstanceGroup Manager Stateful Disk> 
- Disks created on the instances that will be preserved on instance delete, update, etc. Structure is documented below. For more information see the official documentation.
- StatefulExternal List<InstanceIps Group Manager Stateful External Ip> 
- External network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name. Structure is documented below.
- StatefulInternal List<InstanceIps Group Manager Stateful Internal Ip> 
- Internal network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name. Structure is documented below.
- TargetPools List<string>
- The full URL of all target pools to which new instances in the group are added. Updating the target pools attribute does not affect existing instances.
- TargetSize int
- The target number of running instances for this managed instance group. This value should always be explicitly set unless this resource is attached to an autoscaler, in which case it should never be set. Defaults to 0.
- TargetStopped intSize 
- The target number of stopped instances for this managed instance group.
- TargetSuspended intSize 
- The target number of suspended instances for this managed instance group.
- UpdatePolicy InstanceGroup Manager Update Policy 
- The update policy for this managed instance group. Structure is documented below. For more information, see the official documentation and API.
- WaitFor boolInstances 
- Whether to wait for all instances to be created/updated before returning. Note that if this is set to true and the operation does not succeed, this provider will continue trying until it times out.
- WaitFor stringInstances Status 
- When used with wait_for_instancesit specifies the status to wait for. WhenSTABLEis specified this resource will wait until the instances are stable before returning. WhenUPDATEDis set, it will wait for the version target to be reached and any per instance configs to be effective as well as all instances to be stable before returning. The possible values areSTABLEandUPDATED
- Zone string
- The zone that instances in this group should be created
in.
- BaseInstance stringName 
- The base instance name to use for instances in this group. The value must be a valid RFC1035 name. Supported characters are lowercase letters, numbers, and hyphens (-). Instances are named by appending a hyphen and a random four-character string to the base instance name.
- Versions
[]InstanceGroup Manager Version Args 
- Application versions managed by this instance group. Each version deals with a specific instance template, allowing canary release scenarios. Structure is documented below.
- AllInstances InstanceConfig Group Manager All Instances Config Args 
- Properties to set on all instances in the group. After setting allInstancesConfig on the group, you must update the group's instances to apply the configuration.
- AutoHealing InstancePolicies Group Manager Auto Healing Policies Args 
- The autohealing policies for this managed instance group. You can specify only one value. Structure is documented below. For more information, see the official documentation.
- Description string
- An optional textual description of the instance group manager.
- InstanceLifecycle InstancePolicy Group Manager Instance Lifecycle Policy Args 
- The instance lifecycle policy for this managed instance group.
- ListManaged stringInstances Results 
- Pagination behavior of the listManagedInstancesAPI method for this managed instance group. Valid values are:PAGELESS,PAGINATED. IfPAGELESS(default), Pagination is disabled for the group'slistManagedInstancesAPI method.maxResultsandpageTokenquery parameters are ignored and all instances are returned in a single response. IfPAGINATED, pagination is enabled,maxResultsandpageTokenquery parameters are respected.
- Name string
- The name of the instance group manager. Must be 1-63 characters long and comply with RFC1035. Supported characters include lowercase letters, numbers, and hyphens.
- NamedPorts []InstanceGroup Manager Named Port Args 
- The named port configuration. See the section below for details on configuration.
- Params
InstanceGroup Manager Params Args 
- Input only additional params for instance group manager creation. Structure is documented below. For more information, see API.
- Project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- StandbyPolicy InstanceGroup Manager Standby Policy Args 
- The standby policy for stopped and suspended instances. Structure is documented below. For more information, see the official documentation.
- StatefulDisks []InstanceGroup Manager Stateful Disk Args 
- Disks created on the instances that will be preserved on instance delete, update, etc. Structure is documented below. For more information see the official documentation.
- StatefulExternal []InstanceIps Group Manager Stateful External Ip Args 
- External network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name. Structure is documented below.
- StatefulInternal []InstanceIps Group Manager Stateful Internal Ip Args 
- Internal network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name. Structure is documented below.
- TargetPools []string
- The full URL of all target pools to which new instances in the group are added. Updating the target pools attribute does not affect existing instances.
- TargetSize int
- The target number of running instances for this managed instance group. This value should always be explicitly set unless this resource is attached to an autoscaler, in which case it should never be set. Defaults to 0.
- TargetStopped intSize 
- The target number of stopped instances for this managed instance group.
- TargetSuspended intSize 
- The target number of suspended instances for this managed instance group.
- UpdatePolicy InstanceGroup Manager Update Policy Args 
- The update policy for this managed instance group. Structure is documented below. For more information, see the official documentation and API.
- WaitFor boolInstances 
- Whether to wait for all instances to be created/updated before returning. Note that if this is set to true and the operation does not succeed, this provider will continue trying until it times out.
- WaitFor stringInstances Status 
- When used with wait_for_instancesit specifies the status to wait for. WhenSTABLEis specified this resource will wait until the instances are stable before returning. WhenUPDATEDis set, it will wait for the version target to be reached and any per instance configs to be effective as well as all instances to be stable before returning. The possible values areSTABLEandUPDATED
- Zone string
- The zone that instances in this group should be created
in.
- baseInstance StringName 
- The base instance name to use for instances in this group. The value must be a valid RFC1035 name. Supported characters are lowercase letters, numbers, and hyphens (-). Instances are named by appending a hyphen and a random four-character string to the base instance name.
- versions
List<InstanceGroup Manager Version> 
- Application versions managed by this instance group. Each version deals with a specific instance template, allowing canary release scenarios. Structure is documented below.
- allInstances InstanceConfig Group Manager All Instances Config 
- Properties to set on all instances in the group. After setting allInstancesConfig on the group, you must update the group's instances to apply the configuration.
- autoHealing InstancePolicies Group Manager Auto Healing Policies 
- The autohealing policies for this managed instance group. You can specify only one value. Structure is documented below. For more information, see the official documentation.
- description String
- An optional textual description of the instance group manager.
- instanceLifecycle InstancePolicy Group Manager Instance Lifecycle Policy 
- The instance lifecycle policy for this managed instance group.
- listManaged StringInstances Results 
- Pagination behavior of the listManagedInstancesAPI method for this managed instance group. Valid values are:PAGELESS,PAGINATED. IfPAGELESS(default), Pagination is disabled for the group'slistManagedInstancesAPI method.maxResultsandpageTokenquery parameters are ignored and all instances are returned in a single response. IfPAGINATED, pagination is enabled,maxResultsandpageTokenquery parameters are respected.
- name String
- The name of the instance group manager. Must be 1-63 characters long and comply with RFC1035. Supported characters include lowercase letters, numbers, and hyphens.
- namedPorts List<InstanceGroup Manager Named Port> 
- The named port configuration. See the section below for details on configuration.
- params
InstanceGroup Manager Params 
- Input only additional params for instance group manager creation. Structure is documented below. For more information, see API.
- project String
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- standbyPolicy InstanceGroup Manager Standby Policy 
- The standby policy for stopped and suspended instances. Structure is documented below. For more information, see the official documentation.
- statefulDisks List<InstanceGroup Manager Stateful Disk> 
- Disks created on the instances that will be preserved on instance delete, update, etc. Structure is documented below. For more information see the official documentation.
- statefulExternal List<InstanceIps Group Manager Stateful External Ip> 
- External network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name. Structure is documented below.
- statefulInternal List<InstanceIps Group Manager Stateful Internal Ip> 
- Internal network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name. Structure is documented below.
- targetPools List<String>
- The full URL of all target pools to which new instances in the group are added. Updating the target pools attribute does not affect existing instances.
- targetSize Integer
- The target number of running instances for this managed instance group. This value should always be explicitly set unless this resource is attached to an autoscaler, in which case it should never be set. Defaults to 0.
- targetStopped IntegerSize 
- The target number of stopped instances for this managed instance group.
- targetSuspended IntegerSize 
- The target number of suspended instances for this managed instance group.
- updatePolicy InstanceGroup Manager Update Policy 
- The update policy for this managed instance group. Structure is documented below. For more information, see the official documentation and API.
- waitFor BooleanInstances 
- Whether to wait for all instances to be created/updated before returning. Note that if this is set to true and the operation does not succeed, this provider will continue trying until it times out.
- waitFor StringInstances Status 
- When used with wait_for_instancesit specifies the status to wait for. WhenSTABLEis specified this resource will wait until the instances are stable before returning. WhenUPDATEDis set, it will wait for the version target to be reached and any per instance configs to be effective as well as all instances to be stable before returning. The possible values areSTABLEandUPDATED
- zone String
- The zone that instances in this group should be created
in.
- baseInstance stringName 
- The base instance name to use for instances in this group. The value must be a valid RFC1035 name. Supported characters are lowercase letters, numbers, and hyphens (-). Instances are named by appending a hyphen and a random four-character string to the base instance name.
- versions
InstanceGroup Manager Version[] 
- Application versions managed by this instance group. Each version deals with a specific instance template, allowing canary release scenarios. Structure is documented below.
- allInstances InstanceConfig Group Manager All Instances Config 
- Properties to set on all instances in the group. After setting allInstancesConfig on the group, you must update the group's instances to apply the configuration.
- autoHealing InstancePolicies Group Manager Auto Healing Policies 
- The autohealing policies for this managed instance group. You can specify only one value. Structure is documented below. For more information, see the official documentation.
- description string
- An optional textual description of the instance group manager.
- instanceLifecycle InstancePolicy Group Manager Instance Lifecycle Policy 
- The instance lifecycle policy for this managed instance group.
- listManaged stringInstances Results 
- Pagination behavior of the listManagedInstancesAPI method for this managed instance group. Valid values are:PAGELESS,PAGINATED. IfPAGELESS(default), Pagination is disabled for the group'slistManagedInstancesAPI method.maxResultsandpageTokenquery parameters are ignored and all instances are returned in a single response. IfPAGINATED, pagination is enabled,maxResultsandpageTokenquery parameters are respected.
- name string
- The name of the instance group manager. Must be 1-63 characters long and comply with RFC1035. Supported characters include lowercase letters, numbers, and hyphens.
- namedPorts InstanceGroup Manager Named Port[] 
- The named port configuration. See the section below for details on configuration.
- params
InstanceGroup Manager Params 
- Input only additional params for instance group manager creation. Structure is documented below. For more information, see API.
- project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- standbyPolicy InstanceGroup Manager Standby Policy 
- The standby policy for stopped and suspended instances. Structure is documented below. For more information, see the official documentation.
- statefulDisks InstanceGroup Manager Stateful Disk[] 
- Disks created on the instances that will be preserved on instance delete, update, etc. Structure is documented below. For more information see the official documentation.
- statefulExternal InstanceIps Group Manager Stateful External Ip[] 
- External network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name. Structure is documented below.
- statefulInternal InstanceIps Group Manager Stateful Internal Ip[] 
- Internal network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name. Structure is documented below.
- targetPools string[]
- The full URL of all target pools to which new instances in the group are added. Updating the target pools attribute does not affect existing instances.
- targetSize number
- The target number of running instances for this managed instance group. This value should always be explicitly set unless this resource is attached to an autoscaler, in which case it should never be set. Defaults to 0.
- targetStopped numberSize 
- The target number of stopped instances for this managed instance group.
- targetSuspended numberSize 
- The target number of suspended instances for this managed instance group.
- updatePolicy InstanceGroup Manager Update Policy 
- The update policy for this managed instance group. Structure is documented below. For more information, see the official documentation and API.
- waitFor booleanInstances 
- Whether to wait for all instances to be created/updated before returning. Note that if this is set to true and the operation does not succeed, this provider will continue trying until it times out.
- waitFor stringInstances Status 
- When used with wait_for_instancesit specifies the status to wait for. WhenSTABLEis specified this resource will wait until the instances are stable before returning. WhenUPDATEDis set, it will wait for the version target to be reached and any per instance configs to be effective as well as all instances to be stable before returning. The possible values areSTABLEandUPDATED
- zone string
- The zone that instances in this group should be created
in.
- base_instance_ strname 
- The base instance name to use for instances in this group. The value must be a valid RFC1035 name. Supported characters are lowercase letters, numbers, and hyphens (-). Instances are named by appending a hyphen and a random four-character string to the base instance name.
- versions
Sequence[InstanceGroup Manager Version Args] 
- Application versions managed by this instance group. Each version deals with a specific instance template, allowing canary release scenarios. Structure is documented below.
- all_instances_ Instanceconfig Group Manager All Instances Config Args 
- Properties to set on all instances in the group. After setting allInstancesConfig on the group, you must update the group's instances to apply the configuration.
- auto_healing_ Instancepolicies Group Manager Auto Healing Policies Args 
- The autohealing policies for this managed instance group. You can specify only one value. Structure is documented below. For more information, see the official documentation.
- description str
- An optional textual description of the instance group manager.
- instance_lifecycle_ Instancepolicy Group Manager Instance Lifecycle Policy Args 
- The instance lifecycle policy for this managed instance group.
- list_managed_ strinstances_ results 
- Pagination behavior of the listManagedInstancesAPI method for this managed instance group. Valid values are:PAGELESS,PAGINATED. IfPAGELESS(default), Pagination is disabled for the group'slistManagedInstancesAPI method.maxResultsandpageTokenquery parameters are ignored and all instances are returned in a single response. IfPAGINATED, pagination is enabled,maxResultsandpageTokenquery parameters are respected.
- name str
- The name of the instance group manager. Must be 1-63 characters long and comply with RFC1035. Supported characters include lowercase letters, numbers, and hyphens.
- named_ports Sequence[InstanceGroup Manager Named Port Args] 
- The named port configuration. See the section below for details on configuration.
- params
InstanceGroup Manager Params Args 
- Input only additional params for instance group manager creation. Structure is documented below. For more information, see API.
- project str
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- standby_policy InstanceGroup Manager Standby Policy Args 
- The standby policy for stopped and suspended instances. Structure is documented below. For more information, see the official documentation.
- stateful_disks Sequence[InstanceGroup Manager Stateful Disk Args] 
- Disks created on the instances that will be preserved on instance delete, update, etc. Structure is documented below. For more information see the official documentation.
- stateful_external_ Sequence[Instanceips Group Manager Stateful External Ip Args] 
- External network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name. Structure is documented below.
- stateful_internal_ Sequence[Instanceips Group Manager Stateful Internal Ip Args] 
- Internal network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name. Structure is documented below.
- target_pools Sequence[str]
- The full URL of all target pools to which new instances in the group are added. Updating the target pools attribute does not affect existing instances.
- target_size int
- The target number of running instances for this managed instance group. This value should always be explicitly set unless this resource is attached to an autoscaler, in which case it should never be set. Defaults to 0.
- target_stopped_ intsize 
- The target number of stopped instances for this managed instance group.
- target_suspended_ intsize 
- The target number of suspended instances for this managed instance group.
- update_policy InstanceGroup Manager Update Policy Args 
- The update policy for this managed instance group. Structure is documented below. For more information, see the official documentation and API.
- wait_for_ boolinstances 
- Whether to wait for all instances to be created/updated before returning. Note that if this is set to true and the operation does not succeed, this provider will continue trying until it times out.
- wait_for_ strinstances_ status 
- When used with wait_for_instancesit specifies the status to wait for. WhenSTABLEis specified this resource will wait until the instances are stable before returning. WhenUPDATEDis set, it will wait for the version target to be reached and any per instance configs to be effective as well as all instances to be stable before returning. The possible values areSTABLEandUPDATED
- zone str
- The zone that instances in this group should be created
in.
- baseInstance StringName 
- The base instance name to use for instances in this group. The value must be a valid RFC1035 name. Supported characters are lowercase letters, numbers, and hyphens (-). Instances are named by appending a hyphen and a random four-character string to the base instance name.
- versions List<Property Map>
- Application versions managed by this instance group. Each version deals with a specific instance template, allowing canary release scenarios. Structure is documented below.
- allInstances Property MapConfig 
- Properties to set on all instances in the group. After setting allInstancesConfig on the group, you must update the group's instances to apply the configuration.
- autoHealing Property MapPolicies 
- The autohealing policies for this managed instance group. You can specify only one value. Structure is documented below. For more information, see the official documentation.
- description String
- An optional textual description of the instance group manager.
- instanceLifecycle Property MapPolicy 
- The instance lifecycle policy for this managed instance group.
- listManaged StringInstances Results 
- Pagination behavior of the listManagedInstancesAPI method for this managed instance group. Valid values are:PAGELESS,PAGINATED. IfPAGELESS(default), Pagination is disabled for the group'slistManagedInstancesAPI method.maxResultsandpageTokenquery parameters are ignored and all instances are returned in a single response. IfPAGINATED, pagination is enabled,maxResultsandpageTokenquery parameters are respected.
- name String
- The name of the instance group manager. Must be 1-63 characters long and comply with RFC1035. Supported characters include lowercase letters, numbers, and hyphens.
- namedPorts List<Property Map>
- The named port configuration. See the section below for details on configuration.
- params Property Map
- Input only additional params for instance group manager creation. Structure is documented below. For more information, see API.
- project String
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- standbyPolicy Property Map
- The standby policy for stopped and suspended instances. Structure is documented below. For more information, see the official documentation.
- statefulDisks List<Property Map>
- Disks created on the instances that will be preserved on instance delete, update, etc. Structure is documented below. For more information see the official documentation.
- statefulExternal List<Property Map>Ips 
- External network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name. Structure is documented below.
- statefulInternal List<Property Map>Ips 
- Internal network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name. Structure is documented below.
- targetPools List<String>
- The full URL of all target pools to which new instances in the group are added. Updating the target pools attribute does not affect existing instances.
- targetSize Number
- The target number of running instances for this managed instance group. This value should always be explicitly set unless this resource is attached to an autoscaler, in which case it should never be set. Defaults to 0.
- targetStopped NumberSize 
- The target number of stopped instances for this managed instance group.
- targetSuspended NumberSize 
- The target number of suspended instances for this managed instance group.
- updatePolicy Property Map
- The update policy for this managed instance group. Structure is documented below. For more information, see the official documentation and API.
- waitFor BooleanInstances 
- Whether to wait for all instances to be created/updated before returning. Note that if this is set to true and the operation does not succeed, this provider will continue trying until it times out.
- waitFor StringInstances Status 
- When used with wait_for_instancesit specifies the status to wait for. WhenSTABLEis specified this resource will wait until the instances are stable before returning. WhenUPDATEDis set, it will wait for the version target to be reached and any per instance configs to be effective as well as all instances to be stable before returning. The possible values areSTABLEandUPDATED
- zone String
- The zone that instances in this group should be created
in.
Outputs
All input properties are implicitly available as output properties. Additionally, the InstanceGroupManager resource produces the following output properties:
- CreationTimestamp string
- Creation timestamp in RFC3339 text format.
- Fingerprint string
- The fingerprint of the instance group manager.
- Id string
- The provider-assigned unique ID for this managed resource.
- InstanceGroup string
- The full URL of the instance group created by the manager.
- InstanceGroup intManager Id 
- The unique identifier number for the resource. This identifier is defined by the server.
- Operation string
- SelfLink string
- The URL of the created resource.
- Statuses
List<InstanceGroup Manager Status> 
- The status of this managed instance group.
- CreationTimestamp string
- Creation timestamp in RFC3339 text format.
- Fingerprint string
- The fingerprint of the instance group manager.
- Id string
- The provider-assigned unique ID for this managed resource.
- InstanceGroup string
- The full URL of the instance group created by the manager.
- InstanceGroup intManager Id 
- The unique identifier number for the resource. This identifier is defined by the server.
- Operation string
- SelfLink string
- The URL of the created resource.
- Statuses
[]InstanceGroup Manager Status 
- The status of this managed instance group.
- creationTimestamp String
- Creation timestamp in RFC3339 text format.
- fingerprint String
- The fingerprint of the instance group manager.
- id String
- The provider-assigned unique ID for this managed resource.
- instanceGroup String
- The full URL of the instance group created by the manager.
- instanceGroup IntegerManager Id 
- The unique identifier number for the resource. This identifier is defined by the server.
- operation String
- selfLink String
- The URL of the created resource.
- statuses
List<InstanceGroup Manager Status> 
- The status of this managed instance group.
- creationTimestamp string
- Creation timestamp in RFC3339 text format.
- fingerprint string
- The fingerprint of the instance group manager.
- id string
- The provider-assigned unique ID for this managed resource.
- instanceGroup string
- The full URL of the instance group created by the manager.
- instanceGroup numberManager Id 
- The unique identifier number for the resource. This identifier is defined by the server.
- operation string
- selfLink string
- The URL of the created resource.
- statuses
InstanceGroup Manager Status[] 
- The status of this managed instance group.
- creation_timestamp str
- Creation timestamp in RFC3339 text format.
- fingerprint str
- The fingerprint of the instance group manager.
- id str
- The provider-assigned unique ID for this managed resource.
- instance_group str
- The full URL of the instance group created by the manager.
- instance_group_ intmanager_ id 
- The unique identifier number for the resource. This identifier is defined by the server.
- operation str
- self_link str
- The URL of the created resource.
- statuses
Sequence[InstanceGroup Manager Status] 
- The status of this managed instance group.
- creationTimestamp String
- Creation timestamp in RFC3339 text format.
- fingerprint String
- The fingerprint of the instance group manager.
- id String
- The provider-assigned unique ID for this managed resource.
- instanceGroup String
- The full URL of the instance group created by the manager.
- instanceGroup NumberManager Id 
- The unique identifier number for the resource. This identifier is defined by the server.
- operation String
- selfLink String
- The URL of the created resource.
- statuses List<Property Map>
- The status of this managed instance group.
Look up Existing InstanceGroupManager Resource
Get an existing InstanceGroupManager resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: InstanceGroupManagerState, opts?: CustomResourceOptions): InstanceGroupManager@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        all_instances_config: Optional[InstanceGroupManagerAllInstancesConfigArgs] = None,
        auto_healing_policies: Optional[InstanceGroupManagerAutoHealingPoliciesArgs] = None,
        base_instance_name: Optional[str] = None,
        creation_timestamp: Optional[str] = None,
        description: Optional[str] = None,
        fingerprint: Optional[str] = None,
        instance_group: Optional[str] = None,
        instance_group_manager_id: Optional[int] = None,
        instance_lifecycle_policy: Optional[InstanceGroupManagerInstanceLifecyclePolicyArgs] = None,
        list_managed_instances_results: Optional[str] = None,
        name: Optional[str] = None,
        named_ports: Optional[Sequence[InstanceGroupManagerNamedPortArgs]] = None,
        operation: Optional[str] = None,
        params: Optional[InstanceGroupManagerParamsArgs] = None,
        project: Optional[str] = None,
        self_link: Optional[str] = None,
        standby_policy: Optional[InstanceGroupManagerStandbyPolicyArgs] = None,
        stateful_disks: Optional[Sequence[InstanceGroupManagerStatefulDiskArgs]] = None,
        stateful_external_ips: Optional[Sequence[InstanceGroupManagerStatefulExternalIpArgs]] = None,
        stateful_internal_ips: Optional[Sequence[InstanceGroupManagerStatefulInternalIpArgs]] = None,
        statuses: Optional[Sequence[InstanceGroupManagerStatusArgs]] = None,
        target_pools: Optional[Sequence[str]] = None,
        target_size: Optional[int] = None,
        target_stopped_size: Optional[int] = None,
        target_suspended_size: Optional[int] = None,
        update_policy: Optional[InstanceGroupManagerUpdatePolicyArgs] = None,
        versions: Optional[Sequence[InstanceGroupManagerVersionArgs]] = None,
        wait_for_instances: Optional[bool] = None,
        wait_for_instances_status: Optional[str] = None,
        zone: Optional[str] = None) -> InstanceGroupManagerfunc GetInstanceGroupManager(ctx *Context, name string, id IDInput, state *InstanceGroupManagerState, opts ...ResourceOption) (*InstanceGroupManager, error)public static InstanceGroupManager Get(string name, Input<string> id, InstanceGroupManagerState? state, CustomResourceOptions? opts = null)public static InstanceGroupManager get(String name, Output<String> id, InstanceGroupManagerState state, CustomResourceOptions options)resources:  _:    type: gcp:compute:InstanceGroupManager    get:      id: ${id}- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- AllInstances InstanceConfig Group Manager All Instances Config 
- Properties to set on all instances in the group. After setting allInstancesConfig on the group, you must update the group's instances to apply the configuration.
- AutoHealing InstancePolicies Group Manager Auto Healing Policies 
- The autohealing policies for this managed instance group. You can specify only one value. Structure is documented below. For more information, see the official documentation.
- BaseInstance stringName 
- The base instance name to use for instances in this group. The value must be a valid RFC1035 name. Supported characters are lowercase letters, numbers, and hyphens (-). Instances are named by appending a hyphen and a random four-character string to the base instance name.
- CreationTimestamp string
- Creation timestamp in RFC3339 text format.
- Description string
- An optional textual description of the instance group manager.
- Fingerprint string
- The fingerprint of the instance group manager.
- InstanceGroup string
- The full URL of the instance group created by the manager.
- InstanceGroup intManager Id 
- The unique identifier number for the resource. This identifier is defined by the server.
- InstanceLifecycle InstancePolicy Group Manager Instance Lifecycle Policy 
- The instance lifecycle policy for this managed instance group.
- ListManaged stringInstances Results 
- Pagination behavior of the listManagedInstancesAPI method for this managed instance group. Valid values are:PAGELESS,PAGINATED. IfPAGELESS(default), Pagination is disabled for the group'slistManagedInstancesAPI method.maxResultsandpageTokenquery parameters are ignored and all instances are returned in a single response. IfPAGINATED, pagination is enabled,maxResultsandpageTokenquery parameters are respected.
- Name string
- The name of the instance group manager. Must be 1-63 characters long and comply with RFC1035. Supported characters include lowercase letters, numbers, and hyphens.
- NamedPorts List<InstanceGroup Manager Named Port> 
- The named port configuration. See the section below for details on configuration.
- Operation string
- Params
InstanceGroup Manager Params 
- Input only additional params for instance group manager creation. Structure is documented below. For more information, see API.
- Project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- SelfLink string
- The URL of the created resource.
- StandbyPolicy InstanceGroup Manager Standby Policy 
- The standby policy for stopped and suspended instances. Structure is documented below. For more information, see the official documentation.
- StatefulDisks List<InstanceGroup Manager Stateful Disk> 
- Disks created on the instances that will be preserved on instance delete, update, etc. Structure is documented below. For more information see the official documentation.
- StatefulExternal List<InstanceIps Group Manager Stateful External Ip> 
- External network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name. Structure is documented below.
- StatefulInternal List<InstanceIps Group Manager Stateful Internal Ip> 
- Internal network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name. Structure is documented below.
- Statuses
List<InstanceGroup Manager Status> 
- The status of this managed instance group.
- TargetPools List<string>
- The full URL of all target pools to which new instances in the group are added. Updating the target pools attribute does not affect existing instances.
- TargetSize int
- The target number of running instances for this managed instance group. This value should always be explicitly set unless this resource is attached to an autoscaler, in which case it should never be set. Defaults to 0.
- TargetStopped intSize 
- The target number of stopped instances for this managed instance group.
- TargetSuspended intSize 
- The target number of suspended instances for this managed instance group.
- UpdatePolicy InstanceGroup Manager Update Policy 
- The update policy for this managed instance group. Structure is documented below. For more information, see the official documentation and API.
- Versions
List<InstanceGroup Manager Version> 
- Application versions managed by this instance group. Each version deals with a specific instance template, allowing canary release scenarios. Structure is documented below.
- WaitFor boolInstances 
- Whether to wait for all instances to be created/updated before returning. Note that if this is set to true and the operation does not succeed, this provider will continue trying until it times out.
- WaitFor stringInstances Status 
- When used with wait_for_instancesit specifies the status to wait for. WhenSTABLEis specified this resource will wait until the instances are stable before returning. WhenUPDATEDis set, it will wait for the version target to be reached and any per instance configs to be effective as well as all instances to be stable before returning. The possible values areSTABLEandUPDATED
- Zone string
- The zone that instances in this group should be created
in.
- AllInstances InstanceConfig Group Manager All Instances Config Args 
- Properties to set on all instances in the group. After setting allInstancesConfig on the group, you must update the group's instances to apply the configuration.
- AutoHealing InstancePolicies Group Manager Auto Healing Policies Args 
- The autohealing policies for this managed instance group. You can specify only one value. Structure is documented below. For more information, see the official documentation.
- BaseInstance stringName 
- The base instance name to use for instances in this group. The value must be a valid RFC1035 name. Supported characters are lowercase letters, numbers, and hyphens (-). Instances are named by appending a hyphen and a random four-character string to the base instance name.
- CreationTimestamp string
- Creation timestamp in RFC3339 text format.
- Description string
- An optional textual description of the instance group manager.
- Fingerprint string
- The fingerprint of the instance group manager.
- InstanceGroup string
- The full URL of the instance group created by the manager.
- InstanceGroup intManager Id 
- The unique identifier number for the resource. This identifier is defined by the server.
- InstanceLifecycle InstancePolicy Group Manager Instance Lifecycle Policy Args 
- The instance lifecycle policy for this managed instance group.
- ListManaged stringInstances Results 
- Pagination behavior of the listManagedInstancesAPI method for this managed instance group. Valid values are:PAGELESS,PAGINATED. IfPAGELESS(default), Pagination is disabled for the group'slistManagedInstancesAPI method.maxResultsandpageTokenquery parameters are ignored and all instances are returned in a single response. IfPAGINATED, pagination is enabled,maxResultsandpageTokenquery parameters are respected.
- Name string
- The name of the instance group manager. Must be 1-63 characters long and comply with RFC1035. Supported characters include lowercase letters, numbers, and hyphens.
- NamedPorts []InstanceGroup Manager Named Port Args 
- The named port configuration. See the section below for details on configuration.
- Operation string
- Params
InstanceGroup Manager Params Args 
- Input only additional params for instance group manager creation. Structure is documented below. For more information, see API.
- Project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- SelfLink string
- The URL of the created resource.
- StandbyPolicy InstanceGroup Manager Standby Policy Args 
- The standby policy for stopped and suspended instances. Structure is documented below. For more information, see the official documentation.
- StatefulDisks []InstanceGroup Manager Stateful Disk Args 
- Disks created on the instances that will be preserved on instance delete, update, etc. Structure is documented below. For more information see the official documentation.
- StatefulExternal []InstanceIps Group Manager Stateful External Ip Args 
- External network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name. Structure is documented below.
- StatefulInternal []InstanceIps Group Manager Stateful Internal Ip Args 
- Internal network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name. Structure is documented below.
- Statuses
[]InstanceGroup Manager Status Args 
- The status of this managed instance group.
- TargetPools []string
- The full URL of all target pools to which new instances in the group are added. Updating the target pools attribute does not affect existing instances.
- TargetSize int
- The target number of running instances for this managed instance group. This value should always be explicitly set unless this resource is attached to an autoscaler, in which case it should never be set. Defaults to 0.
- TargetStopped intSize 
- The target number of stopped instances for this managed instance group.
- TargetSuspended intSize 
- The target number of suspended instances for this managed instance group.
- UpdatePolicy InstanceGroup Manager Update Policy Args 
- The update policy for this managed instance group. Structure is documented below. For more information, see the official documentation and API.
- Versions
[]InstanceGroup Manager Version Args 
- Application versions managed by this instance group. Each version deals with a specific instance template, allowing canary release scenarios. Structure is documented below.
- WaitFor boolInstances 
- Whether to wait for all instances to be created/updated before returning. Note that if this is set to true and the operation does not succeed, this provider will continue trying until it times out.
- WaitFor stringInstances Status 
- When used with wait_for_instancesit specifies the status to wait for. WhenSTABLEis specified this resource will wait until the instances are stable before returning. WhenUPDATEDis set, it will wait for the version target to be reached and any per instance configs to be effective as well as all instances to be stable before returning. The possible values areSTABLEandUPDATED
- Zone string
- The zone that instances in this group should be created
in.
- allInstances InstanceConfig Group Manager All Instances Config 
- Properties to set on all instances in the group. After setting allInstancesConfig on the group, you must update the group's instances to apply the configuration.
- autoHealing InstancePolicies Group Manager Auto Healing Policies 
- The autohealing policies for this managed instance group. You can specify only one value. Structure is documented below. For more information, see the official documentation.
- baseInstance StringName 
- The base instance name to use for instances in this group. The value must be a valid RFC1035 name. Supported characters are lowercase letters, numbers, and hyphens (-). Instances are named by appending a hyphen and a random four-character string to the base instance name.
- creationTimestamp String
- Creation timestamp in RFC3339 text format.
- description String
- An optional textual description of the instance group manager.
- fingerprint String
- The fingerprint of the instance group manager.
- instanceGroup String
- The full URL of the instance group created by the manager.
- instanceGroup IntegerManager Id 
- The unique identifier number for the resource. This identifier is defined by the server.
- instanceLifecycle InstancePolicy Group Manager Instance Lifecycle Policy 
- The instance lifecycle policy for this managed instance group.
- listManaged StringInstances Results 
- Pagination behavior of the listManagedInstancesAPI method for this managed instance group. Valid values are:PAGELESS,PAGINATED. IfPAGELESS(default), Pagination is disabled for the group'slistManagedInstancesAPI method.maxResultsandpageTokenquery parameters are ignored and all instances are returned in a single response. IfPAGINATED, pagination is enabled,maxResultsandpageTokenquery parameters are respected.
- name String
- The name of the instance group manager. Must be 1-63 characters long and comply with RFC1035. Supported characters include lowercase letters, numbers, and hyphens.
- namedPorts List<InstanceGroup Manager Named Port> 
- The named port configuration. See the section below for details on configuration.
- operation String
- params
InstanceGroup Manager Params 
- Input only additional params for instance group manager creation. Structure is documented below. For more information, see API.
- project String
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- selfLink String
- The URL of the created resource.
- standbyPolicy InstanceGroup Manager Standby Policy 
- The standby policy for stopped and suspended instances. Structure is documented below. For more information, see the official documentation.
- statefulDisks List<InstanceGroup Manager Stateful Disk> 
- Disks created on the instances that will be preserved on instance delete, update, etc. Structure is documented below. For more information see the official documentation.
- statefulExternal List<InstanceIps Group Manager Stateful External Ip> 
- External network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name. Structure is documented below.
- statefulInternal List<InstanceIps Group Manager Stateful Internal Ip> 
- Internal network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name. Structure is documented below.
- statuses
List<InstanceGroup Manager Status> 
- The status of this managed instance group.
- targetPools List<String>
- The full URL of all target pools to which new instances in the group are added. Updating the target pools attribute does not affect existing instances.
- targetSize Integer
- The target number of running instances for this managed instance group. This value should always be explicitly set unless this resource is attached to an autoscaler, in which case it should never be set. Defaults to 0.
- targetStopped IntegerSize 
- The target number of stopped instances for this managed instance group.
- targetSuspended IntegerSize 
- The target number of suspended instances for this managed instance group.
- updatePolicy InstanceGroup Manager Update Policy 
- The update policy for this managed instance group. Structure is documented below. For more information, see the official documentation and API.
- versions
List<InstanceGroup Manager Version> 
- Application versions managed by this instance group. Each version deals with a specific instance template, allowing canary release scenarios. Structure is documented below.
- waitFor BooleanInstances 
- Whether to wait for all instances to be created/updated before returning. Note that if this is set to true and the operation does not succeed, this provider will continue trying until it times out.
- waitFor StringInstances Status 
- When used with wait_for_instancesit specifies the status to wait for. WhenSTABLEis specified this resource will wait until the instances are stable before returning. WhenUPDATEDis set, it will wait for the version target to be reached and any per instance configs to be effective as well as all instances to be stable before returning. The possible values areSTABLEandUPDATED
- zone String
- The zone that instances in this group should be created
in.
- allInstances InstanceConfig Group Manager All Instances Config 
- Properties to set on all instances in the group. After setting allInstancesConfig on the group, you must update the group's instances to apply the configuration.
- autoHealing InstancePolicies Group Manager Auto Healing Policies 
- The autohealing policies for this managed instance group. You can specify only one value. Structure is documented below. For more information, see the official documentation.
- baseInstance stringName 
- The base instance name to use for instances in this group. The value must be a valid RFC1035 name. Supported characters are lowercase letters, numbers, and hyphens (-). Instances are named by appending a hyphen and a random four-character string to the base instance name.
- creationTimestamp string
- Creation timestamp in RFC3339 text format.
- description string
- An optional textual description of the instance group manager.
- fingerprint string
- The fingerprint of the instance group manager.
- instanceGroup string
- The full URL of the instance group created by the manager.
- instanceGroup numberManager Id 
- The unique identifier number for the resource. This identifier is defined by the server.
- instanceLifecycle InstancePolicy Group Manager Instance Lifecycle Policy 
- The instance lifecycle policy for this managed instance group.
- listManaged stringInstances Results 
- Pagination behavior of the listManagedInstancesAPI method for this managed instance group. Valid values are:PAGELESS,PAGINATED. IfPAGELESS(default), Pagination is disabled for the group'slistManagedInstancesAPI method.maxResultsandpageTokenquery parameters are ignored and all instances are returned in a single response. IfPAGINATED, pagination is enabled,maxResultsandpageTokenquery parameters are respected.
- name string
- The name of the instance group manager. Must be 1-63 characters long and comply with RFC1035. Supported characters include lowercase letters, numbers, and hyphens.
- namedPorts InstanceGroup Manager Named Port[] 
- The named port configuration. See the section below for details on configuration.
- operation string
- params
InstanceGroup Manager Params 
- Input only additional params for instance group manager creation. Structure is documented below. For more information, see API.
- project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- selfLink string
- The URL of the created resource.
- standbyPolicy InstanceGroup Manager Standby Policy 
- The standby policy for stopped and suspended instances. Structure is documented below. For more information, see the official documentation.
- statefulDisks InstanceGroup Manager Stateful Disk[] 
- Disks created on the instances that will be preserved on instance delete, update, etc. Structure is documented below. For more information see the official documentation.
- statefulExternal InstanceIps Group Manager Stateful External Ip[] 
- External network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name. Structure is documented below.
- statefulInternal InstanceIps Group Manager Stateful Internal Ip[] 
- Internal network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name. Structure is documented below.
- statuses
InstanceGroup Manager Status[] 
- The status of this managed instance group.
- targetPools string[]
- The full URL of all target pools to which new instances in the group are added. Updating the target pools attribute does not affect existing instances.
- targetSize number
- The target number of running instances for this managed instance group. This value should always be explicitly set unless this resource is attached to an autoscaler, in which case it should never be set. Defaults to 0.
- targetStopped numberSize 
- The target number of stopped instances for this managed instance group.
- targetSuspended numberSize 
- The target number of suspended instances for this managed instance group.
- updatePolicy InstanceGroup Manager Update Policy 
- The update policy for this managed instance group. Structure is documented below. For more information, see the official documentation and API.
- versions
InstanceGroup Manager Version[] 
- Application versions managed by this instance group. Each version deals with a specific instance template, allowing canary release scenarios. Structure is documented below.
- waitFor booleanInstances 
- Whether to wait for all instances to be created/updated before returning. Note that if this is set to true and the operation does not succeed, this provider will continue trying until it times out.
- waitFor stringInstances Status 
- When used with wait_for_instancesit specifies the status to wait for. WhenSTABLEis specified this resource will wait until the instances are stable before returning. WhenUPDATEDis set, it will wait for the version target to be reached and any per instance configs to be effective as well as all instances to be stable before returning. The possible values areSTABLEandUPDATED
- zone string
- The zone that instances in this group should be created
in.
- all_instances_ Instanceconfig Group Manager All Instances Config Args 
- Properties to set on all instances in the group. After setting allInstancesConfig on the group, you must update the group's instances to apply the configuration.
- auto_healing_ Instancepolicies Group Manager Auto Healing Policies Args 
- The autohealing policies for this managed instance group. You can specify only one value. Structure is documented below. For more information, see the official documentation.
- base_instance_ strname 
- The base instance name to use for instances in this group. The value must be a valid RFC1035 name. Supported characters are lowercase letters, numbers, and hyphens (-). Instances are named by appending a hyphen and a random four-character string to the base instance name.
- creation_timestamp str
- Creation timestamp in RFC3339 text format.
- description str
- An optional textual description of the instance group manager.
- fingerprint str
- The fingerprint of the instance group manager.
- instance_group str
- The full URL of the instance group created by the manager.
- instance_group_ intmanager_ id 
- The unique identifier number for the resource. This identifier is defined by the server.
- instance_lifecycle_ Instancepolicy Group Manager Instance Lifecycle Policy Args 
- The instance lifecycle policy for this managed instance group.
- list_managed_ strinstances_ results 
- Pagination behavior of the listManagedInstancesAPI method for this managed instance group. Valid values are:PAGELESS,PAGINATED. IfPAGELESS(default), Pagination is disabled for the group'slistManagedInstancesAPI method.maxResultsandpageTokenquery parameters are ignored and all instances are returned in a single response. IfPAGINATED, pagination is enabled,maxResultsandpageTokenquery parameters are respected.
- name str
- The name of the instance group manager. Must be 1-63 characters long and comply with RFC1035. Supported characters include lowercase letters, numbers, and hyphens.
- named_ports Sequence[InstanceGroup Manager Named Port Args] 
- The named port configuration. See the section below for details on configuration.
- operation str
- params
InstanceGroup Manager Params Args 
- Input only additional params for instance group manager creation. Structure is documented below. For more information, see API.
- project str
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- self_link str
- The URL of the created resource.
- standby_policy InstanceGroup Manager Standby Policy Args 
- The standby policy for stopped and suspended instances. Structure is documented below. For more information, see the official documentation.
- stateful_disks Sequence[InstanceGroup Manager Stateful Disk Args] 
- Disks created on the instances that will be preserved on instance delete, update, etc. Structure is documented below. For more information see the official documentation.
- stateful_external_ Sequence[Instanceips Group Manager Stateful External Ip Args] 
- External network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name. Structure is documented below.
- stateful_internal_ Sequence[Instanceips Group Manager Stateful Internal Ip Args] 
- Internal network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name. Structure is documented below.
- statuses
Sequence[InstanceGroup Manager Status Args] 
- The status of this managed instance group.
- target_pools Sequence[str]
- The full URL of all target pools to which new instances in the group are added. Updating the target pools attribute does not affect existing instances.
- target_size int
- The target number of running instances for this managed instance group. This value should always be explicitly set unless this resource is attached to an autoscaler, in which case it should never be set. Defaults to 0.
- target_stopped_ intsize 
- The target number of stopped instances for this managed instance group.
- target_suspended_ intsize 
- The target number of suspended instances for this managed instance group.
- update_policy InstanceGroup Manager Update Policy Args 
- The update policy for this managed instance group. Structure is documented below. For more information, see the official documentation and API.
- versions
Sequence[InstanceGroup Manager Version Args] 
- Application versions managed by this instance group. Each version deals with a specific instance template, allowing canary release scenarios. Structure is documented below.
- wait_for_ boolinstances 
- Whether to wait for all instances to be created/updated before returning. Note that if this is set to true and the operation does not succeed, this provider will continue trying until it times out.
- wait_for_ strinstances_ status 
- When used with wait_for_instancesit specifies the status to wait for. WhenSTABLEis specified this resource will wait until the instances are stable before returning. WhenUPDATEDis set, it will wait for the version target to be reached and any per instance configs to be effective as well as all instances to be stable before returning. The possible values areSTABLEandUPDATED
- zone str
- The zone that instances in this group should be created
in.
- allInstances Property MapConfig 
- Properties to set on all instances in the group. After setting allInstancesConfig on the group, you must update the group's instances to apply the configuration.
- autoHealing Property MapPolicies 
- The autohealing policies for this managed instance group. You can specify only one value. Structure is documented below. For more information, see the official documentation.
- baseInstance StringName 
- The base instance name to use for instances in this group. The value must be a valid RFC1035 name. Supported characters are lowercase letters, numbers, and hyphens (-). Instances are named by appending a hyphen and a random four-character string to the base instance name.
- creationTimestamp String
- Creation timestamp in RFC3339 text format.
- description String
- An optional textual description of the instance group manager.
- fingerprint String
- The fingerprint of the instance group manager.
- instanceGroup String
- The full URL of the instance group created by the manager.
- instanceGroup NumberManager Id 
- The unique identifier number for the resource. This identifier is defined by the server.
- instanceLifecycle Property MapPolicy 
- The instance lifecycle policy for this managed instance group.
- listManaged StringInstances Results 
- Pagination behavior of the listManagedInstancesAPI method for this managed instance group. Valid values are:PAGELESS,PAGINATED. IfPAGELESS(default), Pagination is disabled for the group'slistManagedInstancesAPI method.maxResultsandpageTokenquery parameters are ignored and all instances are returned in a single response. IfPAGINATED, pagination is enabled,maxResultsandpageTokenquery parameters are respected.
- name String
- The name of the instance group manager. Must be 1-63 characters long and comply with RFC1035. Supported characters include lowercase letters, numbers, and hyphens.
- namedPorts List<Property Map>
- The named port configuration. See the section below for details on configuration.
- operation String
- params Property Map
- Input only additional params for instance group manager creation. Structure is documented below. For more information, see API.
- project String
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- selfLink String
- The URL of the created resource.
- standbyPolicy Property Map
- The standby policy for stopped and suspended instances. Structure is documented below. For more information, see the official documentation.
- statefulDisks List<Property Map>
- Disks created on the instances that will be preserved on instance delete, update, etc. Structure is documented below. For more information see the official documentation.
- statefulExternal List<Property Map>Ips 
- External network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name. Structure is documented below.
- statefulInternal List<Property Map>Ips 
- Internal network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name. Structure is documented below.
- statuses List<Property Map>
- The status of this managed instance group.
- targetPools List<String>
- The full URL of all target pools to which new instances in the group are added. Updating the target pools attribute does not affect existing instances.
- targetSize Number
- The target number of running instances for this managed instance group. This value should always be explicitly set unless this resource is attached to an autoscaler, in which case it should never be set. Defaults to 0.
- targetStopped NumberSize 
- The target number of stopped instances for this managed instance group.
- targetSuspended NumberSize 
- The target number of suspended instances for this managed instance group.
- updatePolicy Property Map
- The update policy for this managed instance group. Structure is documented below. For more information, see the official documentation and API.
- versions List<Property Map>
- Application versions managed by this instance group. Each version deals with a specific instance template, allowing canary release scenarios. Structure is documented below.
- waitFor BooleanInstances 
- Whether to wait for all instances to be created/updated before returning. Note that if this is set to true and the operation does not succeed, this provider will continue trying until it times out.
- waitFor StringInstances Status 
- When used with wait_for_instancesit specifies the status to wait for. WhenSTABLEis specified this resource will wait until the instances are stable before returning. WhenUPDATEDis set, it will wait for the version target to be reached and any per instance configs to be effective as well as all instances to be stable before returning. The possible values areSTABLEandUPDATED
- zone String
- The zone that instances in this group should be created
in.
Supporting Types
InstanceGroupManagerAllInstancesConfig, InstanceGroupManagerAllInstancesConfigArgs            
- 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.
InstanceGroupManagerAutoHealingPolicies, InstanceGroupManagerAutoHealingPoliciesArgs            
- HealthCheck string
- The health check resource that signals autohealing.
- InitialDelay intSec 
- 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.
- InitialDelay intSec 
- 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.
- initialDelay IntegerSec 
- 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.
- initialDelay numberSec 
- 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_ intsec 
- 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.
- initialDelay NumberSec 
- 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.
InstanceGroupManagerInstanceLifecyclePolicy, InstanceGroupManagerInstanceLifecyclePolicyArgs            
- DefaultAction stringOn Failure 
- , Default behavior for all instance or health check failures. Valid options are: REPAIR,DO_NOTHING. IfDO_NOTHINGthen instances will not be repaired. IfREPAIR(default), then failed instances will be repaired.
- ForceUpdate stringOn Repair 
- , Specifies whether to apply the group's latest configuration when repairing a VM. Valid options are: YES,NO. IfYESand 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. IfNO(default), then updates are applied in accordance with the group's update policy type.
- DefaultAction stringOn Failure 
- , Default behavior for all instance or health check failures. Valid options are: REPAIR,DO_NOTHING. IfDO_NOTHINGthen instances will not be repaired. IfREPAIR(default), then failed instances will be repaired.
- ForceUpdate stringOn Repair 
- , Specifies whether to apply the group's latest configuration when repairing a VM. Valid options are: YES,NO. IfYESand 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. IfNO(default), then updates are applied in accordance with the group's update policy type.
- defaultAction StringOn Failure 
- , Default behavior for all instance or health check failures. Valid options are: REPAIR,DO_NOTHING. IfDO_NOTHINGthen instances will not be repaired. IfREPAIR(default), then failed instances will be repaired.
- forceUpdate StringOn Repair 
- , Specifies whether to apply the group's latest configuration when repairing a VM. Valid options are: YES,NO. IfYESand 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. IfNO(default), then updates are applied in accordance with the group's update policy type.
- defaultAction stringOn Failure 
- , Default behavior for all instance or health check failures. Valid options are: REPAIR,DO_NOTHING. IfDO_NOTHINGthen instances will not be repaired. IfREPAIR(default), then failed instances will be repaired.
- forceUpdate stringOn Repair 
- , Specifies whether to apply the group's latest configuration when repairing a VM. Valid options are: YES,NO. IfYESand 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. IfNO(default), then updates are applied in accordance with the group's update policy type.
- default_action_ stron_ failure 
- , Default behavior for all instance or health check failures. Valid options are: REPAIR,DO_NOTHING. IfDO_NOTHINGthen instances will not be repaired. IfREPAIR(default), then failed instances will be repaired.
- force_update_ stron_ repair 
- , Specifies whether to apply the group's latest configuration when repairing a VM. Valid options are: YES,NO. IfYESand 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. IfNO(default), then updates are applied in accordance with the group's update policy type.
- defaultAction StringOn Failure 
- , Default behavior for all instance or health check failures. Valid options are: REPAIR,DO_NOTHING. IfDO_NOTHINGthen instances will not be repaired. IfREPAIR(default), then failed instances will be repaired.
- forceUpdate StringOn Repair 
- , Specifies whether to apply the group's latest configuration when repairing a VM. Valid options are: YES,NO. IfYESand 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. IfNO(default), then updates are applied in accordance with the group's update policy type.
InstanceGroupManagerNamedPort, InstanceGroupManagerNamedPortArgs          
InstanceGroupManagerParams, InstanceGroupManagerParamsArgs        
- 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. For more information, see Manage tags for resources
- 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. For more information, see Manage tags for resources
- 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. For more information, see Manage tags for resources
- {[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. For more information, see Manage tags for resources
- 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. For more information, see Manage tags for resources
- 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. For more information, see Manage tags for resources
InstanceGroupManagerStandbyPolicy, InstanceGroupManagerStandbyPolicyArgs          
- InitialDelay intSec 
- 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. Valid options are: MANUAL,SCALE_OUT_POOL. IfMANUAL(default), you have full control over which VMs are stopped and suspended in the MIG. IfSCALE_OUT_POOL, the MIG uses the VMs from the standby pools to accelerate the scale out by resuming or starting them and then automatically replenishes the standby pool with new VMs to maintain the target sizes.
- InitialDelay intSec 
- 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. Valid options are: MANUAL,SCALE_OUT_POOL. IfMANUAL(default), you have full control over which VMs are stopped and suspended in the MIG. IfSCALE_OUT_POOL, the MIG uses the VMs from the standby pools to accelerate the scale out by resuming or starting them and then automatically replenishes the standby pool with new VMs to maintain the target sizes.
- initialDelay IntegerSec 
- 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. Valid options are: MANUAL,SCALE_OUT_POOL. IfMANUAL(default), you have full control over which VMs are stopped and suspended in the MIG. IfSCALE_OUT_POOL, the MIG uses the VMs from the standby pools to accelerate the scale out by resuming or starting them and then automatically replenishes the standby pool with new VMs to maintain the target sizes.
- initialDelay numberSec 
- 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. Valid options are: MANUAL,SCALE_OUT_POOL. IfMANUAL(default), you have full control over which VMs are stopped and suspended in the MIG. IfSCALE_OUT_POOL, the MIG uses the VMs from the standby pools to accelerate the scale out by resuming or starting them and then automatically replenishes the standby pool with new VMs to maintain the target sizes.
- initial_delay_ intsec 
- 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. Valid options are: MANUAL,SCALE_OUT_POOL. IfMANUAL(default), you have full control over which VMs are stopped and suspended in the MIG. IfSCALE_OUT_POOL, the MIG uses the VMs from the standby pools to accelerate the scale out by resuming or starting them and then automatically replenishes the standby pool with new VMs to maintain the target sizes.
- initialDelay NumberSec 
- 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. Valid options are: MANUAL,SCALE_OUT_POOL. IfMANUAL(default), you have full control over which VMs are stopped and suspended in the MIG. IfSCALE_OUT_POOL, the MIG uses the VMs from the standby pools to accelerate the scale out by resuming or starting them and then automatically replenishes the standby pool with new VMs to maintain the target sizes.
InstanceGroupManagerStatefulDisk, InstanceGroupManagerStatefulDiskArgs          
- 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 NEVERandON_PERMANENT_INSTANCE_DELETION.NEVER- detach the disk when the VM is deleted, but do not delete the disk.ON_PERMANENT_INSTANCE_DELETIONwill delete the stateful disk when the VM is permanently deleted from the instance group. The default isNEVER.
- 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 NEVERandON_PERMANENT_INSTANCE_DELETION.NEVER- detach the disk when the VM is deleted, but do not delete the disk.ON_PERMANENT_INSTANCE_DELETIONwill delete the stateful disk when the VM is permanently deleted from the instance group. The default isNEVER.
- 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 NEVERandON_PERMANENT_INSTANCE_DELETION.NEVER- detach the disk when the VM is deleted, but do not delete the disk.ON_PERMANENT_INSTANCE_DELETIONwill delete the stateful disk when the VM is permanently deleted from the instance group. The default isNEVER.
- 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 NEVERandON_PERMANENT_INSTANCE_DELETION.NEVER- detach the disk when the VM is deleted, but do not delete the disk.ON_PERMANENT_INSTANCE_DELETIONwill delete the stateful disk when the VM is permanently deleted from the instance group. The default isNEVER.
- device_name str
- , 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 NEVERandON_PERMANENT_INSTANCE_DELETION.NEVER- detach the disk when the VM is deleted, but do not delete the disk.ON_PERMANENT_INSTANCE_DELETIONwill delete the stateful disk when the VM is permanently deleted from the instance group. The default isNEVER.
- 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 NEVERandON_PERMANENT_INSTANCE_DELETION.NEVER- detach the disk when the VM is deleted, but do not delete the disk.ON_PERMANENT_INSTANCE_DELETIONwill delete the stateful disk when the VM is permanently deleted from the instance group. The default isNEVER.
InstanceGroupManagerStatefulExternalIp, InstanceGroupManagerStatefulExternalIpArgs            
- DeleteRule string
- , A value that prescribes what should happen to the external ip when the VM instance is deleted. The available options are NEVERandON_PERMANENT_INSTANCE_DELETION.NEVER- detach the ip when the VM is deleted, but do not delete the ip.ON_PERMANENT_INSTANCE_DELETIONwill delete the external ip when the VM is permanently deleted from the instance group.
- InterfaceName string
- , The network interface name of the external Ip. Possible value: nic0
- DeleteRule string
- , A value that prescribes what should happen to the external ip when the VM instance is deleted. The available options are NEVERandON_PERMANENT_INSTANCE_DELETION.NEVER- detach the ip when the VM is deleted, but do not delete the ip.ON_PERMANENT_INSTANCE_DELETIONwill delete the external ip when the VM is permanently deleted from the instance group.
- InterfaceName string
- , The network interface name of the external Ip. Possible value: nic0
- deleteRule String
- , A value that prescribes what should happen to the external ip when the VM instance is deleted. The available options are NEVERandON_PERMANENT_INSTANCE_DELETION.NEVER- detach the ip when the VM is deleted, but do not delete the ip.ON_PERMANENT_INSTANCE_DELETIONwill delete the external ip when the VM is permanently deleted from the instance group.
- interfaceName String
- , The network interface name of the external Ip. Possible value: nic0
- deleteRule string
- , A value that prescribes what should happen to the external ip when the VM instance is deleted. The available options are NEVERandON_PERMANENT_INSTANCE_DELETION.NEVER- detach the ip when the VM is deleted, but do not delete the ip.ON_PERMANENT_INSTANCE_DELETIONwill delete the external ip when the VM is permanently deleted from the instance group.
- interfaceName string
- , The network interface name of the external Ip. Possible value: nic0
- delete_rule str
- , A value that prescribes what should happen to the external ip when the VM instance is deleted. The available options are NEVERandON_PERMANENT_INSTANCE_DELETION.NEVER- detach the ip when the VM is deleted, but do not delete the ip.ON_PERMANENT_INSTANCE_DELETIONwill delete the external ip when the VM is permanently deleted from the instance group.
- interface_name str
- , The network interface name of the external Ip. Possible value: nic0
- deleteRule String
- , A value that prescribes what should happen to the external ip when the VM instance is deleted. The available options are NEVERandON_PERMANENT_INSTANCE_DELETION.NEVER- detach the ip when the VM is deleted, but do not delete the ip.ON_PERMANENT_INSTANCE_DELETIONwill delete the external ip when the VM is permanently deleted from the instance group.
- interfaceName String
- , The network interface name of the external Ip. Possible value: nic0
InstanceGroupManagerStatefulInternalIp, InstanceGroupManagerStatefulInternalIpArgs            
- DeleteRule string
- , A value that prescribes what should happen to the internal ip when the VM instance is deleted. The available options are NEVERandON_PERMANENT_INSTANCE_DELETION.NEVER- detach the ip when the VM is deleted, but do not delete the ip.ON_PERMANENT_INSTANCE_DELETIONwill delete the internal ip when the VM is permanently deleted from the instance group.
- InterfaceName string
- , The network interface name of the internal Ip. Possible value: nic0
- DeleteRule string
- , A value that prescribes what should happen to the internal ip when the VM instance is deleted. The available options are NEVERandON_PERMANENT_INSTANCE_DELETION.NEVER- detach the ip when the VM is deleted, but do not delete the ip.ON_PERMANENT_INSTANCE_DELETIONwill delete the internal ip when the VM is permanently deleted from the instance group.
- InterfaceName string
- , The network interface name of the internal Ip. Possible value: nic0
- deleteRule String
- , A value that prescribes what should happen to the internal ip when the VM instance is deleted. The available options are NEVERandON_PERMANENT_INSTANCE_DELETION.NEVER- detach the ip when the VM is deleted, but do not delete the ip.ON_PERMANENT_INSTANCE_DELETIONwill delete the internal ip when the VM is permanently deleted from the instance group.
- interfaceName String
- , The network interface name of the internal Ip. Possible value: nic0
- deleteRule string
- , A value that prescribes what should happen to the internal ip when the VM instance is deleted. The available options are NEVERandON_PERMANENT_INSTANCE_DELETION.NEVER- detach the ip when the VM is deleted, but do not delete the ip.ON_PERMANENT_INSTANCE_DELETIONwill delete the internal ip when the VM is permanently deleted from the instance group.
- interfaceName string
- , The network interface name of the internal Ip. Possible value: nic0
- delete_rule str
- , A value that prescribes what should happen to the internal ip when the VM instance is deleted. The available options are NEVERandON_PERMANENT_INSTANCE_DELETION.NEVER- detach the ip when the VM is deleted, but do not delete the ip.ON_PERMANENT_INSTANCE_DELETIONwill delete the internal ip when the VM is permanently deleted from the instance group.
- interface_name str
- , The network interface name of the internal Ip. Possible value: nic0
- deleteRule String
- , A value that prescribes what should happen to the internal ip when the VM instance is deleted. The available options are NEVERandON_PERMANENT_INSTANCE_DELETION.NEVER- detach the ip when the VM is deleted, but do not delete the ip.ON_PERMANENT_INSTANCE_DELETIONwill delete the internal ip when the VM is permanently deleted from the instance group.
- interfaceName String
- , The network interface name of the internal Ip. Possible value: nic0
InstanceGroupManagerStatus, InstanceGroupManagerStatusArgs        
- AllInstances List<InstanceConfigs Group Manager Status All Instances Config> 
- Properties to set on all instances in the group. After setting allInstancesConfig on the group, you must update the group's instances to apply the configuration.
- 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<InstanceGroup Manager Status Stateful> 
- Stateful status of the given Instance Group Manager.
- VersionTargets List<InstanceGroup Manager Status Version Target> 
- 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.
- AllInstances []InstanceConfigs Group Manager Status All Instances Config 
- Properties to set on all instances in the group. After setting allInstancesConfig on the group, you must update the group's instances to apply the configuration.
- 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
[]InstanceGroup Manager Status Stateful 
- Stateful status of the given Instance Group Manager.
- VersionTargets []InstanceGroup Manager Status Version Target 
- 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.
- allInstances List<InstanceConfigs Group Manager Status All Instances Config> 
- Properties to set on all instances in the group. After setting allInstancesConfig on the group, you must update the group's instances to apply the configuration.
- 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<InstanceGroup Manager Status Stateful> 
- Stateful status of the given Instance Group Manager.
- versionTargets List<InstanceGroup Manager Status Version Target> 
- 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.
- allInstances InstanceConfigs Group Manager Status All Instances Config[] 
- Properties to set on all instances in the group. After setting allInstancesConfig on the group, you must update the group's instances to apply the configuration.
- 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
InstanceGroup Manager Status Stateful[] 
- Stateful status of the given Instance Group Manager.
- versionTargets InstanceGroup Manager Status Version Target[] 
- 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.
- all_instances_ Sequence[Instanceconfigs Group Manager Status All Instances Config] 
- Properties to set on all instances in the group. After setting allInstancesConfig on the group, you must update the group's instances to apply the configuration.
- 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[InstanceGroup Manager Status Stateful] 
- Stateful status of the given Instance Group Manager.
- version_targets Sequence[InstanceGroup Manager Status Version Target] 
- 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.
- allInstances List<Property Map>Configs 
- Properties to set on all instances in the group. After setting allInstancesConfig on the group, you must update the group's instances to apply the configuration.
- 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 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.
InstanceGroupManagerStatusAllInstancesConfig, InstanceGroupManagerStatusAllInstancesConfigArgs              
- 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.
InstanceGroupManagerStatusStateful, InstanceGroupManagerStatusStatefulArgs          
- HasStateful boolConfig 
- 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.
- PerInstance List<InstanceConfigs Group Manager Status Stateful Per Instance Config> 
- Status of per-instance configs on the instances.
- HasStateful boolConfig 
- 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.
- PerInstance []InstanceConfigs Group Manager Status Stateful Per Instance Config 
- Status of per-instance configs on the instances.
- hasStateful BooleanConfig 
- 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.
- perInstance List<InstanceConfigs Group Manager Status Stateful Per Instance Config> 
- Status of per-instance configs on the instances.
- hasStateful booleanConfig 
- 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.
- perInstance InstanceConfigs Group Manager Status Stateful Per Instance Config[] 
- Status of per-instance configs on the instances.
- has_stateful_ boolconfig 
- 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_ Sequence[Instanceconfigs Group Manager Status Stateful Per Instance Config] 
- Status of per-instance configs on the instances.
- hasStateful BooleanConfig 
- 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.
- perInstance List<Property Map>Configs 
- Status of per-instance configs on the instances.
InstanceGroupManagerStatusStatefulPerInstanceConfig, InstanceGroupManagerStatusStatefulPerInstanceConfigArgs                
- 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 EFFECTIVEor 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 EFFECTIVEor 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 EFFECTIVEor 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 EFFECTIVEor 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 EFFECTIVEor 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 EFFECTIVEor there are no per-instance-configs.
InstanceGroupManagerStatusVersionTarget, InstanceGroupManagerStatusVersionTargetArgs            
- 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.
InstanceGroupManagerUpdatePolicy, InstanceGroupManagerUpdatePolicyArgs          
- MinimalAction string
- Minimal action to be taken on an instance. You can specify either NONEto forbid any actions,REFRESHto update without stopping instances,RESTARTto restart existing instances orREPLACEto delete and create new instances from the target template. If you specify aREFRESH, the Updater will attempt to perform that action only. However, if the Updater determines that the minimal action you specify is not enough to perform the update, it might perform a more disruptive action.
- Type string
- The type of update process. You can specify either PROACTIVEso that the instance group manager proactively executes actions in order to bring instances to their target versions orOPPORTUNISTICso that no action is proactively executed but the update will be performed as part of other actions (for example, resizes or recreateInstances calls).
- MaxSurge intFixed 
- , Specifies a fixed number of VM instances. This must be a positive integer. Conflicts with max_surge_percent. Both cannot be 0.
- MaxSurge intPercent 
- , Specifies a percentage of instances between 0 to 100%, inclusive. For example, specify 80 for 80%. Conflicts with max_surge_fixed.
- int
- , Specifies a fixed number of VM instances. This must be a positive integer.
- int
- , Specifies a percentage of instances between 0 to 100%, inclusive. For example, specify 80 for 80%..
- MinReady intSec 
- , Minimum number of seconds to wait for after a newly created instance becomes available. This value must be from range [0, 3600]
- MostDisruptive stringAllowed Action 
- 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.
- MinimalAction string
- Minimal action to be taken on an instance. You can specify either NONEto forbid any actions,REFRESHto update without stopping instances,RESTARTto restart existing instances orREPLACEto delete and create new instances from the target template. If you specify aREFRESH, the Updater will attempt to perform that action only. However, if the Updater determines that the minimal action you specify is not enough to perform the update, it might perform a more disruptive action.
- Type string
- The type of update process. You can specify either PROACTIVEso that the instance group manager proactively executes actions in order to bring instances to their target versions orOPPORTUNISTICso that no action is proactively executed but the update will be performed as part of other actions (for example, resizes or recreateInstances calls).
- MaxSurge intFixed 
- , Specifies a fixed number of VM instances. This must be a positive integer. Conflicts with max_surge_percent. Both cannot be 0.
- MaxSurge intPercent 
- , Specifies a percentage of instances between 0 to 100%, inclusive. For example, specify 80 for 80%. Conflicts with max_surge_fixed.
- int
- , Specifies a fixed number of VM instances. This must be a positive integer.
- int
- , Specifies a percentage of instances between 0 to 100%, inclusive. For example, specify 80 for 80%..
- MinReady intSec 
- , Minimum number of seconds to wait for after a newly created instance becomes available. This value must be from range [0, 3600]
- MostDisruptive stringAllowed Action 
- 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.
- minimalAction String
- Minimal action to be taken on an instance. You can specify either NONEto forbid any actions,REFRESHto update without stopping instances,RESTARTto restart existing instances orREPLACEto delete and create new instances from the target template. If you specify aREFRESH, the Updater will attempt to perform that action only. However, if the Updater determines that the minimal action you specify is not enough to perform the update, it might perform a more disruptive action.
- type String
- The type of update process. You can specify either PROACTIVEso that the instance group manager proactively executes actions in order to bring instances to their target versions orOPPORTUNISTICso that no action is proactively executed but the update will be performed as part of other actions (for example, resizes or recreateInstances calls).
- maxSurge IntegerFixed 
- , Specifies a fixed number of VM instances. This must be a positive integer. Conflicts with max_surge_percent. Both cannot be 0.
- maxSurge IntegerPercent 
- , Specifies a percentage of instances between 0 to 100%, inclusive. For example, specify 80 for 80%. Conflicts with max_surge_fixed.
- Integer
- , Specifies a fixed number of VM instances. This must be a positive integer.
- Integer
- , Specifies a percentage of instances between 0 to 100%, inclusive. For example, specify 80 for 80%..
- minReady IntegerSec 
- , Minimum number of seconds to wait for after a newly created instance becomes available. This value must be from range [0, 3600]
- mostDisruptive StringAllowed Action 
- 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.
- minimalAction string
- Minimal action to be taken on an instance. You can specify either NONEto forbid any actions,REFRESHto update without stopping instances,RESTARTto restart existing instances orREPLACEto delete and create new instances from the target template. If you specify aREFRESH, the Updater will attempt to perform that action only. However, if the Updater determines that the minimal action you specify is not enough to perform the update, it might perform a more disruptive action.
- type string
- The type of update process. You can specify either PROACTIVEso that the instance group manager proactively executes actions in order to bring instances to their target versions orOPPORTUNISTICso that no action is proactively executed but the update will be performed as part of other actions (for example, resizes or recreateInstances calls).
- maxSurge numberFixed 
- , Specifies a fixed number of VM instances. This must be a positive integer. Conflicts with max_surge_percent. Both cannot be 0.
- maxSurge numberPercent 
- , Specifies a percentage of instances between 0 to 100%, inclusive. For example, specify 80 for 80%. Conflicts with max_surge_fixed.
- number
- , Specifies a fixed number of VM instances. This must be a positive integer.
- number
- , Specifies a percentage of instances between 0 to 100%, inclusive. For example, specify 80 for 80%..
- minReady numberSec 
- , Minimum number of seconds to wait for after a newly created instance becomes available. This value must be from range [0, 3600]
- mostDisruptive stringAllowed Action 
- 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.
- minimal_action str
- Minimal action to be taken on an instance. You can specify either NONEto forbid any actions,REFRESHto update without stopping instances,RESTARTto restart existing instances orREPLACEto delete and create new instances from the target template. If you specify aREFRESH, the Updater will attempt to perform that action only. However, if the Updater determines that the minimal action you specify is not enough to perform the update, it might perform a more disruptive action.
- type str
- The type of update process. You can specify either PROACTIVEso that the instance group manager proactively executes actions in order to bring instances to their target versions orOPPORTUNISTICso 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_ intfixed 
- , Specifies a fixed number of VM instances. This must be a positive integer. Conflicts with max_surge_percent. Both cannot be 0.
- max_surge_ intpercent 
- , Specifies a percentage of instances between 0 to 100%, inclusive. For example, specify 80 for 80%. Conflicts with max_surge_fixed.
- int
- , Specifies a fixed number of VM instances. This must be a positive integer.
- int
- , Specifies a percentage of instances between 0 to 100%, inclusive. For example, specify 80 for 80%..
- min_ready_ intsec 
- , Minimum number of seconds to wait for after a newly created instance becomes available. This value must be from range [0, 3600]
- most_disruptive_ strallowed_ action 
- 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.
- minimalAction String
- Minimal action to be taken on an instance. You can specify either NONEto forbid any actions,REFRESHto update without stopping instances,RESTARTto restart existing instances orREPLACEto delete and create new instances from the target template. If you specify aREFRESH, the Updater will attempt to perform that action only. However, if the Updater determines that the minimal action you specify is not enough to perform the update, it might perform a more disruptive action.
- type String
- The type of update process. You can specify either PROACTIVEso that the instance group manager proactively executes actions in order to bring instances to their target versions orOPPORTUNISTICso that no action is proactively executed but the update will be performed as part of other actions (for example, resizes or recreateInstances calls).
- maxSurge NumberFixed 
- , Specifies a fixed number of VM instances. This must be a positive integer. Conflicts with max_surge_percent. Both cannot be 0.
- maxSurge NumberPercent 
- , Specifies a percentage of instances between 0 to 100%, inclusive. For example, specify 80 for 80%. Conflicts with max_surge_fixed.
- Number
- , Specifies a fixed number of VM instances. This must be a positive integer.
- Number
- , Specifies a percentage of instances between 0 to 100%, inclusive. For example, specify 80 for 80%..
- minReady NumberSec 
- , Minimum number of seconds to wait for after a newly created instance becomes available. This value must be from range [0, 3600]
- mostDisruptive StringAllowed Action 
- 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.
InstanceGroupManagerVersion, InstanceGroupManagerVersionArgs        
- InstanceTemplate string
- The full URL to an instance template from which all new instances of this version will be created. It is recommended to reference instance templates through their unique id (self_link_uniqueattribute).
- Name string
- Version name.
- TargetSize InstanceGroup Manager Version Target Size 
- The number of instances calculated as a fixed number or a percentage depending on the settings. Structure is documented below. - Exactly one - versionyou specify must not have a- target_sizespecified. During a rolling update, the instance group manager will fulfill the- target_sizeconstraints of every other- version, and any remaining instances will be provisioned with the version where- target_sizeis unset.
- InstanceTemplate string
- The full URL to an instance template from which all new instances of this version will be created. It is recommended to reference instance templates through their unique id (self_link_uniqueattribute).
- Name string
- Version name.
- TargetSize InstanceGroup Manager Version Target Size 
- The number of instances calculated as a fixed number or a percentage depending on the settings. Structure is documented below. - Exactly one - versionyou specify must not have a- target_sizespecified. During a rolling update, the instance group manager will fulfill the- target_sizeconstraints of every other- version, and any remaining instances will be provisioned with the version where- target_sizeis unset.
- instanceTemplate String
- The full URL to an instance template from which all new instances of this version will be created. It is recommended to reference instance templates through their unique id (self_link_uniqueattribute).
- name String
- Version name.
- targetSize InstanceGroup Manager Version Target Size 
- The number of instances calculated as a fixed number or a percentage depending on the settings. Structure is documented below. - Exactly one - versionyou specify must not have a- target_sizespecified. During a rolling update, the instance group manager will fulfill the- target_sizeconstraints of every other- version, and any remaining instances will be provisioned with the version where- target_sizeis unset.
- instanceTemplate string
- The full URL to an instance template from which all new instances of this version will be created. It is recommended to reference instance templates through their unique id (self_link_uniqueattribute).
- name string
- Version name.
- targetSize InstanceGroup Manager Version Target Size 
- The number of instances calculated as a fixed number or a percentage depending on the settings. Structure is documented below. - Exactly one - versionyou specify must not have a- target_sizespecified. During a rolling update, the instance group manager will fulfill the- target_sizeconstraints of every other- version, and any remaining instances will be provisioned with the version where- target_sizeis unset.
- instance_template str
- The full URL to an instance template from which all new instances of this version will be created. It is recommended to reference instance templates through their unique id (self_link_uniqueattribute).
- name str
- Version name.
- target_size InstanceGroup Manager Version Target Size 
- The number of instances calculated as a fixed number or a percentage depending on the settings. Structure is documented below. - Exactly one - versionyou specify must not have a- target_sizespecified. During a rolling update, the instance group manager will fulfill the- target_sizeconstraints of every other- version, and any remaining instances will be provisioned with the version where- target_sizeis unset.
- instanceTemplate String
- The full URL to an instance template from which all new instances of this version will be created. It is recommended to reference instance templates through their unique id (self_link_uniqueattribute).
- name String
- Version name.
- targetSize Property Map
- The number of instances calculated as a fixed number or a percentage depending on the settings. Structure is documented below. - Exactly one - versionyou specify must not have a- target_sizespecified. During a rolling update, the instance group manager will fulfill the- target_sizeconstraints of every other- version, and any remaining instances will be provisioned with the version where- target_sizeis unset.
InstanceGroupManagerVersionTargetSize, InstanceGroupManagerVersionTargetSizeArgs            
- 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 usingpercent, rounding will be in favor of explicitly settarget_sizevalues; a managed instance group with 2 instances and 2versions, one of which has atarget_size.percentof60will create 2 instances of thatversion.
- 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 usingpercent, rounding will be in favor of explicitly settarget_sizevalues; a managed instance group with 2 instances and 2versions, one of which has atarget_size.percentof60will create 2 instances of thatversion.
- 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 usingpercent, rounding will be in favor of explicitly settarget_sizevalues; a managed instance group with 2 instances and 2versions, one of which has atarget_size.percentof60will create 2 instances of thatversion.
- 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 usingpercent, rounding will be in favor of explicitly settarget_sizevalues; a managed instance group with 2 instances and 2versions, one of which has atarget_size.percentof60will create 2 instances of thatversion.
- 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 usingpercent, rounding will be in favor of explicitly settarget_sizevalues; a managed instance group with 2 instances and 2versions, one of which has atarget_size.percentof60will create 2 instances of thatversion.
- 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 usingpercent, rounding will be in favor of explicitly settarget_sizevalues; a managed instance group with 2 instances and 2versions, one of which has atarget_size.percentof60will create 2 instances of thatversion.
Import
Instance group managers can be imported using any of these accepted formats:
- projects/{{project}}/zones/{{zone}}/instanceGroupManagers/{{name}}
- {{project}}/{{zone}}/{{name}}
- {{project}}/{{name}}
- {{name}}
When using the pulumi import command, instance group managers can be imported using one of the formats above. For example:
$ pulumi import gcp:compute/instanceGroupManager:InstanceGroupManager default projects/{{project}}/zones/{{zone}}/instanceGroupManagers/{{name}}
$ pulumi import gcp:compute/instanceGroupManager:InstanceGroupManager default {{project}}/{{zone}}/{{name}}
$ pulumi import gcp:compute/instanceGroupManager:InstanceGroupManager default {{project}}/{{name}}
$ pulumi import gcp:compute/instanceGroupManager:InstanceGroupManager default {{name}}
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Google Cloud (GCP) Classic pulumi/pulumi-gcp
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the google-betaTerraform Provider.