Elastic High Performance Computing:ApplyNodes

The ID of the E-HPC cluster.

You can call the ListClusters operation to query the cluster ID.

The image ID of the compute nodes to be added. The parameter takes effect only when the TargetImageId parameter is not specified.

You can call the ListImages and ListCustomImages operations to query the image ID.

The preemption policy of the compute nodes. Valid values:

• NoSpot: The compute nodes are pay-as-you-go instances.
• SpotWithPriceLimit: The compute nodes are preemptible instances that have a user-defined maximum hourly price.
• SpotAsPriceGo: The compute nodes are preemptible instances for which the market price at the time of purchase is used as the bid price.

Default value: NoSpot.

The maximum hourly price of the compute nodes. The value is a floating-point number that supports up to three decimal places. The parameter takes effect only when ComputeSpotStrategy is set to SpotWithPriceLimit.

If ComputeSpotPriceLimit and InstanceTypeModel.N.MaxPrice are specified at the same time, compute nodes are created based on the smaller value of the two parameters.

The type of the system disk. Valid values:

• cloud_efficiency: ultra disk
• cloud_ssd: SSD
• cloud_essd: enhanced SSD (ESSD)
• cloud: basic disk. Disks of this type are retired.

The size of the system disk. Unit: GB.

Valid values: 40 to 500.

Default value: 40.

The prefix of the hostname. You can specify the parameter to manage the compute nodes in an efficient manner.

The suffix of the hostname. You can specify the parameter to manage the compute nodes in an efficient manner.

Specifies whether to allocate a public IP address to the compute nodes. Valid values:

• true: A public IP address is allocated to the compute nodes.
• false: A public IP address is not allocated to the compute nodes.

Default value: false.

The billing method of the elastic IP address (EIP). Valid values:

• PayByBandwidth: pay-by-bandwidth
• PayByTraffic: pay-by-traffic

The maximum inbound public bandwidth. Unit: Mbit/s. Valid values:

• If the purchased outbound public bandwidth is less than or equal to 10 Mbit/s, the valid values of the parameter are 1 to 10 and the default value is 10.
• If the purchased outbound public bandwidth is greater than 10 Mbit/s, the valid values of this parameter are 1 to the amount of the outbound bandwidth that is purchased. The default value is the value of the InternetMaxBandWidthOut parameter.

The maximum outbound public bandwidth. Unit: Mbit/s. Valid values: 0 to 100.

Default value: 0.

The number of vCPUs. The parameter is required when the ResourceAmountType parameter is set to Cores.

You can set vCPU and Memory to query node specifications. For example, you can query the available compute nodes that have 2 vCPUs and 16 GB of memory by setting vCPU to 2 and Memory to 16. You can also query compute nodes by node specification and zone. Query results are sorted by price. The nodes that have the lowest price are created.

The memory capacity. The parameter is required when the ResourceAmountType parameter is set to Cores. Unit: GB.

You can set vCPU and Memory to query node specifications. For example, you can query the available compute nodes that have 2 vCPUs and 16 GB of memory by setting vCPU to 2 and Memory to 16. You can also query compute nodes by node specification and zone. Query results are sorted by price. The nodes that have the lowest price are created.

The level of the instance family. The parameter takes effect only when Cores and Memory are specified. Valid values:

• EntryLevel
• EnterpriseLevel
• CreditEntryLevel For more information, see Overview of burstable instances.

Default value: EnterpriseLevel.

The amount of the resource that you want to add. The specific number depends on the value of the ResourceAmountType parameter:

• If ResourceAmountType is set to Instance, the value range of TargetCapacity is 1 to 200.
• If ResourceAmountType is set to Cores, the value range of TargetCapacity is 1 to 1,000.

The type of the resource that you want to add. Valid values:

• Instances: the ECS instances that are used as compute nodes
• Cores: vCPU and memory

Default value: Instances.

The application policy of the preemptible nodes. Valid values:

• LowPriceResourcePlanning: Preemptible nodes are created based on the unit prices of vCPUs in ascending order. Preemptible nodes are created first when multiple preemptible instance types are specified.
• CapacityOptResourcePlanning: Preemptible nodes are created based on the prices and release rates in ascending order.
• CustomizedResourcePlanning: Nodes are added based on the predefined value of the ZoneIds.N parameter. Instances of a zone that has a higher priority are used first.

Specifies whether to meet the requirements of the TargetCapacity parameter. Valid values:

• true: If the available resources are fewer than the resources that you want to add, no compute nodes are created and an error is returned. If the available resources are more than the resources that you want to add, the following cases may occur:

  • If StrictResourceProvision is set to true, check the inventory of the resources. Compute nodes are created based on the value of the TargetCapacity parameter only when the available resources are sufficient. Otherwise, no compute nodes are created.
  • If StrictResourceProvision is set to false, check the inventory of the resources. Compute nodes are created only when the available resources are sufficient. However, some compute nodes may fail to be created because resources become insufficient after the inventory query.

• false: If the available resources are insufficient, compute nodes are created based on the inventory of the resources.

Default value: true.

The performance level of the ESSD that you want to use as the system disk. Valid values:

• PL0: A single ESSD can deliver up to 10,000 random read/write IOPS.
• PL1: A single ESSD can deliver up to 50,000 IOPS of random read/write.
• PL2: A single ESSD can deliver up to 100,000 random read/write IOPS.
• PL3: A single ESSD can deliver up to 1,000,000 random read/write IOPS.

Default value: PL0. For more information, see ESSDs .

Specifies whether to strictly meet the requirements of the TargetCapacity parameter. The parameter takes effect only when StrictSatisfiedTargetCapacity is set to true. Valid values:

• true: Check the inventory of the resources. Compute nodes are created based on the value of the TargetCapacity parameter only when the available resources are sufficient. Otherwise, no compute nodes are created.
• false: Check the inventory of the resources. Compute nodes are created only when the available resources are sufficient. However, some compute nodes may fail to be created because resources become insufficient after the inventory query.

Default value: false.

The total number of batches to create nodes. Valid values: 1 to 10.

Default value: 1.

The interval between two consecutive batches. Valid values: 60 to 600. Unit: seconds.

Default value: 60.

The details of the zones. You can specify up to 10 zones.

The information about the preemptible instance.

The details about the tags that are added to the nodes.

The queue to which the compute nodes are added.

You can call the ListQueues operation to query the queue name.

The user data of the instance. The user data must be Base64-encoded. The raw data can be up to 16 KB in size. Linux operating systems support shell scripts. Windows operating systems support bat and Powershell scripts. Before you perform Base64 encoding, make sure that the content to be encoded includes [bat] or [powershell] as the first row.