Menu
Amazon CloudFront
API Reference (API Version 2016-09-29)

ListInvalidations

Lists invalidation batches.

Request Syntax

GET /2016-09-29/distribution/DistributionId/invalidation?Marker=Marker&MaxItems=MaxItems HTTP/1.1

URI Request Parameters

The request requires the following URI parameters.

DistributionId

The distribution's ID.

Marker

Use this parameter when paginating results to indicate where to begin in your list of invalidation batches. Because the results are returned in decreasing order from most recent to oldest, the most recent results are on the first page, the second page will contain earlier results, and so on. To get the next page of results, set Marker to the value of the NextMarker from the current page's response. This value is the same as the ID of the last invalidation batch on that page.

MaxItems

The maximum number of invalidation batches that 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"?>
<ListInvalidationsResult>
   <InvalidationList>
      <IsTruncated>boolean</IsTruncated>
      <Items>
         <InvalidationSummary>
            <CreateTime>timestamp</CreateTime>
            <Id>string</Id>
            <Status>string</Status>
         </InvalidationSummary></Items>
      <Marker>string</Marker>
      <MaxItems>integer</MaxItems>
      <NextMarker>string</NextMarker>
      <Quantity>integer</Quantity>
   </InvalidationList>
</ListInvalidationsResult>

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.

ListInvalidationsResult

Root level tag for the ListInvalidationsResult parameters.

Required: Yes

InvalidationList

Information about invalidation batches.

Type: InvalidationList object

Errors

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

AccessDenied

Access denied.

HTTP Status Code: 403

InvalidArgument

The argument is invalid.

HTTP Status Code: 400

NoSuchDistribution

The specified distribution does not exist.

HTTP Status Code: 404