Request Syntax URI Request Parameters Request Body Response Syntax Response Elements Errors See Also

ListDistributionsByRealtimeLogConfig

Gets a list of distributions that have a cache behavior that's associated with the specified real-time log configuration.

You can specify the real-time log configuration by its name or its Amazon Resource Name (ARN). You must provide at least one. If you provide both, CloudFront uses the name to identify the real-time log configuration to list distributions for.

You can optionally specify the maximum number of items to receive in the response. If the total number of items in the list exceeds the maximum that you specify, or the default maximum, the response is paginated. To get the next page of items, send a subsequent request that specifies the NextMarker value from the current response as the Marker value in the subsequent request.

Request Syntax


POST /2020-05-31/distributionsByRealtimeLogConfig HTTP/1.1
<?xml version="1.0" encoding="UTF-8"?>
<ListDistributionsByRealtimeLogConfigRequest xmlns="http://cloudfront.amazonaws.com/doc/2020-05-31/">
   <Marker>string</Marker>
   <MaxItems>string</MaxItems>
   <RealtimeLogConfigArn>string</RealtimeLogConfigArn>
   <RealtimeLogConfigName>string</RealtimeLogConfigName>
</ListDistributionsByRealtimeLogConfigRequest>

URI Request Parameters

The request does not use any URI parameters.

Request Body

The request accepts the following data in XML format.

ListDistributionsByRealtimeLogConfigRequest

Root level tag for the ListDistributionsByRealtimeLogConfigRequest parameters.

Required: Yes

Marker

Use this field when paginating results to indicate where to begin in your list of distributions. The response includes distributions in the list that occur after the marker. To get the next page of the list, set this field's value to the value of NextMarker from the current page's response.

Type: String

Required: No

MaxItems

The maximum number of distributions that you want in the response.

Type: String

Required: No

RealtimeLogConfigArn

The Amazon Resource Name (ARN) of the real-time log configuration whose associated distributions you want to list.

Type: String

Required: No

RealtimeLogConfigName

The name of the real-time log configuration whose associated distributions you want to list.

Type: String

Required: No

Response Syntax


HTTP/1.1 200
<?xml version="1.0" encoding="UTF-8"?>
<DistributionList>
   <IsTruncated>boolean</IsTruncated>
   <Items>
      <DistributionSummary>
         <Aliases>
            <Items>
               <CNAME>string</CNAME>
            </Items>
            <Quantity>integer</Quantity>
         </Aliases>
         <AliasICPRecordals>
            <AliasICPRecordal>
               <CNAME>string</CNAME>
               <ICPRecordalStatus>string</ICPRecordalStatus>
            </AliasICPRecordal>
         </AliasICPRecordals>
         <AnycastIpListId>string</AnycastIpListId>
         <ARN>string</ARN>
         <CacheBehaviors>
            <Items>
               <CacheBehavior>
                  <AllowedMethods>
                     <CachedMethods>
                        <Items>
                           <Method>string</Method>
                        </Items>
                        <Quantity>integer</Quantity>
                     </CachedMethods>
                     <Items>
                        <Method>string</Method>
                     </Items>
                     <Quantity>integer</Quantity>
                  </AllowedMethods>
                  <CachePolicyId>string</CachePolicyId>
                  <Compress>boolean</Compress>
                  <DefaultTTL>long</DefaultTTL>
                  <FieldLevelEncryptionId>string</FieldLevelEncryptionId>
                  <ForwardedValues>
                     <Cookies>
                        <Forward>string</Forward>
                        <WhitelistedNames>
                           <Items>
                              <Name>string</Name>
                           </Items>
                           <Quantity>integer</Quantity>
                        </WhitelistedNames>
                     </Cookies>
                     <Headers>
                        <Items>
                           <Name>string</Name>
                        </Items>
                        <Quantity>integer</Quantity>
                     </Headers>
                     <QueryString>boolean</QueryString>
                     <QueryStringCacheKeys>
                        <Items>
                           <Name>string</Name>
                        </Items>
                        <Quantity>integer</Quantity>
                     </QueryStringCacheKeys>
                  </ForwardedValues>
                  <FunctionAssociations>
                     <Items>
                        <FunctionAssociation>
                           <EventType>string</EventType>
                           <FunctionARN>string</FunctionARN>
                        </FunctionAssociation>
                     </Items>
                     <Quantity>integer</Quantity>
                  </FunctionAssociations>
                  <GrpcConfig>
                     <Enabled>boolean</Enabled>
                  </GrpcConfig>
                  <LambdaFunctionAssociations>
                     <Items>
                        <LambdaFunctionAssociation>
                           <EventType>string</EventType>
                           <IncludeBody>boolean</IncludeBody>
                           <LambdaFunctionARN>string</LambdaFunctionARN>
                        </LambdaFunctionAssociation>
                     </Items>
                     <Quantity>integer</Quantity>
                  </LambdaFunctionAssociations>
                  <MaxTTL>long</MaxTTL>
                  <MinTTL>long</MinTTL>
                  <OriginRequestPolicyId>string</OriginRequestPolicyId>
                  <PathPattern>string</PathPattern>
                  <RealtimeLogConfigArn>string</RealtimeLogConfigArn>
                  <ResponseHeadersPolicyId>string</ResponseHeadersPolicyId>
                  <SmoothStreaming>boolean</SmoothStreaming>
                  <TargetOriginId>string</TargetOriginId>
                  <TrustedKeyGroups>
                     <Enabled>boolean</Enabled>
                     <Items>
                        <KeyGroup>string</KeyGroup>
                     </Items>
                     <Quantity>integer</Quantity>
                  </TrustedKeyGroups>
                  <TrustedSigners>
                     <Enabled>boolean</Enabled>
                     <Items>
                        <AwsAccountNumber>string</AwsAccountNumber>
                     </Items>
                     <Quantity>integer</Quantity>
                  </TrustedSigners>
                  <ViewerProtocolPolicy>string</ViewerProtocolPolicy>
               </CacheBehavior>
            </Items>
            <Quantity>integer</Quantity>
         </CacheBehaviors>
         <Comment>string</Comment>
         <ConnectionFunctionAssociation>
            <Id>string</Id>
         </ConnectionFunctionAssociation>
         <ConnectionMode>string</ConnectionMode>
         <CustomErrorResponses>
            <Items>
               <CustomErrorResponse>
                  <ErrorCachingMinTTL>long</ErrorCachingMinTTL>
                  <ErrorCode>integer</ErrorCode>
                  <ResponseCode>string</ResponseCode>
                  <ResponsePagePath>string</ResponsePagePath>
               </CustomErrorResponse>
            </Items>
            <Quantity>integer</Quantity>
         </CustomErrorResponses>
         <DefaultCacheBehavior>
            <AllowedMethods>
               <CachedMethods>
                  <Items>
                     <Method>string</Method>
                  </Items>
                  <Quantity>integer</Quantity>
               </CachedMethods>
               <Items>
                  <Method>string</Method>
               </Items>
               <Quantity>integer</Quantity>
            </AllowedMethods>
            <CachePolicyId>string</CachePolicyId>
            <Compress>boolean</Compress>
            <DefaultTTL>long</DefaultTTL>
            <FieldLevelEncryptionId>string</FieldLevelEncryptionId>
            <ForwardedValues>
               <Cookies>
                  <Forward>string</Forward>
                  <WhitelistedNames>
                     <Items>
                        <Name>string</Name>
                     </Items>
                     <Quantity>integer</Quantity>
                  </WhitelistedNames>
               </Cookies>
               <Headers>
                  <Items>
                     <Name>string</Name>
                  </Items>
                  <Quantity>integer</Quantity>
               </Headers>
               <QueryString>boolean</QueryString>
               <QueryStringCacheKeys>
                  <Items>
                     <Name>string</Name>
                  </Items>
                  <Quantity>integer</Quantity>
               </QueryStringCacheKeys>
            </ForwardedValues>
            <FunctionAssociations>
               <Items>
                  <FunctionAssociation>
                     <EventType>string</EventType>
                     <FunctionARN>string</FunctionARN>
                  </FunctionAssociation>
               </Items>
               <Quantity>integer</Quantity>
            </FunctionAssociations>
            <GrpcConfig>
               <Enabled>boolean</