Amazon CloudFront
API Reference (API Version 2013-05-12)
AWS Documentation » Amazon CloudFront » API Reference » Actions on Invalidations » GET Invalidation List
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Did this page help you?  Yes | No |  Tell us about it...

GET Invalidation List

Topics

Description

To list your invalidation batches, you do a GET on the 2013-05-12/distribution/distribution ID/invalidation resource. The response includes an InvalidationList element with zero or more InvalidationSummary child elements. By default, your entire list of invalidations is returned in one single page ordered from newest to oldest. If the list is long, you can paginate it using the MaxItems and Marker parameters.

Invalidation history is available for the current and previous billing cycles.

Requests

Syntax

GET /2013-05-12/distribution/distribution ID/invalidation?Marker=value&MaxItems=value HTTP/1.1
Host: cloudfront.amazonaws.com
Authorization: AWS authentication string
Other required headers

Headers

The request must include the headers required in all CloudFront requests. For more information, see Common REST Headers.

Query Parameters

NameDescriptionRequired

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 the 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.

Type: String

Default: CloudFront lists invalidation batches from most recent to oldest

No

MaxItems

The maximum number of invalidation batches you want in the response body.

Type: String with a maximum value of 100

Default: 100

No

Responses

Syntax

HTTP/1.0 200 OK
Content-Type: text/xml

<InvalidationList>
   <Marker>value specified in request</Marker>
   <NextMarker>value for Marker parameter in 
      next request</NextMarker>
   <MaxItems>value specified in request</MaxItems>
   <IsTruncated>true | false</IsTruncated>
   <Quantity>number of invalidation batches created by 
      current AWS account</Quantity>
   <Items>
      <InvalidationSummary>
         <Id>Invalidation ID</Id>
         <Status>InProgress | Completed</Status>
      </InvalidationSummary>
   </Items>
</InvalidationList>

Elements

NameDescription

InvalidationList

Information about invalidation batches. For more information, see InvalidationList Complex Type

Type: InvalidationList datatype

Examples

The following example request lists the first two of your ten invalidation batches.

Sample Request

GET /2013-05-12/distribution/distribution ID/invalidation?MaxItems=2 HTTP/1.1
Host: cloudfront.amazonaws.com
Authorization: AWS authentication string
Other required headers

Sample Response

HTTP/1.0 200 OK
Content-Type: text/xml

<InvalidationList>
   <Marker>EGTXBD79EXAMPLE</Marker>
   <NextMarker>Invalidation ID</NextMarker>
   <MaxItems>2</MaxItems>
   <IsTruncated>true</IsTruncated>
   <Quantity>10</Quantity>
   <Items>
      <InvalidationSummary>
         <Id>Second Invalidation ID</Id>
         <Status>Completed</Status>
      </InvalidationSummary>
      <InvalidationSummary>
         <Id>First Invalidation ID</Id>
         <Status>Completed</Status>
      </InvalidationSummary>
   </Items>
</InvalidationList>

Related Actions

Document Conventions« PreviousNext »
Terms of UseDid this page help you?  Yes | No |  Tell us about it...