v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1456373564.1 KB

<note> <p>This action is only used by the Amazon ECS agent, and it is not intended for use outside of the agent.</p> </note> <p>Registers an EC2 instance into the specified cluster. This instance becomes available to place containers on.</p>

post/#X-Amz-Target=AmazonEC2ContainerServiceV20141113.RegisterContainerInstance

Headers

X-Amz-Target'AmazonEC2ContainerServiceV20141113.RegisterContainerInstance' required

Request body

clusterstring

The short name or full Amazon Resource Name (ARN) of the cluster to register your container instance with. If you do not specify a cluster, the default cluster is assumed.

instanceIdentityDocumentstring

The instance identity document for the EC2 instance to register. This document can be found by running the following command from the instance: <code>curl http://169.254.169.254/latest/dynamic/instance-identity/document/</code>

instanceIdentityDocumentSignaturestring

The instance identity document signature for the EC2 instance to register. This signature can be found by running the following command from the instance: <code>curl http://169.254.169.254/latest/dynamic/instance-identity/signature/</code>

containerInstanceArnstring

The ARN of the container instance (if it was previously registered).

Response

Success