AWS Native is in preview. AWS Classic is fully supported.
aws-native.ecr.RepositoryCreationTemplate
Explore with Pulumi AI
AWS Native is in preview. AWS Classic is fully supported.
AWS::ECR::RepositoryCreationTemplate is used to create repository with configuration from a pre-defined template.
Create RepositoryCreationTemplate Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new RepositoryCreationTemplate(name: string, args: RepositoryCreationTemplateArgs, opts?: CustomResourceOptions);
@overload
def RepositoryCreationTemplate(resource_name: str,
args: RepositoryCreationTemplateArgs,
opts: Optional[ResourceOptions] = None)
@overload
def RepositoryCreationTemplate(resource_name: str,
opts: Optional[ResourceOptions] = None,
applied_for: Optional[Sequence[RepositoryCreationTemplateAppliedForItem]] = None,
prefix: Optional[str] = None,
description: Optional[str] = None,
encryption_configuration: Optional[RepositoryCreationTemplateEncryptionConfigurationArgs] = None,
image_tag_mutability: Optional[RepositoryCreationTemplateImageTagMutability] = None,
lifecycle_policy: Optional[str] = None,
repository_policy: Optional[str] = None,
resource_tags: Optional[Sequence[RepositoryCreationTemplateTagArgs]] = None)
func NewRepositoryCreationTemplate(ctx *Context, name string, args RepositoryCreationTemplateArgs, opts ...ResourceOption) (*RepositoryCreationTemplate, error)
public RepositoryCreationTemplate(string name, RepositoryCreationTemplateArgs args, CustomResourceOptions? opts = null)
public RepositoryCreationTemplate(String name, RepositoryCreationTemplateArgs args)
public RepositoryCreationTemplate(String name, RepositoryCreationTemplateArgs args, CustomResourceOptions options)
type: aws-native:ecr:RepositoryCreationTemplate
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args RepositoryCreationTemplateArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args RepositoryCreationTemplateArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args RepositoryCreationTemplateArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args RepositoryCreationTemplateArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args RepositoryCreationTemplateArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
RepositoryCreationTemplate Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
The RepositoryCreationTemplate resource accepts the following input properties:
- Applied
For List<Pulumi.Aws Native. Ecr. Repository Creation Template Applied For Item> - A list of enumerable Strings representing the repository creation scenarios that the template will apply towards.
- Prefix string
- The prefix use to match the repository name and apply the template.
- Description string
- The description of the template.
- Encryption
Configuration Pulumi.Aws Native. Ecr. Inputs. Repository Creation Template Encryption Configuration The encryption configuration for the repository. This determines how the contents of your repository are encrypted at rest.
By default, when no encryption configuration is set or the
AES256
encryption type is used, Amazon ECR uses server-side encryption with Amazon S3-managed encryption keys which encrypts your data at rest using an AES-256 encryption algorithm. This does not require any action on your part.For more control over the encryption of the contents of your repository, you can use server-side encryption with AWS Key Management Service key stored in AWS Key Management Service ( AWS KMS ) to encrypt your images. For more information, see Amazon ECR encryption at rest in the Amazon Elastic Container Registry User Guide .
- Image
Tag Pulumi.Mutability Aws Native. Ecr. Repository Creation Template Image Tag Mutability - The image tag mutability setting for the repository.
- Lifecycle
Policy string - The JSON lifecycle policy text to apply to the repository. For information about lifecycle policy syntax, see https://docs.aws.amazon.com/AmazonECR/latest/userguide/LifecyclePolicies.html
- Repository
Policy string - The JSON repository policy text to apply to the repository. For more information, see https://docs.aws.amazon.com/AmazonECR/latest/userguide/RepositoryPolicyExamples.html
- List<Pulumi.
Aws Native. Ecr. Inputs. Repository Creation Template Tag> - An array of key-value pairs to apply to this resource.
- Applied
For []RepositoryCreation Template Applied For Item - A list of enumerable Strings representing the repository creation scenarios that the template will apply towards.
- Prefix string
- The prefix use to match the repository name and apply the template.
- Description string
- The description of the template.
- Encryption
Configuration RepositoryCreation Template Encryption Configuration Args The encryption configuration for the repository. This determines how the contents of your repository are encrypted at rest.
By default, when no encryption configuration is set or the
AES256
encryption type is used, Amazon ECR uses server-side encryption with Amazon S3-managed encryption keys which encrypts your data at rest using an AES-256 encryption algorithm. This does not require any action on your part.For more control over the encryption of the contents of your repository, you can use server-side encryption with AWS Key Management Service key stored in AWS Key Management Service ( AWS KMS ) to encrypt your images. For more information, see Amazon ECR encryption at rest in the Amazon Elastic Container Registry User Guide .
- Image
Tag RepositoryMutability Creation Template Image Tag Mutability - The image tag mutability setting for the repository.
- Lifecycle
Policy string - The JSON lifecycle policy text to apply to the repository. For information about lifecycle policy syntax, see https://docs.aws.amazon.com/AmazonECR/latest/userguide/LifecyclePolicies.html
- Repository
Policy string - The JSON repository policy text to apply to the repository. For more information, see https://docs.aws.amazon.com/AmazonECR/latest/userguide/RepositoryPolicyExamples.html
- []Repository
Creation Template Tag Args - An array of key-value pairs to apply to this resource.
- applied
For List<RepositoryCreation Template Applied For Item> - A list of enumerable Strings representing the repository creation scenarios that the template will apply towards.
- prefix String
- The prefix use to match the repository name and apply the template.
- description String
- The description of the template.
- encryption
Configuration RepositoryCreation Template Encryption Configuration The encryption configuration for the repository. This determines how the contents of your repository are encrypted at rest.
By default, when no encryption configuration is set or the
AES256
encryption type is used, Amazon ECR uses server-side encryption with Amazon S3-managed encryption keys which encrypts your data at rest using an AES-256 encryption algorithm. This does not require any action on your part.For more control over the encryption of the contents of your repository, you can use server-side encryption with AWS Key Management Service key stored in AWS Key Management Service ( AWS KMS ) to encrypt your images. For more information, see Amazon ECR encryption at rest in the Amazon Elastic Container Registry User Guide .
- image
Tag RepositoryMutability Creation Template Image Tag Mutability - The image tag mutability setting for the repository.
- lifecycle
Policy String - The JSON lifecycle policy text to apply to the repository. For information about lifecycle policy syntax, see https://docs.aws.amazon.com/AmazonECR/latest/userguide/LifecyclePolicies.html
- repository
Policy String - The JSON repository policy text to apply to the repository. For more information, see https://docs.aws.amazon.com/AmazonECR/latest/userguide/RepositoryPolicyExamples.html
- List<Repository
Creation Template Tag> - An array of key-value pairs to apply to this resource.
- applied
For RepositoryCreation Template Applied For Item[] - A list of enumerable Strings representing the repository creation scenarios that the template will apply towards.
- prefix string
- The prefix use to match the repository name and apply the template.
- description string
- The description of the template.
- encryption
Configuration RepositoryCreation Template Encryption Configuration The encryption configuration for the repository. This determines how the contents of your repository are encrypted at rest.
By default, when no encryption configuration is set or the
AES256
encryption type is used, Amazon ECR uses server-side encryption with Amazon S3-managed encryption keys which encrypts your data at rest using an AES-256 encryption algorithm. This does not require any action on your part.For more control over the encryption of the contents of your repository, you can use server-side encryption with AWS Key Management Service key stored in AWS Key Management Service ( AWS KMS ) to encrypt your images. For more information, see Amazon ECR encryption at rest in the Amazon Elastic Container Registry User Guide .
- image
Tag RepositoryMutability Creation Template Image Tag Mutability - The image tag mutability setting for the repository.
- lifecycle
Policy string - The JSON lifecycle policy text to apply to the repository. For information about lifecycle policy syntax, see https://docs.aws.amazon.com/AmazonECR/latest/userguide/LifecyclePolicies.html
- repository
Policy string - The JSON repository policy text to apply to the repository. For more information, see https://docs.aws.amazon.com/AmazonECR/latest/userguide/RepositoryPolicyExamples.html
- Repository
Creation Template Tag[] - An array of key-value pairs to apply to this resource.
- applied_
for Sequence[RepositoryCreation Template Applied For Item] - A list of enumerable Strings representing the repository creation scenarios that the template will apply towards.
- prefix str
- The prefix use to match the repository name and apply the template.
- description str
- The description of the template.
- encryption_
configuration RepositoryCreation Template Encryption Configuration Args The encryption configuration for the repository. This determines how the contents of your repository are encrypted at rest.
By default, when no encryption configuration is set or the
AES256
encryption type is used, Amazon ECR uses server-side encryption with Amazon S3-managed encryption keys which encrypts your data at rest using an AES-256 encryption algorithm. This does not require any action on your part.For more control over the encryption of the contents of your repository, you can use server-side encryption with AWS Key Management Service key stored in AWS Key Management Service ( AWS KMS ) to encrypt your images. For more information, see Amazon ECR encryption at rest in the Amazon Elastic Container Registry User Guide .
- image_
tag_ Repositorymutability Creation Template Image Tag Mutability - The image tag mutability setting for the repository.
- lifecycle_
policy str - The JSON lifecycle policy text to apply to the repository. For information about lifecycle policy syntax, see https://docs.aws.amazon.com/AmazonECR/latest/userguide/LifecyclePolicies.html
- repository_
policy str - The JSON repository policy text to apply to the repository. For more information, see https://docs.aws.amazon.com/AmazonECR/latest/userguide/RepositoryPolicyExamples.html
- Sequence[Repository
Creation Template Tag Args] - An array of key-value pairs to apply to this resource.
- applied
For List<"REPLICATION" | "PULL_THROUGH_CACHE"> - A list of enumerable Strings representing the repository creation scenarios that the template will apply towards.
- prefix String
- The prefix use to match the repository name and apply the template.
- description String
- The description of the template.
- encryption
Configuration Property Map The encryption configuration for the repository. This determines how the contents of your repository are encrypted at rest.
By default, when no encryption configuration is set or the
AES256
encryption type is used, Amazon ECR uses server-side encryption with Amazon S3-managed encryption keys which encrypts your data at rest using an AES-256 encryption algorithm. This does not require any action on your part.For more control over the encryption of the contents of your repository, you can use server-side encryption with AWS Key Management Service key stored in AWS Key Management Service ( AWS KMS ) to encrypt your images. For more information, see Amazon ECR encryption at rest in the Amazon Elastic Container Registry User Guide .
- image
Tag "MUTABLE" | "IMMUTABLE"Mutability - The image tag mutability setting for the repository.
- lifecycle
Policy String - The JSON lifecycle policy text to apply to the repository. For information about lifecycle policy syntax, see https://docs.aws.amazon.com/AmazonECR/latest/userguide/LifecyclePolicies.html
- repository
Policy String - The JSON repository policy text to apply to the repository. For more information, see https://docs.aws.amazon.com/AmazonECR/latest/userguide/RepositoryPolicyExamples.html
- List<Property Map>
- An array of key-value pairs to apply to this resource.
Outputs
All input properties are implicitly available as output properties. Additionally, the RepositoryCreationTemplate resource produces the following output properties:
- created_
at str - Create timestamp of the template.
- id str
- The provider-assigned unique ID for this managed resource.
- updated_
at str - Update timestamp of the template.
Supporting Types
RepositoryCreationTemplateAppliedForItem, RepositoryCreationTemplateAppliedForItemArgs
- Replication
- REPLICATION
- Pull
Through Cache - PULL_THROUGH_CACHE
- Repository
Creation Template Applied For Item Replication - REPLICATION
- Repository
Creation Template Applied For Item Pull Through Cache - PULL_THROUGH_CACHE
- Replication
- REPLICATION
- Pull
Through Cache - PULL_THROUGH_CACHE
- Replication
- REPLICATION
- Pull
Through Cache - PULL_THROUGH_CACHE
- REPLICATION
- REPLICATION
- PULL_THROUGH_CACHE
- PULL_THROUGH_CACHE
- "REPLICATION"
- REPLICATION
- "PULL_THROUGH_CACHE"
- PULL_THROUGH_CACHE
RepositoryCreationTemplateEncryptionConfiguration, RepositoryCreationTemplateEncryptionConfigurationArgs
- Encryption
Type Pulumi.Aws Native. Ecr. Repository Creation Template Encryption Type The encryption type to use.
If you use the
KMS
encryption type, the contents of the repository will be encrypted using server-side encryption with AWS Key Management Service key stored in AWS KMS . When you use AWS KMS to encrypt your data, you can either use the default AWS managed AWS KMS key for Amazon ECR, or specify your own AWS KMS key, which you already created. For more information, see Protecting data using server-side encryption with an AWS KMS key stored in AWS Key Management Service (SSE-KMS) in the Amazon Simple Storage Service Console Developer Guide .If you use the
AES256
encryption type, Amazon ECR uses server-side encryption with Amazon S3-managed encryption keys which encrypts the images in the repository using an AES-256 encryption algorithm. For more information, see Protecting data using server-side encryption with Amazon S3-managed encryption keys (SSE-S3) in the Amazon Simple Storage Service Console Developer Guide .- Kms
Key string - If you use the
KMS
encryption type, specify the AWS KMS key to use for encryption. The alias, key ID, or full ARN of the AWS KMS key can be specified. The key must exist in the same Region as the repository. If no key is specified, the default AWS managed AWS KMS key for Amazon ECR will be used.
- Encryption
Type RepositoryCreation Template Encryption Type The encryption type to use.
If you use the
KMS
encryption type, the contents of the repository will be encrypted using server-side encryption with AWS Key Management Service key stored in AWS KMS . When you use AWS KMS to encrypt your data, you can either use the default AWS managed AWS KMS key for Amazon ECR, or specify your own AWS KMS key, which you already created. For more information, see Protecting data using server-side encryption with an AWS KMS key stored in AWS Key Management Service (SSE-KMS) in the Amazon Simple Storage Service Console Developer Guide .If you use the
AES256
encryption type, Amazon ECR uses server-side encryption with Amazon S3-managed encryption keys which encrypts the images in the repository using an AES-256 encryption algorithm. For more information, see Protecting data using server-side encryption with Amazon S3-managed encryption keys (SSE-S3) in the Amazon Simple Storage Service Console Developer Guide .- Kms
Key string - If you use the
KMS
encryption type, specify the AWS KMS key to use for encryption. The alias, key ID, or full ARN of the AWS KMS key can be specified. The key must exist in the same Region as the repository. If no key is specified, the default AWS managed AWS KMS key for Amazon ECR will be used.
- encryption
Type RepositoryCreation Template Encryption Type The encryption type to use.
If you use the
KMS
encryption type, the contents of the repository will be encrypted using server-side encryption with AWS Key Management Service key stored in AWS KMS . When you use AWS KMS to encrypt your data, you can either use the default AWS managed AWS KMS key for Amazon ECR, or specify your own AWS KMS key, which you already created. For more information, see Protecting data using server-side encryption with an AWS KMS key stored in AWS Key Management Service (SSE-KMS) in the Amazon Simple Storage Service Console Developer Guide .If you use the
AES256
encryption type, Amazon ECR uses server-side encryption with Amazon S3-managed encryption keys which encrypts the images in the repository using an AES-256 encryption algorithm. For more information, see Protecting data using server-side encryption with Amazon S3-managed encryption keys (SSE-S3) in the Amazon Simple Storage Service Console Developer Guide .- kms
Key String - If you use the
KMS
encryption type, specify the AWS KMS key to use for encryption. The alias, key ID, or full ARN of the AWS KMS key can be specified. The key must exist in the same Region as the repository. If no key is specified, the default AWS managed AWS KMS key for Amazon ECR will be used.
- encryption
Type RepositoryCreation Template Encryption Type The encryption type to use.
If you use the
KMS
encryption type, the contents of the repository will be encrypted using server-side encryption with AWS Key Management Service key stored in AWS KMS . When you use AWS KMS to encrypt your data, you can either use the default AWS managed AWS KMS key for Amazon ECR, or specify your own AWS KMS key, which you already created. For more information, see Protecting data using server-side encryption with an AWS KMS key stored in AWS Key Management Service (SSE-KMS) in the Amazon Simple Storage Service Console Developer Guide .If you use the
AES256
encryption type, Amazon ECR uses server-side encryption with Amazon S3-managed encryption keys which encrypts the images in the repository using an AES-256 encryption algorithm. For more information, see Protecting data using server-side encryption with Amazon S3-managed encryption keys (SSE-S3) in the Amazon Simple Storage Service Console Developer Guide .- kms
Key string - If you use the
KMS
encryption type, specify the AWS KMS key to use for encryption. The alias, key ID, or full ARN of the AWS KMS key can be specified. The key must exist in the same Region as the repository. If no key is specified, the default AWS managed AWS KMS key for Amazon ECR will be used.
- encryption_
type RepositoryCreation Template Encryption Type The encryption type to use.
If you use the
KMS
encryption type, the contents of the repository will be encrypted using server-side encryption with AWS Key Management Service key stored in AWS KMS . When you use AWS KMS to encrypt your data, you can either use the default AWS managed AWS KMS key for Amazon ECR, or specify your own AWS KMS key, which you already created. For more information, see Protecting data using server-side encryption with an AWS KMS key stored in AWS Key Management Service (SSE-KMS) in the Amazon Simple Storage Service Console Developer Guide .If you use the
AES256
encryption type, Amazon ECR uses server-side encryption with Amazon S3-managed encryption keys which encrypts the images in the repository using an AES-256 encryption algorithm. For more information, see Protecting data using server-side encryption with Amazon S3-managed encryption keys (SSE-S3) in the Amazon Simple Storage Service Console Developer Guide .- kms_
key str - If you use the
KMS
encryption type, specify the AWS KMS key to use for encryption. The alias, key ID, or full ARN of the AWS KMS key can be specified. The key must exist in the same Region as the repository. If no key is specified, the default AWS managed AWS KMS key for Amazon ECR will be used.
- encryption
Type "AES256" | "KMS" The encryption type to use.
If you use the
KMS
encryption type, the contents of the repository will be encrypted using server-side encryption with AWS Key Management Service key stored in AWS KMS . When you use AWS KMS to encrypt your data, you can either use the default AWS managed AWS KMS key for Amazon ECR, or specify your own AWS KMS key, which you already created. For more information, see Protecting data using server-side encryption with an AWS KMS key stored in AWS Key Management Service (SSE-KMS) in the Amazon Simple Storage Service Console Developer Guide .If you use the
AES256
encryption type, Amazon ECR uses server-side encryption with Amazon S3-managed encryption keys which encrypts the images in the repository using an AES-256 encryption algorithm. For more information, see Protecting data using server-side encryption with Amazon S3-managed encryption keys (SSE-S3) in the Amazon Simple Storage Service Console Developer Guide .- kms
Key String - If you use the
KMS
encryption type, specify the AWS KMS key to use for encryption. The alias, key ID, or full ARN of the AWS KMS key can be specified. The key must exist in the same Region as the repository. If no key is specified, the default AWS managed AWS KMS key for Amazon ECR will be used.
RepositoryCreationTemplateEncryptionType, RepositoryCreationTemplateEncryptionTypeArgs
- Aes256
- AES256
- Kms
- KMS
- Repository
Creation Template Encryption Type Aes256 - AES256
- Repository
Creation Template Encryption Type Kms - KMS
- Aes256
- AES256
- Kms
- KMS
- Aes256
- AES256
- Kms
- KMS
- AES256
- AES256
- KMS
- KMS
- "AES256"
- AES256
- "KMS"
- KMS
RepositoryCreationTemplateImageTagMutability, RepositoryCreationTemplateImageTagMutabilityArgs
- Mutable
- MUTABLE
- Immutable
- IMMUTABLE
- Repository
Creation Template Image Tag Mutability Mutable - MUTABLE
- Repository
Creation Template Image Tag Mutability Immutable - IMMUTABLE
- Mutable
- MUTABLE
- Immutable
- IMMUTABLE
- Mutable
- MUTABLE
- Immutable
- IMMUTABLE
- MUTABLE
- MUTABLE
- IMMUTABLE
- IMMUTABLE
- "MUTABLE"
- MUTABLE
- "IMMUTABLE"
- IMMUTABLE
RepositoryCreationTemplateTag, RepositoryCreationTemplateTagArgs
- Key string
- The key name of the tag. You can specify a value that is 1 to 128 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.
- Value string
- The value for the tag. You can specify a value that is 0 to 256 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.
- Key string
- The key name of the tag. You can specify a value that is 1 to 128 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.
- Value string
- The value for the tag. You can specify a value that is 0 to 256 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.
- key String
- The key name of the tag. You can specify a value that is 1 to 128 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.
- value String
- The value for the tag. You can specify a value that is 0 to 256 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.
- key string
- The key name of the tag. You can specify a value that is 1 to 128 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.
- value string
- The value for the tag. You can specify a value that is 0 to 256 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.
- key str
- The key name of the tag. You can specify a value that is 1 to 128 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.
- value str
- The value for the tag. You can specify a value that is 0 to 256 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.
- key String
- The key name of the tag. You can specify a value that is 1 to 128 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.
- value String
- The value for the tag. You can specify a value that is 0 to 256 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.
Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
AWS Native is in preview. AWS Classic is fully supported.