Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. AWS Cloud Control
  3. API Docs
  4. ecr
  5. getRepositoryCreationTemplate

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.27.0 published on Monday, Apr 14, 2025 by Pulumi
pulumi/pulumi-aws-native

aws-native.ecr.getRepositoryCreationTemplate

Explore with Pulumi AI

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.27.0 published on Monday, Apr 14, 2025 by Pulumi
pulumi/pulumi-aws-native

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

Using getRepositoryCreationTemplate

Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

function getRepositoryCreationTemplate(args: GetRepositoryCreationTemplateArgs, opts?: InvokeOptions): Promise<GetRepositoryCreationTemplateResult>
function getRepositoryCreationTemplateOutput(args: GetRepositoryCreationTemplateOutputArgs, opts?: InvokeOptions): Output<GetRepositoryCreationTemplateResult>
Copy
def get_repository_creation_template(prefix: Optional[str] = None,
                                     opts: Optional[InvokeOptions] = None) -> GetRepositoryCreationTemplateResult
def get_repository_creation_template_output(prefix: Optional[pulumi.Input[str]] = None,
                                     opts: Optional[InvokeOptions] = None) -> Output[GetRepositoryCreationTemplateResult]
Copy
func LookupRepositoryCreationTemplate(ctx *Context, args *LookupRepositoryCreationTemplateArgs, opts ...InvokeOption) (*LookupRepositoryCreationTemplateResult, error)
func LookupRepositoryCreationTemplateOutput(ctx *Context, args *LookupRepositoryCreationTemplateOutputArgs, opts ...InvokeOption) LookupRepositoryCreationTemplateResultOutput
Copy

> Note: This function is named LookupRepositoryCreationTemplate in the Go SDK.

public static class GetRepositoryCreationTemplate 
{
    public static Task<GetRepositoryCreationTemplateResult> InvokeAsync(GetRepositoryCreationTemplateArgs args, InvokeOptions? opts = null)
    public static Output<GetRepositoryCreationTemplateResult> Invoke(GetRepositoryCreationTemplateInvokeArgs args, InvokeOptions? opts = null)
}
Copy
public static CompletableFuture<GetRepositoryCreationTemplateResult> getRepositoryCreationTemplate(GetRepositoryCreationTemplateArgs args, InvokeOptions options)
public static Output<GetRepositoryCreationTemplateResult> getRepositoryCreationTemplate(GetRepositoryCreationTemplateArgs args, InvokeOptions options)
Copy
fn::invoke:
  function: aws-native:ecr:getRepositoryCreationTemplate
  arguments:
    # arguments dictionary
Copy

The following arguments are supported:

Prefix This property is required. string
The repository namespace prefix associated with the repository creation template.
Prefix This property is required. string
The repository namespace prefix associated with the repository creation template.
prefix This property is required. String
The repository namespace prefix associated with the repository creation template.
prefix This property is required. string
The repository namespace prefix associated with the repository creation template.
prefix This property is required. str
The repository namespace prefix associated with the repository creation template.
prefix This property is required. String
The repository namespace prefix associated with the repository creation template.

getRepositoryCreationTemplate Result

The following output properties are available:

AppliedFor List<Pulumi.AwsNative.Ecr.RepositoryCreationTemplateAppliedForItem>
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
CreatedAt string
The date and time, in JavaScript date format, when the repository creation template was created.
CustomRoleArn string
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.
Description string
The description associated with the repository creation template.
EncryptionConfiguration Pulumi.AwsNative.Ecr.Outputs.RepositoryCreationTemplateEncryptionConfiguration
The encryption configuration associated with the repository creation template.
ImageTagMutability Pulumi.AwsNative.Ecr.RepositoryCreationTemplateImageTagMutability
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.
LifecyclePolicy string
The lifecycle policy to use for repositories created using the template.
RepositoryPolicy string
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.
ResourceTags List<Pulumi.AwsNative.Ecr.Outputs.RepositoryCreationTemplateTag>
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.
UpdatedAt string
The date and time, in JavaScript date format, when the repository creation template was last updated.
AppliedFor []RepositoryCreationTemplateAppliedForItem
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
CreatedAt string
The date and time, in JavaScript date format, when the repository creation template was created.
CustomRoleArn string
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.
Description string
The description associated with the repository creation template.
EncryptionConfiguration RepositoryCreationTemplateEncryptionConfiguration
The encryption configuration associated with the repository creation template.
ImageTagMutability RepositoryCreationTemplateImageTagMutability
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.
LifecyclePolicy string
The lifecycle policy to use for repositories created using the template.
RepositoryPolicy string
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.
ResourceTags []RepositoryCreationTemplateTag
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.
UpdatedAt string
The date and time, in JavaScript date format, when the repository creation template was last updated.
appliedFor List<RepositoryCreationTemplateAppliedForItem>
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
createdAt String
The date and time, in JavaScript date format, when the repository creation template was created.
customRoleArn String
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.
description String
The description associated with the repository creation template.
encryptionConfiguration RepositoryCreationTemplateEncryptionConfiguration
The encryption configuration associated with the repository creation template.
imageTagMutability RepositoryCreationTemplateImageTagMutability
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.
lifecyclePolicy String
The lifecycle policy to use for repositories created using the template.
repositoryPolicy String
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.
resourceTags List<RepositoryCreationTemplateTag>
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.
updatedAt String
The date and time, in JavaScript date format, when the repository creation template was last updated.
appliedFor RepositoryCreationTemplateAppliedForItem[]
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
createdAt string
The date and time, in JavaScript date format, when the repository creation template was created.
customRoleArn string
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.
description string
The description associated with the repository creation template.
encryptionConfiguration RepositoryCreationTemplateEncryptionConfiguration
The encryption configuration associated with the repository creation template.
imageTagMutability RepositoryCreationTemplateImageTagMutability
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.
lifecyclePolicy string
The lifecycle policy to use for repositories created using the template.
repositoryPolicy string
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.
resourceTags RepositoryCreationTemplateTag[]
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.
updatedAt string
The date and time, in JavaScript date format, when the repository creation template was last updated.
applied_for Sequence[RepositoryCreationTemplateAppliedForItem]
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
created_at str
The date and time, in JavaScript date format, when the repository creation template was created.
custom_role_arn str
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.
description str
The description associated with the repository creation template.
encryption_configuration RepositoryCreationTemplateEncryptionConfiguration
The encryption configuration associated with the repository creation template.
image_tag_mutability RepositoryCreationTemplateImageTagMutability
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.
lifecycle_policy str
The lifecycle policy to use for repositories created using the template.
repository_policy str
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.
resource_tags Sequence[RepositoryCreationTemplateTag]
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.
updated_at str
The date and time, in JavaScript date format, when the repository creation template was last updated.
appliedFor List<"REPLICATION" | "PULL_THROUGH_CACHE">
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
createdAt String
The date and time, in JavaScript date format, when the repository creation template was created.
customRoleArn String
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.
description String
The description associated with the repository creation template.
encryptionConfiguration Property Map
The encryption configuration associated with the repository creation template.
imageTagMutability "MUTABLE" | "IMMUTABLE"
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.
lifecyclePolicy String
The lifecycle policy to use for repositories created using the template.
repositoryPolicy String
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.
resourceTags List<Property Map>
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.
updatedAt String
The date and time, in JavaScript date format, when the repository creation template was last updated.

Supporting Types

RepositoryCreationTemplateAppliedForItem

RepositoryCreationTemplateEncryptionConfiguration

EncryptionType This property is required. Pulumi.AwsNative.Ecr.RepositoryCreationTemplateEncryptionType
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 KMSlong key stored in KMS. When you use KMS to encrypt your data, you can either use the default AWS managed KMS key for Amazon ECR, or specify your own KMS key, which you already created. If you use the KMS_DSSE encryption type, the contents of the repository will be encrypted with two layers of encryption using server-side encryption with the KMS Management Service key stored in KMS. Similar to the KMS encryption type, you can either use the default AWS managed KMS key for Amazon ECR, or specify your own KMS key, which you've already created. 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 AES256 encryption algorithm. For more information, see Amazon ECR encryption at rest in the Amazon Elastic Container Registry User Guide.
KmsKey string
If you use the KMS encryption type, specify the KMS key to use for encryption. The alias, key ID, or full ARN of the 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 KMS key for Amazon ECR will be used.
EncryptionType This property is required. RepositoryCreationTemplateEncryptionType
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 KMSlong key stored in KMS. When you use KMS to encrypt your data, you can either use the default AWS managed KMS key for Amazon ECR, or specify your own KMS key, which you already created. If you use the KMS_DSSE encryption type, the contents of the repository will be encrypted with two layers of encryption using server-side encryption with the KMS Management Service key stored in KMS. Similar to the KMS encryption type, you can either use the default AWS managed KMS key for Amazon ECR, or specify your own KMS key, which you've already created. 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 AES256 encryption algorithm. For more information, see Amazon ECR encryption at rest in the Amazon Elastic Container Registry User Guide.
KmsKey string
If you use the KMS encryption type, specify the KMS key to use for encryption. The alias, key ID, or full ARN of the 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 KMS key for Amazon ECR will be used.
encryptionType This property is required. RepositoryCreationTemplateEncryptionType
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 KMSlong key stored in KMS. When you use KMS to encrypt your data, you can either use the default AWS managed KMS key for Amazon ECR, or specify your own KMS key, which you already created. If you use the KMS_DSSE encryption type, the contents of the repository will be encrypted with two layers of encryption using server-side encryption with the KMS Management Service key stored in KMS. Similar to the KMS encryption type, you can either use the default AWS managed KMS key for Amazon ECR, or specify your own KMS key, which you've already created. 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 AES256 encryption algorithm. For more information, see Amazon ECR encryption at rest in the Amazon Elastic Container Registry User Guide.
kmsKey String
If you use the KMS encryption type, specify the KMS key to use for encryption. The alias, key ID, or full ARN of the 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 KMS key for Amazon ECR will be used.
encryptionType This property is required. RepositoryCreationTemplateEncryptionType
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 KMSlong key stored in KMS. When you use KMS to encrypt your data, you can either use the default AWS managed KMS key for Amazon ECR, or specify your own KMS key, which you already created. If you use the KMS_DSSE encryption type, the contents of the repository will be encrypted with two layers of encryption using server-side encryption with the KMS Management Service key stored in KMS. Similar to the KMS encryption type, you can either use the default AWS managed KMS key for Amazon ECR, or specify your own KMS key, which you've already created. 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 AES256 encryption algorithm. For more information, see Amazon ECR encryption at rest in the Amazon Elastic Container Registry User Guide.
kmsKey string
If you use the KMS encryption type, specify the KMS key to use for encryption. The alias, key ID, or full ARN of the 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 KMS key for Amazon ECR will be used.
encryption_type This property is required. RepositoryCreationTemplateEncryptionType
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 KMSlong key stored in KMS. When you use KMS to encrypt your data, you can either use the default AWS managed KMS key for Amazon ECR, or specify your own KMS key, which you already created. If you use the KMS_DSSE encryption type, the contents of the repository will be encrypted with two layers of encryption using server-side encryption with the KMS Management Service key stored in KMS. Similar to the KMS encryption type, you can either use the default AWS managed KMS key for Amazon ECR, or specify your own KMS key, which you've already created. 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 AES256 encryption algorithm. For more information, see Amazon ECR encryption at rest in the Amazon Elastic Container Registry User Guide.
kms_key str
If you use the KMS encryption type, specify the KMS key to use for encryption. The alias, key ID, or full ARN of the 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 KMS key for Amazon ECR will be used.
encryptionType This property is required. "AES256" | "KMS" | "KMS_DSSE"
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 KMSlong key stored in KMS. When you use KMS to encrypt your data, you can either use the default AWS managed KMS key for Amazon ECR, or specify your own KMS key, which you already created. If you use the KMS_DSSE encryption type, the contents of the repository will be encrypted with two layers of encryption using server-side encryption with the KMS Management Service key stored in KMS. Similar to the KMS encryption type, you can either use the default AWS managed KMS key for Amazon ECR, or specify your own KMS key, which you've already created. 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 AES256 encryption algorithm. For more information, see Amazon ECR encryption at rest in the Amazon Elastic Container Registry User Guide.
kmsKey String
If you use the KMS encryption type, specify the KMS key to use for encryption. The alias, key ID, or full ARN of the 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 KMS key for Amazon ECR will be used.

RepositoryCreationTemplateEncryptionType

RepositoryCreationTemplateImageTagMutability

RepositoryCreationTemplateTag

Key This property is required. string
One part of a key-value pair that make up a tag. A key is a general label that acts like a category for more specific tag values.
Value This property is required. string
A value acts as a descriptor within a tag category (key).
Key This property is required. string
One part of a key-value pair that make up a tag. A key is a general label that acts like a category for more specific tag values.
Value This property is required. string
A value acts as a descriptor within a tag category (key).
key This property is required. String
One part of a key-value pair that make up a tag. A key is a general label that acts like a category for more specific tag values.
value This property is required. String
A value acts as a descriptor within a tag category (key).
key This property is required. string
One part of a key-value pair that make up a tag. A key is a general label that acts like a category for more specific tag values.
value This property is required. string
A value acts as a descriptor within a tag category (key).
key This property is required. str
One part of a key-value pair that make up a tag. A key is a general label that acts like a category for more specific tag values.
value This property is required. str
A value acts as a descriptor within a tag category (key).
key This property is required. String
One part of a key-value pair that make up a tag. A key is a general label that acts like a category for more specific tag values.
value This property is required. String
A value acts as a descriptor within a tag category (key).

Package Details

Repository
AWS Native pulumi/pulumi-aws-native
License
Apache-2.0

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.27.0 published on Monday, Apr 14, 2025 by Pulumi
pulumi/pulumi-aws-native