1. Packages
  2. AWS
  3. API Docs
  4. ecrpublic
  5. getImages
AWS v7.11.0 published on Wednesday, Nov 5, 2025 by Pulumi

aws.ecrpublic.getImages

Start a Neo task
Explain and create an aws.ecrpublic.getImages resource
aws logo
AWS v7.11.0 published on Wednesday, Nov 5, 2025 by Pulumi

    The ECR Public Images data source allows the list of images in a specified public repository to be retrieved.

    Using getImages

    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 getImages(args: GetImagesArgs, opts?: InvokeOptions): Promise<GetImagesResult>
    function getImagesOutput(args: GetImagesOutputArgs, opts?: InvokeOptions): Output<GetImagesResult>
    def get_images(image_ids: Optional[Sequence[GetImagesImageId]] = None,
                   region: Optional[str] = None,
                   registry_id: Optional[str] = None,
                   repository_name: Optional[str] = None,
                   opts: Optional[InvokeOptions] = None) -> GetImagesResult
    def get_images_output(image_ids: Optional[pulumi.Input[Sequence[pulumi.Input[GetImagesImageIdArgs]]]] = None,
                   region: Optional[pulumi.Input[str]] = None,
                   registry_id: Optional[pulumi.Input[str]] = None,
                   repository_name: Optional[pulumi.Input[str]] = None,
                   opts: Optional[InvokeOptions] = None) -> Output[GetImagesResult]
    func GetImages(ctx *Context, args *GetImagesArgs, opts ...InvokeOption) (*GetImagesResult, error)
    func GetImagesOutput(ctx *Context, args *GetImagesOutputArgs, opts ...InvokeOption) GetImagesResultOutput

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

    public static class GetImages 
    {
        public static Task<GetImagesResult> InvokeAsync(GetImagesArgs args, InvokeOptions? opts = null)
        public static Output<GetImagesResult> Invoke(GetImagesInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetImagesResult> getImages(GetImagesArgs args, InvokeOptions options)
    public static Output<GetImagesResult> getImages(GetImagesArgs args, InvokeOptions options)
    
    fn::invoke:
      function: aws:ecrpublic/getImages:getImages
      arguments:
        # arguments dictionary

    The following arguments are supported:

    RepositoryName string
    Name of the public repository.
    ImageIds List<GetImagesImageId>
    One or more image ID filters. Each image ID can use either a tag or digest (or both). Each object has the following attributes:
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    RegistryId string
    AWS account ID associated with the public registry that contains the repository. If not specified, the default public registry is assumed.
    RepositoryName string
    Name of the public repository.
    ImageIds []GetImagesImageId
    One or more image ID filters. Each image ID can use either a tag or digest (or both). Each object has the following attributes:
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    RegistryId string
    AWS account ID associated with the public registry that contains the repository. If not specified, the default public registry is assumed.
    repositoryName String
    Name of the public repository.
    imageIds List<GetImagesImageId>
    One or more image ID filters. Each image ID can use either a tag or digest (or both). Each object has the following attributes:
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    registryId String
    AWS account ID associated with the public registry that contains the repository. If not specified, the default public registry is assumed.
    repositoryName string
    Name of the public repository.
    imageIds GetImagesImageId[]
    One or more image ID filters. Each image ID can use either a tag or digest (or both). Each object has the following attributes:
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    registryId string
    AWS account ID associated with the public registry that contains the repository. If not specified, the default public registry is assumed.
    repository_name str
    Name of the public repository.
    image_ids Sequence[GetImagesImageId]
    One or more image ID filters. Each image ID can use either a tag or digest (or both). Each object has the following attributes:
    region str
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    registry_id str
    AWS account ID associated with the public registry that contains the repository. If not specified, the default public registry is assumed.
    repositoryName String
    Name of the public repository.
    imageIds List<Property Map>
    One or more image ID filters. Each image ID can use either a tag or digest (or both). Each object has the following attributes:
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    registryId String
    AWS account ID associated with the public registry that contains the repository. If not specified, the default public registry is assumed.

    getImages Result

    The following output properties are available:

    Id string
    The provider-assigned unique ID for this managed resource.
    Images List<GetImagesImage>
    List of images returned. Each image contains:
    Region string
    RepositoryName string
    Name of the repository.
    ImageIds List<GetImagesImageId>
    RegistryId string
    AWS account ID associated with the public registry.
    Id string
    The provider-assigned unique ID for this managed resource.
    Images []GetImagesImage
    List of images returned. Each image contains:
    Region string
    RepositoryName string
    Name of the repository.
    ImageIds []GetImagesImageId
    RegistryId string
    AWS account ID associated with the public registry.
    id String
    The provider-assigned unique ID for this managed resource.
    images List<GetImagesImage>
    List of images returned. Each image contains:
    region String
    repositoryName String
    Name of the repository.
    imageIds List<GetImagesImageId>
    registryId String
    AWS account ID associated with the public registry.
    id string
    The provider-assigned unique ID for this managed resource.
    images GetImagesImage[]
    List of images returned. Each image contains:
    region string
    repositoryName string
    Name of the repository.
    imageIds GetImagesImageId[]
    registryId string
    AWS account ID associated with the public registry.
    id str
    The provider-assigned unique ID for this managed resource.
    images Sequence[GetImagesImage]
    List of images returned. Each image contains:
    region str
    repository_name str
    Name of the repository.
    image_ids Sequence[GetImagesImageId]
    registry_id str
    AWS account ID associated with the public registry.
    id String
    The provider-assigned unique ID for this managed resource.
    images List<Property Map>
    List of images returned. Each image contains:
    region String
    repositoryName String
    Name of the repository.
    imageIds List<Property Map>
    registryId String
    AWS account ID associated with the public registry.

    Supporting Types

    GetImagesImage

    ArtifactMediaType string
    Media type of the artifact.
    ImageDigest string
    Digest of the image manifest.
    ImageManifestMediaType string
    Media type of the image manifest.
    ImagePushedAt string
    ImageSizeInBytes int
    ImageTags List<string>
    RegistryId string
    AWS account ID associated with the public registry that contains the repository. If not specified, the default public registry is assumed.
    RepositoryName string
    Name of the public repository.
    ArtifactMediaType string
    Media type of the artifact.
    ImageDigest string
    Digest of the image manifest.
    ImageManifestMediaType string
    Media type of the image manifest.
    ImagePushedAt string
    ImageSizeInBytes int
    ImageTags []string
    RegistryId string
    AWS account ID associated with the public registry that contains the repository. If not specified, the default public registry is assumed.
    RepositoryName string
    Name of the public repository.
    artifactMediaType String
    Media type of the artifact.
    imageDigest String
    Digest of the image manifest.
    imageManifestMediaType String
    Media type of the image manifest.
    imagePushedAt String
    imageSizeInBytes Integer
    imageTags List<String>
    registryId String
    AWS account ID associated with the public registry that contains the repository. If not specified, the default public registry is assumed.
    repositoryName String
    Name of the public repository.
    artifactMediaType string
    Media type of the artifact.
    imageDigest string
    Digest of the image manifest.
    imageManifestMediaType string
    Media type of the image manifest.
    imagePushedAt string
    imageSizeInBytes number
    imageTags string[]
    registryId string
    AWS account ID associated with the public registry that contains the repository. If not specified, the default public registry is assumed.
    repositoryName string
    Name of the public repository.
    artifact_media_type str
    Media type of the artifact.
    image_digest str
    Digest of the image manifest.
    image_manifest_media_type str
    Media type of the image manifest.
    image_pushed_at str
    image_size_in_bytes int
    image_tags Sequence[str]
    registry_id str
    AWS account ID associated with the public registry that contains the repository. If not specified, the default public registry is assumed.
    repository_name str
    Name of the public repository.
    artifactMediaType String
    Media type of the artifact.
    imageDigest String
    Digest of the image manifest.
    imageManifestMediaType String
    Media type of the image manifest.
    imagePushedAt String
    imageSizeInBytes Number
    imageTags List<String>
    registryId String
    AWS account ID associated with the public registry that contains the repository. If not specified, the default public registry is assumed.
    repositoryName String
    Name of the public repository.

    GetImagesImageId

    ImageDigest string
    Digest of the image manifest.
    ImageTag string
    Tag used for the image.
    ImageDigest string
    Digest of the image manifest.
    ImageTag string
    Tag used for the image.
    imageDigest String
    Digest of the image manifest.
    imageTag String
    Tag used for the image.
    imageDigest string
    Digest of the image manifest.
    imageTag string
    Tag used for the image.
    image_digest str
    Digest of the image manifest.
    image_tag str
    Tag used for the image.
    imageDigest String
    Digest of the image manifest.
    imageTag String
    Tag used for the image.

    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.11.0 published on Wednesday, Nov 5, 2025 by Pulumi
      Meet Neo: Your AI Platform Teammate