download_url_for_layers

Creates, updates, deletes, gets or lists a download_url_for_layers resource.

Overview

Name	download_url_for_layers
Type	Resource
Id	aws.ecr.download_url_for_layers

Fields

The following fields are returned by SELECT queries:

get_download_url_for_layer

Name	Datatype	Description
download_url	string	The pre-signed Amazon S3 download URL for the requested layer.
layer_digest	string	The digest of the image layer to download. (pattern: <code>[a-zA-Z0-9-_+.]+:[a-fA-F0-9]+</code>)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_download_url_for_layer	select	region		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.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
region	string	AWS region (default: us-east-1)

SELECT examples

get_download_url_for_layer

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.

SELECT
download_url,
layer_digest
FROM aws.ecr.download_url_for_layers
WHERE region = '{{ region }}' -- required
;