Method

Search:

Deregisters an Amazon ECS container instance from the specified cluster. This instance
is no longer available to run tasks.

If you intend to use the container instance for some other purpose after deregistration,
you should stop all of the tasks running on the container instance before deregistration.
That prevents any orphaned tasks from consuming resources.

Deregistering a container instance removes the instance from a cluster, but it does
not terminate the EC2 instance; if you are finished using the instance, be sure to
terminate it in the Amazon EC2 console to stop billing.

If you terminate a running container instance, Amazon ECS automatically deregisters
the instance from your cluster (stopped container instances or instances with disconnected
agents are not automatically deregistered when terminated).

Note:

For .NET Core and PCL this operation is only available in asynchronous form. Please refer to DeregisterContainerInstanceAsync.

Exceptions

These errors are usually caused by a client action, such as using an action or resource
on behalf of a user that doesn't have permissions to use the action or resource, or
specifying an identifier that is not valid.

Examples

This example deregisters a container instance from the specified cluster in your default region. If there are still tasks running on the container instance, you must either stop those tasks before deregistering, or use the force option.