@aws-sdk/client-cloudfront 3.231.0 → 3.233.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist-types/CloudFront.d.ts +242 -244
- package/dist-types/CloudFrontClient.d.ts +1 -1
- package/dist-types/commands/AssociateAliasCommand.d.ts +2 -2
- package/dist-types/commands/CopyDistributionCommand.d.ts +2 -2
- package/dist-types/commands/CreateCachePolicyCommand.d.ts +10 -10
- package/dist-types/commands/CreateContinuousDeploymentPolicyCommand.d.ts +5 -5
- package/dist-types/commands/CreateFunctionCommand.d.ts +5 -5
- package/dist-types/commands/CreateInvalidationCommand.d.ts +1 -1
- package/dist-types/commands/CreateKeyGroupCommand.d.ts +1 -1
- package/dist-types/commands/CreateMonitoringSubscriptionCommand.d.ts +1 -1
- package/dist-types/commands/CreateOriginAccessControlCommand.d.ts +2 -2
- package/dist-types/commands/CreateOriginRequestPolicyCommand.d.ts +11 -11
- package/dist-types/commands/CreateRealtimeLogConfigCommand.d.ts +2 -2
- package/dist-types/commands/CreateResponseHeadersPolicyCommand.d.ts +3 -3
- package/dist-types/commands/DeleteCachePolicyCommand.d.ts +2 -2
- package/dist-types/commands/DeleteCloudFrontOriginAccessIdentityCommand.d.ts +1 -1
- package/dist-types/commands/DeleteContinuousDeploymentPolicyCommand.d.ts +1 -1
- package/dist-types/commands/DeleteDistributionCommand.d.ts +1 -1
- package/dist-types/commands/DeleteFunctionCommand.d.ts +2 -2
- package/dist-types/commands/DeleteKeyGroupCommand.d.ts +2 -2
- package/dist-types/commands/DeleteOriginAccessControlCommand.d.ts +1 -1
- package/dist-types/commands/DeleteOriginRequestPolicyCommand.d.ts +2 -2
- package/dist-types/commands/DeleteRealtimeLogConfigCommand.d.ts +2 -2
- package/dist-types/commands/DeleteResponseHeadersPolicyCommand.d.ts +3 -3
- package/dist-types/commands/DeleteStreamingDistributionCommand.d.ts +19 -20
- package/dist-types/commands/DescribeFunctionCommand.d.ts +3 -3
- package/dist-types/commands/GetCachePolicyCommand.d.ts +7 -7
- package/dist-types/commands/GetCachePolicyConfigCommand.d.ts +2 -2
- package/dist-types/commands/GetCloudFrontOriginAccessIdentityCommand.d.ts +1 -1
- package/dist-types/commands/GetCloudFrontOriginAccessIdentityConfigCommand.d.ts +1 -1
- package/dist-types/commands/GetContinuousDeploymentPolicyCommand.d.ts +1 -1
- package/dist-types/commands/GetDistributionConfigCommand.d.ts +1 -1
- package/dist-types/commands/GetFunctionCommand.d.ts +1 -1
- package/dist-types/commands/GetInvalidationCommand.d.ts +1 -1
- package/dist-types/commands/GetKeyGroupCommand.d.ts +2 -2
- package/dist-types/commands/GetKeyGroupConfigCommand.d.ts +2 -2
- package/dist-types/commands/GetOriginRequestPolicyCommand.d.ts +8 -8
- package/dist-types/commands/GetOriginRequestPolicyConfigCommand.d.ts +3 -3
- package/dist-types/commands/GetRealtimeLogConfigCommand.d.ts +1 -1
- package/dist-types/commands/GetResponseHeadersPolicyCommand.d.ts +4 -4
- package/dist-types/commands/GetResponseHeadersPolicyConfigCommand.d.ts +3 -3
- package/dist-types/commands/GetStreamingDistributionConfigCommand.d.ts +1 -1
- package/dist-types/commands/ListCachePoliciesCommand.d.ts +2 -2
- package/dist-types/commands/ListConflictingAliasesCommand.d.ts +4 -4
- package/dist-types/commands/ListContinuousDeploymentPoliciesCommand.d.ts +1 -1
- package/dist-types/commands/ListDistributionsByCachePolicyIdCommand.d.ts +2 -2
- package/dist-types/commands/ListDistributionsByKeyGroupCommand.d.ts +1 -1
- package/dist-types/commands/ListDistributionsByOriginRequestPolicyIdCommand.d.ts +2 -2
- package/dist-types/commands/ListDistributionsByRealtimeLogConfigCommand.d.ts +4 -4
- package/dist-types/commands/ListDistributionsByResponseHeadersPolicyIdCommand.d.ts +2 -2
- package/dist-types/commands/ListFunctionsCommand.d.ts +2 -2
- package/dist-types/commands/ListInvalidationsCommand.d.ts +1 -1
- package/dist-types/commands/ListKeyGroupsCommand.d.ts +1 -1
- package/dist-types/commands/ListOriginAccessControlsCommand.d.ts +1 -1
- package/dist-types/commands/ListOriginRequestPoliciesCommand.d.ts +2 -2
- package/dist-types/commands/ListRealtimeLogConfigsCommand.d.ts +2 -2
- package/dist-types/commands/ListResponseHeadersPoliciesCommand.d.ts +2 -2
- package/dist-types/commands/ListStreamingDistributionsCommand.d.ts +1 -1
- package/dist-types/commands/PublishFunctionCommand.d.ts +3 -3
- package/dist-types/commands/TestFunctionCommand.d.ts +4 -4
- package/dist-types/commands/UpdateCachePolicyCommand.d.ts +9 -9
- package/dist-types/commands/UpdateCloudFrontOriginAccessIdentityCommand.d.ts +1 -1
- package/dist-types/commands/UpdateContinuousDeploymentPolicyCommand.d.ts +9 -9
- package/dist-types/commands/UpdateDistributionCommand.d.ts +15 -16
- package/dist-types/commands/UpdateDistributionWithStagingConfigCommand.d.ts +4 -4
- package/dist-types/commands/UpdateFieldLevelEncryptionConfigCommand.d.ts +1 -1
- package/dist-types/commands/UpdateFieldLevelEncryptionProfileCommand.d.ts +1 -1
- package/dist-types/commands/UpdateFunctionCommand.d.ts +3 -3
- package/dist-types/commands/UpdateKeyGroupCommand.d.ts +9 -9
- package/dist-types/commands/UpdateOriginRequestPolicyCommand.d.ts +9 -9
- package/dist-types/commands/UpdateRealtimeLogConfigCommand.d.ts +10 -10
- package/dist-types/commands/UpdateResponseHeadersPolicyCommand.d.ts +9 -9
- package/dist-types/commands/UpdateStreamingDistributionCommand.d.ts +1 -1
- package/dist-types/models/models_0.d.ts +667 -674
- package/dist-types/models/models_1.d.ts +191 -191
- package/package.json +1 -1
|
@@ -110,7 +110,7 @@ export interface ActiveTrustedSigners {
|
|
|
110
110
|
}
|
|
111
111
|
/**
|
|
112
112
|
* <p>A complex type that contains information about CNAMEs (alternate domain names), if
|
|
113
|
-
* any, for this distribution
|
|
113
|
+
* any, for this distribution.</p>
|
|
114
114
|
*/
|
|
115
115
|
export interface Aliases {
|
|
116
116
|
/**
|
|
@@ -135,40 +135,40 @@ export declare enum ICPRecordalStatus {
|
|
|
135
135
|
* as a CNAME, that they've added to CloudFront. AliasICPRecordal provides the ICP recordal
|
|
136
136
|
* status for CNAMEs associated with distributions. The status is returned in the CloudFront
|
|
137
137
|
* response; you can't configure it yourself.</p>
|
|
138
|
-
*
|
|
138
|
+
* <p>For more information about ICP recordals, see <a href="https://docs.amazonaws.cn/en_us/aws/latest/userguide/accounts-and-credentials.html"> Signup, Accounts, and Credentials</a> in <i>Getting Started with Amazon Web Services
|
|
139
139
|
* services in China</i>.</p>
|
|
140
140
|
*/
|
|
141
141
|
export interface AliasICPRecordal {
|
|
142
142
|
/**
|
|
143
|
-
* <p>A domain name associated with a distribution
|
|
143
|
+
* <p>A domain name associated with a distribution.</p>
|
|
144
144
|
*/
|
|
145
145
|
CNAME?: string;
|
|
146
146
|
/**
|
|
147
147
|
* <p>The Internet Content Provider (ICP) recordal status for a CNAME. The ICPRecordalStatus
|
|
148
|
-
* is set to APPROVED for all CNAMEs (aliases) in regions outside of China
|
|
149
|
-
*
|
|
150
|
-
*
|
|
148
|
+
* is set to APPROVED for all CNAMEs (aliases) in regions outside of China.</p>
|
|
149
|
+
* <p>The status values returned are the following:</p>
|
|
150
|
+
* <ul>
|
|
151
151
|
* <li>
|
|
152
|
-
*
|
|
152
|
+
* <p>
|
|
153
153
|
* <b>APPROVED</b> indicates that the associated CNAME
|
|
154
154
|
* has a valid ICP recordal number. Multiple CNAMEs can be associated with a
|
|
155
155
|
* distribution, and CNAMEs can correspond to different ICP recordals. To be marked
|
|
156
156
|
* as APPROVED, that is, valid to use with China region, a CNAME must have one ICP
|
|
157
157
|
* recordal number associated with it.</p>
|
|
158
|
-
*
|
|
158
|
+
* </li>
|
|
159
159
|
* <li>
|
|
160
|
-
*
|
|
160
|
+
* <p>
|
|
161
161
|
* <b>SUSPENDED</b> indicates that the associated CNAME
|
|
162
162
|
* does not have a valid ICP recordal number.</p>
|
|
163
|
-
*
|
|
163
|
+
* </li>
|
|
164
164
|
* <li>
|
|
165
|
-
*
|
|
165
|
+
* <p>
|
|
166
166
|
* <b>PENDING</b> indicates that CloudFront can't determine
|
|
167
167
|
* the ICP recordal status of the CNAME associated with the distribution because
|
|
168
168
|
* there was an error in trying to determine the status. You can try again to see
|
|
169
169
|
* if the error is resolved in which case CloudFront returns an APPROVED or SUSPENDED
|
|
170
170
|
* status.</p>
|
|
171
|
-
*
|
|
171
|
+
* </li>
|
|
172
172
|
* </ul>
|
|
173
173
|
*/
|
|
174
174
|
ICPRecordalStatus?: ICPRecordalStatus | string;
|
|
@@ -185,19 +185,19 @@ export declare enum Method {
|
|
|
185
185
|
/**
|
|
186
186
|
* <p>A complex type that controls whether CloudFront caches the response to requests using the
|
|
187
187
|
* specified HTTP methods. There are two choices:</p>
|
|
188
|
-
*
|
|
188
|
+
* <ul>
|
|
189
189
|
* <li>
|
|
190
|
-
*
|
|
190
|
+
* <p>CloudFront caches responses to <code>GET</code> and <code>HEAD</code>
|
|
191
191
|
* requests.</p>
|
|
192
|
-
*
|
|
192
|
+
* </li>
|
|
193
193
|
* <li>
|
|
194
|
-
*
|
|
194
|
+
* <p>CloudFront caches responses to <code>GET</code>, <code>HEAD</code>, and
|
|
195
195
|
* <code>OPTIONS</code> requests.</p>
|
|
196
|
-
*
|
|
196
|
+
* </li>
|
|
197
197
|
* </ul>
|
|
198
|
-
*
|
|
198
|
+
* <p>If you pick the second choice for your Amazon S3 Origin, you may need to forward
|
|
199
199
|
* Access-Control-Request-Method, Access-Control-Request-Headers, and Origin headers for
|
|
200
|
-
* the responses to be cached correctly
|
|
200
|
+
* the responses to be cached correctly.</p>
|
|
201
201
|
*/
|
|
202
202
|
export interface CachedMethods {
|
|
203
203
|
/**
|
|
@@ -216,20 +216,20 @@ export interface CachedMethods {
|
|
|
216
216
|
/**
|
|
217
217
|
* <p>A complex type that controls which HTTP methods CloudFront processes and forwards to your
|
|
218
218
|
* Amazon S3 bucket or your custom origin. There are three choices:</p>
|
|
219
|
-
*
|
|
219
|
+
* <ul>
|
|
220
220
|
* <li>
|
|
221
|
-
*
|
|
222
|
-
*
|
|
221
|
+
* <p>CloudFront forwards only <code>GET</code> and <code>HEAD</code> requests.</p>
|
|
222
|
+
* </li>
|
|
223
223
|
* <li>
|
|
224
|
-
*
|
|
224
|
+
* <p>CloudFront forwards only <code>GET</code>, <code>HEAD</code>, and
|
|
225
225
|
* <code>OPTIONS</code> requests.</p>
|
|
226
|
-
*
|
|
226
|
+
* </li>
|
|
227
227
|
* <li>
|
|
228
|
-
*
|
|
228
|
+
* <p>CloudFront forwards <code>GET, HEAD, OPTIONS, PUT, PATCH, POST</code>, and
|
|
229
229
|
* <code>DELETE</code> requests.</p>
|
|
230
|
-
*
|
|
230
|
+
* </li>
|
|
231
231
|
* </ul>
|
|
232
|
-
*
|
|
232
|
+
* <p>If you pick the third choice, you may need to restrict access to your Amazon S3 bucket or
|
|
233
233
|
* to your custom origin so users can't perform operations that you don't want them to. For
|
|
234
234
|
* example, you might not want users to have permissions to delete objects from your
|
|
235
235
|
* origin.</p>
|
|
@@ -250,25 +250,25 @@ export interface AllowedMethods {
|
|
|
250
250
|
/**
|
|
251
251
|
* <p>A complex type that controls whether CloudFront caches the response to requests using the
|
|
252
252
|
* specified HTTP methods. There are two choices:</p>
|
|
253
|
-
*
|
|
253
|
+
* <ul>
|
|
254
254
|
* <li>
|
|
255
|
-
*
|
|
255
|
+
* <p>CloudFront caches responses to <code>GET</code> and <code>HEAD</code>
|
|
256
256
|
* requests.</p>
|
|
257
|
-
*
|
|
257
|
+
* </li>
|
|
258
258
|
* <li>
|
|
259
|
-
*
|
|
259
|
+
* <p>CloudFront caches responses to <code>GET</code>, <code>HEAD</code>, and
|
|
260
260
|
* <code>OPTIONS</code> requests.</p>
|
|
261
|
-
*
|
|
261
|
+
* </li>
|
|
262
262
|
* </ul>
|
|
263
|
-
*
|
|
263
|
+
* <p>If you pick the second choice for your Amazon S3 Origin, you may need to forward
|
|
264
264
|
* Access-Control-Request-Method, Access-Control-Request-Headers, and Origin headers for
|
|
265
|
-
* the responses to be cached correctly
|
|
265
|
+
* the responses to be cached correctly.</p>
|
|
266
266
|
*/
|
|
267
267
|
CachedMethods?: CachedMethods;
|
|
268
268
|
}
|
|
269
269
|
export interface AssociateAliasRequest {
|
|
270
270
|
/**
|
|
271
|
-
* <p>The ID of the distribution that you
|
|
271
|
+
* <p>The ID of the distribution that you're associating the alias with.</p>
|
|
272
272
|
*/
|
|
273
273
|
TargetDistributionId: string | undefined;
|
|
274
274
|
/**
|
|
@@ -357,12 +357,12 @@ export interface CookieNames {
|
|
|
357
357
|
/**
|
|
358
358
|
* <p>This field is deprecated. We recommend that you use a cache policy or an origin
|
|
359
359
|
* request policy instead of this field.</p>
|
|
360
|
-
*
|
|
360
|
+
* <p>If you want to include cookies in the cache key, use <code>CookiesConfig</code> in a
|
|
361
361
|
* cache policy. See <code>CachePolicy</code>.</p>
|
|
362
|
-
*
|
|
362
|
+
* <p>If you want to send cookies to the origin but not include them in the cache key, use
|
|
363
363
|
* <code>CookiesConfig</code> in an origin request policy. See
|
|
364
364
|
* <code>OriginRequestPolicy</code>.</p>
|
|
365
|
-
*
|
|
365
|
+
* <p>A complex type that specifies whether you want CloudFront to forward cookies to the origin
|
|
366
366
|
* and, if so, which ones. For more information about forwarding cookies to the origin, see
|
|
367
367
|
* <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Cookies.html">Caching Content Based on
|
|
368
368
|
* Cookies</a> in the <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
@@ -371,36 +371,36 @@ export interface CookiePreference {
|
|
|
371
371
|
/**
|
|
372
372
|
* <p>This field is deprecated. We recommend that you use a cache policy or an origin
|
|
373
373
|
* request policy instead of this field.</p>
|
|
374
|
-
*
|
|
374
|
+
* <p>If you want to include cookies in the cache key, use a cache policy. For more
|
|
375
375
|
* information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-key-create-cache-policy">Creating cache policies</a> in the <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
376
|
-
*
|
|
376
|
+
* <p>If you want to send cookies to the origin but not include them in the cache key, use
|
|
377
377
|
* origin request policy. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-origin-requests.html#origin-request-create-origin-request-policy">Creating origin request policies</a> in the
|
|
378
378
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
379
|
-
*
|
|
379
|
+
* <p>Specifies which cookies to forward to the origin for this cache behavior: all, none,
|
|
380
380
|
* or the list of cookies specified in the <code>WhitelistedNames</code> complex
|
|
381
381
|
* type.</p>
|
|
382
|
-
*
|
|
382
|
+
* <p>Amazon S3 doesn't process cookies. When the cache behavior is forwarding requests to an
|
|
383
383
|
* Amazon S3 origin, specify none for the <code>Forward</code> element.</p>
|
|
384
384
|
*/
|
|
385
385
|
Forward: ItemSelection | string | undefined;
|
|
386
386
|
/**
|
|
387
387
|
* <p>This field is deprecated. We recommend that you use a cache policy or an origin
|
|
388
388
|
* request policy instead of this field.</p>
|
|
389
|
-
*
|
|
389
|
+
* <p>If you want to include cookies in the cache key, use a cache policy. For more
|
|
390
390
|
* information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-key-create-cache-policy">Creating cache policies</a> in the <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
391
|
-
*
|
|
391
|
+
* <p>If you want to send cookies to the origin but not include them in the cache key, use
|
|
392
392
|
* an origin request policy. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-origin-requests.html#origin-request-create-origin-request-policy">Creating origin request policies</a> in the
|
|
393
393
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
394
|
-
*
|
|
394
|
+
* <p>Required if you specify <code>whitelist</code> for the value of <code>Forward</code>.
|
|
395
395
|
* A complex type that specifies how many different cookies you want CloudFront to forward to the
|
|
396
396
|
* origin for this cache behavior and, if you want to forward selected cookies, the names
|
|
397
397
|
* of those cookies.</p>
|
|
398
|
-
*
|
|
398
|
+
* <p>If you specify <code>all</code> or <code>none</code> for the value of
|
|
399
399
|
* <code>Forward</code>, omit <code>WhitelistedNames</code>. If you change the value of
|
|
400
400
|
* <code>Forward</code> from <code>whitelist</code> to <code>all</code> or
|
|
401
401
|
* <code>none</code> and you don't delete the <code>WhitelistedNames</code> element and
|
|
402
402
|
* its child elements, CloudFront deletes them automatically.</p>
|
|
403
|
-
*
|
|
403
|
+
* <p>For the current limit on the number of cookie names that you can whitelist for each
|
|
404
404
|
* cache behavior, see <a href="https://docs.aws.amazon.com/general/latest/gr/xrefaws_service_limits.html#limits_cloudfront"> CloudFront
|
|
405
405
|
* Limits</a> in the <i>Amazon Web Services General Reference</i>.</p>
|
|
406
406
|
*/
|
|
@@ -422,14 +422,14 @@ export interface Headers {
|
|
|
422
422
|
/**
|
|
423
423
|
* <p>This field is deprecated. We recommend that you use a cache policy or an origin
|
|
424
424
|
* request policy instead of this field.</p>
|
|
425
|
-
*
|
|
425
|
+
* <p>If you want to include query strings in the cache key, use
|
|
426
426
|
* <code>QueryStringsConfig</code> in a cache policy. See
|
|
427
427
|
* <code>CachePolicy</code>.</p>
|
|
428
|
-
*
|
|
428
|
+
* <p>If you want to send query strings to the origin but not include them in the cache key,
|
|
429
429
|
* use <code>QueryStringsConfig</code> in an origin request policy. See
|
|
430
430
|
* <code>OriginRequestPolicy</code>.</p>
|
|
431
|
-
*
|
|
432
|
-
* want CloudFront to use for caching for a cache behavior
|
|
431
|
+
* <p>A complex type that contains information about the query string parameters that you
|
|
432
|
+
* want CloudFront to use for caching for a cache behavior.</p>
|
|
433
433
|
*/
|
|
434
434
|
export interface QueryStringCacheKeys {
|
|
435
435
|
/**
|
|
@@ -440,46 +440,46 @@ export interface QueryStringCacheKeys {
|
|
|
440
440
|
/**
|
|
441
441
|
* <p>A list that contains the query string parameters that you want CloudFront to use as a basis
|
|
442
442
|
* for caching for a cache behavior. If <code>Quantity</code> is 0, you can omit
|
|
443
|
-
* <code>Items</code
|
|
443
|
+
* <code>Items</code>.</p>
|
|
444
444
|
*/
|
|
445
445
|
Items?: string[];
|
|
446
446
|
}
|
|
447
447
|
/**
|
|
448
448
|
* <p>This field is deprecated. We recommend that you use a cache policy or an origin
|
|
449
449
|
* request policy instead of this field.</p>
|
|
450
|
-
*
|
|
450
|
+
* <p>If you want to include values in the cache key, use a cache policy. For more
|
|
451
451
|
* information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-key-create-cache-policy">Creating cache policies</a> in the <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
452
|
-
*
|
|
452
|
+
* <p>If you want to send values to the origin but not include them in the cache key, use an
|
|
453
453
|
* origin request policy. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-origin-requests.html#origin-request-create-origin-request-policy">Creating origin request policies</a> in the
|
|
454
454
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
455
|
-
*
|
|
455
|
+
* <p>A complex type that specifies how CloudFront handles query strings, cookies, and HTTP
|
|
456
456
|
* headers.</p>
|
|
457
457
|
*/
|
|
458
458
|
export interface ForwardedValues {
|
|
459
459
|
/**
|
|
460
460
|
* <p>This field is deprecated. We recommend that you use a cache policy or an origin
|
|
461
461
|
* request policy instead of this field.</p>
|
|
462
|
-
*
|
|
462
|
+
* <p>If you want to include query strings in the cache key, use a cache policy. For more
|
|
463
463
|
* information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-key-create-cache-policy">Creating cache policies</a> in the <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
464
|
-
*
|
|
464
|
+
* <p>If you want to send query strings to the origin but not include them in the cache key,
|
|
465
465
|
* use an origin request policy. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-origin-requests.html#origin-request-create-origin-request-policy">Creating origin request policies</a> in the
|
|
466
466
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
467
|
-
*
|
|
467
|
+
* <p>Indicates whether you want CloudFront to forward query strings to the origin that is
|
|
468
468
|
* associated with this cache behavior and cache based on the query string parameters. CloudFront
|
|
469
469
|
* behavior depends on the value of <code>QueryString</code> and on the values that you
|
|
470
470
|
* specify for <code>QueryStringCacheKeys</code>, if any:</p>
|
|
471
|
-
*
|
|
471
|
+
* <p>If you specify true for <code>QueryString</code> and you don't specify any values for
|
|
472
472
|
* <code>QueryStringCacheKeys</code>, CloudFront forwards all query string parameters to the
|
|
473
473
|
* origin and caches based on all query string parameters. Depending on how many query
|
|
474
474
|
* string parameters and values you have, this can adversely affect performance because
|
|
475
475
|
* CloudFront must forward more requests to the origin.</p>
|
|
476
|
-
*
|
|
476
|
+
* <p>If you specify true for <code>QueryString</code> and you specify one or more values
|
|
477
477
|
* for <code>QueryStringCacheKeys</code>, CloudFront forwards all query string parameters to the
|
|
478
478
|
* origin, but it only caches based on the query string parameters that you specify.</p>
|
|
479
|
-
*
|
|
479
|
+
* <p>If you specify false for <code>QueryString</code>, CloudFront doesn't forward any query
|
|
480
480
|
* string parameters to the origin, and doesn't cache based on query string
|
|
481
481
|
* parameters.</p>
|
|
482
|
-
*
|
|
482
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/QueryStringParameters.html">Configuring
|
|
483
483
|
* CloudFront to Cache Based on Query String Parameters</a> in the
|
|
484
484
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
485
485
|
*/
|
|
@@ -487,12 +487,12 @@ export interface ForwardedValues {
|
|
|
487
487
|
/**
|
|
488
488
|
* <p>This field is deprecated. We recommend that you use a cache policy or an origin
|
|
489
489
|
* request policy instead of this field.</p>
|
|
490
|
-
*
|
|
490
|
+
* <p>If you want to include cookies in the cache key, use a cache policy. For more
|
|
491
491
|
* information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-key-create-cache-policy">Creating cache policies</a> in the <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
492
|
-
*
|
|
492
|
+
* <p>If you want to send cookies to the origin but not include them in the cache key, use
|
|
493
493
|
* an origin request policy. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-origin-requests.html#origin-request-create-origin-request-policy">Creating origin request policies</a> in the
|
|
494
494
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
495
|
-
*
|
|
495
|
+
* <p>A complex type that specifies whether you want CloudFront to forward cookies to the origin
|
|
496
496
|
* and, if so, which ones. For more information about forwarding cookies to the origin, see
|
|
497
497
|
* <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Cookies.html">How CloudFront Forwards, Caches,
|
|
498
498
|
* and Logs Cookies</a> in the <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
@@ -501,28 +501,28 @@ export interface ForwardedValues {
|
|
|
501
501
|
/**
|
|
502
502
|
* <p>This field is deprecated. We recommend that you use a cache policy or an origin
|
|
503
503
|
* request policy instead of this field.</p>
|
|
504
|
-
*
|
|
504
|
+
* <p>If you want to include headers in the cache key, use a cache policy. For more
|
|
505
505
|
* information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-key-create-cache-policy">Creating cache policies</a> in the <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
506
|
-
*
|
|
506
|
+
* <p>If you want to send headers to the origin but not include them in the cache key, use
|
|
507
507
|
* an origin request policy. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-origin-requests.html#origin-request-create-origin-request-policy">Creating origin request policies</a> in the
|
|
508
508
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
509
|
-
*
|
|
509
|
+
* <p>A complex type that specifies the <code>Headers</code>, if any, that you want CloudFront to
|
|
510
510
|
* forward to the origin for this cache behavior (whitelisted headers). For the headers
|
|
511
511
|
* that you specify, CloudFront also caches separate versions of a specified object that is based
|
|
512
512
|
* on the header values in viewer requests.</p>
|
|
513
|
-
*
|
|
513
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/header-caching.html"> Caching Content
|
|
514
514
|
* Based on Request Headers</a> in the <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
515
515
|
*/
|
|
516
516
|
Headers?: Headers;
|
|
517
517
|
/**
|
|
518
518
|
* <p>This field is deprecated. We recommend that you use a cache policy or an origin
|
|
519
519
|
* request policy instead of this field.</p>
|
|
520
|
-
*
|
|
520
|
+
* <p>If you want to include query strings in the cache key, use a cache policy. For more
|
|
521
521
|
* information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-key-create-cache-policy">Creating cache policies</a> in the <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
522
|
-
*
|
|
522
|
+
* <p>If you want to send query strings to the origin but not include them in the cache key,
|
|
523
523
|
* use an origin request policy. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-origin-requests.html#origin-request-create-origin-request-policy">Creating origin request policies</a> in the
|
|
524
524
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
525
|
-
*
|
|
525
|
+
* <p>A complex type that contains information about the query string parameters that you
|
|
526
526
|
* want CloudFront to use for caching for this cache behavior.</p>
|
|
527
527
|
*/
|
|
528
528
|
QueryStringCacheKeys?: QueryStringCacheKeys;
|
|
@@ -579,33 +579,33 @@ export interface LambdaFunctionAssociation {
|
|
|
579
579
|
/**
|
|
580
580
|
* <p>Specifies the event type that triggers a Lambda@Edge function invocation. You can
|
|
581
581
|
* specify the following values:</p>
|
|
582
|
-
*
|
|
582
|
+
* <ul>
|
|
583
583
|
* <li>
|
|
584
|
-
*
|
|
584
|
+
* <p>
|
|
585
585
|
* <code>viewer-request</code>: The function executes when CloudFront receives a
|
|
586
586
|
* request from a viewer and before it checks to see whether the requested object
|
|
587
|
-
* is in the edge cache
|
|
588
|
-
*
|
|
587
|
+
* is in the edge cache.</p>
|
|
588
|
+
* </li>
|
|
589
589
|
* <li>
|
|
590
|
-
*
|
|
590
|
+
* <p>
|
|
591
591
|
* <code>origin-request</code>: The function executes only when CloudFront sends a
|
|
592
592
|
* request to your origin. When the requested object is in the edge cache, the
|
|
593
593
|
* function doesn't execute.</p>
|
|
594
|
-
*
|
|
594
|
+
* </li>
|
|
595
595
|
* <li>
|
|
596
|
-
*
|
|
596
|
+
* <p>
|
|
597
597
|
* <code>origin-response</code>: The function executes after CloudFront receives a
|
|
598
598
|
* response from the origin and before it caches the object in the response. When
|
|
599
599
|
* the requested object is in the edge cache, the function doesn't execute.</p>
|
|
600
|
-
*
|
|
600
|
+
* </li>
|
|
601
601
|
* <li>
|
|
602
|
-
*
|
|
602
|
+
* <p>
|
|
603
603
|
* <code>viewer-response</code>: The function executes before CloudFront returns the
|
|
604
604
|
* requested object to the viewer. The function executes regardless of whether the
|
|
605
605
|
* object was already in the edge cache.</p>
|
|
606
|
-
*
|
|
606
|
+
* <p>If the origin returns an HTTP status code other than HTTP 200 (OK), the
|
|
607
607
|
* function doesn't execute.</p>
|
|
608
|
-
*
|
|
608
|
+
* </li>
|
|
609
609
|
* </ul>
|
|
610
610
|
*/
|
|
611
611
|
EventType: EventType | string | undefined;
|
|
@@ -619,17 +619,15 @@ export interface LambdaFunctionAssociation {
|
|
|
619
619
|
/**
|
|
620
620
|
* <p>A complex type that specifies a list of Lambda@Edge functions associations for a cache
|
|
621
621
|
* behavior.</p>
|
|
622
|
-
*
|
|
623
|
-
* <p>If you want to invoke one or more Lambda@Edge functions triggered by requests that
|
|
622
|
+
* <p>If you want to invoke one or more Lambda@Edge functions triggered by requests that
|
|
624
623
|
* match the <code>PathPattern</code> of the cache behavior, specify the applicable values
|
|
625
624
|
* for <code>Quantity</code> and <code>Items</code>. Note that there can be up to 4
|
|
626
625
|
* <code>LambdaFunctionAssociation</code> items in this list (one for each possible
|
|
627
626
|
* value of <code>EventType</code>) and each <code>EventType</code> can be associated with
|
|
628
627
|
* only one function.</p>
|
|
629
|
-
*
|
|
630
|
-
* <p>If you don't want to invoke any Lambda@Edge functions for the requests that match
|
|
628
|
+
* <p>If you don't want to invoke any Lambda@Edge functions for the requests that match
|
|
631
629
|
* <code>PathPattern</code>, specify <code>0</code> for <code>Quantity</code> and omit
|
|
632
|
-
* <code>Items</code
|
|
630
|
+
* <code>Items</code>.</p>
|
|
633
631
|
*/
|
|
634
632
|
export interface LambdaFunctionAssociations {
|
|
635
633
|
/**
|
|
@@ -691,24 +689,24 @@ export declare enum ViewerProtocolPolicy {
|
|
|
691
689
|
}
|
|
692
690
|
/**
|
|
693
691
|
* <p>A complex type that describes how CloudFront processes requests.</p>
|
|
694
|
-
*
|
|
692
|
+
* <p>You must create at least as many cache behaviors (including the default cache
|
|
695
693
|
* behavior) as you have origins if you want CloudFront to serve objects from all of the origins.
|
|
696
694
|
* Each cache behavior specifies the one origin from which you want CloudFront to get objects. If
|
|
697
695
|
* you have two origins and only the default cache behavior, the default cache behavior
|
|
698
696
|
* will cause CloudFront to get objects from one of the origins, but the other origin is never
|
|
699
697
|
* used.</p>
|
|
700
|
-
*
|
|
698
|
+
* <p>For the current quota (formerly known as limit) on the number of cache behaviors that
|
|
701
699
|
* you can add to a distribution, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/cloudfront-limits.html">Quotas</a> in the
|
|
702
700
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
703
|
-
*
|
|
704
|
-
* <code>CacheBehaviors</code> element. Don
|
|
701
|
+
* <p>If you don't want to specify any cache behaviors, include only an empty
|
|
702
|
+
* <code>CacheBehaviors</code> element. Don't include an empty
|
|
705
703
|
* <code>CacheBehavior</code> element because this is invalid.</p>
|
|
706
|
-
*
|
|
704
|
+
* <p>To delete all cache behaviors in an existing distribution, update the distribution
|
|
707
705
|
* configuration and include only an empty <code>CacheBehaviors</code> element.</p>
|
|
708
|
-
*
|
|
706
|
+
* <p>To add, change, or remove one or more cache behaviors, update the distribution
|
|
709
707
|
* configuration and specify all of the cache behaviors that you want to include in the
|
|
710
708
|
* updated distribution.</p>
|
|
711
|
-
*
|
|
709
|
+
* <p>For more information about cache behaviors, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-values-specify.html#DownloadDistValuesCacheBehavior">Cache Behavior Settings</a> in the <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
712
710
|
*/
|
|
713
711
|
export interface CacheBehavior {
|
|
714
712
|
/**
|
|
@@ -716,15 +714,15 @@ export interface CacheBehavior {
|
|
|
716
714
|
* apply the behavior to. When CloudFront receives a viewer request, the requested path is
|
|
717
715
|
* compared with path patterns in the order in which cache behaviors are listed in the
|
|
718
716
|
* distribution.</p>
|
|
719
|
-
*
|
|
720
|
-
*
|
|
717
|
+
* <note>
|
|
718
|
+
* <p>You can optionally include a slash (<code>/</code>) at the beginning of the path
|
|
721
719
|
* pattern. For example, <code>/images/*.jpg</code>. CloudFront behavior is the same with or
|
|
722
720
|
* without the leading <code>/</code>.</p>
|
|
723
|
-
*
|
|
724
|
-
*
|
|
721
|
+
* </note>
|
|
722
|
+
* <p>The path pattern for the default cache behavior is <code>*</code> and cannot be
|
|
725
723
|
* changed. If the request for an object does not match the path pattern for any cache
|
|
726
724
|
* behaviors, CloudFront applies the behavior in the default cache behavior.</p>
|
|
727
|
-
*
|
|
725
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-values-specify.html#DownloadDistValuesPathPattern">Path Pattern</a> in the <i> Amazon CloudFront Developer Guide</i>.</p>
|
|
728
726
|
*/
|
|
729
727
|
PathPattern: string | undefined;
|
|
730
728
|
/**
|
|
@@ -734,14 +732,14 @@ export interface CacheBehavior {
|
|
|
734
732
|
TargetOriginId: string | undefined;
|
|
735
733
|
/**
|
|
736
734
|
* <important>
|
|
737
|
-
*
|
|
735
|
+
* <p>We recommend using <code>TrustedKeyGroups</code> instead of
|
|
738
736
|
* <code>TrustedSigners</code>.</p>
|
|
739
|
-
*
|
|
740
|
-
*
|
|
737
|
+
* </important>
|
|
738
|
+
* <p>A list of Amazon Web Services account IDs whose public keys CloudFront can use to validate signed URLs or
|
|
741
739
|
* signed cookies.</p>
|
|
742
|
-
*
|
|
740
|
+
* <p>When a cache behavior contains trusted signers, CloudFront requires signed URLs or signed
|
|
743
741
|
* cookies for all requests that match the cache behavior. The URLs or cookies must be
|
|
744
|
-
* signed with the private key of a CloudFront key pair in the trusted signer
|
|
742
|
+
* signed with the private key of a CloudFront key pair in the trusted signer's Amazon Web Services account.
|
|
745
743
|
* The signed URL or cookie contains information about which public key CloudFront should use to
|
|
746
744
|
* verify the signature. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/PrivateContent.html">Serving private content</a> in the
|
|
747
745
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
@@ -750,7 +748,7 @@ export interface CacheBehavior {
|
|
|
750
748
|
/**
|
|
751
749
|
* <p>A list of key groups that CloudFront can use to validate signed URLs or signed
|
|
752
750
|
* cookies.</p>
|
|
753
|
-
*
|
|
751
|
+
* <p>When a cache behavior contains trusted key groups, CloudFront requires signed URLs or signed
|
|
754
752
|
* cookies for all requests that match the cache behavior. The URLs or cookies must be
|
|
755
753
|
* signed with a private key whose corresponding public key is in the key group. The signed
|
|
756
754
|
* URL or cookie contains information about which public key CloudFront should use to verify the
|
|
@@ -762,54 +760,54 @@ export interface CacheBehavior {
|
|
|
762
760
|
* <p>The protocol that viewers can use to access the files in the origin specified by
|
|
763
761
|
* <code>TargetOriginId</code> when a request matches the path pattern in
|
|
764
762
|
* <code>PathPattern</code>. You can specify the following options:</p>
|
|
765
|
-
*
|
|
763
|
+
* <ul>
|
|
766
764
|
* <li>
|
|
767
|
-
*
|
|
765
|
+
* <p>
|
|
768
766
|
* <code>allow-all</code>: Viewers can use HTTP or HTTPS.</p>
|
|
769
|
-
*
|
|
767
|
+
* </li>
|
|
770
768
|
* <li>
|
|
771
|
-
*
|
|
769
|
+
* <p>
|
|
772
770
|
* <code>redirect-to-https</code>: If a viewer submits an HTTP request, CloudFront
|
|
773
771
|
* returns an HTTP status code of 301 (Moved Permanently) to the viewer along with
|
|
774
|
-
* the HTTPS URL. The viewer then resubmits the request using the new URL
|
|
775
|
-
*
|
|
772
|
+
* the HTTPS URL. The viewer then resubmits the request using the new URL.</p>
|
|
773
|
+
* </li>
|
|
776
774
|
* <li>
|
|
777
|
-
*
|
|
775
|
+
* <p>
|
|
778
776
|
* <code>https-only</code>: If a viewer sends an HTTP request, CloudFront returns an
|
|
779
|
-
* HTTP status code of 403 (Forbidden)
|
|
780
|
-
*
|
|
777
|
+
* HTTP status code of 403 (Forbidden).</p>
|
|
778
|
+
* </li>
|
|
781
779
|
* </ul>
|
|
782
|
-
*
|
|
780
|
+
* <p>For more information about requiring the HTTPS protocol, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-https-viewers-to-cloudfront.html">Requiring HTTPS Between Viewers and CloudFront</a> in the
|
|
783
781
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
784
|
-
*
|
|
785
|
-
*
|
|
782
|
+
* <note>
|
|
783
|
+
* <p>The only way to guarantee that viewers retrieve an object that was fetched from
|
|
786
784
|
* the origin using HTTPS is never to use any other protocol to fetch the object. If
|
|
787
785
|
* you have recently changed from HTTP to HTTPS, we recommend that you clear your
|
|
788
|
-
* objects
|
|
786
|
+
* objects' cache because cached objects are protocol agnostic. That means that an edge
|
|
789
787
|
* location will return an object from the cache regardless of whether the current
|
|
790
788
|
* request protocol matches the protocol used previously. For more information, see
|
|
791
789
|
* <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Expiration.html">Managing Cache
|
|
792
790
|
* Expiration</a> in the <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
793
|
-
*
|
|
791
|
+
* </note>
|
|
794
792
|
*/
|
|
795
793
|
ViewerProtocolPolicy: ViewerProtocolPolicy | string | undefined;
|
|
796
794
|
/**
|
|
797
795
|
* <p>A complex type that controls which HTTP methods CloudFront processes and forwards to your
|
|
798
796
|
* Amazon S3 bucket or your custom origin. There are three choices:</p>
|
|
799
|
-
*
|
|
797
|
+
* <ul>
|
|
800
798
|
* <li>
|
|
801
|
-
*
|
|
802
|
-
*
|
|
799
|
+
* <p>CloudFront forwards only <code>GET</code> and <code>HEAD</code> requests.</p>
|
|
800
|
+
* </li>
|
|
803
801
|
* <li>
|
|
804
|
-
*
|
|
802
|
+
* <p>CloudFront forwards only <code>GET</code>, <code>HEAD</code>, and
|
|
805
803
|
* <code>OPTIONS</code> requests.</p>
|
|
806
|
-
*
|
|
804
|
+
* </li>
|
|
807
805
|
* <li>
|
|
808
|
-
*
|
|
806
|
+
* <p>CloudFront forwards <code>GET, HEAD, OPTIONS, PUT, PATCH, POST</code>, and
|
|
809
807
|
* <code>DELETE</code> requests.</p>
|
|
810
|
-
*
|
|
808
|
+
* </li>
|
|
811
809
|
* </ul>
|
|
812
|
-
*
|
|
810
|
+
* <p>If you pick the third choice, you may need to restrict access to your Amazon S3 bucket or
|
|
813
811
|
* to your custom origin so users can't perform operations that you don't want them to. For
|
|
814
812
|
* example, you might not want users to have permissions to delete objects from your
|
|
815
813
|
* origin.</p>
|
|
@@ -821,7 +819,7 @@ export interface CacheBehavior {
|
|
|
821
819
|
* <code>true</code>; if not, specify <code>false</code>. If you specify
|
|
822
820
|
* <code>true</code> for <code>SmoothStreaming</code>, you can still distribute other
|
|
823
821
|
* content using this cache behavior if the content matches the value of
|
|
824
|
-
* <code>PathPattern</code
|
|
822
|
+
* <code>PathPattern</code>.</p>
|
|
825
823
|
*/
|
|
826
824
|
SmoothStreaming?: boolean;
|
|
827
825
|
/**
|
|
@@ -856,7 +854,7 @@ export interface CacheBehavior {
|
|
|
856
854
|
* <p>The unique identifier of the cache policy that is attached to this cache behavior. For
|
|
857
855
|
* more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-key-create-cache-policy">Creating cache policies</a> or <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-cache-policies.html">Using the managed cache policies</a> in the
|
|
858
856
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
859
|
-
*
|
|
857
|
+
* <p>A <code>CacheBehavior</code> must include either a <code>CachePolicyId</code> or
|
|
860
858
|
* <code>ForwardedValues</code>. We recommend that you use a
|
|
861
859
|
* <code>CachePolicyId</code>.</p>
|
|
862
860
|
*/
|
|
@@ -877,16 +875,16 @@ export interface CacheBehavior {
|
|
|
877
875
|
* <p>This field is deprecated. We recommend that you use a cache policy or an origin
|
|
878
876
|
* request policy instead of this field. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/working-with-policies.html">Working with policies</a> in the
|
|
879
877
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
880
|
-
*
|
|
878
|
+
* <p>If you want to include values in the cache key, use a cache policy. For more
|
|
881
879
|
* information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-key-create-cache-policy">Creating cache policies</a> or <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-cache-policies.html">Using the managed cache policies</a> in the
|
|
882
880
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
883
|
-
*
|
|
881
|
+
* <p>If you want to send values to the origin but not include them in the cache key, use an
|
|
884
882
|
* origin request policy. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-origin-requests.html#origin-request-create-origin-request-policy">Creating origin request policies</a> or <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-origin-request-policies.html">Using the managed origin request policies</a> in the
|
|
885
883
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
886
|
-
*
|
|
884
|
+
* <p>A <code>CacheBehavior</code> must include either a <code>CachePolicyId</code> or
|
|
887
885
|
* <code>ForwardedValues</code>. We recommend that you use a
|
|
888
886
|
* <code>CachePolicyId</code>.</p>
|
|
889
|
-
*
|
|
887
|
+
* <p>A complex type that specifies how CloudFront handles query strings, cookies, and HTTP
|
|
890
888
|
* headers.</p>
|
|
891
889
|
*/
|
|
892
890
|
ForwardedValues?: ForwardedValues;
|
|
@@ -896,12 +894,12 @@ export interface CacheBehavior {
|
|
|
896
894
|
* <p>This field is deprecated. We recommend that you use the <code>MinTTL</code> field in a
|
|
897
895
|
* cache policy instead of this field. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-key-create-cache-policy">Creating cache policies</a> or <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-cache-policies.html">Using the managed cache policies</a> in the
|
|
898
896
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
899
|
-
*
|
|
897
|
+
* <p>The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront
|
|
900
898
|
* forwards another request to your origin to determine whether the object has been
|
|
901
899
|
* updated. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Expiration.html"> Managing How Long
|
|
902
900
|
* Content Stays in an Edge Cache (Expiration)</a> in the <i>
|
|
903
901
|
* Amazon CloudFront Developer Guide</i>.</p>
|
|
904
|
-
*
|
|
902
|
+
* <p>You must specify <code>0</code> for <code>MinTTL</code> if you configure CloudFront to
|
|
905
903
|
* forward all headers to your origin (under <code>Headers</code>, if you specify
|
|
906
904
|
* <code>1</code> for <code>Quantity</code> and <code>*</code> for
|
|
907
905
|
* <code>Name</code>).</p>
|
|
@@ -913,7 +911,7 @@ export interface CacheBehavior {
|
|
|
913
911
|
* <p>This field is deprecated. We recommend that you use the <code>DefaultTTL</code> field
|
|
914
912
|
* in a cache policy instead of this field. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-key-create-cache-policy">Creating cache policies</a> or <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-cache-policies.html">Using the managed cache policies</a> in the
|
|
915
913
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
916
|
-
*
|
|
914
|
+
* <p>The default amount of time that you want objects to stay in CloudFront caches before CloudFront
|
|
917
915
|
* forwards another request to your origin to determine whether the object has been
|
|
918
916
|
* updated. The value that you specify applies only when your origin does not add HTTP
|
|
919
917
|
* headers such as <code>Cache-Control max-age</code>, <code>Cache-Control s-maxage</code>,
|
|
@@ -927,7 +925,7 @@ export interface CacheBehavior {
|
|
|
927
925
|
* <p>This field is deprecated. We recommend that you use the <code>MaxTTL</code> field in a
|
|
928
926
|
* cache policy instead of this field. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-key-create-cache-policy">Creating cache policies</a> or <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-cache-policies.html">Using the managed cache policies</a> in the
|
|
929
927
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
930
|
-
*
|
|
928
|
+
* <p>The maximum amount of time that you want objects to stay in CloudFront caches before CloudFront
|
|
931
929
|
* forwards another request to your origin to determine whether the object has been
|
|
932
930
|
* updated. The value that you specify applies only when your origin adds HTTP headers such
|
|
933
931
|
* as <code>Cache-Control max-age</code>, <code>Cache-Control s-maxage</code>, and
|
|
@@ -937,11 +935,11 @@ export interface CacheBehavior {
|
|
|
937
935
|
MaxTTL?: number;
|
|
938
936
|
}
|
|
939
937
|
/**
|
|
940
|
-
* <p>A complex type that contains zero or more <code>CacheBehavior</code> elements
|
|
938
|
+
* <p>A complex type that contains zero or more <code>CacheBehavior</code> elements.</p>
|
|
941
939
|
*/
|
|
942
940
|
export interface CacheBehaviors {
|
|
943
941
|
/**
|
|
944
|
-
* <p>The number of cache behaviors for this distribution
|
|
942
|
+
* <p>The number of cache behaviors for this distribution.</p>
|
|
945
943
|
*/
|
|
946
944
|
Quantity: number | undefined;
|
|
947
945
|
/**
|
|
@@ -966,36 +964,36 @@ export interface CachePolicyCookiesConfig {
|
|
|
966
964
|
* <p>Determines whether any cookies in viewer requests are included in the cache key and
|
|
967
965
|
* automatically included in requests that CloudFront sends to the origin. Valid values
|
|
968
966
|
* are:</p>
|
|
969
|
-
*
|
|
967
|
+
* <ul>
|
|
970
968
|
* <li>
|
|
971
|
-
*
|
|
969
|
+
* <p>
|
|
972
970
|
* <code>none</code> – Cookies in viewer requests are not included in the cache
|
|
973
971
|
* key and are not automatically included in requests that CloudFront sends to the
|
|
974
972
|
* origin. Even when this field is set to <code>none</code>, any cookies that are
|
|
975
973
|
* listed in an <code>OriginRequestPolicy</code>
|
|
976
|
-
*
|
|
977
|
-
*
|
|
974
|
+
* <i>are</i> included in origin requests.</p>
|
|
975
|
+
* </li>
|
|
978
976
|
* <li>
|
|
979
|
-
*
|
|
977
|
+
* <p>
|
|
980
978
|
* <code>whitelist</code> – The cookies in viewer requests that are listed in the
|
|
981
979
|
* <code>CookieNames</code> type are included in the cache key and
|
|
982
980
|
* automatically included in requests that CloudFront sends to the origin.</p>
|
|
983
|
-
*
|
|
981
|
+
* </li>
|
|
984
982
|
* <li>
|
|
985
|
-
*
|
|
983
|
+
* <p>
|
|
986
984
|
* <code>allExcept</code> – All cookies in viewer requests that are
|
|
987
985
|
* <i>
|
|
988
986
|
* <b>not</b>
|
|
989
987
|
* </i> listed in the
|
|
990
988
|
* <code>CookieNames</code> type are included in the cache key and
|
|
991
989
|
* automatically included in requests that CloudFront sends to the origin.</p>
|
|
992
|
-
*
|
|
990
|
+
* </li>
|
|
993
991
|
* <li>
|
|
994
|
-
*
|
|
992
|
+
* <p>
|
|
995
993
|
* <code>all</code> – All cookies in viewer requests are included in the cache
|
|
996
994
|
* key and are automatically included in requests that CloudFront sends to the
|
|
997
995
|
* origin.</p>
|
|
998
|
-
*
|
|
996
|
+
* </li>
|
|
999
997
|
* </ul>
|
|
1000
998
|
*/
|
|
1001
999
|
CookieBehavior: CachePolicyCookieBehavior | string | undefined;
|
|
@@ -1017,21 +1015,21 @@ export interface CachePolicyHeadersConfig {
|
|
|
1017
1015
|
/**
|
|
1018
1016
|
* <p>Determines whether any HTTP headers are included in the cache key and automatically
|
|
1019
1017
|
* included in requests that CloudFront sends to the origin. Valid values are:</p>
|
|
1020
|
-
*
|
|
1018
|
+
* <ul>
|
|
1021
1019
|
* <li>
|
|
1022
|
-
*
|
|
1020
|
+
* <p>
|
|
1023
1021
|
* <code>none</code> – HTTP headers are not included in the cache key and are not
|
|
1024
1022
|
* automatically included in requests that CloudFront sends to the origin. Even when this
|
|
1025
1023
|
* field is set to <code>none</code>, any headers that are listed in an
|
|
1026
1024
|
* <code>OriginRequestPolicy</code>
|
|
1027
|
-
*
|
|
1028
|
-
*
|
|
1025
|
+
* <i>are</i> included in origin requests.</p>
|
|
1026
|
+
* </li>
|
|
1029
1027
|
* <li>
|
|
1030
|
-
*
|
|
1028
|
+
* <p>
|
|
1031
1029
|
* <code>whitelist</code> – The HTTP headers that are listed in the
|
|
1032
1030
|
* <code>Headers</code> type are included in the cache key and are
|
|
1033
1031
|
* automatically included in requests that CloudFront sends to the origin.</p>
|
|
1034
|
-
*
|
|
1032
|
+
* </li>
|
|
1035
1033
|
* </ul>
|
|
1036
1034
|
*/
|
|
1037
1035
|
HeaderBehavior: CachePolicyHeaderBehavior | string | undefined;
|
|
@@ -1069,36 +1067,36 @@ export interface CachePolicyQueryStringsConfig {
|
|
|
1069
1067
|
* <p>Determines whether any URL query strings in viewer requests are included in the cache
|
|
1070
1068
|
* key and automatically included in requests that CloudFront sends to the origin. Valid values
|
|
1071
1069
|
* are:</p>
|
|
1072
|
-
*
|
|
1070
|
+
* <ul>
|
|
1073
1071
|
* <li>
|
|
1074
|
-
*
|
|
1072
|
+
* <p>
|
|
1075
1073
|
* <code>none</code> – Query strings in viewer requests are not included in the
|
|
1076
1074
|
* cache key and are not automatically included in requests that CloudFront sends to the
|
|
1077
1075
|
* origin. Even when this field is set to <code>none</code>, any query strings that
|
|
1078
1076
|
* are listed in an <code>OriginRequestPolicy</code>
|
|
1079
|
-
*
|
|
1080
|
-
*
|
|
1077
|
+
* <i>are</i> included in origin requests.</p>
|
|
1078
|
+
* </li>
|
|
1081
1079
|
* <li>
|
|
1082
|
-
*
|
|
1080
|
+
* <p>
|
|
1083
1081
|
* <code>whitelist</code> – The query strings in viewer requests that are listed
|
|
1084
1082
|
* in the <code>QueryStringNames</code> type are included in the cache key and
|
|
1085
1083
|
* automatically included in requests that CloudFront sends to the origin.</p>
|
|
1086
|
-
*
|
|
1084
|
+
* </li>
|
|
1087
1085
|
* <li>
|
|
1088
|
-
*
|
|
1086
|
+
* <p>
|
|
1089
1087
|
* <code>allExcept</code> – All query strings in viewer requests that are
|
|
1090
1088
|
* <i>
|
|
1091
1089
|
* <b>not</b>
|
|
1092
1090
|
* </i> listed in the
|
|
1093
1091
|
* <code>QueryStringNames</code> type are included in the cache key and
|
|
1094
1092
|
* automatically included in requests that CloudFront sends to the origin.</p>
|
|
1095
|
-
*
|
|
1093
|
+
* </li>
|
|
1096
1094
|
* <li>
|
|
1097
|
-
*
|
|
1095
|
+
* <p>
|
|
1098
1096
|
* <code>all</code> – All query strings in viewer requests are included in the
|
|
1099
1097
|
* cache key and are automatically included in requests that CloudFront sends to the
|
|
1100
1098
|
* origin.</p>
|
|
1101
|
-
*
|
|
1099
|
+
* </li>
|
|
1102
1100
|
* </ul>
|
|
1103
1101
|
*/
|
|
1104
1102
|
QueryStringBehavior: CachePolicyQueryStringBehavior | string | undefined;
|
|
@@ -1126,9 +1124,9 @@ export interface CachePolicyQueryStringsConfig {
|
|
|
1126
1124
|
* <p>This object determines the values that CloudFront includes in the cache key. These values
|
|
1127
1125
|
* can include HTTP headers, cookies, and URL query strings. CloudFront uses the cache key to
|
|
1128
1126
|
* find an object in its cache that it can return to the viewer.</p>
|
|
1129
|
-
*
|
|
1127
|
+
* <p>The headers, cookies, and query strings that are included in the cache key are
|
|
1130
1128
|
* automatically included in requests that CloudFront sends to the origin. CloudFront sends a request
|
|
1131
|
-
* when it can
|
|
1129
|
+
* when it can't find an object in its cache that matches the request's cache key. If you
|
|
1132
1130
|
* want to send values to the origin but <i>not</i> include them in the cache
|
|
1133
1131
|
* key, use <code>OriginRequestPolicy</code>.</p>
|
|
1134
1132
|
*/
|
|
@@ -1136,33 +1134,33 @@ export interface ParametersInCacheKeyAndForwardedToOrigin {
|
|
|
1136
1134
|
/**
|
|
1137
1135
|
* <p>A flag that can affect whether the <code>Accept-Encoding</code> HTTP header is
|
|
1138
1136
|
* included in the cache key and included in requests that CloudFront sends to the origin.</p>
|
|
1139
|
-
*
|
|
1137
|
+
* <p>This field is related to the <code>EnableAcceptEncodingBrotli</code> field. If one or
|
|
1140
1138
|
* both of these fields is <code>true</code>
|
|
1141
|
-
*
|
|
1139
|
+
* <i>and</i> the viewer request includes the <code>Accept-Encoding</code>
|
|
1142
1140
|
* header, then CloudFront does the following:</p>
|
|
1143
|
-
*
|
|
1141
|
+
* <ul>
|
|
1144
1142
|
* <li>
|
|
1145
|
-
*
|
|
1143
|
+
* <p>Normalizes the value of the viewer's <code>Accept-Encoding</code>
|
|
1146
1144
|
* header</p>
|
|
1147
|
-
*
|
|
1145
|
+
* </li>
|
|
1148
1146
|
* <li>
|
|
1149
|
-
*
|
|
1150
|
-
*
|
|
1147
|
+
* <p>Includes the normalized header in the cache key</p>
|
|
1148
|
+
* </li>
|
|
1151
1149
|
* <li>
|
|
1152
|
-
*
|
|
1150
|
+
* <p>Includes the normalized header in the request to the origin, if a request is
|
|
1153
1151
|
* necessary</p>
|
|
1154
|
-
*
|
|
1152
|
+
* </li>
|
|
1155
1153
|
* </ul>
|
|
1156
|
-
*
|
|
1154
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-policy-compressed-objects">Compression support</a> in the
|
|
1157
1155
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
1158
|
-
*
|
|
1156
|
+
* <p>If you set this value to <code>true</code>, and this cache behavior also has an origin
|
|
1159
1157
|
* request policy attached, do not include the <code>Accept-Encoding</code> header in the
|
|
1160
1158
|
* origin request policy. CloudFront always includes the <code>Accept-Encoding</code> header in
|
|
1161
1159
|
* origin requests when the value of this field is <code>true</code>, so including this
|
|
1162
1160
|
* header in an origin request policy has no effect.</p>
|
|
1163
|
-
*
|
|
1161
|
+
* <p>If both of these fields are <code>false</code>, then CloudFront treats the
|
|
1164
1162
|
* <code>Accept-Encoding</code> header the same as any other HTTP header in the viewer
|
|
1165
|
-
* request. By default, it
|
|
1163
|
+
* request. By default, it's not included in the cache key and it's not included in origin
|
|
1166
1164
|
* requests. In this case, you can manually add <code>Accept-Encoding</code> to the headers
|
|
1167
1165
|
* whitelist like any other HTTP header.</p>
|
|
1168
1166
|
*/
|
|
@@ -1170,33 +1168,33 @@ export interface ParametersInCacheKeyAndForwardedToOrigin {
|
|
|
1170
1168
|
/**
|
|
1171
1169
|
* <p>A flag that can affect whether the <code>Accept-Encoding</code> HTTP header is
|
|
1172
1170
|
* included in the cache key and included in requests that CloudFront sends to the origin.</p>
|
|
1173
|
-
*
|
|
1171
|
+
* <p>This field is related to the <code>EnableAcceptEncodingGzip</code> field. If one or
|
|
1174
1172
|
* both of these fields is <code>true</code>
|
|
1175
|
-
*
|
|
1173
|
+
* <i>and</i> the viewer request includes the <code>Accept-Encoding</code>
|
|
1176
1174
|
* header, then CloudFront does the following:</p>
|
|
1177
|
-
*
|
|
1175
|
+
* <ul>
|
|
1178
1176
|
* <li>
|
|
1179
|
-
*
|
|
1177
|
+
* <p>Normalizes the value of the viewer's <code>Accept-Encoding</code>
|
|
1180
1178
|
* header</p>
|
|
1181
|
-
*
|
|
1179
|
+
* </li>
|
|
1182
1180
|
* <li>
|
|
1183
|
-
*
|
|
1184
|
-
*
|
|
1181
|
+
* <p>Includes the normalized header in the cache key</p>
|
|
1182
|
+
* </li>
|
|
1185
1183
|
* <li>
|
|
1186
|
-
*
|
|
1184
|
+
* <p>Includes the normalized header in the request to the origin, if a request is
|
|
1187
1185
|
* necessary</p>
|
|
1188
|
-
*
|
|
1186
|
+
* </li>
|
|
1189
1187
|
* </ul>
|
|
1190
|
-
*
|
|
1188
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-policy-compressed-objects">Compression support</a> in the
|
|
1191
1189
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
1192
|
-
*
|
|
1190
|
+
* <p>If you set this value to <code>true</code>, and this cache behavior also has an origin
|
|
1193
1191
|
* request policy attached, do not include the <code>Accept-Encoding</code> header in the
|
|
1194
1192
|
* origin request policy. CloudFront always includes the <code>Accept-Encoding</code> header in
|
|
1195
1193
|
* origin requests when the value of this field is <code>true</code>, so including this
|
|
1196
1194
|
* header in an origin request policy has no effect.</p>
|
|
1197
|
-
*
|
|
1195
|
+
* <p>If both of these fields are <code>false</code>, then CloudFront treats the
|
|
1198
1196
|
* <code>Accept-Encoding</code> header the same as any other HTTP header in the viewer
|
|
1199
|
-
* request. By default, it
|
|
1197
|
+
* request. By default, it's not included in the cache key and it's not included in origin
|
|
1200
1198
|
* requests. In this case, you can manually add <code>Accept-Encoding</code> to the headers
|
|
1201
1199
|
* whitelist like any other HTTP header.</p>
|
|
1202
1200
|
*/
|
|
@@ -1222,21 +1220,21 @@ export interface ParametersInCacheKeyAndForwardedToOrigin {
|
|
|
1222
1220
|
}
|
|
1223
1221
|
/**
|
|
1224
1222
|
* <p>A cache policy configuration.</p>
|
|
1225
|
-
*
|
|
1226
|
-
*
|
|
1223
|
+
* <p>This configuration determines the following:</p>
|
|
1224
|
+
* <ul>
|
|
1227
1225
|
* <li>
|
|
1228
|
-
*
|
|
1226
|
+
* <p>The values that CloudFront includes in the cache key. These values can include HTTP
|
|
1229
1227
|
* headers, cookies, and URL query strings. CloudFront uses the cache key to find an
|
|
1230
1228
|
* object in its cache that it can return to the viewer.</p>
|
|
1231
|
-
*
|
|
1229
|
+
* </li>
|
|
1232
1230
|
* <li>
|
|
1233
|
-
*
|
|
1231
|
+
* <p>The default, minimum, and maximum time to live (TTL) values that you want
|
|
1234
1232
|
* objects to stay in the CloudFront cache.</p>
|
|
1235
|
-
*
|
|
1233
|
+
* </li>
|
|
1236
1234
|
* </ul>
|
|
1237
|
-
*
|
|
1235
|
+
* <p>The headers, cookies, and query strings that are included in the cache key are
|
|
1238
1236
|
* automatically included in requests that CloudFront sends to the origin. CloudFront sends a request
|
|
1239
|
-
* when it can
|
|
1237
|
+
* when it can't find a valid object in its cache that matches the request's cache key. If
|
|
1240
1238
|
* you want to send values to the origin but <i>not</i> include them in the
|
|
1241
1239
|
* cache key, use <code>OriginRequestPolicy</code>.</p>
|
|
1242
1240
|
*/
|
|
@@ -1253,11 +1251,11 @@ export interface CachePolicyConfig {
|
|
|
1253
1251
|
/**
|
|
1254
1252
|
* <p>The default amount of time, in seconds, that you want objects to stay in the CloudFront
|
|
1255
1253
|
* cache before CloudFront sends another request to the origin to see if the object has been
|
|
1256
|
-
* updated. CloudFront uses this value as the object
|
|
1254
|
+
* updated. CloudFront uses this value as the object's time to live (TTL) only when the origin
|
|
1257
1255
|
* does <i>not</i> send <code>Cache-Control</code> or <code>Expires</code>
|
|
1258
1256
|
* headers with the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Expiration.html">Managing How Long Content Stays in an Edge Cache (Expiration)</a> in the
|
|
1259
1257
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
1260
|
-
*
|
|
1258
|
+
* <p>The default value for this field is 86400 seconds (one day). If the value of
|
|
1261
1259
|
* <code>MinTTL</code> is more than 86400 seconds, then the default value for this
|
|
1262
1260
|
* field is the same as the value of <code>MinTTL</code>.</p>
|
|
1263
1261
|
*/
|
|
@@ -1268,7 +1266,7 @@ export interface CachePolicyConfig {
|
|
|
1268
1266
|
* uses this value only when the origin sends <code>Cache-Control</code> or
|
|
1269
1267
|
* <code>Expires</code> headers with the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Expiration.html">Managing How Long Content Stays in an Edge Cache (Expiration)</a> in the
|
|
1270
1268
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
1271
|
-
*
|
|
1269
|
+
* <p>The default value for this field is 31536000 seconds (one year). If the value of
|
|
1272
1270
|
* <code>MinTTL</code> or <code>DefaultTTL</code> is more than 31536000 seconds, then
|
|
1273
1271
|
* the default value for this field is the same as the value of
|
|
1274
1272
|
* <code>DefaultTTL</code>.</p>
|
|
@@ -1290,22 +1288,22 @@ export interface CachePolicyConfig {
|
|
|
1290
1288
|
}
|
|
1291
1289
|
/**
|
|
1292
1290
|
* <p>A cache policy.</p>
|
|
1293
|
-
*
|
|
1291
|
+
* <p>When it's attached to a cache behavior, the cache policy determines the
|
|
1294
1292
|
* following:</p>
|
|
1295
|
-
*
|
|
1293
|
+
* <ul>
|
|
1296
1294
|
* <li>
|
|
1297
|
-
*
|
|
1295
|
+
* <p>The values that CloudFront includes in the cache key. These values can include HTTP
|
|
1298
1296
|
* headers, cookies, and URL query strings. CloudFront uses the cache key to find an
|
|
1299
1297
|
* object in its cache that it can return to the viewer.</p>
|
|
1300
|
-
*
|
|
1298
|
+
* </li>
|
|
1301
1299
|
* <li>
|
|
1302
|
-
*
|
|
1300
|
+
* <p>The default, minimum, and maximum time to live (TTL) values that you want
|
|
1303
1301
|
* objects to stay in the CloudFront cache.</p>
|
|
1304
|
-
*
|
|
1302
|
+
* </li>
|
|
1305
1303
|
* </ul>
|
|
1306
|
-
*
|
|
1304
|
+
* <p>The headers, cookies, and query strings that are included in the cache key are
|
|
1307
1305
|
* automatically included in requests that CloudFront sends to the origin. CloudFront sends a request
|
|
1308
|
-
* when it can
|
|
1306
|
+
* when it can't find a valid object in its cache that matches the request's cache key. If
|
|
1309
1307
|
* you want to send values to the origin but <i>not</i> include them in the
|
|
1310
1308
|
* cache key, use <code>OriginRequestPolicy</code>.</p>
|
|
1311
1309
|
*/
|
|
@@ -1446,16 +1444,16 @@ export interface CopyDistributionRequest {
|
|
|
1446
1444
|
}
|
|
1447
1445
|
/**
|
|
1448
1446
|
* <p>A complex type that controls:</p>
|
|
1449
|
-
*
|
|
1447
|
+
* <ul>
|
|
1450
1448
|
* <li>
|
|
1451
|
-
*
|
|
1452
|
-
* error messages before returning the response to the viewer
|
|
1453
|
-
*
|
|
1449
|
+
* <p>Whether CloudFront replaces HTTP status codes in the 4xx and 5xx range with custom
|
|
1450
|
+
* error messages before returning the response to the viewer.</p>
|
|
1451
|
+
* </li>
|
|
1454
1452
|
* <li>
|
|
1455
|
-
*
|
|
1456
|
-
*
|
|
1453
|
+
* <p>How long CloudFront caches HTTP status codes in the 4xx and 5xx range.</p>
|
|
1454
|
+
* </li>
|
|
1457
1455
|
* </ul>
|
|
1458
|
-
*
|
|
1456
|
+
* <p>For more information about custom error pages, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/custom-error-pages.html">Customizing
|
|
1459
1457
|
* Error Responses</a> in the <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
1460
1458
|
*/
|
|
1461
1459
|
export interface CustomErrorResponse {
|
|
@@ -1470,24 +1468,24 @@ export interface CustomErrorResponse {
|
|
|
1470
1468
|
* <code>/4xx-errors/403-forbidden.html</code>. If you want to store your objects and
|
|
1471
1469
|
* your custom error pages in different locations, your distribution must include a cache
|
|
1472
1470
|
* behavior for which the following is true:</p>
|
|
1473
|
-
*
|
|
1471
|
+
* <ul>
|
|
1474
1472
|
* <li>
|
|
1475
|
-
*
|
|
1473
|
+
* <p>The value of <code>PathPattern</code> matches the path to your custom error
|
|
1476
1474
|
* messages. For example, suppose you saved custom error pages for 4xx errors in an
|
|
1477
1475
|
* Amazon S3 bucket in a directory named <code>/4xx-errors</code>. Your distribution
|
|
1478
1476
|
* must include a cache behavior for which the path pattern routes requests for
|
|
1479
1477
|
* your custom error pages to that location, for example,
|
|
1480
|
-
* <code>/4xx-errors/*</code
|
|
1481
|
-
*
|
|
1478
|
+
* <code>/4xx-errors/*</code>.</p>
|
|
1479
|
+
* </li>
|
|
1482
1480
|
* <li>
|
|
1483
|
-
*
|
|
1481
|
+
* <p>The value of <code>TargetOriginId</code> specifies the value of the
|
|
1484
1482
|
* <code>ID</code> element for the origin that contains your custom error
|
|
1485
1483
|
* pages.</p>
|
|
1486
|
-
*
|
|
1484
|
+
* </li>
|
|
1487
1485
|
* </ul>
|
|
1488
|
-
*
|
|
1486
|
+
* <p>If you specify a value for <code>ResponsePagePath</code>, you must also specify a
|
|
1489
1487
|
* value for <code>ResponseCode</code>.</p>
|
|
1490
|
-
*
|
|
1488
|
+
* <p>We recommend that you store custom error pages in an Amazon S3 bucket. If you store custom
|
|
1491
1489
|
* error pages on an HTTP server and the server starts to return 5xx errors, CloudFront can't get
|
|
1492
1490
|
* the files that you want to return to viewers because the origin server is
|
|
1493
1491
|
* unavailable.</p>
|
|
@@ -1498,24 +1496,24 @@ export interface CustomErrorResponse {
|
|
|
1498
1496
|
* error page. There are a variety of reasons that you might want CloudFront to return a status
|
|
1499
1497
|
* code different from the status code that your origin returned to CloudFront, for
|
|
1500
1498
|
* example:</p>
|
|
1501
|
-
*
|
|
1499
|
+
* <ul>
|
|
1502
1500
|
* <li>
|
|
1503
|
-
*
|
|
1501
|
+
* <p>Some Internet devices (some firewalls and corporate proxies, for example)
|
|
1504
1502
|
* intercept HTTP 4xx and 5xx and prevent the response from being returned to the
|
|
1505
1503
|
* viewer. If you substitute <code>200</code>, the response typically won't be
|
|
1506
1504
|
* intercepted.</p>
|
|
1507
|
-
*
|
|
1505
|
+
* </li>
|
|
1508
1506
|
* <li>
|
|
1509
|
-
*
|
|
1507
|
+
* <p>If you don't care about distinguishing among different client errors or server
|
|
1510
1508
|
* errors, you can specify <code>400</code> or <code>500</code> as the
|
|
1511
1509
|
* <code>ResponseCode</code> for all 4xx or 5xx errors.</p>
|
|
1512
|
-
*
|
|
1510
|
+
* </li>
|
|
1513
1511
|
* <li>
|
|
1514
|
-
*
|
|
1512
|
+
* <p>You might want to return a <code>200</code> status code (OK) and static
|
|
1515
1513
|
* website so your customers don't know that your website is down.</p>
|
|
1516
|
-
*
|
|
1514
|
+
* </li>
|
|
1517
1515
|
* </ul>
|
|
1518
|
-
*
|
|
1516
|
+
* <p>If you specify a value for <code>ResponseCode</code>, you must also specify a value
|
|
1519
1517
|
* for <code>ResponsePagePath</code>.</p>
|
|
1520
1518
|
*/
|
|
1521
1519
|
ResponseCode?: string;
|
|
@@ -1524,23 +1522,23 @@ export interface CustomErrorResponse {
|
|
|
1524
1522
|
* code specified in <code>ErrorCode</code>. When this time period has elapsed, CloudFront
|
|
1525
1523
|
* queries your origin to see whether the problem that caused the error has been resolved
|
|
1526
1524
|
* and the requested object is now available.</p>
|
|
1527
|
-
*
|
|
1525
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/custom-error-pages.html">Customizing
|
|
1528
1526
|
* Error Responses</a> in the <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
1529
1527
|
*/
|
|
1530
1528
|
ErrorCachingMinTTL?: number;
|
|
1531
1529
|
}
|
|
1532
1530
|
/**
|
|
1533
1531
|
* <p>A complex type that controls:</p>
|
|
1534
|
-
*
|
|
1532
|
+
* <ul>
|
|
1535
1533
|
* <li>
|
|
1536
|
-
*
|
|
1534
|
+
* <p>Whether CloudFront replaces HTTP status codes in the 4xx and 5xx range with custom
|
|
1537
1535
|
* error messages before returning the response to the viewer.</p>
|
|
1538
|
-
*
|
|
1536
|
+
* </li>
|
|
1539
1537
|
* <li>
|
|
1540
|
-
*
|
|
1541
|
-
*
|
|
1538
|
+
* <p>How long CloudFront caches HTTP status codes in the 4xx and 5xx range.</p>
|
|
1539
|
+
* </li>
|
|
1542
1540
|
* </ul>
|
|
1543
|
-
*
|
|
1541
|
+
* <p>For more information about custom error pages, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/custom-error-pages.html">Customizing
|
|
1544
1542
|
* Error Responses</a> in the <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
1545
1543
|
*/
|
|
1546
1544
|
export interface CustomErrorResponses {
|
|
@@ -1558,8 +1556,8 @@ export interface CustomErrorResponses {
|
|
|
1558
1556
|
Items?: CustomErrorResponse[];
|
|
1559
1557
|
}
|
|
1560
1558
|
/**
|
|
1561
|
-
* <p>A complex type that describes the default cache behavior if you don
|
|
1562
|
-
* <code>CacheBehavior</code> element or if request URLs don
|
|
1559
|
+
* <p>A complex type that describes the default cache behavior if you don't specify a
|
|
1560
|
+
* <code>CacheBehavior</code> element or if request URLs don't match any of the values
|
|
1563
1561
|
* of <code>PathPattern</code> in <code>CacheBehavior</code> elements. You must create
|
|
1564
1562
|
* exactly one default cache behavior.</p>
|
|
1565
1563
|
*/
|
|
@@ -1571,14 +1569,14 @@ export interface DefaultCacheBehavior {
|
|
|
1571
1569
|
TargetOriginId: string | undefined;
|
|
1572
1570
|
/**
|
|
1573
1571
|
* <important>
|
|
1574
|
-
*
|
|
1572
|
+
* <p>We recommend using <code>TrustedKeyGroups</code> instead of
|
|
1575
1573
|
* <code>TrustedSigners</code>.</p>
|
|
1576
|
-
*
|
|
1577
|
-
*
|
|
1574
|
+
* </important>
|
|
1575
|
+
* <p>A list of Amazon Web Services account IDs whose public keys CloudFront can use to validate signed URLs or
|
|
1578
1576
|
* signed cookies.</p>
|
|
1579
|
-
*
|
|
1577
|
+
* <p>When a cache behavior contains trusted signers, CloudFront requires signed URLs or signed
|
|
1580
1578
|
* cookies for all requests that match the cache behavior. The URLs or cookies must be
|
|
1581
|
-
* signed with the private key of a CloudFront key pair in a trusted signer
|
|
1579
|
+
* signed with the private key of a CloudFront key pair in a trusted signer's Amazon Web Services account. The
|
|
1582
1580
|
* signed URL or cookie contains information about which public key CloudFront should use to
|
|
1583
1581
|
* verify the signature. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/PrivateContent.html">Serving private content</a> in the
|
|
1584
1582
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
@@ -1587,7 +1585,7 @@ export interface DefaultCacheBehavior {
|
|
|
1587
1585
|
/**
|
|
1588
1586
|
* <p>A list of key groups that CloudFront can use to validate signed URLs or signed
|
|
1589
1587
|
* cookies.</p>
|
|
1590
|
-
*
|
|
1588
|
+
* <p>When a cache behavior contains trusted key groups, CloudFront requires signed URLs or signed
|
|
1591
1589
|
* cookies for all requests that match the cache behavior. The URLs or cookies must be
|
|
1592
1590
|
* signed with a private key whose corresponding public key is in the key group. The signed
|
|
1593
1591
|
* URL or cookie contains information about which public key CloudFront should use to verify the
|
|
@@ -1599,54 +1597,54 @@ export interface DefaultCacheBehavior {
|
|
|
1599
1597
|
* <p>The protocol that viewers can use to access the files in the origin specified by
|
|
1600
1598
|
* <code>TargetOriginId</code> when a request matches the path pattern in
|
|
1601
1599
|
* <code>PathPattern</code>. You can specify the following options:</p>
|
|
1602
|
-
*
|
|
1600
|
+
* <ul>
|
|
1603
1601
|
* <li>
|
|
1604
|
-
*
|
|
1602
|
+
* <p>
|
|
1605
1603
|
* <code>allow-all</code>: Viewers can use HTTP or HTTPS.</p>
|
|
1606
|
-
*
|
|
1604
|
+
* </li>
|
|
1607
1605
|
* <li>
|
|
1608
|
-
*
|
|
1606
|
+
* <p>
|
|
1609
1607
|
* <code>redirect-to-https</code>: If a viewer submits an HTTP request, CloudFront
|
|
1610
1608
|
* returns an HTTP status code of 301 (Moved Permanently) to the viewer along with
|
|
1611
1609
|
* the HTTPS URL. The viewer then resubmits the request using the new URL.</p>
|
|
1612
|
-
*
|
|
1610
|
+
* </li>
|
|
1613
1611
|
* <li>
|
|
1614
|
-
*
|
|
1612
|
+
* <p>
|
|
1615
1613
|
* <code>https-only</code>: If a viewer sends an HTTP request, CloudFront returns an
|
|
1616
1614
|
* HTTP status code of 403 (Forbidden).</p>
|
|
1617
|
-
*
|
|
1615
|
+
* </li>
|
|
1618
1616
|
* </ul>
|
|
1619
|
-
*
|
|
1617
|
+
* <p>For more information about requiring the HTTPS protocol, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-https-viewers-to-cloudfront.html">Requiring HTTPS Between Viewers and CloudFront</a> in the
|
|
1620
1618
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
1621
|
-
*
|
|
1622
|
-
*
|
|
1619
|
+
* <note>
|
|
1620
|
+
* <p>The only way to guarantee that viewers retrieve an object that was fetched from
|
|
1623
1621
|
* the origin using HTTPS is never to use any other protocol to fetch the object. If
|
|
1624
1622
|
* you have recently changed from HTTP to HTTPS, we recommend that you clear your
|
|
1625
|
-
* objects
|
|
1623
|
+
* objects' cache because cached objects are protocol agnostic. That means that an edge
|
|
1626
1624
|
* location will return an object from the cache regardless of whether the current
|
|
1627
1625
|
* request protocol matches the protocol used previously. For more information, see
|
|
1628
1626
|
* <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Expiration.html">Managing Cache
|
|
1629
1627
|
* Expiration</a> in the <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
1630
|
-
*
|
|
1628
|
+
* </note>
|
|
1631
1629
|
*/
|
|
1632
1630
|
ViewerProtocolPolicy: ViewerProtocolPolicy | string | undefined;
|
|
1633
1631
|
/**
|
|
1634
1632
|
* <p>A complex type that controls which HTTP methods CloudFront processes and forwards to your
|
|
1635
1633
|
* Amazon S3 bucket or your custom origin. There are three choices:</p>
|
|
1636
|
-
*
|
|
1634
|
+
* <ul>
|
|
1637
1635
|
* <li>
|
|
1638
|
-
*
|
|
1639
|
-
*
|
|
1636
|
+
* <p>CloudFront forwards only <code>GET</code> and <code>HEAD</code> requests.</p>
|
|
1637
|
+
* </li>
|
|
1640
1638
|
* <li>
|
|
1641
|
-
*
|
|
1639
|
+
* <p>CloudFront forwards only <code>GET</code>, <code>HEAD</code>, and
|
|
1642
1640
|
* <code>OPTIONS</code> requests.</p>
|
|
1643
|
-
*
|
|
1641
|
+
* </li>
|
|
1644
1642
|
* <li>
|
|
1645
|
-
*
|
|
1643
|
+
* <p>CloudFront forwards <code>GET, HEAD, OPTIONS, PUT, PATCH, POST</code>, and
|
|
1646
1644
|
* <code>DELETE</code> requests.</p>
|
|
1647
|
-
*
|
|
1645
|
+
* </li>
|
|
1648
1646
|
* </ul>
|
|
1649
|
-
*
|
|
1647
|
+
* <p>If you pick the third choice, you may need to restrict access to your Amazon S3 bucket or
|
|
1650
1648
|
* to your custom origin so users can't perform operations that you don't want them to. For
|
|
1651
1649
|
* example, you might not want users to have permissions to delete objects from your
|
|
1652
1650
|
* origin.</p>
|
|
@@ -1658,7 +1656,7 @@ export interface DefaultCacheBehavior {
|
|
|
1658
1656
|
* <code>true</code>; if not, specify <code>false</code>. If you specify
|
|
1659
1657
|
* <code>true</code> for <code>SmoothStreaming</code>, you can still distribute other
|
|
1660
1658
|
* content using this cache behavior if the content matches the value of
|
|
1661
|
-
* <code>PathPattern</code
|
|
1659
|
+
* <code>PathPattern</code>.</p>
|
|
1662
1660
|
*/
|
|
1663
1661
|
SmoothStreaming?: boolean;
|
|
1664
1662
|
/**
|
|
@@ -1695,7 +1693,7 @@ export interface DefaultCacheBehavior {
|
|
|
1695
1693
|
* <p>The unique identifier of the cache policy that is attached to the default cache
|
|
1696
1694
|
* behavior. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-key-create-cache-policy">Creating cache policies</a> or <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-cache-policies.html">Using the managed cache policies</a> in the
|
|
1697
1695
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
1698
|
-
*
|
|
1696
|
+
* <p>A <code>DefaultCacheBehavior</code> must include either a <code>CachePolicyId</code>
|
|
1699
1697
|
* or <code>ForwardedValues</code>. We recommend that you use a
|
|
1700
1698
|
* <code>CachePolicyId</code>.</p>
|
|
1701
1699
|
*/
|
|
@@ -1716,16 +1714,16 @@ export interface DefaultCacheBehavior {
|
|
|
1716
1714
|
* <p>This field is deprecated. We recommend that you use a cache policy or an origin
|
|
1717
1715
|
* request policy instead of this field. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/working-with-policies.html">Working with policies</a> in the
|
|
1718
1716
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
1719
|
-
*
|
|
1717
|
+
* <p>If you want to include values in the cache key, use a cache policy. For more
|
|
1720
1718
|
* information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-key-create-cache-policy">Creating cache policies</a> or <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-cache-policies.html">Using the managed cache policies</a> in the
|
|
1721
1719
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
1722
|
-
*
|
|
1720
|
+
* <p>If you want to send values to the origin but not include them in the cache key, use an
|
|
1723
1721
|
* origin request policy. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-origin-requests.html#origin-request-create-origin-request-policy">Creating origin request policies</a> or <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-origin-request-policies.html">Using the managed origin request policies</a> in the
|
|
1724
1722
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
1725
|
-
*
|
|
1723
|
+
* <p>A <code>DefaultCacheBehavior</code> must include either a <code>CachePolicyId</code>
|
|
1726
1724
|
* or <code>ForwardedValues</code>. We recommend that you use a
|
|
1727
1725
|
* <code>CachePolicyId</code>.</p>
|
|
1728
|
-
*
|
|
1726
|
+
* <p>A complex type that specifies how CloudFront handles query strings, cookies, and HTTP
|
|
1729
1727
|
* headers.</p>
|
|
1730
1728
|
*/
|
|
1731
1729
|
ForwardedValues?: ForwardedValues;
|
|
@@ -1735,12 +1733,12 @@ export interface DefaultCacheBehavior {
|
|
|
1735
1733
|
* <p>This field is deprecated. We recommend that you use the <code>MinTTL</code> field in a
|
|
1736
1734
|
* cache policy instead of this field. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-key-create-cache-policy">Creating cache policies</a> or <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-cache-policies.html">Using the managed cache policies</a> in the
|
|
1737
1735
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
1738
|
-
*
|
|
1736
|
+
* <p>The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront
|
|
1739
1737
|
* forwards another request to your origin to determine whether the object has been
|
|
1740
1738
|
* updated. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Expiration.html">Managing How Long
|
|
1741
1739
|
* Content Stays in an Edge Cache (Expiration)</a> in the
|
|
1742
1740
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
1743
|
-
*
|
|
1741
|
+
* <p>You must specify <code>0</code> for <code>MinTTL</code> if you configure CloudFront to
|
|
1744
1742
|
* forward all headers to your origin (under <code>Headers</code>, if you specify
|
|
1745
1743
|
* <code>1</code> for <code>Quantity</code> and <code>*</code> for
|
|
1746
1744
|
* <code>Name</code>).</p>
|
|
@@ -1752,7 +1750,7 @@ export interface DefaultCacheBehavior {
|
|
|
1752
1750
|
* <p>This field is deprecated. We recommend that you use the <code>DefaultTTL</code> field
|
|
1753
1751
|
* in a cache policy instead of this field. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-key-create-cache-policy">Creating cache policies</a> or <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-cache-policies.html">Using the managed cache policies</a> in the
|
|
1754
1752
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
1755
|
-
*
|
|
1753
|
+
* <p>The default amount of time that you want objects to stay in CloudFront caches before CloudFront
|
|
1756
1754
|
* forwards another request to your origin to determine whether the object has been
|
|
1757
1755
|
* updated. The value that you specify applies only when your origin does not add HTTP
|
|
1758
1756
|
* headers such as <code>Cache-Control max-age</code>, <code>Cache-Control s-maxage</code>,
|
|
@@ -1766,7 +1764,7 @@ export interface DefaultCacheBehavior {
|
|
|
1766
1764
|
* <p>This field is deprecated. We recommend that you use the <code>MaxTTL</code> field in a
|
|
1767
1765
|
* cache policy instead of this field. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-key-create-cache-policy">Creating cache policies</a> or <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-cache-policies.html">Using the managed cache policies</a> in the
|
|
1768
1766
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
1769
|
-
*
|
|
1767
|
+
* <p>The maximum amount of time that you want objects to stay in CloudFront caches before CloudFront
|
|
1770
1768
|
* forwards another request to your origin to determine whether the object has been
|
|
1771
1769
|
* updated. The value that you specify applies only when your origin adds HTTP headers such
|
|
1772
1770
|
* as <code>Cache-Control max-age</code>, <code>Cache-Control s-maxage</code>, and
|
|
@@ -1904,7 +1902,7 @@ export interface OriginGroups {
|
|
|
1904
1902
|
}
|
|
1905
1903
|
/**
|
|
1906
1904
|
* <p>A complex type that contains <code>HeaderName</code> and <code>HeaderValue</code>
|
|
1907
|
-
* elements, if any, for this distribution
|
|
1905
|
+
* elements, if any, for this distribution.</p>
|
|
1908
1906
|
*/
|
|
1909
1907
|
export interface OriginCustomHeader {
|
|
1910
1908
|
/**
|
|
@@ -1921,7 +1919,7 @@ export interface OriginCustomHeader {
|
|
|
1921
1919
|
HeaderValue: string | undefined;
|
|
1922
1920
|
}
|
|
1923
1921
|
/**
|
|
1924
|
-
* <p>A complex type that contains the list of Custom Headers for each origin
|
|
1922
|
+
* <p>A complex type that contains the list of Custom Headers for each origin.</p>
|
|
1925
1923
|
*/
|
|
1926
1924
|
export interface CustomHeaders {
|
|
1927
1925
|
/**
|
|
@@ -1949,12 +1947,12 @@ export declare enum SslProtocol {
|
|
|
1949
1947
|
}
|
|
1950
1948
|
/**
|
|
1951
1949
|
* <p>A complex type that contains information about the SSL/TLS protocols that CloudFront can use
|
|
1952
|
-
* when establishing an HTTPS connection with your origin
|
|
1950
|
+
* when establishing an HTTPS connection with your origin.</p>
|
|
1953
1951
|
*/
|
|
1954
1952
|
export interface OriginSslProtocols {
|
|
1955
1953
|
/**
|
|
1956
1954
|
* <p>The number of SSL/TLS protocols that you want to allow CloudFront to use when establishing
|
|
1957
|
-
* an HTTPS connection with this origin
|
|
1955
|
+
* an HTTPS connection with this origin.</p>
|
|
1958
1956
|
*/
|
|
1959
1957
|
Quantity: number | undefined;
|
|
1960
1958
|
/**
|
|
@@ -1966,7 +1964,7 @@ export interface OriginSslProtocols {
|
|
|
1966
1964
|
* <p>A custom origin. A custom origin is any origin that is <i>not</i> an
|
|
1967
1965
|
* Amazon S3 bucket, with one exception. An Amazon S3 bucket that is <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html">configured with
|
|
1968
1966
|
* static website hosting</a>
|
|
1969
|
-
*
|
|
1967
|
+
* <i>is</i> a custom origin.</p>
|
|
1970
1968
|
*/
|
|
1971
1969
|
export interface CustomOriginConfig {
|
|
1972
1970
|
/**
|
|
@@ -1982,22 +1980,22 @@ export interface CustomOriginConfig {
|
|
|
1982
1980
|
/**
|
|
1983
1981
|
* <p>Specifies the protocol (HTTP or HTTPS) that CloudFront uses to connect to the origin. Valid
|
|
1984
1982
|
* values are:</p>
|
|
1985
|
-
*
|
|
1983
|
+
* <ul>
|
|
1986
1984
|
* <li>
|
|
1987
|
-
*
|
|
1985
|
+
* <p>
|
|
1988
1986
|
* <code>http-only</code> – CloudFront always uses HTTP to connect to the
|
|
1989
1987
|
* origin.</p>
|
|
1990
|
-
*
|
|
1988
|
+
* </li>
|
|
1991
1989
|
* <li>
|
|
1992
|
-
*
|
|
1990
|
+
* <p>
|
|
1993
1991
|
* <code>match-viewer</code> – CloudFront connects to the origin using the same
|
|
1994
1992
|
* protocol that the viewer used to connect to CloudFront.</p>
|
|
1995
|
-
*
|
|
1993
|
+
* </li>
|
|
1996
1994
|
* <li>
|
|
1997
|
-
*
|
|
1995
|
+
* <p>
|
|
1998
1996
|
* <code>https-only</code> – CloudFront always uses HTTPS to connect to the
|
|
1999
1997
|
* origin.</p>
|
|
2000
|
-
*
|
|
1998
|
+
* </li>
|
|
2001
1999
|
* </ul>
|
|
2002
2000
|
*/
|
|
2003
2001
|
OriginProtocolPolicy: OriginProtocolPolicy | string | undefined;
|
|
@@ -2005,48 +2003,48 @@ export interface CustomOriginConfig {
|
|
|
2005
2003
|
* <p>Specifies the minimum SSL/TLS protocol that CloudFront uses when connecting to your origin
|
|
2006
2004
|
* over HTTPS. Valid values include <code>SSLv3</code>, <code>TLSv1</code>,
|
|
2007
2005
|
* <code>TLSv1.1</code>, and <code>TLSv1.2</code>.</p>
|
|
2008
|
-
*
|
|
2006
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-values-specify.html#DownloadDistValuesOriginSSLProtocols">Minimum Origin SSL Protocol</a> in the
|
|
2009
2007
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
2010
2008
|
*/
|
|
2011
2009
|
OriginSslProtocols?: OriginSslProtocols;
|
|
2012
2010
|
/**
|
|
2013
2011
|
* <p>Specifies how long, in seconds, CloudFront waits for a response from the origin. This is
|
|
2014
2012
|
* also known as the <i>origin response timeout</i>. The minimum timeout is 1
|
|
2015
|
-
* second, the maximum is 60 seconds, and the default (if you don
|
|
2013
|
+
* second, the maximum is 60 seconds, and the default (if you don't specify otherwise) is
|
|
2016
2014
|
* 30 seconds.</p>
|
|
2017
|
-
*
|
|
2015
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-values-specify.html#DownloadDistValuesOriginResponseTimeout">Origin Response Timeout</a> in the
|
|
2018
2016
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
2019
2017
|
*/
|
|
2020
2018
|
OriginReadTimeout?: number;
|
|
2021
2019
|
/**
|
|
2022
2020
|
* <p>Specifies how long, in seconds, CloudFront persists its connection to the origin. The
|
|
2023
|
-
* minimum timeout is 1 second, the maximum is 60 seconds, and the default (if you don
|
|
2021
|
+
* minimum timeout is 1 second, the maximum is 60 seconds, and the default (if you don't
|
|
2024
2022
|
* specify otherwise) is 5 seconds.</p>
|
|
2025
|
-
*
|
|
2023
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-values-specify.html#DownloadDistValuesOriginKeepaliveTimeout">Origin Keep-alive Timeout</a> in the
|
|
2026
2024
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
2027
2025
|
*/
|
|
2028
2026
|
OriginKeepaliveTimeout?: number;
|
|
2029
2027
|
}
|
|
2030
2028
|
/**
|
|
2031
2029
|
* <p>CloudFront Origin Shield.</p>
|
|
2032
|
-
*
|
|
2030
|
+
* <p>Using Origin Shield can help reduce the load on your origin. For more information, see
|
|
2033
2031
|
* <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/origin-shield.html">Using Origin Shield</a> in the
|
|
2034
2032
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
2035
2033
|
*/
|
|
2036
2034
|
export interface OriginShield {
|
|
2037
2035
|
/**
|
|
2038
2036
|
* <p>A flag that specifies whether Origin Shield is enabled.</p>
|
|
2039
|
-
*
|
|
2040
|
-
* protect your origin. When it
|
|
2037
|
+
* <p>When it's enabled, CloudFront routes all requests through Origin Shield, which can help
|
|
2038
|
+
* protect your origin. When it's disabled, CloudFront might send requests directly to your
|
|
2041
2039
|
* origin from multiple edge locations or regional edge caches.</p>
|
|
2042
2040
|
*/
|
|
2043
2041
|
Enabled: boolean | undefined;
|
|
2044
2042
|
/**
|
|
2045
2043
|
* <p>The Amazon Web Services Region for Origin Shield.</p>
|
|
2046
|
-
*
|
|
2044
|
+
* <p>Specify the Amazon Web Services Region that has the lowest latency to your origin. To specify a
|
|
2047
2045
|
* region, use the region code, not the region name. For example, specify the US East
|
|
2048
2046
|
* (Ohio) region as <code>us-east-2</code>.</p>
|
|
2049
|
-
*
|
|
2047
|
+
* <p>When you enable CloudFront Origin Shield, you must specify the Amazon Web Services Region for Origin
|
|
2050
2048
|
* Shield. For the list of Amazon Web Services Regions that you can specify, and for help choosing the
|
|
2051
2049
|
* best Region for your origin, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/origin-shield.html#choose-origin-shield-region">Choosing the Amazon Web Services Region for Origin Shield</a> in the
|
|
2052
2050
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
@@ -2063,58 +2061,58 @@ export interface S3OriginConfig {
|
|
|
2063
2061
|
* <p>The CloudFront origin access identity to associate with the origin. Use an origin access
|
|
2064
2062
|
* identity to configure the origin so that viewers can <i>only</i> access
|
|
2065
2063
|
* objects in an Amazon S3 bucket through CloudFront. The format of the value is:</p>
|
|
2066
|
-
*
|
|
2064
|
+
* <p>origin-access-identity/cloudfront/<i>ID-of-origin-access-identity</i>
|
|
2067
2065
|
* </p>
|
|
2068
|
-
*
|
|
2066
|
+
* <p>where <code>
|
|
2069
2067
|
* <i>ID-of-origin-access-identity</i>
|
|
2070
2068
|
* </code> is the value that
|
|
2071
2069
|
* CloudFront returned in the <code>ID</code> element when you created the origin access
|
|
2072
2070
|
* identity.</p>
|
|
2073
|
-
*
|
|
2071
|
+
* <p>If you want viewers to be able to access objects using either the CloudFront URL or the Amazon S3
|
|
2074
2072
|
* URL, specify an empty <code>OriginAccessIdentity</code> element.</p>
|
|
2075
|
-
*
|
|
2073
|
+
* <p>To delete the origin access identity from an existing distribution, update the
|
|
2076
2074
|
* distribution configuration and include an empty <code>OriginAccessIdentity</code>
|
|
2077
2075
|
* element.</p>
|
|
2078
|
-
*
|
|
2076
|
+
* <p>To replace the origin access identity, update the distribution configuration and
|
|
2079
2077
|
* specify the new origin access identity.</p>
|
|
2080
|
-
*
|
|
2078
|
+
* <p>For more information about the origin access identity, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/PrivateContent.html">Serving Private
|
|
2081
2079
|
* Content through CloudFront</a> in the <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
2082
2080
|
*/
|
|
2083
2081
|
OriginAccessIdentity: string | undefined;
|
|
2084
2082
|
}
|
|
2085
2083
|
/**
|
|
2086
2084
|
* <p>An origin.</p>
|
|
2087
|
-
*
|
|
2085
|
+
* <p>An origin is the location where content is stored, and from which CloudFront gets content to
|
|
2088
2086
|
* serve to viewers. To specify an origin:</p>
|
|
2089
|
-
*
|
|
2087
|
+
* <ul>
|
|
2090
2088
|
* <li>
|
|
2091
|
-
*
|
|
2089
|
+
* <p>Use <code>S3OriginConfig</code> to specify an Amazon S3 bucket that is not
|
|
2092
2090
|
* configured with static website hosting.</p>
|
|
2093
|
-
*
|
|
2091
|
+
* </li>
|
|
2094
2092
|
* <li>
|
|
2095
|
-
*
|
|
2093
|
+
* <p>Use <code>CustomOriginConfig</code> to specify all other kinds of origins,
|
|
2096
2094
|
* including:</p>
|
|
2097
|
-
*
|
|
2095
|
+
* <ul>
|
|
2098
2096
|
* <li>
|
|
2099
|
-
*
|
|
2100
|
-
*
|
|
2097
|
+
* <p>An Amazon S3 bucket that is configured with static website hosting</p>
|
|
2098
|
+
* </li>
|
|
2101
2099
|
* <li>
|
|
2102
|
-
*
|
|
2103
|
-
*
|
|
2100
|
+
* <p>An Elastic Load Balancing load balancer</p>
|
|
2101
|
+
* </li>
|
|
2104
2102
|
* <li>
|
|
2105
|
-
*
|
|
2106
|
-
*
|
|
2103
|
+
* <p>An AWS Elemental MediaPackage endpoint</p>
|
|
2104
|
+
* </li>
|
|
2107
2105
|
* <li>
|
|
2108
|
-
*
|
|
2109
|
-
*
|
|
2106
|
+
* <p>An AWS Elemental MediaStore container</p>
|
|
2107
|
+
* </li>
|
|
2110
2108
|
* <li>
|
|
2111
|
-
*
|
|
2109
|
+
* <p>Any other HTTP server, running on an Amazon EC2 instance or any other kind
|
|
2112
2110
|
* of host</p>
|
|
2113
|
-
*
|
|
2111
|
+
* </li>
|
|
2114
2112
|
* </ul>
|
|
2115
|
-
*
|
|
2113
|
+
* </li>
|
|
2116
2114
|
* </ul>
|
|
2117
|
-
*
|
|
2115
|
+
* <p>For the current maximum number of origins that you can specify per distribution, see
|
|
2118
2116
|
* <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/cloudfront-limits.html#limits-web-distributions">General Quotas on Web Distributions</a> in the
|
|
2119
2117
|
* <i>Amazon CloudFront Developer Guide</i> (quotas were formerly referred to as
|
|
2120
2118
|
* limits).</p>
|
|
@@ -2123,26 +2121,26 @@ export interface Origin {
|
|
|
2123
2121
|
/**
|
|
2124
2122
|
* <p>A unique identifier for the origin. This value must be unique within the
|
|
2125
2123
|
* distribution.</p>
|
|
2126
|
-
*
|
|
2124
|
+
* <p>Use this value to specify the <code>TargetOriginId</code> in a
|
|
2127
2125
|
* <code>CacheBehavior</code> or <code>DefaultCacheBehavior</code>.</p>
|
|
2128
2126
|
*/
|
|
2129
2127
|
Id: string | undefined;
|
|
2130
2128
|
/**
|
|
2131
2129
|
* <p>The domain name for the origin.</p>
|
|
2132
|
-
*
|
|
2130
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-values-specify.html#DownloadDistValuesDomainName">Origin Domain Name</a> in the <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
2133
2131
|
*/
|
|
2134
2132
|
DomainName: string | undefined;
|
|
2135
2133
|
/**
|
|
2136
2134
|
* <p>An optional path that CloudFront appends to the origin domain name when CloudFront requests
|
|
2137
2135
|
* content from the origin.</p>
|
|
2138
|
-
*
|
|
2136
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-values-specify.html#DownloadDistValuesOriginPath">Origin Path</a> in the
|
|
2139
2137
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
2140
2138
|
*/
|
|
2141
2139
|
OriginPath?: string;
|
|
2142
2140
|
/**
|
|
2143
2141
|
* <p>A list of HTTP header names and values that CloudFront adds to the requests that it sends to
|
|
2144
2142
|
* the origin.</p>
|
|
2145
|
-
*
|
|
2143
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/add-origin-custom-headers.html">Adding Custom Headers to Origin Requests</a> in the
|
|
2146
2144
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
2147
2145
|
*/
|
|
2148
2146
|
CustomHeaders?: CustomHeaders;
|
|
@@ -2162,31 +2160,31 @@ export interface Origin {
|
|
|
2162
2160
|
CustomOriginConfig?: CustomOriginConfig;
|
|
2163
2161
|
/**
|
|
2164
2162
|
* <p>The number of times that CloudFront attempts to connect to the origin. The minimum number is
|
|
2165
|
-
* 1, the maximum is 3, and the default (if you don
|
|
2166
|
-
*
|
|
2163
|
+
* 1, the maximum is 3, and the default (if you don't specify otherwise) is 3.</p>
|
|
2164
|
+
* <p>For a custom origin (including an Amazon S3 bucket that's configured with static website
|
|
2167
2165
|
* hosting), this value also specifies the number of times that CloudFront attempts to get a
|
|
2168
2166
|
* response from the origin, in the case of an <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-values-specify.html#DownloadDistValuesOriginResponseTimeout">Origin Response Timeout</a>.</p>
|
|
2169
|
-
*
|
|
2167
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-values-specify.html#origin-connection-attempts">Origin Connection Attempts</a> in the
|
|
2170
2168
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
2171
2169
|
*/
|
|
2172
2170
|
ConnectionAttempts?: number;
|
|
2173
2171
|
/**
|
|
2174
2172
|
* <p>The number of seconds that CloudFront waits when trying to establish a connection to the
|
|
2175
2173
|
* origin. The minimum timeout is 1 second, the maximum is 10 seconds, and the default (if
|
|
2176
|
-
* you don
|
|
2177
|
-
*
|
|
2174
|
+
* you don't specify otherwise) is 10 seconds.</p>
|
|
2175
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-values-specify.html#origin-connection-timeout">Origin Connection Timeout</a> in the
|
|
2178
2176
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
2179
2177
|
*/
|
|
2180
2178
|
ConnectionTimeout?: number;
|
|
2181
2179
|
/**
|
|
2182
2180
|
* <p>CloudFront Origin Shield. Using Origin Shield can help reduce the load on your
|
|
2183
2181
|
* origin.</p>
|
|
2184
|
-
*
|
|
2182
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/origin-shield.html">Using Origin Shield</a> in the <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
2185
2183
|
*/
|
|
2186
2184
|
OriginShield?: OriginShield;
|
|
2187
2185
|
/**
|
|
2188
2186
|
* <p>The unique identifier of an origin access control for this origin.</p>
|
|
2189
|
-
*
|
|
2187
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/private-content-restricting-access-to-s3.html">Restricting access to an Amazon S3 origin</a> in the
|
|
2190
2188
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
2191
2189
|
*/
|
|
2192
2190
|
OriginAccessControlId?: string;
|
|
@@ -2223,22 +2221,22 @@ export interface GeoRestriction {
|
|
|
2223
2221
|
/**
|
|
2224
2222
|
* <p>The method that you want to use to restrict distribution of your content by
|
|
2225
2223
|
* country:</p>
|
|
2226
|
-
*
|
|
2224
|
+
* <ul>
|
|
2227
2225
|
* <li>
|
|
2228
|
-
*
|
|
2226
|
+
* <p>
|
|
2229
2227
|
* <code>none</code>: No geo restriction is enabled, meaning access to content is
|
|
2230
2228
|
* not restricted by client geo location.</p>
|
|
2231
|
-
*
|
|
2229
|
+
* </li>
|
|
2232
2230
|
* <li>
|
|
2233
|
-
*
|
|
2231
|
+
* <p>
|
|
2234
2232
|
* <code>blacklist</code>: The <code>Location</code> elements specify the
|
|
2235
2233
|
* countries in which you don't want CloudFront to distribute your content.</p>
|
|
2236
|
-
*
|
|
2234
|
+
* </li>
|
|
2237
2235
|
* <li>
|
|
2238
|
-
*
|
|
2236
|
+
* <p>
|
|
2239
2237
|
* <code>whitelist</code>: The <code>Location</code> elements specify the
|
|
2240
2238
|
* countries in which you want CloudFront to distribute your content.</p>
|
|
2241
|
-
*
|
|
2239
|
+
* </li>
|
|
2242
2240
|
* </ul>
|
|
2243
2241
|
*/
|
|
2244
2242
|
RestrictionType: GeoRestrictionType | string | undefined;
|
|
@@ -2249,14 +2247,14 @@ export interface GeoRestriction {
|
|
|
2249
2247
|
*/
|
|
2250
2248
|
Quantity: number | undefined;
|
|
2251
2249
|
/**
|
|
2252
|
-
* <p>
|
|
2250
|
+
* <p>A complex type that contains a <code>Location</code> element for each country in
|
|
2253
2251
|
* which you want CloudFront either to distribute your content (<code>whitelist</code>) or not
|
|
2254
2252
|
* distribute your content (<code>blacklist</code>).</p>
|
|
2255
|
-
*
|
|
2253
|
+
* <p>The <code>Location</code> element is a two-letter, uppercase country code for a
|
|
2256
2254
|
* country that you want to include in your <code>blacklist</code> or
|
|
2257
2255
|
* <code>whitelist</code>. Include one <code>Location</code> element for each
|
|
2258
2256
|
* country.</p>
|
|
2259
|
-
*
|
|
2257
|
+
* <p>CloudFront and <code>MaxMind</code> both use <code>ISO 3166</code> country codes. For the
|
|
2260
2258
|
* current list of countries and the corresponding codes, see <code>ISO
|
|
2261
2259
|
* 3166-1-alpha-2</code> code on the <i>International Organization for
|
|
2262
2260
|
* Standardization</i> website. You can also refer to the country list on the
|
|
@@ -2290,64 +2288,64 @@ export declare enum SSLSupportMethod {
|
|
|
2290
2288
|
vip = "vip"
|
|
2291
2289
|
}
|
|
2292
2290
|
/**
|
|
2293
|
-
* <p>A complex type that determines the distribution
|
|
2291
|
+
* <p>A complex type that determines the distribution's SSL/TLS configuration for
|
|
2294
2292
|
* communicating with viewers.</p>
|
|
2295
|
-
*
|
|
2293
|
+
* <p>If the distribution doesn't use <code>Aliases</code> (also known as alternate domain
|
|
2296
2294
|
* names or CNAMEs)—that is, if the distribution uses the CloudFront domain name such as
|
|
2297
2295
|
* <code>d111111abcdef8.cloudfront.net</code>—set
|
|
2298
2296
|
* <code>CloudFrontDefaultCertificate</code> to <code>true</code> and leave all other
|
|
2299
2297
|
* fields empty.</p>
|
|
2300
|
-
*
|
|
2298
|
+
* <p>If the distribution uses <code>Aliases</code> (alternate domain names or CNAMEs), use
|
|
2301
2299
|
* the fields in this type to specify the following settings:</p>
|
|
2302
|
-
*
|
|
2300
|
+
* <ul>
|
|
2303
2301
|
* <li>
|
|
2304
|
-
*
|
|
2302
|
+
* <p>Which viewers the distribution accepts HTTPS connections from: only viewers
|
|
2305
2303
|
* that support <a href="https://en.wikipedia.org/wiki/Server_Name_Indication">server name indication (SNI)</a> (recommended), or all viewers
|
|
2306
|
-
* including those that don
|
|
2307
|
-
*
|
|
2304
|
+
* including those that don't support SNI.</p>
|
|
2305
|
+
* <ul>
|
|
2308
2306
|
* <li>
|
|
2309
|
-
*
|
|
2307
|
+
* <p>To accept HTTPS connections from only viewers that support SNI, set
|
|
2310
2308
|
* <code>SSLSupportMethod</code> to <code>sni-only</code>. This is
|
|
2311
2309
|
* recommended. Most browsers and clients support SNI. </p>
|
|
2312
|
-
*
|
|
2310
|
+
* </li>
|
|
2313
2311
|
* <li>
|
|
2314
|
-
*
|
|
2315
|
-
* don
|
|
2312
|
+
* <p>To accept HTTPS connections from all viewers, including those that
|
|
2313
|
+
* don't support SNI, set <code>SSLSupportMethod</code> to
|
|
2316
2314
|
* <code>vip</code>. This is not recommended, and results in additional
|
|
2317
2315
|
* monthly charges from CloudFront.</p>
|
|
2318
|
-
*
|
|
2316
|
+
* </li>
|
|
2319
2317
|
* </ul>
|
|
2320
|
-
*
|
|
2318
|
+
* </li>
|
|
2321
2319
|
* <li>
|
|
2322
|
-
*
|
|
2320
|
+
* <p>The minimum SSL/TLS protocol version that the distribution can use to
|
|
2323
2321
|
* communicate with viewers. To specify a minimum version, choose a value for
|
|
2324
2322
|
* <code>MinimumProtocolVersion</code>. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-values-specify.html#DownloadDistValues-security-policy">Security Policy</a> in the
|
|
2325
2323
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
2326
|
-
*
|
|
2324
|
+
* </li>
|
|
2327
2325
|
* <li>
|
|
2328
|
-
*
|
|
2326
|
+
* <p>The location of the SSL/TLS certificate, <a href="https://docs.aws.amazon.com/acm/latest/userguide/acm-overview.html">Certificate Manager
|
|
2329
2327
|
* (ACM)</a> (recommended) or <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_server-certs.html">Identity and Access Management (IAM)</a>. You specify the location by
|
|
2330
2328
|
* setting a value in one of the following fields (not both):</p>
|
|
2331
|
-
*
|
|
2329
|
+
* <ul>
|
|
2332
2330
|
* <li>
|
|
2333
|
-
*
|
|
2331
|
+
* <p>
|
|
2334
2332
|
* <code>ACMCertificateArn</code>
|
|
2335
2333
|
* </p>
|
|
2336
|
-
*
|
|
2334
|
+
* </li>
|
|
2337
2335
|
* <li>
|
|
2338
|
-
*
|
|
2336
|
+
* <p>
|
|
2339
2337
|
* <code>IAMCertificateId</code>
|
|
2340
2338
|
* </p>
|
|
2341
|
-
*
|
|
2339
|
+
* </li>
|
|
2342
2340
|
* </ul>
|
|
2343
|
-
*
|
|
2341
|
+
* </li>
|
|
2344
2342
|
* </ul>
|
|
2345
|
-
*
|
|
2343
|
+
* <p>All distributions support HTTPS connections from viewers. To require viewers to use
|
|
2346
2344
|
* HTTPS only, or to redirect them from HTTP to HTTPS, use
|
|
2347
2345
|
* <code>ViewerProtocolPolicy</code> in the <code>CacheBehavior</code> or
|
|
2348
2346
|
* <code>DefaultCacheBehavior</code>. To specify how CloudFront should use SSL/TLS to
|
|
2349
2347
|
* communicate with your custom origin, use <code>CustomOriginConfig</code>.</p>
|
|
2350
|
-
*
|
|
2348
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-https.html">Using HTTPS with CloudFront</a> and <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-https-alternate-domain-names.html"> Using Alternate Domain Names and HTTPS</a> in the
|
|
2351
2349
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
2352
2350
|
*/
|
|
2353
2351
|
export interface ViewerCertificate {
|
|
@@ -2355,32 +2353,31 @@ export interface ViewerCertificate {
|
|
|
2355
2353
|
* <p>If the distribution uses the CloudFront domain name such as
|
|
2356
2354
|
* <code>d111111abcdef8.cloudfront.net</code>, set this field to
|
|
2357
2355
|
* <code>true</code>.</p>
|
|
2358
|
-
*
|
|
2356
|
+
* <p>If the distribution uses <code>Aliases</code> (alternate domain names or CNAMEs), set
|
|
2359
2357
|
* this field to <code>false</code> and specify values for the following fields:</p>
|
|
2360
|
-
*
|
|
2358
|
+
* <ul>
|
|
2361
2359
|
* <li>
|
|
2362
|
-
*
|
|
2360
|
+
* <p>
|
|
2363
2361
|
* <code>ACMCertificateArn</code> or <code>IAMCertificateId</code> (specify a
|
|
2364
2362
|
* value for one, not both)</p>
|
|
2365
|
-
*
|
|
2366
|
-
* </li>
|
|
2363
|
+
* </li>
|
|
2367
2364
|
* <li>
|
|
2368
|
-
*
|
|
2365
|
+
* <p>
|
|
2369
2366
|
* <code>MinimumProtocolVersion</code>
|
|
2370
2367
|
* </p>
|
|
2371
|
-
*
|
|
2368
|
+
* </li>
|
|
2372
2369
|
* <li>
|
|
2373
|
-
*
|
|
2370
|
+
* <p>
|
|
2374
2371
|
* <code>SSLSupportMethod</code>
|
|
2375
2372
|
* </p>
|
|
2376
|
-
*
|
|
2373
|
+
* </li>
|
|
2377
2374
|
* </ul>
|
|
2378
2375
|
*/
|
|
2379
2376
|
CloudFrontDefaultCertificate?: boolean;
|
|
2380
2377
|
/**
|
|
2381
2378
|
* <p>If the distribution uses <code>Aliases</code> (alternate domain names or CNAMEs) and
|
|
2382
2379
|
* the SSL/TLS certificate is stored in <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_server-certs.html">Identity and Access Management (IAM)</a>, provide the ID of the IAM certificate.</p>
|
|
2383
|
-
*
|
|
2380
|
+
* <p>If you specify an IAM certificate ID, you must also specify values for
|
|
2384
2381
|
* <code>MinimumProtocolVersion</code> and <code>SSLSupportMethod</code>. </p>
|
|
2385
2382
|
*/
|
|
2386
2383
|
IAMCertificateId?: string;
|
|
@@ -2389,62 +2386,62 @@ export interface ViewerCertificate {
|
|
|
2389
2386
|
* the SSL/TLS certificate is stored in <a href="https://docs.aws.amazon.com/acm/latest/userguide/acm-overview.html">Certificate Manager (ACM)</a>, provide the Amazon Resource Name
|
|
2390
2387
|
* (ARN) of the ACM certificate. CloudFront only supports ACM certificates in the US East
|
|
2391
2388
|
* (N. Virginia) Region (<code>us-east-1</code>).</p>
|
|
2392
|
-
*
|
|
2389
|
+
* <p>If you specify an ACM certificate ARN, you must also specify values for
|
|
2393
2390
|
* <code>MinimumProtocolVersion</code> and <code>SSLSupportMethod</code>.</p>
|
|
2394
2391
|
*/
|
|
2395
2392
|
ACMCertificateArn?: string;
|
|
2396
2393
|
/**
|
|
2397
2394
|
* <p>If the distribution uses <code>Aliases</code> (alternate domain names or CNAMEs),
|
|
2398
2395
|
* specify which viewers the distribution accepts HTTPS connections from.</p>
|
|
2399
|
-
*
|
|
2396
|
+
* <ul>
|
|
2400
2397
|
* <li>
|
|
2401
|
-
*
|
|
2398
|
+
* <p>
|
|
2402
2399
|
* <code>sni-only</code> – The distribution accepts HTTPS connections from only
|
|
2403
2400
|
* viewers that support <a href="https://en.wikipedia.org/wiki/Server_Name_Indication">server name
|
|
2404
2401
|
* indication (SNI)</a>. This is recommended. Most browsers and clients
|
|
2405
2402
|
* support SNI.</p>
|
|
2406
|
-
*
|
|
2403
|
+
* </li>
|
|
2407
2404
|
* <li>
|
|
2408
|
-
*
|
|
2405
|
+
* <p>
|
|
2409
2406
|
* <code>vip</code> – The distribution accepts HTTPS connections from all viewers
|
|
2410
|
-
* including those that don
|
|
2407
|
+
* including those that don't support SNI. This is not recommended, and results in
|
|
2411
2408
|
* additional monthly charges from CloudFront.</p>
|
|
2412
|
-
*
|
|
2409
|
+
* </li>
|
|
2413
2410
|
* <li>
|
|
2414
|
-
*
|
|
2411
|
+
* <p>
|
|
2415
2412
|
* <code>static-ip</code> - Do not specify this value unless your distribution
|
|
2416
2413
|
* has been enabled for this feature by the CloudFront team. If you have a use case
|
|
2417
2414
|
* that requires static IP addresses for a distribution, contact CloudFront through
|
|
2418
2415
|
* the <a href="https://console.aws.amazon.com/support/home">Amazon Web Services Support Center</a>.</p>
|
|
2419
|
-
*
|
|
2416
|
+
* </li>
|
|
2420
2417
|
* </ul>
|
|
2421
|
-
*
|
|
2422
|
-
* <code>d111111abcdef8.cloudfront.net</code>, don
|
|
2418
|
+
* <p>If the distribution uses the CloudFront domain name such as
|
|
2419
|
+
* <code>d111111abcdef8.cloudfront.net</code>, don't set a value for this field.</p>
|
|
2423
2420
|
*/
|
|
2424
2421
|
SSLSupportMethod?: SSLSupportMethod | string;
|
|
2425
2422
|
/**
|
|
2426
2423
|
* <p>If the distribution uses <code>Aliases</code> (alternate domain names or CNAMEs),
|
|
2427
2424
|
* specify the security policy that you want CloudFront to use for HTTPS connections with
|
|
2428
2425
|
* viewers. The security policy determines two settings:</p>
|
|
2429
|
-
*
|
|
2426
|
+
* <ul>
|
|
2430
2427
|
* <li>
|
|
2431
|
-
*
|
|
2428
|
+
* <p>The minimum SSL/TLS protocol that CloudFront can use to communicate with
|
|
2432
2429
|
* viewers.</p>
|
|
2433
|
-
*
|
|
2430
|
+
* </li>
|
|
2434
2431
|
* <li>
|
|
2435
|
-
*
|
|
2432
|
+
* <p>The ciphers that CloudFront can use to encrypt the content that it returns to
|
|
2436
2433
|
* viewers.</p>
|
|
2437
|
-
*
|
|
2434
|
+
* </li>
|
|
2438
2435
|
* </ul>
|
|
2439
|
-
*
|
|
2436
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-values-specify.html#DownloadDistValues-security-policy">Security Policy</a> and <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/secure-connections-supported-viewer-protocols-ciphers.html#secure-connections-supported-ciphers">Supported Protocols and Ciphers Between Viewers and
|
|
2440
2437
|
* CloudFront</a> in the <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
2441
|
-
*
|
|
2442
|
-
*
|
|
2438
|
+
* <note>
|
|
2439
|
+
* <p>On the CloudFront console, this setting is called <b>Security
|
|
2443
2440
|
* Policy</b>.</p>
|
|
2444
|
-
*
|
|
2445
|
-
*
|
|
2441
|
+
* </note>
|
|
2442
|
+
* <p>When you're using SNI only (you set <code>SSLSupportMethod</code> to
|
|
2446
2443
|
* <code>sni-only</code>), you must specify <code>TLSv1</code> or higher.</p>
|
|
2447
|
-
*
|
|
2444
|
+
* <p>If the distribution uses the CloudFront domain name such as
|
|
2448
2445
|
* <code>d111111abcdef8.cloudfront.net</code> (you set
|
|
2449
2446
|
* <code>CloudFrontDefaultCertificate</code> to <code>true</code>), CloudFront automatically
|
|
2450
2447
|
* sets the security policy to <code>TLSv1</code> regardless of the value that you set
|
|
@@ -2455,22 +2452,22 @@ export interface ViewerCertificate {
|
|
|
2455
2452
|
* @deprecated
|
|
2456
2453
|
*
|
|
2457
2454
|
* <p>This field is deprecated. Use one of the following fields instead:</p>
|
|
2458
|
-
*
|
|
2455
|
+
* <ul>
|
|
2459
2456
|
* <li>
|
|
2460
|
-
*
|
|
2457
|
+
* <p>
|
|
2461
2458
|
* <code>ACMCertificateArn</code>
|
|
2462
2459
|
* </p>
|
|
2463
|
-
*
|
|
2460
|
+
* </li>
|
|
2464
2461
|
* <li>
|
|
2465
|
-
*
|
|
2462
|
+
* <p>
|
|
2466
2463
|
* <code>IAMCertificateId</code>
|
|
2467
2464
|
* </p>
|
|
2468
|
-
*
|
|
2465
|
+
* </li>
|
|
2469
2466
|
* <li>
|
|
2470
|
-
*
|
|
2467
|
+
* <p>
|
|
2471
2468
|
* <code>CloudFrontDefaultCertificate</code>
|
|
2472
2469
|
* </p>
|
|
2473
|
-
*
|
|
2470
|
+
* </li>
|
|
2474
2471
|
* </ul>
|
|
2475
2472
|
*/
|
|
2476
2473
|
Certificate?: string;
|
|
@@ -2478,22 +2475,22 @@ export interface ViewerCertificate {
|
|
|
2478
2475
|
* @deprecated
|
|
2479
2476
|
*
|
|
2480
2477
|
* <p>This field is deprecated. Use one of the following fields instead:</p>
|
|
2481
|
-
*
|
|
2478
|
+
* <ul>
|
|
2482
2479
|
* <li>
|
|
2483
|
-
*
|
|
2480
|
+
* <p>
|
|
2484
2481
|
* <code>ACMCertificateArn</code>
|
|
2485
2482
|
* </p>
|
|
2486
|
-
*
|
|
2483
|
+
* </li>
|
|
2487
2484
|
* <li>
|
|
2488
|
-
*
|
|
2485
|
+
* <p>
|
|
2489
2486
|
* <code>IAMCertificateId</code>
|
|
2490
2487
|
* </p>
|
|
2491
|
-
*
|
|
2488
|
+
* </li>
|
|
2492
2489
|
* <li>
|
|
2493
|
-
*
|
|
2490
|
+
* <p>
|
|
2494
2491
|
* <code>CloudFrontDefaultCertificate</code>
|
|
2495
2492
|
* </p>
|
|
2496
|
-
*
|
|
2493
|
+
* </li>
|
|
2497
2494
|
* </ul>
|
|
2498
2495
|
*/
|
|
2499
2496
|
CertificateSource?: CertificateSource | string;
|
|
@@ -2505,9 +2502,9 @@ export interface DistributionConfig {
|
|
|
2505
2502
|
/**
|
|
2506
2503
|
* <p>A unique value (for example, a date-time stamp) that ensures that the request can't be
|
|
2507
2504
|
* replayed.</p>
|
|
2508
|
-
*
|
|
2505
|
+
* <p>If the value of <code>CallerReference</code> is new (regardless of the content of the
|
|
2509
2506
|
* <code>DistributionConfig</code> object), CloudFront creates a new distribution.</p>
|
|
2510
|
-
*
|
|
2507
|
+
* <p>If <code>CallerReference</code> is a value that you already sent in a previous request
|
|
2511
2508
|
* to create a distribution, CloudFront returns a <code>DistributionAlreadyExists</code>
|
|
2512
2509
|
* error.</p>
|
|
2513
2510
|
*/
|
|
@@ -2523,25 +2520,25 @@ export interface DistributionConfig {
|
|
|
2523
2520
|
* (<code>https://www.example.com</code>) instead of an object in your distribution
|
|
2524
2521
|
* (<code>https://www.example.com/product-description.html</code>). Specifying a
|
|
2525
2522
|
* default root object avoids exposing the contents of your distribution.</p>
|
|
2526
|
-
*
|
|
2523
|
+
* <p>Specify only the object name, for example, <code>index.html</code>. Don't add a
|
|
2527
2524
|
* <code>/</code> before the object name.</p>
|
|
2528
|
-
*
|
|
2525
|
+
* <p>If you don't want to specify a default root object when you create a distribution,
|
|
2529
2526
|
* include an empty <code>DefaultRootObject</code> element.</p>
|
|
2530
|
-
*
|
|
2527
|
+
* <p>To delete the default root object from an existing distribution, update the
|
|
2531
2528
|
* distribution configuration and include an empty <code>DefaultRootObject</code>
|
|
2532
2529
|
* element.</p>
|
|
2533
|
-
*
|
|
2530
|
+
* <p>To replace the default root object, update the distribution configuration and specify
|
|
2534
2531
|
* the new object.</p>
|
|
2535
|
-
*
|
|
2532
|
+
* <p>For more information about the default root object, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/DefaultRootObject.html">Creating a
|
|
2536
2533
|
* Default Root Object</a> in the <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
2537
2534
|
*/
|
|
2538
2535
|
DefaultRootObject?: string;
|
|
2539
2536
|
/**
|
|
2540
|
-
* <p>A complex type that contains information about origins for this distribution
|
|
2537
|
+
* <p>A complex type that contains information about origins for this distribution.</p>
|
|
2541
2538
|
*/
|
|
2542
2539
|
Origins: Origins | undefined;
|
|
2543
2540
|
/**
|
|
2544
|
-
* <p>
|
|
2541
|
+
* <p>A complex type that contains information about origin groups for this
|
|
2545
2542
|
* distribution.</p>
|
|
2546
2543
|
*/
|
|
2547
2544
|
OriginGroups?: OriginGroups;
|
|
@@ -2553,33 +2550,33 @@ export interface DistributionConfig {
|
|
|
2553
2550
|
*/
|
|
2554
2551
|
DefaultCacheBehavior: DefaultCacheBehavior | undefined;
|
|
2555
2552
|
/**
|
|
2556
|
-
* <p>A complex type that contains zero or more <code>CacheBehavior</code> elements
|
|
2553
|
+
* <p>A complex type that contains zero or more <code>CacheBehavior</code> elements.</p>
|
|
2557
2554
|
*/
|
|
2558
2555
|
CacheBehaviors?: CacheBehaviors;
|
|
2559
2556
|
/**
|
|
2560
2557
|
* <p>A complex type that controls the following:</p>
|
|
2561
|
-
*
|
|
2558
|
+
* <ul>
|
|
2562
2559
|
* <li>
|
|
2563
|
-
*
|
|
2560
|
+
* <p>Whether CloudFront replaces HTTP status codes in the 4xx and 5xx range with custom
|
|
2564
2561
|
* error messages before returning the response to the viewer.</p>
|
|
2565
|
-
*
|
|
2562
|
+
* </li>
|
|
2566
2563
|
* <li>
|
|
2567
|
-
*
|
|
2568
|
-
*
|
|
2564
|
+
* <p>How long CloudFront caches HTTP status codes in the 4xx and 5xx range.</p>
|
|
2565
|
+
* </li>
|
|
2569
2566
|
* </ul>
|
|
2570
|
-
*
|
|
2567
|
+
* <p>For more information about custom error pages, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/custom-error-pages.html">Customizing
|
|
2571
2568
|
* Error Responses</a> in the <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
2572
2569
|
*/
|
|
2573
2570
|
CustomErrorResponses?: CustomErrorResponses;
|
|
2574
2571
|
/**
|
|
2575
|
-
* <p>
|
|
2572
|
+
* <p>A comment to describe the distribution. The comment cannot be longer than
|
|
2576
2573
|
* 128 characters.</p>
|
|
2577
2574
|
*/
|
|
2578
2575
|
Comment: string | undefined;
|
|
2579
2576
|
/**
|
|
2580
2577
|
* <p>A complex type that controls whether access logs are written for the
|
|
2581
2578
|
* distribution.</p>
|
|
2582
|
-
*
|
|
2579
|
+
* <p>For more information about logging, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/AccessLogs.html">Access Logs</a> in
|
|
2583
2580
|
* the <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
2584
2581
|
*/
|
|
2585
2582
|
Logging?: LoggingConfig;
|
|
@@ -2587,11 +2584,11 @@ export interface DistributionConfig {
|
|
|
2587
2584
|
* <p>The price class that corresponds with the maximum price that you want to pay for CloudFront
|
|
2588
2585
|
* service. If you specify <code>PriceClass_All</code>, CloudFront responds to requests for your
|
|
2589
2586
|
* objects from all CloudFront edge locations.</p>
|
|
2590
|
-
*
|
|
2587
|
+
* <p>If you specify a price class other than <code>PriceClass_All</code>, CloudFront serves your
|
|
2591
2588
|
* objects from the CloudFront edge location that has the lowest latency among the edge locations
|
|
2592
2589
|
* in your price class. Viewers who are in or near regions that are excluded from your
|
|
2593
2590
|
* specified price class may encounter slower performance.</p>
|
|
2594
|
-
*
|
|
2591
|
+
* <p>For more information about price classes, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/PriceClass.html">Choosing the Price
|
|
2595
2592
|
* Class for a CloudFront Distribution</a> in the <i>Amazon CloudFront Developer Guide</i>.
|
|
2596
2593
|
* For information about CloudFront pricing, including how price classes (such as Price Class
|
|
2597
2594
|
* 100) map to CloudFront regions, see <a href="http://aws.amazon.com/cloudfront/pricing/">Amazon CloudFront
|
|
@@ -2603,7 +2600,7 @@ export interface DistributionConfig {
|
|
|
2603
2600
|
*/
|
|
2604
2601
|
Enabled: boolean | undefined;
|
|
2605
2602
|
/**
|
|
2606
|
-
* <p>A complex type that determines the distribution
|
|
2603
|
+
* <p>A complex type that determines the distribution's SSL/TLS configuration for
|
|
2607
2604
|
* communicating with viewers.</p>
|
|
2608
2605
|
*/
|
|
2609
2606
|
ViewerCertificate?: ViewerCertificate;
|
|
@@ -2619,13 +2616,13 @@ export interface DistributionConfig {
|
|
|
2619
2616
|
* <code>arn:aws:wafv2:us-east-1:123456789012:global/webacl/ExampleWebACL/473e64fd-f30b-4765-81a0-62ad96dd167a</code>.
|
|
2620
2617
|
* To specify a web ACL created using WAF Classic, use the ACL ID, for example
|
|
2621
2618
|
* <code>473e64fd-f30b-4765-81a0-62ad96dd167a</code>.</p>
|
|
2622
|
-
*
|
|
2619
|
+
* <p>WAF is a web application firewall that lets you monitor the HTTP and HTTPS requests
|
|
2623
2620
|
* that are forwarded to CloudFront, and lets you control access to your content. Based on
|
|
2624
2621
|
* conditions that you specify, such as the IP addresses that requests originate from or
|
|
2625
2622
|
* the values of query strings, CloudFront responds to requests either with the requested content
|
|
2626
2623
|
* or with an HTTP 403 status code (Forbidden). You can also configure CloudFront to return a
|
|
2627
2624
|
* custom error page when a request is blocked. For more information about WAF, see the
|
|
2628
|
-
* <a href="https://docs.aws.amazon.com/waf/latest/developerguide/what-is-aws-waf.html">WAF Developer Guide</a
|
|
2625
|
+
* <a href="https://docs.aws.amazon.com/waf/latest/developerguide/what-is-aws-waf.html">WAF Developer Guide</a>.</p>
|
|
2629
2626
|
*/
|
|
2630
2627
|
WebACLId?: string;
|
|
2631
2628
|
/**
|
|
@@ -2633,9 +2630,9 @@ export interface DistributionConfig {
|
|
|
2633
2630
|
* communicate with CloudFront. The default value for new web distributions is
|
|
2634
2631
|
* <code>http2</code>. Viewers that don't support HTTP/2 automatically use an earlier HTTP
|
|
2635
2632
|
* version.</p>
|
|
2636
|
-
*
|
|
2633
|
+
* <p>For viewers and CloudFront to use HTTP/2, viewers must support TLSv1.2 or later, and must
|
|
2637
2634
|
* support Server Name Indication (SNI).</p>
|
|
2638
|
-
*
|
|
2635
|
+
* <p>For viewers and CloudFront to use HTTP/3, viewers must support TLSv1.3 and Server Name
|
|
2639
2636
|
* Indication (SNI). CloudFront supports HTTP/3 connection migration to allow the viewer to
|
|
2640
2637
|
* switch networks without losing connection. For more information about connection
|
|
2641
2638
|
* migration, see <a href="https://www.rfc-editor.org/rfc/rfc9000.html#name-connection-migration">Connection Migration</a> at RFC 9000. For more information about supported
|
|
@@ -2647,8 +2644,8 @@ export interface DistributionConfig {
|
|
|
2647
2644
|
* distribution, specify <code>true</code>. If you specify <code>false</code>, CloudFront
|
|
2648
2645
|
* responds to IPv6 DNS requests with the DNS response code <code>NOERROR</code> and with
|
|
2649
2646
|
* no IP addresses. This allows viewers to submit a second request, for an IPv4 address for
|
|
2650
|
-
* your distribution
|
|
2651
|
-
*
|
|
2647
|
+
* your distribution.</p>
|
|
2648
|
+
* <p>In general, you should enable IPv6 if you have users on IPv6 networks who want to
|
|
2652
2649
|
* access your content. However, if you're using signed URLs or signed cookies to restrict
|
|
2653
2650
|
* access to your content, and if you're using a custom policy that includes the
|
|
2654
2651
|
* <code>IpAddress</code> parameter to restrict the IP addresses that can access your
|
|
@@ -2656,21 +2653,21 @@ export interface DistributionConfig {
|
|
|
2656
2653
|
* and not restrict access to other content (or restrict access but not by IP address), you
|
|
2657
2654
|
* can create two distributions. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/private-content-creating-signed-url-custom-policy.html">Creating a Signed URL Using a Custom Policy</a> in the
|
|
2658
2655
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
2659
|
-
*
|
|
2656
|
+
* <p>If you're using an Route 53 Amazon Web Services Integration alias resource record set to route traffic to your CloudFront
|
|
2660
2657
|
* distribution, you need to create a second alias resource record set when both of the
|
|
2661
2658
|
* following are true:</p>
|
|
2662
|
-
*
|
|
2659
|
+
* <ul>
|
|
2663
2660
|
* <li>
|
|
2664
|
-
*
|
|
2665
|
-
*
|
|
2661
|
+
* <p>You enable IPv6 for the distribution</p>
|
|
2662
|
+
* </li>
|
|
2666
2663
|
* <li>
|
|
2667
|
-
*
|
|
2668
|
-
*
|
|
2664
|
+
* <p>You're using alternate domain names in the URLs for your objects</p>
|
|
2665
|
+
* </li>
|
|
2669
2666
|
* </ul>
|
|
2670
|
-
*
|
|
2667
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-to-cloudfront-distribution.html">Routing
|
|
2671
2668
|
* Traffic to an Amazon CloudFront Web Distribution by Using Your Domain Name</a> in the
|
|
2672
2669
|
* <i>Route 53 Amazon Web Services Integration Developer Guide</i>.</p>
|
|
2673
|
-
*
|
|
2670
|
+
* <p>If you created a CNAME resource record set, either with Route 53 Amazon Web Services Integration or with another DNS
|
|
2674
2671
|
* service, you don't need to make any changes. A CNAME record will route traffic to your
|
|
2675
2672
|
* distribution regardless of the IP address format of the viewer request.</p>
|
|
2676
2673
|
*/
|
|
@@ -2693,16 +2690,16 @@ export interface DistributionConfig {
|
|
|
2693
2690
|
*/
|
|
2694
2691
|
export interface Distribution {
|
|
2695
2692
|
/**
|
|
2696
|
-
* <p>The distribution
|
|
2693
|
+
* <p>The distribution's identifier. For example: <code>E1U5RQF7T870K0</code>.</p>
|
|
2697
2694
|
*/
|
|
2698
2695
|
Id: string | undefined;
|
|
2699
2696
|
/**
|
|
2700
|
-
* <p>The distribution
|
|
2697
|
+
* <p>The distribution's Amazon Resource Name (ARN).</p>
|
|
2701
2698
|
*/
|
|
2702
2699
|
ARN: string | undefined;
|
|
2703
2700
|
/**
|
|
2704
|
-
* <p>The distribution
|
|
2705
|
-
* distribution
|
|
2701
|
+
* <p>The distribution's status. When the status is <code>Deployed</code>, the
|
|
2702
|
+
* distribution's information is fully propagated to all CloudFront edge locations.</p>
|
|
2706
2703
|
*/
|
|
2707
2704
|
Status: string | undefined;
|
|
2708
2705
|
/**
|
|
@@ -2710,34 +2707,31 @@ export interface Distribution {
|
|
|
2710
2707
|
*/
|
|
2711
2708
|
LastModifiedTime: Date | undefined;
|
|
2712
2709
|
/**
|
|
2713
|
-
* <p>The number of invalidation batches currently in progress
|
|
2710
|
+
* <p>The number of invalidation batches currently in progress.</p>
|
|
2714
2711
|
*/
|
|
2715
2712
|
InProgressInvalidationBatches: number | undefined;
|
|
2716
2713
|
/**
|
|
2717
|
-
* <p>The distribution
|
|
2714
|
+
* <p>The distribution's CloudFront domain name. For example:
|
|
2718
2715
|
* <code>d111111abcdef8.cloudfront.net</code>.</p>
|
|
2719
2716
|
*/
|
|
2720
2717
|
DomainName: string | undefined;
|
|
2721
2718
|
/**
|
|
2722
2719
|
* <important>
|
|
2723
|
-
*
|
|
2720
|
+
* <p>We recommend using <code>TrustedKeyGroups</code> instead of
|
|
2724
2721
|
* <code>TrustedSigners</code>.</p>
|
|
2725
|
-
*
|
|
2726
|
-
*
|
|
2727
|
-
*
|
|
2728
|
-
*
|
|
2729
|
-
* CloudFront can use to verify the signatures of signed URLs or signed cookies.</p>
|
|
2722
|
+
* </important>
|
|
2723
|
+
* <p>This field contains a list of Amazon Web Services account IDs and the active CloudFront key pairs in each
|
|
2724
|
+
* account that CloudFront can use to verify the signatures of signed URLs or signed
|
|
2725
|
+
* cookies.</p>
|
|
2730
2726
|
*/
|
|
2731
2727
|
ActiveTrustedSigners?: ActiveTrustedSigners;
|
|
2732
2728
|
/**
|
|
2733
|
-
* <p>
|
|
2734
|
-
*
|
|
2735
|
-
* contains a list of key groups and the public keys in each key group that CloudFront can use to
|
|
2736
|
-
* verify the signatures of signed URLs or signed cookies.</p>
|
|
2729
|
+
* <p>This field contains a list of key groups and the public keys in each key group that
|
|
2730
|
+
* CloudFront can use to verify the signatures of signed URLs or signed cookies.</p>
|
|
2737
2731
|
*/
|
|
2738
2732
|
ActiveTrustedKeyGroups?: ActiveTrustedKeyGroups;
|
|
2739
2733
|
/**
|
|
2740
|
-
* <p>The distribution
|
|
2734
|
+
* <p>The distribution's configuration.</p>
|
|
2741
2735
|
*/
|
|
2742
2736
|
DistributionConfig: DistributionConfig | undefined;
|
|
2743
2737
|
/**
|
|
@@ -2745,7 +2739,7 @@ export interface Distribution {
|
|
|
2745
2739
|
* recordal if they want to serve content publicly on an alternate domain name, also known
|
|
2746
2740
|
* as a CNAME, that they've added to CloudFront. AliasICPRecordal provides the ICP recordal
|
|
2747
2741
|
* status for CNAMEs associated with distributions.</p>
|
|
2748
|
-
*
|
|
2742
|
+
* <p>For more information about ICP recordals, see <a href="https://docs.amazonaws.cn/en_us/aws/latest/userguide/accounts-and-credentials.html"> Signup, Accounts, and Credentials</a> in <i>Getting Started with Amazon Web Services
|
|
2749
2743
|
* services in China</i>.</p>
|
|
2750
2744
|
*/
|
|
2751
2745
|
AliasICPRecordals?: AliasICPRecordal[];
|
|
@@ -3128,7 +3122,7 @@ export declare class NoSuchFieldLevelEncryptionConfig extends __BaseException {
|
|
|
3128
3122
|
constructor(opts: __ExceptionOptionType<NoSuchFieldLevelEncryptionConfig, __BaseException>);
|
|
3129
3123
|
}
|
|
3130
3124
|
/**
|
|
3131
|
-
* <p>No origin exists with the specified <code>Origin Id</code
|
|
3125
|
+
* <p>No origin exists with the specified <code>Origin Id</code>.</p>
|
|
3132
3126
|
*/
|
|
3133
3127
|
export declare class NoSuchOrigin extends __BaseException {
|
|
3134
3128
|
readonly name: "NoSuchOrigin";
|
|
@@ -3308,7 +3302,7 @@ export declare class TooManyDistributionsAssociatedToOriginRequestPolicy extends
|
|
|
3308
3302
|
/**
|
|
3309
3303
|
* <p>The maximum number of distributions have been associated with the specified response
|
|
3310
3304
|
* headers policy.</p>
|
|
3311
|
-
*
|
|
3305
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/cloudfront-limits.html">Quotas</a> (formerly known as limits) in the
|
|
3312
3306
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
3313
3307
|
*/
|
|
3314
3308
|
export declare class TooManyDistributionsAssociatedToResponseHeadersPolicy extends __BaseException {
|
|
@@ -3593,20 +3587,20 @@ export declare class CloudFrontOriginAccessIdentityAlreadyExists extends __BaseE
|
|
|
3593
3587
|
/**
|
|
3594
3588
|
* <p>Origin access identity configuration. Send a <code>GET</code> request to the
|
|
3595
3589
|
* <code>/<i>CloudFront API version</i>/CloudFront/identity ID/config</code>
|
|
3596
|
-
* resource
|
|
3590
|
+
* resource.</p>
|
|
3597
3591
|
*/
|
|
3598
3592
|
export interface CloudFrontOriginAccessIdentityConfig {
|
|
3599
3593
|
/**
|
|
3600
3594
|
* <p>A unique value (for example, a date-time stamp) that ensures that the request can't be
|
|
3601
3595
|
* replayed.</p>
|
|
3602
|
-
*
|
|
3596
|
+
* <p>If the value of <code>CallerReference</code> is new (regardless of the content of the
|
|
3603
3597
|
* <code>CloudFrontOriginAccessIdentityConfig</code> object), a new origin access
|
|
3604
3598
|
* identity is created.</p>
|
|
3605
|
-
*
|
|
3599
|
+
* <p>If the <code>CallerReference</code> is a value already sent in a previous identity
|
|
3606
3600
|
* request, and the content of the <code>CloudFrontOriginAccessIdentityConfig</code> is
|
|
3607
3601
|
* identical to the original request (ignoring white space), the response includes the same
|
|
3608
|
-
* information returned to the original request
|
|
3609
|
-
*
|
|
3602
|
+
* information returned to the original request.</p>
|
|
3603
|
+
* <p>If the <code>CallerReference</code> is a value you already sent in a previous request
|
|
3610
3604
|
* to create an identity, but the content of the
|
|
3611
3605
|
* <code>CloudFrontOriginAccessIdentityConfig</code> is different from the original
|
|
3612
3606
|
* request, CloudFront returns a <code>CloudFrontOriginAccessIdentityAlreadyExists</code> error.
|
|
@@ -3623,7 +3617,7 @@ export interface CloudFrontOriginAccessIdentityConfig {
|
|
|
3623
3617
|
* <p>The request to create a new origin access identity (OAI). An origin access identity is
|
|
3624
3618
|
* a special CloudFront user that you can associate with Amazon S3 origins, so that you can secure all
|
|
3625
3619
|
* or just some of your Amazon S3 content. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/private-content-restricting-access-to-s3.html"> Restricting Access to Amazon S3 Content by Using an Origin Access Identity</a> in
|
|
3626
|
-
* the <i>Amazon CloudFront Developer Guide</i
|
|
3620
|
+
* the <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
3627
3621
|
*/
|
|
3628
3622
|
export interface CreateCloudFrontOriginAccessIdentityRequest {
|
|
3629
3623
|
/**
|
|
@@ -3642,11 +3636,11 @@ export interface CloudFrontOriginAccessIdentity {
|
|
|
3642
3636
|
Id: string | undefined;
|
|
3643
3637
|
/**
|
|
3644
3638
|
* <p>The Amazon S3 canonical user ID for the origin access identity, used when giving the origin
|
|
3645
|
-
* access identity read permission to an object in Amazon S3
|
|
3639
|
+
* access identity read permission to an object in Amazon S3.</p>
|
|
3646
3640
|
*/
|
|
3647
3641
|
S3CanonicalUserId: string | undefined;
|
|
3648
3642
|
/**
|
|
3649
|
-
* <p>The current configuration information for the identity
|
|
3643
|
+
* <p>The current configuration information for the identity.</p>
|
|
3650
3644
|
*/
|
|
3651
3645
|
CloudFrontOriginAccessIdentityConfig?: CloudFrontOriginAccessIdentityConfig;
|
|
3652
3646
|
}
|
|
@@ -3714,7 +3708,7 @@ export interface StagingDistributionDnsNames {
|
|
|
3714
3708
|
export interface ContinuousDeploymentSingleHeaderConfig {
|
|
3715
3709
|
/**
|
|
3716
3710
|
* <p>The request header name that you want CloudFront to send to your staging
|
|
3717
|
-
* distribution
|
|
3711
|
+
* distribution. The header must contain the prefix <code>aws-cf-cd-</code>.</p>
|
|
3718
3712
|
*/
|
|
3719
3713
|
Header: string | undefined;
|
|
3720
3714
|
/**
|
|
@@ -3731,15 +3725,14 @@ export interface ContinuousDeploymentSingleHeaderConfig {
|
|
|
3731
3725
|
export interface SessionStickinessConfig {
|
|
3732
3726
|
/**
|
|
3733
3727
|
* <p>The amount of time after which you want sessions to cease if no requests are
|
|
3734
|
-
* received.
|
|
3735
|
-
|
|
3736
|
-
* <p>The value must be less than or equal to <code>MaximumTTL</code>.</p>
|
|
3728
|
+
* received. Allowed values are 300–3600 seconds (5–60 minutes).</p>
|
|
3729
|
+
* <p>The value must be less than or equal to <code>MaximumTTL</code>.</p>
|
|
3737
3730
|
*/
|
|
3738
3731
|
IdleTTL: number | undefined;
|
|
3739
3732
|
/**
|
|
3740
3733
|
* <p>The maximum amount of time to consider requests from the viewer as being part of the
|
|
3741
3734
|
* same session. Allowed values are 300–3600 seconds (5–60 minutes).</p>
|
|
3742
|
-
*
|
|
3735
|
+
* <p>The value must be less than or equal to <code>IdleTTL</code>.</p>
|
|
3743
3736
|
*/
|
|
3744
3737
|
MaximumTTL: number | undefined;
|
|
3745
3738
|
}
|
|
@@ -3932,7 +3925,7 @@ export declare class InvalidDomainNameForOriginAccessControl extends __BaseExcep
|
|
|
3932
3925
|
constructor(opts: __ExceptionOptionType<InvalidDomainNameForOriginAccessControl, __BaseException>);
|
|
3933
3926
|
}
|
|
3934
3927
|
/**
|
|
3935
|
-
* <p>The continuous deployment policy doesn
|
|
3928
|
+
* <p>The continuous deployment policy doesn't exist.</p>
|
|
3936
3929
|
*/
|
|
3937
3930
|
export declare class NoSuchContinuousDeploymentPolicy extends __BaseException {
|
|
3938
3931
|
readonly name: "NoSuchContinuousDeploymentPolicy";
|
|
@@ -3946,7 +3939,7 @@ export declare class NoSuchContinuousDeploymentPolicy extends __BaseException {
|
|
|
3946
3939
|
/**
|
|
3947
3940
|
* <p>The maximum number of distributions have been associated with the specified origin
|
|
3948
3941
|
* access control.</p>
|
|
3949
|
-
*
|
|
3942
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/cloudfront-limits.html">Quotas</a> (formerly known as limits) in the
|
|
3950
3943
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
3951
3944
|
*/
|
|
3952
3945
|
export declare class TooManyDistributionsAssociatedToOriginAccessControl extends __BaseException {
|
|
@@ -3959,30 +3952,30 @@ export declare class TooManyDistributionsAssociatedToOriginAccessControl extends
|
|
|
3959
3952
|
constructor(opts: __ExceptionOptionType<TooManyDistributionsAssociatedToOriginAccessControl, __BaseException>);
|
|
3960
3953
|
}
|
|
3961
3954
|
/**
|
|
3962
|
-
* <p>
|
|
3955
|
+
* <p>A complex type that contains <code>Tag</code> key and <code>Tag</code> value.</p>
|
|
3963
3956
|
*/
|
|
3964
3957
|
export interface Tag {
|
|
3965
3958
|
/**
|
|
3966
|
-
* <p>
|
|
3967
|
-
*
|
|
3959
|
+
* <p>A string that contains <code>Tag</code> key.</p>
|
|
3960
|
+
* <p>The string length should be between 1 and 128 characters. Valid characters include
|
|
3968
3961
|
* <code>a-z</code>, <code>A-Z</code>, <code>0-9</code>, space, and the special
|
|
3969
3962
|
* characters <code>_ - . : / = + @</code>.</p>
|
|
3970
3963
|
*/
|
|
3971
3964
|
Key: string | undefined;
|
|
3972
3965
|
/**
|
|
3973
|
-
* <p>
|
|
3974
|
-
*
|
|
3966
|
+
* <p>A string that contains an optional <code>Tag</code> value.</p>
|
|
3967
|
+
* <p>The string length should be between 0 and 256 characters. Valid characters include
|
|
3975
3968
|
* <code>a-z</code>, <code>A-Z</code>, <code>0-9</code>, space, and the special
|
|
3976
3969
|
* characters <code>_ - . : / = + @</code>.</p>
|
|
3977
3970
|
*/
|
|
3978
3971
|
Value?: string;
|
|
3979
3972
|
}
|
|
3980
3973
|
/**
|
|
3981
|
-
* <p>
|
|
3974
|
+
* <p>A complex type that contains zero or more <code>Tag</code> elements.</p>
|
|
3982
3975
|
*/
|
|
3983
3976
|
export interface Tags {
|
|
3984
3977
|
/**
|
|
3985
|
-
* <p>
|
|
3978
|
+
* <p>A complex type that contains <code>Tag</code> elements.</p>
|
|
3986
3979
|
*/
|
|
3987
3980
|
Items?: Tag[];
|
|
3988
3981
|
}
|
|
@@ -4001,20 +3994,20 @@ export interface DistributionConfigWithTags {
|
|
|
4001
3994
|
Tags: Tags | undefined;
|
|
4002
3995
|
}
|
|
4003
3996
|
/**
|
|
4004
|
-
* <p>The request to create a new distribution with tags
|
|
3997
|
+
* <p>The request to create a new distribution with tags.</p>
|
|
4005
3998
|
*/
|
|
4006
3999
|
export interface CreateDistributionWithTagsRequest {
|
|
4007
4000
|
/**
|
|
4008
|
-
* <p>The distribution's configuration information
|
|
4001
|
+
* <p>The distribution's configuration information.</p>
|
|
4009
4002
|
*/
|
|
4010
4003
|
DistributionConfigWithTags: DistributionConfigWithTags | undefined;
|
|
4011
4004
|
}
|
|
4012
4005
|
/**
|
|
4013
|
-
* <p>The returned result of the corresponding request
|
|
4006
|
+
* <p>The returned result of the corresponding request.</p>
|
|
4014
4007
|
*/
|
|
4015
4008
|
export interface CreateDistributionWithTagsResult {
|
|
4016
4009
|
/**
|
|
4017
|
-
* <p>The distribution's information
|
|
4010
|
+
* <p>The distribution's information.</p>
|
|
4018
4011
|
*/
|
|
4019
4012
|
Distribution?: Distribution;
|
|
4020
4013
|
/**
|
|
@@ -4042,48 +4035,48 @@ export declare enum Format {
|
|
|
4042
4035
|
URLEncoded = "URLEncoded"
|
|
4043
4036
|
}
|
|
4044
4037
|
/**
|
|
4045
|
-
* <p>A field-level encryption content type profile
|
|
4038
|
+
* <p>A field-level encryption content type profile.</p>
|
|
4046
4039
|
*/
|
|
4047
4040
|
export interface ContentTypeProfile {
|
|
4048
4041
|
/**
|
|
4049
|
-
* <p>The format for a field-level encryption content type-profile mapping
|
|
4042
|
+
* <p>The format for a field-level encryption content type-profile mapping.</p>
|
|
4050
4043
|
*/
|
|
4051
4044
|
Format: Format | string | undefined;
|
|
4052
4045
|
/**
|
|
4053
|
-
* <p>The profile ID for a field-level encryption content type-profile mapping
|
|
4046
|
+
* <p>The profile ID for a field-level encryption content type-profile mapping.</p>
|
|
4054
4047
|
*/
|
|
4055
4048
|
ProfileId?: string;
|
|
4056
4049
|
/**
|
|
4057
|
-
* <p>The content type for a field-level encryption content type-profile mapping
|
|
4050
|
+
* <p>The content type for a field-level encryption content type-profile mapping.</p>
|
|
4058
4051
|
*/
|
|
4059
4052
|
ContentType: string | undefined;
|
|
4060
4053
|
}
|
|
4061
4054
|
/**
|
|
4062
|
-
* <p>Field-level encryption content type-profile
|
|
4055
|
+
* <p>Field-level encryption content type-profile.</p>
|
|
4063
4056
|
*/
|
|
4064
4057
|
export interface ContentTypeProfiles {
|
|
4065
4058
|
/**
|
|
4066
|
-
* <p>The number of field-level encryption content type-profile mappings
|
|
4059
|
+
* <p>The number of field-level encryption content type-profile mappings.</p>
|
|
4067
4060
|
*/
|
|
4068
4061
|
Quantity: number | undefined;
|
|
4069
4062
|
/**
|
|
4070
|
-
* <p>Items in a field-level encryption content type-profile mapping
|
|
4063
|
+
* <p>Items in a field-level encryption content type-profile mapping.</p>
|
|
4071
4064
|
*/
|
|
4072
4065
|
Items?: ContentTypeProfile[];
|
|
4073
4066
|
}
|
|
4074
4067
|
/**
|
|
4075
|
-
* <p>The configuration for a field-level encryption content type-profile mapping
|
|
4068
|
+
* <p>The configuration for a field-level encryption content type-profile mapping.</p>
|
|
4076
4069
|
*/
|
|
4077
4070
|
export interface ContentTypeProfileConfig {
|
|
4078
4071
|
/**
|
|
4079
4072
|
* <p>The setting in a field-level encryption content type-profile mapping that specifies
|
|
4080
4073
|
* what to do when an unknown content type is provided for the profile. If true, content is
|
|
4081
4074
|
* forwarded without being encrypted when the content type is unknown. If false (the
|
|
4082
|
-
* default), an error is returned when the content type is unknown
|
|
4075
|
+
* default), an error is returned when the content type is unknown.</p>
|
|
4083
4076
|
*/
|
|
4084
4077
|
ForwardWhenContentTypeIsUnknown: boolean | undefined;
|
|
4085
4078
|
/**
|
|
4086
|
-
* <p>The configuration for a field-level encryption content type-profile
|
|
4079
|
+
* <p>The configuration for a field-level encryption content type-profile.</p>
|
|
4087
4080
|
*/
|
|
4088
4081
|
ContentTypeProfiles?: ContentTypeProfiles;
|
|
4089
4082
|
}
|
|
@@ -4131,7 +4124,7 @@ export interface QueryArgProfileConfig {
|
|
|
4131
4124
|
}
|
|
4132
4125
|
/**
|
|
4133
4126
|
* <p>A complex data type that includes the profile configurations specified for field-level
|
|
4134
|
-
* encryption
|
|
4127
|
+
* encryption.</p>
|
|
4135
4128
|
*/
|
|
4136
4129
|
export interface FieldLevelEncryptionConfig {
|
|
4137
4130
|
/**
|
|
@@ -4163,7 +4156,7 @@ export interface CreateFieldLevelEncryptionConfigRequest {
|
|
|
4163
4156
|
}
|
|
4164
4157
|
/**
|
|
4165
4158
|
* <p>A complex data type that includes the profile configurations and other options
|
|
4166
|
-
* specified for field-level encryption
|
|
4159
|
+
* specified for field-level encryption.</p>
|
|
4167
4160
|
*/
|
|
4168
4161
|
export interface FieldLevelEncryption {
|
|
4169
4162
|
/**
|
|
@@ -4173,12 +4166,12 @@ export interface FieldLevelEncryption {
|
|
|
4173
4166
|
*/
|
|
4174
4167
|
Id: string | undefined;
|
|
4175
4168
|
/**
|
|
4176
|
-
* <p>The last time the field-level encryption configuration was changed
|
|
4169
|
+
* <p>The last time the field-level encryption configuration was changed.</p>
|
|
4177
4170
|
*/
|
|
4178
4171
|
LastModifiedTime: Date | undefined;
|
|
4179
4172
|
/**
|
|
4180
4173
|
* <p>A complex data type that includes the profile configurations specified for field-level
|
|
4181
|
-
* encryption
|
|
4174
|
+
* encryption.</p>
|
|
4182
4175
|
*/
|
|
4183
4176
|
FieldLevelEncryptionConfig: FieldLevelEncryptionConfig | undefined;
|
|
4184
4177
|
}
|
|
@@ -4288,12 +4281,12 @@ export interface FieldPatterns {
|
|
|
4288
4281
|
}
|
|
4289
4282
|
/**
|
|
4290
4283
|
* <p>Complex data type for field-level encryption profiles that includes the encryption key
|
|
4291
|
-
* and field pattern specifications
|
|
4284
|
+
* and field pattern specifications.</p>
|
|
4292
4285
|
*/
|
|
4293
4286
|
export interface EncryptionEntity {
|
|
4294
4287
|
/**
|
|
4295
4288
|
* <p>The public key associated with a set of field-level encryption patterns, to be used
|
|
4296
|
-
* when encrypting the fields that match the patterns
|
|
4289
|
+
* when encrypting the fields that match the patterns.</p>
|
|
4297
4290
|
*/
|
|
4298
4291
|
PublicKeyId: string | undefined;
|
|
4299
4292
|
/**
|
|
@@ -4306,18 +4299,18 @@ export interface EncryptionEntity {
|
|
|
4306
4299
|
* <p>Field patterns in a field-level encryption content type profile specify the fields
|
|
4307
4300
|
* that you want to be encrypted. You can provide the full field name, or any beginning
|
|
4308
4301
|
* characters followed by a wildcard (*). You can't overlap field patterns. For example,
|
|
4309
|
-
* you can't have both ABC* and AB*. Note that field patterns are case-sensitive
|
|
4302
|
+
* you can't have both ABC* and AB*. Note that field patterns are case-sensitive.</p>
|
|
4310
4303
|
*/
|
|
4311
4304
|
FieldPatterns: FieldPatterns | undefined;
|
|
4312
4305
|
}
|
|
4313
4306
|
/**
|
|
4314
4307
|
* <p>Complex data type for field-level encryption profiles that includes all of the
|
|
4315
|
-
* encryption entities
|
|
4308
|
+
* encryption entities.</p>
|
|
4316
4309
|
*/
|
|
4317
4310
|
export interface EncryptionEntities {
|
|
4318
4311
|
/**
|
|
4319
4312
|
* <p>Number of field pattern items in a field-level encryption content type-profile
|
|
4320
|
-
* mapping
|
|
4313
|
+
* mapping.</p>
|
|
4321
4314
|
*/
|
|
4322
4315
|
Quantity: number | undefined;
|
|
4323
4316
|
/**
|
|
@@ -4477,7 +4470,7 @@ export interface FunctionConfig {
|
|
|
4477
4470
|
*/
|
|
4478
4471
|
Comment: string | undefined;
|
|
4479
4472
|
/**
|
|
4480
|
-
* <p>The function
|
|
4473
|
+
* <p>The function's runtime environment. The only valid value is
|
|
4481
4474
|
* <code>cloudfront-js-1.0</code>.</p>
|
|
4482
4475
|
*/
|
|
4483
4476
|
Runtime: FunctionRuntime | string | undefined;
|
|
@@ -4489,7 +4482,7 @@ export interface CreateFunctionRequest {
|
|
|
4489
4482
|
Name: string | undefined;
|
|
4490
4483
|
/**
|
|
4491
4484
|
* <p>Configuration information about the function, including an optional comment and the
|
|
4492
|
-
* function
|
|
4485
|
+
* function's runtime.</p>
|
|
4493
4486
|
*/
|
|
4494
4487
|
FunctionConfig: FunctionConfig | undefined;
|
|
4495
4488
|
/**
|
|
@@ -4515,10 +4508,10 @@ export interface FunctionMetadata {
|
|
|
4515
4508
|
/**
|
|
4516
4509
|
* <p>The stage that the function is in, either <code>DEVELOPMENT</code> or
|
|
4517
4510
|
* <code>LIVE</code>.</p>
|
|
4518
|
-
*
|
|
4511
|
+
* <p>When a function is in the <code>DEVELOPMENT</code> stage, you can test the function
|
|
4519
4512
|
* with <code>TestFunction</code>, and update it with <code>UpdateFunction</code>.</p>
|
|
4520
|
-
*
|
|
4521
|
-
* distribution
|
|
4513
|
+
* <p>When a function is in the <code>LIVE</code> stage, you can attach the function to a
|
|
4514
|
+
* distribution's cache behavior, using the function's ARN.</p>
|
|
4522
4515
|
*/
|
|
4523
4516
|
Stage?: FunctionStage | string;
|
|
4524
4517
|
/**
|
|
@@ -4622,7 +4615,7 @@ export declare class UnsupportedOperation extends __BaseException {
|
|
|
4622
4615
|
/**
|
|
4623
4616
|
* <p>A complex type that contains information about the objects that you want to
|
|
4624
4617
|
* invalidate. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Invalidation.html#invalidation-specifying-objects">Specifying the Objects to Invalidate</a> in the
|
|
4625
|
-
* <i>Amazon CloudFront Developer Guide</i
|
|
4618
|
+
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
4626
4619
|
*/
|
|
4627
4620
|
export interface Paths {
|
|
4628
4621
|
/**
|
|
@@ -4642,7 +4635,7 @@ export interface InvalidationBatch {
|
|
|
4642
4635
|
/**
|
|
4643
4636
|
* <p>A complex type that contains information about the objects that you want to
|
|
4644
4637
|
* invalidate. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Invalidation.html#invalidation-specifying-objects">Specifying the Objects to Invalidate</a> in the
|
|
4645
|
-
* <i>Amazon CloudFront Developer Guide</i
|
|
4638
|
+
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
4646
4639
|
*/
|
|
4647
4640
|
Paths: Paths | undefined;
|
|
4648
4641
|
/**
|
|
@@ -4652,12 +4645,12 @@ export interface InvalidationBatch {
|
|
|
4652
4645
|
* <code>CallerReference</code> and change other values in the request as applicable.
|
|
4653
4646
|
* One way to ensure that the value of <code>CallerReference</code> is unique is to use a
|
|
4654
4647
|
* <code>timestamp</code>, for example, <code>20120301090000</code>.</p>
|
|
4655
|
-
*
|
|
4648
|
+
* <p>If you make a second invalidation request with the same value for
|
|
4656
4649
|
* <code>CallerReference</code>, and if the rest of the request is the same, CloudFront
|
|
4657
4650
|
* doesn't create a new invalidation request. Instead, CloudFront returns information about the
|
|
4658
4651
|
* invalidation request that you previously created with the same
|
|
4659
4652
|
* <code>CallerReference</code>.</p>
|
|
4660
|
-
*
|
|
4653
|
+
* <p>If <code>CallerReference</code> is a value you already sent in a previous invalidation
|
|
4661
4654
|
* batch request but the content of any <code>Path</code> is different from the original
|
|
4662
4655
|
* request, CloudFront returns an <code>InvalidationBatchAlreadyExists</code> error.</p>
|
|
4663
4656
|
*/
|
|
@@ -4677,7 +4670,7 @@ export interface CreateInvalidationRequest {
|
|
|
4677
4670
|
InvalidationBatch: InvalidationBatch | undefined;
|
|
4678
4671
|
}
|
|
4679
4672
|
/**
|
|
4680
|
-
* <p>An invalidation
|
|
4673
|
+
* <p>An invalidation.</p>
|
|
4681
4674
|
*/
|
|
4682
4675
|
export interface Invalidation {
|
|
4683
4676
|
/**
|
|
@@ -4691,11 +4684,11 @@ export interface Invalidation {
|
|
|
4691
4684
|
*/
|
|
4692
4685
|
Status: string | undefined;
|
|
4693
4686
|
/**
|
|
4694
|
-
* <p>The date and time the invalidation request was first made
|
|
4687
|
+
* <p>The date and time the invalidation request was first made.</p>
|
|
4695
4688
|
*/
|
|
4696
4689
|
CreateTime: Date | undefined;
|
|
4697
4690
|
/**
|
|
4698
|
-
* <p>The current invalidation information for the batch request
|
|
4691
|
+
* <p>The current invalidation information for the batch request.</p>
|
|
4699
4692
|
*/
|
|
4700
4693
|
InvalidationBatch: InvalidationBatch | undefined;
|
|
4701
4694
|
}
|
|
@@ -4728,7 +4721,7 @@ export declare class TooManyInvalidationsInProgress extends __BaseException {
|
|
|
4728
4721
|
}
|
|
4729
4722
|
/**
|
|
4730
4723
|
* <p>A key group configuration.</p>
|
|
4731
|
-
*
|
|
4724
|
+
* <p>A key group contains a list of public keys that you can use with <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/PrivateContent.html">CloudFront signed URLs and signed cookies</a>.</p>
|
|
4732
4725
|
*/
|
|
4733
4726
|
export interface KeyGroupConfig {
|
|
4734
4727
|
/**
|
|
@@ -4753,7 +4746,7 @@ export interface CreateKeyGroupRequest {
|
|
|
4753
4746
|
}
|
|
4754
4747
|
/**
|
|
4755
4748
|
* <p>A key group.</p>
|
|
4756
|
-
*
|
|
4749
|
+
* <p>A key group contains a list of public keys that you can use with <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/PrivateContent.html">CloudFront signed URLs and signed cookies</a>.</p>
|
|
4757
4750
|
*/
|
|
4758
4751
|
export interface KeyGroup {
|
|
4759
4752
|
/**
|
|
@@ -4910,22 +4903,22 @@ export interface OriginAccessControlConfig {
|
|
|
4910
4903
|
* <p>Specifies which requests CloudFront signs (adds authentication information to). Specify
|
|
4911
4904
|
* <code>always</code> for the most common use case. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/private-content-restricting-access-to-s3.html#oac-advanced-settings">origin access control advanced settings</a> in the
|
|
4912
4905
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
4913
|
-
*
|
|
4914
|
-
*
|
|
4906
|
+
* <p>This field can have one of the following values:</p>
|
|
4907
|
+
* <ul>
|
|
4915
4908
|
* <li>
|
|
4916
|
-
*
|
|
4909
|
+
* <p>
|
|
4917
4910
|
* <code>always</code> – CloudFront signs all origin requests, overwriting the
|
|
4918
4911
|
* <code>Authorization</code> header from the viewer request if one
|
|
4919
4912
|
* exists.</p>
|
|
4920
|
-
*
|
|
4913
|
+
* </li>
|
|
4921
4914
|
* <li>
|
|
4922
|
-
*
|
|
4915
|
+
* <p>
|
|
4923
4916
|
* <code>never</code> – CloudFront doesn't sign any origin requests. This value turns
|
|
4924
4917
|
* off origin access control for all origins in all distributions that use this
|
|
4925
4918
|
* origin access control.</p>
|
|
4926
|
-
*
|
|
4919
|
+
* </li>
|
|
4927
4920
|
* <li>
|
|
4928
|
-
*
|
|
4921
|
+
* <p>
|
|
4929
4922
|
* <code>no-override</code> – If the viewer request doesn't contain the
|
|
4930
4923
|
* <code>Authorization</code> header, then CloudFront signs the origin request. If
|
|
4931
4924
|
* the viewer request contains the <code>Authorization</code> header, then CloudFront
|
|
@@ -4935,7 +4928,7 @@ export interface OriginAccessControlConfig {
|
|
|
4935
4928
|
* <code>Authorization</code> header to a <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html">cache policy</a> for all cache behaviors that
|
|
4936
4929
|
* use origins associated with this origin access control.</b>
|
|
4937
4930
|
* </p>
|
|
4938
|
-
*
|
|
4931
|
+
* </li>
|
|
4939
4932
|
* </ul>
|
|
4940
4933
|
*/
|
|
4941
4934
|
SigningBehavior: OriginAccessControlSigningBehaviors | string | undefined;
|
|
@@ -4993,7 +4986,7 @@ export declare class OriginAccessControlAlreadyExists extends __BaseException {
|
|
|
4993
4986
|
/**
|
|
4994
4987
|
* <p>The number of origin access controls in your Amazon Web Services account exceeds the maximum
|
|
4995
4988
|
* allowed.</p>
|
|
4996
|
-
*
|
|
4989
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/cloudfront-limits.html">Quotas</a> (formerly known as limits) in the
|
|
4997
4990
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
4998
4991
|
*/
|
|
4999
4992
|
export declare class TooManyOriginAccessControls extends __BaseException {
|
|
@@ -5018,25 +5011,25 @@ export interface OriginRequestPolicyCookiesConfig {
|
|
|
5018
5011
|
/**
|
|
5019
5012
|
* <p>Determines whether cookies in viewer requests are included in requests that CloudFront sends
|
|
5020
5013
|
* to the origin. Valid values are:</p>
|
|
5021
|
-
*
|
|
5014
|
+
* <ul>
|
|
5022
5015
|
* <li>
|
|
5023
|
-
*
|
|
5016
|
+
* <p>
|
|
5024
5017
|
* <code>none</code> – Cookies in viewer requests are not included in requests
|
|
5025
5018
|
* that CloudFront sends to the origin. Even when this field is set to <code>none</code>,
|
|
5026
5019
|
* any cookies that are listed in a <code>CachePolicy</code>
|
|
5027
|
-
*
|
|
5028
|
-
*
|
|
5020
|
+
* <i>are</i> included in origin requests.</p>
|
|
5021
|
+
* </li>
|
|
5029
5022
|
* <li>
|
|
5030
|
-
*
|
|
5023
|
+
* <p>
|
|
5031
5024
|
* <code>whitelist</code> – The cookies in viewer requests that are listed in the
|
|
5032
5025
|
* <code>CookieNames</code> type are included in requests that CloudFront sends to
|
|
5033
5026
|
* the origin.</p>
|
|
5034
|
-
*
|
|
5027
|
+
* </li>
|
|
5035
5028
|
* <li>
|
|
5036
|
-
*
|
|
5029
|
+
* <p>
|
|
5037
5030
|
* <code>all</code> – All cookies in viewer requests are included in requests
|
|
5038
5031
|
* that CloudFront sends to the origin.</p>
|
|
5039
|
-
*
|
|
5032
|
+
* </li>
|
|
5040
5033
|
* </ul>
|
|
5041
5034
|
*/
|
|
5042
5035
|
CookieBehavior: OriginRequestPolicyCookieBehavior | string | undefined;
|
|
@@ -5059,32 +5052,32 @@ export interface OriginRequestPolicyHeadersConfig {
|
|
|
5059
5052
|
/**
|
|
5060
5053
|
* <p>Determines whether any HTTP headers are included in requests that CloudFront sends to the
|
|
5061
5054
|
* origin. Valid values are:</p>
|
|
5062
|
-
*
|
|
5055
|
+
* <ul>
|
|
5063
5056
|
* <li>
|
|
5064
|
-
*
|
|
5057
|
+
* <p>
|
|
5065
5058
|
* <code>none</code> – HTTP headers are not included in requests that CloudFront sends
|
|
5066
5059
|
* to the origin. Even when this field is set to <code>none</code>, any headers
|
|
5067
5060
|
* that are listed in a <code>CachePolicy</code>
|
|
5068
|
-
*
|
|
5069
|
-
*
|
|
5061
|
+
* <i>are</i> included in origin requests.</p>
|
|
5062
|
+
* </li>
|
|
5070
5063
|
* <li>
|
|
5071
|
-
*
|
|
5064
|
+
* <p>
|
|
5072
5065
|
* <code>whitelist</code> – The HTTP headers that are listed in the
|
|
5073
5066
|
* <code>Headers</code> type are included in requests that CloudFront sends to the
|
|
5074
5067
|
* origin.</p>
|
|
5075
|
-
*
|
|
5068
|
+
* </li>
|
|
5076
5069
|
* <li>
|
|
5077
|
-
*
|
|
5070
|
+
* <p>
|
|
5078
5071
|
* <code>allViewer</code> – All HTTP headers in viewer requests are included in
|
|
5079
5072
|
* requests that CloudFront sends to the origin.</p>
|
|
5080
|
-
*
|
|
5073
|
+
* </li>
|
|
5081
5074
|
* <li>
|
|
5082
|
-
*
|
|
5075
|
+
* <p>
|
|
5083
5076
|
* <code>allViewerAndWhitelistCloudFront</code> – All HTTP headers in viewer
|
|
5084
5077
|
* requests and the additional CloudFront headers that are listed in the
|
|
5085
5078
|
* <code>Headers</code> type are included in requests that CloudFront sends to the
|
|
5086
5079
|
* origin. The additional headers are added by CloudFront.</p>
|
|
5087
|
-
*
|
|
5080
|
+
* </li>
|
|
5088
5081
|
* </ul>
|
|
5089
5082
|
*/
|
|
5090
5083
|
HeaderBehavior: OriginRequestPolicyHeaderBehavior | string | undefined;
|
|
@@ -5106,26 +5099,26 @@ export interface OriginRequestPolicyQueryStringsConfig {
|
|
|
5106
5099
|
/**
|
|
5107
5100
|
* <p>Determines whether any URL query strings in viewer requests are included in requests
|
|
5108
5101
|
* that CloudFront sends to the origin. Valid values are:</p>
|
|
5109
|
-
*
|
|
5102
|
+
* <ul>
|
|
5110
5103
|
* <li>
|
|
5111
|
-
*
|
|
5104
|
+
* <p>
|
|
5112
5105
|
* <code>none</code> – Query strings in viewer requests are not included in
|
|
5113
5106
|
* requests that CloudFront sends to the origin. Even when this field is set to
|
|
5114
5107
|
* <code>none</code>, any query strings that are listed in a
|
|
5115
5108
|
* <code>CachePolicy</code>
|
|
5116
|
-
*
|
|
5117
|
-
*
|
|
5109
|
+
* <i>are</i> included in origin requests.</p>
|
|
5110
|
+
* </li>
|
|
5118
5111
|
* <li>
|
|
5119
|
-
*
|
|
5112
|
+
* <p>
|
|
5120
5113
|
* <code>whitelist</code> – The query strings in viewer requests that are listed
|
|
5121
5114
|
* in the <code>QueryStringNames</code> type are included in requests that CloudFront
|
|
5122
5115
|
* sends to the origin.</p>
|
|
5123
|
-
*
|
|
5116
|
+
* </li>
|
|
5124
5117
|
* <li>
|
|
5125
|
-
*
|
|
5118
|
+
* <p>
|
|
5126
5119
|
* <code>all</code> – All query strings in viewer requests are included in
|
|
5127
5120
|
* requests that CloudFront sends to the origin.</p>
|
|
5128
|
-
*
|
|
5121
|
+
* </li>
|
|
5129
5122
|
* </ul>
|
|
5130
5123
|
*/
|
|
5131
5124
|
QueryStringBehavior: OriginRequestPolicyQueryStringBehavior | string | undefined;
|
|
@@ -5137,26 +5130,26 @@ export interface OriginRequestPolicyQueryStringsConfig {
|
|
|
5137
5130
|
}
|
|
5138
5131
|
/**
|
|
5139
5132
|
* <p>An origin request policy configuration.</p>
|
|
5140
|
-
*
|
|
5133
|
+
* <p>This configuration determines the values that CloudFront includes in requests that it sends
|
|
5141
5134
|
* to the origin. Each request that CloudFront sends to the origin includes the following:</p>
|
|
5142
|
-
*
|
|
5135
|
+
* <ul>
|
|
5143
5136
|
* <li>
|
|
5144
|
-
*
|
|
5137
|
+
* <p>The request body and the URL path (without the domain name) from the viewer
|
|
5145
5138
|
* request.</p>
|
|
5146
|
-
*
|
|
5139
|
+
* </li>
|
|
5147
5140
|
* <li>
|
|
5148
|
-
*
|
|
5141
|
+
* <p>The headers that CloudFront automatically includes in every origin request,
|
|
5149
5142
|
* including <code>Host</code>, <code>User-Agent</code>, and
|
|
5150
5143
|
* <code>X-Amz-Cf-Id</code>.</p>
|
|
5151
|
-
*
|
|
5144
|
+
* </li>
|
|
5152
5145
|
* <li>
|
|
5153
|
-
*
|
|
5146
|
+
* <p>All HTTP headers, cookies, and URL query strings that are specified in the
|
|
5154
5147
|
* cache policy or the origin request policy. These can include items from the
|
|
5155
5148
|
* viewer request and, in the case of headers, additional ones that are added by
|
|
5156
5149
|
* CloudFront.</p>
|
|
5157
|
-
*
|
|
5150
|
+
* </li>
|
|
5158
5151
|
* </ul>
|
|
5159
|
-
*
|
|
5152
|
+
* <p>CloudFront sends a request when it can't find an object in its cache that matches the
|
|
5160
5153
|
* request. If you want to send values to the origin and also include them in the cache
|
|
5161
5154
|
* key, use <code>CachePolicy</code>.</p>
|
|
5162
5155
|
*/
|
|
@@ -5192,27 +5185,27 @@ export interface CreateOriginRequestPolicyRequest {
|
|
|
5192
5185
|
}
|
|
5193
5186
|
/**
|
|
5194
5187
|
* <p>An origin request policy.</p>
|
|
5195
|
-
*
|
|
5188
|
+
* <p>When it's attached to a cache behavior, the origin request policy determines the
|
|
5196
5189
|
* values that CloudFront includes in requests that it sends to the origin. Each request that
|
|
5197
5190
|
* CloudFront sends to the origin includes the following:</p>
|
|
5198
|
-
*
|
|
5191
|
+
* <ul>
|
|
5199
5192
|
* <li>
|
|
5200
|
-
*
|
|
5193
|
+
* <p>The request body and the URL path (without the domain name) from the viewer
|
|
5201
5194
|
* request.</p>
|
|
5202
|
-
*
|
|
5195
|
+
* </li>
|
|
5203
5196
|
* <li>
|
|
5204
|
-
*
|
|
5197
|
+
* <p>The headers that CloudFront automatically includes in every origin request,
|
|
5205
5198
|
* including <code>Host</code>, <code>User-Agent</code>, and
|
|
5206
5199
|
* <code>X-Amz-Cf-Id</code>.</p>
|
|
5207
|
-
*
|
|
5200
|
+
* </li>
|
|
5208
5201
|
* <li>
|
|
5209
|
-
*
|
|
5202
|
+
* <p>All HTTP headers, cookies, and URL query strings that are specified in the
|
|
5210
5203
|
* cache policy or the origin request policy. These can include items from the
|
|
5211
5204
|
* viewer request and, in the case of headers, additional ones that are added by
|
|
5212
5205
|
* CloudFront.</p>
|
|
5213
|
-
*
|
|
5206
|
+
* </li>
|
|
5214
5207
|
* </ul>
|
|
5215
|
-
*
|
|
5208
|
+
* <p>CloudFront sends a request when it can't find an object in its cache that matches the
|
|
5216
5209
|
* request. If you want to send values to the origin and also include them in the cache
|
|
5217
5210
|
* key, use <code>CachePolicy</code>.</p>
|
|
5218
5211
|
*/
|
|
@@ -5319,7 +5312,7 @@ export declare class TooManyQueryStringsInOriginRequestPolicy extends __BaseExce
|
|
|
5319
5312
|
*/
|
|
5320
5313
|
export interface PublicKeyConfig {
|
|
5321
5314
|
/**
|
|
5322
|
-
* <p>A string included in the request to help make sure that the request can
|
|
5315
|
+
* <p>A string included in the request to help make sure that the request can't be
|
|
5323
5316
|
* replayed.</p>
|
|
5324
5317
|
*/
|
|
5325
5318
|
CallerReference: string | undefined;
|
|
@@ -5407,7 +5400,7 @@ export interface KinesisStreamConfig {
|
|
|
5407
5400
|
/**
|
|
5408
5401
|
* <p>The Amazon Resource Name (ARN) of an Identity and Access Management (IAM) role that CloudFront can use to
|
|
5409
5402
|
* send real-time log data to your Kinesis data stream.</p>
|
|
5410
|
-
*
|
|
5403
|
+
* <p>For more information the IAM role, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/real-time-logs.html#understand-real-time-log-config-iam-role">Real-time log configuration IAM role</a> in the
|
|
5411
5404
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
5412
5405
|
*/
|
|
5413
5406
|
RoleARN: string | undefined;
|
|
@@ -5441,7 +5434,7 @@ export interface CreateRealtimeLogConfigRequest {
|
|
|
5441
5434
|
EndPoints: EndPoint[] | undefined;
|
|
5442
5435
|
/**
|
|
5443
5436
|
* <p>A list of fields to include in each real-time log record.</p>
|
|
5444
|
-
*
|
|
5437
|
+
* <p>For more information about fields, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/real-time-logs.html#understand-real-time-log-config-fields">Real-time log configuration fields</a> in the
|
|
5445
5438
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
5446
5439
|
*/
|
|
5447
5440
|
Fields: string[] | undefined;
|
|
@@ -5483,7 +5476,7 @@ export interface RealtimeLogConfig {
|
|
|
5483
5476
|
* <p>A list of fields that are included in each real-time log record. In an API response,
|
|
5484
5477
|
* the fields are provided in the same order in which they are sent to the Amazon Kinesis data
|
|
5485
5478
|
* stream.</p>
|
|
5486
|
-
*
|
|
5479
|
+
* <p>For more information about fields, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/real-time-logs.html#understand-real-time-log-config-fields">Real-time log configuration fields</a> in the
|
|
5487
5480
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
5488
5481
|
*/
|
|
5489
5482
|
Fields: string[] | undefined;
|
|
@@ -5525,7 +5518,7 @@ export declare class TooManyRealtimeLogConfigs extends __BaseException {
|
|
|
5525
5518
|
/**
|
|
5526
5519
|
* <p>A list of HTTP header names that CloudFront includes as values for the
|
|
5527
5520
|
* <code>Access-Control-Allow-Headers</code> HTTP response header.</p>
|
|
5528
|
-
*
|
|
5521
|
+
* <p>For more information about the <code>Access-Control-Allow-Headers</code> HTTP response
|
|
5529
5522
|
* header, see <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Headers">Access-Control-Allow-Headers</a> in the MDN Web Docs.</p>
|
|
5530
5523
|
*/
|
|
5531
5524
|
export interface ResponseHeadersPolicyAccessControlAllowHeaders {
|
|
@@ -5542,7 +5535,7 @@ export interface ResponseHeadersPolicyAccessControlAllowHeaders {
|
|
|
5542
5535
|
/**
|
|
5543
5536
|
* <p>A list of HTTP methods that CloudFront includes as values for the
|
|
5544
5537
|
* <code>Access-Control-Allow-Methods</code> HTTP response header.</p>
|
|
5545
|
-
*
|
|
5538
|
+
* <p>For more information about the <code>Access-Control-Allow-Methods</code> HTTP response
|
|
5546
5539
|
* header, see <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Methods">Access-Control-Allow-Methods</a> in the MDN Web Docs.</p>
|
|
5547
5540
|
*/
|
|
5548
5541
|
export interface ResponseHeadersPolicyAccessControlAllowMethods {
|
|
@@ -5552,49 +5545,49 @@ export interface ResponseHeadersPolicyAccessControlAllowMethods {
|
|
|
5552
5545
|
Quantity: number | undefined;
|
|
5553
5546
|
/**
|
|
5554
5547
|
* <p>The list of HTTP methods. Valid values are:</p>
|
|
5555
|
-
*
|
|
5548
|
+
* <ul>
|
|
5556
5549
|
* <li>
|
|
5557
|
-
*
|
|
5550
|
+
* <p>
|
|
5558
5551
|
* <code>GET</code>
|
|
5559
5552
|
* </p>
|
|
5560
|
-
*
|
|
5553
|
+
* </li>
|
|
5561
5554
|
* <li>
|
|
5562
|
-
*
|
|
5555
|
+
* <p>
|
|
5563
5556
|
* <code>DELETE</code>
|
|
5564
5557
|
* </p>
|
|
5565
|
-
*
|
|
5558
|
+
* </li>
|
|
5566
5559
|
* <li>
|
|
5567
|
-
*
|
|
5560
|
+
* <p>
|
|
5568
5561
|
* <code>HEAD</code>
|
|
5569
5562
|
* </p>
|
|
5570
|
-
*
|
|
5563
|
+
* </li>
|
|
5571
5564
|
* <li>
|
|
5572
|
-
*
|
|
5565
|
+
* <p>
|
|
5573
5566
|
* <code>OPTIONS</code>
|
|
5574
5567
|
* </p>
|
|
5575
|
-
*
|
|
5568
|
+
* </li>
|
|
5576
5569
|
* <li>
|
|
5577
|
-
*
|
|
5570
|
+
* <p>
|
|
5578
5571
|
* <code>PATCH</code>
|
|
5579
5572
|
* </p>
|
|
5580
|
-
*
|
|
5573
|
+
* </li>
|
|
5581
5574
|
* <li>
|
|
5582
|
-
*
|
|
5575
|
+
* <p>
|
|
5583
5576
|
* <code>POST</code>
|
|
5584
5577
|
* </p>
|
|
5585
|
-
*
|
|
5578
|
+
* </li>
|
|
5586
5579
|
* <li>
|
|
5587
|
-
*
|
|
5580
|
+
* <p>
|
|
5588
5581
|
* <code>PUT</code>
|
|
5589
5582
|
* </p>
|
|
5590
|
-
*
|
|
5583
|
+
* </li>
|
|
5591
5584
|
* <li>
|
|
5592
|
-
*
|
|
5585
|
+
* <p>
|
|
5593
5586
|
* <code>ALL</code>
|
|
5594
5587
|
* </p>
|
|
5595
|
-
*
|
|
5588
|
+
* </li>
|
|
5596
5589
|
* </ul>
|
|
5597
|
-
*
|
|
5590
|
+
* <p>
|
|
5598
5591
|
* <code>ALL</code> is a special value that includes all of the listed HTTP
|
|
5599
5592
|
* methods.</p>
|
|
5600
5593
|
*/
|
|
@@ -5603,7 +5596,7 @@ export interface ResponseHeadersPolicyAccessControlAllowMethods {
|
|
|
5603
5596
|
/**
|
|
5604
5597
|
* <p>A list of origins (domain names) that CloudFront can use as the value for the
|
|
5605
5598
|
* <code>Access-Control-Allow-Origin</code> HTTP response header.</p>
|
|
5606
|
-
*
|
|
5599
|
+
* <p>For more information about the <code>Access-Control-Allow-Origin</code> HTTP response
|
|
5607
5600
|
* header, see <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin">Access-Control-Allow-Origin</a> in the MDN Web Docs.</p>
|
|
5608
5601
|
*/
|
|
5609
5602
|
export interface ResponseHeadersPolicyAccessControlAllowOrigins {
|
|
@@ -5620,7 +5613,7 @@ export interface ResponseHeadersPolicyAccessControlAllowOrigins {
|
|
|
5620
5613
|
/**
|
|
5621
5614
|
* <p>A list of HTTP headers that CloudFront includes as values for the
|
|
5622
5615
|
* <code>Access-Control-Expose-Headers</code> HTTP response header.</p>
|
|
5623
|
-
*
|
|
5616
|
+
* <p>For more information about the <code>Access-Control-Expose-Headers</code> HTTP
|
|
5624
5617
|
* response header, see <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Expose-Headers">Access-Control-Expose-Headers</a> in the MDN Web Docs.</p>
|
|
5625
5618
|
*/
|
|
5626
5619
|
export interface ResponseHeadersPolicyAccessControlExposeHeaders {
|
|
@@ -5638,49 +5631,49 @@ export interface ResponseHeadersPolicyAccessControlExposeHeaders {
|
|
|
5638
5631
|
* resource sharing (CORS). CloudFront adds these headers to HTTP responses that it sends for
|
|
5639
5632
|
* CORS requests that match a cache behavior associated with this response headers
|
|
5640
5633
|
* policy.</p>
|
|
5641
|
-
*
|
|
5634
|
+
* <p>For more information about CORS, see <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS">Cross-Origin Resource
|
|
5642
5635
|
* Sharing (CORS)</a> in the MDN Web Docs.</p>
|
|
5643
5636
|
*/
|
|
5644
5637
|
export interface ResponseHeadersPolicyCorsConfig {
|
|
5645
5638
|
/**
|
|
5646
5639
|
* <p>A list of origins (domain names) that CloudFront can use as the value for the
|
|
5647
5640
|
* <code>Access-Control-Allow-Origin</code> HTTP response header.</p>
|
|
5648
|
-
*
|
|
5641
|
+
* <p>For more information about the <code>Access-Control-Allow-Origin</code> HTTP response
|
|
5649
5642
|
* header, see <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin">Access-Control-Allow-Origin</a> in the MDN Web Docs.</p>
|
|
5650
5643
|
*/
|
|
5651
5644
|
AccessControlAllowOrigins: ResponseHeadersPolicyAccessControlAllowOrigins | undefined;
|
|
5652
5645
|
/**
|
|
5653
5646
|
* <p>A list of HTTP header names that CloudFront includes as values for the
|
|
5654
5647
|
* <code>Access-Control-Allow-Headers</code> HTTP response header.</p>
|
|
5655
|
-
*
|
|
5648
|
+
* <p>For more information about the <code>Access-Control-Allow-Headers</code> HTTP response
|
|
5656
5649
|
* header, see <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Headers">Access-Control-Allow-Headers</a> in the MDN Web Docs.</p>
|
|
5657
5650
|
*/
|
|
5658
5651
|
AccessControlAllowHeaders: ResponseHeadersPolicyAccessControlAllowHeaders | undefined;
|
|
5659
5652
|
/**
|
|
5660
5653
|
* <p>A list of HTTP methods that CloudFront includes as values for the
|
|
5661
5654
|
* <code>Access-Control-Allow-Methods</code> HTTP response header.</p>
|
|
5662
|
-
*
|
|
5655
|
+
* <p>For more information about the <code>Access-Control-Allow-Methods</code> HTTP response
|
|
5663
5656
|
* header, see <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Methods">Access-Control-Allow-Methods</a> in the MDN Web Docs.</p>
|
|
5664
5657
|
*/
|
|
5665
5658
|
AccessControlAllowMethods: ResponseHeadersPolicyAccessControlAllowMethods | undefined;
|
|
5666
5659
|
/**
|
|
5667
5660
|
* <p>A Boolean that CloudFront uses as the value for the
|
|
5668
5661
|
* <code>Access-Control-Allow-Credentials</code> HTTP response header.</p>
|
|
5669
|
-
*
|
|
5662
|
+
* <p>For more information about the <code>Access-Control-Allow-Credentials</code> HTTP
|
|
5670
5663
|
* response header, see <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Credentials">Access-Control-Allow-Credentials</a> in the MDN Web Docs.</p>
|
|
5671
5664
|
*/
|
|
5672
5665
|
AccessControlAllowCredentials: boolean | undefined;
|
|
5673
5666
|
/**
|
|
5674
5667
|
* <p>A list of HTTP headers that CloudFront includes as values for the
|
|
5675
5668
|
* <code>Access-Control-Expose-Headers</code> HTTP response header.</p>
|
|
5676
|
-
*
|
|
5669
|
+
* <p>For more information about the <code>Access-Control-Expose-Headers</code> HTTP
|
|
5677
5670
|
* response header, see <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Expose-Headers">Access-Control-Expose-Headers</a> in the MDN Web Docs.</p>
|
|
5678
5671
|
*/
|
|
5679
5672
|
AccessControlExposeHeaders?: ResponseHeadersPolicyAccessControlExposeHeaders;
|
|
5680
5673
|
/**
|
|
5681
5674
|
* <p>A number that CloudFront uses as the value for the <code>Access-Control-Max-Age</code> HTTP
|
|
5682
5675
|
* response header.</p>
|
|
5683
|
-
*
|
|
5676
|
+
* <p>For more information about the <code>Access-Control-Max-Age</code> HTTP response
|
|
5684
5677
|
* header, see <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Max-Age">Access-Control-Max-Age</a> in the MDN Web Docs.</p>
|
|
5685
5678
|
*/
|
|
5686
5679
|
AccessControlMaxAgeSec?: number;
|
|
@@ -5692,7 +5685,7 @@ export interface ResponseHeadersPolicyCorsConfig {
|
|
|
5692
5685
|
}
|
|
5693
5686
|
/**
|
|
5694
5687
|
* <p>An HTTP response header name and its value. CloudFront includes this header in HTTP
|
|
5695
|
-
* responses that it sends for requests that match a cache behavior that
|
|
5688
|
+
* responses that it sends for requests that match a cache behavior that's associated with
|
|
5696
5689
|
* this response headers policy.</p>
|
|
5697
5690
|
*/
|
|
5698
5691
|
export interface ResponseHeadersPolicyCustomHeader {
|
|
@@ -5712,7 +5705,7 @@ export interface ResponseHeadersPolicyCustomHeader {
|
|
|
5712
5705
|
}
|
|
5713
5706
|
/**
|
|
5714
5707
|
* <p>A list of HTTP response header names and their values. CloudFront includes these headers in
|
|
5715
|
-
* HTTP responses that it sends for requests that match a cache behavior that
|
|
5708
|
+
* HTTP responses that it sends for requests that match a cache behavior that's associated
|
|
5716
5709
|
* with this response headers policy.</p>
|
|
5717
5710
|
*/
|
|
5718
5711
|
export interface ResponseHeadersPolicyCustomHeadersConfig {
|
|
@@ -5728,7 +5721,7 @@ export interface ResponseHeadersPolicyCustomHeadersConfig {
|
|
|
5728
5721
|
/**
|
|
5729
5722
|
* <p>The policy directives and their values that CloudFront includes as values for the
|
|
5730
5723
|
* <code>Content-Security-Policy</code> HTTP response header.</p>
|
|
5731
|
-
*
|
|
5724
|
+
* <p>For more information about the <code>Content-Security-Policy</code> HTTP response
|
|
5732
5725
|
* header, see <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy">Content-Security-Policy</a> in the MDN Web Docs.</p>
|
|
5733
5726
|
*/
|
|
5734
5727
|
export interface ResponseHeadersPolicyContentSecurityPolicy {
|
|
@@ -5747,7 +5740,7 @@ export interface ResponseHeadersPolicyContentSecurityPolicy {
|
|
|
5747
5740
|
/**
|
|
5748
5741
|
* <p>Determines whether CloudFront includes the <code>X-Content-Type-Options</code> HTTP response
|
|
5749
5742
|
* header with its value set to <code>nosniff</code>.</p>
|
|
5750
|
-
*
|
|
5743
|
+
* <p>For more information about the <code>X-Content-Type-Options</code> HTTP response
|
|
5751
5744
|
* header, see <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Content-Type-Options">X-Content-Type-Options</a> in the MDN Web Docs.</p>
|
|
5752
5745
|
*/
|
|
5753
5746
|
export interface ResponseHeadersPolicyContentTypeOptions {
|
|
@@ -5764,8 +5757,8 @@ export declare enum FrameOptionsList {
|
|
|
5764
5757
|
}
|
|
5765
5758
|
/**
|
|
5766
5759
|
* <p>Determines whether CloudFront includes the <code>X-Frame-Options</code> HTTP response header
|
|
5767
|
-
* and the header
|
|
5768
|
-
*
|
|
5760
|
+
* and the header's value.</p>
|
|
5761
|
+
* <p>For more information about the <code>X-Frame-Options</code> HTTP response header, see
|
|
5769
5762
|
* <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Frame-Options">X-Frame-Options</a> in the MDN Web Docs.</p>
|
|
5770
5763
|
*/
|
|
5771
5764
|
export interface ResponseHeadersPolicyFrameOptions {
|
|
@@ -5777,8 +5770,8 @@ export interface ResponseHeadersPolicyFrameOptions {
|
|
|
5777
5770
|
Override: boolean | undefined;
|
|
5778
5771
|
/**
|
|
5779
5772
|
* <p>The value of the <code>X-Frame-Options</code> HTTP response header. Valid values are
|
|
5780
|
-
* <code>DENY</code> and <code>SAMEORIGIN</code
|
|
5781
|
-
*
|
|
5773
|
+
* <code>DENY</code> and <code>SAMEORIGIN</code>.</p>
|
|
5774
|
+
* <p>For more information about these values, see <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Frame-Options">X-Frame-Options</a> in the MDN Web Docs.</p>
|
|
5782
5775
|
*/
|
|
5783
5776
|
FrameOption: FrameOptionsList | string | undefined;
|
|
5784
5777
|
}
|
|
@@ -5794,8 +5787,8 @@ export declare enum ReferrerPolicyList {
|
|
|
5794
5787
|
}
|
|
5795
5788
|
/**
|
|
5796
5789
|
* <p>Determines whether CloudFront includes the <code>Referrer-Policy</code> HTTP response header
|
|
5797
|
-
* and the header
|
|
5798
|
-
*
|
|
5790
|
+
* and the header's value.</p>
|
|
5791
|
+
* <p>For more information about the <code>Referrer-Policy</code> HTTP response header, see
|
|
5799
5792
|
* <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Referrer-Policy">Referrer-Policy</a> in the MDN Web Docs.</p>
|
|
5800
5793
|
*/
|
|
5801
5794
|
export interface ResponseHeadersPolicyReferrerPolicy {
|
|
@@ -5808,56 +5801,56 @@ export interface ResponseHeadersPolicyReferrerPolicy {
|
|
|
5808
5801
|
/**
|
|
5809
5802
|
* <p>The value of the <code>Referrer-Policy</code> HTTP response header. Valid values
|
|
5810
5803
|
* are:</p>
|
|
5811
|
-
*
|
|
5804
|
+
* <ul>
|
|
5812
5805
|
* <li>
|
|
5813
|
-
*
|
|
5806
|
+
* <p>
|
|
5814
5807
|
* <code>no-referrer</code>
|
|
5815
5808
|
* </p>
|
|
5816
|
-
*
|
|
5809
|
+
* </li>
|
|
5817
5810
|
* <li>
|
|
5818
|
-
*
|
|
5811
|
+
* <p>
|
|
5819
5812
|
* <code>no-referrer-when-downgrade</code>
|
|
5820
5813
|
* </p>
|
|
5821
|
-
*
|
|
5814
|
+
* </li>
|
|
5822
5815
|
* <li>
|
|
5823
|
-
*
|
|
5816
|
+
* <p>
|
|
5824
5817
|
* <code>origin</code>
|
|
5825
5818
|
* </p>
|
|
5826
|
-
*
|
|
5819
|
+
* </li>
|
|
5827
5820
|
* <li>
|
|
5828
|
-
*
|
|
5821
|
+
* <p>
|
|
5829
5822
|
* <code>origin-when-cross-origin</code>
|
|
5830
5823
|
* </p>
|
|
5831
|
-
*
|
|
5824
|
+
* </li>
|
|
5832
5825
|
* <li>
|
|
5833
|
-
*
|
|
5826
|
+
* <p>
|
|
5834
5827
|
* <code>same-origin</code>
|
|
5835
5828
|
* </p>
|
|
5836
|
-
*
|
|
5829
|
+
* </li>
|
|
5837
5830
|
* <li>
|
|
5838
|
-
*
|
|
5831
|
+
* <p>
|
|
5839
5832
|
* <code>strict-origin</code>
|
|
5840
5833
|
* </p>
|
|
5841
|
-
*
|
|
5834
|
+
* </li>
|
|
5842
5835
|
* <li>
|
|
5843
|
-
*
|
|
5836
|
+
* <p>
|
|
5844
5837
|
* <code>strict-origin-when-cross-origin</code>
|
|
5845
5838
|
* </p>
|
|
5846
|
-
*
|
|
5839
|
+
* </li>
|
|
5847
5840
|
* <li>
|
|
5848
|
-
*
|
|
5841
|
+
* <p>
|
|
5849
5842
|
* <code>unsafe-url</code>
|
|
5850
5843
|
* </p>
|
|
5851
|
-
*
|
|
5844
|
+
* </li>
|
|
5852
5845
|
* </ul>
|
|
5853
|
-
*
|
|
5846
|
+
* <p>For more information about these values, see <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Referrer-Policy">Referrer-Policy</a> in the MDN Web Docs.</p>
|
|
5854
5847
|
*/
|
|
5855
5848
|
ReferrerPolicy: ReferrerPolicyList | string | undefined;
|
|
5856
5849
|
}
|
|
5857
5850
|
/**
|
|
5858
5851
|
* <p>Determines whether CloudFront includes the <code>Strict-Transport-Security</code> HTTP
|
|
5859
|
-
* response header and the header
|
|
5860
|
-
*
|
|
5852
|
+
* response header and the header's value.</p>
|
|
5853
|
+
* <p>For more information about the <code>Strict-Transport-Security</code> HTTP response
|
|
5861
5854
|
* header, see <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Strict-Transport-Security">Strict-Transport-Security</a> in the MDN Web Docs.</p>
|
|
5862
5855
|
*/
|
|
5863
5856
|
export interface ResponseHeadersPolicyStrictTransportSecurity {
|
|
@@ -5885,8 +5878,8 @@ export interface ResponseHeadersPolicyStrictTransportSecurity {
|
|
|
5885
5878
|
}
|
|
5886
5879
|
/**
|
|
5887
5880
|
* <p>Determines whether CloudFront includes the <code>X-XSS-Protection</code> HTTP response
|
|
5888
|
-
* header and the header
|
|
5889
|
-
*
|
|
5881
|
+
* header and the header's value.</p>
|
|
5882
|
+
* <p>For more information about the <code>X-XSS-Protection</code> HTTP response header, see
|
|
5890
5883
|
* <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-XSS-Protection">X-XSS-Protection</a> in the MDN Web Docs.</p>
|
|
5891
5884
|
*/
|
|
5892
5885
|
export interface ResponseHeadersPolicyXSSProtection {
|
|
@@ -5902,21 +5895,21 @@ export interface ResponseHeadersPolicyXSSProtection {
|
|
|
5902
5895
|
* <code>X-XSS-Protection</code> header is <code>1</code>. When this setting is
|
|
5903
5896
|
* <code>false</code>, the value of the <code>X-XSS-Protection</code> header is
|
|
5904
5897
|
* <code>0</code>.</p>
|
|
5905
|
-
*
|
|
5898
|
+
* <p>For more information about these settings, see <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-XSS-Protection">X-XSS-Protection</a> in the MDN Web Docs.</p>
|
|
5906
5899
|
*/
|
|
5907
5900
|
Protection: boolean | undefined;
|
|
5908
5901
|
/**
|
|
5909
5902
|
* <p>A Boolean that determines whether CloudFront includes the <code>mode=block</code> directive
|
|
5910
5903
|
* in the <code>X-XSS-Protection</code> header.</p>
|
|
5911
|
-
*
|
|
5904
|
+
* <p>For more information about this directive, see <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-XSS-Protection">X-XSS-Protection</a> in the MDN Web Docs.</p>
|
|
5912
5905
|
*/
|
|
5913
5906
|
ModeBlock?: boolean;
|
|
5914
5907
|
/**
|
|
5915
5908
|
* <p>A reporting URI, which CloudFront uses as the value of the <code>report</code> directive in
|
|
5916
5909
|
* the <code>X-XSS-Protection</code> header.</p>
|
|
5917
|
-
*
|
|
5910
|
+
* <p>You cannot specify a <code>ReportUri</code> when <code>ModeBlock</code> is
|
|
5918
5911
|
* <code>true</code>.</p>
|
|
5919
|
-
*
|
|
5912
|
+
* <p>For more information about using a reporting URL, see <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-XSS-Protection">X-XSS-Protection</a> in the MDN Web Docs.</p>
|
|
5920
5913
|
*/
|
|
5921
5914
|
ReportUri?: string;
|
|
5922
5915
|
}
|
|
@@ -5928,43 +5921,43 @@ export interface ResponseHeadersPolicyXSSProtection {
|
|
|
5928
5921
|
export interface ResponseHeadersPolicySecurityHeadersConfig {
|
|
5929
5922
|
/**
|
|
5930
5923
|
* <p>Determines whether CloudFront includes the <code>X-XSS-Protection</code> HTTP response
|
|
5931
|
-
* header and the header
|
|
5932
|
-
*
|
|
5924
|
+
* header and the header's value.</p>
|
|
5925
|
+
* <p>For more information about the <code>X-XSS-Protection</code> HTTP response header, see
|
|
5933
5926
|
* <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-XSS-Protection">X-XSS-Protection</a> in the MDN Web Docs.</p>
|
|
5934
5927
|
*/
|
|
5935
5928
|
XSSProtection?: ResponseHeadersPolicyXSSProtection;
|
|
5936
5929
|
/**
|
|
5937
5930
|
* <p>Determines whether CloudFront includes the <code>X-Frame-Options</code> HTTP response header
|
|
5938
|
-
* and the header
|
|
5939
|
-
*
|
|
5931
|
+
* and the header's value.</p>
|
|
5932
|
+
* <p>For more information about the <code>X-Frame-Options</code> HTTP response header, see
|
|
5940
5933
|
* <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Frame-Options">X-Frame-Options</a> in the MDN Web Docs.</p>
|
|
5941
5934
|
*/
|
|
5942
5935
|
FrameOptions?: ResponseHeadersPolicyFrameOptions;
|
|
5943
5936
|
/**
|
|
5944
5937
|
* <p>Determines whether CloudFront includes the <code>Referrer-Policy</code> HTTP response header
|
|
5945
|
-
* and the header
|
|
5946
|
-
*
|
|
5938
|
+
* and the header's value.</p>
|
|
5939
|
+
* <p>For more information about the <code>Referrer-Policy</code> HTTP response header, see
|
|
5947
5940
|
* <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Referrer-Policy">Referrer-Policy</a> in the MDN Web Docs.</p>
|
|
5948
5941
|
*/
|
|
5949
5942
|
ReferrerPolicy?: ResponseHeadersPolicyReferrerPolicy;
|
|
5950
5943
|
/**
|
|
5951
5944
|
* <p>The policy directives and their values that CloudFront includes as values for the
|
|
5952
5945
|
* <code>Content-Security-Policy</code> HTTP response header.</p>
|
|
5953
|
-
*
|
|
5946
|
+
* <p>For more information about the <code>Content-Security-Policy</code> HTTP response
|
|
5954
5947
|
* header, see <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy">Content-Security-Policy</a> in the MDN Web Docs.</p>
|
|
5955
5948
|
*/
|
|
5956
5949
|
ContentSecurityPolicy?: ResponseHeadersPolicyContentSecurityPolicy;
|
|
5957
5950
|
/**
|
|
5958
5951
|
* <p>Determines whether CloudFront includes the <code>X-Content-Type-Options</code> HTTP response
|
|
5959
5952
|
* header with its value set to <code>nosniff</code>.</p>
|
|
5960
|
-
*
|
|
5953
|
+
* <p>For more information about the <code>X-Content-Type-Options</code> HTTP response
|
|
5961
5954
|
* header, see <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Content-Type-Options">X-Content-Type-Options</a> in the MDN Web Docs.</p>
|
|
5962
5955
|
*/
|
|
5963
5956
|
ContentTypeOptions?: ResponseHeadersPolicyContentTypeOptions;
|
|
5964
5957
|
/**
|
|
5965
5958
|
* <p>Determines whether CloudFront includes the <code>Strict-Transport-Security</code> HTTP
|
|
5966
|
-
* response header and the header
|
|
5967
|
-
*
|
|
5959
|
+
* response header and the header's value.</p>
|
|
5960
|
+
* <p>For more information about the <code>Strict-Transport-Security</code> HTTP response
|
|
5968
5961
|
* header, see <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Strict-Transport-Security">Strict-Transport-Security</a> in the MDN Web Docs.</p>
|
|
5969
5962
|
*/
|
|
5970
5963
|
StrictTransportSecurity?: ResponseHeadersPolicyStrictTransportSecurity;
|
|
@@ -5974,7 +5967,7 @@ export interface ResponseHeadersPolicySecurityHeadersConfig {
|
|
|
5974
5967
|
* sent from CloudFront. CloudFront adds this header to HTTP responses that it sends in response to
|
|
5975
5968
|
* requests that match a cache behavior that's associated with this response headers
|
|
5976
5969
|
* policy.</p>
|
|
5977
|
-
*
|
|
5970
|
+
* <p>You can use the <code>Server-Timing</code> header to view metrics that can help you
|
|
5978
5971
|
* gain insights about the behavior and performance of CloudFront. For example, you can see which
|
|
5979
5972
|
* cache layer served a cache hit, or the first byte latency from the origin when there was
|
|
5980
5973
|
* a cache miss. You can use the metrics in the <code>Server-Timing</code> header to
|
|
@@ -6002,7 +5995,7 @@ export interface ResponseHeadersPolicyServerTimingHeadersConfig {
|
|
|
6002
5995
|
}
|
|
6003
5996
|
/**
|
|
6004
5997
|
* <p>A response headers policy configuration.</p>
|
|
6005
|
-
*
|
|
5998
|
+
* <p>A response headers policy configuration contains metadata about the response headers
|
|
6006
5999
|
* policy, and configurations for sets of HTTP response headers and their values. CloudFront adds
|
|
6007
6000
|
* the headers in the policy to HTTP responses that it sends for requests that match a
|
|
6008
6001
|
* cache behavior associated with the policy.</p>
|
|
@@ -6010,12 +6003,12 @@ export interface ResponseHeadersPolicyServerTimingHeadersConfig {
|
|
|
6010
6003
|
export interface ResponseHeadersPolicyConfig {
|
|
6011
6004
|
/**
|
|
6012
6005
|
* <p>A comment to describe the response headers policy.</p>
|
|
6013
|
-
*
|
|
6006
|
+
* <p>The comment cannot be longer than 128 characters.</p>
|
|
6014
6007
|
*/
|
|
6015
6008
|
Comment?: string;
|
|
6016
6009
|
/**
|
|
6017
6010
|
* <p>A name to identify the response headers policy.</p>
|
|
6018
|
-
*
|
|
6011
|
+
* <p>The name must be unique for response headers policies in this Amazon Web Services account.</p>
|
|
6019
6012
|
*/
|
|
6020
6013
|
Name: string | undefined;
|
|
6021
6014
|
/**
|
|
@@ -6046,13 +6039,13 @@ export interface CreateResponseHeadersPolicyRequest {
|
|
|
6046
6039
|
}
|
|
6047
6040
|
/**
|
|
6048
6041
|
* <p>A response headers policy.</p>
|
|
6049
|
-
*
|
|
6042
|
+
* <p>A response headers policy contains information about a set of HTTP response headers
|
|
6050
6043
|
* and their values.</p>
|
|
6051
|
-
*
|
|
6052
|
-
* more cache behaviors in a CloudFront distribution. When it
|
|
6044
|
+
* <p>After you create a response headers policy, you can use its ID to attach it to one or
|
|
6045
|
+
* more cache behaviors in a CloudFront distribution. When it's attached to a cache behavior,
|
|
6053
6046
|
* CloudFront adds the headers in the policy to HTTP responses that it sends for requests that
|
|
6054
6047
|
* match the cache behavior.</p>
|
|
6055
|
-
*
|
|
6048
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/adding-response-headers.html">Adding HTTP headers to CloudFront responses</a> in the
|
|
6056
6049
|
* <i>Amazon CloudFront Developer Guide</i>.</p>
|
|
6057
6050
|
*/
|
|
6058
6051
|
export interface ResponseHeadersPolicy {
|
|
@@ -6066,9 +6059,9 @@ export interface ResponseHeadersPolicy {
|
|
|
6066
6059
|
LastModifiedTime: Date | undefined;
|
|
6067
6060
|
/**
|
|
6068
6061
|
* <p>A response headers policy configuration.</p>
|
|
6069
|
-
*
|
|
6062
|
+
* <p>A response headers policy contains information about a set of HTTP response headers
|
|
6070
6063
|
* and their values. CloudFront adds the headers in the policy to HTTP responses that it sends
|
|
6071
|
-
* for requests that match a cache behavior that
|
|
6064
|
+
* for requests that match a cache behavior that's associated with the policy.</p>
|
|
6072
6065
|
*/
|
|
6073
6066
|
ResponseHeadersPolicyConfig: ResponseHeadersPolicyConfig | undefined;
|
|
6074
6067
|
}
|