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.
Container for the parameters to the DescribeImages operation. 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.
Namespace: Amazon.EC2.Model
Assembly: AWSSDK.EC2.dll
Version: 3.x.y.z
public class DescribeImagesRequest : AmazonEC2Request IAmazonWebServiceRequest
The DescribeImagesRequest type exposes the following members
Name | Description | |
---|---|---|
DescribeImagesRequest() |
Name | Type | Description | |
---|---|---|---|
ExecutableUsers | System.Collections.Generic.List<System.String> |
Gets and sets the property ExecutableUsers.
Scopes the images by users with explicit launch permissions. Specify an Amazon Web
Services account ID,
|
|
Filters | System.Collections.Generic.List<Amazon.EC2.Model.Filter> |
Gets and sets the property Filters. The filters.
|
|
ImageIds | System.Collections.Generic.List<System.String> |
Gets and sets the property ImageIds. The image IDs. Default: Describes all images available to you. |
|
IncludeDeprecated | System.Boolean |
Gets and sets the property IncludeDeprecated. Specifies whether to include deprecated AMIs. Default: No deprecated AMIs are included in the response. If you are the AMI owner, all deprecated AMIs appear in the response regardless of what you specify for this parameter. |
|
IncludeDisabled | System.Boolean |
Gets and sets the property IncludeDisabled. Specifies whether to include disabled AMIs. Default: No disabled AMIs are included in the response. |
|
MaxResults | System.Int32 |
Gets and sets the property MaxResults. The maximum number of items to return for this request. To get the next page of items, make another request with the token returned in the output. For more information, see Pagination. |
|
NextToken | System.String |
Gets and sets the property NextToken. The token returned from a previous paginated request. Pagination continues from the end of the items returned by the previous request. |
|
Owners | System.Collections.Generic.List<System.String> |
Gets and sets the property Owners.
Scopes the results to images with the specified owners. You can specify a combination
of Amazon Web Services account IDs, |
This example describes the specified AMI.
var client = new AmazonEC2Client(); var response = client.DescribeImages(new DescribeImagesRequest { ImageIds = new List<string> { "ami-5731123e" } }); List<Image> images = response.Images;
.NET:
Supported in: 8.0 and newer, Core 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.5 and newer, 3.5