AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Describes the specified images (AMIs, AKIs, and ARIs) available to you or all of the images available to you.

The images available to you include public images, private images that you own, and private images owned by other Amazon Web Services accounts for which you have explicit launch permissions.

Recently deregistered images appear in the returned results for a short interval and then return empty results. After all instances that reference a deregistered AMI are terminated, specifying the ID of the image will eventually return an error indicating that the AMI ID cannot be found.

We strongly recommend using only paginated requests. Unpaginated requests are susceptible to throttling and timeouts.

The order of the elements in the response, including those within nested structures, might vary. Applications should not assume the elements appear in a particular order.

Note:

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

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

Syntax

C#
public virtual DescribeImagesResponse DescribeImages(
         DescribeImagesRequest request
)

Parameters

request
Type: Amazon.EC2.Model.DescribeImagesRequest

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

Return Value


The response from the DescribeImages service method, as returned by EC2.

Examples

This example describes the specified AMI.

To describe an AMI


var client = new AmazonEC2Client();
var response = client.DescribeImages(new DescribeImagesRequest 
{
    ImageIds = new List<string> {
        "ami-5731123e"
    }
});

List<Image> images = response.Images;

            

Version Information

.NET Framework:
Supported in: 4.5 and newer, 3.5

See Also