Amazon CloudFront
API Reference (API Version 2017-10-30)


Request Syntax

GET /2017-10-30/public-key?Marker=Marker&MaxItems=MaxItems HTTP/1.1

URI Request Parameters

The request requires the following URI parameters.

Request Body

The request does not have a request body.

Response Syntax

HTTP/1.1 200 <?xml version="1.0" encoding="UTF-8"?> <PublicKeyList> <IsTruncated>boolean</IsTruncated> <Items> <PublicKeySummary> <Comment>string</Comment> <CreatedTime>timestamp</CreatedTime> <EncodedKey>string</EncodedKey> <Id>string</Id> <Name>string</Name> </PublicKeySummary> </Items> <Marker>string</Marker> <MaxItems>integer</MaxItems> <NextMarker>string</NextMarker> <Quantity>integer</Quantity> </PublicKeyList>

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.


Root level tag for the PublicKeyList parameters.

Required: Yes


A flag that indicates whether more elements 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


An array of information about a public key you add to CloudFront to use with features like field-level encryption.

Type: Array of PublicKeySummary objects


Use this when paginating results to indicate where to begin in your list of public keys. The results include public keys 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 public key on that page).

Type: String


The maximum number of public keys you want in the response body.

Type: Integer


If IsTruncated is true, this element is present and contains the value that you can use for the Marker request parameter to continue listing your public keys where you left off.

Type: String


The number of public keys you added to CloudFront to use with features like field-level encryption.

Type: Integer


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


The argument is invalid.

HTTP Status Code: 400

See Also

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