Retrieves the pre-signed Amazon S3 download URL corresponding to an image layer. You can
only get URLs for image layers that are referenced in an image.
When an image is pulled, the GetDownloadUrlForLayer API is called once per image layer
that is not already cached.
This operation is used by the Amazon ECR proxy and is not generally used by
customers for pulling and pushing images. In most cases, you should use the docker CLI to pull, tag, and push images.
Example
Use a bare-bones client and the command you need to make an API call.
The specified repository could not be found. Check the spelling of the specified
repository and ensure that you are performing operations on the correct registry.
Retrieves the pre-signed Amazon S3 download URL corresponding to an image layer. You can only get URLs for image layers that are referenced in an image.
When an image is pulled, the GetDownloadUrlForLayer API is called once per image layer that is not already cached.
This operation is used by the Amazon ECR proxy and is not generally used by customers for pulling and pushing images. In most cases, you should use the
docker
CLI to pull, tag, and push images.Example
Use a bare-bones client and the command you need to make an API call.
Param
GetDownloadUrlForLayerCommandInput
Returns
GetDownloadUrlForLayerCommandOutput
See
input
shape.response
shape.config
shape.Throws
InvalidParameterException (client fault)
The specified parameter is invalid. Review the available parameters for the API request.
Throws
LayerInaccessibleException (client fault)
The specified layer is not available because it is not associated with an image. Unassociated image layers may be cleaned up at any time.
Throws
LayersNotFoundException (client fault)
The specified layers could not be found, or the specified layer is not valid for this repository.
Throws
RepositoryNotFoundException (client fault)
The specified repository could not be found. Check the spelling of the specified repository and ensure that you are performing operations on the correct registry.
Throws
ServerException (server fault)
These errors are usually caused by a server-side issue.
Throws
UnableToGetUpstreamLayerException (client fault)
There was an issue getting the upstream layer matching the pull through cache rule.
Throws
ECRServiceException
Base exception class for all service exceptions from ECR service.