2025/06/02 - AWS Parallel Computing Service - 11 updated api methods
Changes Introduces SUSPENDING and SUSPENDED states for clusters, compute node groups, and queues.
{'cluster': {'status': {'SUSPENDED', 'SUSPENDING'}}}
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.
See also: AWS API Documentation
Request Syntax
client.create_cluster( clusterName='string', scheduler={ 'type': 'SLURM', 'version': 'string' }, size='SMALL'|'MEDIUM'|'LARGE', networking={ 'subnetIds': [ 'string', ], 'securityGroupIds': [ 'string', ] }, slurmConfiguration={ 'scaleDownIdleTimeInSeconds': 123, 'slurmCustomSettings': [ { 'parameterName': 'string', 'parameterValue': 'string' }, ], 'accounting': { 'mode': 'STANDARD'|'NONE', 'defaultPurgeTimeInDays': 123 } }, clientToken='string', tags={ 'string': 'string' } )
string
[REQUIRED]
A name to identify the cluster. Example: MyCluster
dict
[REQUIRED]
The cluster management and job scheduling software associated with the cluster.
type (string) -- [REQUIRED]
The software Amazon Web Services PCS uses to manage cluster scaling and job scheduling.
version (string) -- [REQUIRED]
The version of the specified scheduling software that Amazon Web Services PCS uses to manage cluster scaling and job scheduling. For more information, see Slurm versions in Amazon Web Services PCS in the Amazon Web Services PCS User Guide.
Valid Values: 23.11 | 24.05 | 24.11
string
[REQUIRED]
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
dict
[REQUIRED]
The networking configuration used to set up the cluster's control plane.
subnetIds (list) --
The list of subnet IDs where Amazon Web Services PCS creates an Elastic Network Interface (ENI) to enable communication between managed controllers and Amazon Web Services PCS resources. Subnet IDs have the form subnet-0123456789abcdef0.
Subnets can't be in Outposts, Wavelength or an Amazon Web Services Local Zone.
(string) --
securityGroupIds (list) --
A list of security group IDs associated with the Elastic Network Interface (ENI) created in subnets.
(string) --
dict
Additional options related to the Slurm scheduler.
scaleDownIdleTimeInSeconds (integer) --
The time (in seconds) before an idle node is scaled down.
Default: 600
slurmCustomSettings (list) --
Additional Slurm-specific configuration that directly maps to Slurm settings.
(dict) --
Additional settings that directly map to Slurm settings.
parameterName (string) -- [REQUIRED]
Amazon Web Services PCS supports configuration of the following Slurm parameters:
For clusters
For compute node groups
parameterValue (string) -- [REQUIRED]
The values for the configured Slurm settings.
accounting (dict) --
The accounting configuration includes configurable settings for Slurm accounting.
mode (string) -- [REQUIRED]
The default value for mode is STANDARD. A value of STANDARD means Slurm accounting is enabled.
defaultPurgeTimeInDays (integer) --
The default value for all purge settings for slurmdbd.conf. For more information, see the slurmdbd.conf documentation at SchedMD.
The default value for defaultPurgeTimeInDays is -1.
A value of -1 means there is no purge time and records persist as long as the cluster exists.
string
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.
This field is autopopulated if not provided.
dict
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.
(string) --
(string) --
dict
Response Syntax
{ 'cluster': { 'name': 'string', 'id': 'string', 'arn': 'string', 'status': 'CREATING'|'ACTIVE'|'UPDATING'|'DELETING'|'CREATE_FAILED'|'DELETE_FAILED'|'UPDATE_FAILED'|'SUSPENDING'|'SUSPENDED', 'createdAt': datetime(2015, 1, 1), 'modifiedAt': datetime(2015, 1, 1), 'scheduler': { 'type': 'SLURM', 'version': 'string' }, 'size': 'SMALL'|'MEDIUM'|'LARGE', 'slurmConfiguration': { 'scaleDownIdleTimeInSeconds': 123, 'slurmCustomSettings': [ { 'parameterName': 'string', 'parameterValue': 'string' }, ], 'authKey': { 'secretArn': 'string', 'secretVersion': 'string' }, 'accounting': { 'mode': 'STANDARD'|'NONE', 'defaultPurgeTimeInDays': 123 } }, 'networking': { 'subnetIds': [ 'string', ], 'securityGroupIds': [ 'string', ] }, 'endpoints': [ { 'type': 'SLURMCTLD'|'SLURMDBD', 'privateIpAddress': 'string', 'publicIpAddress': 'string', 'port': 'string' }, ], 'errorInfo': [ { 'code': 'string', 'message': 'string' }, ] } }
Response Structure
(dict) --
cluster (dict) --
The cluster resource.
name (string) --
The name that identifies the cluster.
id (string) --
The generated unique ID of the cluster.
arn (string) --
The unique Amazon Resource Name (ARN) of the cluster.
status (string) --
The provisioning status of the cluster.
createdAt (datetime) --
The date and time the resource was created.
modifiedAt (datetime) --
The date and time the resource was modified.
scheduler (dict) --
The cluster management and job scheduling software associated with the cluster.
type (string) --
The software Amazon Web Services PCS uses to manage cluster scaling and job scheduling.
version (string) --
The version of the specified scheduling software that Amazon Web Services PCS uses to manage cluster scaling and job scheduling. For more information, see Slurm versions in Amazon Web Services PCS in the Amazon Web Services PCS User Guide.
Valid Values: 23.11 | 24.05 | 24.11
size (string) --
The size of the cluster.
SMALL: 32 compute nodes and 256 jobs
MEDIUM: 512 compute nodes and 8192 jobs
LARGE: 2048 compute nodes and 16,384 jobs
slurmConfiguration (dict) --
Additional options related to the Slurm scheduler.
scaleDownIdleTimeInSeconds (integer) --
The time (in seconds) before an idle node is scaled down.
Default: 600
slurmCustomSettings (list) --
Additional Slurm-specific configuration that directly maps to Slurm settings.
(dict) --
Additional settings that directly map to Slurm settings.
parameterName (string) --
Amazon Web Services PCS supports configuration of the following Slurm parameters:
For clusters
For compute node groups
parameterValue (string) --
The values for the configured Slurm settings.
authKey (dict) --
The shared Slurm key for authentication, also known as the cluster secret.
secretArn (string) --
The Amazon Resource Name (ARN) of the the shared Slurm key.
secretVersion (string) --
The version of the shared Slurm key.
accounting (dict) --
The accounting configuration includes configurable settings for Slurm accounting.
mode (string) --
The default value for mode is STANDARD. A value of STANDARD means Slurm accounting is enabled.
defaultPurgeTimeInDays (integer) --
The default value for all purge settings for slurmdbd.conf. For more information, see the slurmdbd.conf documentation at SchedMD.
The default value for defaultPurgeTimeInDays is -1.
A value of -1 means there is no purge time and records persist as long as the cluster exists.
networking (dict) --
The networking configuration for the cluster's control plane.
subnetIds (list) --
The ID of the subnet where Amazon Web Services PCS creates an Elastic Network Interface (ENI) to enable communication between managed controllers and Amazon Web Services PCS resources. The subnet must have an available IP address, cannot reside in AWS Outposts, AWS Wavelength, or an AWS Local Zone.
Example: subnet-abcd1234
(string) --
securityGroupIds (list) --
The list of security group IDs associated with the Elastic Network Interface (ENI) created in subnets.
The following rules are required:
Inbound rule 1
Protocol: All
Ports: All
Source: Self
Outbound rule 1
Protocol: All
Ports: All
Destination: 0.0.0.0/0 (IPv4)
Outbound rule 2
Protocol: All
Ports: All
Destination: Self
(string) --
endpoints (list) --
The list of endpoints available for interaction with the scheduler.
(dict) --
An endpoint available for interaction with the scheduler.
type (string) --
Indicates the type of endpoint running at the specific IP address.
privateIpAddress (string) --
The endpoint's private IP address.
Example: 2.2.2.2
publicIpAddress (string) --
The endpoint's public IP address.
Example: 1.1.1.1
port (string) --
The endpoint's connection port number.
Example: 1234
errorInfo (list) --
The list of errors that occurred during cluster provisioning.
(dict) --
An error that occurred during resource creation.
code (string) --
The short-form error code.
message (string) --
The detailed error information.
{'computeNodeGroup': {'status': {'SUSPENDED', 'SUSPENDING'}}}
Creates a managed set of compute nodes. You associate a compute node group with a cluster through 1 or more Amazon Web Services PCS queues or as part of the login fleet. A compute node group includes the definition of the compute properties and lifecycle management. Amazon Web Services PCS uses the information you provide to this API action to launch compute nodes in your account. You can only specify subnets in the same Amazon VPC as your cluster. You receive billing charges for the compute nodes that Amazon Web Services PCS launches in your account. You must already have a launch template before you call this API. For more information, see Launch an instance from a launch template in the Amazon Elastic Compute Cloud User Guide for Linux Instances.
See also: AWS API Documentation
Request Syntax
client.create_compute_node_group( clusterIdentifier='string', computeNodeGroupName='string', amiId='string', subnetIds=[ 'string', ], purchaseOption='ONDEMAND'|'SPOT', customLaunchTemplate={ 'id': 'string', 'version': 'string' }, iamInstanceProfileArn='string', scalingConfiguration={ 'minInstanceCount': 123, 'maxInstanceCount': 123 }, instanceConfigs=[ { 'instanceType': 'string' }, ], spotOptions={ 'allocationStrategy': 'lowest-price'|'capacity-optimized'|'price-capacity-optimized' }, slurmConfiguration={ 'slurmCustomSettings': [ { 'parameterName': 'string', 'parameterValue': 'string' }, ] }, clientToken='string', tags={ 'string': 'string' } )
string
[REQUIRED]
The name or ID of the cluster to create a compute node group in.
string
[REQUIRED]
A name to identify the cluster. Example: MyCluster
string
The ID of the Amazon Machine Image (AMI) that Amazon Web Services PCS uses to launch compute nodes (Amazon EC2 instances). If you don't provide this value, Amazon Web Services PCS uses the AMI ID specified in the custom launch template.
list
[REQUIRED]
The list of subnet IDs where the compute node group launches instances. Subnets must be in the same VPC as the cluster.
(string) --
string
Specifies how EC2 instances are purchased on your behalf. Amazon Web Services PCS supports On-Demand and Spot instances. For more information, see Instance purchasing options in the Amazon Elastic Compute Cloud User Guide. If you don't provide this option, it defaults to On-Demand.
dict
[REQUIRED]
An Amazon EC2 launch template Amazon Web Services PCS uses to launch compute nodes.
id (string) -- [REQUIRED]
The ID of the EC2 launch template to use to provision instances.
Example: lt-xxxx
version (string) -- [REQUIRED]
The version of the EC2 launch template to use to provision instances.
string
[REQUIRED]
The Amazon Resource Name (ARN) of the IAM instance profile used to pass an IAM role when launching EC2 instances. The role contained in your instance profile must have the pcs:RegisterComputeNodeGroupInstance permission. The resource identifier of the ARN must start with AWSPCS or it must have /aws-pcs/ in its path.
Examples
arn:aws:iam::111122223333:instance-profile/AWSPCS-example-role-1
arn:aws:iam::111122223333:instance-profile/aws-pcs/example-role-2
dict
[REQUIRED]
Specifies the boundaries of the compute node group auto scaling.
minInstanceCount (integer) -- [REQUIRED]
The lower bound of the number of instances allowed in the compute fleet.
maxInstanceCount (integer) -- [REQUIRED]
The upper bound of the number of instances allowed in the compute fleet.
list
[REQUIRED]
A list of EC2 instance configurations that Amazon Web Services PCS can provision in the compute node group.
(dict) --
An EC2 instance configuration Amazon Web Services PCS uses to launch compute nodes.
instanceType (string) --
The EC2 instance type that Amazon Web Services PCS can provision in the compute node group.
Example: t2.xlarge
dict
Additional configuration when you specify SPOT as the purchaseOption for the CreateComputeNodeGroup API action.
allocationStrategy (string) --
The Amazon EC2 allocation strategy Amazon Web Services PCS uses to provision EC2 instances. Amazon Web Services PCS supports lowest price, capacity optimized, and price capacity optimized. For more information, see Use allocation strategies to determine how EC2 Fleet or Spot Fleet fulfills Spot and On-Demand capacity in the Amazon Elastic Compute Cloud User Guide. If you don't provide this option, it defaults to price capacity optimized.
dict
Additional options related to the Slurm scheduler.
slurmCustomSettings (list) --
Additional Slurm-specific configuration that directly maps to Slurm settings.
(dict) --
Additional settings that directly map to Slurm settings.
parameterName (string) -- [REQUIRED]
Amazon Web Services PCS supports configuration of the following Slurm parameters:
For clusters
For compute node groups
parameterValue (string) -- [REQUIRED]
The values for the configured Slurm settings.
string
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.
This field is autopopulated if not provided.
dict
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.
(string) --
(string) --
dict
Response Syntax
{ 'computeNodeGroup': { 'name': 'string', 'id': 'string', 'arn': 'string', 'clusterId': 'string', 'createdAt': datetime(2015, 1, 1), 'modifiedAt': datetime(2015, 1, 1), 'status': 'CREATING'|'ACTIVE'|'UPDATING'|'DELETING'|'CREATE_FAILED'|'DELETE_FAILED'|'UPDATE_FAILED'|'DELETED'|'SUSPENDING'|'SUSPENDED', 'amiId': 'string', 'subnetIds': [ 'string', ], 'purchaseOption': 'ONDEMAND'|'SPOT', 'customLaunchTemplate': { 'id': 'string', 'version': 'string' }, 'iamInstanceProfileArn': 'string', 'scalingConfiguration': { 'minInstanceCount': 123, 'maxInstanceCount': 123 }, 'instanceConfigs': [ { 'instanceType': 'string' }, ], 'spotOptions': { 'allocationStrategy': 'lowest-price'|'capacity-optimized'|'price-capacity-optimized' }, 'slurmConfiguration': { 'slurmCustomSettings': [ { 'parameterName': 'string', 'parameterValue': 'string' }, ] }, 'errorInfo': [ { 'code': 'string', 'message': 'string' }, ] } }
Response Structure
(dict) --
computeNodeGroup (dict) --
A compute node group associated with a cluster.
name (string) --
The name that identifies the compute node group.
id (string) --
The generated unique ID of the compute node group.
arn (string) --
The unique Amazon Resource Name (ARN) of the compute node group.
clusterId (string) --
The ID of the cluster of the compute node group.
createdAt (datetime) --
The date and time the resource was created.
modifiedAt (datetime) --
The date and time the resource was modified.
status (string) --
The provisioning status of the compute node group.
amiId (string) --
The ID of the Amazon Machine Image (AMI) that Amazon Web Services PCS uses to launch instances. If not provided, Amazon Web Services PCS uses the AMI ID specified in the custom launch template.
subnetIds (list) --
The list of subnet IDs where instances are provisioned by the compute node group. The subnets must be in the same VPC as the cluster.
(string) --
purchaseOption (string) --
Specifies how EC2 instances are purchased on your behalf. Amazon Web Services PCS supports On-Demand and Spot instances. For more information, see Instance purchasing options in the Amazon Elastic Compute Cloud User Guide. If you don't provide this option, it defaults to On-Demand.
customLaunchTemplate (dict) --
An Amazon EC2 launch template Amazon Web Services PCS uses to launch compute nodes.
id (string) --
The ID of the EC2 launch template to use to provision instances.
Example: lt-xxxx
version (string) --
The version of the EC2 launch template to use to provision instances.
iamInstanceProfileArn (string) --
The Amazon Resource Name (ARN) of the IAM instance profile used to pass an IAM role when launching EC2 instances. The role contained in your instance profile must have the pcs:RegisterComputeNodeGroupInstance permission. The resource identifier of the ARN must start with AWSPCS or it must have /aws-pcs/ in its path.
Examples
arn:aws:iam::111122223333:instance-profile/AWSPCS-example-role-1
arn:aws:iam::111122223333:instance-profile/aws-pcs/example-role-2
scalingConfiguration (dict) --
Specifies the boundaries of the compute node group auto scaling.
minInstanceCount (integer) --
The lower bound of the number of instances allowed in the compute fleet.
maxInstanceCount (integer) --
The upper bound of the number of instances allowed in the compute fleet.
instanceConfigs (list) --
A list of EC2 instance configurations that Amazon Web Services PCS can provision in the compute node group.
(dict) --
An EC2 instance configuration Amazon Web Services PCS uses to launch compute nodes.
instanceType (string) --
The EC2 instance type that Amazon Web Services PCS can provision in the compute node group.
Example: t2.xlarge
spotOptions (dict) --
Additional configuration when you specify SPOT as the purchaseOption for the CreateComputeNodeGroup API action.
allocationStrategy (string) --
The Amazon EC2 allocation strategy Amazon Web Services PCS uses to provision EC2 instances. Amazon Web Services PCS supports lowest price, capacity optimized, and price capacity optimized. For more information, see Use allocation strategies to determine how EC2 Fleet or Spot Fleet fulfills Spot and On-Demand capacity in the Amazon Elastic Compute Cloud User Guide. If you don't provide this option, it defaults to price capacity optimized.
slurmConfiguration (dict) --
Additional options related to the Slurm scheduler.
slurmCustomSettings (list) --
Additional Slurm-specific configuration that directly maps to Slurm settings.
(dict) --
Additional settings that directly map to Slurm settings.
parameterName (string) --
Amazon Web Services PCS supports configuration of the following Slurm parameters:
For clusters
For compute node groups
parameterValue (string) --
The values for the configured Slurm settings.
errorInfo (list) --
The list of errors that occurred during compute node group provisioning.
(dict) --
An error that occurred during resource creation.
code (string) --
The short-form error code.
message (string) --
The detailed error information.
{'queue': {'status': {'SUSPENDED', 'SUSPENDING'}}}
Creates a job queue. You must associate 1 or more compute node groups with the queue. You can associate 1 compute node group with multiple queues.
See also: AWS API Documentation
Request Syntax
client.create_queue( clusterIdentifier='string', queueName='string', computeNodeGroupConfigurations=[ { 'computeNodeGroupId': 'string' }, ], clientToken='string', tags={ 'string': 'string' } )
string
[REQUIRED]
The name or ID of the cluster for which to create a queue.
string
[REQUIRED]
A name to identify the queue.
list
The list of compute node group configurations to associate with the queue. Queues assign jobs to associated compute node groups.
(dict) --
The compute node group configuration for a queue.
computeNodeGroupId (string) --
The compute node group ID for the compute node group configuration.
string
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.
This field is autopopulated if not provided.
dict
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.
(string) --
(string) --
dict
Response Syntax
{ 'queue': { 'name': 'string', 'id': 'string', 'arn': 'string', 'clusterId': 'string', 'createdAt': datetime(2015, 1, 1), 'modifiedAt': datetime(2015, 1, 1), 'status': 'CREATING'|'ACTIVE'|'UPDATING'|'DELETING'|'CREATE_FAILED'|'DELETE_FAILED'|'UPDATE_FAILED'|'SUSPENDING'|'SUSPENDED', 'computeNodeGroupConfigurations': [ { 'computeNodeGroupId': 'string' }, ], 'errorInfo': [ { 'code': 'string', 'message': 'string' }, ] } }
Response Structure
(dict) --
queue (dict) --
A queue resource.
name (string) --
The name that identifies the queue.
id (string) --
The generated unique ID of the queue.
arn (string) --
The unique Amazon Resource Name (ARN) of the queue.
clusterId (string) --
The ID of the cluster of the queue.
createdAt (datetime) --
The date and time the resource was created.
modifiedAt (datetime) --
The date and time the resource was modified.
status (string) --
The provisioning status of the queue.
computeNodeGroupConfigurations (list) --
The list of compute node group configurations associated with the queue. Queues assign jobs to associated compute node groups.
(dict) --
The compute node group configuration for a queue.
computeNodeGroupId (string) --
The compute node group ID for the compute node group configuration.
errorInfo (list) --
The list of errors that occurred during queue provisioning.
(dict) --
An error that occurred during resource creation.
code (string) --
The short-form error code.
message (string) --
The detailed error information.
{'cluster': {'status': {'SUSPENDED', 'SUSPENDING'}}}
Returns detailed information about a running cluster in your account. This API action provides networking information, endpoint information for communication with the scheduler, and provisioning status.
See also: AWS API Documentation
Request Syntax
client.get_cluster( clusterIdentifier='string' )
string
[REQUIRED]
The name or ID of the cluster of the queue.
dict
Response Syntax
{ 'cluster': { 'name': 'string', 'id': 'string', 'arn': 'string', 'status': 'CREATING'|'ACTIVE'|'UPDATING'|'DELETING'|'CREATE_FAILED'|'DELETE_FAILED'|'UPDATE_FAILED'|'SUSPENDING'|'SUSPENDED', 'createdAt': datetime(2015, 1, 1), 'modifiedAt': datetime(2015, 1, 1), 'scheduler': { 'type': 'SLURM', 'version': 'string' }, 'size': 'SMALL'|'MEDIUM'|'LARGE', 'slurmConfiguration': { 'scaleDownIdleTimeInSeconds': 123, 'slurmCustomSettings': [ { 'parameterName': 'string', 'parameterValue': 'string' }, ], 'authKey': { 'secretArn': 'string', 'secretVersion': 'string' }, 'accounting': { 'mode': 'STANDARD'|'NONE', 'defaultPurgeTimeInDays': 123 } }, 'networking': { 'subnetIds': [ 'string', ], 'securityGroupIds': [ 'string', ] }, 'endpoints': [ { 'type': 'SLURMCTLD'|'SLURMDBD', 'privateIpAddress': 'string', 'publicIpAddress': 'string', 'port': 'string' }, ], 'errorInfo': [ { 'code': 'string', 'message': 'string' }, ] } }
Response Structure
(dict) --
cluster (dict) --
The cluster resource.
name (string) --
The name that identifies the cluster.
id (string) --
The generated unique ID of the cluster.
arn (string) --
The unique Amazon Resource Name (ARN) of the cluster.
status (string) --
The provisioning status of the cluster.
createdAt (datetime) --
The date and time the resource was created.
modifiedAt (datetime) --
The date and time the resource was modified.
scheduler (dict) --
The cluster management and job scheduling software associated with the cluster.
type (string) --
The software Amazon Web Services PCS uses to manage cluster scaling and job scheduling.
version (string) --
The version of the specified scheduling software that Amazon Web Services PCS uses to manage cluster scaling and job scheduling. For more information, see Slurm versions in Amazon Web Services PCS in the Amazon Web Services PCS User Guide.
Valid Values: 23.11 | 24.05 | 24.11
size (string) --
The size of the cluster.
SMALL: 32 compute nodes and 256 jobs
MEDIUM: 512 compute nodes and 8192 jobs
LARGE: 2048 compute nodes and 16,384 jobs
slurmConfiguration (dict) --
Additional options related to the Slurm scheduler.
scaleDownIdleTimeInSeconds (integer) --
The time (in seconds) before an idle node is scaled down.
Default: 600
slurmCustomSettings (list) --
Additional Slurm-specific configuration that directly maps to Slurm settings.
(dict) --
Additional settings that directly map to Slurm settings.
parameterName (string) --
Amazon Web Services PCS supports configuration of the following Slurm parameters:
For clusters
For compute node groups
parameterValue (string) --
The values for the configured Slurm settings.
authKey (dict) --
The shared Slurm key for authentication, also known as the cluster secret.
secretArn (string) --
The Amazon Resource Name (ARN) of the the shared Slurm key.
secretVersion (string) --
The version of the shared Slurm key.
accounting (dict) --
The accounting configuration includes configurable settings for Slurm accounting.
mode (string) --
The default value for mode is STANDARD. A value of STANDARD means Slurm accounting is enabled.
defaultPurgeTimeInDays (integer) --
The default value for all purge settings for slurmdbd.conf. For more information, see the slurmdbd.conf documentation at SchedMD.
The default value for defaultPurgeTimeInDays is -1.
A value of -1 means there is no purge time and records persist as long as the cluster exists.
networking (dict) --
The networking configuration for the cluster's control plane.
subnetIds (list) --
The ID of the subnet where Amazon Web Services PCS creates an Elastic Network Interface (ENI) to enable communication between managed controllers and Amazon Web Services PCS resources. The subnet must have an available IP address, cannot reside in AWS Outposts, AWS Wavelength, or an AWS Local Zone.
Example: subnet-abcd1234
(string) --
securityGroupIds (list) --
The list of security group IDs associated with the Elastic Network Interface (ENI) created in subnets.
The following rules are required:
Inbound rule 1
Protocol: All
Ports: All
Source: Self
Outbound rule 1
Protocol: All
Ports: All
Destination: 0.0.0.0/0 (IPv4)
Outbound rule 2
Protocol: All
Ports: All
Destination: Self
(string) --
endpoints (list) --
The list of endpoints available for interaction with the scheduler.
(dict) --
An endpoint available for interaction with the scheduler.
type (string) --
Indicates the type of endpoint running at the specific IP address.
privateIpAddress (string) --
The endpoint's private IP address.
Example: 2.2.2.2
publicIpAddress (string) --
The endpoint's public IP address.
Example: 1.1.1.1
port (string) --
The endpoint's connection port number.
Example: 1234
errorInfo (list) --
The list of errors that occurred during cluster provisioning.
(dict) --
An error that occurred during resource creation.
code (string) --
The short-form error code.
message (string) --
The detailed error information.
{'computeNodeGroup': {'status': {'SUSPENDED', 'SUSPENDING'}}}
Returns detailed information about a compute node group. This API action provides networking information, EC2 instance type, compute node group status, and scheduler (such as Slurm) configuration.
See also: AWS API Documentation
Request Syntax
client.get_compute_node_group( clusterIdentifier='string', computeNodeGroupIdentifier='string' )
string
[REQUIRED]
The name or ID of the cluster.
string
[REQUIRED]
The name or ID of the compute node group.
dict
Response Syntax
{ 'computeNodeGroup': { 'name': 'string', 'id': 'string', 'arn': 'string', 'clusterId': 'string', 'createdAt': datetime(2015, 1, 1), 'modifiedAt': datetime(2015, 1, 1), 'status': 'CREATING'|'ACTIVE'|'UPDATING'|'DELETING'|'CREATE_FAILED'|'DELETE_FAILED'|'UPDATE_FAILED'|'DELETED'|'SUSPENDING'|'SUSPENDED', 'amiId': 'string', 'subnetIds': [ 'string', ], 'purchaseOption': 'ONDEMAND'|'SPOT', 'customLaunchTemplate': { 'id': 'string', 'version': 'string' }, 'iamInstanceProfileArn': 'string', 'scalingConfiguration': { 'minInstanceCount': 123, 'maxInstanceCount': 123 }, 'instanceConfigs': [ { 'instanceType': 'string' }, ], 'spotOptions': { 'allocationStrategy': 'lowest-price'|'capacity-optimized'|'price-capacity-optimized' }, 'slurmConfiguration': { 'slurmCustomSettings': [ { 'parameterName': 'string', 'parameterValue': 'string' }, ] }, 'errorInfo': [ { 'code': 'string', 'message': 'string' }, ] } }
Response Structure
(dict) --
computeNodeGroup (dict) --
A compute node group associated with a cluster.
name (string) --
The name that identifies the compute node group.
id (string) --
The generated unique ID of the compute node group.
arn (string) --
The unique Amazon Resource Name (ARN) of the compute node group.
clusterId (string) --
The ID of the cluster of the compute node group.
createdAt (datetime) --
The date and time the resource was created.
modifiedAt (datetime) --
The date and time the resource was modified.
status (string) --
The provisioning status of the compute node group.
amiId (string) --
The ID of the Amazon Machine Image (AMI) that Amazon Web Services PCS uses to launch instances. If not provided, Amazon Web Services PCS uses the AMI ID specified in the custom launch template.
subnetIds (list) --
The list of subnet IDs where instances are provisioned by the compute node group. The subnets must be in the same VPC as the cluster.
(string) --
purchaseOption (string) --
Specifies how EC2 instances are purchased on your behalf. Amazon Web Services PCS supports On-Demand and Spot instances. For more information, see Instance purchasing options in the Amazon Elastic Compute Cloud User Guide. If you don't provide this option, it defaults to On-Demand.
customLaunchTemplate (dict) --
An Amazon EC2 launch template Amazon Web Services PCS uses to launch compute nodes.
id (string) --
The ID of the EC2 launch template to use to provision instances.
Example: lt-xxxx
version (string) --
The version of the EC2 launch template to use to provision instances.
iamInstanceProfileArn (string) --
The Amazon Resource Name (ARN) of the IAM instance profile used to pass an IAM role when launching EC2 instances. The role contained in your instance profile must have the pcs:RegisterComputeNodeGroupInstance permission. The resource identifier of the ARN must start with AWSPCS or it must have /aws-pcs/ in its path.
Examples
arn:aws:iam::111122223333:instance-profile/AWSPCS-example-role-1
arn:aws:iam::111122223333:instance-profile/aws-pcs/example-role-2
scalingConfiguration (dict) --
Specifies the boundaries of the compute node group auto scaling.
minInstanceCount (integer) --
The lower bound of the number of instances allowed in the compute fleet.
maxInstanceCount (integer) --
The upper bound of the number of instances allowed in the compute fleet.
instanceConfigs (list) --
A list of EC2 instance configurations that Amazon Web Services PCS can provision in the compute node group.
(dict) --
An EC2 instance configuration Amazon Web Services PCS uses to launch compute nodes.
instanceType (string) --
The EC2 instance type that Amazon Web Services PCS can provision in the compute node group.
Example: t2.xlarge
spotOptions (dict) --
Additional configuration when you specify SPOT as the purchaseOption for the CreateComputeNodeGroup API action.
allocationStrategy (string) --
The Amazon EC2 allocation strategy Amazon Web Services PCS uses to provision EC2 instances. Amazon Web Services PCS supports lowest price, capacity optimized, and price capacity optimized. For more information, see Use allocation strategies to determine how EC2 Fleet or Spot Fleet fulfills Spot and On-Demand capacity in the Amazon Elastic Compute Cloud User Guide. If you don't provide this option, it defaults to price capacity optimized.
slurmConfiguration (dict) --
Additional options related to the Slurm scheduler.
slurmCustomSettings (list) --
Additional Slurm-specific configuration that directly maps to Slurm settings.
(dict) --
Additional settings that directly map to Slurm settings.
parameterName (string) --
Amazon Web Services PCS supports configuration of the following Slurm parameters:
For clusters
For compute node groups
parameterValue (string) --
The values for the configured Slurm settings.
errorInfo (list) --
The list of errors that occurred during compute node group provisioning.
(dict) --
An error that occurred during resource creation.
code (string) --
The short-form error code.
message (string) --
The detailed error information.
{'queue': {'status': {'SUSPENDED', 'SUSPENDING'}}}
Returns detailed information about a queue. The information includes the compute node groups that the queue uses to schedule jobs.
See also: AWS API Documentation
Request Syntax
client.get_queue( clusterIdentifier='string', queueIdentifier='string' )
string
[REQUIRED]
The name or ID of the cluster of the queue.
string
[REQUIRED]
The name or ID of the queue.
dict
Response Syntax
{ 'queue': { 'name': 'string', 'id': 'string', 'arn': 'string', 'clusterId': 'string', 'createdAt': datetime(2015, 1, 1), 'modifiedAt': datetime(2015, 1, 1), 'status': 'CREATING'|'ACTIVE'|'UPDATING'|'DELETING'|'CREATE_FAILED'|'DELETE_FAILED'|'UPDATE_FAILED'|'SUSPENDING'|'SUSPENDED', 'computeNodeGroupConfigurations': [ { 'computeNodeGroupId': 'string' }, ], 'errorInfo': [ { 'code': 'string', 'message': 'string' }, ] } }
Response Structure
(dict) --
queue (dict) --
A queue resource.
name (string) --
The name that identifies the queue.
id (string) --
The generated unique ID of the queue.
arn (string) --
The unique Amazon Resource Name (ARN) of the queue.
clusterId (string) --
The ID of the cluster of the queue.
createdAt (datetime) --
The date and time the resource was created.
modifiedAt (datetime) --
The date and time the resource was modified.
status (string) --
The provisioning status of the queue.
computeNodeGroupConfigurations (list) --
The list of compute node group configurations associated with the queue. Queues assign jobs to associated compute node groups.
(dict) --
The compute node group configuration for a queue.
computeNodeGroupId (string) --
The compute node group ID for the compute node group configuration.
errorInfo (list) --
The list of errors that occurred during queue provisioning.
(dict) --
An error that occurred during resource creation.
code (string) --
The short-form error code.
message (string) --
The detailed error information.
{'clusters': {'status': {'SUSPENDED', 'SUSPENDING'}}}
Returns a list of running clusters in your account.
See also: AWS API Documentation
Request Syntax
client.list_clusters( nextToken='string', maxResults=123 )
string
The value of nextToken is a unique pagination token for each page of results returned. If nextToken is returned, there are more results available. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. Using an expired pagination token returns an HTTP 400 InvalidToken error.
integer
The maximum number of results that are returned per call. You can use nextToken to obtain further pages of results. The default is 10 results, and the maximum allowed page size is 100 results. A value of 0 uses the default.
dict
Response Syntax
{ 'clusters': [ { 'name': 'string', 'id': 'string', 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'modifiedAt': datetime(2015, 1, 1), 'status': 'CREATING'|'ACTIVE'|'UPDATING'|'DELETING'|'CREATE_FAILED'|'DELETE_FAILED'|'UPDATE_FAILED'|'SUSPENDING'|'SUSPENDED' }, ], 'nextToken': 'string' }
Response Structure
(dict) --
clusters (list) --
The list of clusters.
(dict) --
The object returned by the ListClusters API action.
name (string) --
The name that identifies the cluster.
id (string) --
The generated unique ID of the cluster.
arn (string) --
The unique Amazon Resource Name (ARN) of the cluster.
createdAt (datetime) --
The date and time the resource was created.
modifiedAt (datetime) --
The date and time the resource was modified.
status (string) --
The provisioning status of the cluster.
nextToken (string) --
The value of nextToken is a unique pagination token for each page of results returned. If nextToken is returned, there are more results available. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. Using an expired pagination token returns an HTTP 400 InvalidToken error.
{'computeNodeGroups': {'status': {'SUSPENDED', 'SUSPENDING'}}}
Returns a list of all compute node groups associated with a cluster.
See also: AWS API Documentation
Request Syntax
client.list_compute_node_groups( clusterIdentifier='string', nextToken='string', maxResults=123 )
string
[REQUIRED]
The name or ID of the cluster to list compute node groups for.
string
The value of nextToken is a unique pagination token for each page of results returned. If nextToken is returned, there are more results available. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. Using an expired pagination token returns an HTTP 400 InvalidToken error.
integer
The maximum number of results that are returned per call. You can use nextToken to obtain further pages of results. The default is 10 results, and the maximum allowed page size is 100 results. A value of 0 uses the default.
dict
Response Syntax
{ 'computeNodeGroups': [ { 'name': 'string', 'id': 'string', 'arn': 'string', 'clusterId': 'string', 'createdAt': datetime(2015, 1, 1), 'modifiedAt': datetime(2015, 1, 1), 'status': 'CREATING'|'ACTIVE'|'UPDATING'|'DELETING'|'CREATE_FAILED'|'DELETE_FAILED'|'UPDATE_FAILED'|'DELETED'|'SUSPENDING'|'SUSPENDED' }, ], 'nextToken': 'string' }
Response Structure
(dict) --
computeNodeGroups (list) --
The list of compute node groups for the cluster.
(dict) --
The object returned by the ListComputeNodeGroups API action.
name (string) --
The name that identifies the compute node group.
id (string) --
The generated unique ID of the compute node group.
arn (string) --
The unique Amazon Resource Name (ARN) of the compute node group.
clusterId (string) --
The ID of the cluster of the compute node group.
createdAt (datetime) --
The date and time the resource was created.
modifiedAt (datetime) --
The date and time the resource was modified.
status (string) --
The provisioning status of the compute node group.
nextToken (string) --
The value of nextToken is a unique pagination token for each page of results returned. If nextToken is returned, there are more results available. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. Using an expired pagination token returns an HTTP 400 InvalidToken error.
{'queues': {'status': {'SUSPENDED', 'SUSPENDING'}}}
Returns a list of all queues associated with a cluster.
See also: AWS API Documentation
Request Syntax
client.list_queues( clusterIdentifier='string', nextToken='string', maxResults=123 )
string
[REQUIRED]
The name or ID of the cluster to list queues for.
string
The value of nextToken is a unique pagination token for each page of results returned. If nextToken is returned, there are more results available. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. Using an expired pagination token returns an HTTP 400 InvalidToken error.
integer
The maximum number of results that are returned per call. You can use nextToken to obtain further pages of results. The default is 10 results, and the maximum allowed page size is 100 results. A value of 0 uses the default.
dict
Response Syntax
{ 'queues': [ { 'name': 'string', 'id': 'string', 'arn': 'string', 'clusterId': 'string', 'createdAt': datetime(2015, 1, 1), 'modifiedAt': datetime(2015, 1, 1), 'status': 'CREATING'|'ACTIVE'|'UPDATING'|'DELETING'|'CREATE_FAILED'|'DELETE_FAILED'|'UPDATE_FAILED'|'SUSPENDING'|'SUSPENDED' }, ], 'nextToken': 'string' }
Response Structure
(dict) --
queues (list) --
The list of queues associated with the cluster.
(dict) --
The object returned by the ListQueues API action.
name (string) --
The name that identifies the queue.
id (string) --
The generated unique ID of the queue.
arn (string) --
The unique Amazon Resource Name (ARN) of the queue.
clusterId (string) --
The ID of the cluster of the queue.
createdAt (datetime) --
The date and time the resource was created.
modifiedAt (datetime) --
The date and time the resource was modified.
status (string) --
The provisioning status of the queue.
nextToken (string) --
The value of nextToken is a unique pagination token for each page of results returned. If nextToken is returned, there are more results available. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. Using an expired pagination token returns an HTTP 400 InvalidToken error.
{'computeNodeGroup': {'status': {'SUSPENDED', 'SUSPENDING'}}}
Updates a compute node group. You can update many of the fields related to your compute node group including the configurations for networking, compute nodes, and settings specific to your scheduler (such as Slurm).
See also: AWS API Documentation
Request Syntax
client.update_compute_node_group( clusterIdentifier='string', computeNodeGroupIdentifier='string', amiId='string', subnetIds=[ 'string', ], customLaunchTemplate={ 'id': 'string', 'version': 'string' }, purchaseOption='ONDEMAND'|'SPOT', spotOptions={ 'allocationStrategy': 'lowest-price'|'capacity-optimized'|'price-capacity-optimized' }, scalingConfiguration={ 'minInstanceCount': 123, 'maxInstanceCount': 123 }, iamInstanceProfileArn='string', slurmConfiguration={ 'slurmCustomSettings': [ { 'parameterName': 'string', 'parameterValue': 'string' }, ] }, clientToken='string' )
string
[REQUIRED]
The name or ID of the cluster of the compute node group.
string
[REQUIRED]
The name or ID of the compute node group.
string
The ID of the Amazon Machine Image (AMI) that Amazon Web Services PCS uses to launch instances. If not provided, Amazon Web Services PCS uses the AMI ID specified in the custom launch template.
list
The list of subnet IDs where the compute node group provisions instances. The subnets must be in the same VPC as the cluster.
(string) --
dict
An Amazon EC2 launch template Amazon Web Services PCS uses to launch compute nodes.
id (string) -- [REQUIRED]
The ID of the EC2 launch template to use to provision instances.
Example: lt-xxxx
version (string) -- [REQUIRED]
The version of the EC2 launch template to use to provision instances.
string
Specifies how EC2 instances are purchased on your behalf. Amazon Web Services PCS supports On-Demand and Spot instances. For more information, see Instance purchasing options in the Amazon Elastic Compute Cloud User Guide. If you don't provide this option, it defaults to On-Demand.
dict
Additional configuration when you specify SPOT as the purchaseOption for the CreateComputeNodeGroup API action.
allocationStrategy (string) --
The Amazon EC2 allocation strategy Amazon Web Services PCS uses to provision EC2 instances. Amazon Web Services PCS supports lowest price, capacity optimized, and price capacity optimized. For more information, see Use allocation strategies to determine how EC2 Fleet or Spot Fleet fulfills Spot and On-Demand capacity in the Amazon Elastic Compute Cloud User Guide. If you don't provide this option, it defaults to price capacity optimized.
dict
Specifies the boundaries of the compute node group auto scaling.
minInstanceCount (integer) -- [REQUIRED]
The lower bound of the number of instances allowed in the compute fleet.
maxInstanceCount (integer) -- [REQUIRED]
The upper bound of the number of instances allowed in the compute fleet.
string
The Amazon Resource Name (ARN) of the IAM instance profile used to pass an IAM role when launching EC2 instances. The role contained in your instance profile must have the pcs:RegisterComputeNodeGroupInstance permission. The resource identifier of the ARN must start with AWSPCS or it must have /aws-pcs/ in its path.
Examples
arn:aws:iam::111122223333:instance-profile/AWSPCS-example-role-1
arn:aws:iam::111122223333:instance-profile/aws-pcs/example-role-2
dict
Additional options related to the Slurm scheduler.
slurmCustomSettings (list) --
Additional Slurm-specific configuration that directly maps to Slurm settings.
(dict) --
Additional settings that directly map to Slurm settings.
parameterName (string) -- [REQUIRED]
Amazon Web Services PCS supports configuration of the following Slurm parameters:
For clusters
For compute node groups
parameterValue (string) -- [REQUIRED]
The values for the configured Slurm settings.
string
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.
This field is autopopulated if not provided.
dict
Response Syntax
{ 'computeNodeGroup': { 'name': 'string', 'id': 'string', 'arn': 'string', 'clusterId': 'string', 'createdAt': datetime(2015, 1, 1), 'modifiedAt': datetime(2015, 1, 1), 'status': 'CREATING'|'ACTIVE'|'UPDATING'|'DELETING'|'CREATE_FAILED'|'DELETE_FAILED'|'UPDATE_FAILED'|'DELETED'|'SUSPENDING'|'SUSPENDED', 'amiId': 'string', 'subnetIds': [ 'string', ], 'purchaseOption': 'ONDEMAND'|'SPOT', 'customLaunchTemplate': { 'id': 'string', 'version': 'string' }, 'iamInstanceProfileArn': 'string', 'scalingConfiguration': { 'minInstanceCount': 123, 'maxInstanceCount': 123 }, 'instanceConfigs': [ { 'instanceType': 'string' }, ], 'spotOptions': { 'allocationStrategy': 'lowest-price'|'capacity-optimized'|'price-capacity-optimized' }, 'slurmConfiguration': { 'slurmCustomSettings': [ { 'parameterName': 'string', 'parameterValue': 'string' }, ] }, 'errorInfo': [ { 'code': 'string', 'message': 'string' }, ] } }
Response Structure
(dict) --
computeNodeGroup (dict) --
A compute node group associated with a cluster.
name (string) --
The name that identifies the compute node group.
id (string) --
The generated unique ID of the compute node group.
arn (string) --
The unique Amazon Resource Name (ARN) of the compute node group.
clusterId (string) --
The ID of the cluster of the compute node group.
createdAt (datetime) --
The date and time the resource was created.
modifiedAt (datetime) --
The date and time the resource was modified.
status (string) --
The provisioning status of the compute node group.
amiId (string) --
The ID of the Amazon Machine Image (AMI) that Amazon Web Services PCS uses to launch instances. If not provided, Amazon Web Services PCS uses the AMI ID specified in the custom launch template.
subnetIds (list) --
The list of subnet IDs where instances are provisioned by the compute node group. The subnets must be in the same VPC as the cluster.
(string) --
purchaseOption (string) --
Specifies how EC2 instances are purchased on your behalf. Amazon Web Services PCS supports On-Demand and Spot instances. For more information, see Instance purchasing options in the Amazon Elastic Compute Cloud User Guide. If you don't provide this option, it defaults to On-Demand.
customLaunchTemplate (dict) --
An Amazon EC2 launch template Amazon Web Services PCS uses to launch compute nodes.
id (string) --
The ID of the EC2 launch template to use to provision instances.
Example: lt-xxxx
version (string) --
The version of the EC2 launch template to use to provision instances.
iamInstanceProfileArn (string) --
The Amazon Resource Name (ARN) of the IAM instance profile used to pass an IAM role when launching EC2 instances. The role contained in your instance profile must have the pcs:RegisterComputeNodeGroupInstance permission. The resource identifier of the ARN must start with AWSPCS or it must have /aws-pcs/ in its path.
Examples
arn:aws:iam::111122223333:instance-profile/AWSPCS-example-role-1
arn:aws:iam::111122223333:instance-profile/aws-pcs/example-role-2
scalingConfiguration (dict) --
Specifies the boundaries of the compute node group auto scaling.
minInstanceCount (integer) --
The lower bound of the number of instances allowed in the compute fleet.
maxInstanceCount (integer) --
The upper bound of the number of instances allowed in the compute fleet.
instanceConfigs (list) --
A list of EC2 instance configurations that Amazon Web Services PCS can provision in the compute node group.
(dict) --
An EC2 instance configuration Amazon Web Services PCS uses to launch compute nodes.
instanceType (string) --
The EC2 instance type that Amazon Web Services PCS can provision in the compute node group.
Example: t2.xlarge
spotOptions (dict) --
Additional configuration when you specify SPOT as the purchaseOption for the CreateComputeNodeGroup API action.
allocationStrategy (string) --
The Amazon EC2 allocation strategy Amazon Web Services PCS uses to provision EC2 instances. Amazon Web Services PCS supports lowest price, capacity optimized, and price capacity optimized. For more information, see Use allocation strategies to determine how EC2 Fleet or Spot Fleet fulfills Spot and On-Demand capacity in the Amazon Elastic Compute Cloud User Guide. If you don't provide this option, it defaults to price capacity optimized.
slurmConfiguration (dict) --
Additional options related to the Slurm scheduler.
slurmCustomSettings (list) --
Additional Slurm-specific configuration that directly maps to Slurm settings.
(dict) --
Additional settings that directly map to Slurm settings.
parameterName (string) --
Amazon Web Services PCS supports configuration of the following Slurm parameters:
For clusters
For compute node groups
parameterValue (string) --
The values for the configured Slurm settings.
errorInfo (list) --
The list of errors that occurred during compute node group provisioning.
(dict) --
An error that occurred during resource creation.
code (string) --
The short-form error code.
message (string) --
The detailed error information.
{'queue': {'status': {'SUSPENDED', 'SUSPENDING'}}}
Updates the compute node group configuration of a queue. Use this API to change the compute node groups that the queue can send jobs to.
See also: AWS API Documentation
Request Syntax
client.update_queue( clusterIdentifier='string', queueIdentifier='string', computeNodeGroupConfigurations=[ { 'computeNodeGroupId': 'string' }, ], clientToken='string' )
string
[REQUIRED]
The name or ID of the cluster of the queue.
string
[REQUIRED]
The name or ID of the queue.
list
The list of compute node group configurations to associate with the queue. Queues assign jobs to associated compute node groups.
(dict) --
The compute node group configuration for a queue.
computeNodeGroupId (string) --
The compute node group ID for the compute node group configuration.
string
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.
This field is autopopulated if not provided.
dict
Response Syntax
{ 'queue': { 'name': 'string', 'id': 'string', 'arn': 'string', 'clusterId': 'string', 'createdAt': datetime(2015, 1, 1), 'modifiedAt': datetime(2015, 1, 1), 'status': 'CREATING'|'ACTIVE'|'UPDATING'|'DELETING'|'CREATE_FAILED'|'DELETE_FAILED'|'UPDATE_FAILED'|'SUSPENDING'|'SUSPENDED', 'computeNodeGroupConfigurations': [ { 'computeNodeGroupId': 'string' }, ], 'errorInfo': [ { 'code': 'string', 'message': 'string' }, ] } }
Response Structure
(dict) --
queue (dict) --
A queue resource.
name (string) --
The name that identifies the queue.
id (string) --
The generated unique ID of the queue.
arn (string) --
The unique Amazon Resource Name (ARN) of the queue.
clusterId (string) --
The ID of the cluster of the queue.
createdAt (datetime) --
The date and time the resource was created.
modifiedAt (datetime) --
The date and time the resource was modified.
status (string) --
The provisioning status of the queue.
computeNodeGroupConfigurations (list) --
The list of compute node group configurations associated with the queue. Queues assign jobs to associated compute node groups.
(dict) --
The compute node group configuration for a queue.
computeNodeGroupId (string) --
The compute node group ID for the compute node group configuration.
errorInfo (list) --
The list of errors that occurred during queue provisioning.
(dict) --
An error that occurred during resource creation.
code (string) --
The short-form error code.
message (string) --
The detailed error information.