ecr:DescribeImages

List

ecr:DescribeImages is a List access-level action in the ecr service. Grants permission to get metadata about the images in a repository, including image size, image tags, and creation date

Resource types

ARNs that ecr:DescribeImages can be scoped to in an IAM policy.

arn:${Partition}:ecr:${Region}:${Account}:repository/${RepositoryName}
repository

Condition keys

Keys you can use in the Condition block of a policy that grants ecr:DescribeImages.

aws:ResourceTag/${TagKey} String

Filters access by tag-value associated with the resource

ecr:ResourceTag/${TagKey} String

Filters access by tag-value associated with the resource

Example IAM policy

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

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowEcrDescribeImages",
      "Effect": "Allow",
      "Action": "ecr:DescribeImages",
      "Resource": "*"
    }
  ]
}

Related actions in ecr

ecr:BatchCheckLayerAvailability Read ecr:BatchDeleteImage Write ecr:BatchGetImage Read ecr:BatchGetRepositoryScanningConfiguration Read ecr:BatchImportUpstreamImage Write ecr:CompleteLayerUpload Write ecr:CreatePullThroughCacheRule Write ecr:CreateRepository Write ecr:CreateRepositoryCreationTemplate Write ecr:DeleteLifecyclePolicy Write ecr:DeletePullThroughCacheRule Write ecr:DeleteRegistryPolicy Permissions management

View all ecr actions →