{ "smithy": "2.0", "shapes": { "com.amazonaws.pcs#AWSParallelComputingService": { "type": "service", "version": "2023-02-10", "operations": [ { "target": "com.amazonaws.pcs#ListTagsForResource" }, { "target": "com.amazonaws.pcs#TagResource" }, { "target": "com.amazonaws.pcs#UntagResource" } ], "resources": [ { "target": "com.amazonaws.pcs#ClusterResource" } ], "traits": { "aws.api#service": { "sdkId": "PCS", "arnNamespace": "pcs" }, "aws.auth#sigv4": { "name": "pcs" }, "aws.iam#defineConditionKeys": { "aws:ResourceTag/${TagKey}": { "type": "String", "documentation": "Filters access by a tag key and value pair of a resource", "externalDocumentation": "${DocHomeURL}IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-resourcetag" }, "aws:RequestTag/${TagKey}": { "type": "String", "documentation": "Filters access by a tag key and value pair that is allowed in the request", "externalDocumentation": "${DocHomeURL}IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-requesttag" }, "aws:TagKeys": { "type": "ArrayOfString", "documentation": "Filters access by a list of tag keys that are allowed in the request", "externalDocumentation": "${DocHomeURL}IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-tagkeys" }, "ResourceName": { "type": "String", "documentation": "Filters creation of resources with a certain name" } }, "aws.iam#disableConditionKeyInference": {}, "aws.protocols#awsJson1_0": {}, "smithy.api#cors": { "additionalAllowedHeaders": [ "*,authorization,date,x-amz-date,x-amz-security-token,x-amz-target,content-type,x-amz-content-sha256,x-amz-user-agent,x-amzn-platform-id,x-amzn-trace-id,amz-sdk-invocation-id,amz-sdk-request" ] }, "smithy.api#documentation": "

Parallel Computing Service (PCS) is a managed service that makes it easier for you to run and scale your high performance computing (HPC) workloads, and build scientific and engineering models on Amazon Web Services using Slurm. For more information, see the Parallel Computing Service User Guide.

This reference describes the actions and data types of the service management API. You can use the Amazon Web Services SDKs to call the API actions in software, or use the Command Line Interface (CLI) to call the API actions manually. These API actions manage the service through an Amazon Web Services account.

The API actions operate on PCS resources. A resource is an entity in Amazon Web Services that you can work with. Amazon Web Services services create resources when you use the features of the service. Examples of PCS resources include clusters, compute node groups, and queues. For more information about resources in Amazon Web Services, see Resource in the Resource Explorer User Guide.

An PCS compute node is an Amazon EC2 instance. You don't launch compute nodes directly. PCS uses configuration information that you provide to launch compute nodes in your Amazon Web Services account. You receive billing charges for your running compute nodes. PCS automatically terminates your compute nodes when you delete the PCS resources related to those compute nodes.

", "smithy.api#title": "AWS Parallel Computing Service", "smithy.rules#endpointBdd": { "version": "1.1", "parameters": { "Region": { "builtIn": "AWS::Region", "required": false, "documentation": "The AWS region used to dispatch the request.", "type": "string" }, "UseDualStack": { "builtIn": "AWS::UseDualStack", "required": true, "default": false, "documentation": "When true, use the dual-stack endpoint. If the configured endpoint does not support dual-stack, dispatching the request MAY return an error.", "type": "boolean" }, "UseFIPS": { "builtIn": "AWS::UseFIPS", "required": true, "default": false, "documentation": "When true, send this request to the FIPS-compliant regional endpoint. If the configured endpoint does not have a FIPS compliant endpoint, dispatching the request will return an error.", "type": "boolean" }, "Endpoint": { "builtIn": "SDK::Endpoint", "required": false, "documentation": "Override the endpoint used to send this request", "type": "string" } }, "conditions": [ { "fn": "isSet", "argv": [ { "ref": "Endpoint" } ] }, { "fn": "isSet", "argv": [ { "ref": "Region" } ] }, { "fn": "aws.partition", "argv": [ { "ref": "Region" } ], "assign": "PartitionResult" }, { "fn": "booleanEquals", "argv": [ { "ref": "UseFIPS" }, true ] }, { "fn": "booleanEquals", "argv": [ { "ref": "UseDualStack" }, true ] }, { "fn": "booleanEquals", "argv": [ { "fn": "getAttr", "argv": [ { "ref": "PartitionResult" }, "supportsDualStack" ] }, true ] }, { "fn": "booleanEquals", "argv": [ { "fn": "getAttr", "argv": [ { "ref": "PartitionResult" }, "supportsFIPS" ] }, true ] } ], "results": [ { "conditions": [], "error": "Invalid Configuration: FIPS and custom endpoint are not supported", "type": "error" }, { "conditions": [], "error": "Invalid Configuration: Dualstack and custom endpoint are not supported", "type": "error" }, { "conditions": [], "endpoint": { "url": { "ref": "Endpoint" }, "properties": {}, "headers": {} }, "type": "endpoint" }, { "conditions": [], "endpoint": { "url": "https://pcs-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", "properties": {}, "headers": {} }, "type": "endpoint" }, { "conditions": [], "error": "FIPS and DualStack are enabled, but this partition does not support one or both", "type": "error" }, { "conditions": [], "endpoint": { "url": "https://pcs-fips.{Region}.{PartitionResult#dnsSuffix}", "properties": {}, "headers": {} }, "type": "endpoint" }, { "conditions": [], "error": "FIPS is enabled but this partition does not support FIPS", "type": "error" }, { "conditions": [], "endpoint": { "url": "https://pcs.{Region}.{PartitionResult#dualStackDnsSuffix}", "properties": {}, "headers": {} }, "type": "endpoint" }, { "conditions": [], "error": "DualStack is enabled but this partition does not support DualStack", "type": "error" }, { "conditions": [], "endpoint": { "url": "https://pcs.{Region}.{PartitionResult#dnsSuffix}", "properties": {}, "headers": {} }, "type": "endpoint" }, { "conditions": [], "error": "Invalid Configuration: Missing Region", "type": "error" } ], "root": 2, "nodeCount": 13, "nodes": "/////wAAAAH/////AAAAAAAAAAwAAAADAAAAAQAAAAQF9eELAAAAAgAAAAUF9eELAAAAAwAAAAgAAAAGAAAABAAAAAcF9eEKAAAABQX14QgF9eEJAAAABAAAAAoAAAAJAAAABgX14QYF9eEHAAAABQAAAAsF9eEFAAAABgX14QQF9eEFAAAAAwX14QEAAAANAAAABAX14QIF9eED" }, "smithy.rules#endpointRuleSet": { "version": "1.0", "parameters": { "Region": { "builtIn": "AWS::Region", "required": false, "documentation": "The AWS region used to dispatch the request.", "type": "string" }, "UseDualStack": { "builtIn": "AWS::UseDualStack", "required": true, "default": false, "documentation": "When true, use the dual-stack endpoint. If the configured endpoint does not support dual-stack, dispatching the request MAY return an error.", "type": "boolean" }, "UseFIPS": { "builtIn": "AWS::UseFIPS", "required": true, "default": false, "documentation": "When true, send this request to the FIPS-compliant regional endpoint. If the configured endpoint does not have a FIPS compliant endpoint, dispatching the request will return an error.", "type": "boolean" }, "Endpoint": { "builtIn": "SDK::Endpoint", "required": false, "documentation": "Override the endpoint used to send this request", "type": "string" } }, "rules": [ { "conditions": [ { "fn": "isSet", "argv": [ { "ref": "Endpoint" } ] } ], "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ { "ref": "UseFIPS" }, true ] } ], "error": "Invalid Configuration: FIPS and custom endpoint are not supported", "type": "error" }, { "conditions": [], "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ { "ref": "UseDualStack" }, true ] } ], "error": "Invalid Configuration: Dualstack and custom endpoint are not supported", "type": "error" }, { "conditions": [], "endpoint": { "url": { "ref": "Endpoint" }, "properties": {}, "headers": {} }, "type": "endpoint" } ], "type": "tree" } ], "type": "tree" }, { "conditions": [], "rules": [ { "conditions": [ { "fn": "isSet", "argv": [ { "ref": "Region" } ] } ], "rules": [ { "conditions": [ { "fn": "aws.partition", "argv": [ { "ref": "Region" } ], "assign": "PartitionResult" } ], "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ { "ref": "UseFIPS" }, true ] }, { "fn": "booleanEquals", "argv": [ { "ref": "UseDualStack" }, true ] } ], "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ true, { "fn": "getAttr", "argv": [ { "ref": "PartitionResult" }, "supportsFIPS" ] } ] }, { "fn": "booleanEquals", "argv": [ true, { "fn": "getAttr", "argv": [ { "ref": "PartitionResult" }, "supportsDualStack" ] } ] } ], "rules": [ { "conditions": [], "rules": [ { "conditions": [], "endpoint": { "url": "https://pcs-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", "properties": {}, "headers": {} }, "type": "endpoint" } ], "type": "tree" } ], "type": "tree" }, { "conditions": [], "error": "FIPS and DualStack are enabled, but this partition does not support one or both", "type": "error" } ], "type": "tree" }, { "conditions": [ { "fn": "booleanEquals", "argv": [ { "ref": "UseFIPS" }, true ] } ], "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ { "fn": "getAttr", "argv": [ { "ref": "PartitionResult" }, "supportsFIPS" ] }, true ] } ], "rules": [ { "conditions": [], "rules": [ { "conditions": [], "endpoint": { "url": "https://pcs-fips.{Region}.{PartitionResult#dnsSuffix}", "properties": {}, "headers": {} }, "type": "endpoint" } ], "type": "tree" } ], "type": "tree" }, { "conditions": [], "error": "FIPS is enabled but this partition does not support FIPS", "type": "error" } ], "type": "tree" }, { "conditions": [ { "fn": "booleanEquals", "argv": [ { "ref": "UseDualStack" }, true ] } ], "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ true, { "fn": "getAttr", "argv": [ { "ref": "PartitionResult" }, "supportsDualStack" ] } ] } ], "rules": [ { "conditions": [], "rules": [ { "conditions": [], "endpoint": { "url": "https://pcs.{Region}.{PartitionResult#dualStackDnsSuffix}", "properties": {}, "headers": {} }, "type": "endpoint" } ], "type": "tree" } ], "type": "tree" }, { "conditions": [], "error": "DualStack is enabled but this partition does not support DualStack", "type": "error" } ], "type": "tree" }, { "conditions": [], "rules": [ { "conditions": [], "endpoint": { "url": "https://pcs.{Region}.{PartitionResult#dnsSuffix}", "properties": {}, "headers": {} }, "type": "endpoint" } ], "type": "tree" } ], "type": "tree" } ], "type": "tree" }, { "conditions": [], "error": "Invalid Configuration: Missing Region", "type": "error" } ], "type": "tree" } ] }, "smithy.rules#endpointTests": { "testCases": [ { "documentation": "For region us-east-1 with FIPS enabled and DualStack enabled", "expect": { "endpoint": { "url": "https://pcs-fips.us-east-1.api.aws" } }, "params": { "Region": "us-east-1", "UseFIPS": true, "UseDualStack": true } }, { "documentation": "For region us-east-1 with FIPS enabled and DualStack disabled", "expect": { "endpoint": { "url": "https://pcs-fips.us-east-1.amazonaws.com" } }, "params": { "Region": "us-east-1", "UseFIPS": true, "UseDualStack": false } }, { "documentation": "For region us-east-1 with FIPS disabled and DualStack enabled", "expect": { "endpoint": { "url": "https://pcs.us-east-1.api.aws" } }, "params": { "Region": "us-east-1", "UseFIPS": false, "UseDualStack": true } }, { "documentation": "For region us-east-1 with FIPS disabled and DualStack disabled", "expect": { "endpoint": { "url": "https://pcs.us-east-1.amazonaws.com" } }, "params": { "Region": "us-east-1", "UseFIPS": false, "UseDualStack": false } }, { "documentation": "For region cn-north-1 with FIPS enabled and DualStack enabled", "expect": { "endpoint": { "url": "https://pcs-fips.cn-north-1.api.amazonwebservices.com.cn" } }, "params": { "Region": "cn-north-1", "UseFIPS": true, "UseDualStack": true } }, { "documentation": "For region cn-north-1 with FIPS enabled and DualStack disabled", "expect": { "endpoint": { "url": "https://pcs-fips.cn-north-1.amazonaws.com.cn" } }, "params": { "Region": "cn-north-1", "UseFIPS": true, "UseDualStack": false } }, { "documentation": "For region cn-north-1 with FIPS disabled and DualStack enabled", "expect": { "endpoint": { "url": "https://pcs.cn-north-1.api.amazonwebservices.com.cn" } }, "params": { "Region": "cn-north-1", "UseFIPS": false, "UseDualStack": true } }, { "documentation": "For region cn-north-1 with FIPS disabled and DualStack disabled", "expect": { "endpoint": { "url": "https://pcs.cn-north-1.amazonaws.com.cn" } }, "params": { "Region": "cn-north-1", "UseFIPS": false, "UseDualStack": false } }, { "documentation": "For region us-gov-east-1 with FIPS enabled and DualStack enabled", "expect": { "endpoint": { "url": "https://pcs-fips.us-gov-east-1.api.aws" } }, "params": { "Region": "us-gov-east-1", "UseFIPS": true, "UseDualStack": true } }, { "documentation": "For region us-gov-east-1 with FIPS enabled and DualStack disabled", "expect": { "endpoint": { "url": "https://pcs-fips.us-gov-east-1.amazonaws.com" } }, "params": { "Region": "us-gov-east-1", "UseFIPS": true, "UseDualStack": false } }, { "documentation": "For region us-gov-east-1 with FIPS disabled and DualStack enabled", "expect": { "endpoint": { "url": "https://pcs.us-gov-east-1.api.aws" } }, "params": { "Region": "us-gov-east-1", "UseFIPS": false, "UseDualStack": true } }, { "documentation": "For region us-gov-east-1 with FIPS disabled and DualStack disabled", "expect": { "endpoint": { "url": "https://pcs.us-gov-east-1.amazonaws.com" } }, "params": { "Region": "us-gov-east-1", "UseFIPS": false, "UseDualStack": false } }, { "documentation": "For region us-iso-east-1 with FIPS enabled and DualStack disabled", "expect": { "endpoint": { "url": "https://pcs-fips.us-iso-east-1.c2s.ic.gov" } }, "params": { "Region": "us-iso-east-1", "UseFIPS": true, "UseDualStack": false } }, { "documentation": "For region us-iso-east-1 with FIPS disabled and DualStack disabled", "expect": { "endpoint": { "url": "https://pcs.us-iso-east-1.c2s.ic.gov" } }, "params": { "Region": "us-iso-east-1", "UseFIPS": false, "UseDualStack": false } }, { "documentation": "For region us-isob-east-1 with FIPS enabled and DualStack disabled", "expect": { "endpoint": { "url": "https://pcs-fips.us-isob-east-1.sc2s.sgov.gov" } }, "params": { "Region": "us-isob-east-1", "UseFIPS": true, "UseDualStack": false } }, { "documentation": "For region us-isob-east-1 with FIPS disabled and DualStack disabled", "expect": { "endpoint": { "url": "https://pcs.us-isob-east-1.sc2s.sgov.gov" } }, "params": { "Region": "us-isob-east-1", "UseFIPS": false, "UseDualStack": false } }, { "documentation": "For custom endpoint with region set and fips disabled and dualstack disabled", "expect": { "endpoint": { "url": "https://example.com" } }, "params": { "Region": "us-east-1", "UseFIPS": false, "UseDualStack": false, "Endpoint": "https://example.com" } }, { "documentation": "For custom endpoint with region not set and fips disabled and dualstack disabled", "expect": { "endpoint": { "url": "https://example.com" } }, "params": { "UseFIPS": false, "UseDualStack": false, "Endpoint": "https://example.com" } }, { "documentation": "For custom endpoint with fips enabled and dualstack disabled", "expect": { "error": "Invalid Configuration: FIPS and custom endpoint are not supported" }, "params": { "Region": "us-east-1", "UseFIPS": true, "UseDualStack": false, "Endpoint": "https://example.com" } }, { "documentation": "For custom endpoint with fips disabled and dualstack enabled", "expect": { "error": "Invalid Configuration: Dualstack and custom endpoint are not supported" }, "params": { "Region": "us-east-1", "UseFIPS": false, "UseDualStack": true, "Endpoint": "https://example.com" } }, { "documentation": "Missing region", "expect": { "error": "Invalid Configuration: Missing Region" } } ], "version": "1.0" } } }, "com.amazonaws.pcs#AccessDeniedException": { "type": "structure", "members": { "message": { "target": "smithy.api#String", "traits": { "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

You don't have permission to perform the action.

Examples

", "smithy.api#error": "client", "smithy.api#httpError": 403 } }, "com.amazonaws.pcs#Accounting": { "type": "structure", "members": { "defaultPurgeTimeInDays": { "target": "smithy.api#Integer", "traits": { "smithy.api#documentation": "

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.

0 isn't a valid value.

", "smithy.api#range": { "min": -1, "max": 10000 } } }, "mode": { "target": "com.amazonaws.pcs#AccountingMode", "traits": { "smithy.api#documentation": "

The default value for mode is NONE. A value of STANDARD means Slurm accounting is enabled.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

The accounting configuration includes configurable settings for Slurm accounting. It's a property of the ClusterSlurmConfiguration object.

" } }, "com.amazonaws.pcs#AccountingMode": { "type": "enum", "members": { "STANDARD": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "STANDARD" } }, "NONE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "NONE" } } } }, "com.amazonaws.pcs#AccountingRequest": { "type": "structure", "members": { "defaultPurgeTimeInDays": { "target": "smithy.api#Integer", "traits": { "smithy.api#documentation": "

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.

0 isn't a valid value.

", "smithy.api#range": { "min": -1, "max": 10000 } } }, "mode": { "target": "com.amazonaws.pcs#AccountingMode", "traits": { "smithy.api#documentation": "

The default value for mode is NONE. A value of STANDARD means Slurm accounting is enabled.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

The accounting configuration includes configurable settings for Slurm accounting. It's a property of the ClusterSlurmConfiguration object.

" } }, "com.amazonaws.pcs#AmiId": { "type": "string", "traits": { "smithy.api#pattern": "^ami-[a-z0-9]+$" } }, "com.amazonaws.pcs#AmiIdOrEmpty": { "type": "string", "traits": { "smithy.api#pattern": "^(ami-[a-z0-9]+)?$" } }, "com.amazonaws.pcs#Arn": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 1011 }, "smithy.api#pattern": "^arn:aws.*:pcs:.*:[0-9]{12}:.*/[a-z0-9_\\-]+$" } }, "com.amazonaws.pcs#BootstrapId": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 1000 }, "smithy.api#pattern": "^[\\S]+$" } }, "com.amazonaws.pcs#CgroupCustomSetting": { "type": "structure", "members": { "parameterName": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

PCS supports custom Cgroup settings for clusters. For more information, see Configuring custom Cgroup settings in PCS in the PCS User Guide.

", "smithy.api#required": {} } }, "parameterValue": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The values for the configured Cgroup settings.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

Additional settings that directly map to Cgroup settings.

PCS supports a subset of Cgroup settings. For more information, see Configuring custom Cgroup settings in PCS in the PCS User Guide.

" } }, "com.amazonaws.pcs#CgroupCustomSettings": { "type": "list", "member": { "target": "com.amazonaws.pcs#CgroupCustomSetting" } }, "com.amazonaws.pcs#Cluster": { "type": "structure", "members": { "name": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The name that identifies the cluster.

", "smithy.api#required": {} } }, "id": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The generated unique ID of the cluster.

", "smithy.api#required": {} } }, "arn": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The unique Amazon Resource Name (ARN) of the cluster.

", "smithy.api#required": {} } }, "status": { "target": "com.amazonaws.pcs#ClusterStatus", "traits": { "smithy.api#documentation": "

The provisioning status of the cluster.

The provisioning status doesn't indicate the overall health of the cluster.

The resource enters the SUSPENDING and SUSPENDED states when the scheduler is beyond end of life and we have suspended the cluster. When in these states, you can't use the cluster. The cluster controller is down and all compute instances are terminated. The resources still count toward your service quotas. You can delete a resource if its status is SUSPENDED. For more information, see Frequently asked questions about Slurm versions in PCS in the PCS User Guide.

", "smithy.api#required": {} } }, "createdAt": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "

The date and time the resource was created.

", "smithy.api#required": {}, "smithy.api#timestampFormat": "date-time" } }, "modifiedAt": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "

The date and time the resource was modified.

", "smithy.api#required": {}, "smithy.api#timestampFormat": "date-time" } }, "scheduler": { "target": "com.amazonaws.pcs#Scheduler", "traits": { "smithy.api#required": {} } }, "size": { "target": "com.amazonaws.pcs#Size", "traits": { "smithy.api#documentation": "

The size of the cluster.

", "smithy.api#required": {} } }, "slurmConfiguration": { "target": "com.amazonaws.pcs#ClusterSlurmConfiguration", "traits": { "smithy.api#documentation": "

Additional options related to the Slurm scheduler.

" } }, "networking": { "target": "com.amazonaws.pcs#Networking", "traits": { "smithy.api#required": {} } }, "endpoints": { "target": "com.amazonaws.pcs#Endpoints", "traits": { "smithy.api#documentation": "

The list of endpoints available for interaction with the scheduler.

" } }, "errorInfo": { "target": "com.amazonaws.pcs#ErrorInfoList", "traits": { "smithy.api#documentation": "

The list of errors that occurred during cluster provisioning.

" } } }, "traits": { "smithy.api#documentation": "

The cluster resource and configuration.

" } }, "com.amazonaws.pcs#ClusterIdentifier": { "type": "string", "traits": { "smithy.api#pattern": "^(pcs_[a-zA-Z0-9]+|[A-Za-z][A-Za-z0-9-]{2,40})$" } }, "com.amazonaws.pcs#ClusterList": { "type": "list", "member": { "target": "com.amazonaws.pcs#ClusterSummary" } }, "com.amazonaws.pcs#ClusterName": { "type": "string", "traits": { "smithy.api#length": { "min": 3, "max": 40 }, "smithy.api#pattern": "^(?!pcs_)^[A-Za-z][A-Za-z0-9-]+$" } }, "com.amazonaws.pcs#ClusterResource": { "type": "resource", "identifiers": { "clusterIdentifier": { "target": "com.amazonaws.pcs#ClusterIdentifier" } }, "create": { "target": "com.amazonaws.pcs#CreateCluster" }, "update": { "target": "com.amazonaws.pcs#UpdateCluster" }, "operations": [ { "target": "com.amazonaws.pcs#DeleteCluster" }, { "target": "com.amazonaws.pcs#GetCluster" }, { "target": "com.amazonaws.pcs#RegisterComputeNodeGroupInstance" } ], "collectionOperations": [ { "target": "com.amazonaws.pcs#ListClusters" } ], "resources": [ { "target": "com.amazonaws.pcs#ComputeNodeGroupResource" }, { "target": "com.amazonaws.pcs#QueueResource" } ], "traits": { "aws.api#arn": { "template": "cluster/{clusterIdentifier}" }, "aws.iam#conditionKeys": [ "aws:ResourceTag/${TagKey}" ], "aws.iam#iamResource": { "name": "cluster" } } }, "com.amazonaws.pcs#ClusterSlurmConfiguration": { "type": "structure", "members": { "scaleDownIdleTimeInSeconds": { "target": "smithy.api#Integer", "traits": { "smithy.api#documentation": "

The time (in seconds) before an idle node is scaled down.

Default: 600

", "smithy.api#range": { "min": 1, "max": 10000000 } } }, "slurmCustomSettings": { "target": "com.amazonaws.pcs#SlurmCustomSettings", "traits": { "smithy.api#documentation": "

Additional Slurm-specific configuration that directly maps to Slurm settings.

" } }, "slurmdbdCustomSettings": { "target": "com.amazonaws.pcs#SlurmdbdCustomSettings", "traits": { "smithy.api#documentation": "

Additional SlurmDBD-specific configuration that directly maps to SlurmDBD settings.

" } }, "cgroupCustomSettings": { "target": "com.amazonaws.pcs#CgroupCustomSettings", "traits": { "smithy.api#documentation": "

Additional Cgroup-specific configuration that directly maps to Cgroup settings.

" } }, "jobSubmitPlugins": { "target": "com.amazonaws.pcs#JobSubmitPluginList", "traits": { "smithy.api#documentation": "

The job submit plugins to run on the cluster controller. Use job submit plugins to execute custom scripts during job submission and job modification to validate or modify the job's configuration. Custom scripts can accept or reject jobs based on their configuration or modify the configuration before job execution.

" } }, "authKey": { "target": "com.amazonaws.pcs#SlurmAuthKey", "traits": { "smithy.api#documentation": "

The shared Slurm key for authentication, also known as the cluster secret.

" } }, "jwtAuth": { "target": "com.amazonaws.pcs#JwtAuth", "traits": { "smithy.api#documentation": "

The JWT authentication configuration for Slurm REST API access.

" } }, "accounting": { "target": "com.amazonaws.pcs#Accounting", "traits": { "smithy.api#documentation": "

The accounting configuration includes configurable settings for Slurm accounting.

" } }, "slurmRest": { "target": "com.amazonaws.pcs#SlurmRest", "traits": { "smithy.api#documentation": "

The Slurm REST API configuration for the cluster.

" } } }, "traits": { "smithy.api#documentation": "

Additional options related to the Slurm scheduler.

" } }, "com.amazonaws.pcs#ClusterSlurmConfigurationRequest": { "type": "structure", "members": { "scaleDownIdleTimeInSeconds": { "target": "smithy.api#Integer", "traits": { "smithy.api#documentation": "

The time (in seconds) before an idle node is scaled down.

Default: 600

", "smithy.api#range": { "min": 1, "max": 10000000 } } }, "slurmCustomSettings": { "target": "com.amazonaws.pcs#SlurmCustomSettings", "traits": { "smithy.api#documentation": "

Additional Slurm-specific configuration that directly maps to Slurm settings.

" } }, "slurmdbdCustomSettings": { "target": "com.amazonaws.pcs#SlurmdbdCustomSettings", "traits": { "smithy.api#documentation": "

Additional SlurmDBD-specific configuration that directly maps to SlurmDBD settings.

" } }, "cgroupCustomSettings": { "target": "com.amazonaws.pcs#CgroupCustomSettings", "traits": { "smithy.api#documentation": "

Additional Cgroup-specific configuration that directly maps to Cgroup settings.

" } }, "jobSubmitPlugins": { "target": "com.amazonaws.pcs#JobSubmitPluginList", "traits": { "smithy.api#documentation": "

The job submit plugins to run on the cluster controller. Use job submit plugins to execute custom scripts during job submission and job modification to validate or modify the job's configuration. Custom scripts can accept or reject jobs based on their configuration or modify the configuration before job execution.

" } }, "accounting": { "target": "com.amazonaws.pcs#AccountingRequest", "traits": { "smithy.api#documentation": "

The accounting configuration includes configurable settings for Slurm accounting.

" } }, "slurmRest": { "target": "com.amazonaws.pcs#SlurmRestRequest", "traits": { "smithy.api#documentation": "

The Slurm REST API configuration for the cluster.

" } } }, "traits": { "smithy.api#documentation": "

Additional options related to the Slurm scheduler.

" } }, "com.amazonaws.pcs#ClusterStatus": { "type": "enum", "members": { "CREATING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "CREATING" } }, "ACTIVE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "ACTIVE" } }, "UPDATING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "UPDATING" } }, "DELETING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "DELETING" } }, "CREATE_FAILED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "CREATE_FAILED" } }, "DELETE_FAILED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "DELETE_FAILED" } }, "UPDATE_FAILED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "UPDATE_FAILED" } }, "SUSPENDING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "SUSPENDING" } }, "SUSPENDED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "SUSPENDED" } }, "RESUMING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "RESUMING" } } } }, "com.amazonaws.pcs#ClusterSummary": { "type": "structure", "members": { "name": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The name that identifies the cluster.

", "smithy.api#required": {} } }, "id": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The generated unique ID of the cluster.

", "smithy.api#required": {} } }, "arn": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The unique Amazon Resource Name (ARN) of the cluster.

", "smithy.api#required": {} } }, "createdAt": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "

The date and time the resource was created.

", "smithy.api#required": {}, "smithy.api#timestampFormat": "date-time" } }, "modifiedAt": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "

The date and time the resource was modified.

", "smithy.api#required": {}, "smithy.api#timestampFormat": "date-time" } }, "status": { "target": "com.amazonaws.pcs#ClusterStatus", "traits": { "smithy.api#documentation": "

The provisioning status of the cluster.

The provisioning status doesn't indicate the overall health of the cluster.

The resource enters the SUSPENDING and SUSPENDED states when the scheduler is beyond end of life and we have suspended the cluster. When in these states, you can't use the cluster. The cluster controller is down and all compute instances are terminated. The resources still count toward your service quotas. You can delete a resource if its status is SUSPENDED. For more information, see Frequently asked questions about Slurm versions in PCS in the PCS User Guide.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

The object returned by the ListClusters API action.

" } }, "com.amazonaws.pcs#ComputeNodeGroup": { "type": "structure", "members": { "amiId": { "target": "com.amazonaws.pcs#AmiId", "traits": { "smithy.api#documentation": "

The ID of the Amazon Machine Image (AMI) that PCS uses to launch instances. If not present, PCS uses the AMI ID specified in the custom launch template.

" } }, "securityGroupIds": { "target": "com.amazonaws.pcs#SecurityGroupIdList", "traits": { "smithy.api#documentation": "

The IDs of the EC2 security groups configured directly on the compute node group. PCS uses these security groups instead of the security groups in the custom launch template. This value isn't present if security groups aren't configured directly on the compute node group. In that case, PCS uses the security groups in the custom launch template.

" } }, "sshKeyName": { "target": "com.amazonaws.pcs#KeyPairName", "traits": { "smithy.api#documentation": "

The name of the EC2 key pair configured directly on the compute node group. PCS uses this key pair instead of the key pair in the custom launch template. This value isn't present if a key pair isn't configured directly on the compute node group. In that case, PCS uses the key pair in the custom launch template, if one is specified.

" } }, "name": { "target": "com.amazonaws.pcs#ComputeNodeGroupName", "traits": { "smithy.api#documentation": "

The name that identifies the compute node group.

", "smithy.api#required": {} } }, "id": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The generated unique ID of the compute node group.

", "smithy.api#required": {} } }, "arn": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The unique Amazon Resource Name (ARN) of the compute node group.

", "smithy.api#required": {} } }, "clusterId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The ID of the cluster of the compute node group.

", "smithy.api#required": {} } }, "createdAt": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "

The date and time the resource was created.

", "smithy.api#required": {}, "smithy.api#timestampFormat": "date-time" } }, "modifiedAt": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "

The date and time the resource was modified.

", "smithy.api#required": {}, "smithy.api#timestampFormat": "date-time" } }, "status": { "target": "com.amazonaws.pcs#ComputeNodeGroupStatus", "traits": { "smithy.api#documentation": "

The provisioning status of the compute node group.

The provisioning status doesn't indicate the overall health of the compute node group.

The resource enters the SUSPENDING and SUSPENDED states when the scheduler is beyond end of life and we have suspended the cluster. When in these states, you can't use the cluster. The cluster controller is down and all compute instances are terminated. The resources still count toward your service quotas. You can delete a resource if its status is SUSPENDED. For more information, see Frequently asked questions about Slurm versions in PCS in the PCS User Guide.

", "smithy.api#required": {} } }, "subnetIds": { "target": "com.amazonaws.pcs#SubnetIdList", "traits": { "smithy.api#documentation": "

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.

", "smithy.api#required": {} } }, "purchaseOption": { "target": "com.amazonaws.pcs#PurchaseOption", "traits": { "smithy.api#documentation": "

Specifies how EC2 instances are purchased on your behalf. PCS supports On-Demand Instances, Spot Instances, Interruptible Capacity Reservations, On-Demand Capacity Reservations, and Amazon EC2 Capacity Blocks for ML. For more information, see Amazon EC2 billing and purchasing options in the Amazon Elastic Compute Cloud User Guide. For more information about PCS support for Capacity Blocks, see Using Amazon EC2 Capacity Blocks for ML with PCS in the PCS User Guide. For more information about PCS support for interruptible capacity reservations, see Using I-ODCRs with PCS in the PCS User Guide. Choose On-Demand if you plan to use an On-Demand Capacity Reservation (ODCR). For more information, see Using ODCRs with PCS. If you don't provide this option, it defaults to On-Demand.

" } }, "launchTemplateMode": { "target": "com.amazonaws.pcs#LaunchTemplateMode", "traits": { "smithy.api#default": "CUSTOM", "smithy.api#documentation": "

Indicates whether the compute node group uses a custom launch template or a launch template that PCS manages. The default value is CUSTOM.

Valid values:

" } }, "customLaunchTemplate": { "target": "com.amazonaws.pcs#CustomLaunchTemplate", "traits": { "smithy.api#documentation": "

The custom Amazon EC2 launch template associated with the compute node group. This value is present when launchTemplateMode is CUSTOM and isn't present when launchTemplateMode is MANAGED.

" } }, "iamInstanceProfileArn": { "target": "com.amazonaws.pcs#InstanceProfileArn", "traits": { "smithy.api#documentation": "

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 and the role name must start with AWSPCS or must have the path /aws-pcs/. For more information, see IAM instance profiles for PCS in the PCS User Guide.

", "smithy.api#required": {} } }, "scalingConfiguration": { "target": "com.amazonaws.pcs#ScalingConfiguration", "traits": { "smithy.api#required": {} } }, "instanceConfigs": { "target": "com.amazonaws.pcs#InstanceList", "traits": { "smithy.api#documentation": "

A list of EC2 instance configurations that PCS can provision in the compute node group.

", "smithy.api#required": {} } }, "spotOptions": { "target": "com.amazonaws.pcs#SpotOptions" }, "slurmConfiguration": { "target": "com.amazonaws.pcs#ComputeNodeGroupSlurmConfiguration" }, "nodeLifecycleActions": { "target": "com.amazonaws.pcs#NodeLifecycleActions", "traits": { "smithy.api#documentation": "

The lifecycle actions to run on compute nodes in the compute node group. Use lifecycle actions to run custom scripts at defined stages of a compute node's lifecycle, such as when a compute node finishes bootstrapping or becomes ready to accept jobs.

" } }, "errorInfo": { "target": "com.amazonaws.pcs#ErrorInfoList", "traits": { "smithy.api#documentation": "

The list of errors that occurred during compute node group provisioning.

" } } }, "traits": { "smithy.api#documentation": "

A compute node group associated with a cluster.

" } }, "com.amazonaws.pcs#ComputeNodeGroupConfiguration": { "type": "structure", "members": { "computeNodeGroupId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The compute node group ID for the compute node group configuration.

" } } }, "traits": { "smithy.api#documentation": "

The compute node group configuration for a queue.

" } }, "com.amazonaws.pcs#ComputeNodeGroupConfigurationList": { "type": "list", "member": { "target": "com.amazonaws.pcs#ComputeNodeGroupConfiguration" } }, "com.amazonaws.pcs#ComputeNodeGroupIdentifier": { "type": "string", "traits": { "smithy.api#pattern": "^(pcs_[a-zA-Z0-9]+|[A-Za-z][A-Za-z0-9-]{2,25})$" } }, "com.amazonaws.pcs#ComputeNodeGroupList": { "type": "list", "member": { "target": "com.amazonaws.pcs#ComputeNodeGroupSummary" } }, "com.amazonaws.pcs#ComputeNodeGroupName": { "type": "string", "traits": { "smithy.api#length": { "min": 3, "max": 25 }, "smithy.api#pattern": "^(?!pcs_)^[A-Za-z][A-Za-z0-9-]+$" } }, "com.amazonaws.pcs#ComputeNodeGroupResource": { "type": "resource", "identifiers": { "clusterIdentifier": { "target": "com.amazonaws.pcs#ClusterIdentifier" }, "computeNodeGroupIdentifier": { "target": "com.amazonaws.pcs#ComputeNodeGroupIdentifier" } }, "create": { "target": "com.amazonaws.pcs#CreateComputeNodeGroup" }, "update": { "target": "com.amazonaws.pcs#UpdateComputeNodeGroup" }, "operations": [ { "target": "com.amazonaws.pcs#DeleteComputeNodeGroup" }, { "target": "com.amazonaws.pcs#GetComputeNodeGroup" } ], "collectionOperations": [ { "target": "com.amazonaws.pcs#ListComputeNodeGroups" } ], "traits": { "aws.api#arn": { "template": "cluster/{clusterIdentifier}/computenodegroup/{computeNodeGroupIdentifier}" }, "aws.iam#conditionKeys": [ "aws:ResourceTag/${TagKey}" ], "aws.iam#iamResource": { "name": "computenodegroup" } } }, "com.amazonaws.pcs#ComputeNodeGroupSlurmConfiguration": { "type": "structure", "members": { "scaleDownIdleTimeInSeconds": { "target": "smithy.api#Integer", "traits": { "smithy.api#documentation": "

The time (in seconds) before an idle node is scaled down. If not specified, the cluster-level setting applies. This overrides the cluster-level scaleDownIdleTimeInSeconds setting. A value of -1 removes the override and applies the cluster-level setting to this compute node group. Requires Slurm version 25.11 or later.

", "smithy.api#range": { "min": -1, "max": 10000000 } } }, "slurmCustomSettings": { "target": "com.amazonaws.pcs#SlurmCustomSettings", "traits": { "smithy.api#documentation": "

Additional Slurm-specific configuration that directly maps to Slurm settings.

" } }, "gresCustomSettings": { "target": "com.amazonaws.pcs#GresCustomSettings", "traits": { "smithy.api#documentation": "

The additional Slurm gres.conf records for the compute node group. Each item is a map of gres.conf attribute names to values that describes one gres.conf record, such as a GPU topology, MIG, MPS, or custom GRES entry. PCS adds the NodeName= prefix and merges these records with the GPU record it derives from the instance type.

" } } }, "traits": { "smithy.api#documentation": "

Additional options related to the Slurm scheduler.

" } }, "com.amazonaws.pcs#ComputeNodeGroupSlurmConfigurationRequest": { "type": "structure", "members": { "scaleDownIdleTimeInSeconds": { "target": "smithy.api#Integer", "traits": { "smithy.api#documentation": "

The time (in seconds) before an idle node is scaled down. If not specified, the cluster-level setting applies. This overrides the cluster-level scaleDownIdleTimeInSeconds setting. A value of -1 removes the override and applies the cluster-level setting to this compute node group. Requires Slurm version 25.11 or later.

", "smithy.api#range": { "min": -1, "max": 10000000 } } }, "slurmCustomSettings": { "target": "com.amazonaws.pcs#SlurmCustomSettings", "traits": { "smithy.api#documentation": "

Additional Slurm-specific configuration that directly maps to Slurm settings.

" } }, "gresCustomSettings": { "target": "com.amazonaws.pcs#GresCustomSettings", "traits": { "smithy.api#documentation": "

The additional Slurm gres.conf records for the compute node group. Each item is a map of gres.conf attribute names to values that describes one gres.conf record, such as a GPU topology, MIG, MPS, or custom GRES entry. PCS adds the NodeName= prefix and merges these records with the GPU record it derives from the instance type.

" } } }, "traits": { "smithy.api#documentation": "

Additional options related to the Slurm scheduler.

" } }, "com.amazonaws.pcs#ComputeNodeGroupStatus": { "type": "enum", "members": { "CREATING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "CREATING" } }, "ACTIVE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "ACTIVE" } }, "UPDATING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "UPDATING" } }, "DELETING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "DELETING" } }, "CREATE_FAILED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "CREATE_FAILED" } }, "DELETE_FAILED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "DELETE_FAILED" } }, "UPDATE_FAILED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "UPDATE_FAILED" } }, "DELETED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "DELETED" } }, "SUSPENDING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "SUSPENDING" } }, "SUSPENDED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "SUSPENDED" } }, "RESUMING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "RESUMING" } } } }, "com.amazonaws.pcs#ComputeNodeGroupSummary": { "type": "structure", "members": { "name": { "target": "com.amazonaws.pcs#ComputeNodeGroupName", "traits": { "smithy.api#documentation": "

The name that identifies the compute node group.

", "smithy.api#required": {} } }, "id": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The generated unique ID of the compute node group.

", "smithy.api#required": {} } }, "arn": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The unique Amazon Resource Name (ARN) of the compute node group.

", "smithy.api#required": {} } }, "clusterId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The ID of the cluster of the compute node group.

", "smithy.api#required": {} } }, "createdAt": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "

The date and time the resource was created.

", "smithy.api#required": {}, "smithy.api#timestampFormat": "date-time" } }, "modifiedAt": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "

The date and time the resource was modified.

", "smithy.api#required": {}, "smithy.api#timestampFormat": "date-time" } }, "status": { "target": "com.amazonaws.pcs#ComputeNodeGroupStatus", "traits": { "smithy.api#documentation": "

The provisioning status of the compute node group.

The provisioning status doesn't indicate the overall health of the compute node group.

The resource enters the SUSPENDING and SUSPENDED states when the scheduler is beyond end of life and we have suspended the cluster. When in these states, you can't use the cluster. The cluster controller is down and all compute instances are terminated. The resources still count toward your service quotas. You can delete a resource if its status is SUSPENDED. For more information, see Frequently asked questions about Slurm versions in PCS in the PCS User Guide.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

The object returned by the ListComputeNodeGroups API action.

" } }, "com.amazonaws.pcs#ConflictException": { "type": "structure", "members": { "message": { "target": "smithy.api#String", "traits": { "smithy.api#required": {} } }, "resourceId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The unique identifier of the resource that caused the conflict exception.

", "smithy.api#required": {} } }, "resourceType": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The type or category of the resource that caused the conflict exception.\"

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

Your request has conflicting operations. This can occur if you're trying to perform more than 1 operation on the same resource at the same time.

Examples

", "smithy.api#error": "client", "smithy.api#httpError": 409 } }, "com.amazonaws.pcs#CreateCluster": { "type": "operation", "input": { "target": "com.amazonaws.pcs#CreateClusterRequest" }, "output": { "target": "com.amazonaws.pcs#CreateClusterResponse" }, "errors": [ { "target": "com.amazonaws.pcs#AccessDeniedException" }, { "target": "com.amazonaws.pcs#ConflictException" }, { "target": "com.amazonaws.pcs#InternalServerException" }, { "target": "com.amazonaws.pcs#ServiceQuotaExceededException" }, { "target": "com.amazonaws.pcs#ThrottlingException" }, { "target": "com.amazonaws.pcs#ValidationException" } ], "traits": { "aws.iam#conditionKeys": [ "aws:RequestTag/${TagKey}", "aws:TagKeys" ], "smithy.api#documentation": "

Creates a cluster in your account. 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 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.

", "smithy.api#idempotent": {}, "smithy.api#tags": [ "Cluster" ] } }, "com.amazonaws.pcs#CreateClusterRequest": { "type": "structure", "members": { "clusterName": { "target": "com.amazonaws.pcs#ClusterName", "traits": { "aws.iam#conditionKeyValue": "pcs:ResourceName", "smithy.api#documentation": "

A name to identify the cluster. Example: MyCluster

", "smithy.api#required": {} } }, "scheduler": { "target": "com.amazonaws.pcs#SchedulerRequest", "traits": { "smithy.api#documentation": "

The cluster management and job scheduling software associated with the cluster.

", "smithy.api#required": {} } }, "size": { "target": "com.amazonaws.pcs#Size", "traits": { "smithy.api#documentation": "

A value that determines the maximum number of compute nodes in the cluster and the maximum number of jobs (active and queued).

", "smithy.api#required": {} } }, "networking": { "target": "com.amazonaws.pcs#NetworkingRequest", "traits": { "smithy.api#documentation": "

The networking configuration used to set up the cluster's control plane.

", "smithy.api#required": {} } }, "slurmConfiguration": { "target": "com.amazonaws.pcs#ClusterSlurmConfigurationRequest", "traits": { "smithy.api#documentation": "

Additional options related to the Slurm scheduler.

" } }, "clientToken": { "target": "com.amazonaws.pcs#SBClientToken", "traits": { "smithy.api#documentation": "

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 one for you.

", "smithy.api#idempotencyToken": {} } }, "tags": { "target": "com.amazonaws.pcs#RequestTagMap", "traits": { "smithy.api#documentation": "

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.

" } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.pcs#CreateClusterResponse": { "type": "structure", "members": { "cluster": { "target": "com.amazonaws.pcs#Cluster", "traits": { "smithy.api#documentation": "

The cluster resource.

" } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.pcs#CreateComputeNodeGroup": { "type": "operation", "input": { "target": "com.amazonaws.pcs#CreateComputeNodeGroupRequest" }, "output": { "target": "com.amazonaws.pcs#CreateComputeNodeGroupResponse" }, "errors": [ { "target": "com.amazonaws.pcs#AccessDeniedException" }, { "target": "com.amazonaws.pcs#ConflictException" }, { "target": "com.amazonaws.pcs#InternalServerException" }, { "target": "com.amazonaws.pcs#ResourceNotFoundException" }, { "target": "com.amazonaws.pcs#ServiceQuotaExceededException" }, { "target": "com.amazonaws.pcs#ThrottlingException" }, { "target": "com.amazonaws.pcs#ValidationException" } ], "traits": { "aws.iam#conditionKeys": [ "aws:RequestTag/${TagKey}", "aws:TagKeys" ], "smithy.api#documentation": "

Creates a managed set of compute nodes. You associate a compute node group with a cluster through 1 or more PCS queues or as part of the login fleet. A compute node group includes the definition of the compute properties and lifecycle management. 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 PCS launches in your account. You can configure common instance settings, such as the AMI, security groups, and SSH key pair, directly on the compute node group, or you can provide a custom EC2 launch template. To use a launch template that PCS manages, set launchTemplateMode to MANAGED and don't provide customLaunchTemplate. In this case, you must specify amiId and securityGroupIds. For more information, see Configuring instance settings for compute node groups in PCS in the PCS User Guide.

", "smithy.api#idempotent": {}, "smithy.api#tags": [ "ComputeNodeGroup" ], "smithy.test#smokeTests": [ { "id": "InstanceArnSuccess", "params": { "clusterIdentifier": "testCluster", "computeNodeGroupName": "testNodeGroupName", "subnetIds": [ "subnet-0cbf727bae9405b47" ], "scalingConfiguration": { "minInstanceCount": 1, "maxInstanceCount": 1 }, "iamInstanceProfileArn": "arn:aws:iam::975050141277:instance-profile/aws-pcs/example-role-2", "customLaunchTemplate": { "id": "lt-0b8f8ee3f92b73dc0", "version": "1" }, "instanceConfigs": [ { "instanceType": "t3.medium" } ] }, "expect": { "failure": { "errorId": "com.amazonaws.pcs#AccessDeniedException" } }, "vendorParamsShape": "aws.test#AwsVendorParams", "vendorParams": { "region": "us-east-1" } } ] } }, "com.amazonaws.pcs#CreateComputeNodeGroupRequest": { "type": "structure", "members": { "amiId": { "target": "com.amazonaws.pcs#AmiId", "traits": { "smithy.api#documentation": "

The ID of the Amazon Machine Image (AMI) that PCS uses to launch compute nodes (Amazon EC2 instances). This value overrides the AMI ID in the custom launch template. If you don't provide this value, PCS uses the AMI ID specified in the custom launch template. You must provide this value if launchTemplateMode is MANAGED.

" } }, "securityGroupIds": { "target": "com.amazonaws.pcs#SecurityGroupIdList", "traits": { "smithy.api#documentation": "

The IDs of the EC2 security groups to configure directly on the compute node group. The security groups must be in the same VPC as the cluster. PCS uses these security groups instead of the security groups in the custom launch template. You can't specify this value if the custom launch template defines network interfaces. If you don't provide this value, PCS uses the security groups in the custom launch template. You must provide this value if launchTemplateMode is MANAGED. For more information, see Configuring instance settings for compute node groups in PCS in the PCS User Guide.

" } }, "sshKeyName": { "target": "com.amazonaws.pcs#KeyPairName", "traits": { "smithy.api#documentation": "

The name of the EC2 key pair to configure directly on the compute node group. The key pair must exist in your account and Amazon Web Services Region. PCS uses this key pair instead of the key pair in the custom launch template. If you don't provide this value, PCS uses the key pair in the custom launch template, if one is specified. You must have permission for ec2:DescribeKeyPairs. If you delete the key pair later, future instance launches can fail. For more information, see Configuring instance settings for compute node groups in PCS in the PCS User Guide.

" } }, "clusterIdentifier": { "target": "com.amazonaws.pcs#ClusterIdentifier", "traits": { "smithy.api#documentation": "

The name or ID of the cluster to create a compute node group in.

", "smithy.api#required": {} } }, "computeNodeGroupName": { "target": "com.amazonaws.pcs#ComputeNodeGroupName", "traits": { "aws.iam#conditionKeyValue": "pcs:ResourceName", "smithy.api#documentation": "

A name to identify the cluster. Example: MyCluster

", "smithy.api#required": {} } }, "subnetIds": { "target": "com.amazonaws.pcs#StringList", "traits": { "smithy.api#documentation": "

The list of subnet IDs where the compute node group launches instances. Subnets must be in the same VPC as the cluster.

", "smithy.api#required": {} } }, "purchaseOption": { "target": "com.amazonaws.pcs#PurchaseOption", "traits": { "smithy.api#documentation": "

Specifies how EC2 instances are purchased on your behalf. PCS supports On-Demand Instances, Spot Instances, Interruptible Capacity Reservations, On-Demand Capacity Reservations, and Amazon EC2 Capacity Blocks for ML. For more information, see Amazon EC2 billing and purchasing options in the Amazon Elastic Compute Cloud User Guide. For more information about PCS support for Capacity Blocks, see Using Amazon EC2 Capacity Blocks for ML with PCS in the PCS User Guide. For more information about PCS support for interruptible capacity reservations, see Using I-ODCRs with PCS in the PCS User Guide. Choose On-Demand if you plan to use an On-Demand Capacity Reservation (ODCR). For more information, see Using ODCRs with PCS. If you don't provide this option, it defaults to On-Demand.

" } }, "launchTemplateMode": { "target": "com.amazonaws.pcs#LaunchTemplateMode", "traits": { "smithy.api#default": "CUSTOM", "smithy.api#documentation": "

Specifies whether the compute node group uses a custom launch template or a launch template that PCS manages. The default value is CUSTOM.

If the value is CUSTOM, provide customLaunchTemplate. If the value is MANAGED, omit customLaunchTemplate and provide amiId and securityGroupIds.

" } }, "customLaunchTemplate": { "target": "com.amazonaws.pcs#CustomLaunchTemplate", "traits": { "smithy.api#documentation": "

The custom Amazon EC2 launch template to associate with the compute node group. Specify the launch template id and version when launchTemplateMode is CUSTOM. Don't specify this value when launchTemplateMode is MANAGED.

" } }, "iamInstanceProfileArn": { "target": "com.amazonaws.pcs#InstanceProfileArn", "traits": { "smithy.api#documentation": "

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 and the role name must start with AWSPCS or must have the path /aws-pcs/. For more information, see IAM instance profiles for PCS in the PCS User Guide.

", "smithy.api#required": {} } }, "scalingConfiguration": { "target": "com.amazonaws.pcs#ScalingConfigurationRequest", "traits": { "smithy.api#documentation": "

Specifies the boundaries of the compute node group auto scaling.

", "smithy.api#required": {} } }, "instanceConfigs": { "target": "com.amazonaws.pcs#InstanceList", "traits": { "smithy.api#documentation": "

A list of EC2 instance configurations that PCS can provision in the compute node group.

", "smithy.api#required": {} } }, "spotOptions": { "target": "com.amazonaws.pcs#SpotOptions" }, "slurmConfiguration": { "target": "com.amazonaws.pcs#ComputeNodeGroupSlurmConfigurationRequest", "traits": { "smithy.api#documentation": "

Additional options related to the Slurm scheduler.

" } }, "nodeLifecycleActions": { "target": "com.amazonaws.pcs#NodeLifecycleActionsRequest", "traits": { "smithy.api#documentation": "

The lifecycle actions to run on compute nodes in the compute node group. Use lifecycle actions to run custom scripts at defined stages of a compute node's lifecycle, such as when a compute node finishes bootstrapping or becomes ready to accept jobs.

" } }, "clientToken": { "target": "com.amazonaws.pcs#SBClientToken", "traits": { "smithy.api#documentation": "

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 one for you.

", "smithy.api#idempotencyToken": {} } }, "tags": { "target": "com.amazonaws.pcs#RequestTagMap", "traits": { "smithy.api#documentation": "

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.

" } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.pcs#CreateComputeNodeGroupResponse": { "type": "structure", "members": { "computeNodeGroup": { "target": "com.amazonaws.pcs#ComputeNodeGroup" } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.pcs#CreateQueue": { "type": "operation", "input": { "target": "com.amazonaws.pcs#CreateQueueRequest" }, "output": { "target": "com.amazonaws.pcs#CreateQueueResponse" }, "errors": [ { "target": "com.amazonaws.pcs#AccessDeniedException" }, { "target": "com.amazonaws.pcs#ConflictException" }, { "target": "com.amazonaws.pcs#InternalServerException" }, { "target": "com.amazonaws.pcs#ResourceNotFoundException" }, { "target": "com.amazonaws.pcs#ServiceQuotaExceededException" }, { "target": "com.amazonaws.pcs#ThrottlingException" }, { "target": "com.amazonaws.pcs#ValidationException" } ], "traits": { "aws.iam#conditionKeys": [ "aws:RequestTag/${TagKey}", "aws:TagKeys" ], "smithy.api#documentation": "

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.

", "smithy.api#idempotent": {}, "smithy.api#tags": [ "Queue" ] } }, "com.amazonaws.pcs#CreateQueueRequest": { "type": "structure", "members": { "clusterIdentifier": { "target": "com.amazonaws.pcs#ClusterIdentifier", "traits": { "smithy.api#documentation": "

The name or ID of the cluster for which to create a queue.

", "smithy.api#required": {} } }, "queueName": { "target": "com.amazonaws.pcs#QueueName", "traits": { "aws.iam#conditionKeyValue": "pcs:ResourceName", "smithy.api#documentation": "

A name to identify the queue.

", "smithy.api#required": {} } }, "computeNodeGroupConfigurations": { "target": "com.amazonaws.pcs#ComputeNodeGroupConfigurationList", "traits": { "smithy.api#documentation": "

The list of compute node group configurations to associate with the queue. Queues assign jobs to associated compute node groups.

" } }, "slurmConfiguration": { "target": "com.amazonaws.pcs#QueueSlurmConfigurationRequest", "traits": { "smithy.api#documentation": "

Additional options related to the Slurm scheduler.

" } }, "clientToken": { "target": "com.amazonaws.pcs#SBClientToken", "traits": { "smithy.api#documentation": "

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 one for you.

", "smithy.api#idempotencyToken": {} } }, "tags": { "target": "com.amazonaws.pcs#RequestTagMap", "traits": { "smithy.api#documentation": "

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.

" } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.pcs#CreateQueueResponse": { "type": "structure", "members": { "queue": { "target": "com.amazonaws.pcs#Queue" } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.pcs#CustomLaunchTemplate": { "type": "structure", "members": { "id": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The ID of the EC2 launch template to use to provision instances. Specify this value together with version.

Example: lt-xxxx

", "smithy.api#required": {} } }, "version": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The version of the EC2 launch template to use to provision instances. Specify this value together with id.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

An Amazon EC2 launch template PCS uses to launch compute nodes. The structure contains the launch template ID and version.

" } }, "com.amazonaws.pcs#DeleteCluster": { "type": "operation", "input": { "target": "com.amazonaws.pcs#DeleteClusterRequest" }, "output": { "target": "com.amazonaws.pcs#DeleteClusterResponse" }, "errors": [ { "target": "com.amazonaws.pcs#AccessDeniedException" }, { "target": "com.amazonaws.pcs#ConflictException" }, { "target": "com.amazonaws.pcs#InternalServerException" }, { "target": "com.amazonaws.pcs#ResourceNotFoundException" }, { "target": "com.amazonaws.pcs#ThrottlingException" }, { "target": "com.amazonaws.pcs#ValidationException" } ], "traits": { "smithy.api#documentation": "

Deletes a cluster and all its linked resources. You must delete all queues and compute node groups associated with the cluster before you can delete the cluster.

", "smithy.api#idempotent": {}, "smithy.api#tags": [ "Cluster" ] } }, "com.amazonaws.pcs#DeleteClusterRequest": { "type": "structure", "members": { "clusterIdentifier": { "target": "com.amazonaws.pcs#ClusterIdentifier", "traits": { "smithy.api#documentation": "

The name or ID of the cluster to delete.

", "smithy.api#required": {} } }, "clientToken": { "target": "com.amazonaws.pcs#SBClientToken", "traits": { "smithy.api#documentation": "

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 one for you.

", "smithy.api#idempotencyToken": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.pcs#DeleteClusterResponse": { "type": "structure", "members": {}, "traits": { "smithy.api#output": {} } }, "com.amazonaws.pcs#DeleteComputeNodeGroup": { "type": "operation", "input": { "target": "com.amazonaws.pcs#DeleteComputeNodeGroupRequest" }, "output": { "target": "com.amazonaws.pcs#DeleteComputeNodeGroupResponse" }, "errors": [ { "target": "com.amazonaws.pcs#AccessDeniedException" }, { "target": "com.amazonaws.pcs#ConflictException" }, { "target": "com.amazonaws.pcs#InternalServerException" }, { "target": "com.amazonaws.pcs#ResourceNotFoundException" }, { "target": "com.amazonaws.pcs#ThrottlingException" }, { "target": "com.amazonaws.pcs#ValidationException" } ], "traits": { "smithy.api#documentation": "

Deletes a compute node group. You must delete all queues associated with the compute node group first.

", "smithy.api#idempotent": {}, "smithy.api#tags": [ "ComputeNodeGroup" ] } }, "com.amazonaws.pcs#DeleteComputeNodeGroupRequest": { "type": "structure", "members": { "clusterIdentifier": { "target": "com.amazonaws.pcs#ClusterIdentifier", "traits": { "smithy.api#documentation": "

The name or ID of the cluster of the compute node group.

", "smithy.api#required": {} } }, "computeNodeGroupIdentifier": { "target": "com.amazonaws.pcs#ComputeNodeGroupIdentifier", "traits": { "smithy.api#documentation": "

The name or ID of the compute node group to delete.

", "smithy.api#required": {} } }, "clientToken": { "target": "com.amazonaws.pcs#SBClientToken", "traits": { "smithy.api#documentation": "

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 one for you.

", "smithy.api#idempotencyToken": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.pcs#DeleteComputeNodeGroupResponse": { "type": "structure", "members": {}, "traits": { "smithy.api#output": {} } }, "com.amazonaws.pcs#DeleteQueue": { "type": "operation", "input": { "target": "com.amazonaws.pcs#DeleteQueueRequest" }, "output": { "target": "com.amazonaws.pcs#DeleteQueueResponse" }, "errors": [ { "target": "com.amazonaws.pcs#AccessDeniedException" }, { "target": "com.amazonaws.pcs#ConflictException" }, { "target": "com.amazonaws.pcs#InternalServerException" }, { "target": "com.amazonaws.pcs#ResourceNotFoundException" }, { "target": "com.amazonaws.pcs#ThrottlingException" }, { "target": "com.amazonaws.pcs#ValidationException" } ], "traits": { "smithy.api#documentation": "

Deletes a job queue. If the compute node group associated with this queue isn't associated with any other queues, PCS terminates all the compute nodes for this queue.

", "smithy.api#idempotent": {}, "smithy.api#tags": [ "Queue" ] } }, "com.amazonaws.pcs#DeleteQueueRequest": { "type": "structure", "members": { "clusterIdentifier": { "target": "com.amazonaws.pcs#ClusterIdentifier", "traits": { "smithy.api#documentation": "

The name or ID of the cluster of the queue.

", "smithy.api#required": {} } }, "queueIdentifier": { "target": "com.amazonaws.pcs#QueueIdentifier", "traits": { "smithy.api#documentation": "

The name or ID of the queue to delete.

", "smithy.api#required": {} } }, "clientToken": { "target": "com.amazonaws.pcs#SBClientToken", "traits": { "smithy.api#documentation": "

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 one for you.

", "smithy.api#idempotencyToken": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.pcs#DeleteQueueResponse": { "type": "structure", "members": {}, "traits": { "smithy.api#output": {} } }, "com.amazonaws.pcs#Endpoint": { "type": "structure", "members": { "type": { "target": "com.amazonaws.pcs#EndpointType", "traits": { "smithy.api#documentation": "

Indicates the type of endpoint running at the specific IP address.

", "smithy.api#required": {} } }, "privateIpAddress": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

For clusters that use IPv4, this is the endpoint's private IP address.

Example: 10.1.2.3

For clusters configured to use IPv6, this is an empty string.

", "smithy.api#required": {} } }, "publicIpAddress": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The endpoint's public IP address.

Example: 192.0.2.1

" } }, "ipv6Address": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The endpoint's IPv6 address.

Example: 2001:db8::1

" } }, "port": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The endpoint's connection port number.

Example: 1234

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

An endpoint available for interaction with the scheduler.

" } }, "com.amazonaws.pcs#EndpointType": { "type": "enum", "members": { "SLURMCTLD": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "SLURMCTLD" } }, "SLURMDBD": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "SLURMDBD" } }, "SLURMRESTD": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "SLURMRESTD" } } } }, "com.amazonaws.pcs#Endpoints": { "type": "list", "member": { "target": "com.amazonaws.pcs#Endpoint" } }, "com.amazonaws.pcs#ErrorInfo": { "type": "structure", "members": { "code": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The short-form error code.

" } }, "message": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The detailed error information.

" } } }, "traits": { "smithy.api#documentation": "

An error that occurred during resource creation.

" } }, "com.amazonaws.pcs#ErrorInfoList": { "type": "list", "member": { "target": "com.amazonaws.pcs#ErrorInfo" } }, "com.amazonaws.pcs#ExecutionPolicy": { "type": "enum", "members": { "FIRST_BOOT_ONLY": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "FIRST_BOOT_ONLY" } }, "EVERY_BOOT": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "EVERY_BOOT" } } }, "traits": { "smithy.api#documentation": "

The policy that determines when a node lifecycle script runs. Valid values:

" } }, "com.amazonaws.pcs#GetCluster": { "type": "operation", "input": { "target": "com.amazonaws.pcs#GetClusterRequest" }, "output": { "target": "com.amazonaws.pcs#GetClusterResponse" }, "errors": [ { "target": "com.amazonaws.pcs#AccessDeniedException" }, { "target": "com.amazonaws.pcs#ConflictException" }, { "target": "com.amazonaws.pcs#InternalServerException" }, { "target": "com.amazonaws.pcs#ResourceNotFoundException" }, { "target": "com.amazonaws.pcs#ThrottlingException" }, { "target": "com.amazonaws.pcs#ValidationException" } ], "traits": { "smithy.api#documentation": "

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.

", "smithy.api#readonly": {}, "smithy.api#tags": [ "Cluster" ], "smithy.test#smokeTests": [ { "id": "GetCluster_AccessDeniedException", "params": { "clusterIdentifier": "pcs_donotexist" }, "expect": { "failure": { "errorId": "com.amazonaws.pcs#AccessDeniedException" } }, "vendorParamsShape": "aws.test#AwsVendorParams", "vendorParams": { "region": "us-west-2" } } ] } }, "com.amazonaws.pcs#GetClusterRequest": { "type": "structure", "members": { "clusterIdentifier": { "target": "com.amazonaws.pcs#ClusterIdentifier", "traits": { "smithy.api#documentation": "

The name or ID of the cluster.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.pcs#GetClusterResponse": { "type": "structure", "members": { "cluster": { "target": "com.amazonaws.pcs#Cluster", "traits": { "smithy.api#documentation": "

The cluster resource.

" } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.pcs#GetComputeNodeGroup": { "type": "operation", "input": { "target": "com.amazonaws.pcs#GetComputeNodeGroupRequest" }, "output": { "target": "com.amazonaws.pcs#GetComputeNodeGroupResponse" }, "errors": [ { "target": "com.amazonaws.pcs#AccessDeniedException" }, { "target": "com.amazonaws.pcs#ConflictException" }, { "target": "com.amazonaws.pcs#InternalServerException" }, { "target": "com.amazonaws.pcs#ResourceNotFoundException" }, { "target": "com.amazonaws.pcs#ThrottlingException" }, { "target": "com.amazonaws.pcs#ValidationException" } ], "traits": { "smithy.api#documentation": "

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.

", "smithy.api#readonly": {}, "smithy.api#tags": [ "ComputeNodeGroup" ], "smithy.test#smokeTests": [ { "id": "GetComputeNodeGroup_AccessDeniedException", "params": { "clusterIdentifier": "pcs_donotexist", "computeNodeGroupIdentifier": "pcs_donotexist" }, "expect": { "failure": { "errorId": "com.amazonaws.pcs#AccessDeniedException" } }, "vendorParamsShape": "aws.test#AwsVendorParams", "vendorParams": { "region": "us-west-2" } } ] } }, "com.amazonaws.pcs#GetComputeNodeGroupRequest": { "type": "structure", "members": { "clusterIdentifier": { "target": "com.amazonaws.pcs#ClusterIdentifier", "traits": { "smithy.api#documentation": "

The name or ID of the cluster.

", "smithy.api#required": {} } }, "computeNodeGroupIdentifier": { "target": "com.amazonaws.pcs#ComputeNodeGroupIdentifier", "traits": { "smithy.api#documentation": "

The name or ID of the compute node group.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.pcs#GetComputeNodeGroupResponse": { "type": "structure", "members": { "computeNodeGroup": { "target": "com.amazonaws.pcs#ComputeNodeGroup" } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.pcs#GetQueue": { "type": "operation", "input": { "target": "com.amazonaws.pcs#GetQueueRequest" }, "output": { "target": "com.amazonaws.pcs#GetQueueResponse" }, "errors": [ { "target": "com.amazonaws.pcs#AccessDeniedException" }, { "target": "com.amazonaws.pcs#ConflictException" }, { "target": "com.amazonaws.pcs#InternalServerException" }, { "target": "com.amazonaws.pcs#ResourceNotFoundException" }, { "target": "com.amazonaws.pcs#ThrottlingException" }, { "target": "com.amazonaws.pcs#ValidationException" } ], "traits": { "smithy.api#documentation": "

Returns detailed information about a queue. The information includes the compute node groups that the queue uses to schedule jobs.

", "smithy.api#readonly": {}, "smithy.api#tags": [ "Queue" ], "smithy.test#smokeTests": [ { "id": "GetQueueFailure_AccessDeniedException", "params": { "clusterIdentifier": "pcs_donotexist", "queueIdentifier": "pcs_donotexist" }, "expect": { "failure": { "errorId": "com.amazonaws.pcs#AccessDeniedException" } }, "vendorParamsShape": "aws.test#AwsVendorParams", "vendorParams": { "region": "us-west-2" } } ] } }, "com.amazonaws.pcs#GetQueueRequest": { "type": "structure", "members": { "clusterIdentifier": { "target": "com.amazonaws.pcs#ClusterIdentifier", "traits": { "smithy.api#documentation": "

The name or ID of the cluster of the queue.

", "smithy.api#required": {} } }, "queueIdentifier": { "target": "com.amazonaws.pcs#QueueIdentifier", "traits": { "smithy.api#documentation": "

The name or ID of the queue.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.pcs#GetQueueResponse": { "type": "structure", "members": { "queue": { "target": "com.amazonaws.pcs#Queue" } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.pcs#GresCustomSettingMap": { "type": "map", "key": { "target": "smithy.api#String" }, "value": { "target": "smithy.api#String" }, "traits": { "smithy.api#documentation": "

A single Slurm gres.conf record, expressed as a map of gres.conf attribute names to their values. For example, {\"Name\": \"gpu\", \"Type\": \"a100\", \"File\": \"/dev/nvidia[0-7]\"} or {\"AutoDetect\": \"nvml\"}. PCS adds the NodeName= prefix for the compute node group.

PCS supports a subset of gres.conf settings. For more information, see Configuring custom GRES settings in PCS in the PCS User Guide.

" } }, "com.amazonaws.pcs#GresCustomSettings": { "type": "list", "member": { "target": "com.amazonaws.pcs#GresCustomSettingMap" } }, "com.amazonaws.pcs#InstanceConfig": { "type": "structure", "members": { "instanceType": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The EC2 instance type that PCS can provision in the compute node group.

Example: t2.xlarge

" } } }, "traits": { "smithy.api#documentation": "

An EC2 instance configuration PCS uses to launch compute nodes.

" } }, "com.amazonaws.pcs#InstanceList": { "type": "list", "member": { "target": "com.amazonaws.pcs#InstanceConfig" } }, "com.amazonaws.pcs#InstanceProfileArn": { "type": "string", "traits": { "smithy.api#pattern": "^arn:aws([a-zA-Z-]{0,10})?:iam::[0-9]{12}:instance-profile/([!-~]{1,510}/)?([\\w+=,.@-]{1,128})$" } }, "com.amazonaws.pcs#InternalServerException": { "type": "structure", "members": { "message": { "target": "smithy.api#String", "traits": { "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

PCS can't process your request right now. Try again later.

", "smithy.api#error": "server", "smithy.api#httpError": 500, "smithy.api#retryable": {} } }, "com.amazonaws.pcs#JobSubmitPlugin": { "type": "structure", "members": { "name": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

A unique name for the plugin. The name can be up to 64 characters long. Valid characters are letters, numbers, spaces, underscores (_), and hyphens (-). The first character must be a letter or a number.

", "smithy.api#length": { "min": 1, "max": 64 }, "smithy.api#pattern": "^[A-Za-z0-9][A-Za-z0-9_-]*$", "smithy.api#required": {} } }, "type": { "target": "com.amazonaws.pcs#JobSubmitPluginType", "traits": { "smithy.api#documentation": "

The runtime language used to execute the custom script. Valid values:

", "smithy.api#required": {} } }, "scriptSource": { "target": "com.amazonaws.pcs#JobSubmitScriptSource", "traits": { "smithy.api#documentation": "

The source location and integrity information for the script.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

A job submit plugin configuration, including its name, runtime language, and script source.

" } }, "com.amazonaws.pcs#JobSubmitPluginList": { "type": "list", "member": { "target": "com.amazonaws.pcs#JobSubmitPlugin" }, "traits": { "smithy.api#length": { "min": 0, "max": 1 } } }, "com.amazonaws.pcs#JobSubmitPluginType": { "type": "enum", "members": { "STARLARK": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "STARLARK" } } }, "traits": { "smithy.api#documentation": "

The runtime language used to execute the custom script. Valid values:

" } }, "com.amazonaws.pcs#JobSubmitScriptSource": { "type": "structure", "members": { "scriptLocation": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The location of the script. Specify an Amazon S3 URI in the format s3://bucket-name/key.

", "smithy.api#length": { "min": 1, "max": 1024 }, "smithy.api#pattern": "^s3://[a-z0-9][a-z0-9.-]{1,61}[a-z0-9]/.+$", "smithy.api#required": {} } }, "s3VersionId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The Amazon S3 version ID of the script. Use this value to pin the script to a specific version in a versioned Amazon S3 bucket.

", "smithy.api#length": { "max": 1024 } } }, "checksum": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The SHA-256 checksum of the script content, as a 64-character hexadecimal string. This value is optional. When specified, PCS uses this value to verify the integrity of the downloaded script.

", "smithy.api#length": { "min": 64, "max": 64 }, "smithy.api#pattern": "^[a-fA-F0-9]{64}$" } } }, "traits": { "smithy.api#documentation": "

The source location and integrity information for the script.

" } }, "com.amazonaws.pcs#JwtAuth": { "type": "structure", "members": { "jwtKey": { "target": "com.amazonaws.pcs#JwtKey", "traits": { "smithy.api#documentation": "

The JWT key for Slurm REST API authentication.

" } } }, "traits": { "smithy.api#documentation": "

The JWT authentication configuration for Slurm REST API access.

" } }, "com.amazonaws.pcs#JwtKey": { "type": "structure", "members": { "secretArn": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The Amazon Resource Name (ARN) of the Amazon Web Services Secrets Manager secret containing the JWT key.

", "smithy.api#required": {} } }, "secretVersion": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The version of the Amazon Web Services Secrets Manager secret containing the JWT key.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

The JWT key stored in Amazon Web Services Secrets Manager for Slurm REST API authentication.

" } }, "com.amazonaws.pcs#KeyPairName": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 255 } } }, "com.amazonaws.pcs#KeyPairNameOrEmpty": { "type": "string", "traits": { "smithy.api#length": { "max": 255 } } }, "com.amazonaws.pcs#LaunchTemplateMode": { "type": "enum", "members": { "CUSTOM": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "CUSTOM" } }, "MANAGED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "MANAGED" } } } }, "com.amazonaws.pcs#ListClusters": { "type": "operation", "input": { "target": "com.amazonaws.pcs#ListClustersRequest" }, "output": { "target": "com.amazonaws.pcs#ListClustersResponse" }, "errors": [ { "target": "com.amazonaws.pcs#AccessDeniedException" }, { "target": "com.amazonaws.pcs#ConflictException" }, { "target": "com.amazonaws.pcs#InternalServerException" }, { "target": "com.amazonaws.pcs#ResourceNotFoundException" }, { "target": "com.amazonaws.pcs#ThrottlingException" }, { "target": "com.amazonaws.pcs#ValidationException" } ], "traits": { "smithy.api#documentation": "

Returns a list of running clusters in your account.

", "smithy.api#paginated": { "inputToken": "nextToken", "outputToken": "nextToken", "pageSize": "maxResults", "items": "clusters" }, "smithy.api#readonly": {}, "smithy.api#tags": [ "Cluster" ], "smithy.test#smokeTests": [ { "id": "ListClustersSuccess", "params": {}, "expect": { "success": {} }, "vendorParamsShape": "aws.test#AwsVendorParams", "vendorParams": { "region": "us-west-2" } } ] } }, "com.amazonaws.pcs#ListClustersRequest": { "type": "structure", "members": { "nextToken": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

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.

", "smithy.api#httpQuery": "nextToken" } }, "maxResults": { "target": "com.amazonaws.pcs#MaxResults", "traits": { "smithy.api#default": 10, "smithy.api#documentation": "

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.

", "smithy.api#httpQuery": "maxResults" } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.pcs#ListClustersResponse": { "type": "structure", "members": { "clusters": { "target": "com.amazonaws.pcs#ClusterList", "traits": { "smithy.api#documentation": "

The list of clusters.

", "smithy.api#required": {} } }, "nextToken": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

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.

" } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.pcs#ListComputeNodeGroups": { "type": "operation", "input": { "target": "com.amazonaws.pcs#ListComputeNodeGroupsRequest" }, "output": { "target": "com.amazonaws.pcs#ListComputeNodeGroupsResponse" }, "errors": [ { "target": "com.amazonaws.pcs#AccessDeniedException" }, { "target": "com.amazonaws.pcs#ConflictException" }, { "target": "com.amazonaws.pcs#InternalServerException" }, { "target": "com.amazonaws.pcs#ResourceNotFoundException" }, { "target": "com.amazonaws.pcs#ThrottlingException" }, { "target": "com.amazonaws.pcs#ValidationException" } ], "traits": { "smithy.api#documentation": "

Returns a list of all compute node groups associated with a cluster.

", "smithy.api#paginated": { "inputToken": "nextToken", "outputToken": "nextToken", "pageSize": "maxResults", "items": "computeNodeGroups" }, "smithy.api#readonly": {}, "smithy.api#tags": [ "ComputeNodeGroup" ], "smithy.test#smokeTests": [ { "id": "ListComputeNodeGroups_AccessDeniedException", "params": { "clusterIdentifier": "pcs_donotexist" }, "expect": { "failure": { "errorId": "com.amazonaws.pcs#AccessDeniedException" } }, "vendorParamsShape": "aws.test#AwsVendorParams", "vendorParams": { "region": "us-west-2" } } ] } }, "com.amazonaws.pcs#ListComputeNodeGroupsRequest": { "type": "structure", "members": { "clusterIdentifier": { "target": "com.amazonaws.pcs#ClusterIdentifier", "traits": { "smithy.api#documentation": "

The name or ID of the cluster to list compute node groups for.

", "smithy.api#required": {} } }, "nextToken": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

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.

" } }, "maxResults": { "target": "com.amazonaws.pcs#MaxResults", "traits": { "smithy.api#default": 10, "smithy.api#documentation": "

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.

" } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.pcs#ListComputeNodeGroupsResponse": { "type": "structure", "members": { "computeNodeGroups": { "target": "com.amazonaws.pcs#ComputeNodeGroupList", "traits": { "smithy.api#documentation": "

The list of compute node groups for the cluster.

", "smithy.api#required": {} } }, "nextToken": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

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.

" } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.pcs#ListQueues": { "type": "operation", "input": { "target": "com.amazonaws.pcs#ListQueuesRequest" }, "output": { "target": "com.amazonaws.pcs#ListQueuesResponse" }, "errors": [ { "target": "com.amazonaws.pcs#AccessDeniedException" }, { "target": "com.amazonaws.pcs#ConflictException" }, { "target": "com.amazonaws.pcs#InternalServerException" }, { "target": "com.amazonaws.pcs#ResourceNotFoundException" }, { "target": "com.amazonaws.pcs#ThrottlingException" }, { "target": "com.amazonaws.pcs#ValidationException" } ], "traits": { "smithy.api#documentation": "

Returns a list of all queues associated with a cluster.

", "smithy.api#paginated": { "inputToken": "nextToken", "outputToken": "nextToken", "pageSize": "maxResults", "items": "queues" }, "smithy.api#readonly": {}, "smithy.api#tags": [ "Queue" ], "smithy.test#smokeTests": [ { "id": "ListQueueFailure_AccessDeniedException", "params": { "clusterIdentifier": "pcs_donotexist" }, "expect": { "failure": { "errorId": "com.amazonaws.pcs#AccessDeniedException" } }, "vendorParamsShape": "aws.test#AwsVendorParams", "vendorParams": { "region": "us-west-2" } } ] } }, "com.amazonaws.pcs#ListQueuesRequest": { "type": "structure", "members": { "clusterIdentifier": { "target": "com.amazonaws.pcs#ClusterIdentifier", "traits": { "smithy.api#documentation": "

The name or ID of the cluster to list queues for.

", "smithy.api#required": {} } }, "nextToken": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

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.

" } }, "maxResults": { "target": "com.amazonaws.pcs#MaxResults", "traits": { "smithy.api#default": 10, "smithy.api#documentation": "

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.

" } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.pcs#ListQueuesResponse": { "type": "structure", "members": { "queues": { "target": "com.amazonaws.pcs#QueueList", "traits": { "smithy.api#documentation": "

The list of queues associated with the cluster.

", "smithy.api#required": {} } }, "nextToken": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

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.

" } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.pcs#ListTagsForResource": { "type": "operation", "input": { "target": "com.amazonaws.pcs#ListTagsForResourceRequest" }, "output": { "target": "com.amazonaws.pcs#ListTagsForResourceResponse" }, "errors": [ { "target": "com.amazonaws.pcs#ResourceNotFoundException" } ], "traits": { "aws.iam#conditionKeys": [ "aws:ResourceTag/${TagKey}" ], "smithy.api#documentation": "

Returns a list of all tags on an PCS resource.

", "smithy.api#readonly": {} } }, "com.amazonaws.pcs#ListTagsForResourceRequest": { "type": "structure", "members": { "resourceArn": { "target": "com.amazonaws.pcs#Arn", "traits": { "smithy.api#documentation": "

The Amazon Resource Name (ARN) of the resource for which to list tags.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {}, "smithy.api#references": [ { "resource": "com.amazonaws.pcs#ClusterResource", "ids": { "clusterIdentifier": "resourceArn" } }, { "resource": "com.amazonaws.pcs#QueueResource", "ids": { "clusterIdentifier": "resourceArn", "queueIdentifier": "resourceArn" } }, { "resource": "com.amazonaws.pcs#ComputeNodeGroupResource", "ids": { "clusterIdentifier": "resourceArn", "computeNodeGroupIdentifier": "resourceArn" } } ] } }, "com.amazonaws.pcs#ListTagsForResourceResponse": { "type": "structure", "members": { "tags": { "target": "com.amazonaws.pcs#ResponseTagMap", "traits": { "smithy.api#documentation": "

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.

" } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.pcs#MaxResults": { "type": "integer", "traits": { "smithy.api#default": 10, "smithy.api#range": { "min": 1, "max": 100 } } }, "com.amazonaws.pcs#NetworkType": { "type": "enum", "members": { "IPV4": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "IPV4" } }, "IPV6": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "IPV6" } } } }, "com.amazonaws.pcs#Networking": { "type": "structure", "members": { "subnetIds": { "target": "com.amazonaws.pcs#SubnetIdList", "traits": { "smithy.api#documentation": "

The ID of the subnet where PCS creates an Elastic Network Interface (ENI) to enable communication between managed controllers and PCS resources. The subnet must have an available IP address, cannot reside in Outposts, Wavelength, or an Amazon Web Services Local Zone.

Example: subnet-abcd1234

" } }, "securityGroupIds": { "target": "com.amazonaws.pcs#SecurityGroupIdList", "traits": { "smithy.api#documentation": "

The list of security group IDs associated with the Elastic Network Interface (ENI) created in subnets.

The following rules are required:

" } }, "networkType": { "target": "com.amazonaws.pcs#NetworkType", "traits": { "smithy.api#documentation": "

The IP address version the cluster uses. The default is IPV4.

" } } }, "traits": { "smithy.api#documentation": "

The networking configuration for the cluster's control plane.

" } }, "com.amazonaws.pcs#NetworkingRequest": { "type": "structure", "members": { "subnetIds": { "target": "com.amazonaws.pcs#SubnetIdList", "traits": { "smithy.api#documentation": "

The list of subnet IDs where PCS creates an Elastic Network Interface (ENI) to enable communication between managed controllers and PCS resources. Subnet IDs have the form subnet-0123456789abcdef0.

Subnets can't be in Outposts, Wavelength or an Amazon Web Services Local Zone.

PCS currently supports only 1 subnet in this list.

" } }, "securityGroupIds": { "target": "com.amazonaws.pcs#SecurityGroupIdList", "traits": { "smithy.api#documentation": "

A list of security group IDs associated with the Elastic Network Interface (ENI) created in subnets.

" } }, "networkType": { "target": "com.amazonaws.pcs#NetworkType", "traits": { "smithy.api#documentation": "

The IP address version the cluster uses. The default is IPV4.

" } } }, "traits": { "smithy.api#documentation": "

The networking configuration for the cluster's control plane.

" } }, "com.amazonaws.pcs#NodeLifecycleActions": { "type": "structure", "members": { "stages": { "target": "com.amazonaws.pcs#NodeLifecycleStages", "traits": { "smithy.api#documentation": "

The lifecycle stages where you configure scripts to run.

", "smithy.api#required": {} } }, "scriptCachingPolicy": { "target": "com.amazonaws.pcs#ScriptCachingPolicy", "traits": { "smithy.api#default": "CACHE_ONCE", "smithy.api#documentation": "

The caching policy for node lifecycle scripts. The default value is CACHE_ONCE. Valid values:

" } } }, "traits": { "smithy.api#documentation": "

The lifecycle actions configured on a compute node group. Lifecycle actions define scripts that PCS runs on compute nodes at specific stages of their lifecycle.

" } }, "com.amazonaws.pcs#NodeLifecycleActionsRequest": { "type": "structure", "members": { "stages": { "target": "com.amazonaws.pcs#NodeLifecycleStages", "traits": { "smithy.api#documentation": "

The lifecycle stages where you configure scripts to run.

", "smithy.api#required": {} } }, "scriptCachingPolicy": { "target": "com.amazonaws.pcs#ScriptCachingPolicy", "traits": { "smithy.api#default": "CACHE_ONCE", "smithy.api#documentation": "

The caching policy for node lifecycle scripts. The default value is CACHE_ONCE. Valid values:

" } } }, "traits": { "smithy.api#documentation": "

The lifecycle actions to configure on a compute node group when you create it. Lifecycle actions define scripts that PCS runs on compute nodes at specific stages of their lifecycle.

" } }, "com.amazonaws.pcs#NodeLifecycleScript": { "type": "structure", "members": { "name": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

A unique name for the script. The name can be up to 64 characters long. Valid characters are letters, numbers, spaces, underscores (_), and hyphens (-). The first character must be a letter or a number.

", "smithy.api#length": { "min": 1, "max": 64 }, "smithy.api#pattern": "^[A-Za-z0-9][A-Za-z0-9 _-]*$", "smithy.api#required": {} } }, "scriptSource": { "target": "com.amazonaws.pcs#ScriptSource", "traits": { "smithy.api#documentation": "

The source location and integrity information for the script.

", "smithy.api#required": {} } }, "arguments": { "target": "com.amazonaws.pcs#NodeLifecycleScriptArguments", "traits": { "smithy.api#documentation": "

The command-line arguments to pass to the script. You can specify up to 20 arguments, and each argument can be up to 256 characters long.

" } }, "onError": { "target": "com.amazonaws.pcs#OnError", "traits": { "smithy.api#default": "TERMINATE", "smithy.api#documentation": "

The behavior when the script fails. The default value is TERMINATE. Valid values:

" } }, "executionPolicy": { "target": "com.amazonaws.pcs#ExecutionPolicy", "traits": { "smithy.api#default": "FIRST_BOOT_ONLY", "smithy.api#documentation": "

The policy that determines when the script runs. The default value is FIRST_BOOT_ONLY. Valid values:

" } } }, "traits": { "smithy.api#documentation": "

A script to run during a compute node lifecycle stage.

" } }, "com.amazonaws.pcs#NodeLifecycleScriptArgument": { "type": "string", "traits": { "smithy.api#length": { "max": 256 } } }, "com.amazonaws.pcs#NodeLifecycleScriptArguments": { "type": "list", "member": { "target": "com.amazonaws.pcs#NodeLifecycleScriptArgument" }, "traits": { "smithy.api#length": { "max": 20 } } }, "com.amazonaws.pcs#NodeLifecycleScriptList": { "type": "list", "member": { "target": "com.amazonaws.pcs#NodeLifecycleScript" }, "traits": { "smithy.api#length": { "min": 1, "max": 20 } } }, "com.amazonaws.pcs#NodeLifecycleStages": { "type": "structure", "members": { "nodeBootstrapped": { "target": "com.amazonaws.pcs#NodeLifecycleScriptList", "traits": { "smithy.api#documentation": "

The scripts to run after PCS finishes setting up the compute node and before the Slurm daemon (slurmd) starts. Use this stage for tasks that must complete before the node accepts jobs, such as mounting shared storage, configuring networking, or installing software packages.

" } }, "nodeReady": { "target": "com.amazonaws.pcs#NodeLifecycleScriptList", "traits": { "smithy.api#documentation": "

The scripts to run after the Slurm daemon (slurmd) starts and the compute node registers with the Slurm controller. Use this stage for tasks that require Slurm to be running, such as running Slurm commands.

" } } }, "traits": { "smithy.api#documentation": "

The stages of a compute node's lifecycle where you can configure scripts to run.

" } }, "com.amazonaws.pcs#OnError": { "type": "enum", "members": { "TERMINATE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "TERMINATE" } }, "STOP_SEQUENCE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "STOP_SEQUENCE" } }, "CONTINUE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "CONTINUE" } } }, "traits": { "smithy.api#documentation": "

The behavior when a node lifecycle script fails. Valid values:

" } }, "com.amazonaws.pcs#PurchaseOption": { "type": "enum", "members": { "ONDEMAND": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "ONDEMAND" } }, "SPOT": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "SPOT" } }, "CAPACITY_BLOCK": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "CAPACITY_BLOCK" } }, "INTERRUPTIBLE_CAPACITY_RESERVATION": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "INTERRUPTIBLE_CAPACITY_RESERVATION" } } } }, "com.amazonaws.pcs#Queue": { "type": "structure", "members": { "name": { "target": "com.amazonaws.pcs#QueueName", "traits": { "smithy.api#documentation": "

The name that identifies the queue.

", "smithy.api#required": {} } }, "id": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The generated unique ID of the queue.

", "smithy.api#required": {} } }, "arn": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The unique Amazon Resource Name (ARN) of the queue.

", "smithy.api#required": {} } }, "clusterId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The ID of the cluster of the queue.

", "smithy.api#required": {} } }, "createdAt": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "

The date and time the resource was created.

", "smithy.api#required": {}, "smithy.api#timestampFormat": "date-time" } }, "modifiedAt": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "

The date and time the resource was modified.

", "smithy.api#required": {}, "smithy.api#timestampFormat": "date-time" } }, "status": { "target": "com.amazonaws.pcs#QueueStatus", "traits": { "smithy.api#documentation": "

The provisioning status of the queue.

The provisioning status doesn't indicate the overall health of the queue.

The resource enters the SUSPENDING and SUSPENDED states when the scheduler is beyond end of life and we have suspended the cluster. When in these states, you can't use the cluster. The cluster controller is down and all compute instances are terminated. The resources still count toward your service quotas. You can delete a resource if its status is SUSPENDED. For more information, see Frequently asked questions about Slurm versions in PCS in the PCS User Guide.

", "smithy.api#required": {} } }, "computeNodeGroupConfigurations": { "target": "com.amazonaws.pcs#ComputeNodeGroupConfigurationList", "traits": { "smithy.api#documentation": "

The list of compute node group configurations associated with the queue. Queues assign jobs to associated compute node groups.

", "smithy.api#required": {} } }, "slurmConfiguration": { "target": "com.amazonaws.pcs#QueueSlurmConfiguration", "traits": { "smithy.api#documentation": "

Additional options related to the Slurm scheduler.

" } }, "errorInfo": { "target": "com.amazonaws.pcs#ErrorInfoList", "traits": { "smithy.api#documentation": "

The list of errors that occurred during queue provisioning.

" } } }, "traits": { "smithy.api#documentation": "

A queue resource.

" } }, "com.amazonaws.pcs#QueueIdentifier": { "type": "string", "traits": { "smithy.api#pattern": "^(pcs_[a-zA-Z0-9]+|[A-Za-z][A-Za-z0-9-]{2,25})$" } }, "com.amazonaws.pcs#QueueList": { "type": "list", "member": { "target": "com.amazonaws.pcs#QueueSummary" } }, "com.amazonaws.pcs#QueueName": { "type": "string", "traits": { "smithy.api#length": { "min": 3, "max": 25 }, "smithy.api#pattern": "^(?!pcs_)^[A-Za-z][A-Za-z0-9-]+$" } }, "com.amazonaws.pcs#QueueResource": { "type": "resource", "identifiers": { "clusterIdentifier": { "target": "com.amazonaws.pcs#ClusterIdentifier" }, "queueIdentifier": { "target": "com.amazonaws.pcs#QueueIdentifier" } }, "create": { "target": "com.amazonaws.pcs#CreateQueue" }, "update": { "target": "com.amazonaws.pcs#UpdateQueue" }, "operations": [ { "target": "com.amazonaws.pcs#DeleteQueue" }, { "target": "com.amazonaws.pcs#GetQueue" } ], "collectionOperations": [ { "target": "com.amazonaws.pcs#ListQueues" } ], "traits": { "aws.api#arn": { "template": "cluster/{clusterIdentifier}/queue/{queueIdentifier}" }, "aws.iam#conditionKeys": [ "aws:ResourceTag/${TagKey}" ], "aws.iam#iamResource": { "name": "queue" } } }, "com.amazonaws.pcs#QueueSlurmConfiguration": { "type": "structure", "members": { "slurmCustomSettings": { "target": "com.amazonaws.pcs#SlurmCustomSettings", "traits": { "smithy.api#documentation": "

Additional Slurm-specific configuration that directly maps to Slurm settings.

" } } }, "traits": { "smithy.api#documentation": "

Additional options related to the Slurm scheduler.

" } }, "com.amazonaws.pcs#QueueSlurmConfigurationRequest": { "type": "structure", "members": { "slurmCustomSettings": { "target": "com.amazonaws.pcs#SlurmCustomSettings", "traits": { "smithy.api#documentation": "

Additional Slurm-specific configuration that directly maps to Slurm settings.

" } } }, "traits": { "smithy.api#documentation": "

Additional options related to the Slurm scheduler.

" } }, "com.amazonaws.pcs#QueueStatus": { "type": "enum", "members": { "CREATING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "CREATING" } }, "ACTIVE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "ACTIVE" } }, "UPDATING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "UPDATING" } }, "DELETING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "DELETING" } }, "CREATE_FAILED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "CREATE_FAILED" } }, "DELETE_FAILED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "DELETE_FAILED" } }, "UPDATE_FAILED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "UPDATE_FAILED" } }, "SUSPENDING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "SUSPENDING" } }, "SUSPENDED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "SUSPENDED" } }, "RESUMING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "RESUMING" } } } }, "com.amazonaws.pcs#QueueSummary": { "type": "structure", "members": { "name": { "target": "com.amazonaws.pcs#QueueName", "traits": { "smithy.api#documentation": "

The name that identifies the queue.

", "smithy.api#required": {} } }, "id": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The generated unique ID of the queue.

", "smithy.api#required": {} } }, "arn": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The unique Amazon Resource Name (ARN) of the queue.

", "smithy.api#required": {} } }, "clusterId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The ID of the cluster of the queue.

", "smithy.api#required": {} } }, "createdAt": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "

The date and time the resource was created.

", "smithy.api#required": {}, "smithy.api#timestampFormat": "date-time" } }, "modifiedAt": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "

The date and time the resource was modified.

", "smithy.api#required": {}, "smithy.api#timestampFormat": "date-time" } }, "status": { "target": "com.amazonaws.pcs#QueueStatus", "traits": { "smithy.api#documentation": "

The provisioning status of the queue.

The provisioning status doesn't indicate the overall health of the queue.

The resource enters the SUSPENDING and SUSPENDED states when the scheduler is beyond end of life and we have suspended the cluster. When in these states, you can't use the cluster. The cluster controller is down and all compute instances are terminated. The resources still count toward your service quotas. You can delete a resource if its status is SUSPENDED. For more information, see Frequently asked questions about Slurm versions in PCS in the PCS User Guide.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

The object returned by the ListQueues API action.

" } }, "com.amazonaws.pcs#RegisterComputeNodeGroupInstance": { "type": "operation", "input": { "target": "com.amazonaws.pcs#RegisterComputeNodeGroupInstanceRequest" }, "output": { "target": "com.amazonaws.pcs#RegisterComputeNodeGroupInstanceResponse" }, "errors": [ { "target": "com.amazonaws.pcs#AccessDeniedException" }, { "target": "com.amazonaws.pcs#InternalServerException" } ], "traits": { "smithy.api#documentation": "

This API action isn't intended for you to use.

PCS uses this API action to register the compute nodes it launches in your account.

" } }, "com.amazonaws.pcs#RegisterComputeNodeGroupInstanceRequest": { "type": "structure", "members": { "clusterIdentifier": { "target": "com.amazonaws.pcs#ClusterIdentifier", "traits": { "smithy.api#documentation": "

The name or ID of the cluster to register the compute node group instance in.

", "smithy.api#required": {} } }, "bootstrapId": { "target": "com.amazonaws.pcs#BootstrapId", "traits": { "smithy.api#documentation": "

The client-generated token to allow for retries.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.pcs#RegisterComputeNodeGroupInstanceResponse": { "type": "structure", "members": { "nodeID": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The scheduler node ID for this instance.

", "smithy.api#required": {} } }, "sharedSecret": { "target": "com.amazonaws.pcs#SharedSecret", "traits": { "smithy.api#documentation": "

For the Slurm scheduler, this is the shared Munge key the scheduler uses to authenticate compute node group instances.

", "smithy.api#required": {} } }, "endpoints": { "target": "com.amazonaws.pcs#Endpoints", "traits": { "smithy.api#documentation": "

The list of endpoints available for interaction with the scheduler.

", "smithy.api#required": {} } }, "clusterName": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The name of the cluster that the compute node registered into.

" } }, "computeNodeGroupId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The ID of the compute node group that the compute node registered into.

" } }, "computeNodeGroupName": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The name of the compute node group that the compute node registered into.

" } }, "nodeLifecycleActions": { "target": "com.amazonaws.pcs#NodeLifecycleActions", "traits": { "smithy.api#documentation": "

The node lifecycle actions configured for the node group, including scripts to run when a compute node finishes bootstrapping or becomes ready to accept jobs.

" } }, "schedulerVersion": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The scheduler version that the cluster is running. A compute node uses this value to run the matching scheduler version.

" } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.pcs#RequestTagMap": { "type": "map", "key": { "target": "com.amazonaws.pcs#TagKey" }, "value": { "target": "com.amazonaws.pcs#TagValue" }, "traits": { "smithy.api#length": { "min": 1, "max": 200 } } }, "com.amazonaws.pcs#ResourceNotFoundException": { "type": "structure", "members": { "message": { "target": "smithy.api#String", "traits": { "smithy.api#required": {} } }, "resourceId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The unique identifier of the resource that was not found.

", "smithy.api#required": {} } }, "resourceType": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The type or category of the resource that was not found.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

The requested resource can't be found. The cluster, node group, or queue you're attempting to get, update, list, or delete doesn't exist.

Examples

", "smithy.api#error": "client", "smithy.api#httpError": 404 } }, "com.amazonaws.pcs#ResponseTagMap": { "type": "map", "key": { "target": "com.amazonaws.pcs#TagKey" }, "value": { "target": "com.amazonaws.pcs#TagValue" } }, "com.amazonaws.pcs#SBClientToken": { "type": "string", "traits": { "smithy.api#length": { "min": 8, "max": 100 } } }, "com.amazonaws.pcs#ScalingConfiguration": { "type": "structure", "members": { "minInstanceCount": { "target": "smithy.api#Integer", "traits": { "smithy.api#default": 0, "smithy.api#documentation": "

The lower bound of the number of instances allowed in the compute fleet.

", "smithy.api#range": { "min": 0 }, "smithy.api#required": {} } }, "maxInstanceCount": { "target": "smithy.api#Integer", "traits": { "smithy.api#default": 0, "smithy.api#documentation": "

The upper bound of the number of instances allowed in the compute fleet.

", "smithy.api#range": { "min": 0 }, "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

Specifies the boundaries of the compute node group auto scaling.

" } }, "com.amazonaws.pcs#ScalingConfigurationRequest": { "type": "structure", "members": { "minInstanceCount": { "target": "smithy.api#Integer", "traits": { "smithy.api#default": 0, "smithy.api#documentation": "

The lower bound of the number of instances allowed in the compute fleet.

", "smithy.api#range": { "min": 0 }, "smithy.api#required": {} } }, "maxInstanceCount": { "target": "smithy.api#Integer", "traits": { "smithy.api#default": 0, "smithy.api#documentation": "

The upper bound of the number of instances allowed in the compute fleet.

", "smithy.api#range": { "min": 0 }, "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

Specifies the boundaries of the compute node group auto scaling.

" } }, "com.amazonaws.pcs#Scheduler": { "type": "structure", "members": { "type": { "target": "com.amazonaws.pcs#SchedulerType", "traits": { "smithy.api#documentation": "

The software PCS uses to manage cluster scaling and job scheduling.

", "smithy.api#required": {} } }, "version": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The version of the specified scheduling software that PCS uses to manage cluster scaling and job scheduling. You can update this version using the UpdateCluster API action. For more information, see Updating the scheduler version on a cluster and Slurm versions in PCS in the PCS User Guide.

Valid Values: 23.11 | 24.05 | 24.11 | 25.05 | 25.11 | 26.05

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

The cluster management and job scheduling software associated with the cluster.

" } }, "com.amazonaws.pcs#SchedulerRequest": { "type": "structure", "members": { "type": { "target": "com.amazonaws.pcs#SchedulerType", "traits": { "smithy.api#documentation": "

The software PCS uses to manage cluster scaling and job scheduling.

", "smithy.api#required": {} } }, "version": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The version of the specified scheduling software that PCS uses to manage cluster scaling and job scheduling. For more information, see Slurm versions in PCS in the PCS User Guide.

Valid Values: 24.11 | 25.05 | 25.11 | 26.05

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

The cluster management and job scheduling software associated with the cluster.

" } }, "com.amazonaws.pcs#SchedulerType": { "type": "enum", "members": { "SLURM": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "SLURM" } } } }, "com.amazonaws.pcs#ScriptCachingPolicy": { "type": "enum", "members": { "CACHE_ONCE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "CACHE_ONCE" } }, "REFRESH_ON_REBOOT": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "REFRESH_ON_REBOOT" } } }, "traits": { "smithy.api#documentation": "

The caching policy for a node lifecycle script. Valid values:

" } }, "com.amazonaws.pcs#ScriptSource": { "type": "structure", "members": { "scriptLocation": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The location of the script. Specify either an Amazon S3 URI in the format s3://bucket-name/key or an HTTPS URL.

", "smithy.api#length": { "min": 1, "max": 1024 }, "smithy.api#pattern": "^(s3://[a-z0-9][a-z0-9.-]{1,61}[a-z0-9]/.+|https://([a-zA-Z0-9](?:[a-zA-Z0-9_-]{0,61}[a-zA-Z0-9])?\\.)+[a-zA-Z]{2,63}(?::[0-9]{1,5})?(?:[/?#][^\\s]*)?)$", "smithy.api#required": {} } }, "s3VersionId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The Amazon S3 version ID of the script. Use this value to pin the script to a specific version in a versioned Amazon S3 bucket. This value is only valid when scriptLocation is an Amazon S3 URI.

", "smithy.api#length": { "max": 1024 } } }, "checksum": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The SHA-256 checksum of the script content, as a 64-character hexadecimal string. This value is optional. When specified, PCS uses this value to verify the integrity of the downloaded script.

", "smithy.api#length": { "min": 64, "max": 64 }, "smithy.api#pattern": "^[a-fA-F0-9]{64}$" } } }, "traits": { "smithy.api#documentation": "

The source location and integrity information for a node lifecycle script.

" } }, "com.amazonaws.pcs#SecurityGroupId": { "type": "string", "traits": { "smithy.api#pattern": "^sg-\\w{8,17}$" } }, "com.amazonaws.pcs#SecurityGroupIdList": { "type": "list", "member": { "target": "com.amazonaws.pcs#SecurityGroupId" } }, "com.amazonaws.pcs#SecurityGroupIdListOrEmpty": { "type": "list", "member": { "target": "com.amazonaws.pcs#SecurityGroupId" } }, "com.amazonaws.pcs#ServiceQuotaExceededException": { "type": "structure", "members": { "message": { "target": "smithy.api#String", "traits": { "smithy.api#required": {} } }, "serviceCode": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The service code associated with the quota that was exceeded.

", "smithy.api#required": {} } }, "resourceId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The unique identifier of the resource that caused the quota to be exceeded.

" } }, "resourceType": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The type or category of the resource that caused the quota to be exceeded.

" } }, "quotaCode": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The quota code of the service quota that was exceeded.

" } } }, "traits": { "smithy.api#documentation": "

You exceeded your service quota. Service quotas, also referred to as limits, are the maximum number of service resources or operations for your Amazon Web Services account. To learn how to increase your service quota, see Requesting a quota increase in the Service Quotas User Guide

Examples

", "smithy.api#error": "client", "smithy.api#httpError": 402 } }, "com.amazonaws.pcs#SharedSecret": { "type": "string", "traits": { "smithy.api#sensitive": {} } }, "com.amazonaws.pcs#Size": { "type": "enum", "members": { "SMALL": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "SMALL" } }, "MEDIUM": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "MEDIUM" } }, "LARGE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "LARGE" } } } }, "com.amazonaws.pcs#SlurmAuthKey": { "type": "structure", "members": { "secretArn": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The Amazon Resource Name (ARN) of the shared Slurm key.

", "smithy.api#required": {} } }, "secretVersion": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The version of the shared Slurm key.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

The shared Slurm key for authentication, also known as the cluster secret.

" } }, "com.amazonaws.pcs#SlurmCustomSetting": { "type": "structure", "members": { "parameterName": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

PCS supports custom Slurm settings for clusters, compute node groups, and queues. For more information, see Configuring custom Slurm settings in PCS in the PCS User Guide.

", "smithy.api#required": {} } }, "parameterValue": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The values for the configured Slurm settings.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

Additional settings that directly map to Slurm settings.

PCS supports a subset of Slurm settings. For more information, see Configuring custom Slurm settings in PCS in the PCS User Guide.

" } }, "com.amazonaws.pcs#SlurmCustomSettings": { "type": "list", "member": { "target": "com.amazonaws.pcs#SlurmCustomSetting" } }, "com.amazonaws.pcs#SlurmRest": { "type": "structure", "members": { "mode": { "target": "com.amazonaws.pcs#SlurmRestMode", "traits": { "smithy.api#documentation": "

The default value for mode is NONE. A value of STANDARD means the Slurm REST API is enabled.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

The Slurm REST API configuration includes settings for enabling and configuring the Slurm REST API. It's a property of the ClusterSlurmConfiguration object.

" } }, "com.amazonaws.pcs#SlurmRestMode": { "type": "enum", "members": { "STANDARD": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "STANDARD" } }, "NONE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "NONE" } } } }, "com.amazonaws.pcs#SlurmRestRequest": { "type": "structure", "members": { "mode": { "target": "com.amazonaws.pcs#SlurmRestMode", "traits": { "smithy.api#documentation": "

The default value for mode is NONE. A value of STANDARD means the Slurm REST API is enabled.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

The Slurm REST API configuration includes settings for enabling and configuring the Slurm REST API. It's a property of the ClusterSlurmConfiguration object.

" } }, "com.amazonaws.pcs#SlurmdbdCustomSetting": { "type": "structure", "members": { "parameterName": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

PCS supports custom SlurmDBD settings for clusters. For more information, see Configuring custom SlurmDBD settings in PCS in the PCS User Guide.

", "smithy.api#required": {} } }, "parameterValue": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The values for the configured SlurmDBD settings.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

Additional settings that directly map to SlurmDBD settings.

PCS supports a subset of SlurmDBD settings. For more information, see Configuring custom SlurmDBD settings in PCS in the PCS User Guide.

" } }, "com.amazonaws.pcs#SlurmdbdCustomSettings": { "type": "list", "member": { "target": "com.amazonaws.pcs#SlurmdbdCustomSetting" } }, "com.amazonaws.pcs#SpotAllocationStrategy": { "type": "enum", "members": { "LOWEST_PRICE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "lowest-price" } }, "CAPACITY_OPTIMIZED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "capacity-optimized" } }, "PRICE_CAPACITY_OPTIMIZED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "price-capacity-optimized" } } } }, "com.amazonaws.pcs#SpotOptions": { "type": "structure", "members": { "allocationStrategy": { "target": "com.amazonaws.pcs#SpotAllocationStrategy", "traits": { "smithy.api#documentation": "

The Amazon EC2 allocation strategy PCS uses to provision EC2 instances. 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.

" } } }, "traits": { "smithy.api#documentation": "

Additional configuration when you specify SPOT as the purchaseOption for the CreateComputeNodeGroup API action.

" } }, "com.amazonaws.pcs#StringList": { "type": "list", "member": { "target": "smithy.api#String" } }, "com.amazonaws.pcs#SubnetId": { "type": "string", "traits": { "smithy.api#pattern": "^subnet-\\w{8,17}$" } }, "com.amazonaws.pcs#SubnetIdList": { "type": "list", "member": { "target": "com.amazonaws.pcs#SubnetId" }, "traits": { "smithy.api#length": { "min": 1 } } }, "com.amazonaws.pcs#TagKey": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 128 } } }, "com.amazonaws.pcs#TagKeys": { "type": "list", "member": { "target": "com.amazonaws.pcs#TagKey" }, "traits": { "smithy.api#length": { "min": 1, "max": 200 } } }, "com.amazonaws.pcs#TagResource": { "type": "operation", "input": { "target": "com.amazonaws.pcs#TagResourceRequest" }, "output": { "target": "com.amazonaws.pcs#TagResourceResponse" }, "errors": [ { "target": "com.amazonaws.pcs#ResourceNotFoundException" }, { "target": "com.amazonaws.pcs#ServiceQuotaExceededException" } ], "traits": { "aws.iam#conditionKeys": [ "aws:ResourceTag/${TagKey}", "aws:RequestTag/${TagKey}", "aws:TagKeys" ], "smithy.api#documentation": "

Adds or edits tags on an PCS resource. Each tag consists of a tag key and a tag value. The tag key and tag value are case-sensitive strings. The tag value can be an empty (null) string. To add a tag, specify a new tag key and a tag value. To edit a tag, specify an existing tag key and a new tag value.

", "smithy.api#idempotent": {} } }, "com.amazonaws.pcs#TagResourceRequest": { "type": "structure", "members": { "resourceArn": { "target": "com.amazonaws.pcs#Arn", "traits": { "smithy.api#documentation": "

The Amazon Resource Name (ARN) of the resource.

", "smithy.api#required": {} } }, "tags": { "target": "com.amazonaws.pcs#RequestTagMap", "traits": { "smithy.api#documentation": "

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.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {}, "smithy.api#references": [ { "resource": "com.amazonaws.pcs#ClusterResource", "ids": { "clusterIdentifier": "resourceArn" } }, { "resource": "com.amazonaws.pcs#QueueResource", "ids": { "clusterIdentifier": "resourceArn", "queueIdentifier": "resourceArn" } }, { "resource": "com.amazonaws.pcs#ComputeNodeGroupResource", "ids": { "clusterIdentifier": "resourceArn", "computeNodeGroupIdentifier": "resourceArn" } } ] } }, "com.amazonaws.pcs#TagResourceResponse": { "type": "structure", "members": {}, "traits": { "smithy.api#output": {} } }, "com.amazonaws.pcs#TagValue": { "type": "string", "traits": { "smithy.api#length": { "min": 0, "max": 256 } } }, "com.amazonaws.pcs#ThrottlingException": { "type": "structure", "members": { "message": { "target": "smithy.api#String", "traits": { "smithy.api#required": {} } }, "retryAfterSeconds": { "target": "smithy.api#Integer", "traits": { "smithy.api#documentation": "

The number of seconds to wait before retrying the request.

", "smithy.api#httpHeader": "Retry-After" } } }, "traits": { "smithy.api#documentation": "

Your request exceeded a request rate quota. Check the resource's request rate quota and try again.

", "smithy.api#error": "client", "smithy.api#httpError": 429, "smithy.api#retryable": {} } }, "com.amazonaws.pcs#UntagResource": { "type": "operation", "input": { "target": "com.amazonaws.pcs#UntagResourceRequest" }, "output": { "target": "com.amazonaws.pcs#UntagResourceResponse" }, "errors": [ { "target": "com.amazonaws.pcs#ResourceNotFoundException" } ], "traits": { "aws.iam#conditionKeys": [ "aws:ResourceTag/${TagKey}", "aws:TagKeys" ], "smithy.api#documentation": "

Deletes tags from an PCS resource. To delete a tag, specify the tag key and the Amazon Resource Name (ARN) of the PCS resource.

", "smithy.api#idempotent": {} } }, "com.amazonaws.pcs#UntagResourceRequest": { "type": "structure", "members": { "resourceArn": { "target": "com.amazonaws.pcs#Arn", "traits": { "smithy.api#documentation": "

The Amazon Resource Name (ARN) of the resource.

", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "tagKeys": { "target": "com.amazonaws.pcs#TagKeys", "traits": { "aws.iam#conditionKeyValue": "aws:TagKeys", "smithy.api#documentation": "

1 or more tag keys to remove from the resource. Specify only tag keys and not tag values.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {}, "smithy.api#references": [ { "resource": "com.amazonaws.pcs#ClusterResource", "ids": { "clusterIdentifier": "resourceArn" } }, { "resource": "com.amazonaws.pcs#QueueResource", "ids": { "clusterIdentifier": "resourceArn", "queueIdentifier": "resourceArn" } }, { "resource": "com.amazonaws.pcs#ComputeNodeGroupResource", "ids": { "clusterIdentifier": "resourceArn", "computeNodeGroupIdentifier": "resourceArn" } } ] } }, "com.amazonaws.pcs#UntagResourceResponse": { "type": "structure", "members": {}, "traits": { "smithy.api#output": {} } }, "com.amazonaws.pcs#UpdateAccountingRequest": { "type": "structure", "members": { "defaultPurgeTimeInDays": { "target": "smithy.api#Integer", "traits": { "smithy.api#documentation": "

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.

0 isn't a valid value.

", "smithy.api#range": { "min": -1, "max": 10000 } } }, "mode": { "target": "com.amazonaws.pcs#AccountingMode", "traits": { "smithy.api#documentation": "

The default value for mode is NONE. A value of STANDARD means Slurm accounting is enabled.

" } } }, "traits": { "smithy.api#documentation": "

The accounting configuration includes configurable settings for Slurm accounting.

" } }, "com.amazonaws.pcs#UpdateCluster": { "type": "operation", "input": { "target": "com.amazonaws.pcs#UpdateClusterRequest" }, "output": { "target": "com.amazonaws.pcs#UpdateClusterResponse" }, "errors": [ { "target": "com.amazonaws.pcs#AccessDeniedException" }, { "target": "com.amazonaws.pcs#ConflictException" }, { "target": "com.amazonaws.pcs#InternalServerException" }, { "target": "com.amazonaws.pcs#ResourceNotFoundException" }, { "target": "com.amazonaws.pcs#ThrottlingException" }, { "target": "com.amazonaws.pcs#ValidationException" } ], "traits": { "smithy.api#documentation": "

Updates a cluster configuration. You can update the scheduler version, modify scheduler settings, and update accounting configuration for an existing cluster. For more information about updating the scheduler version, see Updating the scheduler version on a cluster in the PCS User Guide.

You can only update clusters that are in ACTIVE, UPDATE_FAILED, or SUSPENDED state. All associated resources (queues and compute node groups) must be in ACTIVE state before you can update the cluster.

", "smithy.api#idempotent": {}, "smithy.api#tags": [ "Cluster" ], "smithy.test#smokeTests": [ { "id": "UpdateCluster_AccessDeniedException", "params": { "clusterIdentifier": "pcs_donotexist" }, "expect": { "failure": { "errorId": "com.amazonaws.pcs#AccessDeniedException" } }, "vendorParamsShape": "aws.test#AwsVendorParams", "vendorParams": { "region": "us-west-2" } } ] } }, "com.amazonaws.pcs#UpdateClusterRequest": { "type": "structure", "members": { "clusterIdentifier": { "target": "com.amazonaws.pcs#ClusterIdentifier", "traits": { "smithy.api#documentation": "

The name or ID of the cluster to update.

", "smithy.api#required": {} } }, "clientToken": { "target": "com.amazonaws.pcs#SBClientToken", "traits": { "smithy.api#documentation": "

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 one for you.

", "smithy.api#idempotencyToken": {} } }, "slurmConfiguration": { "target": "com.amazonaws.pcs#UpdateClusterSlurmConfigurationRequest", "traits": { "smithy.api#documentation": "

Additional options related to the Slurm scheduler.

" } }, "scheduler": { "target": "com.amazonaws.pcs#UpdateSchedulerRequest", "traits": { "smithy.api#documentation": "

The scheduler configuration to update for the cluster. Use this to update the scheduler version. For more information, see Updating the scheduler version on a cluster in the PCS User Guide.

" } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.pcs#UpdateClusterResponse": { "type": "structure", "members": { "cluster": { "target": "com.amazonaws.pcs#Cluster" } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.pcs#UpdateClusterSlurmConfigurationRequest": { "type": "structure", "members": { "scaleDownIdleTimeInSeconds": { "target": "smithy.api#Integer", "traits": { "smithy.api#documentation": "

The time (in seconds) before an idle node is scaled down.

Default: 600

", "smithy.api#range": { "min": 1, "max": 10000000 } } }, "slurmCustomSettings": { "target": "com.amazonaws.pcs#SlurmCustomSettings", "traits": { "smithy.api#documentation": "

Additional Slurm-specific configuration that directly maps to Slurm settings.

" } }, "slurmdbdCustomSettings": { "target": "com.amazonaws.pcs#SlurmdbdCustomSettings", "traits": { "smithy.api#documentation": "

Additional SlurmDBD-specific configuration that directly maps to SlurmDBD settings.

" } }, "cgroupCustomSettings": { "target": "com.amazonaws.pcs#CgroupCustomSettings", "traits": { "smithy.api#documentation": "

Additional Cgroup-specific configuration that directly maps to Cgroup settings.

" } }, "jobSubmitPlugins": { "target": "com.amazonaws.pcs#JobSubmitPluginList", "traits": { "smithy.api#documentation": "

The job submit plugins to run on the cluster controller. Use job submit plugins to execute custom scripts during job submission and job modification to validate or modify the job's configuration. Custom scripts can accept or reject jobs based on their configuration or modify the configuration before job execution.

" } }, "accounting": { "target": "com.amazonaws.pcs#UpdateAccountingRequest", "traits": { "smithy.api#documentation": "

The accounting configuration includes configurable settings for Slurm accounting.

" } }, "slurmRest": { "target": "com.amazonaws.pcs#UpdateSlurmRestRequest", "traits": { "smithy.api#documentation": "

The Slurm REST API configuration for the cluster.

" } } }, "traits": { "smithy.api#documentation": "

Additional options related to the Slurm scheduler.

" } }, "com.amazonaws.pcs#UpdateComputeNodeGroup": { "type": "operation", "input": { "target": "com.amazonaws.pcs#UpdateComputeNodeGroupRequest" }, "output": { "target": "com.amazonaws.pcs#UpdateComputeNodeGroupResponse" }, "errors": [ { "target": "com.amazonaws.pcs#AccessDeniedException" }, { "target": "com.amazonaws.pcs#ConflictException" }, { "target": "com.amazonaws.pcs#InternalServerException" }, { "target": "com.amazonaws.pcs#ResourceNotFoundException" }, { "target": "com.amazonaws.pcs#ServiceQuotaExceededException" }, { "target": "com.amazonaws.pcs#ThrottlingException" }, { "target": "com.amazonaws.pcs#ValidationException" } ], "traits": { "smithy.api#documentation": "

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

", "smithy.api#idempotent": {}, "smithy.api#tags": [ "ComputeNodeGroup" ] } }, "com.amazonaws.pcs#UpdateComputeNodeGroupRequest": { "type": "structure", "members": { "amiId": { "target": "com.amazonaws.pcs#AmiIdOrEmpty", "traits": { "smithy.api#documentation": "

The ID of the Amazon Machine Image (AMI) that PCS uses to launch instances. This value overrides the AMI ID in the custom launch template. Specify an empty string (\"\") to remove the AMI ID from the compute node group and use the AMI ID specified in the custom launch template. Omit this value to leave the current setting unchanged.

" } }, "securityGroupIds": { "target": "com.amazonaws.pcs#SecurityGroupIdListOrEmpty", "traits": { "smithy.api#documentation": "

The IDs of the EC2 security groups to configure directly on the compute node group. The security groups must be in the same VPC as the cluster. PCS uses these security groups instead of the security groups in the custom launch template. You can't specify this value if the custom launch template defines network interfaces. Specify an empty list ([]) to remove the security groups from the compute node group and use the security groups in the custom launch template. Omit this value to leave the current setting unchanged.

" } }, "sshKeyName": { "target": "com.amazonaws.pcs#KeyPairNameOrEmpty", "traits": { "smithy.api#documentation": "

The name of the EC2 key pair to configure directly on the compute node group. The key pair must exist in your account and Amazon Web Services Region. PCS uses this key pair instead of the key pair in the custom launch template. Specify an empty string (\"\") to remove the key pair from the compute node group and use the key pair in the custom launch template. Omit this value to leave the current setting unchanged. You must have permission for ec2:DescribeKeyPairs to specify a key pair. If you delete the key pair later, future instance launches can fail.

" } }, "clusterIdentifier": { "target": "com.amazonaws.pcs#ClusterIdentifier", "traits": { "smithy.api#documentation": "

The name or ID of the cluster of the compute node group.

", "smithy.api#required": {} } }, "computeNodeGroupIdentifier": { "target": "com.amazonaws.pcs#ComputeNodeGroupIdentifier", "traits": { "smithy.api#documentation": "

The name or ID of the compute node group.

", "smithy.api#required": {} } }, "subnetIds": { "target": "com.amazonaws.pcs#StringList", "traits": { "smithy.api#documentation": "

The list of subnet IDs where the compute node group provisions instances. The subnets must be in the same VPC as the cluster.

" } }, "launchTemplateMode": { "target": "com.amazonaws.pcs#LaunchTemplateMode", "traits": { "smithy.api#documentation": "

Specifies whether the compute node group uses a custom launch template or a launch template that PCS manages. Omit this value to keep the current mode.

Valid values:

When switching to MANAGED, the compute node group must have amiId and securityGroupIds configured. You can set these values in the same request.

" } }, "customLaunchTemplate": { "target": "com.amazonaws.pcs#CustomLaunchTemplate", "traits": { "smithy.api#documentation": "

The custom Amazon EC2 launch template to associate with the compute node group. To set or change the custom launch template, specify id and version. If you provide this value and omit launchTemplateMode, the compute node group must already use CUSTOM mode. To switch from MANAGED to CUSTOM, specify launchTemplateMode as CUSTOM and provide this value. If the compute node group already uses CUSTOM, omit this value while also omitting launchTemplateMode, or while specifying CUSTOM, to keep the existing custom launch template. For more information, see Migrating a compute node group from a custom launch template in the PCS User Guide.

" } }, "purchaseOption": { "target": "com.amazonaws.pcs#PurchaseOption", "traits": { "smithy.api#documentation": "

Specifies how EC2 instances are purchased on your behalf. PCS supports On-Demand Instances, Spot Instances, Interruptible Capacity Reservations, On-Demand Capacity Reservations, and Amazon EC2 Capacity Blocks for ML. For more information, see Amazon EC2 billing and purchasing options in the Amazon Elastic Compute Cloud User Guide. For more information about PCS support for Capacity Blocks, see Using Amazon EC2 Capacity Blocks for ML with PCS in the PCS User Guide. For more information about PCS support for interruptible capacity reservations, see Using I-ODCRs with PCS in the PCS User Guide. Choose On-Demand if you plan to use an On-Demand Capacity Reservation (ODCR). For more information, see Using ODCRs with PCS. If you don't provide this option, it defaults to On-Demand.

" } }, "spotOptions": { "target": "com.amazonaws.pcs#SpotOptions" }, "scalingConfiguration": { "target": "com.amazonaws.pcs#ScalingConfigurationRequest", "traits": { "smithy.api#documentation": "

Specifies the boundaries of the compute node group auto scaling.

" } }, "iamInstanceProfileArn": { "target": "com.amazonaws.pcs#InstanceProfileArn", "traits": { "smithy.api#documentation": "

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 and the role name must start with AWSPCS or must have the path /aws-pcs/. For more information, see IAM instance profiles for PCS in the PCS User Guide.

" } }, "slurmConfiguration": { "target": "com.amazonaws.pcs#UpdateComputeNodeGroupSlurmConfigurationRequest", "traits": { "smithy.api#documentation": "

Additional options related to the Slurm scheduler.

" } }, "nodeLifecycleActions": { "target": "com.amazonaws.pcs#UpdateNodeLifecycleActionsRequest", "traits": { "smithy.api#documentation": "

The lifecycle actions to run on compute nodes in the compute node group. Use lifecycle actions to run custom scripts at defined stages of a compute node's lifecycle, such as when a compute node finishes bootstrapping or becomes ready to accept jobs.

" } }, "clientToken": { "target": "com.amazonaws.pcs#SBClientToken", "traits": { "smithy.api#documentation": "

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 one for you.

", "smithy.api#idempotencyToken": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.pcs#UpdateComputeNodeGroupResponse": { "type": "structure", "members": { "computeNodeGroup": { "target": "com.amazonaws.pcs#ComputeNodeGroup" } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.pcs#UpdateComputeNodeGroupSlurmConfigurationRequest": { "type": "structure", "members": { "scaleDownIdleTimeInSeconds": { "target": "smithy.api#Integer", "traits": { "smithy.api#documentation": "

The time (in seconds) before an idle node is scaled down. If not specified, the cluster-level setting applies. This overrides the cluster-level scaleDownIdleTimeInSeconds setting. A value of -1 removes the override and applies the cluster-level setting to this compute node group. Requires Slurm version 25.11 or later.

", "smithy.api#range": { "min": -1, "max": 10000000 } } }, "slurmCustomSettings": { "target": "com.amazonaws.pcs#SlurmCustomSettings", "traits": { "smithy.api#documentation": "

Additional Slurm-specific configuration that directly maps to Slurm settings.

" } }, "gresCustomSettings": { "target": "com.amazonaws.pcs#GresCustomSettings", "traits": { "smithy.api#documentation": "

The additional Slurm gres.conf records for the compute node group. Each item is a map of gres.conf attribute names to values that describes one gres.conf record, such as a GPU topology, MIG, MPS, or custom GRES entry. PCS adds the NodeName= prefix and merges these records with the GPU record it derives from the instance type.

" } } }, "traits": { "smithy.api#documentation": "

Additional options related to the Slurm scheduler.

" } }, "com.amazonaws.pcs#UpdateNodeLifecycleActionsRequest": { "type": "structure", "members": { "stages": { "target": "com.amazonaws.pcs#NodeLifecycleStages", "traits": { "smithy.api#documentation": "

The lifecycle stages where you configure scripts to run.

", "smithy.api#required": {} } }, "scriptCachingPolicy": { "target": "com.amazonaws.pcs#ScriptCachingPolicy", "traits": { "smithy.api#default": "CACHE_ONCE", "smithy.api#documentation": "

The caching policy for node lifecycle scripts. The default value is CACHE_ONCE. Valid values:

" } } }, "traits": { "smithy.api#documentation": "

The lifecycle actions to configure on a compute node group when you update it. Lifecycle actions define scripts that PCS runs on compute nodes at specific stages of their lifecycle.

" } }, "com.amazonaws.pcs#UpdateQueue": { "type": "operation", "input": { "target": "com.amazonaws.pcs#UpdateQueueRequest" }, "output": { "target": "com.amazonaws.pcs#UpdateQueueResponse" }, "errors": [ { "target": "com.amazonaws.pcs#AccessDeniedException" }, { "target": "com.amazonaws.pcs#ConflictException" }, { "target": "com.amazonaws.pcs#InternalServerException" }, { "target": "com.amazonaws.pcs#ResourceNotFoundException" }, { "target": "com.amazonaws.pcs#ServiceQuotaExceededException" }, { "target": "com.amazonaws.pcs#ThrottlingException" }, { "target": "com.amazonaws.pcs#ValidationException" } ], "traits": { "smithy.api#documentation": "

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.

", "smithy.api#idempotent": {}, "smithy.api#tags": [ "Queue" ] } }, "com.amazonaws.pcs#UpdateQueueRequest": { "type": "structure", "members": { "clusterIdentifier": { "target": "com.amazonaws.pcs#ClusterIdentifier", "traits": { "smithy.api#documentation": "

The name or ID of the cluster of the queue.

", "smithy.api#required": {} } }, "queueIdentifier": { "target": "com.amazonaws.pcs#QueueIdentifier", "traits": { "smithy.api#documentation": "

The name or ID of the queue.

", "smithy.api#required": {} } }, "computeNodeGroupConfigurations": { "target": "com.amazonaws.pcs#ComputeNodeGroupConfigurationList", "traits": { "smithy.api#documentation": "

The list of compute node group configurations to associate with the queue. Queues assign jobs to associated compute node groups.

" } }, "slurmConfiguration": { "target": "com.amazonaws.pcs#UpdateQueueSlurmConfigurationRequest", "traits": { "smithy.api#documentation": "

Additional options related to the Slurm scheduler.

" } }, "clientToken": { "target": "com.amazonaws.pcs#SBClientToken", "traits": { "smithy.api#documentation": "

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 one for you.

", "smithy.api#idempotencyToken": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.pcs#UpdateQueueResponse": { "type": "structure", "members": { "queue": { "target": "com.amazonaws.pcs#Queue" } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.pcs#UpdateQueueSlurmConfigurationRequest": { "type": "structure", "members": { "slurmCustomSettings": { "target": "com.amazonaws.pcs#SlurmCustomSettings", "traits": { "smithy.api#documentation": "

Additional Slurm-specific configuration that directly maps to Slurm settings.

" } } }, "traits": { "smithy.api#documentation": "

Additional options related to the Slurm scheduler.

" } }, "com.amazonaws.pcs#UpdateSchedulerRequest": { "type": "structure", "members": { "version": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The scheduler version to update the cluster to. You can only update to a newer version. For more information about supported versions and update paths, see Updating the scheduler version on a cluster in the PCS User Guide.

Valid Values: 24.05 | 24.11 | 25.05 | 25.11 | 26.05

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

The scheduler configuration for updating a cluster. Use this to specify the scheduler version to update to.

" } }, "com.amazonaws.pcs#UpdateSlurmRestRequest": { "type": "structure", "members": { "mode": { "target": "com.amazonaws.pcs#SlurmRestMode", "traits": { "smithy.api#documentation": "

The default value for mode is NONE. A value of STANDARD means the Slurm REST API is enabled.

" } } }, "traits": { "smithy.api#documentation": "

The Slurm REST API configuration includes settings for enabling and configuring the Slurm REST API.

" } }, "com.amazonaws.pcs#ValidationException": { "type": "structure", "members": { "message": { "target": "smithy.api#String", "traits": { "smithy.api#required": {} } }, "reason": { "target": "com.amazonaws.pcs#ValidationExceptionReason", "traits": { "smithy.api#documentation": "

The specific reason or cause of the validation error.

", "smithy.api#required": {} } }, "fieldList": { "target": "com.amazonaws.pcs#ValidationExceptionFieldList", "traits": { "smithy.api#documentation": "

A list of fields or properties that failed validation.

" } } }, "traits": { "smithy.api#documentation": "

The request isn't valid.

Examples

", "smithy.api#error": "client", "smithy.api#httpError": 400 } }, "com.amazonaws.pcs#ValidationExceptionField": { "type": "structure", "members": { "name": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The name of the exception.

", "smithy.api#required": {} } }, "message": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The message body of the exception.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

Stores information about a field in a request that caused an exception.

" } }, "com.amazonaws.pcs#ValidationExceptionFieldList": { "type": "list", "member": { "target": "com.amazonaws.pcs#ValidationExceptionField" } }, "com.amazonaws.pcs#ValidationExceptionReason": { "type": "enum", "members": { "UNKNOWN_OPERATION": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "unknownOperation" } }, "CANNOT_PARSE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "cannotParse" } }, "FIELD_VALIDATION_FAILED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "fieldValidationFailed" } }, "OTHER": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "other" } } } } } }