

# ListCloudFrontOriginAccessIdentities


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](#API_ListCloudFrontOriginAccessIdentities_RequestSyntax) **   <a name="cloudfront-ListCloudFrontOriginAccessIdentities-request-uri-Marker"></a>
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 `Marker` to the value of the `NextMarker` from the current page's response (which is also the ID of the last identity on that page).

 ** [MaxItems](#API_ListCloudFrontOriginAccessIdentities_RequestSyntax) **   <a name="cloudfront-ListCloudFrontOriginAccessIdentities-request-uri-MaxItems"></a>
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](#API_ListCloudFrontOriginAccessIdentities_ResponseSyntax) **   <a name="cloudfront-ListCloudFrontOriginAccessIdentities-response-CloudFrontOriginAccessIdentityList"></a>
Root level tag for the CloudFrontOriginAccessIdentityList parameters.  
Required: Yes

 ** [IsTruncated](#API_ListCloudFrontOriginAccessIdentities_ResponseSyntax) **   <a name="cloudfront-ListCloudFrontOriginAccessIdentities-response-IsTruncated"></a>
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 `Marker` request parameter to retrieve more items in the list.  
Type: Boolean

 ** [Items](#API_ListCloudFrontOriginAccessIdentities_ResponseSyntax) **   <a name="cloudfront-ListCloudFrontOriginAccessIdentities-response-Items"></a>
A complex type that contains one `CloudFrontOriginAccessIdentitySummary` element for each origin access identity that was created by the current Amazon Web Services account.  
Type: Array of [CloudFrontOriginAccessIdentitySummary](API_CloudFrontOriginAccessIdentitySummary.md) objects

 ** [Marker](#API_ListCloudFrontOriginAccessIdentities_ResponseSyntax) **   <a name="cloudfront-ListCloudFrontOriginAccessIdentities-response-Marker"></a>
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 `Marker` to the value of the `NextMarker` from the current page's response (which is also the ID of the last identity on that page).  
Type: String

 ** [MaxItems](#API_ListCloudFrontOriginAccessIdentities_ResponseSyntax) **   <a name="cloudfront-ListCloudFrontOriginAccessIdentities-response-MaxItems"></a>
The maximum number of origin access identities you want in the response body.  
Type: Integer

 ** [NextMarker](#API_ListCloudFrontOriginAccessIdentities_ResponseSyntax) **   <a name="cloudfront-ListCloudFrontOriginAccessIdentities-response-NextMarker"></a>
If `IsTruncated` is `true`, this element is present and contains the value you can use for the `Marker` request parameter to continue listing your origin access identities where they left off.  
Type: String

 ** [Quantity](#API_ListCloudFrontOriginAccessIdentities_ResponseSyntax) **   <a name="cloudfront-ListCloudFrontOriginAccessIdentities-response-Quantity"></a>
The number of CloudFront origin access identities that were created by the current Amazon Web Services account.  
Type: Integer

## Errors


For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidArgument **   
An argument is invalid.  
HTTP Status Code: 400

## See Also


For more information about using this API in one of the language-specific Amazon SDKs, see the following:
+  [Amazon Command Line Interface V2](https://docs.amazonaws.cn/goto/cli2/cloudfront-2020-05-31/ListCloudFrontOriginAccessIdentities) 
+  [Amazon SDK for .NET V4](https://docs.amazonaws.cn/goto/DotNetSDKV4/cloudfront-2020-05-31/ListCloudFrontOriginAccessIdentities) 
+  [Amazon SDK for C\$1\$1](https://docs.amazonaws.cn/goto/SdkForCpp/cloudfront-2020-05-31/ListCloudFrontOriginAccessIdentities) 
+  [Amazon SDK for Go v2](https://docs.amazonaws.cn/goto/SdkForGoV2/cloudfront-2020-05-31/ListCloudFrontOriginAccessIdentities) 
+  [Amazon SDK for Java V2](https://docs.amazonaws.cn/goto/SdkForJavaV2/cloudfront-2020-05-31/ListCloudFrontOriginAccessIdentities) 
+  [Amazon SDK for JavaScript V3](https://docs.amazonaws.cn/goto/SdkForJavaScriptV3/cloudfront-2020-05-31/ListCloudFrontOriginAccessIdentities) 
+  [Amazon SDK for Kotlin](https://docs.amazonaws.cn/goto/SdkForKotlin/cloudfront-2020-05-31/ListCloudFrontOriginAccessIdentities) 
+  [Amazon SDK for PHP V3](https://docs.amazonaws.cn/goto/SdkForPHPV3/cloudfront-2020-05-31/ListCloudFrontOriginAccessIdentities) 
+  [Amazon SDK for Python](https://docs.amazonaws.cn/goto/boto3/cloudfront-2020-05-31/ListCloudFrontOriginAccessIdentities) 
+  [Amazon SDK for Ruby V3](https://docs.amazonaws.cn/goto/SdkForRubyV3/cloudfront-2020-05-31/ListCloudFrontOriginAccessIdentities) 