1. Packages
  2. AWS
  3. API Docs
  4. ecr
  5. Repository
AWS v7.10.0 published on Friday, Oct 24, 2025 by Pulumi
pulumi/pulumi-aws

aws.ecr.Repository

Get Started
aws logo
AWS v7.10.0 published on Friday, Oct 24, 2025 by Pulumi
pulumi/pulumi-aws

    Provides an Elastic Container Registry Repository.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const foo = new aws.ecr.Repository("foo", {
    name: "bar",
    imageTagMutability: "MUTABLE",
    imageScanningConfiguration: {
        scanOnPush: true,
    },
});

    import pulumi
import pulumi_aws as aws

foo = aws.ecr.Repository("foo",
    name="bar",
    image_tag_mutability="MUTABLE",
    image_scanning_configuration={
        "scan_on_push": True,
    })

    package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/ecr"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := ecr.NewRepository(ctx, "foo", &ecr.RepositoryArgs{
			Name:               pulumi.String("bar"),
			ImageTagMutability: pulumi.String("MUTABLE"),
			ImageScanningConfiguration: &ecr.RepositoryImageScanningConfigurationArgs{
				ScanOnPush: pulumi.Bool(true),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var foo = new Aws.Ecr.Repository("foo", new()
    {
        Name = "bar",
        ImageTagMutability = "MUTABLE",
        ImageScanningConfiguration = new Aws.Ecr.Inputs.RepositoryImageScanningConfigurationArgs
        {
            ScanOnPush = true,
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ecr.Repository;
import com.pulumi.aws.ecr.RepositoryArgs;
import com.pulumi.aws.ecr.inputs.RepositoryImageScanningConfigurationArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var foo = new Repository("foo", RepositoryArgs.builder()
            .name("bar")
            .imageTagMutability("MUTABLE")
            .imageScanningConfiguration(RepositoryImageScanningConfigurationArgs.builder()
                .scanOnPush(true)
                .build())
            .build());

    }
}

    resources:
  foo:
    type: aws:ecr:Repository
    properties:
      name: bar
      imageTagMutability: MUTABLE
      imageScanningConfiguration:
        scanOnPush: true

    With Image Tag Mutability Exclusion

    import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = new aws.ecr.Repository("example", {
    name: "example-repo",
    imageTagMutability: "IMMUTABLE_WITH_EXCLUSION",
    imageTagMutabilityExclusionFilters: [
        {
            filter: "latest*",
            filterType: "WILDCARD",
        },
        {
            filter: "dev-*",
            filterType: "WILDCARD",
        },
    ],
});

    import pulumi
import pulumi_aws as aws

example = aws.ecr.Repository("example",
    name="example-repo",
    image_tag_mutability="IMMUTABLE_WITH_EXCLUSION",
    image_tag_mutability_exclusion_filters=[
        {
            "filter": "latest*",
            "filter_type": "WILDCARD",
        },
        {
            "filter": "dev-*",
            "filter_type": "WILDCARD",
        },
    ])

    package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/ecr"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := ecr.NewRepository(ctx, "example", &ecr.RepositoryArgs{
			Name:               pulumi.String("example-repo"),
			ImageTagMutability: pulumi.String("IMMUTABLE_WITH_EXCLUSION"),
			ImageTagMutabilityExclusionFilters: ecr.RepositoryImageTagMutabilityExclusionFilterArray{
				&ecr.RepositoryImageTagMutabilityExclusionFilterArgs{
					Filter:     pulumi.String("latest*"),
					FilterType: pulumi.String("WILDCARD"),
				},
				&ecr.RepositoryImageTagMutabilityExclusionFilterArgs{
					Filter:     pulumi.String("dev-*"),
					FilterType: pulumi.String("WILDCARD"),
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var example = new Aws.Ecr.Repository("example", new()
    {
        Name = "example-repo",
        ImageTagMutability = "IMMUTABLE_WITH_EXCLUSION",
        ImageTagMutabilityExclusionFilters = new[]
        {
            new Aws.Ecr.Inputs.RepositoryImageTagMutabilityExclusionFilterArgs
            {
                Filter = "latest*",
                FilterType = "WILDCARD",
            },
            new Aws.Ecr.Inputs.RepositoryImageTagMutabilityExclusionFilterArgs
            {
                Filter = "dev-*",
                FilterType = "WILDCARD",
            },
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ecr.Repository;
import com.pulumi.aws.ecr.RepositoryArgs;
import com.pulumi.aws.ecr.inputs.RepositoryImageTagMutabilityExclusionFilterArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var example = new Repository("example", RepositoryArgs.builder()
            .name("example-repo")
            .imageTagMutability("IMMUTABLE_WITH_EXCLUSION")
            .imageTagMutabilityExclusionFilters(            
                RepositoryImageTagMutabilityExclusionFilterArgs.builder()
                    .filter("latest*")
                    .filterType("WILDCARD")
                    .build(),
                RepositoryImageTagMutabilityExclusionFilterArgs.builder()
                    .filter("dev-*")
                    .filterType("WILDCARD")
                    .build())
            .build());

    }
}

    resources:
  example:
    type: aws:ecr:Repository
    properties:
      name: example-repo
      imageTagMutability: IMMUTABLE_WITH_EXCLUSION
      imageTagMutabilityExclusionFilters:
        - filter: latest*
          filterType: WILDCARD
        - filter: dev-*
          filterType: WILDCARD

    Create Repository Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Repository(name: string, args?: RepositoryArgs, opts?: CustomResourceOptions);
    @overload
def Repository(resource_name: str,
               args: Optional[RepositoryArgs] = None,
               opts: Optional[ResourceOptions] = None)

@overload
def Repository(resource_name: str,
               opts: Optional[ResourceOptions] = None,
               encryption_configurations: Optional[Sequence[RepositoryEncryptionConfigurationArgs]] = None,
               force_delete: Optional[bool] = None,
               image_scanning_configuration: Optional[RepositoryImageScanningConfigurationArgs] = None,
               image_tag_mutability: Optional[str] = None,
               image_tag_mutability_exclusion_filters: Optional[Sequence[RepositoryImageTagMutabilityExclusionFilterArgs]] = None,
               name: Optional[str] = None,
               region: Optional[str] = None,
               tags: Optional[Mapping[str, str]] = None)
    func NewRepository(ctx *Context, name string, args *RepositoryArgs, opts ...ResourceOption) (*Repository, error)
    public Repository(string name, RepositoryArgs? args = null, CustomResourceOptions? opts = null)
    public Repository(String name, RepositoryArgs args)
public Repository(String name, RepositoryArgs args, CustomResourceOptions options)

    type: aws:ecr:Repository
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 RepositoryArgs
    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 RepositoryArgs
    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 RepositoryArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args RepositoryArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args RepositoryArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var examplerepositoryResourceResourceFromEcrrepository = new Aws.Ecr.Repository("examplerepositoryResourceResourceFromEcrrepository", new()
{
    EncryptionConfigurations = new[]
    {
        new Aws.Ecr.Inputs.RepositoryEncryptionConfigurationArgs
        {
            EncryptionType = "string",
            KmsKey = "string",
        },
    },
    ForceDelete = false,
    ImageScanningConfiguration = new Aws.Ecr.Inputs.RepositoryImageScanningConfigurationArgs
    {
        ScanOnPush = false,
    },
    ImageTagMutability = "string",
    ImageTagMutabilityExclusionFilters = new[]
    {
        new Aws.Ecr.Inputs.RepositoryImageTagMutabilityExclusionFilterArgs
        {
            Filter = "string",
            FilterType = "string",
        },
    },
    Name = "string",
    Region = "string",
    Tags = 
    {
        { "string", "string" },
    },
});

    example, err := ecr.NewRepository(ctx, "examplerepositoryResourceResourceFromEcrrepository", &ecr.RepositoryArgs{
	EncryptionConfigurations: ecr.RepositoryEncryptionConfigurationArray{
		&ecr.RepositoryEncryptionConfigurationArgs{
			EncryptionType: pulumi.String("string"),
			KmsKey:         pulumi.String("string"),
		},
	},
	ForceDelete: pulumi.Bool(false),
	ImageScanningConfiguration: &ecr.RepositoryImageScanningConfigurationArgs{
		ScanOnPush: pulumi.Bool(false),
	},
	ImageTagMutability: pulumi.String("string"),
	ImageTagMutabilityExclusionFilters: ecr.RepositoryImageTagMutabilityExclusionFilterArray{
		&ecr.RepositoryImageTagMutabilityExclusionFilterArgs{
			Filter:     pulumi.String("string"),
			FilterType: pulumi.String("string"),
		},
	},
	Name:   pulumi.String("string"),
	Region: pulumi.String("string"),
	Tags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
})

    var examplerepositoryResourceResourceFromEcrrepository = new com.pulumi.aws.ecr.Repository("examplerepositoryResourceResourceFromEcrrepository", com.pulumi.aws.ecr.RepositoryArgs.builder()
    .encryptionConfigurations(RepositoryEncryptionConfigurationArgs.builder()
        .encryptionType("string")
        .kmsKey("string")
        .build())
    .forceDelete(false)
    .imageScanningConfiguration(RepositoryImageScanningConfigurationArgs.builder()
        .scanOnPush(false)
        .build())
    .imageTagMutability("string")
    .imageTagMutabilityExclusionFilters(RepositoryImageTagMutabilityExclusionFilterArgs.builder()
        .filter("string")
        .filterType("string")
        .build())
    .name("string")
    .region("string")
    .tags(Map.of("string", "string"))
    .build());

    examplerepository_resource_resource_from_ecrrepository = aws.ecr.Repository("examplerepositoryResourceResourceFromEcrrepository",
    encryption_configurations=[{
        "encryption_type": "string",
        "kms_key": "string",
    }],
    force_delete=False,
    image_scanning_configuration={
        "scan_on_push": False,
    },
    image_tag_mutability="string",
    image_tag_mutability_exclusion_filters=[{
        "filter": "string",
        "filter_type": "string",
    }],
    name="string",
    region="string",
    tags={
        "string": "string",
    })

    const examplerepositoryResourceResourceFromEcrrepository = new aws.ecr.Repository("examplerepositoryResourceResourceFromEcrrepository", {
    encryptionConfigurations: [{
        encryptionType: "string",
        kmsKey: "string",
    }],
    forceDelete: false,
    imageScanningConfiguration: {
        scanOnPush: false,
    },
    imageTagMutability: "string",
    imageTagMutabilityExclusionFilters: [{
        filter: "string",
        filterType: "string",
    }],
    name: "string",
    region: "string",
    tags: {
        string: "string",
    },
});

    type: aws:ecr:Repository
properties:
    encryptionConfigurations:
        - encryptionType: string
          kmsKey: string
    forceDelete: false
    imageScanningConfiguration:
        scanOnPush: false
    imageTagMutability: string
    imageTagMutabilityExclusionFilters:
        - filter: string
          filterType: string
    name: string
    region: string
    tags:
        string: string

    Repository Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The Repository resource accepts the following input properties:

    EncryptionConfigurations List<RepositoryEncryptionConfiguration>
    Encryption configuration for the repository. See below for schema.
    ForceDelete bool
    If true, will delete the repository even if it contains images. Defaults to false.
    ImageScanningConfiguration RepositoryImageScanningConfiguration
    Configuration block that defines image scanning configuration for the repository. By default, image scanning must be manually triggered. See the ECR User Guide for more information about image scanning.
    ImageTagMutability string
    The tag mutability setting for the repository. Must be one of: MUTABLE, IMMUTABLE, IMMUTABLE_WITH_EXCLUSION, or MUTABLE_WITH_EXCLUSION. Defaults to MUTABLE.
    ImageTagMutabilityExclusionFilters List<RepositoryImageTagMutabilityExclusionFilter>
    Configuration block that defines filters to specify which image tags can override the default tag mutability setting. Only applicable when image_tag_mutability is set to IMMUTABLE_WITH_EXCLUSION or MUTABLE_WITH_EXCLUSION. See below for schema.
    Name string
    Name of the repository.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    Tags Dictionary<string, string>
    A map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    EncryptionConfigurations []RepositoryEncryptionConfigurationArgs
    Encryption configuration for the repository. See below for schema.
    ForceDelete bool
    If true, will delete the repository even if it contains images. Defaults to false.
    ImageScanningConfiguration RepositoryImageScanningConfigurationArgs
    Configuration block that defines image scanning configuration for the repository. By default, image scanning must be manually triggered. See the ECR User Guide for more information about image scanning.
    ImageTagMutability string
    The tag mutability setting for the repository. Must be one of: MUTABLE, IMMUTABLE, IMMUTABLE_WITH_EXCLUSION, or MUTABLE_WITH_EXCLUSION. Defaults to MUTABLE.
    ImageTagMutabilityExclusionFilters []RepositoryImageTagMutabilityExclusionFilterArgs
    Configuration block that defines filters to specify which image tags can override the default tag mutability setting. Only applicable when image_tag_mutability is set to IMMUTABLE_WITH_EXCLUSION or MUTABLE_WITH_EXCLUSION. See below for schema.
    Name string
    Name of the repository.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    Tags map[string]string
    A map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    encryptionConfigurations List<RepositoryEncryptionConfiguration>
    Encryption configuration for the repository. See below for schema.
    forceDelete Boolean
    If true, will delete the repository even if it contains images. Defaults to false.
    imageScanningConfiguration RepositoryImageScanningConfiguration
    Configuration block that defines image scanning configuration for the repository. By default, image scanning must be manually triggered. See the ECR User Guide for more information about image scanning.
    imageTagMutability String
    The tag mutability setting for the repository. Must be one of: MUTABLE, IMMUTABLE, IMMUTABLE_WITH_EXCLUSION, or MUTABLE_WITH_EXCLUSION. Defaults to MUTABLE.
    imageTagMutabilityExclusionFilters List<RepositoryImageTagMutabilityExclusionFilter>
    Configuration block that defines filters to specify which image tags can override the default tag mutability setting. Only applicable when image_tag_mutability is set to IMMUTABLE_WITH_EXCLUSION or MUTABLE_WITH_EXCLUSION. See below for schema.
    name String
    Name of the repository.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    tags Map<String,String>
    A map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    encryptionConfigurations RepositoryEncryptionConfiguration[]
    Encryption configuration for the repository. See below for schema.
    forceDelete boolean
    If true, will delete the repository even if it contains images. Defaults to false.
    imageScanningConfiguration RepositoryImageScanningConfiguration
    Configuration block that defines image scanning configuration for the repository. By default, image scanning must be manually triggered. See the ECR User Guide for more information about image scanning.
    imageTagMutability string
    The tag mutability setting for the repository. Must be one of: MUTABLE, IMMUTABLE, IMMUTABLE_WITH_EXCLUSION, or MUTABLE_WITH_EXCLUSION. Defaults to MUTABLE.
    imageTagMutabilityExclusionFilters RepositoryImageTagMutabilityExclusionFilter[]
    Configuration block that defines filters to specify which image tags can override the default tag mutability setting. Only applicable when image_tag_mutability is set to IMMUTABLE_WITH_EXCLUSION or MUTABLE_WITH_EXCLUSION. See below for schema.
    name string
    Name of the repository.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    tags {[key: string]: string}
    A map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    encryption_configurations Sequence[RepositoryEncryptionConfigurationArgs]
    Encryption configuration for the repository. See below for schema.
    force_delete bool
    If true, will delete the repository even if it contains images. Defaults to false.
    image_scanning_configuration RepositoryImageScanningConfigurationArgs
    Configuration block that defines image scanning configuration for the repository. By default, image scanning must be manually triggered. See the ECR User Guide for more information about image scanning.
    image_tag_mutability str
    The tag mutability setting for the repository. Must be one of: MUTABLE, IMMUTABLE, IMMUTABLE_WITH_EXCLUSION, or MUTABLE_WITH_EXCLUSION. Defaults to MUTABLE.
    image_tag_mutability_exclusion_filters Sequence[RepositoryImageTagMutabilityExclusionFilterArgs]
    Configuration block that defines filters to specify which image tags can override the default tag mutability setting. Only applicable when image_tag_mutability is set to IMMUTABLE_WITH_EXCLUSION or MUTABLE_WITH_EXCLUSION. See below for schema.
    name str
    Name of the repository.
    region str
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    tags Mapping[str, str]
    A map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    encryptionConfigurations List<Property Map>
    Encryption configuration for the repository. See below for schema.
    forceDelete Boolean
    If true, will delete the repository even if it contains images. Defaults to false.
    imageScanningConfiguration Property Map
    Configuration block that defines image scanning configuration for the repository. By default, image scanning must be manually triggered. See the ECR User Guide for more information about image scanning.
    imageTagMutability String
    The tag mutability setting for the repository. Must be one of: MUTABLE, IMMUTABLE, IMMUTABLE_WITH_EXCLUSION, or MUTABLE_WITH_EXCLUSION. Defaults to MUTABLE.
    imageTagMutabilityExclusionFilters List<Property Map>
    Configuration block that defines filters to specify which image tags can override the default tag mutability setting. Only applicable when image_tag_mutability is set to IMMUTABLE_WITH_EXCLUSION or MUTABLE_WITH_EXCLUSION. See below for schema.
    name String
    Name of the repository.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    tags Map<String>
    A map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Repository resource produces the following output properties:

    Arn string
    Full ARN of the repository.
    Id string
    The provider-assigned unique ID for this managed resource.
    RegistryId string
    The registry ID where the repository was created.
    RepositoryUrl string
    The URL of the repository (in the form aws_account_id.dkr.ecr.region.amazonaws.com/repositoryName).
    TagsAll Dictionary<string, string>
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.
    Arn string
    Full ARN of the repository.
    Id string
    The provider-assigned unique ID for this managed resource.
    RegistryId string
    The registry ID where the repository was created.
    RepositoryUrl string
    The URL of the repository (in the form aws_account_id.dkr.ecr.region.amazonaws.com/repositoryName).
    TagsAll map[string]string
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.
    arn String
    Full ARN of the repository.
    id String
    The provider-assigned unique ID for this managed resource.
    registryId String
    The registry ID where the repository was created.
    repositoryUrl String
    The URL of the repository (in the form aws_account_id.dkr.ecr.region.amazonaws.com/repositoryName).
    tagsAll Map<String,String>
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.
    arn string
    Full ARN of the repository.
    id string
    The provider-assigned unique ID for this managed resource.
    registryId string
    The registry ID where the repository was created.
    repositoryUrl string
    The URL of the repository (in the form aws_account_id.dkr.ecr.region.amazonaws.com/repositoryName).
    tagsAll {[key: string]: string}
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.
    arn str
    Full ARN of the repository.
    id str
    The provider-assigned unique ID for this managed resource.
    registry_id str
    The registry ID where the repository was created.
    repository_url str
    The URL of the repository (in the form aws_account_id.dkr.ecr.region.amazonaws.com/repositoryName).
    tags_all Mapping[str, str]
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.
    arn String
    Full ARN of the repository.
    id String
    The provider-assigned unique ID for this managed resource.
    registryId String
    The registry ID where the repository was created.
    repositoryUrl String
    The URL of the repository (in the form aws_account_id.dkr.ecr.region.amazonaws.com/repositoryName).
    tagsAll Map<String>
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Look up Existing Repository Resource

    Get an existing Repository resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: RepositoryState, opts?: CustomResourceOptions): Repository
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        arn: Optional[str] = None,
        encryption_configurations: Optional[Sequence[RepositoryEncryptionConfigurationArgs]] = None,
        force_delete: Optional[bool] = None,
        image_scanning_configuration: Optional[RepositoryImageScanningConfigurationArgs] = None,
        image_tag_mutability: Optional[str] = None,
        image_tag_mutability_exclusion_filters: Optional[Sequence[RepositoryImageTagMutabilityExclusionFilterArgs]] = None,
        name: Optional[str] = None,
        region: Optional[str] = None,
        registry_id: Optional[str] = None,
        repository_url: Optional[str] = None,
        tags: Optional[Mapping[str, str]] = None,
        tags_all: Optional[Mapping[str, str]] = None) -> Repository
    func GetRepository(ctx *Context, name string, id IDInput, state *RepositoryState, opts ...ResourceOption) (*Repository, error)
    public static Repository Get(string name, Input<string> id, RepositoryState? state, CustomResourceOptions? opts = null)
    public static Repository get(String name, Output<String> id, RepositoryState state, CustomResourceOptions options)
    resources:  _:    type: aws:ecr:Repository    get:      id: ${id}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    Arn string
    Full ARN of the repository.
    EncryptionConfigurations List<RepositoryEncryptionConfiguration>
    Encryption configuration for the repository. See below for schema.
    ForceDelete bool
    If true, will delete the repository even if it contains images. Defaults to false.
    ImageScanningConfiguration RepositoryImageScanningConfiguration
    Configuration block that defines image scanning configuration for the repository. By default, image scanning must be manually triggered. See the ECR User Guide for more information about image scanning.
    ImageTagMutability string
    The tag mutability setting for the repository. Must be one of: MUTABLE, IMMUTABLE, IMMUTABLE_WITH_EXCLUSION, or MUTABLE_WITH_EXCLUSION. Defaults to MUTABLE.
    ImageTagMutabilityExclusionFilters List<RepositoryImageTagMutabilityExclusionFilter>
    Configuration block that defines filters to specify which image tags can override the default tag mutability setting. Only applicable when image_tag_mutability is set to IMMUTABLE_WITH_EXCLUSION or MUTABLE_WITH_EXCLUSION. See below for schema.
    Name string
    Name of the repository.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    RegistryId string
    The registry ID where the repository was created.
    RepositoryUrl string
    The URL of the repository (in the form aws_account_id.dkr.ecr.region.amazonaws.com/repositoryName).
    Tags Dictionary<string, string>
    A map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    TagsAll Dictionary<string, string>
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.
    Arn string
    Full ARN of the repository.
    EncryptionConfigurations []RepositoryEncryptionConfigurationArgs
    Encryption configuration for the repository. See below for schema.
    ForceDelete bool
    If true, will delete the repository even if it contains images. Defaults to false.
    ImageScanningConfiguration RepositoryImageScanningConfigurationArgs
    Configuration block that defines image scanning configuration for the repository. By default, image scanning must be manually triggered. See the ECR User Guide for more information about image scanning.
    ImageTagMutability string
    The tag mutability setting for the repository. Must be one of: MUTABLE, IMMUTABLE, IMMUTABLE_WITH_EXCLUSION, or MUTABLE_WITH_EXCLUSION. Defaults to MUTABLE.
    ImageTagMutabilityExclusionFilters []RepositoryImageTagMutabilityExclusionFilterArgs
    Configuration block that defines filters to specify which image tags can override the default tag mutability setting. Only applicable when image_tag_mutability is set to IMMUTABLE_WITH_EXCLUSION or MUTABLE_WITH_EXCLUSION. See below for schema.
    Name string
    Name of the repository.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    RegistryId string
    The registry ID where the repository was created.
    RepositoryUrl string
    The URL of the repository (in the form aws_account_id.dkr.ecr.region.amazonaws.com/repositoryName).
    Tags map[string]string
    A map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    TagsAll map[string]string
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.
    arn String
    Full ARN of the repository.
    encryptionConfigurations List<RepositoryEncryptionConfiguration>
    Encryption configuration for the repository. See below for schema.
    forceDelete Boolean
    If true, will delete the repository even if it contains images. Defaults to false.
    imageScanningConfiguration RepositoryImageScanningConfiguration
    Configuration block that defines image scanning configuration for the repository. By default, image scanning must be manually triggered. See the ECR User Guide for more information about image scanning.
    imageTagMutability String
    The tag mutability setting for the repository. Must be one of: MUTABLE, IMMUTABLE, IMMUTABLE_WITH_EXCLUSION, or MUTABLE_WITH_EXCLUSION. Defaults to MUTABLE.
    imageTagMutabilityExclusionFilters List<RepositoryImageTagMutabilityExclusionFilter>
    Configuration block that defines filters to specify which image tags can override the default tag mutability setting. Only applicable when image_tag_mutability is set to IMMUTABLE_WITH_EXCLUSION or MUTABLE_WITH_EXCLUSION. See below for schema.
    name String
    Name of the repository.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    registryId String
    The registry ID where the repository was created.
    repositoryUrl String
    The URL of the repository (in the form aws_account_id.dkr.ecr.region.amazonaws.com/repositoryName).
    tags Map<String,String>
    A map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tagsAll Map<String,String>
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.
    arn string
    Full ARN of the repository.
    encryptionConfigurations RepositoryEncryptionConfiguration[]
    Encryption configuration for the repository. See below for schema.
    forceDelete boolean
    If true, will delete the repository even if it contains images. Defaults to false.
    imageScanningConfiguration RepositoryImageScanningConfiguration
    Configuration block that defines image scanning configuration for the repository. By default, image scanning must be manually triggered. See the ECR User Guide for more information about image scanning.
    imageTagMutability string
    The tag mutability setting for the repository. Must be one of: MUTABLE, IMMUTABLE, IMMUTABLE_WITH_EXCLUSION, or MUTABLE_WITH_EXCLUSION. Defaults to MUTABLE.
    imageTagMutabilityExclusionFilters RepositoryImageTagMutabilityExclusionFilter[]
    Configuration block that defines filters to specify which image tags can override the default tag mutability setting. Only applicable when image_tag_mutability is set to IMMUTABLE_WITH_EXCLUSION or MUTABLE_WITH_EXCLUSION. See below for schema.
    name string
    Name of the repository.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    registryId string
    The registry ID where the repository was created.
    repositoryUrl string
    The URL of the repository (in the form aws_account_id.dkr.ecr.region.amazonaws.com/repositoryName).
    tags {[key: string]: string}
    A map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tagsAll {[key: string]: string}
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.
    arn str
    Full ARN of the repository.
    encryption_configurations Sequence[RepositoryEncryptionConfigurationArgs]
    Encryption configuration for the repository. See below for schema.
    force_delete bool
    If true, will delete the repository even if it contains images. Defaults to false.
    image_scanning_configuration RepositoryImageScanningConfigurationArgs
    Configuration block that defines image scanning configuration for the repository. By default, image scanning must be manually triggered. See the ECR User Guide for more information about image scanning.
    image_tag_mutability str
    The tag mutability setting for the repository. Must be one of: MUTABLE, IMMUTABLE, IMMUTABLE_WITH_EXCLUSION, or MUTABLE_WITH_EXCLUSION. Defaults to MUTABLE.
    image_tag_mutability_exclusion_filters Sequence[RepositoryImageTagMutabilityExclusionFilterArgs]
    Configuration block that defines filters to specify which image tags can override the default tag mutability setting. Only applicable when image_tag_mutability is set to IMMUTABLE_WITH_EXCLUSION or MUTABLE_WITH_EXCLUSION. See below for schema.
    name str
    Name of the repository.
    region str
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    registry_id str
    The registry ID where the repository was created.
    repository_url str
    The URL of the repository (in the form aws_account_id.dkr.ecr.region.amazonaws.com/repositoryName).
    tags Mapping[str, str]
    A map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tags_all Mapping[str, str]
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.
    arn String
    Full ARN of the repository.
    encryptionConfigurations List<Property Map>
    Encryption configuration for the repository. See below for schema.
    forceDelete Boolean
    If true, will delete the repository even if it contains images. Defaults to false.
    imageScanningConfiguration Property Map
    Configuration block that defines image scanning configuration for the repository. By default, image scanning must be manually triggered. See the ECR User Guide for more information about image scanning.
    imageTagMutability String
    The tag mutability setting for the repository. Must be one of: MUTABLE, IMMUTABLE, IMMUTABLE_WITH_EXCLUSION, or MUTABLE_WITH_EXCLUSION. Defaults to MUTABLE.
    imageTagMutabilityExclusionFilters List<Property Map>
    Configuration block that defines filters to specify which image tags can override the default tag mutability setting. Only applicable when image_tag_mutability is set to IMMUTABLE_WITH_EXCLUSION or MUTABLE_WITH_EXCLUSION. See below for schema.
    name String
    Name of the repository.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    registryId String
    The registry ID where the repository was created.
    repositoryUrl String
    The URL of the repository (in the form aws_account_id.dkr.ecr.region.amazonaws.com/repositoryName).
    tags Map<String>
    A map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tagsAll Map<String>
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Supporting Types

    RepositoryEncryptionConfiguration, RepositoryEncryptionConfigurationArgs

    EncryptionType string
    The encryption type to use for the repository. Valid values are AES256 or KMS. Defaults to AES256.
    KmsKey string
    The ARN of the KMS key to use when encryption_type is KMS. If not specified, uses the default AWS managed key for ECR.
    EncryptionType string
    The encryption type to use for the repository. Valid values are AES256 or KMS. Defaults to AES256.
    KmsKey string
    The ARN of the KMS key to use when encryption_type is KMS. If not specified, uses the default AWS managed key for ECR.
    encryptionType String
    The encryption type to use for the repository. Valid values are AES256 or KMS. Defaults to AES256.
    kmsKey String
    The ARN of the KMS key to use when encryption_type is KMS. If not specified, uses the default AWS managed key for ECR.
    encryptionType string
    The encryption type to use for the repository. Valid values are AES256 or KMS. Defaults to AES256.
    kmsKey string
    The ARN of the KMS key to use when encryption_type is KMS. If not specified, uses the default AWS managed key for ECR.
    encryption_type str
    The encryption type to use for the repository. Valid values are AES256 or KMS. Defaults to AES256.
    kms_key str
    The ARN of the KMS key to use when encryption_type is KMS. If not specified, uses the default AWS managed key for ECR.
    encryptionType String
    The encryption type to use for the repository. Valid values are AES256 or KMS. Defaults to AES256.
    kmsKey String
    The ARN of the KMS key to use when encryption_type is KMS. If not specified, uses the default AWS managed key for ECR.

    RepositoryImageScanningConfiguration, RepositoryImageScanningConfigurationArgs

    ScanOnPush bool
    Indicates whether images are scanned after being pushed to the repository (true) or not scanned (false).
    ScanOnPush bool
    Indicates whether images are scanned after being pushed to the repository (true) or not scanned (false).
    scanOnPush Boolean
    Indicates whether images are scanned after being pushed to the repository (true) or not scanned (false).
    scanOnPush boolean
    Indicates whether images are scanned after being pushed to the repository (true) or not scanned (false).
    scan_on_push bool
    Indicates whether images are scanned after being pushed to the repository (true) or not scanned (false).
    scanOnPush Boolean
    Indicates whether images are scanned after being pushed to the repository (true) or not scanned (false).

    RepositoryImageTagMutabilityExclusionFilter, RepositoryImageTagMutabilityExclusionFilterArgs

    Filter string
    The filter pattern to use for excluding image tags from the mutability setting. Must contain only letters, numbers, and special characters (._-). Each filter can be up to 128 characters long and can contain a maximum of 2 wildcards ().
    FilterType string
    The type of filter to use. Must be WILDCARD.
    Filter string
    The filter pattern to use for excluding image tags from the mutability setting. Must contain only letters, numbers, and special characters (._-). Each filter can be up to 128 characters long and can contain a maximum of 2 wildcards ().
    FilterType string
    The type of filter to use. Must be WILDCARD.
    filter String
    The filter pattern to use for excluding image tags from the mutability setting. Must contain only letters, numbers, and special characters (._-). Each filter can be up to 128 characters long and can contain a maximum of 2 wildcards ().
    filterType String
    The type of filter to use. Must be WILDCARD.
    filter string
    The filter pattern to use for excluding image tags from the mutability setting. Must contain only letters, numbers, and special characters (._-). Each filter can be up to 128 characters long and can contain a maximum of 2 wildcards ().
    filterType string
    The type of filter to use. Must be WILDCARD.
    filter str
    The filter pattern to use for excluding image tags from the mutability setting. Must contain only letters, numbers, and special characters (._-). Each filter can be up to 128 characters long and can contain a maximum of 2 wildcards ().
    filter_type str
    The type of filter to use. Must be WILDCARD.
    filter String
    The filter pattern to use for excluding image tags from the mutability setting. Must contain only letters, numbers, and special characters (._-). Each filter can be up to 128 characters long and can contain a maximum of 2 wildcards ().
    filterType String
    The type of filter to use. Must be WILDCARD.

    Import

    Identity Schema

    Required

    • name - (String) Name of the ECR repository.

    Optional

    • account_id (String) AWS Account where this resource is managed.

    • region (String) Region where this resource is managed.

    Using pulumi import, import ECR Repositories using the name. For example:

    console

    % pulumi import aws_ecr_repository.service test-service

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    AWS Classic pulumi/pulumi-aws
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the aws Terraform Provider.
    aws logo
    AWS v7.10.0 published on Friday, Oct 24, 2025 by Pulumi
    pulumi/pulumi-aws
      Meet Neo: Your AI Platform Teammate