aws-cdk-lib 2.154.0__py3-none-any.whl → 2.154.1__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.

Potentially problematic release.


This version of aws-cdk-lib might be problematic. Click here for more details.

@@ -118,6 +118,16 @@ cloudfront.Distribution(self, "myDist",
118
118
  )
119
119
  ```
120
120
 
121
+ #### Moving an alternate domain name to a different distribution
122
+
123
+ When you try to add an alternate domain name to a distribution but the alternate domain name is already in use on a different distribution, you get a `CNAMEAlreadyExists` error (One or more of the CNAMEs you provided are already associated with a different resource).
124
+
125
+ In that case, you might want to move the existing alternate domain name from one distribution (the source distribution) to another (the target distribution). The following steps are an overview of the process. For more information, see [Moving an alternate domain name to a different distribution](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/alternate-domain-names-move.html).
126
+
127
+ 1. Deploy the stack with the target distribution. The `certificate` property must be specified but the `domainNames` should be absent.
128
+ 2. Move the alternate domain name by running CloudFront `associate-alias` command. For the example and preconditions, see the AWS documentation above.
129
+ 3. Specify the `domainNames` property with the alternative domain name, then deploy the stack again to resolve the drift at the alternative domain name.
130
+
121
131
  #### Cross Region Certificates
122
132
 
123
133
  > **This feature is currently experimental**
@@ -15677,7 +15687,7 @@ class DistributionProps:
15677
15687
  :param certificate: A certificate to associate with the distribution. The certificate must be located in N. Virginia (us-east-1). Default: - the CloudFront wildcard certificate (*.cloudfront.net) will be used.
15678
15688
  :param comment: Any comments you want to include about the distribution. Default: - no comment
15679
15689
  :param default_root_object: The object that you want CloudFront to request from your origin (for example, index.html) when a viewer requests the root URL for your distribution. If no default object is set, the request goes to the origin's root (e.g., example.com/). Default: - no default root object
15680
- :param domain_names: Alternative domain names for this distribution. If you want to use your own domain name, such as www.example.com, instead of the cloudfront.net domain name, you can add an alternate domain name to your distribution. If you attach a certificate to the distribution, you must add (at least one of) the domain names of the certificate to this list. Default: - The distribution will only support the default generated name (e.g., d111111abcdef8.cloudfront.net)
15690
+ :param domain_names: Alternative domain names for this distribution. If you want to use your own domain name, such as www.example.com, instead of the cloudfront.net domain name, you can add an alternate domain name to your distribution. If you attach a certificate to the distribution, you should add (at least one of) the domain names of the certificate to this list. When you want to move a domain name between distributions, you can associate a certificate without specifying any domain names. For more information, see the *Moving an alternate domain name to a different distribution* section in the README. Default: - The distribution will only support the default generated name (e.g., d111111abcdef8.cloudfront.net)
15681
15691
  :param enabled: Enable or disable the distribution. Default: true
15682
15692
  :param enable_ipv6: Whether CloudFront will respond to IPv6 DNS requests with an IPv6 address. 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. Default: true
15683
15693
  :param enable_logging: Enable access logging for the distribution. Default: - false, unless ``logBucket`` is specified.
@@ -15833,7 +15843,10 @@ class DistributionProps:
15833
15843
 
15834
15844
  If you want to use your own domain name, such as www.example.com, instead of the cloudfront.net domain name,
15835
15845
  you can add an alternate domain name to your distribution. If you attach a certificate to the distribution,
15836
- you must add (at least one of) the domain names of the certificate to this list.
15846
+ you should add (at least one of) the domain names of the certificate to this list.
15847
+
15848
+ When you want to move a domain name between distributions, you can associate a certificate without specifying any domain names.
15849
+ For more information, see the *Moving an alternate domain name to a different distribution* section in the README.
15837
15850
 
15838
15851
  :default: - The distribution will only support the default generated name (e.g., d111111abcdef8.cloudfront.net)
15839
15852
  '''
@@ -23044,7 +23057,7 @@ class Distribution(
23044
23057
  :param certificate: A certificate to associate with the distribution. The certificate must be located in N. Virginia (us-east-1). Default: - the CloudFront wildcard certificate (*.cloudfront.net) will be used.
23045
23058
  :param comment: Any comments you want to include about the distribution. Default: - no comment
23046
23059
  :param default_root_object: The object that you want CloudFront to request from your origin (for example, index.html) when a viewer requests the root URL for your distribution. If no default object is set, the request goes to the origin's root (e.g., example.com/). Default: - no default root object
23047
- :param domain_names: Alternative domain names for this distribution. If you want to use your own domain name, such as www.example.com, instead of the cloudfront.net domain name, you can add an alternate domain name to your distribution. If you attach a certificate to the distribution, you must add (at least one of) the domain names of the certificate to this list. Default: - The distribution will only support the default generated name (e.g., d111111abcdef8.cloudfront.net)
23060
+ :param domain_names: Alternative domain names for this distribution. If you want to use your own domain name, such as www.example.com, instead of the cloudfront.net domain name, you can add an alternate domain name to your distribution. If you attach a certificate to the distribution, you should add (at least one of) the domain names of the certificate to this list. When you want to move a domain name between distributions, you can associate a certificate without specifying any domain names. For more information, see the *Moving an alternate domain name to a different distribution* section in the README. Default: - The distribution will only support the default generated name (e.g., d111111abcdef8.cloudfront.net)
23048
23061
  :param enabled: Enable or disable the distribution. Default: true
23049
23062
  :param enable_ipv6: Whether CloudFront will respond to IPv6 DNS requests with an IPv6 address. 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. Default: true
23050
23063
  :param enable_logging: Enable access logging for the distribution. Default: - false, unless ``logBucket`` is specified.
@@ -2129,6 +2129,7 @@ class CfnFleet(
2129
2129
  subnets=["subnets"],
2130
2130
  vpc_id="vpcId"
2131
2131
  ),
2132
+ image_id="imageId",
2132
2133
  name="name",
2133
2134
  overflow_behavior="overflowBehavior",
2134
2135
  tags=[CfnTag(
@@ -2148,6 +2149,7 @@ class CfnFleet(
2148
2149
  environment_type: typing.Optional[builtins.str] = None,
2149
2150
  fleet_service_role: typing.Optional[builtins.str] = None,
2150
2151
  fleet_vpc_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnFleet.VpcConfigProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
2152
+ image_id: typing.Optional[builtins.str] = None,
2151
2153
  name: typing.Optional[builtins.str] = None,
2152
2154
  overflow_behavior: typing.Optional[builtins.str] = None,
2153
2155
  tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
@@ -2160,6 +2162,7 @@ class CfnFleet(
2160
2162
  :param environment_type: The environment type of the compute fleet. - The environment type ``ARM_CONTAINER`` is available only in regions US East (N. Virginia), US East (Ohio), US West (Oregon), EU (Ireland), Asia Pacific (Mumbai), Asia Pacific (Tokyo), Asia Pacific (Singapore), Asia Pacific (Sydney), EU (Frankfurt), and South America (São Paulo). - The environment type ``LINUX_CONTAINER`` is available only in regions US East (N. Virginia), US East (Ohio), US West (Oregon), EU (Ireland), EU (Frankfurt), Asia Pacific (Tokyo), Asia Pacific (Singapore), Asia Pacific (Sydney), South America (São Paulo), and Asia Pacific (Mumbai). - The environment type ``LINUX_GPU_CONTAINER`` is available only in regions US East (N. Virginia), US East (Ohio), US West (Oregon), EU (Ireland), EU (Frankfurt), Asia Pacific (Tokyo), and Asia Pacific (Sydney). - The environment type ``WINDOWS_SERVER_2019_CONTAINER`` is available only in regions US East (N. Virginia), US East (Ohio), US West (Oregon), Asia Pacific (Sydney), Asia Pacific (Tokyo), Asia Pacific (Mumbai) and EU (Ireland). - The environment type ``WINDOWS_SERVER_2022_CONTAINER`` is available only in regions US East (N. Virginia), US East (Ohio), US West (Oregon), EU (Ireland), EU (Frankfurt), Asia Pacific (Sydney), Asia Pacific (Singapore), Asia Pacific (Tokyo), South America (São Paulo) and Asia Pacific (Mumbai). For more information, see `Build environment compute types <https://docs.aws.amazon.com//codebuild/latest/userguide/build-env-ref-compute-types.html>`_ in the *AWS CodeBuild user guide* .
2161
2163
  :param fleet_service_role: The service role associated with the compute fleet. For more information, see `Allow a user to add a permission policy for a fleet service role <https://docs.aws.amazon.com/codebuild/latest/userguide/auth-and-access-control-iam-identity-based-access-control.html#customer-managed-policies-example-permission-policy-fleet-service-role.html>`_ in the *AWS CodeBuild User Guide* .
2162
2164
  :param fleet_vpc_config: Information about the VPC configuration that AWS CodeBuild accesses.
2165
+ :param image_id:
2163
2166
  :param name: The name of the compute fleet.
2164
2167
  :param overflow_behavior: The compute fleet overflow behavior. - For overflow behavior ``QUEUE`` , your overflow builds need to wait on the existing fleet instance to become available. - For overflow behavior ``ON_DEMAND`` , your overflow builds run on CodeBuild on-demand. .. epigraph:: If you choose to set your overflow behavior to on-demand while creating a VPC-connected fleet, make sure that you add the required VPC permissions to your project service role. For more information, see `Example policy statement to allow CodeBuild access to AWS services required to create a VPC network interface <https://docs.aws.amazon.com/codebuild/latest/userguide/auth-and-access-control-iam-identity-based-access-control.html#customer-managed-policies-example-create-vpc-network-interface>`_ .
2165
2168
  :param tags: A list of tag key and value pairs associated with this compute fleet. These tags are available for use by AWS services that support AWS CodeBuild compute fleet tags.
@@ -2174,6 +2177,7 @@ class CfnFleet(
2174
2177
  environment_type=environment_type,
2175
2178
  fleet_service_role=fleet_service_role,
2176
2179
  fleet_vpc_config=fleet_vpc_config,
2180
+ image_id=image_id,
2177
2181
  name=name,
2178
2182
  overflow_behavior=overflow_behavior,
2179
2183
  tags=tags,
@@ -2304,6 +2308,18 @@ class CfnFleet(
2304
2308
  check_type(argname="argument value", value=value, expected_type=type_hints["value"])
2305
2309
  jsii.set(self, "fleetVpcConfig", value) # pyright: ignore[reportArgumentType]
2306
2310
 
2311
+ @builtins.property
2312
+ @jsii.member(jsii_name="imageId")
2313
+ def image_id(self) -> typing.Optional[builtins.str]:
2314
+ return typing.cast(typing.Optional[builtins.str], jsii.get(self, "imageId"))
2315
+
2316
+ @image_id.setter
2317
+ def image_id(self, value: typing.Optional[builtins.str]) -> None:
2318
+ if __debug__:
2319
+ type_hints = typing.get_type_hints(_typecheckingstub__a33f552a37e35f306dfe760e51f68c6ca42ccd6b0ff4f2384f78f2d64f098f01)
2320
+ check_type(argname="argument value", value=value, expected_type=type_hints["value"])
2321
+ jsii.set(self, "imageId", value) # pyright: ignore[reportArgumentType]
2322
+
2307
2323
  @builtins.property
2308
2324
  @jsii.member(jsii_name="name")
2309
2325
  def name(self) -> typing.Optional[builtins.str]:
@@ -2442,6 +2458,7 @@ class CfnFleet(
2442
2458
  "environment_type": "environmentType",
2443
2459
  "fleet_service_role": "fleetServiceRole",
2444
2460
  "fleet_vpc_config": "fleetVpcConfig",
2461
+ "image_id": "imageId",
2445
2462
  "name": "name",
2446
2463
  "overflow_behavior": "overflowBehavior",
2447
2464
  "tags": "tags",
@@ -2456,6 +2473,7 @@ class CfnFleetProps:
2456
2473
  environment_type: typing.Optional[builtins.str] = None,
2457
2474
  fleet_service_role: typing.Optional[builtins.str] = None,
2458
2475
  fleet_vpc_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnFleet.VpcConfigProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
2476
+ image_id: typing.Optional[builtins.str] = None,
2459
2477
  name: typing.Optional[builtins.str] = None,
2460
2478
  overflow_behavior: typing.Optional[builtins.str] = None,
2461
2479
  tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
@@ -2467,6 +2485,7 @@ class CfnFleetProps:
2467
2485
  :param environment_type: The environment type of the compute fleet. - The environment type ``ARM_CONTAINER`` is available only in regions US East (N. Virginia), US East (Ohio), US West (Oregon), EU (Ireland), Asia Pacific (Mumbai), Asia Pacific (Tokyo), Asia Pacific (Singapore), Asia Pacific (Sydney), EU (Frankfurt), and South America (São Paulo). - The environment type ``LINUX_CONTAINER`` is available only in regions US East (N. Virginia), US East (Ohio), US West (Oregon), EU (Ireland), EU (Frankfurt), Asia Pacific (Tokyo), Asia Pacific (Singapore), Asia Pacific (Sydney), South America (São Paulo), and Asia Pacific (Mumbai). - The environment type ``LINUX_GPU_CONTAINER`` is available only in regions US East (N. Virginia), US East (Ohio), US West (Oregon), EU (Ireland), EU (Frankfurt), Asia Pacific (Tokyo), and Asia Pacific (Sydney). - The environment type ``WINDOWS_SERVER_2019_CONTAINER`` is available only in regions US East (N. Virginia), US East (Ohio), US West (Oregon), Asia Pacific (Sydney), Asia Pacific (Tokyo), Asia Pacific (Mumbai) and EU (Ireland). - The environment type ``WINDOWS_SERVER_2022_CONTAINER`` is available only in regions US East (N. Virginia), US East (Ohio), US West (Oregon), EU (Ireland), EU (Frankfurt), Asia Pacific (Sydney), Asia Pacific (Singapore), Asia Pacific (Tokyo), South America (São Paulo) and Asia Pacific (Mumbai). For more information, see `Build environment compute types <https://docs.aws.amazon.com//codebuild/latest/userguide/build-env-ref-compute-types.html>`_ in the *AWS CodeBuild user guide* .
2468
2486
  :param fleet_service_role: The service role associated with the compute fleet. For more information, see `Allow a user to add a permission policy for a fleet service role <https://docs.aws.amazon.com/codebuild/latest/userguide/auth-and-access-control-iam-identity-based-access-control.html#customer-managed-policies-example-permission-policy-fleet-service-role.html>`_ in the *AWS CodeBuild User Guide* .
2469
2487
  :param fleet_vpc_config: Information about the VPC configuration that AWS CodeBuild accesses.
2488
+ :param image_id:
2470
2489
  :param name: The name of the compute fleet.
2471
2490
  :param overflow_behavior: The compute fleet overflow behavior. - For overflow behavior ``QUEUE`` , your overflow builds need to wait on the existing fleet instance to become available. - For overflow behavior ``ON_DEMAND`` , your overflow builds run on CodeBuild on-demand. .. epigraph:: If you choose to set your overflow behavior to on-demand while creating a VPC-connected fleet, make sure that you add the required VPC permissions to your project service role. For more information, see `Example policy statement to allow CodeBuild access to AWS services required to create a VPC network interface <https://docs.aws.amazon.com/codebuild/latest/userguide/auth-and-access-control-iam-identity-based-access-control.html#customer-managed-policies-example-create-vpc-network-interface>`_ .
2472
2491
  :param tags: A list of tag key and value pairs associated with this compute fleet. These tags are available for use by AWS services that support AWS CodeBuild compute fleet tags.
@@ -2490,6 +2509,7 @@ class CfnFleetProps:
2490
2509
  subnets=["subnets"],
2491
2510
  vpc_id="vpcId"
2492
2511
  ),
2512
+ image_id="imageId",
2493
2513
  name="name",
2494
2514
  overflow_behavior="overflowBehavior",
2495
2515
  tags=[CfnTag(
@@ -2505,6 +2525,7 @@ class CfnFleetProps:
2505
2525
  check_type(argname="argument environment_type", value=environment_type, expected_type=type_hints["environment_type"])
2506
2526
  check_type(argname="argument fleet_service_role", value=fleet_service_role, expected_type=type_hints["fleet_service_role"])
2507
2527
  check_type(argname="argument fleet_vpc_config", value=fleet_vpc_config, expected_type=type_hints["fleet_vpc_config"])
2528
+ check_type(argname="argument image_id", value=image_id, expected_type=type_hints["image_id"])
2508
2529
  check_type(argname="argument name", value=name, expected_type=type_hints["name"])
2509
2530
  check_type(argname="argument overflow_behavior", value=overflow_behavior, expected_type=type_hints["overflow_behavior"])
2510
2531
  check_type(argname="argument tags", value=tags, expected_type=type_hints["tags"])
@@ -2519,6 +2540,8 @@ class CfnFleetProps:
2519
2540
  self._values["fleet_service_role"] = fleet_service_role
2520
2541
  if fleet_vpc_config is not None:
2521
2542
  self._values["fleet_vpc_config"] = fleet_vpc_config
2543
+ if image_id is not None:
2544
+ self._values["image_id"] = image_id
2522
2545
  if name is not None:
2523
2546
  self._values["name"] = name
2524
2547
  if overflow_behavior is not None:
@@ -2603,6 +2626,14 @@ class CfnFleetProps:
2603
2626
  result = self._values.get("fleet_vpc_config")
2604
2627
  return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, CfnFleet.VpcConfigProperty]], result)
2605
2628
 
2629
+ @builtins.property
2630
+ def image_id(self) -> typing.Optional[builtins.str]:
2631
+ '''
2632
+ :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codebuild-fleet.html#cfn-codebuild-fleet-imageid
2633
+ '''
2634
+ result = self._values.get("image_id")
2635
+ return typing.cast(typing.Optional[builtins.str], result)
2636
+
2606
2637
  @builtins.property
2607
2638
  def name(self) -> typing.Optional[builtins.str]:
2608
2639
  '''The name of the compute fleet.
@@ -17180,6 +17211,7 @@ def _typecheckingstub__081dd1a893dcfd34d3fe760e75a2377d2c6fbce3f4d815a8e141bcdc0
17180
17211
  environment_type: typing.Optional[builtins.str] = None,
17181
17212
  fleet_service_role: typing.Optional[builtins.str] = None,
17182
17213
  fleet_vpc_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnFleet.VpcConfigProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
17214
+ image_id: typing.Optional[builtins.str] = None,
17183
17215
  name: typing.Optional[builtins.str] = None,
17184
17216
  overflow_behavior: typing.Optional[builtins.str] = None,
17185
17217
  tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
@@ -17229,6 +17261,12 @@ def _typecheckingstub__c66d1798050c93d95746b1057fb5b75bf773869be3796e773defefc3a
17229
17261
  """Type checking stubs"""
17230
17262
  pass
17231
17263
 
17264
+ def _typecheckingstub__a33f552a37e35f306dfe760e51f68c6ca42ccd6b0ff4f2384f78f2d64f098f01(
17265
+ value: typing.Optional[builtins.str],
17266
+ ) -> None:
17267
+ """Type checking stubs"""
17268
+ pass
17269
+
17232
17270
  def _typecheckingstub__81a1c2090a083488d8e471132fa655912efe0a0fbc6ff93d4665fff305cc8b48(
17233
17271
  value: typing.Optional[builtins.str],
17234
17272
  ) -> None:
@@ -17263,6 +17301,7 @@ def _typecheckingstub__0f3b2fbc34cebb084c954d70b833a508d545b12a4280ff0f8020065e7
17263
17301
  environment_type: typing.Optional[builtins.str] = None,
17264
17302
  fleet_service_role: typing.Optional[builtins.str] = None,
17265
17303
  fleet_vpc_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnFleet.VpcConfigProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
17304
+ image_id: typing.Optional[builtins.str] = None,
17266
17305
  name: typing.Optional[builtins.str] = None,
17267
17306
  overflow_behavior: typing.Optional[builtins.str] = None,
17268
17307
  tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
@@ -16312,7 +16312,7 @@ class CfnIPAM(
16312
16312
  :param scope: Scope in which this resource is defined.
16313
16313
  :param id: Construct identifier for this resource (unique in its scope).
16314
16314
  :param description: The description for the IPAM.
16315
- :param enable_private_gua: Enable provisioning of GUA space in private pools.
16315
+ :param enable_private_gua: Enable this option to use your own GUA ranges as private IPv6 addresses. This option is disabled by default.
16316
16316
  :param operating_regions: The operating Regions for an IPAM. Operating Regions are AWS Regions where the IPAM is allowed to manage IP address CIDRs. IPAM only discovers and monitors resources in the AWS Regions you select as operating Regions. For more information about operating Regions, see `Create an IPAM <https://docs.aws.amazon.com//vpc/latest/ipam/create-ipam.html>`_ in the *Amazon VPC IPAM User Guide* .
16317
16317
  :param tags: The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key ``Owner`` and the value ``TeamA`` , specify ``tag:Owner`` for the filter name and ``TeamA`` for the filter value.
16318
16318
  :param tier: IPAM is offered in a Free Tier and an Advanced Tier. For more information about the features available in each tier and the costs associated with the tiers, see the `VPC IPAM product pricing page <https://docs.aws.amazon.com//vpc/pricing/>`_ .
@@ -16462,7 +16462,7 @@ class CfnIPAM(
16462
16462
  def enable_private_gua(
16463
16463
  self,
16464
16464
  ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
16465
- '''Enable provisioning of GUA space in private pools.'''
16465
+ '''Enable this option to use your own GUA ranges as private IPv6 addresses.'''
16466
16466
  return typing.cast(typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]], jsii.get(self, "enablePrivateGua"))
16467
16467
 
16468
16468
  @enable_private_gua.setter
@@ -18122,7 +18122,7 @@ class CfnIPAMProps:
18122
18122
  '''Properties for defining a ``CfnIPAM``.
18123
18123
 
18124
18124
  :param description: The description for the IPAM.
18125
- :param enable_private_gua: Enable provisioning of GUA space in private pools.
18125
+ :param enable_private_gua: Enable this option to use your own GUA ranges as private IPv6 addresses. This option is disabled by default.
18126
18126
  :param operating_regions: The operating Regions for an IPAM. Operating Regions are AWS Regions where the IPAM is allowed to manage IP address CIDRs. IPAM only discovers and monitors resources in the AWS Regions you select as operating Regions. For more information about operating Regions, see `Create an IPAM <https://docs.aws.amazon.com//vpc/latest/ipam/create-ipam.html>`_ in the *Amazon VPC IPAM User Guide* .
18127
18127
  :param tags: The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key ``Owner`` and the value ``TeamA`` , specify ``tag:Owner`` for the filter name and ``TeamA`` for the filter value.
18128
18128
  :param tier: IPAM is offered in a Free Tier and an Advanced Tier. For more information about the features available in each tier and the costs associated with the tiers, see the `VPC IPAM product pricing page <https://docs.aws.amazon.com//vpc/pricing/>`_ .
@@ -18181,7 +18181,9 @@ class CfnIPAMProps:
18181
18181
  def enable_private_gua(
18182
18182
  self,
18183
18183
  ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
18184
- '''Enable provisioning of GUA space in private pools.
18184
+ '''Enable this option to use your own GUA ranges as private IPv6 addresses.
18185
+
18186
+ This option is disabled by default.
18185
18187
 
18186
18188
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-ipam.html#cfn-ec2-ipam-enableprivategua
18187
18189
  '''
@@ -39461,8 +39463,8 @@ class CfnPrefixList(
39461
39463
  :param id: Construct identifier for this resource (unique in its scope).
39462
39464
  :param address_family: The IP address type. Valid Values: ``IPv4`` | ``IPv6``
39463
39465
  :param prefix_list_name: A name for the prefix list. Constraints: Up to 255 characters in length. The name cannot start with ``com.amazonaws`` .
39464
- :param entries: One or more entries for the prefix list.
39465
- :param max_entries: The maximum number of entries for the prefix list.
39466
+ :param entries: The entries for the prefix list.
39467
+ :param max_entries: The maximum number of entries for the prefix list. This property is required when you create a prefix list.
39466
39468
  :param tags: The tags for the prefix list.
39467
39469
  '''
39468
39470
  if __debug__:
@@ -39595,7 +39597,7 @@ class CfnPrefixList(
39595
39597
  def entries(
39596
39598
  self,
39597
39599
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnPrefixList.EntryProperty"]]]]:
39598
- '''One or more entries for the prefix list.'''
39600
+ '''The entries for the prefix list.'''
39599
39601
  return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnPrefixList.EntryProperty"]]]], jsii.get(self, "entries"))
39600
39602
 
39601
39603
  @entries.setter
@@ -39735,8 +39737,8 @@ class CfnPrefixListProps:
39735
39737
 
39736
39738
  :param address_family: The IP address type. Valid Values: ``IPv4`` | ``IPv6``
39737
39739
  :param prefix_list_name: A name for the prefix list. Constraints: Up to 255 characters in length. The name cannot start with ``com.amazonaws`` .
39738
- :param entries: One or more entries for the prefix list.
39739
- :param max_entries: The maximum number of entries for the prefix list.
39740
+ :param entries: The entries for the prefix list.
39741
+ :param max_entries: The maximum number of entries for the prefix list. This property is required when you create a prefix list.
39740
39742
  :param tags: The tags for the prefix list.
39741
39743
 
39742
39744
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-prefixlist.html
@@ -39812,7 +39814,7 @@ class CfnPrefixListProps:
39812
39814
  def entries(
39813
39815
  self,
39814
39816
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, CfnPrefixList.EntryProperty]]]]:
39815
- '''One or more entries for the prefix list.
39817
+ '''The entries for the prefix list.
39816
39818
 
39817
39819
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-prefixlist.html#cfn-ec2-prefixlist-entries
39818
39820
  '''
@@ -39823,6 +39825,8 @@ class CfnPrefixListProps:
39823
39825
  def max_entries(self) -> typing.Optional[jsii.Number]:
39824
39826
  '''The maximum number of entries for the prefix list.
39825
39827
 
39828
+ This property is required when you create a prefix list.
39829
+
39826
39830
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-prefixlist.html#cfn-ec2-prefixlist-maxentries
39827
39831
  '''
39828
39832
  result = self._values.get("max_entries")
@@ -55894,7 +55898,9 @@ class CfnVPCCidrBlock(
55894
55898
  @builtins.property
55895
55899
  @jsii.member(jsii_name="attrIpSource")
55896
55900
  def attr_ip_source(self) -> builtins.str:
55897
- '''The IP Source of an IPv6 VPC CIDR Block.
55901
+ '''The source that allocated the IP address space.
55902
+
55903
+ ``byoip`` or ``amazon`` indicates public IP address space allocated by Amazon or space that you have allocated with Bring your own IP (BYOIP). ``none`` indicates private space.
55898
55904
 
55899
55905
  :cloudformationAttribute: IpSource
55900
55906
  '''
@@ -55903,7 +55909,9 @@ class CfnVPCCidrBlock(
55903
55909
  @builtins.property
55904
55910
  @jsii.member(jsii_name="attrIpv6AddressAttribute")
55905
55911
  def attr_ipv6_address_attribute(self) -> builtins.str:
55906
- '''The value denoting whether an IPv6 VPC CIDR Block is public or private.
55912
+ '''Public IPv6 addresses are those advertised on the internet from AWS .
55913
+
55914
+ Private IP addresses are not and cannot be advertised on the internet from AWS .
55907
55915
 
55908
55916
  :cloudformationAttribute: Ipv6AddressAttribute
55909
55917
  '''
@@ -12633,7 +12633,7 @@ class CfnTaskDefinition(
12633
12633
  :param interactive: When this parameter is ``true`` , you can deploy containerized applications that require ``stdin`` or a ``tty`` to be allocated. This parameter maps to ``OpenStdin`` in the docker conainer create command and the ``--interactive`` option to docker run.
12634
12634
  :param links: The ``links`` parameter allows containers to communicate with each other without the need for port mappings. This parameter is only supported if the network mode of a task definition is ``bridge`` . The ``name:internalName`` construct is analogous to ``name:alias`` in Docker links. Up to 255 letters (uppercase and lowercase), numbers, underscores, and hyphens are allowed.. This parameter maps to ``Links`` in the docker conainer create command and the ``--link`` option to docker run. .. epigraph:: This parameter is not supported for Windows containers. > Containers that are collocated on a single container instance may be able to communicate with each other without requiring links or host port mappings. Network isolation is achieved on the container instance using security groups and VPC settings.
12635
12635
  :param linux_parameters: Linux-specific modifications that are applied to the container, such as Linux kernel capabilities. For more information see `KernelCapabilities <https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_KernelCapabilities.html>`_ . .. epigraph:: This parameter is not supported for Windows containers.
12636
- :param log_configuration: The log configuration specification for the container. This parameter maps to ``LogConfig`` in the `Create a container <https://docs.aws.amazon.com/https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate>`_ section of the `Docker Remote API <https://docs.aws.amazon.com/https://docs.docker.com/engine/api/v1.35/>`_ and the ``--log-driver`` option to `docker run <https://docs.aws.amazon.com/https://docs.docker.com/engine/reference/run/>`_ . By default, containers use the same logging driver that the Docker daemon uses. However, the container may use a different logging driver than the Docker daemon by specifying a log driver with this parameter in the container definition. To use a different logging driver for a container, the log system must be configured properly on the container instance (or on a different log server for remote logging options). For more information on the options for different supported log drivers, see `Configure logging drivers <https://docs.aws.amazon.com/https://docs.docker.com/engine/admin/logging/overview/>`_ in the Docker documentation. .. epigraph:: Amazon ECS currently supports a subset of the logging drivers available to the Docker daemon (shown in the `LogConfiguration <https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_LogConfiguration.html>`_ data type). Additional log drivers may be available in future releases of the Amazon ECS container agent. This parameter requires version 1.18 of the Docker Remote API or greater on your container instance. To check the Docker Remote API version on your container instance, log in to your container instance and run the following command: ``sudo docker version --format '{{.Server.APIVersion}}'`` .. epigraph:: The Amazon ECS container agent running on a container instance must register the logging drivers available on that instance with the ``ECS_AVAILABLE_LOGGING_DRIVERS`` environment variable before containers placed on that instance can use these log configuration options. For more information, see `Amazon ECS Container Agent Configuration <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-config.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
12636
+ :param log_configuration: The log configuration specification for the container. This parameter maps to ``LogConfig`` in the docker Create a container command and the ``--log-driver`` option to docker run. By default, containers use the same logging driver that the Docker daemon uses. However, the container may use a different logging driver than the Docker daemon by specifying a log driver with this parameter in the container definition. To use a different logging driver for a container, the log system must be configured properly on the container instance (or on a different log server for remote logging options). For more information on the options for different supported log drivers, see `Configure logging drivers <https://docs.aws.amazon.com/https://docs.docker.com/engine/admin/logging/overview/>`_ in the Docker documentation. .. epigraph:: Amazon ECS currently supports a subset of the logging drivers available to the Docker daemon (shown in the `LogConfiguration <https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_LogConfiguration.html>`_ data type). Additional log drivers may be available in future releases of the Amazon ECS container agent. This parameter requires version 1.18 of the Docker Remote API or greater on your container instance. To check the Docker Remote API version on your container instance, log in to your container instance and run the following command: ``sudo docker version --format '{{.Server.APIVersion}}'`` .. epigraph:: The Amazon ECS container agent running on a container instance must register the logging drivers available on that instance with the ``ECS_AVAILABLE_LOGGING_DRIVERS`` environment variable before containers placed on that instance can use these log configuration options. For more information, see `Amazon ECS Container Agent Configuration <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-config.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
12637
12637
  :param memory: The amount (in MiB) of memory to present to the container. If your container attempts to exceed the memory specified here, the container is killed. The total amount of memory reserved for all containers within a task must be lower than the task ``memory`` value, if one is specified. This parameter maps to ``Memory`` in the `Create a container <https://docs.aws.amazon.com/https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate>`_ section of the `Docker Remote API <https://docs.aws.amazon.com/https://docs.docker.com/engine/api/v1.35/>`_ and the ``--memory`` option to `docker run <https://docs.aws.amazon.com/https://docs.docker.com/engine/reference/run/#security-configuration>`_ . If using the Fargate launch type, this parameter is optional. If using the EC2 launch type, you must specify either a task-level memory value or a container-level memory value. If you specify both a container-level ``memory`` and ``memoryReservation`` value, ``memory`` must be greater than ``memoryReservation`` . If you specify ``memoryReservation`` , then that value is subtracted from the available memory resources for the container instance where the container is placed. Otherwise, the value of ``memory`` is used. The Docker 20.10.0 or later daemon reserves a minimum of 6 MiB of memory for a container, so you should not specify fewer than 6 MiB of memory for your containers. The Docker 19.03.13-ce or earlier daemon reserves a minimum of 4 MiB of memory for a container, so you should not specify fewer than 4 MiB of memory for your containers.
12638
12638
  :param memory_reservation: The soft limit (in MiB) of memory to reserve for the container. When system memory is under heavy contention, Docker attempts to keep the container memory to this soft limit. However, your container can consume more memory when it needs to, up to either the hard limit specified with the ``memory`` parameter (if applicable), or all of the available memory on the container instance, whichever comes first. This parameter maps to ``MemoryReservation`` in the the docker conainer create command and the ``--memory-reservation`` option to docker run. If a task-level memory value is not specified, you must specify a non-zero integer for one or both of ``memory`` or ``memoryReservation`` in a container definition. If you specify both, ``memory`` must be greater than ``memoryReservation`` . If you specify ``memoryReservation`` , then that value is subtracted from the available memory resources for the container instance where the container is placed. Otherwise, the value of ``memory`` is used. For example, if your container normally uses 128 MiB of memory, but occasionally bursts to 256 MiB of memory for short periods of time, you can set a ``memoryReservation`` of 128 MiB, and a ``memory`` hard limit of 300 MiB. This configuration would allow the container to only reserve 128 MiB of memory from the remaining resources on the container instance, but also allow the container to consume more memory resources when needed. The Docker 20.10.0 or later daemon reserves a minimum of 6 MiB of memory for a container. So, don't specify less than 6 MiB of memory for your containers. The Docker 19.03.13-ce or earlier daemon reserves a minimum of 4 MiB of memory for a container. So, don't specify less than 4 MiB of memory for your containers.
12639
12639
  :param mount_points: The mount points for data volumes in your container. This parameter maps to ``Volumes`` in the the docker conainer create command and the ``--volume`` option to docker run. Windows containers can mount whole directories on the same drive as ``$env:ProgramData`` . Windows containers can't mount directories on a different drive, and mount point can't be across drives.
@@ -13277,7 +13277,7 @@ class CfnTaskDefinition(
13277
13277
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnTaskDefinition.LogConfigurationProperty"]]:
13278
13278
  '''The log configuration specification for the container.
13279
13279
 
13280
- This parameter maps to ``LogConfig`` in the `Create a container <https://docs.aws.amazon.com/https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate>`_ section of the `Docker Remote API <https://docs.aws.amazon.com/https://docs.docker.com/engine/api/v1.35/>`_ and the ``--log-driver`` option to `docker run <https://docs.aws.amazon.com/https://docs.docker.com/engine/reference/run/>`_ . By default, containers use the same logging driver that the Docker daemon uses. However, the container may use a different logging driver than the Docker daemon by specifying a log driver with this parameter in the container definition. To use a different logging driver for a container, the log system must be configured properly on the container instance (or on a different log server for remote logging options). For more information on the options for different supported log drivers, see `Configure logging drivers <https://docs.aws.amazon.com/https://docs.docker.com/engine/admin/logging/overview/>`_ in the Docker documentation.
13280
+ This parameter maps to ``LogConfig`` in the docker Create a container command and the ``--log-driver`` option to docker run. By default, containers use the same logging driver that the Docker daemon uses. However, the container may use a different logging driver than the Docker daemon by specifying a log driver with this parameter in the container definition. To use a different logging driver for a container, the log system must be configured properly on the container instance (or on a different log server for remote logging options). For more information on the options for different supported log drivers, see `Configure logging drivers <https://docs.aws.amazon.com/https://docs.docker.com/engine/admin/logging/overview/>`_ in the Docker documentation.
13281
13281
  .. epigraph::
13282
13282
 
13283
13283
  Amazon ECS currently supports a subset of the logging drivers available to the Docker daemon (shown in the `LogConfiguration <https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_LogConfiguration.html>`_ data type). Additional log drivers may be available in future releases of the Amazon ECS container agent.
@@ -14819,7 +14819,9 @@ class CfnTaskDefinition(
14819
14819
  add: typing.Optional[typing.Sequence[builtins.str]] = None,
14820
14820
  drop: typing.Optional[typing.Sequence[builtins.str]] = None,
14821
14821
  ) -> None:
14822
- '''The Linux capabilities to add or remove from the default Docker configuration for a container defined in the task definition.. For more detailed information about these Linux capabilities, see the `capabilities(7) <https://docs.aws.amazon.com/http://man7.org/linux/man-pages/man7/capabilities.7.html>`_ Linux manual page.
14822
+ '''The Linux capabilities to add or remove from the default Docker configuration for a container defined in the task definition.
14823
+
14824
+ For more detailed information about these Linux capabilities, see the `capabilities(7) <https://docs.aws.amazon.com/http://man7.org/linux/man-pages/man7/capabilities.7.html>`_ Linux manual page.
14823
14825
 
14824
14826
  :param add: The Linux capabilities for the container that have been added to the default configuration provided by Docker. This parameter maps to ``CapAdd`` in the docker conainer create command and the ``--cap-add`` option to docker run. .. epigraph:: Tasks launched on AWS Fargate only support adding the ``SYS_PTRACE`` kernel capability. Valid values: ``"ALL" | "AUDIT_CONTROL" | "AUDIT_WRITE" | "BLOCK_SUSPEND" | "CHOWN" | "DAC_OVERRIDE" | "DAC_READ_SEARCH" | "FOWNER" | "FSETID" | "IPC_LOCK" | "IPC_OWNER" | "KILL" | "LEASE" | "LINUX_IMMUTABLE" | "MAC_ADMIN" | "MAC_OVERRIDE" | "MKNOD" | "NET_ADMIN" | "NET_BIND_SERVICE" | "NET_BROADCAST" | "NET_RAW" | "SETFCAP" | "SETGID" | "SETPCAP" | "SETUID" | "SYS_ADMIN" | "SYS_BOOT" | "SYS_CHROOT" | "SYS_MODULE" | "SYS_NICE" | "SYS_PACCT" | "SYS_PTRACE" | "SYS_RAWIO" | "SYS_RESOURCE" | "SYS_TIME" | "SYS_TTY_CONFIG" | "SYSLOG" | "WAKE_ALARM"``
14825
14827
  :param drop: The Linux capabilities for the container that have been removed from the default configuration provided by Docker. This parameter maps to ``CapDrop`` in the docker conainer create command and the ``--cap-drop`` option to docker run. Valid values: ``"ALL" | "AUDIT_CONTROL" | "AUDIT_WRITE" | "BLOCK_SUSPEND" | "CHOWN" | "DAC_OVERRIDE" | "DAC_READ_SEARCH" | "FOWNER" | "FSETID" | "IPC_LOCK" | "IPC_OWNER" | "KILL" | "LEASE" | "LINUX_IMMUTABLE" | "MAC_ADMIN" | "MAC_OVERRIDE" | "MKNOD" | "NET_ADMIN" | "NET_BIND_SERVICE" | "NET_BROADCAST" | "NET_RAW" | "SETFCAP" | "SETGID" | "SETPCAP" | "SETUID" | "SYS_ADMIN" | "SYS_BOOT" | "SYS_CHROOT" | "SYS_MODULE" | "SYS_NICE" | "SYS_PACCT" | "SYS_PTRACE" | "SYS_RAWIO" | "SYS_RESOURCE" | "SYS_TIME" | "SYS_TTY_CONFIG" | "SYSLOG" | "WAKE_ALARM"``