ListDistributionsByOwnedResource - Amazon CloudFront

ListDistributionsByOwnedResource

Lists the CloudFront distributions that are associated with the specified resource that you own.

Request Syntax

GET /2020-05-31/distributionsByOwnedResource/ResourceArn?Marker=Marker&MaxItems=MaxItems HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.

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.

MaxItems

The maximum number of distributions to return.

ResourceArn

The ARN of the CloudFront resource that you've shared with other AWS accounts.

Required: Yes

Request Body

The request does not have a request body.

Response Syntax

HTTP/1.1 200 <?xml version="1.0" encoding="UTF-8"?> <DistributionList> <IsTruncated>boolean</IsTruncated> <Items> <DistributionIdOwner> <DistributionId>string</DistributionId> <OwnerAccountId>string</OwnerAccountId> </DistributionIdOwner> </Items> <Marker>string</Marker> <MaxItems>integer</MaxItems> <NextMarker>string</NextMarker> <Quantity>integer</Quantity> </DistributionList>

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.

DistributionList

Root level tag for the DistributionList parameters.

Required: Yes

IsTruncated

A flag that indicates whether more DistributionIdOwner objects 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 results in the list.

Type: Boolean

Items

The number of DistributionIdOwner objects.

Type: Array of DistributionIdOwner objects

Marker

Use this field when paginating results to indicate where to begin in your list of DistributionIdOwner objects. 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

MaxItems

The maximum number of DistributionIdOwner objects to return.

Type: Integer

NextMarker

A token used for pagination of results returned in the response. You can use the token from the previous request to define where the current request should begin.

Type: String

Quantity

Specifies the actual number of DistributionIdOwner objects included in the list for the current page.

Type: Integer

Errors

For information about the errors that are common to all actions, see Common Errors.

AccessDenied

Access denied.

HTTP Status Code: 403

EntityNotFound

The entity was not found.

HTTP Status Code: 404

InvalidArgument

An argument is invalid.

HTTP Status Code: 400

UnsupportedOperation

This operation is not supported in this AWS Region.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: