InstanceGroupProps

Properties for defining a InstanceGroup.

See https://www.alibabacloud.com/help/ros/developer-reference/aliyun-ecs-instancegroup

Initializer

import com.aliyun.ros.cdk.ecs.InstanceGroupProps;
InstanceGroupProps.builder()
    .instanceType(java.lang.String)
    .instanceType(IResolvable)
    .maxAmount(java.lang.Number)
    .maxAmount(IResolvable)
//  .affinity(java.lang.String)
//  .affinity(IResolvable)
//  .allocatePublicIp(java.lang.Boolean)
//  .allocatePublicIp(IResolvable)
//  .autoReleaseTime(java.lang.String)
//  .autoReleaseTime(IResolvable)
//  .autoRenew(java.lang.String)
//  .autoRenew(IResolvable)
//  .autoRenewPeriod(java.lang.Number)
//  .autoRenewPeriod(IResolvable)
//  .cpuOptions(IResolvable)
//  .cpuOptions(CpuOptionsProperty)
//  .creditSpecification(java.lang.String)
//  .creditSpecification(IResolvable)
//  .dedicatedHostId(java.lang.String)
//  .dedicatedHostId(IResolvable)
//  .deletionForce(java.lang.Boolean)
//  .deletionForce(IResolvable)
//  .deletionProtection(java.lang.Boolean)
//  .deletionProtection(IResolvable)
//  .deploymentSetGroupNo(java.lang.Number)
//  .deploymentSetGroupNo(IResolvable)
//  .deploymentSetId(java.lang.String)
//  .deploymentSetId(IResolvable)
//  .description(java.lang.String)
//  .description(IResolvable)
//  .diskMappings(IResolvable)
//  .diskMappings(java.util.List<IResolvable)
//  .diskMappings(DiskMappingsProperty>)
//  .eniMappings(IResolvable)
//  .eniMappings(java.util.List<IResolvable)
//  .eniMappings(EniMappingsProperty>)
//  .hostName(java.lang.String)
//  .hostName(IResolvable)
//  .hostNames(IResolvable)
//  .hostNames(java.util.List<java.lang.String)
//  .hostNames(IResolvable>)
//  .hpcClusterId(java.lang.String)
//  .hpcClusterId(IResolvable)
//  .httpEndpoint(java.lang.String)
//  .httpEndpoint(IResolvable)
//  .httpTokens(java.lang.String)
//  .httpTokens(IResolvable)
//  .imageFamily(java.lang.String)
//  .imageFamily(IResolvable)
//  .imageId(java.lang.String)
//  .imageId(IResolvable)
//  .imageOptions(IResolvable)
//  .imageOptions(ImageOptionsProperty)
//  .instanceChargeType(java.lang.String)
//  .instanceChargeType(IResolvable)
//  .instanceName(java.lang.String)
//  .instanceName(IResolvable)
//  .internetChargeType(java.lang.String)
//  .internetChargeType(IResolvable)
//  .internetMaxBandwidthOut(java.lang.Number)
//  .internetMaxBandwidthOut(IResolvable)
//  .ioOptimized(java.lang.String)
//  .ioOptimized(IResolvable)
//  .ipv6AddressCount(java.lang.Number)
//  .ipv6AddressCount(IResolvable)
//  .ipv6Addresses(java.util.List<java.lang.Object>)
//  .ipv6Addresses(IResolvable)
//  .keyPairName(java.lang.String)
//  .keyPairName(IResolvable)
//  .launchTemplateId(java.lang.String)
//  .launchTemplateId(IResolvable)
//  .launchTemplateName(java.lang.String)
//  .launchTemplateName(IResolvable)
//  .launchTemplateVersion(java.lang.String)
//  .launchTemplateVersion(IResolvable)
//  .networkInterfaceQueueNumber(java.lang.Number)
//  .networkInterfaceQueueNumber(IResolvable)
//  .networkOptions(IResolvable)
//  .networkOptions(NetworkOptionsProperty)
//  .networkType(java.lang.String)
//  .networkType(IResolvable)
//  .password(java.lang.String)
//  .password(IResolvable)
//  .passwordInherit(java.lang.Boolean)
//  .passwordInherit(IResolvable)
//  .period(java.lang.Number)
//  .period(IResolvable)
//  .periodUnit(java.lang.String)
//  .periodUnit(IResolvable)
//  .privateIpAddress(java.lang.String)
//  .privateIpAddress(IResolvable)
//  .privatePoolOptions(IResolvable)
//  .privatePoolOptions(PrivatePoolOptionsProperty)
//  .ramRoleName(java.lang.String)
//  .ramRoleName(IResolvable)
//  .resourceGroupId(java.lang.String)
//  .resourceGroupId(IResolvable)
//  .schedulerOptions(IResolvable)
//  .schedulerOptions(SchedulerOptionsProperty)
//  .securityEnhancementStrategy(java.lang.String)
//  .securityEnhancementStrategy(IResolvable)
//  .securityGroupId(java.lang.String)
//  .securityGroupId(IResolvable)
//  .securityGroupIds(IResolvable)
//  .securityGroupIds(java.util.List<java.lang.String)
//  .securityGroupIds(IResolvable>)
//  .securityOptions(IResolvable)
//  .securityOptions(SecurityOptionsProperty)
//  .spotDuration(java.lang.Number)
//  .spotDuration(IResolvable)
//  .spotInterruptionBehavior(java.lang.String)
//  .spotInterruptionBehavior(IResolvable)
//  .spotPriceLimit(java.lang.String)
//  .spotPriceLimit(IResolvable)
//  .spotStrategy(java.lang.String)
//  .spotStrategy(IResolvable)
//  .storageSetId(java.lang.String)
//  .storageSetId(IResolvable)
//  .storageSetPartitionNumber(java.lang.Number)
//  .storageSetPartitionNumber(IResolvable)
//  .subscriptionDeletionForce(java.lang.Boolean)
//  .subscriptionDeletionForce(IResolvable)
//  .systemDiskAutoSnapshotPolicyId(java.lang.String)
//  .systemDiskAutoSnapshotPolicyId(IResolvable)
//  .systemDiskBurstingEnabled(java.lang.Boolean)
//  .systemDiskBurstingEnabled(IResolvable)
//  .systemDiskCategory(java.lang.String)
//  .systemDiskCategory(IResolvable)
//  .systemDiskDescription(java.lang.String)
//  .systemDiskDescription(IResolvable)
//  .systemDiskDiskName(java.lang.String)
//  .systemDiskDiskName(IResolvable)
//  .systemDiskEncryptAlgorithm(java.lang.String)
//  .systemDiskEncryptAlgorithm(IResolvable)
//  .systemDiskEncrypted(java.lang.String)
//  .systemDiskEncrypted(IResolvable)
//  .systemDiskKmsKeyId(java.lang.String)
//  .systemDiskKmsKeyId(IResolvable)
//  .systemDiskPerformanceLevel(java.lang.String)
//  .systemDiskPerformanceLevel(IResolvable)
//  .systemDiskProvisionedIops(java.lang.Number)
//  .systemDiskProvisionedIops(IResolvable)
//  .systemDiskSize(java.lang.Number)
//  .systemDiskSize(IResolvable)
//  .systemDiskStorageClusterId(java.lang.String)
//  .systemDiskStorageClusterId(IResolvable)
//  .tags(java.util.List<TagsProperty>)
//  .tenancy(java.lang.String)
//  .tenancy(IResolvable)
//  .uniqueSuffix(java.lang.Boolean)
//  .uniqueSuffix(IResolvable)
//  .updatePolicy(java.lang.String)
//  .updatePolicy(IResolvable)
//  .useAdditionalService(java.lang.Boolean)
//  .useAdditionalService(IResolvable)
//  .userData(java.lang.String)
//  .userData(IResolvable)
//  .vpcId(java.lang.String)
//  .vpcId(IResolvable)
//  .vSwitchId(java.lang.String)
//  .vSwitchId(IResolvable)
//  .zoneId(java.lang.String)
//  .zoneId(IResolvable)
//  .zoneIds(IResolvable)
//  .zoneIds(java.util.List<java.lang.String)
//  .zoneIds(IResolvable>)
    .build();

Properties

instanceType^Required

public java.lang.Object getInstanceType();

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property instanceType: Ecs instance supported instance type, make sure it should be correct.

maxAmount^Required

public java.lang.Object getMaxAmount();

• Type: java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable

Property maxAmount: Max number of instances to create, should be bigger than 'MinAmount' and smaller than 1000.

affinity^Optional

public java.lang.Object getAffinity();

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property affinity: Specifies whether to associate the instance on a dedicated host with the dedicated host.

Valid values:

• default: does not associate the ECS instance with the dedicated host. When you start an instance that was stopped in economical mode, the instance is automatically deployed to another dedicated host in the automatic deployment resource pool if the available resources of the original dedicated host are insufficient.
• host: associates the ECS instance with the dedicated host. When you start an instance that was stopped in economical mode, the instance remains on the original dedicated host. If the available resources of the original dedicated host are insufficient, the instance cannot start. Default value: default.

allocatePublicIp^Optional

public java.lang.Object getAllocatePublicIp();

• Type: java.lang.Boolean OR com.aliyun.ros.cdk.core.IResolvable

Property allocatePublicIp: The public ip for ecs instance, if properties is true, will allocate public ip.

If property InternetMaxBandwidthOut set to 0, it will not assign public ip.

autoReleaseTime^Optional

public java.lang.Object getAutoReleaseTime();

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property autoReleaseTime: Auto release time for created instance, Follow ISO8601 standard using UTC time.

format is 'yyyy-MM-ddTHH:mm:ssZ'. Not bigger than 3 years from this day onwards

autoRenew^Optional

public java.lang.Object getAutoRenew();

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property autoRenew: Whether renew the fee automatically?

When the parameter InstanceChargeType is PrePaid, it will take effect. Range of value:True: automatic renewal.False: no automatic renewal. Default value is False.Old instances will not be changed.

autoRenewPeriod^Optional

public java.lang.Object getAutoRenewPeriod();

• Type: java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable

Property autoRenewPeriod: The time period of auto renew.

When the parameter InstanceChargeType is PrePaid, it will take effect.It could be 1, 2, 3, 6, 12, 24, 36, 48, 60. Default value is 1.Old instances will not be changed.

cpuOptions^Optional

public java.lang.Object getCpuOptions();

• Type: com.aliyun.ros.cdk.core.IResolvable OR CpuOptionsProperty

Property cpuOptions: Cpu options.

creditSpecification^Optional

public java.lang.Object getCreditSpecification();

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property creditSpecification: The performance mode of the burstable instance.

Valid values:

• Standard: the standard mode.
• Unlimited: the unlimited mode.

dedicatedHostId^Optional

public java.lang.Object getDedicatedHostId();

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property dedicatedHostId: The ID of the dedicated host.

You can call the DescribeDedicatedHosts operation to query the list of dedicated host IDs.

Spot instances cannot be created on dedicated hosts. If you specify DedicatedHostId, SpotStrategy and SpotPriceLimit are automatically ignored.

deletionForce^Optional

public java.lang.Object getDeletionForce();

• Type: java.lang.Boolean OR com.aliyun.ros.cdk.core.IResolvable

Property deletionForce: Whether force delete the instance.

Default value is false.

deletionProtection^Optional

public java.lang.Object getDeletionProtection();

• Type: java.lang.Boolean OR com.aliyun.ros.cdk.core.IResolvable

Property deletionProtection: Whether an instance can be released manually through the console or API, deletion protection only support postPaid instance.

deploymentSetGroupNo^Optional

public java.lang.Object getDeploymentSetGroupNo();

• Type: java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable

Property deploymentSetGroupNo: The number of the deployment set group to which to deploy the instance.

If the deployment set specified by DeploymentSetId uses the high availability group strategy (AvailabilityGroup), you can use DeploymentSetGroupNo to specify a deployment set group in the deployment set. Valid values: 1 to 7.

deploymentSetId^Optional

public java.lang.Object getDeploymentSetId();

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property deploymentSetId: Deployment set ID.

The change of the property does not affect existing instances.

description^Optional

public java.lang.Object getDescription();

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property description: Description of the instance, [2, 256] characters.

Do not fill or empty, the default is empty. Old instances will not be changed.

diskMappings^Optional

public java.lang.Object getDiskMappings();

• Type: com.aliyun.ros.cdk.core.IResolvable OR java.util.ListDiskMappingsProperty>

Property diskMappings: Disk mappings to attach to instance.

Max support 16 disks. If the image contains a data disk, you can specify other parameters of the data disk via the same value of parameter "Device". If parameter "Category" is not specified, it will be cloud_efficiency instead of "Category" of data disk in the image.Old instances will not be changed.

eniMappings^Optional

public java.lang.Object getEniMappings();

• Type: com.aliyun.ros.cdk.core.IResolvable OR java.util.ListEniMappingsProperty>

Property eniMappings: NetworkInterface to attach to instance.

Max support 2 ENIs.

hostName^Optional

public java.lang.Object getHostName();

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property hostName: Host name of created ecs instance.

at least 2 characters, and '.' '-' Is not the first and last characters as hostname, not continuous use. Windows platform can be up to 15 characters, allowing letters (without limiting case), numbers and '-', and does not support the number of points, not all is digital ('.').Other (Linux, etc.) platform up to 64 characters, allowing support number multiple points for the period between the points, each permit letters (without limiting case), numbers and '-' components. Support to use the regular expression to set the different instance name for each ECS instance. HostName could be specified as 'name_prefix[begin_number,bits]name_suffix', such as 'host[123,4]tail'. If you creates 3 instances with hostname 'host[123,4]tail', all the host names of instances are host0123tail, host0124tail, host0125tail. The 'name_prefix[begin_number,bits]name_suffix' should follow those rules:

1. 'name_prefix' is required.
2. 'name_suffix' is optional.
3. The name regular expression can't include any spaces.
4. The 'bits' must be in range [1, 6].
5. The 'begin_number' must be in range [0, 999999].
6. You could only specify 'begin_number'. The 'bits' will be set as 6 by default.
7. You also could only specify the [] or [,]. The 'begin_number' will be set as 0 by default, the 'bits' will be set as 6 by default.
8. If the bits of 'begin_number' is less than the 'bits' you specified, like [1234,1], the 'bits' will be set as 6 by default. The host name is specified by regular expression works after restart instance manually.

hostNames^Optional

public java.lang.Object getHostNames();

• Type: com.aliyun.ros.cdk.core.IResolvable OR java.util.List

Property hostNames: The hostname of instance N.

You can use this parameter to specify different hostnames for multiple instances. Take note of the following items:

• The maximum value of N must be the same as the Amount value. For example, if you set Amount to 2, you can use HostNames.1 and HostNames.2 to specify hostnames for the individual instances. Examples: HostNames.1=test1 and HostNames.2=test2.
• You cannot specify both HostName and HostNames.N.
• The hostname cannot start or end with a period (.) or hyphen (-). The hostname cannot contain consecutive periods (.) or hyphens (-).
• For Windows instances, the hostname must be 2 to 15 characters in length and cannot contain periods (.) or contain only digits. The hostname can contain letters, digits, and hyphens (-).
• For instances that run other operating systems such as Linux, the hostname must be 2 to 64 characters in length. You can use periods (.) to separate a hostname into multiple segments. Each segment can contain letters, digits, and hyphens (-).

hpcClusterId^Optional

public java.lang.Object getHpcClusterId();

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property hpcClusterId: The HPC cluster ID to which the instance belongs.The change of the property does not affect existing instances.

httpEndpoint^Optional

public java.lang.Object getHttpEndpoint();

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property httpEndpoint: Specifies whether the access channel is enabled for instance metadata.

Valid values:

• enabled
• disabled Default value: enabled.

httpTokens^Optional

public java.lang.Object getHttpTokens();

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property httpTokens: Specifies whether the security hardening mode (IMDSv2) is forcefully used to access instance metadata.

Valid values:

• optional: does not forcefully use the security-enhanced mode (IMDSv2).
• required: forcefully uses the security-enhanced mode (IMDSv2). After you set this parameter to required, you cannot access instance metadata in normal mode. Default value: optional.

imageFamily^Optional

public java.lang.Object getImageFamily();

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property imageFamily: The name of the image family.

You can set this parameter to obtain the latest available custom image from the specified image family to create the instance.

• ImageFamily must be empty if ImageId is specified.
• ImageFamily can be specified if ImageId is not specified.

imageId^Optional

public java.lang.Object getImageId();

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property imageId: The image ID.

public java.lang.Object getImageOptions();

public java.lang.Object getInstanceChargeType();

public java.lang.Object getInstanceName();

public java.lang.Object getInternetChargeType();

public java.lang.Object getInternetMaxBandwidthOut();

public java.lang.Object getIoOptimized();

public java.lang.Object getIpv6AddressCount();

public java.lang.Object getIpv6Addresses();

public java.lang.Object getKeyPairName();

public java.lang.Object getLaunchTemplateId();

public java.lang.Object getLaunchTemplateName();

public java.lang.Object getLaunchTemplateVersion();

public java.lang.Object getNetworkInterfaceQueueNumber();

public java.lang.Object getNetworkOptions();

public java.lang.Object getNetworkType();

public java.lang.Object getPassword();

public java.lang.Object getPasswordInherit();

public java.lang.Object getPeriod();

public java.lang.Object getPeriodUnit();

public java.lang.Object getPrivateIpAddress();

public java.lang.Object getPrivatePoolOptions();

public java.lang.Object getRamRoleName();

public java.lang.Object getResourceGroupId();

public java.lang.Object getSchedulerOptions();

public java.lang.Object getSecurityEnhancementStrategy();

public java.lang.Object getSecurityGroupId();

public java.lang.Object getSecurityGroupIds();

public java.lang.Object getSecurityOptions();

public java.lang.Object getSpotDuration();

public java.lang.Object getSpotInterruptionBehavior();

public java.lang.Object getSpotPriceLimit();

public java.lang.Object getSpotStrategy();

public java.lang.Object getStorageSetId();

public java.lang.Object getStorageSetPartitionNumber();

public java.lang.Object getSubscriptionDeletionForce();

public java.lang.Object getSystemDiskAutoSnapshotPolicyId();

public java.lang.Object getSystemDiskBurstingEnabled();

public java.lang.Object getSystemDiskCategory();

public java.lang.Object getSystemDiskDescription();

public java.lang.Object getSystemDiskDiskName();

public java.lang.Object getSystemDiskEncryptAlgorithm();

public java.lang.Object getSystemDiskEncrypted();

public java.lang.Object getSystemDiskKmsKeyId();

public java.lang.Object getSystemDiskPerformanceLevel();

public java.lang.Object getSystemDiskProvisionedIops();

public java.lang.Object getSystemDiskSize();

public java.lang.Object getSystemDiskStorageClusterId();

public java.util.List<TagsProperty> getTags();

public java.lang.Object getTenancy();

public java.lang.Object getUniqueSuffix();

public java.lang.Object getUpdatePolicy();

public java.lang.Object getUseAdditionalService();

public java.lang.Object getUserData();

public java.lang.Object getVpcId();

public java.lang.Object getVSwitchId();

public java.lang.Object getZoneId();

public java.lang.Object getZoneIds();