authorization_tokens

Creates, updates, deletes, gets or lists an authorization_tokens resource.

Overview

Name	authorization_tokens
Type	Resource
Id	aws.ecr.authorization_tokens

Fields

The following fields are returned by SELECT queries:

get_authorization_token

Name	Datatype	Description
authorization_data	array	A list of authorization token data objects that correspond to the registryIds values in the request. The size of the authorization token returned by Amazon ECR is not fixed. We recommend that you don't make assumptions about the maximum size.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_authorization_token	select	region		Retrieves an authorization token. An authorization token represents your IAM authentication credentials and can be used to access any Amazon ECR registry that your IAM principal has access to. The authorization token is valid for 12 hours. The authorizationToken returned is a base64 encoded string that can be decoded and used in a docker login command to authenticate to a registry. The CLI offers an get-login-password command that simplifies the login process. For more information, see Registry authentication in the Amazon Elastic Container Registry User Guide.

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_authorization_token

Retrieves an authorization token. An authorization token represents your IAM authentication credentials and can be used to access any Amazon ECR registry that your IAM principal has access to. The authorization token is valid for 12 hours. The authorizationToken returned is a base64 encoded string that can be decoded and used in a docker login command to authenticate to a registry. The CLI offers an get-login-password command that simplifies the login process. For more information, see Registry authentication in the Amazon Elastic Container Registry User Guide.

SELECT
authorization_data
FROM aws.ecr.authorization_tokens
WHERE region = '{{ region }}' -- required
;