Lists origin access identities.
Request Syntax
GET /2020-05-31/origin-access-identity/cloudfront?Marker=Marker&MaxItems=MaxItems HTTP/1.1
URI Request Parameters
The request uses the following URI parameters.
- Marker
-
Use this when paginating results to indicate where to begin in your list of origin access identities. The results include identities in the list that occur after the marker. To get the next page of results, set the
Markerto the value of theNextMarkerfrom the current page's response (which is also the ID of the last identity on that page). - MaxItems
-
The maximum number of origin access identities you want in the response body.
Request Body
The request does not have a request body.
Response Syntax
HTTP/1.1 200
<?xml version="1.0" encoding="UTF-8"?>
<CloudFrontOriginAccessIdentityList>
<IsTruncated>boolean</IsTruncated>
<Items>
<CloudFrontOriginAccessIdentitySummary>
<Comment>string</Comment>
<Id>string</Id>
<S3CanonicalUserId>string</S3CanonicalUserId>
</CloudFrontOriginAccessIdentitySummary>
</Items>
<Marker>string</Marker>
<MaxItems>integer</MaxItems>
<NextMarker>string</NextMarker>
<Quantity>integer</Quantity>
</CloudFrontOriginAccessIdentityList>Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in XML format by the service.
- CloudFrontOriginAccessIdentityList
-
Root level tag for the CloudFrontOriginAccessIdentityList parameters.
Required: Yes
- IsTruncated
-
A flag that indicates whether more origin access identities remain to be listed. If your results were truncated, you can make a follow-up pagination request using the
Markerrequest parameter to retrieve more items in the list.Type: Boolean
- Items
-
A complex type that contains one
CloudFrontOriginAccessIdentitySummaryelement for each origin access identity that was created by the current AWS account.Type: Array of CloudFrontOriginAccessIdentitySummary objects
- Marker
-
Use this when paginating results to indicate where to begin in your list of origin access identities. The results include identities in the list that occur after the marker. To get the next page of results, set the
Markerto the value of theNextMarkerfrom the current page's response (which is also the ID of the last identity on that page).Type: String
- MaxItems
-
The maximum number of origin access identities you want in the response body.
Type: Integer
- NextMarker
-
If
IsTruncatedistrue, this element is present and contains the value you can use for theMarkerrequest parameter to continue listing your origin access identities where they left off.Type: String
- Quantity
-
The number of CloudFront origin access identities that were created by the current AWS account.
Type: Integer
Errors
For information about the errors that are common to all actions, see Common Errors.
- InvalidArgument
-
An argument is invalid.
HTTP Status Code: 400
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
