CreateCluster

The operation that you want to perform. Set the value to CreateCluster.

The ID of the zone.

You can call the ListRegions and DescribeZones operations to query IDs of the zones where E-HPC is supported.

The name of the cluster. The name must be 2 to 64 characters in length.

The description of the cluster. The description must be 2 to 256 characters in length. It cannot start with http:// or https://.

The version of E-HPC. By default, the parameter is set to the latest version number.

The version of the E-HPC client. By default, the parameter is set to the latest version number.

You can call the ListCurrentClientVersion operation to query the current version of the E-HPC client.

The image tag of the operating system.

The service type of the domain account. Valid values:

• nis
• ldap

Default value: nis

The type of the scheduler. Valid values:

• pbs
• slurm
• opengridscheduler
• deadline

Default value: pbs

The ID of the security group to which the cluster belongs.

You can call the DescribeSecurityGroups operation to query available security groups in the current region.

If you do not use an existing security group, set the parameter to the name of a new security group. A default policy is applied to the new security group.

The ID of the virtual private cloud (VPC) to which the cluster belongs.

You can call the DescribeVpcs operation to query available VPCs.

The ID of the vSwitch. E-HPC supports only VPC networks.

You can call the DescribeVSwitches operation to query available vSwitches.

The type of the shared storage. Only Apsara File Storage NAS file systems are supported.

The ID of the file system. If you leave the parameter empty, a Performance NAS file system is created by default.

You can call the ListFileSystemWithMountTargets operation to query available mount targets.

The type of the protocol that is used by the file system. Valid values:

• NFS
• SMB

Default value: NFS

The mount target of the file system. Take note of the following information:

• If you do not specify the VolumeId parameter, you can leave the VolumeMountpoint parameter empty. A mount target is created by default.
• If you specify the VolumeId parameter, the VolumeMountpoint parameter is required. You can call the ListFileSystemWithMountTargets operation to query available mount targets.

The remote directory to which the file system is mounted.

The mode in which the cluster is deployed. Valid values:

• Standard: An account node, a scheduling node, a logon node, and multiple compute nodes are separately deployed.
• Simple: A management node, a logon node, and multiple compute nodes are deployed. The management node consists of an account node and a scheduling node. The logon node and compute nodes are separately deployed.
• Tiny: A management node and multiple compute nodes are deployed. The management node consists of an account node, a scheduling node, and a logon node. The compute nodes are separately deployed.

Default value: Standard

Specifies whether to enable the high availability feature. Valid values:

• true: enables the high availability feature
• false: disable the high availability feature

Default value: false

The billing method of the nodes. Valid values:

• PostPaid: pay-as-you-go
• PrePaid: subscription

If you set the parameter to PrePaid, auto-renewal is enabled by default.

The root password of the logon node. The password must be 8 to 30 characters in length and contain at least three of the following items: uppercase letters, lowercase letters, digits, and special characters. The password can contain the following special characters:

You must specify either Password or KeyPairName. If both are specified, the Password parameter prevails.

The name of the AccessKey pair.

The type of the image. Valid values:

• system: public image
• self: custom image
• others: shared image

Default value: system

The ID of the image.

You can call the ListImages and ListCustomImages operations to query the images that are supported by E-HPC.

The number of the management nodes. Valid values: 1 and 2.

The instance type of the management nodes.

You can call the ListPreferredEcsTypes operation to query the recommended instance types.

The number of the compute nodes. Valid values: 1 to 99.

The instance type of the compute nodes.

You can call the ListPreferredEcsTypes operation to query the recommended instance types.

The number of the logon nodes. Valid value: 1.

The instance type of the logon nodes.

You can call the ListPreferredEcsTypes operation to query the recommended instance types.

The ID of the Super Computing Cluster (SCC) instance.

If you specify the parameter, the SCC instance is moved to a new SCC cluster.

The bidding method 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. A maximum of three decimal places can be used in the value of the parameter. The parameter is valid only when the ComputeSpotStrategy parameter is set to SpotWithPriceLimit.

Specifies whether the compute nodes support hyper-threading. Valid values:

• true: Hyper-threading is supported.
• false: Hyper-threading is not supported.

Default value: true

The duration of the subscription. The unit of the duration is specified by the PeriodUnit parameter.

• If PriceUnit is set to Year, the valid values of the Period parameter are 1, 2, and 3.
• If PriceUnit is set to Month, the valid values of the Period parameter are 1, 2, 3, 4, 5, 6, 7, 8, and 9.
• If PriceUnit is set to Hour, the valid value of the Period parameter is 1.

Default value: 1

The unit of the subscription duration. Valid values:

• Year
• Month
• Hour

Default value: Month

Specifies whether to enable auto-renewal for the subscription. Valid values:

• true: enables auto-renewal
• false: disables auto-renewal

Default value: false

The auto-renewal period of the subscription compute nodes. The parameter takes effect when AutoRenew is set to true.

The URL of the job files that are uploaded to an Object Storage Service (OSS) bucket.

The queue to which the compute nodes are added.

The category of the system disk. Valid values:

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

Default value: cloud_ssd

The size of the system disk. Unit: GB

Valid values: 40 to 500

Default value: 40

Specifies whether to enable Virtual Network Computing (VNC). Valid values:

• true: enables VNC
• false: disables VNC

Default value: false

The ID of the resource group.

You can call the ListResourceGroups operation to obtain the ID of the resource group.

The client token that is used to ensure the idempotence of the request. You can use the client to generate the value, but you must ensure that it is unique among different requests. The token can contain only ASCII characters and cannot exceed 64 characters in length. For more information, see How to ensure the idempotence of a request.

Specifies whether the logon node uses an elastic IP address (EIP). Default value: false

The performance level of the ESSD that is used 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: PL1

For more information, see ESSDs.

Specifies whether to enable auto scaling. Valid values:

• true: enables auto scaling
• false: disables auto scaling

Default value: false

The version of the cluster.

Default value: 1.0

The mode configurations of the plug-in. This parameter takes effect only when the SchedulerType parameter is set to custom.

The value must be a JSON string. The parameter contains the following parameters: pluginMod, pluginLocalPath, and pluginOssPath.

• pluginMod: the mode of the plug-in. The following modes are supported:
  • oss: The plug-in is downloaded and decompressed from OSS to a local path. The local path is specified by the pluginLocalPath parameter.
  • image: By default, the plug-in is stored in a pre-defined local path. The local path is specified by the pluginLocalPath parameter.
• pluginLocalPath: the local path where the plug-in is stored. We recommend that you select a shared directory in oss mode and a non-shared directory in image mode.
• pluginOssPath: the remote path where the plug-in is stored in OSS. This parameter takes effect only when the pluginMod parameter is set to oss.

Specifies whether not to install the agent.

• true: The agent is not installed.
• false: The agent is installed.

Default value: false

The name of the Resource Access Management (RAM) role.

You can call the ListRoles operation provided by RAM to query the created RAM roles.

The tag of the software.

Valid values of N: 0 to 100

You can call the ListSoftwares operation to query the tag of the software.

The queue of the nodes to which the additional file system is attached.

Valid values of N: 1 to 10.

The ID of the additional file system.

Valid values of N: 1 to 10

The type of the nodes to which the additional file system is attached.

Valid values of N in AdditionalVolumes.N.Roles: 1 to 10

Valid values of N in Roles.N.Name: 0 to 8

The mount target of the additional file system.

Valid values of N: 1 to 10

The remote directory to which the additional file system is mounted.

Valid values of N: 1 to 10

The type of the additional shared storage. Only NAS file systems are supported.

Valid values of N: 1 to 10

The local directory to which the additional file system is mounted.

Valid values of N: 1 to 10

The type of the protocol that is used by the additional file system. Valid values:

• NFS
• SMB

Valid values of N: 1 to 10

Default value: NFS

The type of the cluster. Valid value: PublicCloud.

Valid values of N: 1 to 10

The parameters that are used to run the script after the cluster is created.

Valid values of N: 0 to 16

The URL that is used to download the script after the cluster is created.

Valid values of N: 0 to 16

The node of the RAM role.

Valid values of N: 0 to 3

• If the DeployMode parameter is set to Standard, the following values are valid: scheduler, account, login. Separate multiple values with commas (,).
• If the DeployMode parameter is set to Simple, the following values are valid: manager and login. Separate multiple values with commas (,).
• If the DeployMode parameter is set to Tiny, the following value is valid: manager.

The ID of the request.

The ID of the task.

The ID of the cluster.