IAmazonECR.ListImages Method (ListImagesRequest)

Lists all the image IDs for the specified repository.

You can filter images based on whether or not they are tagged by using the tagStatus filter and specifying either TAGGED, UNTAGGED or ANY. For example, you can filter your results to return only UNTAGGED images and then pipe that result to a BatchDeleteImage operation to delete them. Or, you can filter your results to return only TAGGED images to list all of the tags in your repository.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to ListImagesAsync.

Namespace: Amazon.ECR
Assembly: AWSSDK.ECR.dll
Version: 3.x.y.z

Syntax

public abstract ListImagesResponse ListImages(
         ListImagesRequest request
)

Parameters

request: Type: Amazon.ECR.Model.ListImagesRequest

Container for the necessary parameters to execute the ListImages service method.

Return Value

Type: ListImagesResponse

The response from the ListImages service method, as returned by ECR.

Exceptions

Exception	Condition
InvalidParameterException	The specified parameter is invalid. Review the available parameters for the API request.
RepositoryNotFoundException	The specified repository could not be found. Check the spelling of the specified repository and ensure that you are performing operations on the correct registry.
ServerException	These errors are usually caused by a server-side issue.

Examples

This example lists all of the images in the repository named ubuntu in the default registry in the current account.

To list all images in a repository


var client = new AmazonECRClient();
var response = client.ListImages(new ListImagesRequest 
{
    RepositoryName = "ubuntu"
});

List<ImageIdentifier> imageIds = response.ImageIds;

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

IAmazonECR.ListImages (ListImagesRequest)

Method