Request Syntax Request Parameters Response Syntax Response Elements Errors See Also

RegisterComputeNodeGroupInstance

Important

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

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

Request Syntax


{
   "bootstrapId": "string",
   "clusterIdentifier": "string"
}

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

bootstrapId

The client-generated token to allow for retries.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1000.

Pattern: [\S]+

Required: Yes

clusterIdentifier

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

Type: String

Pattern: (pcs_[a-zA-Z0-9]+|[A-Za-z][A-Za-z0-9-]{1,40})

Required: Yes

Response Syntax


{
   "endpoints": [ 
      { 
         "port": "string",
         "privateIpAddress": "string",
         "publicIpAddress": "string",
         "type": "string"
      }
   ],
   "nodeID": "string",
   "sharedSecret": "string"
}

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

endpoints

The list of endpoints available for interaction with the scheduler.

Type: Array of Endpoint objects

nodeID

The scheduler node ID for this instance.

Type: String

sharedSecret

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

Type: String

Errors

For information about the errors that are common to all actions, see Common Errors.

AccessDeniedException

You don't have permission to perform the action.

Examples

The launch template instance profile doesn't pass iam:PassRole verification.
There is a mismatch between the account ID and cluster ID.
The cluster ID doesn't exist.
The EC2 instance isn't present.

HTTP Status Code: 400

InternalServerException

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

HTTP Status Code: 500