/AWS1/CL_HPP=>CREATECLUSTER()
¶
About CreateCluster¶
Creates a cluster in your account. Amazon Web Services PCS creates the cluster controller in a service-owned account. The cluster controller communicates with the cluster resources in your account. The subnets and security groups for the cluster must already exist before you use this API action.
It takes time for Amazon Web Services PCS to create the cluster. The cluster is in
a Creating
state until it is ready to use. There can only be 1
cluster in a Creating
state per Amazon Web Services Region per Amazon Web Services account.
CreateCluster
fails with a ServiceQuotaExceededException
if there is already
a cluster in a Creating
state.
Method Signature¶
IMPORTING¶
Required arguments:¶
IV_CLUSTERNAME
TYPE /AWS1/HPPCLUSTERNAME
/AWS1/HPPCLUSTERNAME
¶
A name to identify the cluster. Example:
MyCluster
IO_SCHEDULER
TYPE REF TO /AWS1/CL_HPPSCHEDULERREQUEST
/AWS1/CL_HPPSCHEDULERREQUEST
¶
The cluster management and job scheduling software associated with the cluster.
IV_SIZE
TYPE /AWS1/HPPSIZE
/AWS1/HPPSIZE
¶
A value that determines the maximum number of compute nodes in the cluster and the maximum number of jobs (active and queued).
SMALL
: 32 compute nodes and 256 jobs
MEDIUM
: 512 compute nodes and 8192 jobs
LARGE
: 2048 compute nodes and 16,384 jobs
IO_NETWORKING
TYPE REF TO /AWS1/CL_HPPNETWORKINGREQUEST
/AWS1/CL_HPPNETWORKINGREQUEST
¶
The networking configuration used to set up the cluster's control plane.
Optional arguments:¶
IO_SLURMCONFIGURATION
TYPE REF TO /AWS1/CL_HPPCLUSTSLURMCONFREQ
/AWS1/CL_HPPCLUSTSLURMCONFREQ
¶
Additional options related to the Slurm scheduler.
IV_CLIENTTOKEN
TYPE /AWS1/HPPSBCLIENTTOKEN
/AWS1/HPPSBCLIENTTOKEN
¶
A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. Idempotency ensures that an API request completes only once. With an idempotent request, if the original request completes successfully, the subsequent retries with the same client token return the result from the original successful request and they have no additional effect. If you don't specify a client token, the CLI and SDK automatically generate 1 for you.
IT_TAGS
TYPE /AWS1/CL_HPPREQUESTTAGMAP_W=>TT_REQUESTTAGMAP
TT_REQUESTTAGMAP
¶
1 or more tags added to the resource. Each tag consists of a tag key and tag value. The tag value is optional and can be an empty string.