GetOriginRequestPolicyConfig
Gets an origin request policy configuration.
To get an origin request policy configuration, you must provide the policy's
identifier. If the origin request policy is attached to a distribution's cache behavior,
you can get the policy's identifier using ListDistributions
or
GetDistribution
. If the origin request policy is not attached to a
cache behavior, you can get the identifier using
ListOriginRequestPolicies
.
Request Syntax
GET /2020-05-31/origin-request-policy/Id
/config HTTP/1.1
URI Request Parameters
The request uses the following URI parameters.
- Id
-
The unique identifier for the origin request policy. If the origin request policy is attached to a distribution's cache behavior, you can get the policy's identifier using
ListDistributions
orGetDistribution
. If the origin request policy is not attached to a cache behavior, you can get the identifier usingListOriginRequestPolicies
.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"?>
<OriginRequestPolicyConfig>
<Comment>string</Comment>
<CookiesConfig>
<CookieBehavior>string</CookieBehavior>
<Cookies>
<Items>
<Name>string</Name>
</Items>
<Quantity>integer</Quantity>
</Cookies>
</CookiesConfig>
<HeadersConfig>
<HeaderBehavior>string</HeaderBehavior>
<Headers>
<Items>
<Name>string</Name>
</Items>
<Quantity>integer</Quantity>
</Headers>
</HeadersConfig>
<Name>string</Name>
<QueryStringsConfig>
<QueryStringBehavior>string</QueryStringBehavior>
<QueryStrings>
<Items>
<Name>string</Name>
</Items>
<Quantity>integer</Quantity>
</QueryStrings>
</QueryStringsConfig>
</OriginRequestPolicyConfig>
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.
- OriginRequestPolicyConfig
-
Root level tag for the OriginRequestPolicyConfig parameters.
Required: Yes
- Comment
-
A comment to describe the origin request policy. The comment cannot be longer than 128 characters.
Type: String
- CookiesConfig
-
The cookies from viewer requests to include in origin requests.
Type: OriginRequestPolicyCookiesConfig object
- HeadersConfig
-
The HTTP headers to include in origin requests. These can include headers from viewer requests and additional headers added by CloudFront.
Type: OriginRequestPolicyHeadersConfig object
- Name
-
A unique name to identify the origin request policy.
Type: String
- QueryStringsConfig
-
The URL query strings from viewer requests to include in origin requests.
Type: OriginRequestPolicyQueryStringsConfig object
Errors
For information about the errors that are common to all actions, see Common Errors.
- AccessDenied
-
Access denied.
HTTP Status Code: 403
- NoSuchOriginRequestPolicy
-
The origin request policy does not exist.
HTTP Status Code: 404
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: