Returns information about AMIs, AKIs, and ARIs.
This includes image type, product codes, architecture, and kernel
and RAM disk IDs. Images available to you include public images,
private images that you own, and private images owned by other
users for which you have explicit launch permissions.
Declaration Syntax
C# |
DescribeImagesResponse DescribeImages( DescribeImagesRequest request )
Parameters
- request (DescribeImagesRequest)
- Describe Images request
Return Value
Describe Images Response from the service
Remarks
Launch permissions fall into three categories:
1. public:
The owner of the AMI granted launch permissions for the AMI to the
all group. All users have launch permissions for these AMIs.
2. explicit:
The owner of the AMI granted launch permissions to a specific user.
3. implicit:
A user has implicit launch permissions for all AMIs he or she
owns.
The list of AMIs returned can be modified by specifying AMI IDs,
AMI owners, or users with launch permissions. If no options are
specified, Amazon EC2 returns all AMIs for
which the user has launch permissions.
If you specify one or more AMI IDs, only AMIs that have the
specified IDs are returned. If you specify an invalid AMI
ID, a fault is returned. If you specify an AMI ID for which
you do not have access, it will not be included in the returned
results.
If you specify one or more AMI owners, only AMIs from the
specified owners and for which you have access are returned. The
results can include the account IDs of the
specified owners, amazon for AMIs owned by Amazon or self for AMIs that you
own.
If you specify a list of executable users, only users that have
launch permissions for the AMIs are returned. You can specify account IDs
(if you own the AMI(s)), self for AMIs for which you own or have
explicit permissions, or all for public AMIs.
Exceptions
Exception | Condition |
---|---|
WebException | |
AmazonEC2Exception |