1. Packages
  2. AWS Classic
  3. API Docs
  4. ecr
  5. getImage

Try AWS Native preview for resources not in the classic version.

AWS Classic v6.42.0 published on Wednesday, Jun 26, 2024 by Pulumi

aws.ecr.getImage

Explore with Pulumi AI

aws logo

Try AWS Native preview for resources not in the classic version.

AWS Classic v6.42.0 published on Wednesday, Jun 26, 2024 by Pulumi

    The ECR Image data source allows the details of an image with a particular tag or digest to be retrieved.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as aws from "@pulumi/aws";
    
    const serviceImage = aws.ecr.getImage({
        repositoryName: "my/service",
        imageTag: "latest",
    });
    
    import pulumi
    import pulumi_aws as aws
    
    service_image = aws.ecr.get_image(repository_name="my/service",
        image_tag="latest")
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/ecr"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := ecr.GetImage(ctx, &ecr.GetImageArgs{
    			RepositoryName: "my/service",
    			ImageTag:       pulumi.StringRef("latest"),
    		}, nil)
    		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 serviceImage = Aws.Ecr.GetImage.Invoke(new()
        {
            RepositoryName = "my/service",
            ImageTag = "latest",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.aws.ecr.EcrFunctions;
    import com.pulumi.aws.ecr.inputs.GetImageArgs;
    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) {
            final var serviceImage = EcrFunctions.getImage(GetImageArgs.builder()
                .repositoryName("my/service")
                .imageTag("latest")
                .build());
    
        }
    }
    
    variables:
      serviceImage:
        fn::invoke:
          Function: aws:ecr:getImage
          Arguments:
            repositoryName: my/service
            imageTag: latest
    

    Using getImage

    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 getImage(args: GetImageArgs, opts?: InvokeOptions): Promise<GetImageResult>
    function getImageOutput(args: GetImageOutputArgs, opts?: InvokeOptions): Output<GetImageResult>
    def get_image(image_digest: Optional[str] = None,
                  image_tag: Optional[str] = None,
                  most_recent: Optional[bool] = None,
                  registry_id: Optional[str] = None,
                  repository_name: Optional[str] = None,
                  opts: Optional[InvokeOptions] = None) -> GetImageResult
    def get_image_output(image_digest: Optional[pulumi.Input[str]] = None,
                  image_tag: Optional[pulumi.Input[str]] = None,
                  most_recent: Optional[pulumi.Input[bool]] = None,
                  registry_id: Optional[pulumi.Input[str]] = None,
                  repository_name: Optional[pulumi.Input[str]] = None,
                  opts: Optional[InvokeOptions] = None) -> Output[GetImageResult]
    func GetImage(ctx *Context, args *GetImageArgs, opts ...InvokeOption) (*GetImageResult, error)
    func GetImageOutput(ctx *Context, args *GetImageOutputArgs, opts ...InvokeOption) GetImageResultOutput

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

    public static class GetImage 
    {
        public static Task<GetImageResult> InvokeAsync(GetImageArgs args, InvokeOptions? opts = null)
        public static Output<GetImageResult> Invoke(GetImageInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetImageResult> getImage(GetImageArgs args, InvokeOptions options)
    // Output-based functions aren't available in Java yet
    
    fn::invoke:
      function: aws:ecr/getImage:getImage
      arguments:
        # arguments dictionary

    The following arguments are supported:

    RepositoryName string
    Name of the ECR Repository.
    ImageDigest string
    Sha256 digest of the image manifest. At least one of image_digest, image_tag, or most_recent must be specified.
    ImageTag string
    Tag associated with this image. At least one of image_digest, image_tag, or most_recent must be specified.
    MostRecent bool
    Return the most recently pushed image. At least one of image_digest, image_tag, or most_recent must be specified.
    RegistryId string
    ID of the Registry where the repository resides.
    RepositoryName string
    Name of the ECR Repository.
    ImageDigest string
    Sha256 digest of the image manifest. At least one of image_digest, image_tag, or most_recent must be specified.
    ImageTag string
    Tag associated with this image. At least one of image_digest, image_tag, or most_recent must be specified.
    MostRecent bool
    Return the most recently pushed image. At least one of image_digest, image_tag, or most_recent must be specified.
    RegistryId string
    ID of the Registry where the repository resides.
    repositoryName String
    Name of the ECR Repository.
    imageDigest String
    Sha256 digest of the image manifest. At least one of image_digest, image_tag, or most_recent must be specified.
    imageTag String
    Tag associated with this image. At least one of image_digest, image_tag, or most_recent must be specified.
    mostRecent Boolean
    Return the most recently pushed image. At least one of image_digest, image_tag, or most_recent must be specified.
    registryId String
    ID of the Registry where the repository resides.
    repositoryName string
    Name of the ECR Repository.
    imageDigest string
    Sha256 digest of the image manifest. At least one of image_digest, image_tag, or most_recent must be specified.
    imageTag string
    Tag associated with this image. At least one of image_digest, image_tag, or most_recent must be specified.
    mostRecent boolean
    Return the most recently pushed image. At least one of image_digest, image_tag, or most_recent must be specified.
    registryId string
    ID of the Registry where the repository resides.
    repository_name str
    Name of the ECR Repository.
    image_digest str
    Sha256 digest of the image manifest. At least one of image_digest, image_tag, or most_recent must be specified.
    image_tag str
    Tag associated with this image. At least one of image_digest, image_tag, or most_recent must be specified.
    most_recent bool
    Return the most recently pushed image. At least one of image_digest, image_tag, or most_recent must be specified.
    registry_id str
    ID of the Registry where the repository resides.
    repositoryName String
    Name of the ECR Repository.
    imageDigest String
    Sha256 digest of the image manifest. At least one of image_digest, image_tag, or most_recent must be specified.
    imageTag String
    Tag associated with this image. At least one of image_digest, image_tag, or most_recent must be specified.
    mostRecent Boolean
    Return the most recently pushed image. At least one of image_digest, image_tag, or most_recent must be specified.
    registryId String
    ID of the Registry where the repository resides.

    getImage Result

    The following output properties are available:

    Id string
    The provider-assigned unique ID for this managed resource.
    ImageDigest string
    ImagePushedAt int
    Date and time, expressed as a unix timestamp, at which the current image was pushed to the repository.
    ImageSizeInBytes int
    Size, in bytes, of the image in the repository.
    ImageTags List<string>
    List of tags associated with this image.
    ImageUri string
    The URI for the specific image version specified by image_tag or image_digest.
    RegistryId string
    RepositoryName string
    ImageTag string
    MostRecent bool
    Id string
    The provider-assigned unique ID for this managed resource.
    ImageDigest string
    ImagePushedAt int
    Date and time, expressed as a unix timestamp, at which the current image was pushed to the repository.
    ImageSizeInBytes int
    Size, in bytes, of the image in the repository.
    ImageTags []string
    List of tags associated with this image.
    ImageUri string
    The URI for the specific image version specified by image_tag or image_digest.
    RegistryId string
    RepositoryName string
    ImageTag string
    MostRecent bool
    id String
    The provider-assigned unique ID for this managed resource.
    imageDigest String
    imagePushedAt Integer
    Date and time, expressed as a unix timestamp, at which the current image was pushed to the repository.
    imageSizeInBytes Integer
    Size, in bytes, of the image in the repository.
    imageTags List<String>
    List of tags associated with this image.
    imageUri String
    The URI for the specific image version specified by image_tag or image_digest.
    registryId String
    repositoryName String
    imageTag String
    mostRecent Boolean
    id string
    The provider-assigned unique ID for this managed resource.
    imageDigest string
    imagePushedAt number
    Date and time, expressed as a unix timestamp, at which the current image was pushed to the repository.
    imageSizeInBytes number
    Size, in bytes, of the image in the repository.
    imageTags string[]
    List of tags associated with this image.
    imageUri string
    The URI for the specific image version specified by image_tag or image_digest.
    registryId string
    repositoryName string
    imageTag string
    mostRecent boolean
    id str
    The provider-assigned unique ID for this managed resource.
    image_digest str
    image_pushed_at int
    Date and time, expressed as a unix timestamp, at which the current image was pushed to the repository.
    image_size_in_bytes int
    Size, in bytes, of the image in the repository.
    image_tags Sequence[str]
    List of tags associated with this image.
    image_uri str
    The URI for the specific image version specified by image_tag or image_digest.
    registry_id str
    repository_name str
    image_tag str
    most_recent bool
    id String
    The provider-assigned unique ID for this managed resource.
    imageDigest String
    imagePushedAt Number
    Date and time, expressed as a unix timestamp, at which the current image was pushed to the repository.
    imageSizeInBytes Number
    Size, in bytes, of the image in the repository.
    imageTags List<String>
    List of tags associated with this image.
    imageUri String
    The URI for the specific image version specified by image_tag or image_digest.
    registryId String
    repositoryName String
    imageTag String
    mostRecent Boolean

    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

    Try AWS Native preview for resources not in the classic version.

    AWS Classic v6.42.0 published on Wednesday, Jun 26, 2024 by Pulumi