ecs:DeregisterContainerInstance

Write

ecs:DeregisterContainerInstance is a Write access-level action in the ecs service. Grants permission to deregister an Amazon ECS container instance from the specified cluster

Resource types

ARNs that ecs:DeregisterContainerInstance can be scoped to in an IAM policy.

arn:${Partition}:ecs:${Region}:${Account}:cluster/${ClusterName}
cluster

Condition keys

Keys you can use in the Condition block of a policy that grants ecs:DeregisterContainerInstance.

aws:ResourceTag/${TagKey} String

Filters access by the tag key-value pairs attached to the resource

ecs:ResourceTag/${TagKey} String

Filters access by the tag key-value pairs attached to the resource

Example IAM policy

A minimal policy that allows ecs:DeregisterContainerInstance. Replace "Resource": "*" with a specific ARN to follow least privilege.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowEcsDeregisterContainerInstance",
      "Effect": "Allow",
      "Action": "ecs:DeregisterContainerInstance",
      "Resource": "*"
    }
  ]
}

Related actions in ecs

View all ecs actions →