Pull an image
Find an image's tag or digest and pull it, by tag or pinned to its digest.
Replace org-example1234.ecr.example.com with your registry host, my-app with the repository name and repository-id with its id.
Prerequisites
- Permission for
ecr:PullImageon the repository. On a public repository a client that is not logged in pulls without it; a logged-in client is still judged by its policies. - To list images:
ecr:ListImageson the repository through the CLI or the API. In the console,ecr:DescribeRepositorieson it; without it the repository's page answers 404.
Find the image
- Open Image repositories, then open the repository.
- On the Images tab, choose the image's row.
The row's detail shows a docker pull line per tag and Pull by digest. The tab reads the
newest 500 manifests; when there are more, older images are listed through the CLI or the API.
dcloud ecr images list repository-id --limit 100 --offset 0GET /ecr/api/repositories/repository-id/images?limit=100&offset=0The list has one row per tag, { tag, manifest }, newest image first, plus one row with
tag: null for each manifest no tag points at: an untagged image, and also each platform image
of a multi-platform image and each signature or SBOM. hasMore says whether there is another page. limit is 1–500
(100 by default). It carries no scan state; read that per image (see
Scan an image).
Pull
docker pull org-example1234.ecr.example.com/my-app:v1.2.0
docker pull org-example1234.ecr.example.com/my-app@sha256:<digest>A pull by digest gets exactly that image, however its tags move later.
If the pull is refused
DENIEDtoken does not grant pull on repository my-app: the credential may not pull this repository. Without credentials, a private repository answers401instead.NAME_UNKNOWNrepository name not known: no repository has that name.MANIFEST_UNKNOWNmanifest unknown: no image has that tag or digest. An image a lifecycle rule deleted answers the same, and the pull is noted on it (see Restore an expired image).