@propulsionworks/cloudformation 0.1.15 → 0.1.16
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/out/exports/resources.generated/aws-b2bi-partnership.d.ts +8 -0
- package/out/exports/resources.generated/aws-bedrock-datasource.d.ts +1 -1
- package/out/exports/resources.generated/aws-bedrock-guardrail.d.ts +24 -0
- package/out/exports/resources.generated/aws-cassandra-table.d.ts +3 -0
- package/out/exports/resources.generated/aws-cloudformation-stackset.d.ts +2 -2
- package/out/exports/resources.generated/aws-cloudfront-distribution.d.ts +39 -7
- package/out/exports/resources.generated/aws-dynamodb-globaltable.d.ts +82 -46
- package/out/exports/resources.generated/aws-dynamodb-table.d.ts +6 -2
- package/out/exports/resources.generated/aws-ec2-trafficmirrorfilterrule.d.ts +1 -1
- package/out/exports/resources.generated/aws-ecs-service.d.ts +1 -1
- package/out/exports/resources.generated/aws-ecs-taskdefinition.d.ts +2 -3
- package/out/exports/resources.generated/aws-emrserverless-application.d.ts +1 -1
- package/out/exports/resources.generated/aws-evs-environment.d.ts +1 -1
- package/out/exports/resources.generated/aws-fsx-s3accesspointattachment.d.ts +25 -3
- package/out/exports/resources.generated/aws-gamelift-containerfleet.d.ts +1 -1
- package/out/exports/resources.generated/aws-imagebuilder-component.d.ts +1 -56
- package/out/exports/resources.generated/aws-imagebuilder-containerrecipe.d.ts +1 -85
- package/out/exports/resources.generated/aws-imagebuilder-workflow.d.ts +1 -57
- package/out/exports/resources.generated/aws-iot-logging.d.ts +2 -2
- package/out/exports/resources.generated/aws-kinesis-streamconsumer.d.ts +18 -5
- package/out/exports/resources.generated/aws-lex-bot.d.ts +1 -0
- package/out/exports/resources.generated/aws-neptune-dbinstance.d.ts +2 -0
- package/out/exports/resources.generated/aws-odb-cloudautonomousvmcluster.d.ts +285 -0
- package/out/exports/resources.generated/aws-odb-cloudexadatainfrastructure.d.ts +200 -0
- package/out/exports/resources.generated/aws-odb-cloudvmcluster.d.ts +233 -0
- package/out/exports/resources.generated/aws-odb-odbnetwork.d.ts +98 -0
- package/out/exports/resources.generated/aws-omics-workflow.d.ts +2 -2
- package/out/exports/resources.generated/aws-qbusiness-dataaccessor.d.ts +54 -0
- package/out/exports/resources.generated/aws-qbusiness-datasource.d.ts +1 -1
- package/out/exports/resources.generated/aws-qbusiness-permission.d.ts +23 -0
- package/out/exports/resources.generated/aws-quicksight-custompermissions.d.ts +26 -2
- package/out/exports/resources.generated/aws-quicksight-dashboard.d.ts +1 -1
- package/out/exports/resources.generated/aws-rds-dbinstance.d.ts +5 -4
- package/out/exports/resources.generated/aws-redshiftserverless-snapshot.d.ts +109 -0
- package/out/exports/resources.generated/aws-s3tables-table.d.ts +166 -0
- package/out/exports/resources.generated/aws-transfer-server.d.ts +1 -0
- package/package.json +1 -1
|
@@ -20,6 +20,7 @@ export type B2BIPartnershipProps = {
|
|
|
20
20
|
*/
|
|
21
21
|
CapabilityOptions?: CapabilityOptions | undefined;
|
|
22
22
|
/**
|
|
23
|
+
* Specifies the email address associated with this trading partner.
|
|
23
24
|
* @minLength 5
|
|
24
25
|
* @maxLength 254
|
|
25
26
|
* @pattern ^[\w\.\-]+@[\w\.\-]+$
|
|
@@ -34,6 +35,7 @@ export type B2BIPartnershipProps = {
|
|
|
34
35
|
*/
|
|
35
36
|
Name: string;
|
|
36
37
|
/**
|
|
38
|
+
* Specifies the phone number associated with the partnership.
|
|
37
39
|
* @minLength 7
|
|
38
40
|
* @maxLength 22
|
|
39
41
|
* @pattern ^\+?([0-9 \t\-()\/]{7,})(?:\s*(?:#|x\.?|ext\.?|extension) \t*(\d+))?$
|
|
@@ -100,6 +102,7 @@ export type B2BIPartnershipAttribs = {
|
|
|
100
102
|
*/
|
|
101
103
|
export type CapabilityOptions = {
|
|
102
104
|
/**
|
|
105
|
+
* A structure that contains the inbound EDI options for the capability.
|
|
103
106
|
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-b2bi-partnership-capabilityoptions.html#cfn-b2bi-partnership-capabilityoptions-inboundedi}
|
|
104
107
|
*/
|
|
105
108
|
InboundEdi?: InboundEdiOptions | undefined;
|
|
@@ -110,10 +113,12 @@ export type CapabilityOptions = {
|
|
|
110
113
|
OutboundEdi?: OutboundEdiOptions | undefined;
|
|
111
114
|
};
|
|
112
115
|
/**
|
|
116
|
+
* Contains options for processing inbound EDI files. These options allow for customizing how incoming EDI documents are processed.
|
|
113
117
|
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-b2bi-partnership-inboundedioptions.html}
|
|
114
118
|
*/
|
|
115
119
|
export type InboundEdiOptions = {
|
|
116
120
|
/**
|
|
121
|
+
* A structure that contains X12-specific options for processing inbound X12 EDI files.
|
|
117
122
|
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-b2bi-partnership-inboundedioptions.html#cfn-b2bi-partnership-inboundedioptions-x12}
|
|
118
123
|
*/
|
|
119
124
|
X12?: X12InboundEdiOptions | undefined;
|
|
@@ -269,10 +274,12 @@ export type X12FunctionalGroupHeaders = {
|
|
|
269
274
|
*/
|
|
270
275
|
export type X12GS05TimeFormat = "HHMM" | "HHMMSS" | "HHMMSSDD";
|
|
271
276
|
/**
|
|
277
|
+
* Contains options specific to processing inbound X12 EDI files.
|
|
272
278
|
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-b2bi-partnership-x12inboundedioptions.html}
|
|
273
279
|
*/
|
|
274
280
|
export type X12InboundEdiOptions = {
|
|
275
281
|
/**
|
|
282
|
+
* Specifies acknowledgment options for inbound X12 EDI files. These options control how functional and technical acknowledgments are handled.
|
|
276
283
|
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-b2bi-partnership-x12inboundedioptions.html#cfn-b2bi-partnership-x12inboundedioptions-acknowledgmentoptions}
|
|
277
284
|
*/
|
|
278
285
|
AcknowledgmentOptions?: X12AcknowledgmentOptions | undefined;
|
|
@@ -336,6 +343,7 @@ export type X12InterchangeControlHeaders = {
|
|
|
336
343
|
*/
|
|
337
344
|
export type X12OutboundEdiHeaders = {
|
|
338
345
|
/**
|
|
346
|
+
* Specifies control number configuration for outbound X12 EDI headers. These settings determine the starting values for interchange, functional group, and transaction set control numbers.
|
|
339
347
|
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-b2bi-partnership-x12outboundediheaders.html#cfn-b2bi-partnership-x12outboundediheaders-controlnumbers}
|
|
340
348
|
*/
|
|
341
349
|
ControlNumbers?: X12ControlNumbers | undefined;
|
|
@@ -551,7 +551,7 @@ export type S3DataSourceConfiguration = {
|
|
|
551
551
|
*/
|
|
552
552
|
BucketOwnerAccountId?: string | undefined;
|
|
553
553
|
/**
|
|
554
|
-
* A list of S3 prefixes to include certain files or content. For more information, see [Organizing objects using prefixes](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) .
|
|
554
|
+
* A list of S3 prefixes to include certain files or content. This field is an array with a maximum of one item, which can contain a string that has a maximum length of 300 characters. For more information, see [Organizing objects using prefixes](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) .
|
|
555
555
|
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-bedrock-datasource-s3datasourceconfiguration.html#cfn-bedrock-datasource-s3datasourceconfiguration-inclusionprefixes}
|
|
556
556
|
*/
|
|
557
557
|
InclusionPrefixes?: string[] | undefined;
|
|
@@ -219,11 +219,23 @@ export type ContentFilterConfig = {
|
|
|
219
219
|
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-bedrock-guardrail-contentfiltertype.html}
|
|
220
220
|
*/
|
|
221
221
|
export type ContentFilterType = "SEXUAL" | "VIOLENCE" | "HATE" | "INSULTS" | "MISCONDUCT" | "PROMPT_ATTACK";
|
|
222
|
+
/**
|
|
223
|
+
* Tier name for tier configuration in content filters policy
|
|
224
|
+
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-bedrock-guardrail-contentfilterstiername.html}
|
|
225
|
+
*/
|
|
226
|
+
export type ContentFiltersTierName = "CLASSIC" | "STANDARD";
|
|
222
227
|
/**
|
|
223
228
|
* Contains details about how to handle harmful content.
|
|
224
229
|
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-bedrock-guardrail-contentpolicyconfig.html}
|
|
225
230
|
*/
|
|
226
231
|
export type ContentPolicyConfig = {
|
|
232
|
+
/**
|
|
233
|
+
* Guardrail tier config for content policy
|
|
234
|
+
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-bedrock-guardrail-contentpolicyconfig.html#cfn-bedrock-guardrail-contentpolicyconfig-contentfilterstierconfig}
|
|
235
|
+
*/
|
|
236
|
+
ContentFiltersTierConfig?: {
|
|
237
|
+
TierName: ContentFiltersTierName;
|
|
238
|
+
} | undefined;
|
|
227
239
|
/**
|
|
228
240
|
* Contains the type of the content filter and how strongly it should apply to prompts and model responses.
|
|
229
241
|
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-bedrock-guardrail-contentpolicyconfig.html#cfn-bedrock-guardrail-contentpolicyconfig-filtersconfig}
|
|
@@ -625,12 +637,24 @@ export type TopicPolicyConfig = {
|
|
|
625
637
|
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-bedrock-guardrail-topicpolicyconfig.html#cfn-bedrock-guardrail-topicpolicyconfig-topicsconfig}
|
|
626
638
|
*/
|
|
627
639
|
TopicsConfig: TopicConfig[];
|
|
640
|
+
/**
|
|
641
|
+
* Guardrail tier config for topic policy
|
|
642
|
+
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-bedrock-guardrail-topicpolicyconfig.html#cfn-bedrock-guardrail-topicpolicyconfig-topicstierconfig}
|
|
643
|
+
*/
|
|
644
|
+
TopicsTierConfig?: {
|
|
645
|
+
TierName: TopicsTierName;
|
|
646
|
+
} | undefined;
|
|
628
647
|
};
|
|
629
648
|
/**
|
|
630
649
|
* Type of topic in a policy
|
|
631
650
|
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-bedrock-guardrail-topictype.html}
|
|
632
651
|
*/
|
|
633
652
|
export type TopicType = "DENY";
|
|
653
|
+
/**
|
|
654
|
+
* Tier name for tier configuration in topic policy
|
|
655
|
+
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-bedrock-guardrail-topicstiername.html}
|
|
656
|
+
*/
|
|
657
|
+
export type TopicsTierName = "CLASSIC" | "STANDARD";
|
|
634
658
|
/**
|
|
635
659
|
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-bedrock-guardrail-wordaction.html}
|
|
636
660
|
*/
|
|
@@ -25,6 +25,7 @@ export type CassandraTableProps = {
|
|
|
25
25
|
*/
|
|
26
26
|
BillingMode?: BillingMode | undefined;
|
|
27
27
|
/**
|
|
28
|
+
* Represents the CDC configuration for the table
|
|
28
29
|
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cassandra-table.html#cfn-cassandra-table-cdcspecification}
|
|
29
30
|
*/
|
|
30
31
|
CdcSpecification?: CdcSpecification | undefined;
|
|
@@ -200,10 +201,12 @@ export type BillingMode = {
|
|
|
200
201
|
*/
|
|
201
202
|
export type CdcSpecification = {
|
|
202
203
|
/**
|
|
204
|
+
* Indicates whether CDC is enabled or disabled for the table
|
|
203
205
|
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cassandra-table-cdcspecification.html#cfn-cassandra-table-cdcspecification-status}
|
|
204
206
|
*/
|
|
205
207
|
Status: CdcStatus;
|
|
206
208
|
/**
|
|
209
|
+
* Specifies what data should be captured in the change data stream
|
|
207
210
|
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cassandra-table-cdcspecification.html#cfn-cassandra-table-cdcspecification-viewtype}
|
|
208
211
|
*/
|
|
209
212
|
ViewType?: CdcViewType | undefined;
|
|
@@ -359,7 +359,7 @@ export type OperationPreferences = {
|
|
|
359
359
|
*/
|
|
360
360
|
ConcurrencyMode?: ConcurrencyMode | undefined;
|
|
361
361
|
/**
|
|
362
|
-
* The number of accounts
|
|
362
|
+
* The number of accounts per Region this operation can fail in before CloudFormation stops the operation in that Region. If the operation is stopped in a Region, CloudFormation doesn't attempt the operation in any subsequent Regions.
|
|
363
363
|
*
|
|
364
364
|
* Conditional: You must specify either `FailureToleranceCount` or `FailureTolerancePercentage` (but not both).
|
|
365
365
|
* @min 0
|
|
@@ -367,7 +367,7 @@ export type OperationPreferences = {
|
|
|
367
367
|
*/
|
|
368
368
|
FailureToleranceCount?: number | undefined;
|
|
369
369
|
/**
|
|
370
|
-
* The percentage of accounts
|
|
370
|
+
* The percentage of accounts per Region this stack operation can fail in before CloudFormation stops the operation in that Region. If the operation is stopped in a Region, CloudFormation doesn't attempt the operation in any subsequent Regions.
|
|
371
371
|
*
|
|
372
372
|
* When calculating the number of accounts based on the specified percentage, CloudFormation rounds *down* to the next whole number.
|
|
373
373
|
*
|
|
@@ -89,6 +89,8 @@ export type CacheBehavior = {
|
|
|
89
89
|
*/
|
|
90
90
|
Compress?: boolean | undefined;
|
|
91
91
|
/**
|
|
92
|
+
* > This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see [Unsupported features for SaaS Manager for Amazon CloudFront](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-config-options.html#unsupported-saas) in the *Amazon CloudFront Developer Guide* .
|
|
93
|
+
*
|
|
92
94
|
* This field is deprecated. We recommend that you use the `DefaultTTL` field in a cache policy instead of this field. For more information, see [Creating cache policies](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-key-create-cache-policy) or [Using the managed cache policies](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-cache-policies.html) in the *Amazon CloudFront Developer Guide* .
|
|
93
95
|
*
|
|
94
96
|
* The default amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such as `Cache-Control max-age` , `Cache-Control s-maxage` , and `Expires` to objects. For more information, see [Managing How Long Content Stays in an Edge Cache (Expiration)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Expiration.html) in the *Amazon CloudFront Developer Guide* .
|
|
@@ -131,6 +133,8 @@ export type CacheBehavior = {
|
|
|
131
133
|
*/
|
|
132
134
|
LambdaFunctionAssociations?: LambdaFunctionAssociation[] | undefined;
|
|
133
135
|
/**
|
|
136
|
+
* > This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see [Unsupported features for SaaS Manager for Amazon CloudFront](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-config-options.html#unsupported-saas) in the *Amazon CloudFront Developer Guide* .
|
|
137
|
+
*
|
|
134
138
|
* This field is deprecated. We recommend that you use the `MaxTTL` field in a cache policy instead of this field. For more information, see [Creating cache policies](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-key-create-cache-policy) or [Using the managed cache policies](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-cache-policies.html) in the *Amazon CloudFront Developer Guide* .
|
|
135
139
|
*
|
|
136
140
|
* The maximum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such as `Cache-Control max-age` , `Cache-Control s-maxage` , and `Expires` to objects. For more information, see [Managing How Long Content Stays in an Edge Cache (Expiration)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Expiration.html) in the *Amazon CloudFront Developer Guide* .
|
|
@@ -139,6 +143,8 @@ export type CacheBehavior = {
|
|
|
139
143
|
*/
|
|
140
144
|
MaxTTL?: number | undefined;
|
|
141
145
|
/**
|
|
146
|
+
* > This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see [Unsupported features for SaaS Manager for Amazon CloudFront](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-config-options.html#unsupported-saas) in the *Amazon CloudFront Developer Guide* .
|
|
147
|
+
*
|
|
142
148
|
* This field is deprecated. We recommend that you use the `MinTTL` field in a cache policy instead of this field. For more information, see [Creating cache policies](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-key-create-cache-policy) or [Using the managed cache policies](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-cache-policies.html) in the *Amazon CloudFront Developer Guide* .
|
|
143
149
|
*
|
|
144
150
|
* The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. For more information, see [Managing How Long Content Stays in an Edge Cache (Expiration)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Expiration.html) in the *Amazon CloudFront Developer Guide* .
|
|
@@ -175,6 +181,8 @@ export type CacheBehavior = {
|
|
|
175
181
|
*/
|
|
176
182
|
ResponseHeadersPolicyId?: string | undefined;
|
|
177
183
|
/**
|
|
184
|
+
* > This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see [Unsupported features for SaaS Manager for Amazon CloudFront](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-config-options.html#unsupported-saas) in the *Amazon CloudFront Developer Guide* .
|
|
185
|
+
*
|
|
178
186
|
* Indicates whether you want to distribute media files in the Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify `true` ; if not, specify `false` . If you specify `true` for `SmoothStreaming` , you can still distribute other content using this cache behavior if the content matches the value of `PathPattern` .
|
|
179
187
|
* @default false
|
|
180
188
|
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-distribution-cachebehavior.html#cfn-cloudfront-distribution-cachebehavior-smoothstreaming}
|
|
@@ -193,7 +201,7 @@ export type CacheBehavior = {
|
|
|
193
201
|
*/
|
|
194
202
|
TrustedKeyGroups?: string[] | undefined;
|
|
195
203
|
/**
|
|
196
|
-
* > We recommend using `TrustedKeyGroups` instead of `TrustedSigners` .
|
|
204
|
+
* > We recommend using `TrustedKeyGroups` instead of `TrustedSigners` . > This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see [Unsupported features for SaaS Manager for Amazon CloudFront](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-config-options.html#unsupported-saas) in the *Amazon CloudFront Developer Guide* .
|
|
197
205
|
*
|
|
198
206
|
* A list of AWS account IDs whose public keys CloudFront can use to validate signed URLs or signed cookies.
|
|
199
207
|
*
|
|
@@ -324,7 +332,7 @@ export type CustomOriginConfig = {
|
|
|
324
332
|
*/
|
|
325
333
|
HTTPSPort?: number | undefined;
|
|
326
334
|
/**
|
|
327
|
-
* Specifies how long, in seconds, CloudFront persists its connection to the origin. The minimum timeout is 1 second, the maximum is
|
|
335
|
+
* Specifies how long, in seconds, CloudFront persists its connection to the origin. The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 5 seconds.
|
|
328
336
|
*
|
|
329
337
|
* For more information, see [Keep-alive timeout (custom origins only)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/DownloadDistValuesOrigin.html#DownloadDistValuesOriginKeepaliveTimeout) in the *Amazon CloudFront Developer Guide* .
|
|
330
338
|
* @default 5
|
|
@@ -341,7 +349,7 @@ export type CustomOriginConfig = {
|
|
|
341
349
|
*/
|
|
342
350
|
OriginProtocolPolicy: string;
|
|
343
351
|
/**
|
|
344
|
-
* Specifies how long, in seconds, CloudFront waits for a response from the origin. This is also known as the *origin response timeout* . The minimum timeout is 1 second, the maximum is
|
|
352
|
+
* Specifies how long, in seconds, CloudFront waits for a response from the origin. This is also known as the *origin response timeout* . The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 30 seconds.
|
|
345
353
|
*
|
|
346
354
|
* For more information, see [Response timeout (custom origins only)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/DownloadDistValuesOrigin.html#DownloadDistValuesOriginResponseTimeout) in the *Amazon CloudFront Developer Guide* .
|
|
347
355
|
* @default 30
|
|
@@ -400,6 +408,8 @@ export type DefaultCacheBehavior = {
|
|
|
400
408
|
*/
|
|
401
409
|
Compress?: boolean | undefined;
|
|
402
410
|
/**
|
|
411
|
+
* > This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see [Unsupported features for SaaS Manager for Amazon CloudFront](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-config-options.html#unsupported-saas) in the *Amazon CloudFront Developer Guide* .
|
|
412
|
+
*
|
|
403
413
|
* This field is deprecated. We recommend that you use the `DefaultTTL` field in a cache policy instead of this field. For more information, see [Creating cache policies](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-key-create-cache-policy) or [Using the managed cache policies](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-cache-policies.html) in the *Amazon CloudFront Developer Guide* .
|
|
404
414
|
*
|
|
405
415
|
* The default amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such as `Cache-Control max-age` , `Cache-Control s-maxage` , and `Expires` to objects. For more information, see [Managing How Long Content Stays in an Edge Cache (Expiration)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Expiration.html) in the *Amazon CloudFront Developer Guide* .
|
|
@@ -442,6 +452,8 @@ export type DefaultCacheBehavior = {
|
|
|
442
452
|
*/
|
|
443
453
|
LambdaFunctionAssociations?: LambdaFunctionAssociation[] | undefined;
|
|
444
454
|
/**
|
|
455
|
+
* > This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see [Unsupported features for SaaS Manager for Amazon CloudFront](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-config-options.html#unsupported-saas) in the *Amazon CloudFront Developer Guide* .
|
|
456
|
+
*
|
|
445
457
|
* This field is deprecated. We recommend that you use the `MaxTTL` field in a cache policy instead of this field. For more information, see [Creating cache policies](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-key-create-cache-policy) or [Using the managed cache policies](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-cache-policies.html) in the *Amazon CloudFront Developer Guide* .
|
|
446
458
|
*
|
|
447
459
|
* The maximum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such as `Cache-Control max-age` , `Cache-Control s-maxage` , and `Expires` to objects. For more information, see [Managing How Long Content Stays in an Edge Cache (Expiration)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Expiration.html) in the *Amazon CloudFront Developer Guide* .
|
|
@@ -450,6 +462,8 @@ export type DefaultCacheBehavior = {
|
|
|
450
462
|
*/
|
|
451
463
|
MaxTTL?: number | undefined;
|
|
452
464
|
/**
|
|
465
|
+
* > This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see [Unsupported features for SaaS Manager for Amazon CloudFront](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-config-options.html#unsupported-saas) in the *Amazon CloudFront Developer Guide* .
|
|
466
|
+
*
|
|
453
467
|
* This field is deprecated. We recommend that you use the `MinTTL` field in a cache policy instead of this field. For more information, see [Creating cache policies](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-key-create-cache-policy) or [Using the managed cache policies](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-cache-policies.html) in the *Amazon CloudFront Developer Guide* .
|
|
454
468
|
*
|
|
455
469
|
* The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. For more information, see [Managing How Long Content Stays in an Edge Cache (Expiration)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Expiration.html) in the *Amazon CloudFront Developer Guide* .
|
|
@@ -478,6 +492,8 @@ export type DefaultCacheBehavior = {
|
|
|
478
492
|
*/
|
|
479
493
|
ResponseHeadersPolicyId?: string | undefined;
|
|
480
494
|
/**
|
|
495
|
+
* > This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see [Unsupported features for SaaS Manager for Amazon CloudFront](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-config-options.html#unsupported-saas) in the *Amazon CloudFront Developer Guide* .
|
|
496
|
+
*
|
|
481
497
|
* Indicates whether you want to distribute media files in the Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify `true` ; if not, specify `false` . If you specify `true` for `SmoothStreaming` , you can still distribute other content using this cache behavior if the content matches the value of `PathPattern` .
|
|
482
498
|
* @default false
|
|
483
499
|
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-distribution-defaultcachebehavior.html#cfn-cloudfront-distribution-defaultcachebehavior-smoothstreaming}
|
|
@@ -496,7 +512,7 @@ export type DefaultCacheBehavior = {
|
|
|
496
512
|
*/
|
|
497
513
|
TrustedKeyGroups?: string[] | undefined;
|
|
498
514
|
/**
|
|
499
|
-
* > We recommend using `TrustedKeyGroups` instead of `TrustedSigners` .
|
|
515
|
+
* > We recommend using `TrustedKeyGroups` instead of `TrustedSigners` . > This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see [Unsupported features for SaaS Manager for Amazon CloudFront](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-config-options.html#unsupported-saas) in the *Amazon CloudFront Developer Guide* .
|
|
500
516
|
*
|
|
501
517
|
* A list of AWS account IDs whose public keys CloudFront can use to validate signed URLs or signed cookies.
|
|
502
518
|
*
|
|
@@ -524,11 +540,15 @@ export type DefaultCacheBehavior = {
|
|
|
524
540
|
*/
|
|
525
541
|
export type DistributionConfig = {
|
|
526
542
|
/**
|
|
543
|
+
* > This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see [Unsupported features for SaaS Manager for Amazon CloudFront](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-config-options.html#unsupported-saas) in the *Amazon CloudFront Developer Guide* .
|
|
544
|
+
*
|
|
527
545
|
* A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution.
|
|
528
546
|
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-distribution-distributionconfig.html#cfn-cloudfront-distribution-distributionconfig-aliases}
|
|
529
547
|
*/
|
|
530
548
|
Aliases?: string[] | undefined;
|
|
531
549
|
/**
|
|
550
|
+
* > To use this field for a multi-tenant distribution, use a connection group instead. For more information, see [ConnectionGroup](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_ConnectionGroup.html) .
|
|
551
|
+
*
|
|
532
552
|
* ID of the Anycast static IP list that is associated with the distribution.
|
|
533
553
|
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-distribution-distributionconfig.html#cfn-cloudfront-distribution-distributionconfig-anycastiplistid}
|
|
534
554
|
*/
|
|
@@ -557,6 +577,8 @@ export type DistributionConfig = {
|
|
|
557
577
|
*/
|
|
558
578
|
ConnectionMode?: ConnectionMode | undefined;
|
|
559
579
|
/**
|
|
580
|
+
* > This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see [Unsupported features for SaaS Manager for Amazon CloudFront](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-config-options.html#unsupported-saas) in the *Amazon CloudFront Developer Guide* .
|
|
581
|
+
*
|
|
560
582
|
* The identifier of a continuous deployment policy. For more information, see `CreateContinuousDeploymentPolicy` .
|
|
561
583
|
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-distribution-distributionconfig.html#cfn-cloudfront-distribution-distributionconfig-continuousdeploymentpolicyid}
|
|
562
584
|
*/
|
|
@@ -615,6 +637,8 @@ export type DistributionConfig = {
|
|
|
615
637
|
*/
|
|
616
638
|
HttpVersion?: string | undefined;
|
|
617
639
|
/**
|
|
640
|
+
* > To use this field for a multi-tenant distribution, use a connection group instead. For more information, see [ConnectionGroup](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_ConnectionGroup.html) .
|
|
641
|
+
*
|
|
618
642
|
* If you want CloudFront to respond to IPv6 DNS requests with an IPv6 address for your distribution, specify `true` . If you specify `false` , CloudFront responds to IPv6 DNS requests with the DNS response code `NOERROR` and with no IP addresses. This allows viewers to submit a second request, for an IPv4 address for your distribution.
|
|
619
643
|
*
|
|
620
644
|
* In general, you should enable IPv6 if you have users on IPv6 networks who want to access your content. However, if you're using signed URLs or signed cookies to restrict access to your content, and if you're using a custom policy that includes the `IpAddress` parameter to restrict the IP addresses that can access your content, don't enable IPv6. If you want to restrict access to some content by IP address and not restrict access to other content (or restrict access but not by IP address), you can create two distributions. For more information, see [Creating a Signed URL Using a Custom Policy](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/private-content-creating-signed-url-custom-policy.html) in the *Amazon CloudFront Developer Guide* .
|
|
@@ -652,6 +676,8 @@ export type DistributionConfig = {
|
|
|
652
676
|
*/
|
|
653
677
|
Origins?: Origin[] | undefined;
|
|
654
678
|
/**
|
|
679
|
+
* > This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see [Unsupported features for SaaS Manager for Amazon CloudFront](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-config-options.html#unsupported-saas) in the *Amazon CloudFront Developer Guide* .
|
|
680
|
+
*
|
|
655
681
|
* The price class that corresponds with the maximum price that you want to pay for CloudFront service. If you specify `PriceClass_All` , CloudFront responds to requests for your objects from all CloudFront edge locations.
|
|
656
682
|
*
|
|
657
683
|
* If you specify a price class other than `PriceClass_All` , CloudFront serves your objects from the CloudFront edge location that has the lowest latency among the edge locations in your price class. Viewers who are in or near regions that are excluded from your specified price class may encounter slower performance.
|
|
@@ -675,11 +701,15 @@ export type DistributionConfig = {
|
|
|
675
701
|
*/
|
|
676
702
|
S3Origin?: LegacyS3Origin | undefined;
|
|
677
703
|
/**
|
|
704
|
+
* > This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see [Unsupported features for SaaS Manager for Amazon CloudFront](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-config-options.html#unsupported-saas) in the *Amazon CloudFront Developer Guide* .
|
|
705
|
+
*
|
|
678
706
|
* A Boolean that indicates whether this is a staging distribution. When this value is `true` , this is a staging distribution. When this value is `false` , this is not a staging distribution.
|
|
679
707
|
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-distribution-distributionconfig.html#cfn-cloudfront-distribution-distributionconfig-staging}
|
|
680
708
|
*/
|
|
681
709
|
Staging?: boolean | undefined;
|
|
682
710
|
/**
|
|
711
|
+
* > This field only supports multi-tenant distributions. You can't specify this field for standard distributions. For more information, see [Unsupported features for SaaS Manager for Amazon CloudFront](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-config-options.html#unsupported-saas) in the *Amazon CloudFront Developer Guide* .
|
|
712
|
+
*
|
|
683
713
|
* A distribution tenant configuration.
|
|
684
714
|
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-distribution-distributionconfig.html#cfn-cloudfront-distribution-distributionconfig-tenantconfig}
|
|
685
715
|
*/
|
|
@@ -702,6 +732,8 @@ export type DistributionConfig = {
|
|
|
702
732
|
WebACLId?: string | undefined;
|
|
703
733
|
};
|
|
704
734
|
/**
|
|
735
|
+
* > This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see [Unsupported features for SaaS Manager for Amazon CloudFront](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-config-options.html#unsupported-saas) in the *Amazon CloudFront Developer Guide* .
|
|
736
|
+
*
|
|
705
737
|
* This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field.
|
|
706
738
|
*
|
|
707
739
|
* If you want to include values in the cache key, use a cache policy. For more information, see [Creating cache policies](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-key-create-cache-policy) in the *Amazon CloudFront Developer Guide* .
|
|
@@ -1282,7 +1314,7 @@ export type ViewerCertificate = {
|
|
|
1282
1314
|
*/
|
|
1283
1315
|
CloudFrontDefaultCertificate?: boolean | undefined;
|
|
1284
1316
|
/**
|
|
1285
|
-
* > In CloudFormation, this field name is `IamCertificateId` . Note the different capitalization.
|
|
1317
|
+
* > This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see [Unsupported features for SaaS Manager for Amazon CloudFront](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-config-options.html#unsupported-saas) in the *Amazon CloudFront Developer Guide* . > In CloudFormation, this field name is `IamCertificateId` . Note the different capitalization.
|
|
1286
1318
|
*
|
|
1287
1319
|
* If the distribution uses `Aliases` (alternate domain names or CNAMEs) and the SSL/TLS certificate is stored in [AWS Identity and Access Management (IAM)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_server-certs.html) , provide the ID of the IAM certificate.
|
|
1288
1320
|
*
|
|
@@ -1326,7 +1358,7 @@ export type ViewerCertificate = {
|
|
|
1326
1358
|
*/
|
|
1327
1359
|
export type VpcOriginConfig = {
|
|
1328
1360
|
/**
|
|
1329
|
-
* Specifies how long, in seconds, CloudFront persists its connection to the origin. The minimum timeout is 1 second, the maximum is
|
|
1361
|
+
* Specifies how long, in seconds, CloudFront persists its connection to the origin. The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 5 seconds.
|
|
1330
1362
|
*
|
|
1331
1363
|
* For more information, see [Keep-alive timeout (custom origins only)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/DownloadDistValuesOrigin.html#DownloadDistValuesOriginKeepaliveTimeout) in the *Amazon CloudFront Developer Guide* .
|
|
1332
1364
|
* @default 5
|
|
@@ -1334,7 +1366,7 @@ export type VpcOriginConfig = {
|
|
|
1334
1366
|
*/
|
|
1335
1367
|
OriginKeepaliveTimeout?: number | undefined;
|
|
1336
1368
|
/**
|
|
1337
|
-
* Specifies how long, in seconds, CloudFront waits for a response from the origin. This is also known as the *origin response timeout* . The minimum timeout is 1 second, the maximum is
|
|
1369
|
+
* Specifies how long, in seconds, CloudFront waits for a response from the origin. This is also known as the *origin response timeout* . The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 30 seconds.
|
|
1338
1370
|
*
|
|
1339
1371
|
* For more information, see [Response timeout (custom origins only)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/DownloadDistValuesOrigin.html#DownloadDistValuesOriginResponseTimeout) in the *Amazon CloudFront Developer Guide* .
|
|
1340
1372
|
* @default 30
|
|
@@ -10,45 +10,46 @@ import type { ResourceDefinitionWithAttributes, Tag, PolicyDocument } from "../m
|
|
|
10
10
|
*
|
|
11
11
|
* - The IAM Principal executing the stack operation must have the permissions listed below in all regions where you plan to have a global table replica. The IAM Principal's permissions should not have restrictions based on IP source address. Some global tables operations (for example, adding a replica) are asynchronous, and require that the IAM Principal is valid until they complete. You should not delete the Principal (user or IAM role) until CloudFormation has finished updating your stack.
|
|
12
12
|
*
|
|
13
|
+
* - `application-autoscaling:DeleteScalingPolicy`
|
|
14
|
+
* - `application-autoscaling:DeleteScheduledAction`
|
|
15
|
+
* - `application-autoscaling:DeregisterScalableTarget`
|
|
16
|
+
* - `application-autoscaling:DescribeScalableTargets`
|
|
17
|
+
* - `application-autoscaling:DescribeScalingPolicies`
|
|
18
|
+
* - `application-autoscaling:PutScalingPolicy`
|
|
19
|
+
* - `application-autoscaling:PutScheduledAction`
|
|
20
|
+
* - `application-autoscaling:RegisterScalableTarget`
|
|
21
|
+
* - `dynamodb:BatchWriteItem`
|
|
22
|
+
* - `dynamodb:CreateGlobalTableWitness`
|
|
13
23
|
* - `dynamodb:CreateTable`
|
|
14
|
-
* - `dynamodb:
|
|
24
|
+
* - `dynamodb:CreateTableReplica`
|
|
25
|
+
* - `dynamodb:DeleteGlobalTableWitness`
|
|
26
|
+
* - `dynamodb:DeleteItem`
|
|
15
27
|
* - `dynamodb:DeleteTable`
|
|
28
|
+
* - `dynamodb:DeleteTableReplica`
|
|
16
29
|
* - `dynamodb:DescribeContinuousBackups`
|
|
17
30
|
* - `dynamodb:DescribeContributorInsights`
|
|
18
31
|
* - `dynamodb:DescribeTable`
|
|
19
32
|
* - `dynamodb:DescribeTableReplicaAutoScaling`
|
|
20
33
|
* - `dynamodb:DescribeTimeToLive`
|
|
21
|
-
* - `dynamodb:ListTables`
|
|
22
|
-
* - `dynamodb:UpdateTimeToLive`
|
|
23
|
-
* - `dynamodb:UpdateContributorInsights`
|
|
24
|
-
* - `dynamodb:UpdateContinuousBackups`
|
|
25
|
-
* - `dynamodb:ListTagsOfResource`
|
|
26
|
-
* - `dynamodb:TagResource`
|
|
27
|
-
* - `dynamodb:UntagResource`
|
|
28
|
-
* - `dynamodb:BatchWriteItem`
|
|
29
|
-
* - `dynamodb:CreateTableReplica`
|
|
30
|
-
* - `dynamodb:DeleteItem`
|
|
31
|
-
* - `dynamodb:DeleteTableReplica`
|
|
32
34
|
* - `dynamodb:DisableKinesisStreamingDestination`
|
|
33
35
|
* - `dynamodb:EnableKinesisStreamingDestination`
|
|
34
36
|
* - `dynamodb:GetItem`
|
|
37
|
+
* - `dynamodb:ListTables`
|
|
38
|
+
* - `dynamodb:ListTagsOfResource`
|
|
35
39
|
* - `dynamodb:PutItem`
|
|
36
40
|
* - `dynamodb:Query`
|
|
37
41
|
* - `dynamodb:Scan`
|
|
42
|
+
* - `dynamodb:TagResource`
|
|
43
|
+
* - `dynamodb:UntagResource`
|
|
44
|
+
* - `dynamodb:UpdateContinuousBackups`
|
|
45
|
+
* - `dynamodb:UpdateContributorInsights`
|
|
38
46
|
* - `dynamodb:UpdateItem`
|
|
39
|
-
* - `dynamodb:
|
|
47
|
+
* - `dynamodb:UpdateTable`
|
|
40
48
|
* - `dynamodb:UpdateTableReplicaAutoScaling`
|
|
49
|
+
* - `dynamodb:UpdateTimeToLive`
|
|
41
50
|
* - `iam:CreateServiceLinkedRole`
|
|
42
51
|
* - `kms:CreateGrant`
|
|
43
52
|
* - `kms:DescribeKey`
|
|
44
|
-
* - `application-autoscaling:DeleteScalingPolicy`
|
|
45
|
-
* - `application-autoscaling:DeleteScheduledAction`
|
|
46
|
-
* - `application-autoscaling:DeregisterScalableTarget`
|
|
47
|
-
* - `application-autoscaling:DescribeScalingPolicies`
|
|
48
|
-
* - `application-autoscaling:DescribeScalableTargets`
|
|
49
|
-
* - `application-autoscaling:PutScalingPolicy`
|
|
50
|
-
* - `application-autoscaling:PutScheduledAction`
|
|
51
|
-
* - `application-autoscaling:RegisterScalableTarget`
|
|
52
53
|
* - When using provisioned billing mode, CloudFormation will create an auto scaling policy on each of your replicas to control their write capacities. You must configure this policy using the `WriteProvisionedThroughputSettings` property. CloudFormation will ensure that all replicas have the same write capacity auto scaling property. You cannot directly specify a value for write capacity for a global table.
|
|
53
54
|
* - If your table uses provisioned capacity, you must configure auto scaling directly in the `AWS::DynamoDB::GlobalTable` resource. You should not configure additional auto scaling policies on any of the table replicas or global secondary indexes, either via API or via `AWS::ApplicationAutoScaling::ScalableTarget` or `AWS::ApplicationAutoScaling::ScalingPolicy` . Doing so might result in unexpected behavior and is unsupported.
|
|
54
55
|
* - In AWS CloudFormation , each global table is controlled by a single stack, in a single region, regardless of the number of replicas. When you deploy your template, CloudFormation will create/update all replicas as part of a single stack operation. You should not deploy the same `AWS::DynamoDB::GlobalTable` resource in multiple regions. Doing so will result in errors, and is unsupported. If you deploy your application template in multiple regions, you can use conditions to only create the resource in a single region. Alternatively, you can choose to define your `AWS::DynamoDB::GlobalTable` resources in a stack separate from your application stack, and make sure it is only deployed to a single region.
|
|
@@ -66,45 +67,46 @@ export type DynamoDBGlobalTable = ResourceDefinitionWithAttributes<"AWS::DynamoD
|
|
|
66
67
|
*
|
|
67
68
|
* - The IAM Principal executing the stack operation must have the permissions listed below in all regions where you plan to have a global table replica. The IAM Principal's permissions should not have restrictions based on IP source address. Some global tables operations (for example, adding a replica) are asynchronous, and require that the IAM Principal is valid until they complete. You should not delete the Principal (user or IAM role) until CloudFormation has finished updating your stack.
|
|
68
69
|
*
|
|
70
|
+
* - `application-autoscaling:DeleteScalingPolicy`
|
|
71
|
+
* - `application-autoscaling:DeleteScheduledAction`
|
|
72
|
+
* - `application-autoscaling:DeregisterScalableTarget`
|
|
73
|
+
* - `application-autoscaling:DescribeScalableTargets`
|
|
74
|
+
* - `application-autoscaling:DescribeScalingPolicies`
|
|
75
|
+
* - `application-autoscaling:PutScalingPolicy`
|
|
76
|
+
* - `application-autoscaling:PutScheduledAction`
|
|
77
|
+
* - `application-autoscaling:RegisterScalableTarget`
|
|
78
|
+
* - `dynamodb:BatchWriteItem`
|
|
79
|
+
* - `dynamodb:CreateGlobalTableWitness`
|
|
69
80
|
* - `dynamodb:CreateTable`
|
|
70
|
-
* - `dynamodb:
|
|
81
|
+
* - `dynamodb:CreateTableReplica`
|
|
82
|
+
* - `dynamodb:DeleteGlobalTableWitness`
|
|
83
|
+
* - `dynamodb:DeleteItem`
|
|
71
84
|
* - `dynamodb:DeleteTable`
|
|
85
|
+
* - `dynamodb:DeleteTableReplica`
|
|
72
86
|
* - `dynamodb:DescribeContinuousBackups`
|
|
73
87
|
* - `dynamodb:DescribeContributorInsights`
|
|
74
88
|
* - `dynamodb:DescribeTable`
|
|
75
89
|
* - `dynamodb:DescribeTableReplicaAutoScaling`
|
|
76
90
|
* - `dynamodb:DescribeTimeToLive`
|
|
77
|
-
* - `dynamodb:ListTables`
|
|
78
|
-
* - `dynamodb:UpdateTimeToLive`
|
|
79
|
-
* - `dynamodb:UpdateContributorInsights`
|
|
80
|
-
* - `dynamodb:UpdateContinuousBackups`
|
|
81
|
-
* - `dynamodb:ListTagsOfResource`
|
|
82
|
-
* - `dynamodb:TagResource`
|
|
83
|
-
* - `dynamodb:UntagResource`
|
|
84
|
-
* - `dynamodb:BatchWriteItem`
|
|
85
|
-
* - `dynamodb:CreateTableReplica`
|
|
86
|
-
* - `dynamodb:DeleteItem`
|
|
87
|
-
* - `dynamodb:DeleteTableReplica`
|
|
88
91
|
* - `dynamodb:DisableKinesisStreamingDestination`
|
|
89
92
|
* - `dynamodb:EnableKinesisStreamingDestination`
|
|
90
93
|
* - `dynamodb:GetItem`
|
|
94
|
+
* - `dynamodb:ListTables`
|
|
95
|
+
* - `dynamodb:ListTagsOfResource`
|
|
91
96
|
* - `dynamodb:PutItem`
|
|
92
97
|
* - `dynamodb:Query`
|
|
93
98
|
* - `dynamodb:Scan`
|
|
99
|
+
* - `dynamodb:TagResource`
|
|
100
|
+
* - `dynamodb:UntagResource`
|
|
101
|
+
* - `dynamodb:UpdateContinuousBackups`
|
|
102
|
+
* - `dynamodb:UpdateContributorInsights`
|
|
94
103
|
* - `dynamodb:UpdateItem`
|
|
95
|
-
* - `dynamodb:
|
|
104
|
+
* - `dynamodb:UpdateTable`
|
|
96
105
|
* - `dynamodb:UpdateTableReplicaAutoScaling`
|
|
106
|
+
* - `dynamodb:UpdateTimeToLive`
|
|
97
107
|
* - `iam:CreateServiceLinkedRole`
|
|
98
108
|
* - `kms:CreateGrant`
|
|
99
109
|
* - `kms:DescribeKey`
|
|
100
|
-
* - `application-autoscaling:DeleteScalingPolicy`
|
|
101
|
-
* - `application-autoscaling:DeleteScheduledAction`
|
|
102
|
-
* - `application-autoscaling:DeregisterScalableTarget`
|
|
103
|
-
* - `application-autoscaling:DescribeScalingPolicies`
|
|
104
|
-
* - `application-autoscaling:DescribeScalableTargets`
|
|
105
|
-
* - `application-autoscaling:PutScalingPolicy`
|
|
106
|
-
* - `application-autoscaling:PutScheduledAction`
|
|
107
|
-
* - `application-autoscaling:RegisterScalableTarget`
|
|
108
110
|
* - When using provisioned billing mode, CloudFormation will create an auto scaling policy on each of your replicas to control their write capacities. You must configure this policy using the `WriteProvisionedThroughputSettings` property. CloudFormation will ensure that all replicas have the same write capacity auto scaling property. You cannot directly specify a value for write capacity for a global table.
|
|
109
111
|
* - If your table uses provisioned capacity, you must configure auto scaling directly in the `AWS::DynamoDB::GlobalTable` resource. You should not configure additional auto scaling policies on any of the table replicas or global secondary indexes, either via API or via `AWS::ApplicationAutoScaling::ScalableTarget` or `AWS::ApplicationAutoScaling::ScalingPolicy` . Doing so might result in unexpected behavior and is unsupported.
|
|
110
112
|
* - In AWS CloudFormation , each global table is controlled by a single stack, in a single region, regardless of the number of replicas. When you deploy your template, CloudFormation will create/update all replicas as part of a single stack operation. You should not deploy the same `AWS::DynamoDB::GlobalTable` resource in multiple regions. Doing so will result in errors, and is unsupported. If you deploy your application template in multiple regions, you can use conditions to only create the resource in a single region. Alternatively, you can choose to define your `AWS::DynamoDB::GlobalTable` resources in a stack separate from your application stack, and make sure it is only deployed to a single region.
|
|
@@ -133,6 +135,11 @@ export type DynamoDBGlobalTableProps = {
|
|
|
133
135
|
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-globaltable.html#cfn-dynamodb-globaltable-globalsecondaryindexes}
|
|
134
136
|
*/
|
|
135
137
|
GlobalSecondaryIndexes?: GlobalSecondaryIndex[] | undefined;
|
|
138
|
+
/**
|
|
139
|
+
* The list of witnesses of the MRSC global table. Only one witness Region can be configured per MRSC global table.
|
|
140
|
+
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-globaltable.html#cfn-dynamodb-globaltable-globaltablewitnesses}
|
|
141
|
+
*/
|
|
142
|
+
GlobalTableWitnesses?: GlobalTableWitness[] | undefined;
|
|
136
143
|
/**
|
|
137
144
|
* Specifies the attributes that make up the primary key for the table. The attributes in the `KeySchema` property must also be defined in the `AttributeDefinitions` property.
|
|
138
145
|
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-globaltable.html#cfn-dynamodb-globaltable-keyschema}
|
|
@@ -143,6 +150,18 @@ export type DynamoDBGlobalTableProps = {
|
|
|
143
150
|
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-globaltable.html#cfn-dynamodb-globaltable-localsecondaryindexes}
|
|
144
151
|
*/
|
|
145
152
|
LocalSecondaryIndexes?: LocalSecondaryIndex[] | undefined;
|
|
153
|
+
/**
|
|
154
|
+
* Specifies the consistency mode for a new global table.
|
|
155
|
+
*
|
|
156
|
+
* You can specify one of the following consistency modes:
|
|
157
|
+
*
|
|
158
|
+
* - `EVENTUAL` : Configures a new global table for multi-Region eventual consistency (MREC).
|
|
159
|
+
* - `STRONG` : Configures a new global table for multi-Region strong consistency (MRSC).
|
|
160
|
+
*
|
|
161
|
+
* If you don't specify this field, the global table consistency mode defaults to `EVENTUAL` . For more information about global tables consistency modes, see [Consistency modes](https://docs.aws.amazon.com/V2globaltables_HowItWorks.html#V2globaltables_HowItWorks.consistency-modes) in DynamoDB developer guide.
|
|
162
|
+
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-globaltable.html#cfn-dynamodb-globaltable-multiregionconsistency}
|
|
163
|
+
*/
|
|
164
|
+
MultiRegionConsistency?: "EVENTUAL" | "STRONG" | undefined;
|
|
146
165
|
/**
|
|
147
166
|
* Specifies the list of replicas for your global table. The list must contain at least one element, the region where the stack defining the global table is deployed. For example, if you define your table in a stack deployed to us-east-1, you must have an entry in `Replicas` with the region us-east-1. You cannot remove the replica in the stack region.
|
|
148
167
|
*
|
|
@@ -150,7 +169,7 @@ export type DynamoDBGlobalTableProps = {
|
|
|
150
169
|
* >
|
|
151
170
|
* > If you add or delete a replica during an update, we recommend that you don't update any other resources. If your stack fails to update and is rolled back while adding a new replica, you might need to manually delete the replica.
|
|
152
171
|
*
|
|
153
|
-
* You can create a new global table with as many replicas as needed. You can add or remove replicas after table creation, but you can only add or remove a single replica in each update.
|
|
172
|
+
* You can create a new global table with as many replicas as needed. You can add or remove replicas after table creation, but you can only add or remove a single replica in each update. For Multi-Region Strong Consistency (MRSC), you can add or remove up to 3 replicas, or 2 replicas plus a witness Region.
|
|
154
173
|
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-globaltable.html#cfn-dynamodb-globaltable-replicas}
|
|
155
174
|
*/
|
|
156
175
|
Replicas: ReplicaSpecification[];
|
|
@@ -160,7 +179,7 @@ export type DynamoDBGlobalTableProps = {
|
|
|
160
179
|
*/
|
|
161
180
|
SSESpecification?: SSESpecification | undefined;
|
|
162
181
|
/**
|
|
163
|
-
* Specifies the streams settings on your global table. You must provide a value for this property if your global table contains more than one replica. You can only change the streams settings if your global table has only one replica.
|
|
182
|
+
* Specifies the streams settings on your global table. You must provide a value for this property if your global table contains more than one replica. You can only change the streams settings if your global table has only one replica. For Multi-Region Strong Consistency (MRSC), you do not need to provide a value for this property and can change the settings at any time.
|
|
164
183
|
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-globaltable.html#cfn-dynamodb-globaltable-streamspecification}
|
|
165
184
|
*/
|
|
166
185
|
StreamSpecification?: StreamSpecification | undefined;
|
|
@@ -325,6 +344,23 @@ export type GlobalSecondaryIndex = {
|
|
|
325
344
|
*/
|
|
326
345
|
WriteProvisionedThroughputSettings?: WriteProvisionedThroughputSettings | undefined;
|
|
327
346
|
};
|
|
347
|
+
/**
|
|
348
|
+
* The witness Region for the MRSC global table. A MRSC global table can be configured with either three replicas, or with two replicas and one witness.
|
|
349
|
+
*
|
|
350
|
+
* The witness must be in a different Region than the replicas and within the same Region set:
|
|
351
|
+
*
|
|
352
|
+
* - US Region set: US East (N. Virginia), US East (Ohio), US West (Oregon)
|
|
353
|
+
* - EU Region set: Europe (Ireland), Europe (London), Europe (Paris), Europe (Frankfurt)
|
|
354
|
+
* - AP Region set: Asia Pacific (Tokyo), Asia Pacific (Seoul), Asia Pacific (Osaka)
|
|
355
|
+
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-dynamodb-globaltable-globaltablewitness.html}
|
|
356
|
+
*/
|
|
357
|
+
export type GlobalTableWitness = {
|
|
358
|
+
/**
|
|
359
|
+
* The name of the AWS Region that serves as a witness for the MRSC global table.
|
|
360
|
+
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-dynamodb-globaltable-globaltablewitness.html#cfn-dynamodb-globaltable-globaltablewitness-region}
|
|
361
|
+
*/
|
|
362
|
+
Region?: string | undefined;
|
|
363
|
+
};
|
|
328
364
|
/**
|
|
329
365
|
* Represents *a single element* of a key schema. A key schema specifies the attributes that make up the primary key of a table, or the key attributes of an index.
|
|
330
366
|
*
|
|
@@ -646,9 +682,9 @@ export type SSESpecification = {
|
|
|
646
682
|
SSEType?: string | undefined;
|
|
647
683
|
};
|
|
648
684
|
/**
|
|
649
|
-
* Represents the DynamoDB Streams configuration for a table in DynamoDB.
|
|
685
|
+
* Represents the DynamoDB Streams configuration for a table in DynamoDB .
|
|
650
686
|
*
|
|
651
|
-
* You can only modify this value
|
|
687
|
+
* You can only modify this value for a `AWS::DynamoDB::GlobalTable` resource configured for multi-Region eventual consistency (MREC, the default) if that resource contains only one entry in `Replicas` . You must specify a value for this property for a `AWS::DynamoDB::GlobalTable` resource configured for MREC with more than one entry in `Replicas` . For Multi-Region Strong Consistency (MRSC), Streams are not required and can be changed for existing tables.
|
|
652
688
|
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-dynamodb-globaltable-streamspecification.html}
|
|
653
689
|
*/
|
|
654
690
|
export type StreamSpecification = {
|
|
@@ -106,9 +106,13 @@ export type DynamoDBTableProps = {
|
|
|
106
106
|
*/
|
|
107
107
|
ProvisionedThroughput?: ProvisionedThroughput | undefined;
|
|
108
108
|
/**
|
|
109
|
-
*
|
|
109
|
+
* An AWS resource-based policy document in JSON format that will be attached to the table.
|
|
110
110
|
*
|
|
111
|
-
* When you attach a resource-based policy while creating a table, the policy
|
|
111
|
+
* When you attach a resource-based policy while creating a table, the policy application is *strongly consistent* .
|
|
112
|
+
*
|
|
113
|
+
* The maximum size supported for a resource-based policy document is 20 KB. DynamoDB counts whitespaces when calculating the size of a policy against this limit. For a full list of all considerations that apply for resource-based policies, see [Resource-based policy considerations](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/rbac-considerations.html) .
|
|
114
|
+
*
|
|
115
|
+
* > You need to specify the `CreateTable` and `PutResourcePolicy` IAM actions for authorizing a user to create a table with a resource-based policy.
|
|
112
116
|
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-table.html#cfn-dynamodb-table-resourcepolicy}
|
|
113
117
|
*/
|
|
114
118
|
ResourcePolicy?: ResourcePolicy | undefined;
|
|
@@ -80,7 +80,7 @@ export type EC2TrafficMirrorFilterRuleProps = {
|
|
|
80
80
|
*/
|
|
81
81
|
export type EC2TrafficMirrorFilterRuleAttribs = {
|
|
82
82
|
/**
|
|
83
|
-
* The ID of the Traffic Mirror
|
|
83
|
+
* The ID of the Traffic Mirror rule.
|
|
84
84
|
* @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-trafficmirrorfilterrule.html#cfn-ec2-trafficmirrorfilterrule-trafficmirrorfilterruleid}
|
|
85
85
|
*/
|
|
86
86
|
TrafficMirrorFilterRuleId: string;
|