AWS Documentation » Amazon ECS » Developer Guide » Using the Amazon ECS Command Line Interface » Amazon ECS Command Line Reference » ecs-cli pull

ecs-cli pull

Pull an image from an Amazon ECR repository.

Important

Some features described may only be available with the latest version of the Amazon ECS CLI. For more information about obtaining the latest version, see Installing the Amazon ECS CLI.

Syntax

ecs-cli pull [--registry-id registry_id] [--region region] ECR_REPOSITORY[:TAG|@DIGEST] [--help]

Options

Name	Description
--registry-id registry_id	Specifies the Amazon ECR registry ID from which to pull the image. By default, images are pulled from the current AWS account. Required: No
--region, -r region	Specifies the AWS Region to use. Defaults to the cluster configured using the configure command. Type: String Required: No
--help, -h	Shows the help text for the specified command. Required: No

Examples

Example 1

This example pulls a local image called amazonlinux from an Amazon ECR repository with the same name.

ecs-cli pull amazonlinux

Output:

INFO[0000] Getting AWS account ID...
INFO[0000] Pulling image                                 repository="aws_account_id.dkr.ecr.us-east-1.amazonaws.com/amazonlinux" tag=
INFO[0129] Image pulled