Skip to content

/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.

RETURNING

OO_OUTPUT TYPE REF TO /AWS1/CL_HPPCREATECLUSTERRSP /AWS1/CL_HPPCREATECLUSTERRSP