AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
Creates a cache policy.
After you create a cache policy, you can attach it to one or more cache behaviors. When it's attached to a cache behavior, the cache policy determines the following:
The values that CloudFront includes in the cache key. These values can include HTTP headers, cookies, and URL query strings. CloudFront uses the cache key to find an object in its cache that it can return to the viewer.
The default, minimum, and maximum time to live (TTL) values that you want objects to stay in the CloudFront cache.
The headers, cookies, and query strings that are included in the cache key are also
included in requests that CloudFront sends to the origin. CloudFront sends a request
when it can't find an object in its cache that matches the request's cache key. If
you want to send values to the origin but not include them in the cache key,
use OriginRequestPolicy
.
For more information about cache policies, see Controlling the cache key in the Amazon CloudFront Developer Guide.
This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginCreateCachePolicy and EndCreateCachePolicy.
Namespace: Amazon.CloudFront
Assembly: AWSSDK.CloudFront.dll
Version: 3.x.y.z
public abstract Task<CreateCachePolicyResponse> CreateCachePolicyAsync( CreateCachePolicyRequest request, CancellationToken cancellationToken )
Container for the necessary parameters to execute the CreateCachePolicy service method.
A cancellation token that can be used by other objects or threads to receive notice of cancellation.
Exception | Condition |
---|---|
AccessDeniedException | Access denied. |
CachePolicyAlreadyExistsException | A cache policy with this name already exists. You must provide a unique name. To modify an existing cache policy, use UpdateCachePolicy. |
InconsistentQuantitiesException | The value of Quantity and the size of Items don't match. |
InvalidArgumentException | An argument is invalid. |
TooManyCachePoliciesException | You have reached the maximum number of cache policies for this Amazon Web Services account. For more information, see Quotas (formerly known as limits) in the Amazon CloudFront Developer Guide. |
TooManyCookiesInCachePolicyException | The number of cookies in the cache policy exceeds the maximum. For more information, see Quotas (formerly known as limits) in the Amazon CloudFront Developer Guide. |
TooManyHeadersInCachePolicyException | The number of headers in the cache policy exceeds the maximum. For more information, see Quotas (formerly known as limits) in the Amazon CloudFront Developer Guide. |
TooManyQueryStringsInCachePolicyException | The number of query strings in the cache policy exceeds the maximum. For more information, see Quotas (formerly known as limits) in the Amazon CloudFront Developer Guide. |
.NET Core App:
Supported in: 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.5