AWS::ECR::RepositoryCreationTemplate - Amazon CloudFormation
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

AWS::ECR::RepositoryCreationTemplate

The details of the repository creation template associated with the request.

Syntax

To declare this entity in your Amazon CloudFormation template, use the following syntax:

JSON

{ "Type" : "AWS::ECR::RepositoryCreationTemplate", "Properties" : { "AppliedFor" : [ String, ... ], "CustomRoleArn" : String, "Description" : String, "EncryptionConfiguration" : EncryptionConfiguration, "ImageTagMutability" : String, "LifecyclePolicy" : String, "Prefix" : String, "RepositoryPolicy" : String, "ResourceTags" : [ Tag, ... ] } }

YAML

Type: AWS::ECR::RepositoryCreationTemplate Properties: AppliedFor: - String CustomRoleArn: String Description: String EncryptionConfiguration: EncryptionConfiguration ImageTagMutability: String LifecyclePolicy: String Prefix: String RepositoryPolicy: String ResourceTags: - Tag

Properties

AppliedFor

A list of enumerable Strings representing the repository creation scenarios that this template will apply towards. The two supported scenarios are PULL_THROUGH_CACHE and REPLICATION

Required: Yes

Type: Array of String

Update requires: No interruption

CustomRoleArn

The ARN of the role to be assumed by Amazon ECR. Amazon ECR will assume your supplied role when the customRoleArn is specified. When this field isn't specified, Amazon ECR will use the service-linked role for the repository creation template.

Required: No

Type: String

Pattern: ^arn:aws[-a-z0-9]*:iam::[0-9]{12}:role/[A-Za-z0-9+=,-.@_]*$

Maximum: 2048

Update requires: No interruption

Description

The description associated with the repository creation template.

Required: No

Type: String

Minimum: 0

Maximum: 256

Update requires: No interruption

EncryptionConfiguration

The encryption configuration associated with the repository creation template.

Required: No

Type: EncryptionConfiguration

Update requires: No interruption

ImageTagMutability

The tag mutability setting for the repository. If this parameter is omitted, the default setting of MUTABLE will be used which will allow image tags to be overwritten. If IMMUTABLE is specified, all image tags within the repository will be immutable which will prevent them from being overwritten.

Required: No

Type: String

Allowed values: MUTABLE | IMMUTABLE

Update requires: No interruption

LifecyclePolicy

The lifecycle policy to use for repositories created using the template.

Required: No

Type: String

Minimum: 100

Maximum: 30720

Update requires: No interruption

Prefix

The repository namespace prefix associated with the repository creation template.

Required: Yes

Type: String

Pattern: ^((?:[a-z0-9]+(?:[._-][a-z0-9]+)*/)*[a-z0-9]+(?:[._-][a-z0-9]+)*/?|ROOT)$

Minimum: 1

Maximum: 256

Update requires: Replacement

RepositoryPolicy

he repository policy to apply to repositories created using the template. A repository policy is a permissions policy associated with a repository to control access permissions.

Required: No

Type: String

Minimum: 0

Maximum: 10240

Update requires: No interruption

ResourceTags

The metadata to apply to the repository to help you categorize and organize. Each tag consists of a key and an optional value, both of which you define. Tag keys can have a maximum character length of 128 characters, and tag values can have a maximum length of 256 characters.

Required: No

Type: Array of Tag

Maximum: 50

Update requires: No interruption

Return values

Ref

Fn::GetAtt

CreatedAt

The date and time, in JavaScript date format, when the repository creation template was created.

UpdatedAt

The date and time, in JavaScript date format, when the repository creation template was last updated.