getImages

AWS v7.24.0, Mar 31 26

Viewing docs for AWS v7.24.0
published on Tuesday, Mar 31, 2026 by Pulumi

Schema (JSON)

pulumi/pulumi-aws

Viewing docs for AWS v7.24.0
published on Tuesday, Mar 31, 2026 by Pulumi

Schema (JSON)

pulumi/pulumi-aws

Example Usage

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

const example = aws.ecrpublic.getImages({
    repositoryName: "my-public-repository",
});
export const imageDigests = example.then(example => .filter(img => img.digest != null).map(img => (img.digest)));
export const imageTags = example.then(example => std.flatten({
    input: .map(img => (img.tags)),
})).then(invoke => std.distinct({
    input: invoke.result,
})).then(invoke => invoke.result);

import pulumi
import pulumi_aws as aws
import pulumi_std as std

example = aws.ecrpublic.get_images(repository_name="my-public-repository")
pulumi.export("imageDigests", [img.digest for img in example.images if img.digest != None])
pulumi.export("imageTags", std.distinct(input=std.flatten(input=[img.tags for img in example.images]).result).result)

Example coming soon!

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

return await Deployment.RunAsync(() => 
{
    var example = Aws.EcrPublic.GetImages.Invoke(new()
    {
        RepositoryName = "my-public-repository",
    });

    return new Dictionary<string, object?>
    {
        ["imageDigests"] = .Where(img => img.Digest != null).Select(img => 
        {
            return img.Digest;
        }).ToList(),
        ["imageTags"] = Std.Flatten.Invoke(new()
        {
            Input = .Select(img => 
            {
                return img.Tags;
            }).ToList(),
        }).Apply(invoke => Std.Distinct.Invoke(new()
        {
            Input = invoke.Result,
        })).Apply(invoke => invoke.Result),
    };
});

Example coming soon!

Example coming soon!

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.

Viewing docs for AWS v7.24.0
published on Tuesday, Mar 31, 2026 by Pulumi

Schema (JSON)

pulumi/pulumi-aws

aws.ecrpublic.getImages

On this page

On this page

Example Usage

Using getImages

getImages Result

Supporting Types

GetImagesImage

GetImagesImageId

Package Details

On this page

On this page