aws-cdk-lib 2.168.0__py3-none-any.whl → 2.170.0__py3-none-any.whl

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.
Files changed (40) hide show
  1. aws_cdk/__init__.py +2 -0
  2. aws_cdk/_jsii/__init__.py +1 -1
  3. aws_cdk/_jsii/{aws-cdk-lib@2.168.0.jsii.tgz → aws-cdk-lib@2.170.0.jsii.tgz} +0 -0
  4. aws_cdk/aws_accessanalyzer/__init__.py +244 -13
  5. aws_cdk/aws_applicationsignals/__init__.py +8 -1
  6. aws_cdk/aws_autoscaling/__init__.py +310 -9
  7. aws_cdk/aws_cloudfront/__init__.py +50 -0
  8. aws_cdk/aws_cloudfront/experimental/__init__.py +5 -0
  9. aws_cdk/aws_codebuild/__init__.py +2 -2
  10. aws_cdk/aws_connect/__init__.py +378 -0
  11. aws_cdk/aws_customerprofiles/__init__.py +44 -0
  12. aws_cdk/aws_deadline/__init__.py +299 -6
  13. aws_cdk/aws_dynamodb/__init__.py +47 -25
  14. aws_cdk/aws_ec2/__init__.py +6 -2
  15. aws_cdk/aws_ecs/__init__.py +28 -22
  16. aws_cdk/aws_efs/__init__.py +61 -4
  17. aws_cdk/aws_eks/__init__.py +116 -0
  18. aws_cdk/aws_gamelift/__init__.py +385 -251
  19. aws_cdk/aws_iot/__init__.py +209 -0
  20. aws_cdk/aws_iotfleetwise/__init__.py +550 -0
  21. aws_cdk/aws_iotsitewise/__init__.py +6 -3
  22. aws_cdk/aws_ivs/__init__.py +458 -0
  23. aws_cdk/aws_kinesisfirehose/__init__.py +90 -33
  24. aws_cdk/aws_lambda/__init__.py +150 -6
  25. aws_cdk/aws_lambda_event_sources/__init__.py +298 -1
  26. aws_cdk/aws_rbin/__init__.py +902 -0
  27. aws_cdk/aws_rds/__init__.py +115 -0
  28. aws_cdk/aws_route53resolver/__init__.py +76 -19
  29. aws_cdk/aws_sagemaker/__init__.py +32 -0
  30. aws_cdk/aws_sns/__init__.py +593 -8
  31. aws_cdk/aws_sns_subscriptions/__init__.py +68 -22
  32. aws_cdk/aws_synthetics/__init__.py +46 -0
  33. aws_cdk/aws_vpclattice/__init__.py +118 -2
  34. aws_cdk/aws_wisdom/__init__.py +16 -21
  35. {aws_cdk_lib-2.168.0.dist-info → aws_cdk_lib-2.170.0.dist-info}/METADATA +1 -1
  36. {aws_cdk_lib-2.168.0.dist-info → aws_cdk_lib-2.170.0.dist-info}/RECORD +40 -39
  37. {aws_cdk_lib-2.168.0.dist-info → aws_cdk_lib-2.170.0.dist-info}/LICENSE +0 -0
  38. {aws_cdk_lib-2.168.0.dist-info → aws_cdk_lib-2.170.0.dist-info}/NOTICE +0 -0
  39. {aws_cdk_lib-2.168.0.dist-info → aws_cdk_lib-2.170.0.dist-info}/WHEEL +0 -0
  40. {aws_cdk_lib-2.168.0.dist-info → aws_cdk_lib-2.170.0.dist-info}/top_level.txt +0 -0
@@ -1689,7 +1689,7 @@ class CfnGlobalTable(
1689
1689
  :param stream_specification: 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.
1690
1690
  :param table_name: A name for the global table. If you don't specify a name, AWS CloudFormation generates a unique ID and uses that ID as the table name. For more information, see `Name type <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-name.html>`_ . .. epigraph:: If you specify a name, you cannot perform updates that require replacement of this resource. You can perform updates that require no or some interruption. If you must replace the resource, specify a new name.
1691
1691
  :param time_to_live_specification: Specifies the time to live (TTL) settings for the table. This setting will be applied to all replicas.
1692
- :param warm_throughput:
1692
+ :param warm_throughput: Provides visibility into the number of read and write operations your table or secondary index can instantaneously support. The settings can be modified using the ``UpdateTable`` operation to meet the throughput requirements of an upcoming peak event.
1693
1693
  :param write_on_demand_throughput_settings: Sets the write request settings for a global table or a global secondary index. You can only specify this setting if your resource uses the ``PAY_PER_REQUEST`` ``BillingMode`` .
1694
1694
  :param write_provisioned_throughput_settings: Specifies an auto scaling policy for write capacity. This policy will be applied to all replicas. This setting must be specified if ``BillingMode`` is set to ``PROVISIONED`` .
1695
1695
  '''
@@ -1963,6 +1963,7 @@ class CfnGlobalTable(
1963
1963
  def warm_throughput(
1964
1964
  self,
1965
1965
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnGlobalTable.WarmThroughputProperty"]]:
1966
+ '''Provides visibility into the number of read and write operations your table or secondary index can instantaneously support.'''
1966
1967
  return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnGlobalTable.WarmThroughputProperty"]], jsii.get(self, "warmThroughput"))
1967
1968
 
1968
1969
  @warm_throughput.setter
@@ -2298,7 +2299,7 @@ class CfnGlobalTable(
2298
2299
  :param index_name: The name of the global secondary index. The name must be unique among all other indexes on this table.
2299
2300
  :param key_schema: The complete key schema for a global secondary index, which consists of one or more pairs of attribute names and key types: - ``HASH`` - partition key - ``RANGE`` - sort key > The partition key of an item is also known as its *hash attribute* . The term "hash attribute" derives from DynamoDB's usage of an internal hash function to evenly distribute data items across partitions, based on their partition key values. .. epigraph:: The sort key of an item is also known as its *range attribute* . The term "range attribute" derives from the way DynamoDB stores items with the same partition key physically close together, in sorted order by the sort key value.
2300
2301
  :param projection: Represents attributes that are copied (projected) from the table into the global secondary index. These are in addition to the primary key attributes and index key attributes, which are automatically projected.
2301
- :param warm_throughput:
2302
+ :param warm_throughput: Represents the warm throughput value (in read units per second and write units per second) for the specified secondary index. If you use this parameter, you must specify ``ReadUnitsPerSecond`` , ``WriteUnitsPerSecond`` , or both.
2302
2303
  :param write_on_demand_throughput_settings: Sets the write request settings for a global table or a global secondary index. You can only specify this setting if your resource uses the ``PAY_PER_REQUEST`` ``BillingMode`` .
2303
2304
  :param write_provisioned_throughput_settings: Defines write capacity settings for the global secondary index. You must specify a value for this property if the table's ``BillingMode`` is ``PROVISIONED`` . All replicas will have the same write capacity settings for this global secondary index.
2304
2305
 
@@ -2416,7 +2417,10 @@ class CfnGlobalTable(
2416
2417
  def warm_throughput(
2417
2418
  self,
2418
2419
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnGlobalTable.WarmThroughputProperty"]]:
2419
- '''
2420
+ '''Represents the warm throughput value (in read units per second and write units per second) for the specified secondary index.
2421
+
2422
+ If you use this parameter, you must specify ``ReadUnitsPerSecond`` , ``WriteUnitsPerSecond`` , or both.
2423
+
2420
2424
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-dynamodb-globaltable-globalsecondaryindex.html#cfn-dynamodb-globaltable-globalsecondaryindex-warmthroughput
2421
2425
  '''
2422
2426
  result = self._values.get("warm_throughput")
@@ -4061,9 +4065,12 @@ class CfnGlobalTable(
4061
4065
  read_units_per_second: typing.Optional[jsii.Number] = None,
4062
4066
  write_units_per_second: typing.Optional[jsii.Number] = None,
4063
4067
  ) -> None:
4064
- '''
4065
- :param read_units_per_second:
4066
- :param write_units_per_second:
4068
+ '''Provides visibility into the number of read and write operations your table or secondary index can instantaneously support.
4069
+
4070
+ The settings can be modified using the ``UpdateTable`` operation to meet the throughput requirements of an upcoming peak event.
4071
+
4072
+ :param read_units_per_second: Represents the number of read operations your base table can instantaneously support.
4073
+ :param write_units_per_second: Represents the number of write operations your base table can instantaneously support.
4067
4074
 
4068
4075
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-dynamodb-globaltable-warmthroughput.html
4069
4076
  :exampleMetadata: fixture=_generated
@@ -4091,7 +4098,8 @@ class CfnGlobalTable(
4091
4098
 
4092
4099
  @builtins.property
4093
4100
  def read_units_per_second(self) -> typing.Optional[jsii.Number]:
4094
- '''
4101
+ '''Represents the number of read operations your base table can instantaneously support.
4102
+
4095
4103
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-dynamodb-globaltable-warmthroughput.html#cfn-dynamodb-globaltable-warmthroughput-readunitspersecond
4096
4104
  '''
4097
4105
  result = self._values.get("read_units_per_second")
@@ -4099,7 +4107,8 @@ class CfnGlobalTable(
4099
4107
 
4100
4108
  @builtins.property
4101
4109
  def write_units_per_second(self) -> typing.Optional[jsii.Number]:
4102
- '''
4110
+ '''Represents the number of write operations your base table can instantaneously support.
4111
+
4103
4112
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-dynamodb-globaltable-warmthroughput.html#cfn-dynamodb-globaltable-warmthroughput-writeunitspersecond
4104
4113
  '''
4105
4114
  result = self._values.get("write_units_per_second")
@@ -4298,7 +4307,7 @@ class CfnGlobalTableProps:
4298
4307
  :param stream_specification: 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.
4299
4308
  :param table_name: A name for the global table. If you don't specify a name, AWS CloudFormation generates a unique ID and uses that ID as the table name. For more information, see `Name type <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-name.html>`_ . .. epigraph:: If you specify a name, you cannot perform updates that require replacement of this resource. You can perform updates that require no or some interruption. If you must replace the resource, specify a new name.
4300
4309
  :param time_to_live_specification: Specifies the time to live (TTL) settings for the table. This setting will be applied to all replicas.
4301
- :param warm_throughput:
4310
+ :param warm_throughput: Provides visibility into the number of read and write operations your table or secondary index can instantaneously support. The settings can be modified using the ``UpdateTable`` operation to meet the throughput requirements of an upcoming peak event.
4302
4311
  :param write_on_demand_throughput_settings: Sets the write request settings for a global table or a global secondary index. You can only specify this setting if your resource uses the ``PAY_PER_REQUEST`` ``BillingMode`` .
4303
4312
  :param write_provisioned_throughput_settings: Specifies an auto scaling policy for write capacity. This policy will be applied to all replicas. This setting must be specified if ``BillingMode`` is set to ``PROVISIONED`` .
4304
4313
 
@@ -4686,7 +4695,10 @@ class CfnGlobalTableProps:
4686
4695
  def warm_throughput(
4687
4696
  self,
4688
4697
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnGlobalTable.WarmThroughputProperty]]:
4689
- '''
4698
+ '''Provides visibility into the number of read and write operations your table or secondary index can instantaneously support.
4699
+
4700
+ The settings can be modified using the ``UpdateTable`` operation to meet the throughput requirements of an upcoming peak event.
4701
+
4690
4702
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-globaltable.html#cfn-dynamodb-globaltable-warmthroughput
4691
4703
  '''
4692
4704
  result = self._values.get("warm_throughput")
@@ -4921,7 +4933,7 @@ class CfnTable(
4921
4933
  :param contributor_insights_specification: The settings used to enable or disable CloudWatch Contributor Insights for the specified table.
4922
4934
  :param deletion_protection_enabled: Determines if a table is protected from deletion. When enabled, the table cannot be deleted by any user or process. This setting is disabled by default. For more information, see `Using deletion protection <https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.Basics.html#WorkingWithTables.Basics.DeletionProtection>`_ in the *Amazon DynamoDB Developer Guide* .
4923
4935
  :param global_secondary_indexes: Global secondary indexes to be created on the table. You can create up to 20 global secondary indexes. .. epigraph:: If you update a table to include a new global secondary index, AWS CloudFormation initiates the index creation and then proceeds with the stack update. AWS CloudFormation doesn't wait for the index to complete creation because the backfilling phase can take a long time, depending on the size of the table. You can't use the index or update the table until the index's status is ``ACTIVE`` . You can track its status by using the DynamoDB `DescribeTable <https://docs.aws.amazon.com/cli/latest/reference/dynamodb/describe-table.html>`_ command. If you add or delete an index 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 index, you must manually delete the index. Updates are not supported. The following are exceptions: - If you update either the contributor insights specification or the provisioned throughput values of global secondary indexes, you can update the table without interruption. - You can delete or add one global secondary index without interruption. If you do both in the same update (for example, by changing the index's logical ID), the update fails.
4924
- :param import_source_specification: Specifies the properties of data being imported from the S3 bucket source to the table. .. epigraph:: If you specify the ``ImportSourceSpecification`` property, and also specify either the ``StreamSpecification`` , the ``TableClass`` property, or the ``DeletionProtectionEnabled`` property, the IAM entity creating/updating stack must have ``UpdateTable`` permission.
4936
+ :param import_source_specification: Specifies the properties of data being imported from the S3 bucket source to the" table. .. epigraph:: If you specify the ``ImportSourceSpecification`` property, and also specify either the ``StreamSpecification`` , the ``TableClass`` property, the ``DeletionProtectionEnabled`` property, or the ``WarmThroughput`` property, the IAM entity creating/updating stack must have ``UpdateTable`` permission.
4925
4937
  :param kinesis_stream_specification: The Kinesis Data Streams configuration for the specified table.
4926
4938
  :param local_secondary_indexes: Local secondary indexes to be created on the table. You can create up to 5 local secondary indexes. Each index is scoped to a given hash key value. The size of each hash key can be up to 10 gigabytes.
4927
4939
  :param on_demand_throughput: Sets the maximum number of read and write units for the specified on-demand table. If you use this property, you must specify ``MaxReadRequestUnits`` , ``MaxWriteRequestUnits`` , or both.
@@ -4934,7 +4946,7 @@ class CfnTable(
4934
4946
  :param table_name: A name for the table. If you don't specify a name, AWS CloudFormation generates a unique physical ID and uses that ID for the table name. For more information, see `Name Type <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-name.html>`_ . .. epigraph:: If you specify a name, you cannot perform updates that require replacement of this resource. You can perform updates that require no or some interruption. If you must replace the resource, specify a new name.
4935
4947
  :param tags: An array of key-value pairs to apply to this resource. For more information, see `Tag <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-resource-tags.html>`_ .
4936
4948
  :param time_to_live_specification: Specifies the Time to Live (TTL) settings for the table. .. epigraph:: For detailed information about the limits in DynamoDB, see `Limits in Amazon DynamoDB <https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Limits.html>`_ in the Amazon DynamoDB Developer Guide.
4937
- :param warm_throughput:
4949
+ :param warm_throughput: Represents the warm throughput (in read units per second and write units per second) for creating a table.
4938
4950
  '''
4939
4951
  if __debug__:
4940
4952
  type_hints = typing.get_type_hints(_typecheckingstub__9c4a83992df200bfde2ccfe129994eeacab105432a2509473861feb736dd5ea6)
@@ -5139,7 +5151,7 @@ class CfnTable(
5139
5151
  def import_source_specification(
5140
5152
  self,
5141
5153
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnTable.ImportSourceSpecificationProperty"]]:
5142
- '''Specifies the properties of data being imported from the S3 bucket source to the table.'''
5154
+ '''Specifies the properties of data being imported from the S3 bucket source to the" table.'''
5143
5155
  return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnTable.ImportSourceSpecificationProperty"]], jsii.get(self, "importSourceSpecification"))
5144
5156
 
5145
5157
  @import_source_specification.setter
@@ -5358,6 +5370,7 @@ class CfnTable(
5358
5370
  def warm_throughput(
5359
5371
  self,
5360
5372
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnTable.WarmThroughputProperty"]]:
5373
+ '''Represents the warm throughput (in read units per second and write units per second) for creating a table.'''
5361
5374
  return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnTable.WarmThroughputProperty"]], jsii.get(self, "warmThroughput"))
5362
5375
 
5363
5376
  @warm_throughput.setter
@@ -5611,7 +5624,7 @@ class CfnTable(
5611
5624
  :param contributor_insights_specification: The settings used to enable or disable CloudWatch Contributor Insights for the specified global secondary index.
5612
5625
  :param on_demand_throughput: The maximum number of read and write units for the specified global secondary index. If you use this parameter, you must specify ``MaxReadRequestUnits`` , ``MaxWriteRequestUnits`` , or both.
5613
5626
  :param provisioned_throughput: Represents the provisioned throughput settings for the specified global secondary index. For current minimum and maximum provisioned throughput values, see `Service, Account, and Table Quotas <https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Limits.html>`_ in the *Amazon DynamoDB Developer Guide* .
5614
- :param warm_throughput:
5627
+ :param warm_throughput: Represents the warm throughput value (in read units per second and write units per second) for the specified secondary index. If you use this parameter, you must specify ``ReadUnitsPerSecond`` , ``WriteUnitsPerSecond`` , or both.
5615
5628
 
5616
5629
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-dynamodb-table-globalsecondaryindex.html
5617
5630
  :exampleMetadata: fixture=_generated
@@ -5758,7 +5771,10 @@ class CfnTable(
5758
5771
  def warm_throughput(
5759
5772
  self,
5760
5773
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnTable.WarmThroughputProperty"]]:
5761
- '''
5774
+ '''Represents the warm throughput value (in read units per second and write units per second) for the specified secondary index.
5775
+
5776
+ If you use this parameter, you must specify ``ReadUnitsPerSecond`` , ``WriteUnitsPerSecond`` , or both.
5777
+
5762
5778
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-dynamodb-table-globalsecondaryindex.html#cfn-dynamodb-table-globalsecondaryindex-warmthroughput
5763
5779
  '''
5764
5780
  result = self._values.get("warm_throughput")
@@ -6994,9 +7010,12 @@ class CfnTable(
6994
7010
  read_units_per_second: typing.Optional[jsii.Number] = None,
6995
7011
  write_units_per_second: typing.Optional[jsii.Number] = None,
6996
7012
  ) -> None:
6997
- '''
6998
- :param read_units_per_second:
6999
- :param write_units_per_second:
7013
+ '''Provides visibility into the number of read and write operations your table or secondary index can instantaneously support.
7014
+
7015
+ The settings can be modified using the ``UpdateTable`` operation to meet the throughput requirements of an upcoming peak event.
7016
+
7017
+ :param read_units_per_second: Represents the number of read operations your base table can instantaneously support.
7018
+ :param write_units_per_second: Represents the number of write operations your base table can instantaneously support.
7000
7019
 
7001
7020
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-dynamodb-table-warmthroughput.html
7002
7021
  :exampleMetadata: fixture=_generated
@@ -7024,7 +7043,8 @@ class CfnTable(
7024
7043
 
7025
7044
  @builtins.property
7026
7045
  def read_units_per_second(self) -> typing.Optional[jsii.Number]:
7027
- '''
7046
+ '''Represents the number of read operations your base table can instantaneously support.
7047
+
7028
7048
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-dynamodb-table-warmthroughput.html#cfn-dynamodb-table-warmthroughput-readunitspersecond
7029
7049
  '''
7030
7050
  result = self._values.get("read_units_per_second")
@@ -7032,7 +7052,8 @@ class CfnTable(
7032
7052
 
7033
7053
  @builtins.property
7034
7054
  def write_units_per_second(self) -> typing.Optional[jsii.Number]:
7035
- '''
7055
+ '''Represents the number of write operations your base table can instantaneously support.
7056
+
7036
7057
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-dynamodb-table-warmthroughput.html#cfn-dynamodb-table-warmthroughput-writeunitspersecond
7037
7058
  '''
7038
7059
  result = self._values.get("write_units_per_second")
@@ -7109,7 +7130,7 @@ class CfnTableProps:
7109
7130
  :param contributor_insights_specification: The settings used to enable or disable CloudWatch Contributor Insights for the specified table.
7110
7131
  :param deletion_protection_enabled: Determines if a table is protected from deletion. When enabled, the table cannot be deleted by any user or process. This setting is disabled by default. For more information, see `Using deletion protection <https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.Basics.html#WorkingWithTables.Basics.DeletionProtection>`_ in the *Amazon DynamoDB Developer Guide* .
7111
7132
  :param global_secondary_indexes: Global secondary indexes to be created on the table. You can create up to 20 global secondary indexes. .. epigraph:: If you update a table to include a new global secondary index, AWS CloudFormation initiates the index creation and then proceeds with the stack update. AWS CloudFormation doesn't wait for the index to complete creation because the backfilling phase can take a long time, depending on the size of the table. You can't use the index or update the table until the index's status is ``ACTIVE`` . You can track its status by using the DynamoDB `DescribeTable <https://docs.aws.amazon.com/cli/latest/reference/dynamodb/describe-table.html>`_ command. If you add or delete an index 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 index, you must manually delete the index. Updates are not supported. The following are exceptions: - If you update either the contributor insights specification or the provisioned throughput values of global secondary indexes, you can update the table without interruption. - You can delete or add one global secondary index without interruption. If you do both in the same update (for example, by changing the index's logical ID), the update fails.
7112
- :param import_source_specification: Specifies the properties of data being imported from the S3 bucket source to the table. .. epigraph:: If you specify the ``ImportSourceSpecification`` property, and also specify either the ``StreamSpecification`` , the ``TableClass`` property, or the ``DeletionProtectionEnabled`` property, the IAM entity creating/updating stack must have ``UpdateTable`` permission.
7133
+ :param import_source_specification: Specifies the properties of data being imported from the S3 bucket source to the" table. .. epigraph:: If you specify the ``ImportSourceSpecification`` property, and also specify either the ``StreamSpecification`` , the ``TableClass`` property, the ``DeletionProtectionEnabled`` property, or the ``WarmThroughput`` property, the IAM entity creating/updating stack must have ``UpdateTable`` permission.
7113
7134
  :param kinesis_stream_specification: The Kinesis Data Streams configuration for the specified table.
7114
7135
  :param local_secondary_indexes: Local secondary indexes to be created on the table. You can create up to 5 local secondary indexes. Each index is scoped to a given hash key value. The size of each hash key can be up to 10 gigabytes.
7115
7136
  :param on_demand_throughput: Sets the maximum number of read and write units for the specified on-demand table. If you use this property, you must specify ``MaxReadRequestUnits`` , ``MaxWriteRequestUnits`` , or both.
@@ -7122,7 +7143,7 @@ class CfnTableProps:
7122
7143
  :param table_name: A name for the table. If you don't specify a name, AWS CloudFormation generates a unique physical ID and uses that ID for the table name. For more information, see `Name Type <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-name.html>`_ . .. epigraph:: If you specify a name, you cannot perform updates that require replacement of this resource. You can perform updates that require no or some interruption. If you must replace the resource, specify a new name.
7123
7144
  :param tags: An array of key-value pairs to apply to this resource. For more information, see `Tag <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-resource-tags.html>`_ .
7124
7145
  :param time_to_live_specification: Specifies the Time to Live (TTL) settings for the table. .. epigraph:: For detailed information about the limits in DynamoDB, see `Limits in Amazon DynamoDB <https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Limits.html>`_ in the Amazon DynamoDB Developer Guide.
7125
- :param warm_throughput:
7146
+ :param warm_throughput: Represents the warm throughput (in read units per second and write units per second) for creating a table.
7126
7147
 
7127
7148
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-table.html
7128
7149
  :exampleMetadata: fixture=_generated
@@ -7421,11 +7442,11 @@ class CfnTableProps:
7421
7442
  def import_source_specification(
7422
7443
  self,
7423
7444
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnTable.ImportSourceSpecificationProperty]]:
7424
- '''Specifies the properties of data being imported from the S3 bucket source to the table.
7445
+ '''Specifies the properties of data being imported from the S3 bucket source to the" table.
7425
7446
 
7426
7447
  .. epigraph::
7427
7448
 
7428
- If you specify the ``ImportSourceSpecification`` property, and also specify either the ``StreamSpecification`` , the ``TableClass`` property, or the ``DeletionProtectionEnabled`` property, the IAM entity creating/updating stack must have ``UpdateTable`` permission.
7449
+ If you specify the ``ImportSourceSpecification`` property, and also specify either the ``StreamSpecification`` , the ``TableClass`` property, the ``DeletionProtectionEnabled`` property, or the ``WarmThroughput`` property, the IAM entity creating/updating stack must have ``UpdateTable`` permission.
7429
7450
 
7430
7451
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-table.html#cfn-dynamodb-table-importsourcespecification
7431
7452
  '''
@@ -7587,7 +7608,8 @@ class CfnTableProps:
7587
7608
  def warm_throughput(
7588
7609
  self,
7589
7610
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnTable.WarmThroughputProperty]]:
7590
- '''
7611
+ '''Represents the warm throughput (in read units per second and write units per second) for creating a table.
7612
+
7591
7613
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-table.html#cfn-dynamodb-table-warmthroughput
7592
7614
  '''
7593
7615
  result = self._values.get("warm_throughput")
@@ -39718,7 +39718,7 @@ class CfnPrefixList(
39718
39718
  :param address_family: The IP address type. Valid Values: ``IPv4`` | ``IPv6``
39719
39719
  :param prefix_list_name: A name for the prefix list. Constraints: Up to 255 characters in length. The name cannot start with ``com.amazonaws`` .
39720
39720
  :param entries: The entries for the prefix list.
39721
- :param max_entries: The maximum number of entries for the prefix list.
39721
+ :param max_entries: The maximum number of entries for the prefix list. You can't modify the entries and the size of a prefix list at the same time. This property is required when you create a prefix list.
39722
39722
  :param tags: The tags for the prefix list.
39723
39723
  '''
39724
39724
  if __debug__:
@@ -39992,7 +39992,7 @@ class CfnPrefixListProps:
39992
39992
  :param address_family: The IP address type. Valid Values: ``IPv4`` | ``IPv6``
39993
39993
  :param prefix_list_name: A name for the prefix list. Constraints: Up to 255 characters in length. The name cannot start with ``com.amazonaws`` .
39994
39994
  :param entries: The entries for the prefix list.
39995
- :param max_entries: The maximum number of entries for the prefix list.
39995
+ :param max_entries: The maximum number of entries for the prefix list. You can't modify the entries and the size of a prefix list at the same time. This property is required when you create a prefix list.
39996
39996
  :param tags: The tags for the prefix list.
39997
39997
 
39998
39998
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-prefixlist.html
@@ -40079,6 +40079,10 @@ class CfnPrefixListProps:
40079
40079
  def max_entries(self) -> typing.Optional[jsii.Number]:
40080
40080
  '''The maximum number of entries for the prefix list.
40081
40081
 
40082
+ You can't modify the entries and the size of a prefix list at the same time.
40083
+
40084
+ This property is required when you create a prefix list.
40085
+
40082
40086
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-prefixlist.html#cfn-ec2-prefixlist-maxentries
40083
40087
  '''
40084
40088
  result = self._values.get("max_entries")
@@ -8337,7 +8337,7 @@ class CfnService(
8337
8337
  :param desired_count: The number of instantiations of the specified task definition to place and keep running in your service. For new services, if a desired count is not specified, a default value of ``1`` is used. When using the ``DAEMON`` scheduling strategy, the desired count is not required. For existing services, if a desired count is not specified, it is omitted from the operation.
8338
8338
  :param enable_ecs_managed_tags: Specifies whether to turn on Amazon ECS managed tags for the tasks within the service. For more information, see `Tagging your Amazon ECS resources <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html>`_ in the *Amazon Elastic Container Service Developer Guide* . When you use Amazon ECS managed tags, you need to set the ``propagateTags`` request parameter.
8339
8339
  :param enable_execute_command: Determines whether the execute command functionality is turned on for the service. If ``true`` , the execute command functionality is turned on for all containers in tasks as part of the service.
8340
- :param health_check_grace_period_seconds: The period of time, in seconds, that the Amazon ECS service scheduler ignores unhealthy Elastic Load Balancing target health checks after a task has first started. This is only used when your service is configured to use a load balancer. If your service has a load balancer defined and you don't specify a health check grace period value, the default value of ``0`` is used. If you do not use an Elastic Load Balancing, we recommend that you use the ``startPeriod`` in the task definition health check parameters. For more information, see `Health check <https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_HealthCheck.html>`_ . If your service's tasks take a while to start and respond to Elastic Load Balancing health checks, you can specify a health check grace period of up to 2,147,483,647 seconds (about 69 years). During that time, the Amazon ECS service scheduler ignores health check status. This grace period can prevent the service scheduler from marking tasks as unhealthy and stopping them before they have time to come up.
8340
+ :param health_check_grace_period_seconds: The period of time, in seconds, that the Amazon ECS service scheduler ignores unhealthy Elastic Load Balancing, VPC Lattice, and container health checks after a task has first started. If you don't specify a health check grace period value, the default value of ``0`` is used. If you don't use any of the health checks, then ``healthCheckGracePeriodSeconds`` is unused. If your service's tasks take a while to start and respond to health checks, you can specify a health check grace period of up to 2,147,483,647 seconds (about 69 years). During that time, the Amazon ECS service scheduler ignores health check status. This grace period can prevent the service scheduler from marking tasks as unhealthy and stopping them before they have time to come up.
8341
8341
  :param launch_type: The launch type on which to run your service. For more information, see `Amazon ECS Launch Types <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_types.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
8342
8342
  :param load_balancers: A list of load balancer objects to associate with the service. If you specify the ``Role`` property, ``LoadBalancers`` must be specified as well. For information about the number of load balancers that you can specify per service, see `Service Load Balancing <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-load-balancing.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
8343
8343
  :param network_configuration: The network configuration for the service. This parameter is required for task definitions that use the ``awsvpc`` network mode to receive their own elastic network interface, and it is not supported for other network modes. For more information, see `Task Networking <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-networking.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
@@ -8353,7 +8353,7 @@ class CfnService(
8353
8353
  :param tags: The metadata that you apply to the service to help you categorize and organize them. Each tag consists of a key and an optional value, both of which you define. When a service is deleted, the tags are deleted as well. The following basic restrictions apply to tags: - Maximum number of tags per resource - 50 - For each resource, each tag key must be unique, and each tag key can have only one value. - Maximum key length - 128 Unicode characters in UTF-8 - Maximum value length - 256 Unicode characters in UTF-8 - If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : /
8354
8354
  :param task_definition: The ``family`` and ``revision`` ( ``family:revision`` ) or full ARN of the task definition to run in your service. If a ``revision`` isn't specified, the latest ``ACTIVE`` revision is used. A task definition must be specified if the service uses either the ``ECS`` or ``CODE_DEPLOY`` deployment controllers. For more information about deployment types, see `Amazon ECS deployment types <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html>`_ .
8355
8355
  :param volume_configurations: The configuration for a volume specified in the task definition as a volume that is configured at launch time. Currently, the only supported volume type is an Amazon EBS volume.
8356
- :param vpc_lattice_configurations:
8356
+ :param vpc_lattice_configurations: The VPC Lattice configuration for the service being created.
8357
8357
  '''
8358
8358
  if __debug__:
8359
8359
  type_hints = typing.get_type_hints(_typecheckingstub__ec1192a1d20e03deef75c7fa1457b92ecf9506c5c5df97b5a4473fc3a9a714ef)
@@ -8582,7 +8582,7 @@ class CfnService(
8582
8582
  @builtins.property
8583
8583
  @jsii.member(jsii_name="healthCheckGracePeriodSeconds")
8584
8584
  def health_check_grace_period_seconds(self) -> typing.Optional[jsii.Number]:
8585
- '''The period of time, in seconds, that the Amazon ECS service scheduler ignores unhealthy Elastic Load Balancing target health checks after a task has first started.'''
8585
+ '''The period of time, in seconds, that the Amazon ECS service scheduler ignores unhealthy Elastic Load Balancing, VPC Lattice, and container health checks after a task has first started.'''
8586
8586
  return typing.cast(typing.Optional[jsii.Number], jsii.get(self, "healthCheckGracePeriodSeconds"))
8587
8587
 
8588
8588
  @health_check_grace_period_seconds.setter
@@ -8836,6 +8836,7 @@ class CfnService(
8836
8836
  def vpc_lattice_configurations(
8837
8837
  self,
8838
8838
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnService.VpcLatticeConfigurationProperty"]]]]:
8839
+ '''The VPC Lattice configuration for the service being created.'''
8839
8840
  return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnService.VpcLatticeConfigurationProperty"]]]], jsii.get(self, "vpcLatticeConfigurations"))
8840
8841
 
8841
8842
  @vpc_lattice_configurations.setter
@@ -11378,10 +11379,11 @@ class CfnService(
11378
11379
  role_arn: builtins.str,
11379
11380
  target_group_arn: builtins.str,
11380
11381
  ) -> None:
11381
- '''
11382
- :param port_name:
11383
- :param role_arn:
11384
- :param target_group_arn:
11382
+ '''The VPC Lattice configuration for your service that holds the information for the target group(s) Amazon ECS tasks will be registered to.
11383
+
11384
+ :param port_name: The name of the port mapping to register in the VPC Lattice target group. This is the name of the ``portMapping`` you defined in your task definition.
11385
+ :param role_arn: The ARN of the IAM role to associate with this VPC Lattice configuration. This is the Amazon ECS infrastructure IAM role that is used to manage your VPC Lattice infrastructure.
11386
+ :param target_group_arn: The full Amazon Resource Name (ARN) of the target group or groups associated with the VPC Lattice configuration that the Amazon ECS tasks will be registered to.
11385
11387
 
11386
11388
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-service-vpclatticeconfiguration.html
11387
11389
  :exampleMetadata: fixture=_generated
@@ -11411,7 +11413,10 @@ class CfnService(
11411
11413
 
11412
11414
  @builtins.property
11413
11415
  def port_name(self) -> builtins.str:
11414
- '''
11416
+ '''The name of the port mapping to register in the VPC Lattice target group.
11417
+
11418
+ This is the name of the ``portMapping`` you defined in your task definition.
11419
+
11415
11420
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-service-vpclatticeconfiguration.html#cfn-ecs-service-vpclatticeconfiguration-portname
11416
11421
  '''
11417
11422
  result = self._values.get("port_name")
@@ -11420,7 +11425,10 @@ class CfnService(
11420
11425
 
11421
11426
  @builtins.property
11422
11427
  def role_arn(self) -> builtins.str:
11423
- '''
11428
+ '''The ARN of the IAM role to associate with this VPC Lattice configuration.
11429
+
11430
+ This is the Amazon ECS infrastructure IAM role that is used to manage your VPC Lattice infrastructure.
11431
+
11424
11432
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-service-vpclatticeconfiguration.html#cfn-ecs-service-vpclatticeconfiguration-rolearn
11425
11433
  '''
11426
11434
  result = self._values.get("role_arn")
@@ -11429,7 +11437,8 @@ class CfnService(
11429
11437
 
11430
11438
  @builtins.property
11431
11439
  def target_group_arn(self) -> builtins.str:
11432
- '''
11440
+ '''The full Amazon Resource Name (ARN) of the target group or groups associated with the VPC Lattice configuration that the Amazon ECS tasks will be registered to.
11441
+
11433
11442
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-service-vpclatticeconfiguration.html#cfn-ecs-service-vpclatticeconfiguration-targetgrouparn
11434
11443
  '''
11435
11444
  result = self._values.get("target_group_arn")
@@ -11519,7 +11528,7 @@ class CfnServiceProps:
11519
11528
  :param desired_count: The number of instantiations of the specified task definition to place and keep running in your service. For new services, if a desired count is not specified, a default value of ``1`` is used. When using the ``DAEMON`` scheduling strategy, the desired count is not required. For existing services, if a desired count is not specified, it is omitted from the operation.
11520
11529
  :param enable_ecs_managed_tags: Specifies whether to turn on Amazon ECS managed tags for the tasks within the service. For more information, see `Tagging your Amazon ECS resources <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html>`_ in the *Amazon Elastic Container Service Developer Guide* . When you use Amazon ECS managed tags, you need to set the ``propagateTags`` request parameter.
11521
11530
  :param enable_execute_command: Determines whether the execute command functionality is turned on for the service. If ``true`` , the execute command functionality is turned on for all containers in tasks as part of the service.
11522
- :param health_check_grace_period_seconds: The period of time, in seconds, that the Amazon ECS service scheduler ignores unhealthy Elastic Load Balancing target health checks after a task has first started. This is only used when your service is configured to use a load balancer. If your service has a load balancer defined and you don't specify a health check grace period value, the default value of ``0`` is used. If you do not use an Elastic Load Balancing, we recommend that you use the ``startPeriod`` in the task definition health check parameters. For more information, see `Health check <https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_HealthCheck.html>`_ . If your service's tasks take a while to start and respond to Elastic Load Balancing health checks, you can specify a health check grace period of up to 2,147,483,647 seconds (about 69 years). During that time, the Amazon ECS service scheduler ignores health check status. This grace period can prevent the service scheduler from marking tasks as unhealthy and stopping them before they have time to come up.
11531
+ :param health_check_grace_period_seconds: The period of time, in seconds, that the Amazon ECS service scheduler ignores unhealthy Elastic Load Balancing, VPC Lattice, and container health checks after a task has first started. If you don't specify a health check grace period value, the default value of ``0`` is used. If you don't use any of the health checks, then ``healthCheckGracePeriodSeconds`` is unused. If your service's tasks take a while to start and respond to health checks, you can specify a health check grace period of up to 2,147,483,647 seconds (about 69 years). During that time, the Amazon ECS service scheduler ignores health check status. This grace period can prevent the service scheduler from marking tasks as unhealthy and stopping them before they have time to come up.
11523
11532
  :param launch_type: The launch type on which to run your service. For more information, see `Amazon ECS Launch Types <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_types.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
11524
11533
  :param load_balancers: A list of load balancer objects to associate with the service. If you specify the ``Role`` property, ``LoadBalancers`` must be specified as well. For information about the number of load balancers that you can specify per service, see `Service Load Balancing <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-load-balancing.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
11525
11534
  :param network_configuration: The network configuration for the service. This parameter is required for task definitions that use the ``awsvpc`` network mode to receive their own elastic network interface, and it is not supported for other network modes. For more information, see `Task Networking <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-networking.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
@@ -11535,7 +11544,7 @@ class CfnServiceProps:
11535
11544
  :param tags: The metadata that you apply to the service to help you categorize and organize them. Each tag consists of a key and an optional value, both of which you define. When a service is deleted, the tags are deleted as well. The following basic restrictions apply to tags: - Maximum number of tags per resource - 50 - For each resource, each tag key must be unique, and each tag key can have only one value. - Maximum key length - 128 Unicode characters in UTF-8 - Maximum value length - 256 Unicode characters in UTF-8 - If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : /
11536
11545
  :param task_definition: The ``family`` and ``revision`` ( ``family:revision`` ) or full ARN of the task definition to run in your service. If a ``revision`` isn't specified, the latest ``ACTIVE`` revision is used. A task definition must be specified if the service uses either the ``ECS`` or ``CODE_DEPLOY`` deployment controllers. For more information about deployment types, see `Amazon ECS deployment types <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html>`_ .
11537
11546
  :param volume_configurations: The configuration for a volume specified in the task definition as a volume that is configured at launch time. Currently, the only supported volume type is an Amazon EBS volume.
11538
- :param vpc_lattice_configurations:
11547
+ :param vpc_lattice_configurations: The VPC Lattice configuration for the service being created.
11539
11548
 
11540
11549
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ecs-service.html
11541
11550
  :exampleMetadata: fixture=_generated
@@ -11875,13 +11884,11 @@ class CfnServiceProps:
11875
11884
 
11876
11885
  @builtins.property
11877
11886
  def health_check_grace_period_seconds(self) -> typing.Optional[jsii.Number]:
11878
- '''The period of time, in seconds, that the Amazon ECS service scheduler ignores unhealthy Elastic Load Balancing target health checks after a task has first started.
11879
-
11880
- This is only used when your service is configured to use a load balancer. If your service has a load balancer defined and you don't specify a health check grace period value, the default value of ``0`` is used.
11887
+ '''The period of time, in seconds, that the Amazon ECS service scheduler ignores unhealthy Elastic Load Balancing, VPC Lattice, and container health checks after a task has first started.
11881
11888
 
11882
- If you do not use an Elastic Load Balancing, we recommend that you use the ``startPeriod`` in the task definition health check parameters. For more information, see `Health check <https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_HealthCheck.html>`_ .
11889
+ If you don't specify a health check grace period value, the default value of ``0`` is used. If you don't use any of the health checks, then ``healthCheckGracePeriodSeconds`` is unused.
11883
11890
 
11884
- If your service's tasks take a while to start and respond to Elastic Load Balancing health checks, you can specify a health check grace period of up to 2,147,483,647 seconds (about 69 years). During that time, the Amazon ECS service scheduler ignores health check status. This grace period can prevent the service scheduler from marking tasks as unhealthy and stopping them before they have time to come up.
11891
+ If your service's tasks take a while to start and respond to health checks, you can specify a health check grace period of up to 2,147,483,647 seconds (about 69 years). During that time, the Amazon ECS service scheduler ignores health check status. This grace period can prevent the service scheduler from marking tasks as unhealthy and stopping them before they have time to come up.
11885
11892
 
11886
11893
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ecs-service.html#cfn-ecs-service-healthcheckgraceperiodseconds
11887
11894
  '''
@@ -12112,7 +12119,8 @@ class CfnServiceProps:
12112
12119
  def vpc_lattice_configurations(
12113
12120
  self,
12114
12121
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, CfnService.VpcLatticeConfigurationProperty]]]]:
12115
- '''
12122
+ '''The VPC Lattice configuration for the service being created.
12123
+
12116
12124
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ecs-service.html#cfn-ecs-service-vpclatticeconfigurations
12117
12125
  '''
12118
12126
  result = self._values.get("vpc_lattice_configurations")
@@ -15863,7 +15871,7 @@ class CfnTaskDefinition(
15863
15871
  :param container_port: The port number on the container that's bound to the user-specified or automatically assigned host port. If you use containers in a task with the ``awsvpc`` or ``host`` network mode, specify the exposed ports using ``containerPort`` . If you use containers in a task with the ``bridge`` network mode and you specify a container port and not a host port, your container automatically receives a host port in the ephemeral port range. For more information, see ``hostPort`` . Port mappings that are automatically assigned in this way do not count toward the 100 reserved ports limit of a container instance.
15864
15872
  :param container_port_range: The port number range on the container that's bound to the dynamically mapped host port range. The following rules apply when you specify a ``containerPortRange`` : - You must use either the ``bridge`` network mode or the ``awsvpc`` network mode. - This parameter is available for both the EC2 and AWS Fargate launch types. - This parameter is available for both the Linux and Windows operating systems. - The container instance must have at least version 1.67.0 of the container agent and at least version 1.67.0-1 of the ``ecs-init`` package - You can specify a maximum of 100 port ranges per container. - You do not specify a ``hostPortRange`` . The value of the ``hostPortRange`` is set as follows: - For containers in a task with the ``awsvpc`` network mode, the ``hostPortRange`` is set to the same value as the ``containerPortRange`` . This is a static mapping strategy. - For containers in a task with the ``bridge`` network mode, the Amazon ECS agent finds open host ports from the default ephemeral range and passes it to docker to bind them to the container ports. - The ``containerPortRange`` valid values are between 1 and 65535. - A port can only be included in one port mapping per container. - You cannot specify overlapping port ranges. - The first port in the range must be less than last port in the range. - Docker recommends that you turn off the docker-proxy in the Docker daemon config file when you have a large number of ports. For more information, see `Issue #11185 <https://docs.aws.amazon.com/https://github.com/moby/moby/issues/11185>`_ on the Github website. For information about how to turn off the docker-proxy in the Docker daemon config file, see `Docker daemon <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/bootstrap_container_instance.html#bootstrap_docker_daemon>`_ in the *Amazon ECS Developer Guide* . You can call ```DescribeTasks`` <https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_DescribeTasks.html>`_ to view the ``hostPortRange`` which are the host ports that are bound to the container ports.
15865
15873
  :param host_port: The port number on the container instance to reserve for your container. If you specify a ``containerPortRange`` , leave this field empty and the value of the ``hostPort`` is set as follows: - For containers in a task with the ``awsvpc`` network mode, the ``hostPort`` is set to the same value as the ``containerPort`` . This is a static mapping strategy. - For containers in a task with the ``bridge`` network mode, the Amazon ECS agent finds open ports on the host and automatically binds them to the container ports. This is a dynamic mapping strategy. If you use containers in a task with the ``awsvpc`` or ``host`` network mode, the ``hostPort`` can either be left blank or set to the same value as the ``containerPort`` . If you use containers in a task with the ``bridge`` network mode, you can specify a non-reserved host port for your container port mapping, or you can omit the ``hostPort`` (or set it to ``0`` ) while specifying a ``containerPort`` and your container automatically receives a port in the ephemeral port range for your container instance operating system and Docker version. The default ephemeral port range for Docker version 1.6.0 and later is listed on the instance under ``/proc/sys/net/ipv4/ip_local_port_range`` . If this kernel parameter is unavailable, the default ephemeral port range from 49153 through 65535 (Linux) or 49152 through 65535 (Windows) is used. Do not attempt to specify a host port in the ephemeral port range as these are reserved for automatic assignment. In general, ports below 32768 are outside of the ephemeral port range. The default reserved ports are 22 for SSH, the Docker ports 2375 and 2376, and the Amazon ECS container agent ports 51678-51680. Any host port that was previously specified in a running task is also reserved while the task is running. That is, after a task stops, the host port is released. The current reserved ports are displayed in the ``remainingResources`` of `DescribeContainerInstances <https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_DescribeContainerInstances.html>`_ output. A container instance can have up to 100 reserved ports at a time. This number includes the default reserved ports. Automatically assigned ports aren't included in the 100 reserved ports quota.
15866
- :param name: The name that's used for the port mapping. This parameter only applies to Service Connect. This parameter is the name that you use in the ``serviceConnectConfiguration`` of a service. The name can include up to 64 characters. The characters can include lowercase letters, numbers, underscores (_), and hyphens (-). The name can't start with a hyphen. For more information, see `Service Connect <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
15874
+ :param name: The name that's used for the port mapping. This parameter is the name that you use in the ``serviceConnectConfiguration`` and the ``vpcLatticeConfigurations`` of a service. The name can include up to 64 characters. The characters can include lowercase letters, numbers, underscores (_), and hyphens (-). The name can't start with a hyphen.
15867
15875
  :param protocol: The protocol used for the port mapping. Valid values are ``tcp`` and ``udp`` . The default is ``tcp`` . ``protocol`` is immutable in a Service Connect service. Updating this field requires a service deletion and redeployment.
15868
15876
 
15869
15877
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-taskdefinition-portmapping.html
@@ -15993,9 +16001,7 @@ class CfnTaskDefinition(
15993
16001
  def name(self) -> typing.Optional[builtins.str]:
15994
16002
  '''The name that's used for the port mapping.
15995
16003
 
15996
- This parameter only applies to Service Connect. This parameter is the name that you use in the ``serviceConnectConfiguration`` of a service. The name can include up to 64 characters. The characters can include lowercase letters, numbers, underscores (_), and hyphens (-). The name can't start with a hyphen.
15997
-
15998
- For more information, see `Service Connect <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
16004
+ This parameter is the name that you use in the ``serviceConnectConfiguration`` and the ``vpcLatticeConfigurations`` of a service. The name can include up to 64 characters. The characters can include lowercase letters, numbers, underscores (_), and hyphens (-). The name can't start with a hyphen.
15999
16005
 
16000
16006
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-taskdefinition-portmapping.html#cfn-ecs-taskdefinition-portmapping-name
16001
16007
  '''
@@ -1592,7 +1592,10 @@ class CfnFileSystem(
1592
1592
  availability_zone_name="availabilityZoneName",
1593
1593
  file_system_id="fileSystemId",
1594
1594
  kms_key_id="kmsKeyId",
1595
- region="region"
1595
+ region="region",
1596
+ role_arn="roleArn",
1597
+ status="status",
1598
+ status_message="statusMessage"
1596
1599
  )]
1597
1600
  ),
1598
1601
  throughput_mode="throughputMode"
@@ -2245,7 +2248,10 @@ class CfnFileSystem(
2245
2248
  availability_zone_name="availabilityZoneName",
2246
2249
  file_system_id="fileSystemId",
2247
2250
  kms_key_id="kmsKeyId",
2248
- region="region"
2251
+ region="region",
2252
+ role_arn="roleArn",
2253
+ status="status",
2254
+ status_message="statusMessage"
2249
2255
  )]
2250
2256
  )
2251
2257
  '''
@@ -2288,6 +2294,9 @@ class CfnFileSystem(
2288
2294
  "file_system_id": "fileSystemId",
2289
2295
  "kms_key_id": "kmsKeyId",
2290
2296
  "region": "region",
2297
+ "role_arn": "roleArn",
2298
+ "status": "status",
2299
+ "status_message": "statusMessage",
2291
2300
  },
2292
2301
  )
2293
2302
  class ReplicationDestinationProperty:
@@ -2298,6 +2307,9 @@ class CfnFileSystem(
2298
2307
  file_system_id: typing.Optional[builtins.str] = None,
2299
2308
  kms_key_id: typing.Optional[builtins.str] = None,
2300
2309
  region: typing.Optional[builtins.str] = None,
2310
+ role_arn: typing.Optional[builtins.str] = None,
2311
+ status: typing.Optional[builtins.str] = None,
2312
+ status_message: typing.Optional[builtins.str] = None,
2301
2313
  ) -> None:
2302
2314
  '''Describes the destination file system in the replication configuration.
2303
2315
 
@@ -2305,6 +2317,9 @@ class CfnFileSystem(
2305
2317
  :param file_system_id: The ID of the destination Amazon EFS file system.
2306
2318
  :param kms_key_id: The ID of an AWS KMS key used to protect the encrypted file system.
2307
2319
  :param region: The AWS Region in which the destination file system is located. .. epigraph:: For One Zone file systems, the replication configuration must specify the AWS Region in which the destination file system is located.
2320
+ :param role_arn:
2321
+ :param status:
2322
+ :param status_message:
2308
2323
 
2309
2324
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-efs-filesystem-replicationdestination.html
2310
2325
  :exampleMetadata: fixture=_generated
@@ -2319,7 +2334,10 @@ class CfnFileSystem(
2319
2334
  availability_zone_name="availabilityZoneName",
2320
2335
  file_system_id="fileSystemId",
2321
2336
  kms_key_id="kmsKeyId",
2322
- region="region"
2337
+ region="region",
2338
+ role_arn="roleArn",
2339
+ status="status",
2340
+ status_message="statusMessage"
2323
2341
  )
2324
2342
  '''
2325
2343
  if __debug__:
@@ -2328,6 +2346,9 @@ class CfnFileSystem(
2328
2346
  check_type(argname="argument file_system_id", value=file_system_id, expected_type=type_hints["file_system_id"])
2329
2347
  check_type(argname="argument kms_key_id", value=kms_key_id, expected_type=type_hints["kms_key_id"])
2330
2348
  check_type(argname="argument region", value=region, expected_type=type_hints["region"])
2349
+ check_type(argname="argument role_arn", value=role_arn, expected_type=type_hints["role_arn"])
2350
+ check_type(argname="argument status", value=status, expected_type=type_hints["status"])
2351
+ check_type(argname="argument status_message", value=status_message, expected_type=type_hints["status_message"])
2331
2352
  self._values: typing.Dict[builtins.str, typing.Any] = {}
2332
2353
  if availability_zone_name is not None:
2333
2354
  self._values["availability_zone_name"] = availability_zone_name
@@ -2337,6 +2358,12 @@ class CfnFileSystem(
2337
2358
  self._values["kms_key_id"] = kms_key_id
2338
2359
  if region is not None:
2339
2360
  self._values["region"] = region
2361
+ if role_arn is not None:
2362
+ self._values["role_arn"] = role_arn
2363
+ if status is not None:
2364
+ self._values["status"] = status
2365
+ if status_message is not None:
2366
+ self._values["status_message"] = status_message
2340
2367
 
2341
2368
  @builtins.property
2342
2369
  def availability_zone_name(self) -> typing.Optional[builtins.str]:
@@ -2383,6 +2410,30 @@ class CfnFileSystem(
2383
2410
  result = self._values.get("region")
2384
2411
  return typing.cast(typing.Optional[builtins.str], result)
2385
2412
 
2413
+ @builtins.property
2414
+ def role_arn(self) -> typing.Optional[builtins.str]:
2415
+ '''
2416
+ :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-efs-filesystem-replicationdestination.html#cfn-efs-filesystem-replicationdestination-rolearn
2417
+ '''
2418
+ result = self._values.get("role_arn")
2419
+ return typing.cast(typing.Optional[builtins.str], result)
2420
+
2421
+ @builtins.property
2422
+ def status(self) -> typing.Optional[builtins.str]:
2423
+ '''
2424
+ :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-efs-filesystem-replicationdestination.html#cfn-efs-filesystem-replicationdestination-status
2425
+ '''
2426
+ result = self._values.get("status")
2427
+ return typing.cast(typing.Optional[builtins.str], result)
2428
+
2429
+ @builtins.property
2430
+ def status_message(self) -> typing.Optional[builtins.str]:
2431
+ '''
2432
+ :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-efs-filesystem-replicationdestination.html#cfn-efs-filesystem-replicationdestination-statusmessage
2433
+ '''
2434
+ result = self._values.get("status_message")
2435
+ return typing.cast(typing.Optional[builtins.str], result)
2436
+
2386
2437
  def __eq__(self, rhs: typing.Any) -> builtins.bool:
2387
2438
  return isinstance(rhs, self.__class__) and rhs._values == self._values
2388
2439
 
@@ -2487,7 +2538,10 @@ class CfnFileSystemProps:
2487
2538
  availability_zone_name="availabilityZoneName",
2488
2539
  file_system_id="fileSystemId",
2489
2540
  kms_key_id="kmsKeyId",
2490
- region="region"
2541
+ region="region",
2542
+ role_arn="roleArn",
2543
+ status="status",
2544
+ status_message="statusMessage"
2491
2545
  )]
2492
2546
  ),
2493
2547
  throughput_mode="throughputMode"
@@ -5127,6 +5181,9 @@ def _typecheckingstub__a0a6356d4030fadb2a5ab2683faf2e9b37a0259a16f5946aff9be9f29
5127
5181
  file_system_id: typing.Optional[builtins.str] = None,
5128
5182
  kms_key_id: typing.Optional[builtins.str] = None,
5129
5183
  region: typing.Optional[builtins.str] = None,
5184
+ role_arn: typing.Optional[builtins.str] = None,
5185
+ status: typing.Optional[builtins.str] = None,
5186
+ status_message: typing.Optional[builtins.str] = None,
5130
5187
  ) -> None:
5131
5188
  """Type checking stubs"""
5132
5189
  pass