RegionInstanceGroupManagerArgs class
The set of arguments for RegionInstanceGroupManager. The set of arguments for RegionInstanceGroupManager.
Constructors
-
RegionInstanceGroupManagerArgs({Input<
RegionInstanceGroupManagerAllInstancesConfig?> ? allInstancesConfig, Input<RegionInstanceGroupManagerAutoHealingPolicies?> ? autoHealingPolicies, required Input<String> baseInstanceName, Input<String?> ? deletionPolicy, Input<String?> ? description, Input<String?> ? distributionPolicyTargetShape, Input<List< ? distributionPolicyZones, Input<String> ?>RegionInstanceGroupManagerInstanceFlexibilityPolicy?> ? instanceFlexibilityPolicy, Input<RegionInstanceGroupManagerInstanceLifecyclePolicy?> ? instanceLifecyclePolicy, Input<String?> ? listManagedInstancesResults, Input<String?> ? name, Input<List< ? namedPorts, Input<RegionInstanceGroupManagerNamedPort> ?>RegionInstanceGroupManagerParams?> ? params, Input<String?> ? project, Input<String?> ? region, Input<RegionInstanceGroupManagerResourcePolicies?> ? resourcePolicies, Input<RegionInstanceGroupManagerStandbyPolicy?> ? standbyPolicy, Input<List< ? statefulDisks, Input<RegionInstanceGroupManagerStatefulDisk> ?>List< ? statefulExternalIps, Input<RegionInstanceGroupManagerStatefulExternalIp> ?>List< ? statefulInternalIps, Input<RegionInstanceGroupManagerStatefulInternalIp> ?>List< ? targetPools, Input<String> ?>int?> ? targetSize, Input<List< ? targetSizePolicies, Input<RegionInstanceGroupManagerTargetSizePolicy> ?>int?> ? targetStoppedSize, Input<int?> ? targetSuspendedSize, Input<RegionInstanceGroupManagerUpdatePolicy?> ? updatePolicy, required Input<List< versions, Input<RegionInstanceGroupManagerVersion> >bool?> ? waitForInstances, Input<String?> ? waitForInstancesStatus}) -
Creates a new RegionInstanceGroupManagerArgs.
allInstancesConfigProperties to set on all instances in the group. After settingautoHealingPoliciesThe autohealing policies for this managed instancebaseInstanceNameThe base instance name to use fordeletionPolicyWhether Terraform will be prevented from destroying the resource. Defaults to "DELETE".descriptionAn optional textual description of the instancedistributionPolicyTargetShapeThe shape to which the group converges either proactively or on resize events (depending on the value set in update_policy.0.instance_redistribution_type). For more information see the official documentation.distributionPolicyZonesThe distribution policy for this managed instanceinstanceFlexibilityPolicyThe flexibility policy for managed instance group. Instance flexibility allows managed instance group to create VMs from multiple types of machines. Instance flexibility configuration on managed instance group overrides instance template configuration. Structure is documented below.instanceLifecyclePolicyThe instance lifecycle policy for this managed instance group.listManagedInstancesResultsPagination behavior of thelistManagedInstancesAPInameThe name of the instance group manager. Must be 1-63namedPortsThe named port configuration. See the section belowparams) Input only additional params for instance group manager creation. Structure is documented below. For more information, see API.projectThe ID of the project in which the resource belongs. If itregionThe region where the managed instance group resides. If not provided, the provider region is used.resourcePoliciesResource policies for this managed instance group. Structure is documented below.standbyPolicyThe standby policy for stopped and suspended instances. Structure is documented below. For more information, see the official documentation.statefulDisksDisks created on the instances that will be preserved on instance delete, update, etc. Structure is documented below. For more information see the official documentation. Proactive cross zone instance redistribution must be disabled before you can update stateful disks on existing instance group managers. This can be controlled via theupdatePolicy.statefulExternalIpsExternal 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.statefulInternalIpsInternal 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.targetPoolsThe full URL of all target pools to which newtargetSizeThe target number of running instances for this managedtargetSizePoliciesThe policy that specifies how the MIG creates its VMs to achieve the target size. Structure is documented below.targetStoppedSizeThe target number of stopped instances for this managed instance group.targetSuspendedSizeThe target number of suspended instances for this managed instance group.updatePolicyThe update policy for this managed instance group. Structure is documented below. For more information, see the official documentation and APIversionsApplication versions managed by this instance group. EachwaitForInstancesWhether to wait for all instances to be created/updated beforewaitForInstancesStatusWhen used withwaitForInstancesit specifies the status to wait for.const -
RegionInstanceGroupManagerArgs.fromMap(Map<
String, dynamic> map) -
factory
Properties
-
allInstancesConfig
→ Input<
RegionInstanceGroupManagerAllInstancesConfig?> ? -
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.
final
-
autoHealingPolicies
→ Input<
RegionInstanceGroupManagerAutoHealingPolicies?> ? -
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.
final
-
baseInstanceName
→ Input<
String> -
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.
final
-
deletionPolicy
→ Input<
String?> ? -
Whether Terraform will be prevented from destroying the resource. Defaults to "DELETE".
When a 'terraform destroy' or 'pulumi up' would delete the resource,
the command will fail if this field is set to "PREVENT" in Terraform state.
When set to "ABANDON", the command will remove the resource from Terraform
management without updating or deleting the resource in the API.
When set to "DELETE", deleting the resource is allowed.
final
-
description
→ Input<
String?> ? -
An optional textual description of the instance
group manager.
final
-
distributionPolicyTargetShape
→ Input<
String?> ? -
The shape to which the group converges either proactively or on resize events (depending on the value set in update_policy.0.instance_redistribution_type). For more information see the official documentation.
final
-
distributionPolicyZones
→ Input<
List< ?String> ?> -
The distribution policy for this managed instance
group. You can specify one or more values. For more information, see the official documentation.
final
- hashCode → int
-
The hash code for this object.
no setterinherited
-
instanceFlexibilityPolicy
→ Input<
RegionInstanceGroupManagerInstanceFlexibilityPolicy?> ? -
The flexibility policy for managed instance group. Instance flexibility allows managed instance group to create VMs from multiple types of machines. Instance flexibility configuration on managed instance group overrides instance template configuration. Structure is documented below.
final
-
instanceLifecyclePolicy
→ Input<
RegionInstanceGroupManagerInstanceLifecyclePolicy?> ? -
The instance lifecycle policy for this managed instance group.
final
-
listManagedInstancesResults
→ Input<
String?> ? -
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.final -
name
→ Input<
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.
final
-
namedPorts
→ Input<
List< ?RegionInstanceGroupManagerNamedPort> ?> -
The named port configuration. See the section below
for details on configuration.
final
-
params
→ Input<
RegionInstanceGroupManagerParams?> ? -
) Input only additional params for instance group manager creation. Structure is documented below. For more information, see API.
final
-
project
→ Input<
String?> ? -
The ID of the project in which the resource belongs. If it
is not provided, the provider project is used.
final
-
region
→ Input<
String?> ? -
The region where the managed instance group resides. If not provided, the provider region is used.
final
-
resourcePolicies
→ Input<
RegionInstanceGroupManagerResourcePolicies?> ? -
Resource policies for this managed instance group. Structure is documented below.
final
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
-
standbyPolicy
→ Input<
RegionInstanceGroupManagerStandbyPolicy?> ? -
The standby policy for stopped and suspended instances. Structure is documented below. For more information, see the official documentation.
final
-
statefulDisks
→ Input<
List< ?RegionInstanceGroupManagerStatefulDisk> ?> -
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. Proactive cross zone instance redistribution must be disabled before you can update stateful disks on existing instance group managers. This can be controlled via the
updatePolicy.final -
statefulExternalIps
→ Input<
List< ?RegionInstanceGroupManagerStatefulExternalIp> ?> -
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.
final
-
statefulInternalIps
→ Input<
List< ?RegionInstanceGroupManagerStatefulInternalIp> ?> -
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.
final
-
targetPools
→ Input<
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.
final
-
targetSize
→ Input<
int?> ? -
The target number of running instances for this managed
instance group. This value will fight with autoscaler settings when set, and generally shouldn't be set
when using one. If a value is required, such as to specify a creation-time target size for the MIG,
lifecycle.ignore_changescan be used to prevent Terraform from modifying the value. Defaults to0.final -
targetSizePolicies
→ Input<
List< ?RegionInstanceGroupManagerTargetSizePolicy> ?> -
The policy that specifies how the MIG creates its VMs to achieve the target size. Structure is documented below.
final
-
targetStoppedSize
→ Input<
int?> ? -
The target number of stopped instances for this managed instance group.
final
-
targetSuspendedSize
→ Input<
int?> ? -
The target number of suspended instances for this managed instance group.
final
-
updatePolicy
→ Input<
RegionInstanceGroupManagerUpdatePolicy?> ? -
The update policy for this managed instance group. Structure is documented below. For more information, see the official documentation and API
final
-
versions
→ Input<
List< RegionInstanceGroupManagerVersion> > -
Application versions managed by this instance group. Each
version deals with a specific instance template, allowing canary release scenarios.
Structure is documented below.
final
-
waitForInstances
→ Input<
bool?> ? -
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, the provider will
continue trying until it times out.
final
-
waitForInstancesStatus
→ Input<
String?> ? -
When used with
waitForInstancesit 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 areSTABLEandUPDATEDfinal
Methods
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
toMap(
) → Map< String, dynamic> -
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited