| Copyright | (c) 2013-2023 Brendan Hay |
|---|---|
| License | Mozilla Public License, v. 2.0. |
| Maintainer | Brendan Hay |
| Stability | auto-generated |
| Portability | non-portable (GHC extensions) |
| Safe Haskell | Safe-Inferred |
| Language | Haskell2010 |
Amazonka.EC2.ListImagesInRecycleBin
Description
Lists one or more AMIs that are currently in the Recycle Bin. For more information, see Recycle Bin in the Amazon EC2 User Guide.
This operation returns paginated results.
Synopsis
- data ListImagesInRecycleBin = ListImagesInRecycleBin' {}
- newListImagesInRecycleBin :: ListImagesInRecycleBin
- listImagesInRecycleBin_dryRun :: Lens' ListImagesInRecycleBin (Maybe Bool)
- listImagesInRecycleBin_imageIds :: Lens' ListImagesInRecycleBin (Maybe [Text])
- listImagesInRecycleBin_maxResults :: Lens' ListImagesInRecycleBin (Maybe Natural)
- listImagesInRecycleBin_nextToken :: Lens' ListImagesInRecycleBin (Maybe Text)
- data ListImagesInRecycleBinResponse = ListImagesInRecycleBinResponse' {
- images :: Maybe [ImageRecycleBinInfo]
- nextToken :: Maybe Text
- httpStatus :: Int
- newListImagesInRecycleBinResponse :: Int -> ListImagesInRecycleBinResponse
- listImagesInRecycleBinResponse_images :: Lens' ListImagesInRecycleBinResponse (Maybe [ImageRecycleBinInfo])
- listImagesInRecycleBinResponse_nextToken :: Lens' ListImagesInRecycleBinResponse (Maybe Text)
- listImagesInRecycleBinResponse_httpStatus :: Lens' ListImagesInRecycleBinResponse Int
Creating a Request
data ListImagesInRecycleBin Source #
See: newListImagesInRecycleBin smart constructor.
Constructors
| ListImagesInRecycleBin' | |
Fields
| |
Instances
newListImagesInRecycleBin :: ListImagesInRecycleBin Source #
Create a value of ListImagesInRecycleBin with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:dryRun:ListImagesInRecycleBin', listImagesInRecycleBin_dryRun - Checks whether you have the required permissions for the action, without
actually making the request, and provides an error response. If you have
the required permissions, the error response is DryRunOperation.
Otherwise, it is UnauthorizedOperation.
$sel:imageIds:ListImagesInRecycleBin', listImagesInRecycleBin_imageIds - The IDs of the AMIs to list. Omit this parameter to list all of the AMIs
that are in the Recycle Bin. You can specify up to 20 IDs in a single
request.
$sel:maxResults:ListImagesInRecycleBin', listImagesInRecycleBin_maxResults - The maximum number of results to return with a single call. To retrieve
the remaining results, make another call with the returned nextToken
value.
If you do not specify a value for MaxResults, the request returns 1,000 items per page by default. For more information, see Pagination.
ListImagesInRecycleBin, listImagesInRecycleBin_nextToken - The token for the next page of results.
Request Lenses
listImagesInRecycleBin_dryRun :: Lens' ListImagesInRecycleBin (Maybe Bool) Source #
Checks whether you have the required permissions for the action, without
actually making the request, and provides an error response. If you have
the required permissions, the error response is DryRunOperation.
Otherwise, it is UnauthorizedOperation.
listImagesInRecycleBin_imageIds :: Lens' ListImagesInRecycleBin (Maybe [Text]) Source #
The IDs of the AMIs to list. Omit this parameter to list all of the AMIs that are in the Recycle Bin. You can specify up to 20 IDs in a single request.
listImagesInRecycleBin_maxResults :: Lens' ListImagesInRecycleBin (Maybe Natural) Source #
The maximum number of results to return with a single call. To retrieve
the remaining results, make another call with the returned nextToken
value.
If you do not specify a value for MaxResults, the request returns 1,000 items per page by default. For more information, see Pagination.
listImagesInRecycleBin_nextToken :: Lens' ListImagesInRecycleBin (Maybe Text) Source #
The token for the next page of results.
Destructuring the Response
data ListImagesInRecycleBinResponse Source #
See: newListImagesInRecycleBinResponse smart constructor.
Constructors
| ListImagesInRecycleBinResponse' | |
Fields
| |
Instances
newListImagesInRecycleBinResponse Source #
Create a value of ListImagesInRecycleBinResponse with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:images:ListImagesInRecycleBinResponse', listImagesInRecycleBinResponse_images - Information about the AMIs.
ListImagesInRecycleBin, listImagesInRecycleBinResponse_nextToken - The token to use to retrieve the next page of results. This value is
null when there are no more results to return.
$sel:httpStatus:ListImagesInRecycleBinResponse', listImagesInRecycleBinResponse_httpStatus - The response's http status code.
Response Lenses
listImagesInRecycleBinResponse_images :: Lens' ListImagesInRecycleBinResponse (Maybe [ImageRecycleBinInfo]) Source #
Information about the AMIs.
listImagesInRecycleBinResponse_nextToken :: Lens' ListImagesInRecycleBinResponse (Maybe Text) Source #
The token to use to retrieve the next page of results. This value is
null when there are no more results to return.
listImagesInRecycleBinResponse_httpStatus :: Lens' ListImagesInRecycleBinResponse Int Source #
The response's http status code.