Google Cloud Classic v8.9.3 published on Monday, Nov 18, 2024 by Pulumi
gcp.compute.getRegionInstanceGroupManager
Explore with Pulumi AI
Get a Compute Region Instance Group Manager within GCE. For more information, see the official documentation and API
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const rigm = gcp.compute.getRegionInstanceGroupManager({
name: "my-igm",
region: "us-central1",
});
import pulumi
import pulumi_gcp as gcp
rigm = gcp.compute.get_region_instance_group_manager(name="my-igm",
region="us-central1")
package main
import (
"github.com/pulumi/pulumi-gcp/sdk/v8/go/gcp/compute"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := compute.LookupRegionInstanceGroupManager(ctx, &compute.LookupRegionInstanceGroupManagerArgs{
Name: pulumi.StringRef("my-igm"),
Region: pulumi.StringRef("us-central1"),
}, nil)
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() =>
{
var rigm = Gcp.Compute.GetRegionInstanceGroupManager.Invoke(new()
{
Name = "my-igm",
Region = "us-central1",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.compute.ComputeFunctions;
import com.pulumi.gcp.compute.inputs.GetRegionInstanceGroupManagerArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
final var rigm = ComputeFunctions.getRegionInstanceGroupManager(GetRegionInstanceGroupManagerArgs.builder()
.name("my-igm")
.region("us-central1")
.build());
}
}
variables:
rigm:
fn::invoke:
Function: gcp:compute:getRegionInstanceGroupManager
Arguments:
name: my-igm
region: us-central1
Using getRegionInstanceGroupManager
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getRegionInstanceGroupManager(args: GetRegionInstanceGroupManagerArgs, opts?: InvokeOptions): Promise<GetRegionInstanceGroupManagerResult>
function getRegionInstanceGroupManagerOutput(args: GetRegionInstanceGroupManagerOutputArgs, opts?: InvokeOptions): Output<GetRegionInstanceGroupManagerResult>
def get_region_instance_group_manager(name: Optional[str] = None,
project: Optional[str] = None,
region: Optional[str] = None,
self_link: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetRegionInstanceGroupManagerResult
def get_region_instance_group_manager_output(name: Optional[pulumi.Input[str]] = None,
project: Optional[pulumi.Input[str]] = None,
region: Optional[pulumi.Input[str]] = None,
self_link: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetRegionInstanceGroupManagerResult]
func LookupRegionInstanceGroupManager(ctx *Context, args *LookupRegionInstanceGroupManagerArgs, opts ...InvokeOption) (*LookupRegionInstanceGroupManagerResult, error)
func LookupRegionInstanceGroupManagerOutput(ctx *Context, args *LookupRegionInstanceGroupManagerOutputArgs, opts ...InvokeOption) LookupRegionInstanceGroupManagerResultOutput
> Note: This function is named LookupRegionInstanceGroupManager
in the Go SDK.
public static class GetRegionInstanceGroupManager
{
public static Task<GetRegionInstanceGroupManagerResult> InvokeAsync(GetRegionInstanceGroupManagerArgs args, InvokeOptions? opts = null)
public static Output<GetRegionInstanceGroupManagerResult> Invoke(GetRegionInstanceGroupManagerInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetRegionInstanceGroupManagerResult> getRegionInstanceGroupManager(GetRegionInstanceGroupManagerArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
function: gcp:compute/getRegionInstanceGroupManager:getRegionInstanceGroupManager
arguments:
# arguments dictionary
The following arguments are supported:
- Name string
- The name of the instance group. Either
name
orself_link
must be provided. - Project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
Region
- (Optional) The region where the managed instance group resides. If not provided, the provider region is used.
- Region string
- Self
Link string - The self link of the instance group. Either
name
orself_link
must be provided.
- Name string
- The name of the instance group. Either
name
orself_link
must be provided. - Project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
Region
- (Optional) The region where the managed instance group resides. If not provided, the provider region is used.
- Region string
- Self
Link string - The self link of the instance group. Either
name
orself_link
must be provided.
- name String
- The name of the instance group. Either
name
orself_link
must be provided. - project String
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
Region
- (Optional) The region where the managed instance group resides. If not provided, the provider region is used.
- region String
- self
Link String - The self link of the instance group. Either
name
orself_link
must be provided.
- name string
- The name of the instance group. Either
name
orself_link
must be provided. - project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
Region
- (Optional) The region where the managed instance group resides. If not provided, the provider region is used.
- region string
- self
Link string - The self link of the instance group. Either
name
orself_link
must be provided.
- name str
- The name of the instance group. Either
name
orself_link
must be provided. - project str
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
Region
- (Optional) The region where the managed instance group resides. If not provided, the provider region is used.
- region str
- self_
link str - The self link of the instance group. Either
name
orself_link
must be provided.
- name String
- The name of the instance group. Either
name
orself_link
must be provided. - project String
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
Region
- (Optional) The region where the managed instance group resides. If not provided, the provider region is used.
- region String
- self
Link String - The self link of the instance group. Either
name
orself_link
must be provided.
getRegionInstanceGroupManager Result
The following output properties are available:
- All
Instances List<GetConfigs Region Instance Group Manager All Instances Config> - Auto
Healing List<GetPolicies Region Instance Group Manager Auto Healing Policy> - Base
Instance stringName - Creation
Timestamp string - Description string
- Distribution
Policy stringTarget Shape - Distribution
Policy List<string>Zones - Fingerprint string
- Id string
- The provider-assigned unique ID for this managed resource.
- Instance
Flexibility List<GetPolicies Region Instance Group Manager Instance Flexibility Policy> - Instance
Group string - Instance
Lifecycle List<GetPolicies Region Instance Group Manager Instance Lifecycle Policy> - List
Managed stringInstances Results - Named
Ports List<GetRegion Instance Group Manager Named Port> - Params
List<Get
Region Instance Group Manager Param> - Standby
Policies List<GetRegion Instance Group Manager Standby Policy> - Stateful
Disks List<GetRegion Instance Group Manager Stateful Disk> - Stateful
External List<GetIps Region Instance Group Manager Stateful External Ip> - Stateful
Internal List<GetIps Region Instance Group Manager Stateful Internal Ip> - Statuses
List<Get
Region Instance Group Manager Status> - Target
Pools List<string> - Target
Size int - Target
Stopped intSize - Target
Suspended intSize - Update
Policies List<GetRegion Instance Group Manager Update Policy> - Versions
List<Get
Region Instance Group Manager Version> - Wait
For boolInstances - Wait
For stringInstances Status - Name string
- Project string
- Region string
- Self
Link string
- All
Instances []GetConfigs Region Instance Group Manager All Instances Config - Auto
Healing []GetPolicies Region Instance Group Manager Auto Healing Policy - Base
Instance stringName - Creation
Timestamp string - Description string
- Distribution
Policy stringTarget Shape - Distribution
Policy []stringZones - Fingerprint string
- Id string
- The provider-assigned unique ID for this managed resource.
- Instance
Flexibility []GetPolicies Region Instance Group Manager Instance Flexibility Policy - Instance
Group string - Instance
Lifecycle []GetPolicies Region Instance Group Manager Instance Lifecycle Policy - List
Managed stringInstances Results - Named
Ports []GetRegion Instance Group Manager Named Port - Params
[]Get
Region Instance Group Manager Param - Standby
Policies []GetRegion Instance Group Manager Standby Policy - Stateful
Disks []GetRegion Instance Group Manager Stateful Disk - Stateful
External []GetIps Region Instance Group Manager Stateful External Ip - Stateful
Internal []GetIps Region Instance Group Manager Stateful Internal Ip - Statuses
[]Get
Region Instance Group Manager Status - Target
Pools []string - Target
Size int - Target
Stopped intSize - Target
Suspended intSize - Update
Policies []GetRegion Instance Group Manager Update Policy - Versions
[]Get
Region Instance Group Manager Version - Wait
For boolInstances - Wait
For stringInstances Status - Name string
- Project string
- Region string
- Self
Link string
- all
Instances List<GetConfigs Region Instance Group Manager All Instances Config> - auto
Healing List<GetPolicies Region Instance Group Manager Auto Healing Policy> - base
Instance StringName - creation
Timestamp String - description String
- distribution
Policy StringTarget Shape - distribution
Policy List<String>Zones - fingerprint String
- id String
- The provider-assigned unique ID for this managed resource.
- instance
Flexibility List<GetPolicies Region Instance Group Manager Instance Flexibility Policy> - instance
Group String - instance
Lifecycle List<GetPolicies Region Instance Group Manager Instance Lifecycle Policy> - list
Managed StringInstances Results - named
Ports List<GetRegion Instance Group Manager Named Port> - params
List<Get
Region Instance Group Manager Param> - standby
Policies List<GetRegion Instance Group Manager Standby Policy> - stateful
Disks List<GetRegion Instance Group Manager Stateful Disk> - stateful
External List<GetIps Region Instance Group Manager Stateful External Ip> - stateful
Internal List<GetIps Region Instance Group Manager Stateful Internal Ip> - statuses
List<Get
Region Instance Group Manager Status> - target
Pools List<String> - target
Size Integer - target
Stopped IntegerSize - target
Suspended IntegerSize - update
Policies List<GetRegion Instance Group Manager Update Policy> - versions
List<Get
Region Instance Group Manager Version> - wait
For BooleanInstances - wait
For StringInstances Status - name String
- project String
- region String
- self
Link String
- all
Instances GetConfigs Region Instance Group Manager All Instances Config[] - auto
Healing GetPolicies Region Instance Group Manager Auto Healing Policy[] - base
Instance stringName - creation
Timestamp string - description string
- distribution
Policy stringTarget Shape - distribution
Policy string[]Zones - fingerprint string
- id string
- The provider-assigned unique ID for this managed resource.
- instance
Flexibility GetPolicies Region Instance Group Manager Instance Flexibility Policy[] - instance
Group string - instance
Lifecycle GetPolicies Region Instance Group Manager Instance Lifecycle Policy[] - list
Managed stringInstances Results - named
Ports GetRegion Instance Group Manager Named Port[] - params
Get
Region Instance Group Manager Param[] - standby
Policies GetRegion Instance Group Manager Standby Policy[] - stateful
Disks GetRegion Instance Group Manager Stateful Disk[] - stateful
External GetIps Region Instance Group Manager Stateful External Ip[] - stateful
Internal GetIps Region Instance Group Manager Stateful Internal Ip[] - statuses
Get
Region Instance Group Manager Status[] - target
Pools string[] - target
Size number - target
Stopped numberSize - target
Suspended numberSize - update
Policies GetRegion Instance Group Manager Update Policy[] - versions
Get
Region Instance Group Manager Version[] - wait
For booleanInstances - wait
For stringInstances Status - name string
- project string
- region string
- self
Link string
- all_
instances_ Sequence[Getconfigs Region Instance Group Manager All Instances Config] - auto_
healing_ Sequence[Getpolicies Region Instance Group Manager Auto Healing Policy] - base_
instance_ strname - creation_
timestamp str - description str
- distribution_
policy_ strtarget_ shape - distribution_
policy_ Sequence[str]zones - fingerprint str
- id str
- The provider-assigned unique ID for this managed resource.
- instance_
flexibility_ Sequence[Getpolicies Region Instance Group Manager Instance Flexibility Policy] - instance_
group str - instance_
lifecycle_ Sequence[Getpolicies Region Instance Group Manager Instance Lifecycle Policy] - list_
managed_ strinstances_ results - named_
ports Sequence[GetRegion Instance Group Manager Named Port] - params
Sequence[Get
Region Instance Group Manager Param] - standby_
policies Sequence[GetRegion Instance Group Manager Standby Policy] - stateful_
disks Sequence[GetRegion Instance Group Manager Stateful Disk] - stateful_
external_ Sequence[Getips Region Instance Group Manager Stateful External Ip] - stateful_
internal_ Sequence[Getips Region Instance Group Manager Stateful Internal Ip] - statuses
Sequence[Get
Region Instance Group Manager Status] - target_
pools Sequence[str] - target_
size int - target_
stopped_ intsize - target_
suspended_ intsize - update_
policies Sequence[GetRegion Instance Group Manager Update Policy] - versions
Sequence[Get
Region Instance Group Manager Version] - wait_
for_ boolinstances - wait_
for_ strinstances_ status - name str
- project str
- region str
- self_
link str
- all
Instances List<Property Map>Configs - auto
Healing List<Property Map>Policies - base
Instance StringName - creation
Timestamp String - description String
- distribution
Policy StringTarget Shape - distribution
Policy List<String>Zones - fingerprint String
- id String
- The provider-assigned unique ID for this managed resource.
- instance
Flexibility List<Property Map>Policies - instance
Group String - instance
Lifecycle List<Property Map>Policies - list
Managed StringInstances Results - named
Ports List<Property Map> - params List<Property Map>
- standby
Policies List<Property Map> - stateful
Disks List<Property Map> - stateful
External List<Property Map>Ips - stateful
Internal List<Property Map>Ips - statuses List<Property Map>
- target
Pools List<String> - target
Size Number - target
Stopped NumberSize - target
Suspended NumberSize - update
Policies List<Property Map> - versions List<Property Map>
- wait
For BooleanInstances - wait
For StringInstances Status - name String
- project String
- region String
- self
Link String
Supporting Types
GetRegionInstanceGroupManagerAllInstancesConfig
GetRegionInstanceGroupManagerAutoHealingPolicy
- Health
Check string - 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.
- Health
Check string - 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.
- health
Check String - The health check resource that signals autohealing.
- initial
Delay 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.
- health
Check string - The health check resource that signals autohealing.
- initial
Delay 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.
- health
Check String - The health check resource that signals autohealing.
- initial
Delay 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.
GetRegionInstanceGroupManagerInstanceFlexibilityPolicy
- Instance
Selections List<GetRegion Instance Group Manager Instance Flexibility Policy Instance Selection> - Named instance selections configuring properties that the group will use when creating new VMs.
- Instance
Selections []GetRegion Instance Group Manager Instance Flexibility Policy Instance Selection - Named instance selections configuring properties that the group will use when creating new VMs.
- instance
Selections List<GetRegion Instance Group Manager Instance Flexibility Policy Instance Selection> - Named instance selections configuring properties that the group will use when creating new VMs.
- instance
Selections GetRegion Instance Group Manager Instance Flexibility Policy Instance Selection[] - Named instance selections configuring properties that the group will use when creating new VMs.
- instance_
selections Sequence[GetRegion Instance Group Manager Instance Flexibility Policy Instance Selection] - Named instance selections configuring properties that the group will use when creating new VMs.
- instance
Selections List<Property Map> - Named instance selections configuring properties that the group will use when creating new VMs.
GetRegionInstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection
- Machine
Types List<string> - Full machine-type names, e.g. "n1-standard-16"
- Name string
- The name of the instance group. Either
name
orself_link
must be provided. - Rank int
- Preference of this instance selection. Lower number means higher preference. MIG will first try to create a VM based on the machine-type with lowest rank and fallback to next rank based on availability. Machine types and instance selections with the same rank have the same preference.
- Machine
Types []string - Full machine-type names, e.g. "n1-standard-16"
- Name string
- The name of the instance group. Either
name
orself_link
must be provided. - Rank int
- Preference of this instance selection. Lower number means higher preference. MIG will first try to create a VM based on the machine-type with lowest rank and fallback to next rank based on availability. Machine types and instance selections with the same rank have the same preference.
- machine
Types List<String> - Full machine-type names, e.g. "n1-standard-16"
- name String
- The name of the instance group. Either
name
orself_link
must be provided. - rank Integer
- Preference of this instance selection. Lower number means higher preference. MIG will first try to create a VM based on the machine-type with lowest rank and fallback to next rank based on availability. Machine types and instance selections with the same rank have the same preference.
- machine
Types string[] - Full machine-type names, e.g. "n1-standard-16"
- name string
- The name of the instance group. Either
name
orself_link
must be provided. - rank number
- Preference of this instance selection. Lower number means higher preference. MIG will first try to create a VM based on the machine-type with lowest rank and fallback to next rank based on availability. Machine types and instance selections with the same rank have the same preference.
- machine_
types Sequence[str] - Full machine-type names, e.g. "n1-standard-16"
- name str
- The name of the instance group. Either
name
orself_link
must be provided. - rank int
- Preference of this instance selection. Lower number means higher preference. MIG will first try to create a VM based on the machine-type with lowest rank and fallback to next rank based on availability. Machine types and instance selections with the same rank have the same preference.
- machine
Types List<String> - Full machine-type names, e.g. "n1-standard-16"
- name String
- The name of the instance group. Either
name
orself_link
must be provided. - rank Number
- Preference of this instance selection. Lower number means higher preference. MIG will first try to create a VM based on the machine-type with lowest rank and fallback to next rank based on availability. Machine types and instance selections with the same rank have the same preference.
GetRegionInstanceGroupManagerInstanceLifecyclePolicy
- Default
Action stringOn Failure - Default behavior for all instance or health check failures.
- Force
Update stringOn Repair - Specifies whether to apply the group's latest configuration when repairing a VM. Valid options are: YES, NO. If YES and you updated the group's instance template or per-instance configurations after the VM was created, then these changes are applied when VM is repaired. If NO (default), then updates are applied in accordance with the group's update policy type.
- Default
Action stringOn Failure - Default behavior for all instance or health check failures.
- Force
Update stringOn Repair - Specifies whether to apply the group's latest configuration when repairing a VM. Valid options are: YES, NO. If YES and you updated the group's instance template or per-instance configurations after the VM was created, then these changes are applied when VM is repaired. If NO (default), then updates are applied in accordance with the group's update policy type.
- default
Action StringOn Failure - Default behavior for all instance or health check failures.
- force
Update StringOn Repair - Specifies whether to apply the group's latest configuration when repairing a VM. Valid options are: YES, NO. If YES and you updated the group's instance template or per-instance configurations after the VM was created, then these changes are applied when VM is repaired. If NO (default), then updates are applied in accordance with the group's update policy type.
- default
Action stringOn Failure - Default behavior for all instance or health check failures.
- force
Update stringOn Repair - Specifies whether to apply the group's latest configuration when repairing a VM. Valid options are: YES, NO. If YES and you updated the group's instance template or per-instance configurations after the VM was created, then these changes are applied when VM is repaired. If NO (default), then updates are applied in accordance with the group's update policy type.
- default_
action_ stron_ failure - Default behavior for all instance or health check failures.
- force_
update_ stron_ repair - Specifies whether to apply the group's latest configuration when repairing a VM. Valid options are: YES, NO. If YES and you updated the group's instance template or per-instance configurations after the VM was created, then these changes are applied when VM is repaired. If NO (default), then updates are applied in accordance with the group's update policy type.
- default
Action StringOn Failure - Default behavior for all instance or health check failures.
- force
Update StringOn Repair - Specifies whether to apply the group's latest configuration when repairing a VM. Valid options are: YES, NO. If YES and you updated the group's instance template or per-instance configurations after the VM was created, then these changes are applied when VM is repaired. If NO (default), then updates are applied in accordance with the group's update policy type.
GetRegionInstanceGroupManagerNamedPort
GetRegionInstanceGroupManagerParam
- 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.
- 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.
- 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.
- {[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.
- 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.
- Map<String>
- Resource manager tags to bind to the managed instance group. The tags are key-value pairs. Keys must be in the format tagKeys/123 and values in the format tagValues/456.
GetRegionInstanceGroupManagerStandbyPolicy
- 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 string
- Defines how a MIG resumes or starts VMs from a standby pool when the group scales out. The default mode is "MANUAL".
- Initial
Delay 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. The default mode is "MANUAL".
- initial
Delay 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. The default mode is "MANUAL".
- initial
Delay 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. The default mode is "MANUAL".
- 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. The default mode is "MANUAL".
- initial
Delay 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. The default mode is "MANUAL".
GetRegionInstanceGroupManagerStatefulDisk
- Delete
Rule string - A value that prescribes what should happen to the stateful disk when the VM instance is deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER - detach the disk when the VM is deleted, but do not delete the disk. ON_PERMANENT_INSTANCE_DELETION will delete the stateful disk when the VM is permanently deleted from the instance group. The default is NEVER.
- Device
Name string - The device name of the disk to be attached.
- Delete
Rule string - A value that prescribes what should happen to the stateful disk when the VM instance is deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER - detach the disk when the VM is deleted, but do not delete the disk. ON_PERMANENT_INSTANCE_DELETION will delete the stateful disk when the VM is permanently deleted from the instance group. The default is NEVER.
- Device
Name string - The device name of the disk to be attached.
- delete
Rule String - A value that prescribes what should happen to the stateful disk when the VM instance is deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER - detach the disk when the VM is deleted, but do not delete the disk. ON_PERMANENT_INSTANCE_DELETION will delete the stateful disk when the VM is permanently deleted from the instance group. The default is NEVER.
- device
Name String - The device name of the disk to be attached.
- delete
Rule string - A value that prescribes what should happen to the stateful disk when the VM instance is deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER - detach the disk when the VM is deleted, but do not delete the disk. ON_PERMANENT_INSTANCE_DELETION will delete the stateful disk when the VM is permanently deleted from the instance group. The default is NEVER.
- device
Name string - The device name of the disk to be attached.
- delete_
rule str - A value that prescribes what should happen to the stateful disk when the VM instance is deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER - detach the disk when the VM is deleted, but do not delete the disk. ON_PERMANENT_INSTANCE_DELETION will delete the stateful disk when the VM is permanently deleted from the instance group. The default is NEVER.
- device_
name str - The device name of the disk to be attached.
- delete
Rule String - A value that prescribes what should happen to the stateful disk when the VM instance is deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER - detach the disk when the VM is deleted, but do not delete the disk. ON_PERMANENT_INSTANCE_DELETION will delete the stateful disk when the VM is permanently deleted from the instance group. The default is NEVER.
- device
Name String - The device name of the disk to be attached.
GetRegionInstanceGroupManagerStatefulExternalIp
- Delete
Rule string - A value that prescribes what should happen to an associated static Address resource when a VM instance is permanently deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER - detach the IP when the VM is deleted, but do not delete the address resource. ON_PERMANENT_INSTANCE_DELETION will delete the stateful address when the VM is permanently deleted from the instance group. The default is NEVER.
- Interface
Name string - The network interface name
- Delete
Rule string - A value that prescribes what should happen to an associated static Address resource when a VM instance is permanently deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER - detach the IP when the VM is deleted, but do not delete the address resource. ON_PERMANENT_INSTANCE_DELETION will delete the stateful address when the VM is permanently deleted from the instance group. The default is NEVER.
- Interface
Name string - The network interface name
- delete
Rule String - A value that prescribes what should happen to an associated static Address resource when a VM instance is permanently deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER - detach the IP when the VM is deleted, but do not delete the address resource. ON_PERMANENT_INSTANCE_DELETION will delete the stateful address when the VM is permanently deleted from the instance group. The default is NEVER.
- interface
Name String - The network interface name
- delete
Rule string - A value that prescribes what should happen to an associated static Address resource when a VM instance is permanently deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER - detach the IP when the VM is deleted, but do not delete the address resource. ON_PERMANENT_INSTANCE_DELETION will delete the stateful address when the VM is permanently deleted from the instance group. The default is NEVER.
- interface
Name string - The network interface name
- delete_
rule str - A value that prescribes what should happen to an associated static Address resource when a VM instance is permanently deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER - detach the IP when the VM is deleted, but do not delete the address resource. ON_PERMANENT_INSTANCE_DELETION will delete the stateful address when the VM is permanently deleted from the instance group. The default is NEVER.
- interface_
name str - The network interface name
- delete
Rule String - A value that prescribes what should happen to an associated static Address resource when a VM instance is permanently deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER - detach the IP when the VM is deleted, but do not delete the address resource. ON_PERMANENT_INSTANCE_DELETION will delete the stateful address when the VM is permanently deleted from the instance group. The default is NEVER.
- interface
Name String - The network interface name
GetRegionInstanceGroupManagerStatefulInternalIp
- Delete
Rule string - A value that prescribes what should happen to an associated static Address resource when a VM instance is permanently deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER - detach the IP when the VM is deleted, but do not delete the address resource. ON_PERMANENT_INSTANCE_DELETION will delete the stateful address when the VM is permanently deleted from the instance group. The default is NEVER.
- Interface
Name string - The network interface name
- Delete
Rule string - A value that prescribes what should happen to an associated static Address resource when a VM instance is permanently deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER - detach the IP when the VM is deleted, but do not delete the address resource. ON_PERMANENT_INSTANCE_DELETION will delete the stateful address when the VM is permanently deleted from the instance group. The default is NEVER.
- Interface
Name string - The network interface name
- delete
Rule String - A value that prescribes what should happen to an associated static Address resource when a VM instance is permanently deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER - detach the IP when the VM is deleted, but do not delete the address resource. ON_PERMANENT_INSTANCE_DELETION will delete the stateful address when the VM is permanently deleted from the instance group. The default is NEVER.
- interface
Name String - The network interface name
- delete
Rule string - A value that prescribes what should happen to an associated static Address resource when a VM instance is permanently deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER - detach the IP when the VM is deleted, but do not delete the address resource. ON_PERMANENT_INSTANCE_DELETION will delete the stateful address when the VM is permanently deleted from the instance group. The default is NEVER.
- interface
Name string - The network interface name
- delete_
rule str - A value that prescribes what should happen to an associated static Address resource when a VM instance is permanently deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER - detach the IP when the VM is deleted, but do not delete the address resource. ON_PERMANENT_INSTANCE_DELETION will delete the stateful address when the VM is permanently deleted from the instance group. The default is NEVER.
- interface_
name str - The network interface name
- delete
Rule String - A value that prescribes what should happen to an associated static Address resource when a VM instance is permanently deleted. The available options are NEVER and ON_PERMANENT_INSTANCE_DELETION. NEVER - detach the IP when the VM is deleted, but do not delete the address resource. ON_PERMANENT_INSTANCE_DELETION will delete the stateful address when the VM is permanently deleted from the instance group. The default is NEVER.
- interface
Name String - The network interface name
GetRegionInstanceGroupManagerStatus
- All
Instances List<GetConfigs Region Instance Group Manager Status All Instances Config> - Status of all-instances configuration on the group.
- Is
Stable bool - A bit indicating whether the managed instance group is in a stable state. A stable state means that: none of the instances in the managed instance group is currently undergoing any type of change (for example, creation, restart, or deletion); no future changes are scheduled for instances in the managed instance group; and the managed instance group itself is not being modified.
- Statefuls
List<Get
Region Instance Group Manager Status Stateful> - Stateful status of the given Instance Group Manager.
- Version
Targets List<GetRegion Instance Group Manager Status Version Target> - A status of consistency of Instances' versions with their target version specified by version field on Instance Group Manager.
- All
Instances []GetConfigs Region Instance Group Manager Status All Instances Config - Status of all-instances configuration on the group.
- Is
Stable bool - A bit indicating whether the managed instance group is in a stable state. A stable state means that: none of the instances in the managed instance group is currently undergoing any type of change (for example, creation, restart, or deletion); no future changes are scheduled for instances in the managed instance group; and the managed instance group itself is not being modified.
- Statefuls
[]Get
Region Instance Group Manager Status Stateful - Stateful status of the given Instance Group Manager.
- Version
Targets []GetRegion Instance Group Manager Status Version Target - A status of consistency of Instances' versions with their target version specified by version field on Instance Group Manager.
- all
Instances List<GetConfigs Region Instance Group Manager Status All Instances Config> - Status of all-instances configuration on the group.
- is
Stable 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<Get
Region Instance Group Manager Status Stateful> - Stateful status of the given Instance Group Manager.
- version
Targets List<GetRegion Instance Group Manager Status Version Target> - A status of consistency of Instances' versions with their target version specified by version field on Instance Group Manager.
- all
Instances GetConfigs Region Instance Group Manager Status All Instances Config[] - Status of all-instances configuration on the group.
- is
Stable 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
Get
Region Instance Group Manager Status Stateful[] - Stateful status of the given Instance Group Manager.
- version
Targets GetRegion Instance Group Manager Status Version Target[] - A status of consistency of Instances' versions with their target version specified by version field on Instance Group Manager.
- all_
instances_ Sequence[Getconfigs Region Instance Group Manager Status All Instances Config] - Status of all-instances configuration on the group.
- is_
stable bool - A bit indicating whether the managed instance group is in a stable state. A stable state means that: none of the instances in the managed instance group is currently undergoing any type of change (for example, creation, restart, or deletion); no future changes are scheduled for instances in the managed instance group; and the managed instance group itself is not being modified.
- statefuls
Sequence[Get
Region Instance Group Manager Status Stateful] - Stateful status of the given Instance Group Manager.
- version_
targets Sequence[GetRegion Instance Group Manager Status Version Target] - A status of consistency of Instances' versions with their target version specified by version field on Instance Group Manager.
- all
Instances List<Property Map>Configs - Status of all-instances configuration on the group.
- is
Stable 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.
- version
Targets List<Property Map> - A status of consistency of Instances' versions with their target version specified by version field on Instance Group Manager.
GetRegionInstanceGroupManagerStatusAllInstancesConfig
- Current
Revision 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.
- Current
Revision 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.
- current
Revision 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 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.
- current
Revision String - Current all-instances configuration revision. This value is in RFC3339 text format.
- effective Boolean
- A bit indicating whether this configuration has been applied to all managed instances in the group.
GetRegionInstanceGroupManagerStatusStateful
- 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 List<GetConfigs Region Instance 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 []GetConfigs Region Instance Group Manager Status Stateful Per Instance Config - Status of per-instance configs on the instances.
- has
Stateful 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.
- per
Instance List<GetConfigs Region Instance Group Manager Status Stateful Per Instance Config> - Status of per-instance configs on the instances.
- has
Stateful 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.
- per
Instance GetConfigs Region Instance 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[Getconfigs Region Instance Group Manager Status Stateful Per Instance Config] - Status of per-instance configs on the instances.
- has
Stateful 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.
- per
Instance List<Property Map>Configs - Status of per-instance configs on the instances.
GetRegionInstanceGroupManagerStatusStatefulPerInstanceConfig
- All
Effective bool - A bit indicating if all of the group's per-instance configs (listed in the output of a listPerInstanceConfigs API call) have status EFFECTIVE or there are no per-instance-configs.
- All
Effective bool - A bit indicating if all of the group's per-instance configs (listed in the output of a listPerInstanceConfigs API call) have status EFFECTIVE or there are no per-instance-configs.
- all
Effective Boolean - A bit indicating if all of the group's per-instance configs (listed in the output of a listPerInstanceConfigs API call) have status EFFECTIVE or there are no per-instance-configs.
- all
Effective boolean - A bit indicating if all of the group's per-instance configs (listed in the output of a listPerInstanceConfigs API call) have status EFFECTIVE or there are no per-instance-configs.
- all_
effective bool - A bit indicating if all of the group's per-instance configs (listed in the output of a listPerInstanceConfigs API call) have status EFFECTIVE or there are no per-instance-configs.
- all
Effective Boolean - A bit indicating if all of the group's per-instance configs (listed in the output of a listPerInstanceConfigs API call) have status EFFECTIVE or there are no per-instance-configs.
GetRegionInstanceGroupManagerStatusVersionTarget
- 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.
- 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.
- is
Reached 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 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.
- is
Reached Boolean - A bit indicating whether version target has been reached in this managed instance group, i.e. all instances are in their target version. Instances' target version are specified by version field on Instance Group Manager.
GetRegionInstanceGroupManagerUpdatePolicy
- Instance
Redistribution stringType - The instance redistribution policy for regional managed instance groups. Valid values are: "PROACTIVE", "NONE". If PROACTIVE (default), the group attempts to maintain an even distribution of VM instances across zones in the region. If NONE, proactive redistribution is disabled.
- Max
Surge 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].
- Minimal
Action string - Minimal action to be taken on an instance. You can specify either NONE to forbid any actions, REFRESH to update without stopping instances, RESTART to restart existing instances or REPLACE to delete and create new instances from the target template. If you specify a REFRESH, the Updater will attempt to perform that action only. However, if the Updater determines that the minimal action you specify is not enough to perform the update, it might perform a more disruptive action.
- Most
Disruptive 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.
- Replacement
Method string - The instance replacement method for regional managed instance groups. Valid values are: "RECREATE", "SUBSTITUTE". If SUBSTITUTE (default), the group replaces VM instances with new instances that have randomly generated names. If RECREATE, instance names are preserved. You must also set max_unavailable_fixed or max_unavailable_percent to be greater than 0.
- Type string
- The type of update process. You can specify either PROACTIVE so that the instance group manager proactively executes actions in order to bring instances to their target versions or OPPORTUNISTIC so that no action is proactively executed but the update will be performed as part of other actions (for example, resizes or recreateInstances calls).
- Instance
Redistribution stringType - The instance redistribution policy for regional managed instance groups. Valid values are: "PROACTIVE", "NONE". If PROACTIVE (default), the group attempts to maintain an even distribution of VM instances across zones in the region. If NONE, proactive redistribution is disabled.
- Max
Surge 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].
- Minimal
Action string - Minimal action to be taken on an instance. You can specify either NONE to forbid any actions, REFRESH to update without stopping instances, RESTART to restart existing instances or REPLACE to delete and create new instances from the target template. If you specify a REFRESH, the Updater will attempt to perform that action only. However, if the Updater determines that the minimal action you specify is not enough to perform the update, it might perform a more disruptive action.
- Most
Disruptive 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.
- Replacement
Method string - The instance replacement method for regional managed instance groups. Valid values are: "RECREATE", "SUBSTITUTE". If SUBSTITUTE (default), the group replaces VM instances with new instances that have randomly generated names. If RECREATE, instance names are preserved. You must also set max_unavailable_fixed or max_unavailable_percent to be greater than 0.
- Type string
- The type of update process. You can specify either PROACTIVE so that the instance group manager proactively executes actions in order to bring instances to their target versions or OPPORTUNISTIC so that no action is proactively executed but the update will be performed as part of other actions (for example, resizes or recreateInstances calls).
- instance
Redistribution StringType - The instance redistribution policy for regional managed instance groups. Valid values are: "PROACTIVE", "NONE". If PROACTIVE (default), the group attempts to maintain an even distribution of VM instances across zones in the region. If NONE, proactive redistribution is disabled.
- max
Surge IntegerFixed - Specifies a fixed number of VM instances. This must be a positive integer. Conflicts with max_surge_percent. Both cannot be 0
- max
Surge 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%.
- min
Ready IntegerSec - Minimum number of seconds to wait for after a newly created instance becomes available. This value must be from range [0, 3600].
- minimal
Action String - Minimal action to be taken on an instance. You can specify either NONE to forbid any actions, REFRESH to update without stopping instances, RESTART to restart existing instances or REPLACE to delete and create new instances from the target template. If you specify a REFRESH, the Updater will attempt to perform that action only. However, if the Updater determines that the minimal action you specify is not enough to perform the update, it might perform a more disruptive action.
- most
Disruptive 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.
- replacement
Method String - The instance replacement method for regional managed instance groups. Valid values are: "RECREATE", "SUBSTITUTE". If SUBSTITUTE (default), the group replaces VM instances with new instances that have randomly generated names. If RECREATE, instance names are preserved. You must also set max_unavailable_fixed or max_unavailable_percent to be greater than 0.
- type String
- The type of update process. You can specify either PROACTIVE so that the instance group manager proactively executes actions in order to bring instances to their target versions or OPPORTUNISTIC so that no action is proactively executed but the update will be performed as part of other actions (for example, resizes or recreateInstances calls).
- instance
Redistribution stringType - The instance redistribution policy for regional managed instance groups. Valid values are: "PROACTIVE", "NONE". If PROACTIVE (default), the group attempts to maintain an even distribution of VM instances across zones in the region. If NONE, proactive redistribution is disabled.
- max
Surge numberFixed - Specifies a fixed number of VM instances. This must be a positive integer. Conflicts with max_surge_percent. Both cannot be 0
- max
Surge 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%.
- min
Ready numberSec - Minimum number of seconds to wait for after a newly created instance becomes available. This value must be from range [0, 3600].
- minimal
Action string - Minimal action to be taken on an instance. You can specify either NONE to forbid any actions, REFRESH to update without stopping instances, RESTART to restart existing instances or REPLACE to delete and create new instances from the target template. If you specify a REFRESH, the Updater will attempt to perform that action only. However, if the Updater determines that the minimal action you specify is not enough to perform the update, it might perform a more disruptive action.
- most
Disruptive 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.
- replacement
Method string - The instance replacement method for regional managed instance groups. Valid values are: "RECREATE", "SUBSTITUTE". If SUBSTITUTE (default), the group replaces VM instances with new instances that have randomly generated names. If RECREATE, instance names are preserved. You must also set max_unavailable_fixed or max_unavailable_percent to be greater than 0.
- type string
- The type of update process. You can specify either PROACTIVE so that the instance group manager proactively executes actions in order to bring instances to their target versions or OPPORTUNISTIC so that no action is proactively executed but the update will be performed as part of other actions (for example, resizes or recreateInstances calls).
- instance_
redistribution_ strtype - The instance redistribution policy for regional managed instance groups. Valid values are: "PROACTIVE", "NONE". If PROACTIVE (default), the group attempts to maintain an even distribution of VM instances across zones in the region. If NONE, proactive redistribution is disabled.
- max_
surge_ 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].
- minimal_
action str - Minimal action to be taken on an instance. You can specify either NONE to forbid any actions, REFRESH to update without stopping instances, RESTART to restart existing instances or REPLACE to delete and create new instances from the target template. If you specify a REFRESH, the Updater will attempt to perform that action only. However, if the Updater determines that the minimal action you specify is not enough to perform the update, it might perform a more disruptive action.
- most_
disruptive_ 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 regional managed instance groups. Valid values are: "RECREATE", "SUBSTITUTE". If SUBSTITUTE (default), the group replaces VM instances with new instances that have randomly generated names. If RECREATE, instance names are preserved. You must also set max_unavailable_fixed or max_unavailable_percent to be greater than 0.
- type str
- The type of update process. You can specify either PROACTIVE so that the instance group manager proactively executes actions in order to bring instances to their target versions or OPPORTUNISTIC so that no action is proactively executed but the update will be performed as part of other actions (for example, resizes or recreateInstances calls).
- instance
Redistribution StringType - The instance redistribution policy for regional managed instance groups. Valid values are: "PROACTIVE", "NONE". If PROACTIVE (default), the group attempts to maintain an even distribution of VM instances across zones in the region. If NONE, proactive redistribution is disabled.
- max
Surge NumberFixed - Specifies a fixed number of VM instances. This must be a positive integer. Conflicts with max_surge_percent. Both cannot be 0
- max
Surge 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%.
- min
Ready NumberSec - Minimum number of seconds to wait for after a newly created instance becomes available. This value must be from range [0, 3600].
- minimal
Action String - Minimal action to be taken on an instance. You can specify either NONE to forbid any actions, REFRESH to update without stopping instances, RESTART to restart existing instances or REPLACE to delete and create new instances from the target template. If you specify a REFRESH, the Updater will attempt to perform that action only. However, if the Updater determines that the minimal action you specify is not enough to perform the update, it might perform a more disruptive action.
- most
Disruptive 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.
- replacement
Method String - The instance replacement method for regional managed instance groups. Valid values are: "RECREATE", "SUBSTITUTE". If SUBSTITUTE (default), the group replaces VM instances with new instances that have randomly generated names. If RECREATE, instance names are preserved. You must also set max_unavailable_fixed or max_unavailable_percent to be greater than 0.
- type String
- The type of update process. You can specify either PROACTIVE so that the instance group manager proactively executes actions in order to bring instances to their target versions or OPPORTUNISTIC so that no action is proactively executed but the update will be performed as part of other actions (for example, resizes or recreateInstances calls).
GetRegionInstanceGroupManagerVersion
- Instance
Template string - The full URL to an instance template from which all new instances of this version will be created.
- Name string
- The name of the instance group. Either
name
orself_link
must be provided. - Target
Sizes List<GetRegion Instance Group Manager Version Target Size> - The number of instances calculated as a fixed number or a percentage depending on the settings.
- Instance
Template string - The full URL to an instance template from which all new instances of this version will be created.
- Name string
- The name of the instance group. Either
name
orself_link
must be provided. - Target
Sizes []GetRegion Instance Group Manager Version Target Size - The number of instances calculated as a fixed number or a percentage depending on the settings.
- instance
Template String - The full URL to an instance template from which all new instances of this version will be created.
- name String
- The name of the instance group. Either
name
orself_link
must be provided. - target
Sizes List<GetRegion Instance Group Manager Version Target Size> - The number of instances calculated as a fixed number or a percentage depending on the settings.
- instance
Template string - The full URL to an instance template from which all new instances of this version will be created.
- name string
- The name of the instance group. Either
name
orself_link
must be provided. - target
Sizes GetRegion Instance Group Manager Version Target Size[] - The number of instances calculated as a fixed number or a percentage depending on the settings.
- instance_
template str - The full URL to an instance template from which all new instances of this version will be created.
- name str
- The name of the instance group. Either
name
orself_link
must be provided. - target_
sizes Sequence[GetRegion Instance Group Manager Version Target Size] - The number of instances calculated as a fixed number or a percentage depending on the settings.
- instance
Template String - The full URL to an instance template from which all new instances of this version will be created.
- name String
- The name of the instance group. Either
name
orself_link
must be provided. - target
Sizes List<Property Map> - The number of instances calculated as a fixed number or a percentage depending on the settings.
GetRegionInstanceGroupManagerVersionTargetSize
- Fixed int
- The number of instances which are managed for this version. Conflicts with percent.
- Percent int
- The number of instances (calculated as percentage) which are managed for this version. Conflicts with fixed. Note that when using percent, rounding will be in favor of explicitly set target_size values; a managed instance group with 2 instances and 2 versions, one of which has a target_size.percent of 60 will create 2 instances of that version.
- Fixed int
- The number of instances which are managed for this version. Conflicts with percent.
- Percent int
- The number of instances (calculated as percentage) which are managed for this version. Conflicts with fixed. Note that when using percent, rounding will be in favor of explicitly set target_size values; a managed instance group with 2 instances and 2 versions, one of which has a target_size.percent of 60 will create 2 instances of that version.
- fixed Integer
- The number of instances which are managed for this version. Conflicts with percent.
- percent Integer
- The number of instances (calculated as percentage) which are managed for this version. Conflicts with fixed. Note that when using percent, rounding will be in favor of explicitly set target_size values; a managed instance group with 2 instances and 2 versions, one of which has a target_size.percent of 60 will create 2 instances of that version.
- fixed number
- The number of instances which are managed for this version. Conflicts with percent.
- percent number
- The number of instances (calculated as percentage) which are managed for this version. Conflicts with fixed. Note that when using percent, rounding will be in favor of explicitly set target_size values; a managed instance group with 2 instances and 2 versions, one of which has a target_size.percent of 60 will create 2 instances of that version.
- fixed int
- The number of instances which are managed for this version. Conflicts with percent.
- percent int
- The number of instances (calculated as percentage) which are managed for this version. Conflicts with fixed. Note that when using percent, rounding will be in favor of explicitly set target_size values; a managed instance group with 2 instances and 2 versions, one of which has a target_size.percent of 60 will create 2 instances of that version.
- fixed Number
- The number of instances which are managed for this version. Conflicts with percent.
- percent Number
- The number of instances (calculated as percentage) which are managed for this version. Conflicts with fixed. Note that when using percent, rounding will be in favor of explicitly set target_size values; a managed instance group with 2 instances and 2 versions, one of which has a target_size.percent of 60 will create 2 instances of that version.
Package Details
- Repository
- Google Cloud (GCP) Classic pulumi/pulumi-gcp
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
google-beta
Terraform Provider.