aws-cdk-lib 2.207.0__py3-none-any.whl → 2.208.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.

Potentially problematic release.


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

Files changed (35) hide show
  1. aws_cdk/_jsii/__init__.py +1 -1
  2. aws_cdk/_jsii/{aws-cdk-lib@2.207.0.jsii.tgz → aws-cdk-lib@2.208.0.jsii.tgz} +0 -0
  3. aws_cdk/aws_aiops/__init__.py +16 -12
  4. aws_cdk/aws_amazonmq/__init__.py +8 -18
  5. aws_cdk/aws_appstream/__init__.py +36 -4
  6. aws_cdk/aws_bedrock/__init__.py +191 -72
  7. aws_cdk/aws_certificatemanager/__init__.py +45 -0
  8. aws_cdk/aws_cloudfront/__init__.py +12 -2
  9. aws_cdk/aws_connect/__init__.py +107 -3
  10. aws_cdk/aws_customerprofiles/__init__.py +27 -22
  11. aws_cdk/aws_docdb/__init__.py +5 -3
  12. aws_cdk/aws_ec2/__init__.py +53 -11
  13. aws_cdk/aws_ecs/__init__.py +118 -29
  14. aws_cdk/aws_events/__init__.py +142 -0
  15. aws_cdk/aws_gamelift/__init__.py +2 -2
  16. aws_cdk/aws_guardduty/__init__.py +86 -0
  17. aws_cdk/aws_kinesisfirehose/__init__.py +377 -4
  18. aws_cdk/aws_logs/__init__.py +53 -4
  19. aws_cdk/aws_mediapackagev2/__init__.py +881 -0
  20. aws_cdk/aws_omics/__init__.py +13 -10
  21. aws_cdk/aws_quicksight/__init__.py +111 -4
  22. aws_cdk/aws_rds/__init__.py +208 -10
  23. aws_cdk/aws_s3/__init__.py +775 -5
  24. aws_cdk/aws_s3express/__init__.py +61 -3
  25. aws_cdk/aws_s3tables/__init__.py +254 -0
  26. aws_cdk/aws_sagemaker/__init__.py +524 -137
  27. aws_cdk/aws_ssm/__init__.py +48 -0
  28. aws_cdk/aws_transfer/__init__.py +49 -0
  29. aws_cdk/aws_wisdom/__init__.py +1185 -100
  30. {aws_cdk_lib-2.207.0.dist-info → aws_cdk_lib-2.208.0.dist-info}/METADATA +2 -2
  31. {aws_cdk_lib-2.207.0.dist-info → aws_cdk_lib-2.208.0.dist-info}/RECORD +35 -35
  32. {aws_cdk_lib-2.207.0.dist-info → aws_cdk_lib-2.208.0.dist-info}/LICENSE +0 -0
  33. {aws_cdk_lib-2.207.0.dist-info → aws_cdk_lib-2.208.0.dist-info}/NOTICE +0 -0
  34. {aws_cdk_lib-2.207.0.dist-info → aws_cdk_lib-2.208.0.dist-info}/WHEEL +0 -0
  35. {aws_cdk_lib-2.207.0.dist-info → aws_cdk_lib-2.208.0.dist-info}/top_level.txt +0 -0
@@ -5924,9 +5924,9 @@ class CfnCapacityReservation(
5924
5924
  '''
5925
5925
  :param scope: Scope in which this resource is defined.
5926
5926
  :param id: Construct identifier for this resource (unique in its scope).
5927
- :param instance_count: The number of instances for which to reserve capacity. .. epigraph:: You can request future-dated Capacity Reservations for an instance count with a minimum of 100 vCPUs. For example, if you request a future-dated Capacity Reservation for ``m5.xlarge`` instances, you must request at least 25 instances ( *25 * m5.xlarge = 100 vCPUs* ). Valid range: 1 - 1000
5927
+ :param instance_count: The number of instances for which to reserve capacity. .. epigraph:: You can request future-dated Capacity Reservations for an instance count with a minimum of 64 vCPUs. For example, if you request a future-dated Capacity Reservation for ``m5.xlarge`` instances, you must request at least 25 instances ( *16 * m5.xlarge = 64 vCPUs* ). Valid range: 1 - 1000
5928
5928
  :param instance_platform: The type of operating system for which to reserve capacity.
5929
- :param instance_type: The instance type for which to reserve capacity. .. epigraph:: You can request future-dated Capacity Reservations for instance types in the C, M, R, I, and T instance families only. For more information, see `Instance types <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html>`_ in the *Amazon EC2 User Guide* .
5929
+ :param instance_type: The instance type for which to reserve capacity. .. epigraph:: You can request future-dated Capacity Reservations for instance types in the C, M, R, I, T, and G instance families only. For more information, see `Instance types <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html>`_ in the *Amazon EC2 User Guide* .
5930
5930
  :param availability_zone: The Availability Zone in which to create the Capacity Reservation.
5931
5931
  :param availability_zone_id: The Availability Zone ID of the Capacity Reservation.
5932
5932
  :param ebs_optimized: Indicates whether the Capacity Reservation supports EBS-optimized instances. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS- optimized instance.
@@ -7427,9 +7427,9 @@ class CfnCapacityReservationProps:
7427
7427
  ) -> None:
7428
7428
  '''Properties for defining a ``CfnCapacityReservation``.
7429
7429
 
7430
- :param instance_count: The number of instances for which to reserve capacity. .. epigraph:: You can request future-dated Capacity Reservations for an instance count with a minimum of 100 vCPUs. For example, if you request a future-dated Capacity Reservation for ``m5.xlarge`` instances, you must request at least 25 instances ( *25 * m5.xlarge = 100 vCPUs* ). Valid range: 1 - 1000
7430
+ :param instance_count: The number of instances for which to reserve capacity. .. epigraph:: You can request future-dated Capacity Reservations for an instance count with a minimum of 64 vCPUs. For example, if you request a future-dated Capacity Reservation for ``m5.xlarge`` instances, you must request at least 25 instances ( *16 * m5.xlarge = 64 vCPUs* ). Valid range: 1 - 1000
7431
7431
  :param instance_platform: The type of operating system for which to reserve capacity.
7432
- :param instance_type: The instance type for which to reserve capacity. .. epigraph:: You can request future-dated Capacity Reservations for instance types in the C, M, R, I, and T instance families only. For more information, see `Instance types <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html>`_ in the *Amazon EC2 User Guide* .
7432
+ :param instance_type: The instance type for which to reserve capacity. .. epigraph:: You can request future-dated Capacity Reservations for instance types in the C, M, R, I, T, and G instance families only. For more information, see `Instance types <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html>`_ in the *Amazon EC2 User Guide* .
7433
7433
  :param availability_zone: The Availability Zone in which to create the Capacity Reservation.
7434
7434
  :param availability_zone_id: The Availability Zone ID of the Capacity Reservation.
7435
7435
  :param ebs_optimized: Indicates whether the Capacity Reservation supports EBS-optimized instances. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS- optimized instance.
@@ -7531,7 +7531,7 @@ class CfnCapacityReservationProps:
7531
7531
 
7532
7532
  .. epigraph::
7533
7533
 
7534
- You can request future-dated Capacity Reservations for an instance count with a minimum of 100 vCPUs. For example, if you request a future-dated Capacity Reservation for ``m5.xlarge`` instances, you must request at least 25 instances ( *25 * m5.xlarge = 100 vCPUs* ).
7534
+ You can request future-dated Capacity Reservations for an instance count with a minimum of 64 vCPUs. For example, if you request a future-dated Capacity Reservation for ``m5.xlarge`` instances, you must request at least 25 instances ( *16 * m5.xlarge = 64 vCPUs* ).
7535
7535
 
7536
7536
  Valid range: 1 - 1000
7537
7537
 
@@ -7557,7 +7557,7 @@ class CfnCapacityReservationProps:
7557
7557
 
7558
7558
  .. epigraph::
7559
7559
 
7560
- You can request future-dated Capacity Reservations for instance types in the C, M, R, I, and T instance families only.
7560
+ You can request future-dated Capacity Reservations for instance types in the C, M, R, I, T, and G instance families only.
7561
7561
 
7562
7562
  For more information, see `Instance types <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html>`_ in the *Amazon EC2 User Guide* .
7563
7563
 
@@ -21415,7 +21415,7 @@ class CfnInstance(
21415
21415
  :param ipv6_address_count: The number of IPv6 addresses to associate with the primary network interface. Amazon EC2 chooses the IPv6 addresses from the range of your subnet. You cannot specify this option and the option to assign specific IPv6 addresses in the same request. You can specify this option if you've specified a minimum number of instances to launch. You cannot specify this option and the network interfaces option in the same request.
21416
21416
  :param ipv6_addresses: The IPv6 addresses from the range of the subnet to associate with the primary network interface. You cannot specify this option and the option to assign a number of IPv6 addresses in the same request. You cannot specify this option if you've specified a minimum number of instances to launch. You cannot specify this option and the network interfaces option in the same request.
21417
21417
  :param kernel_id: The ID of the kernel. .. epigraph:: We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see `PV-GRUB <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/UserProvidedkernels.html>`_ in the *Amazon EC2 User Guide* .
21418
- :param key_name: The name of the key pair. You can create a key pair using `CreateKeyPair <https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateKeyPair.html>`_ or `ImportKeyPair <https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ImportKeyPair.html>`_ . .. epigraph:: If you do not specify a key pair, you can't connect to the instance unless you choose an AMI that is configured to allow users another way to log in.
21418
+ :param key_name: The name of the key pair. For more information, see `Create a key pair for your EC2 instance <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/create-key-pairs.html>`_ . .. epigraph:: If you do not specify a key pair, you can't connect to the instance unless you choose an AMI that is configured to allow users another way to log in.
21419
21419
  :param launch_template: The launch template. Any additional parameters that you specify for the new instance overwrite the corresponding parameters included in the launch template.
21420
21420
  :param license_specifications: The license configurations.
21421
21421
  :param metadata_options: The metadata options for the instance.
@@ -21940,7 +21940,7 @@ class CfnInstance(
21940
21940
  def key_name(self) -> typing.Optional[builtins.str]:
21941
21941
  '''The name of the key pair.
21942
21942
 
21943
- You can create a key pair using `CreateKeyPair <https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateKeyPair.html>`_ or `ImportKeyPair <https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ImportKeyPair.html>`_ .
21943
+ For more information, see `Create a key pair for your EC2 instance <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/create-key-pairs.html>`_ .
21944
21944
  '''
21945
21945
  return typing.cast(typing.Optional[builtins.str], jsii.get(self, "keyName"))
21946
21946
 
@@ -24829,7 +24829,7 @@ class CfnInstanceProps:
24829
24829
  :param ipv6_address_count: The number of IPv6 addresses to associate with the primary network interface. Amazon EC2 chooses the IPv6 addresses from the range of your subnet. You cannot specify this option and the option to assign specific IPv6 addresses in the same request. You can specify this option if you've specified a minimum number of instances to launch. You cannot specify this option and the network interfaces option in the same request.
24830
24830
  :param ipv6_addresses: The IPv6 addresses from the range of the subnet to associate with the primary network interface. You cannot specify this option and the option to assign a number of IPv6 addresses in the same request. You cannot specify this option if you've specified a minimum number of instances to launch. You cannot specify this option and the network interfaces option in the same request.
24831
24831
  :param kernel_id: The ID of the kernel. .. epigraph:: We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see `PV-GRUB <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/UserProvidedkernels.html>`_ in the *Amazon EC2 User Guide* .
24832
- :param key_name: The name of the key pair. You can create a key pair using `CreateKeyPair <https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateKeyPair.html>`_ or `ImportKeyPair <https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ImportKeyPair.html>`_ . .. epigraph:: If you do not specify a key pair, you can't connect to the instance unless you choose an AMI that is configured to allow users another way to log in.
24832
+ :param key_name: The name of the key pair. For more information, see `Create a key pair for your EC2 instance <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/create-key-pairs.html>`_ . .. epigraph:: If you do not specify a key pair, you can't connect to the instance unless you choose an AMI that is configured to allow users another way to log in.
24833
24833
  :param launch_template: The launch template. Any additional parameters that you specify for the new instance overwrite the corresponding parameters included in the launch template.
24834
24834
  :param license_specifications: The license configurations.
24835
24835
  :param metadata_options: The metadata options for the instance.
@@ -25396,7 +25396,7 @@ class CfnInstanceProps:
25396
25396
 
25397
25397
  @builtins.property
25398
25398
  def key_name(self) -> typing.Optional[builtins.str]:
25399
- '''The name of the key pair. You can create a key pair using `CreateKeyPair <https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateKeyPair.html>`_ or `ImportKeyPair <https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ImportKeyPair.html>`_ .
25399
+ '''The name of the key pair. For more information, see `Create a key pair for your EC2 instance <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/create-key-pairs.html>`_ .
25400
25400
 
25401
25401
  .. epigraph::
25402
25402
 
@@ -55177,6 +55177,7 @@ class CfnTrafficMirrorSession(
55177
55177
 
55178
55178
  # the properties below are optional
55179
55179
  description="description",
55180
+ owner_id="ownerId",
55180
55181
  packet_length=123,
55181
55182
  tags=[CfnTag(
55182
55183
  key="key",
@@ -55196,6 +55197,7 @@ class CfnTrafficMirrorSession(
55196
55197
  traffic_mirror_filter_id: builtins.str,
55197
55198
  traffic_mirror_target_id: builtins.str,
55198
55199
  description: typing.Optional[builtins.str] = None,
55200
+ owner_id: typing.Optional[builtins.str] = None,
55199
55201
  packet_length: typing.Optional[jsii.Number] = None,
55200
55202
  tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
55201
55203
  virtual_network_id: typing.Optional[jsii.Number] = None,
@@ -55208,6 +55210,7 @@ class CfnTrafficMirrorSession(
55208
55210
  :param traffic_mirror_filter_id: The ID of the Traffic Mirror filter.
55209
55211
  :param traffic_mirror_target_id: The ID of the Traffic Mirror target.
55210
55212
  :param description: The description of the Traffic Mirror session.
55213
+ :param owner_id: The ID of the account that owns the Traffic Mirror session.
55211
55214
  :param packet_length: The number of bytes in each packet to mirror. These are bytes after the VXLAN header. Do not specify this parameter when you want to mirror the entire packet. To mirror a subset of the packet, set this to the length (in bytes) that you want to mirror. For example, if you set this value to 100, then the first 100 bytes that meet the filter criteria are copied to the target. If you do not want to mirror the entire packet, use the ``PacketLength`` parameter to specify the number of bytes in each packet to mirror. For sessions with Network Load Balancer (NLB) Traffic Mirror targets the default ``PacketLength`` will be set to 8500. Valid values are 1-8500. Setting a ``PacketLength`` greater than 8500 will result in an error response.
55212
55215
  :param tags: The tags to assign to a Traffic Mirror session.
55213
55216
  :param virtual_network_id: The VXLAN ID for the Traffic Mirror session. For more information about the VXLAN protocol, see `RFC 7348 <https://docs.aws.amazon.com/https://datatracker.ietf.org/doc/html/rfc7348>`_ . If you do not specify a ``VirtualNetworkId`` , an account-wide unique ID is chosen at random.
@@ -55222,6 +55225,7 @@ class CfnTrafficMirrorSession(
55222
55225
  traffic_mirror_filter_id=traffic_mirror_filter_id,
55223
55226
  traffic_mirror_target_id=traffic_mirror_target_id,
55224
55227
  description=description,
55228
+ owner_id=owner_id,
55225
55229
  packet_length=packet_length,
55226
55230
  tags=tags,
55227
55231
  virtual_network_id=virtual_network_id,
@@ -55262,7 +55266,8 @@ class CfnTrafficMirrorSession(
55262
55266
  @builtins.property
55263
55267
  @jsii.member(jsii_name="attrId")
55264
55268
  def attr_id(self) -> builtins.str:
55265
- '''
55269
+ '''The ID of a Traffic Mirror session.
55270
+
55266
55271
  :cloudformationAttribute: Id
55267
55272
  '''
55268
55273
  return typing.cast(builtins.str, jsii.get(self, "attrId"))
@@ -55343,6 +55348,19 @@ class CfnTrafficMirrorSession(
55343
55348
  check_type(argname="argument value", value=value, expected_type=type_hints["value"])
55344
55349
  jsii.set(self, "description", value) # pyright: ignore[reportArgumentType]
55345
55350
 
55351
+ @builtins.property
55352
+ @jsii.member(jsii_name="ownerId")
55353
+ def owner_id(self) -> typing.Optional[builtins.str]:
55354
+ '''The ID of the account that owns the Traffic Mirror session.'''
55355
+ return typing.cast(typing.Optional[builtins.str], jsii.get(self, "ownerId"))
55356
+
55357
+ @owner_id.setter
55358
+ def owner_id(self, value: typing.Optional[builtins.str]) -> None:
55359
+ if __debug__:
55360
+ type_hints = typing.get_type_hints(_typecheckingstub__21588510c317dbb4d3f093aedb52504c662e37e8a686d1ea3651a49a04ed0e49)
55361
+ check_type(argname="argument value", value=value, expected_type=type_hints["value"])
55362
+ jsii.set(self, "ownerId", value) # pyright: ignore[reportArgumentType]
55363
+
55346
55364
  @builtins.property
55347
55365
  @jsii.member(jsii_name="packetLength")
55348
55366
  def packet_length(self) -> typing.Optional[jsii.Number]:
@@ -55392,6 +55410,7 @@ class CfnTrafficMirrorSession(
55392
55410
  "traffic_mirror_filter_id": "trafficMirrorFilterId",
55393
55411
  "traffic_mirror_target_id": "trafficMirrorTargetId",
55394
55412
  "description": "description",
55413
+ "owner_id": "ownerId",
55395
55414
  "packet_length": "packetLength",
55396
55415
  "tags": "tags",
55397
55416
  "virtual_network_id": "virtualNetworkId",
@@ -55406,6 +55425,7 @@ class CfnTrafficMirrorSessionProps:
55406
55425
  traffic_mirror_filter_id: builtins.str,
55407
55426
  traffic_mirror_target_id: builtins.str,
55408
55427
  description: typing.Optional[builtins.str] = None,
55428
+ owner_id: typing.Optional[builtins.str] = None,
55409
55429
  packet_length: typing.Optional[jsii.Number] = None,
55410
55430
  tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
55411
55431
  virtual_network_id: typing.Optional[jsii.Number] = None,
@@ -55417,6 +55437,7 @@ class CfnTrafficMirrorSessionProps:
55417
55437
  :param traffic_mirror_filter_id: The ID of the Traffic Mirror filter.
55418
55438
  :param traffic_mirror_target_id: The ID of the Traffic Mirror target.
55419
55439
  :param description: The description of the Traffic Mirror session.
55440
+ :param owner_id: The ID of the account that owns the Traffic Mirror session.
55420
55441
  :param packet_length: The number of bytes in each packet to mirror. These are bytes after the VXLAN header. Do not specify this parameter when you want to mirror the entire packet. To mirror a subset of the packet, set this to the length (in bytes) that you want to mirror. For example, if you set this value to 100, then the first 100 bytes that meet the filter criteria are copied to the target. If you do not want to mirror the entire packet, use the ``PacketLength`` parameter to specify the number of bytes in each packet to mirror. For sessions with Network Load Balancer (NLB) Traffic Mirror targets the default ``PacketLength`` will be set to 8500. Valid values are 1-8500. Setting a ``PacketLength`` greater than 8500 will result in an error response.
55421
55442
  :param tags: The tags to assign to a Traffic Mirror session.
55422
55443
  :param virtual_network_id: The VXLAN ID for the Traffic Mirror session. For more information about the VXLAN protocol, see `RFC 7348 <https://docs.aws.amazon.com/https://datatracker.ietf.org/doc/html/rfc7348>`_ . If you do not specify a ``VirtualNetworkId`` , an account-wide unique ID is chosen at random.
@@ -55438,6 +55459,7 @@ class CfnTrafficMirrorSessionProps:
55438
55459
 
55439
55460
  # the properties below are optional
55440
55461
  description="description",
55462
+ owner_id="ownerId",
55441
55463
  packet_length=123,
55442
55464
  tags=[CfnTag(
55443
55465
  key="key",
@@ -55453,6 +55475,7 @@ class CfnTrafficMirrorSessionProps:
55453
55475
  check_type(argname="argument traffic_mirror_filter_id", value=traffic_mirror_filter_id, expected_type=type_hints["traffic_mirror_filter_id"])
55454
55476
  check_type(argname="argument traffic_mirror_target_id", value=traffic_mirror_target_id, expected_type=type_hints["traffic_mirror_target_id"])
55455
55477
  check_type(argname="argument description", value=description, expected_type=type_hints["description"])
55478
+ check_type(argname="argument owner_id", value=owner_id, expected_type=type_hints["owner_id"])
55456
55479
  check_type(argname="argument packet_length", value=packet_length, expected_type=type_hints["packet_length"])
55457
55480
  check_type(argname="argument tags", value=tags, expected_type=type_hints["tags"])
55458
55481
  check_type(argname="argument virtual_network_id", value=virtual_network_id, expected_type=type_hints["virtual_network_id"])
@@ -55464,6 +55487,8 @@ class CfnTrafficMirrorSessionProps:
55464
55487
  }
55465
55488
  if description is not None:
55466
55489
  self._values["description"] = description
55490
+ if owner_id is not None:
55491
+ self._values["owner_id"] = owner_id
55467
55492
  if packet_length is not None:
55468
55493
  self._values["packet_length"] = packet_length
55469
55494
  if tags is not None:
@@ -55524,6 +55549,15 @@ class CfnTrafficMirrorSessionProps:
55524
55549
  result = self._values.get("description")
55525
55550
  return typing.cast(typing.Optional[builtins.str], result)
55526
55551
 
55552
+ @builtins.property
55553
+ def owner_id(self) -> typing.Optional[builtins.str]:
55554
+ '''The ID of the account that owns the Traffic Mirror session.
55555
+
55556
+ :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-trafficmirrorsession.html#cfn-ec2-trafficmirrorsession-ownerid
55557
+ '''
55558
+ result = self._values.get("owner_id")
55559
+ return typing.cast(typing.Optional[builtins.str], result)
55560
+
55527
55561
  @builtins.property
55528
55562
  def packet_length(self) -> typing.Optional[jsii.Number]:
55529
55563
  '''The number of bytes in each packet to mirror.
@@ -111673,6 +111707,7 @@ def _typecheckingstub__9e0df29e9de2cc6eed997cd0738e89aa6fc9bdffd0c700ef4584f2c9e
111673
111707
  traffic_mirror_filter_id: builtins.str,
111674
111708
  traffic_mirror_target_id: builtins.str,
111675
111709
  description: typing.Optional[builtins.str] = None,
111710
+ owner_id: typing.Optional[builtins.str] = None,
111676
111711
  packet_length: typing.Optional[jsii.Number] = None,
111677
111712
  tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
111678
111713
  virtual_network_id: typing.Optional[jsii.Number] = None,
@@ -111722,6 +111757,12 @@ def _typecheckingstub__4239210691e02d4eea905b9be001d8302bb77db3dde61743cea1aa5b6
111722
111757
  """Type checking stubs"""
111723
111758
  pass
111724
111759
 
111760
+ def _typecheckingstub__21588510c317dbb4d3f093aedb52504c662e37e8a686d1ea3651a49a04ed0e49(
111761
+ value: typing.Optional[builtins.str],
111762
+ ) -> None:
111763
+ """Type checking stubs"""
111764
+ pass
111765
+
111725
111766
  def _typecheckingstub__9aaf61851419d979865e5ff3ad332c3b90ca87f0fd776502a722e2ebe1429297(
111726
111767
  value: typing.Optional[jsii.Number],
111727
111768
  ) -> None:
@@ -111747,6 +111788,7 @@ def _typecheckingstub__410c9163482a74952290246bbd3c364855d8d943a582d683fbe831b27
111747
111788
  traffic_mirror_filter_id: builtins.str,
111748
111789
  traffic_mirror_target_id: builtins.str,
111749
111790
  description: typing.Optional[builtins.str] = None,
111791
+ owner_id: typing.Optional[builtins.str] = None,
111750
111792
  packet_length: typing.Optional[jsii.Number] = None,
111751
111793
  tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
111752
111794
  virtual_network_id: typing.Optional[jsii.Number] = None,
@@ -9239,11 +9239,14 @@ class CfnService(
9239
9239
  role_arn: typing.Optional[builtins.str] = None,
9240
9240
  test_listener_rule: typing.Optional[builtins.str] = None,
9241
9241
  ) -> None:
9242
- '''
9243
- :param alternate_target_group_arn:
9244
- :param production_listener_rule:
9245
- :param role_arn:
9246
- :param test_listener_rule:
9242
+ '''The advanced settings for a load balancer used in blue/green deployments.
9243
+
9244
+ Specify the alternate target group, listener rules, and IAM role required for traffic shifting during blue/green deployments. For more information, see `Required resources for Amazon ECS blue/green deployments <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/blue-green-deployment-implementation.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
9245
+
9246
+ :param alternate_target_group_arn: The Amazon Resource Name (ARN) of the alternate target group for Amazon ECS blue/green deployments.
9247
+ :param production_listener_rule: The Amazon Resource Name (ARN) that that identifies the production listener rule (in the case of an Application Load Balancer) or listener (in the case for an Network Load Balancer) for routing production traffic.
9248
+ :param role_arn: The Amazon Resource Name (ARN) of the IAM role that grants Amazon ECS permission to call the Elastic Load Balancing APIs for you.
9249
+ :param test_listener_rule: The Amazon Resource Name (ARN) that identifies ) that identifies the test listener rule (in the case of an Application Load Balancer) or listener (in the case for an Network Load Balancer) for routing test traffic.
9247
9250
 
9248
9251
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-service-advancedconfiguration.html
9249
9252
  :exampleMetadata: fixture=_generated
@@ -9281,7 +9284,8 @@ class CfnService(
9281
9284
 
9282
9285
  @builtins.property
9283
9286
  def alternate_target_group_arn(self) -> builtins.str:
9284
- '''
9287
+ '''The Amazon Resource Name (ARN) of the alternate target group for Amazon ECS blue/green deployments.
9288
+
9285
9289
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-service-advancedconfiguration.html#cfn-ecs-service-advancedconfiguration-alternatetargetgrouparn
9286
9290
  '''
9287
9291
  result = self._values.get("alternate_target_group_arn")
@@ -9290,7 +9294,8 @@ class CfnService(
9290
9294
 
9291
9295
  @builtins.property
9292
9296
  def production_listener_rule(self) -> typing.Optional[builtins.str]:
9293
- '''
9297
+ '''The Amazon Resource Name (ARN) that that identifies the production listener rule (in the case of an Application Load Balancer) or listener (in the case for an Network Load Balancer) for routing production traffic.
9298
+
9294
9299
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-service-advancedconfiguration.html#cfn-ecs-service-advancedconfiguration-productionlistenerrule
9295
9300
  '''
9296
9301
  result = self._values.get("production_listener_rule")
@@ -9298,7 +9303,8 @@ class CfnService(
9298
9303
 
9299
9304
  @builtins.property
9300
9305
  def role_arn(self) -> typing.Optional[builtins.str]:
9301
- '''
9306
+ '''The Amazon Resource Name (ARN) of the IAM role that grants Amazon ECS permission to call the Elastic Load Balancing APIs for you.
9307
+
9302
9308
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-service-advancedconfiguration.html#cfn-ecs-service-advancedconfiguration-rolearn
9303
9309
  '''
9304
9310
  result = self._values.get("role_arn")
@@ -9306,7 +9312,8 @@ class CfnService(
9306
9312
 
9307
9313
  @builtins.property
9308
9314
  def test_listener_rule(self) -> typing.Optional[builtins.str]:
9309
- '''
9315
+ '''The Amazon Resource Name (ARN) that identifies ) that identifies the test listener rule (in the case of an Application Load Balancer) or listener (in the case for an Network Load Balancer) for routing test traffic.
9316
+
9310
9317
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-service-advancedconfiguration.html#cfn-ecs-service-advancedconfiguration-testlistenerrule
9311
9318
  '''
9312
9319
  result = self._values.get("test_listener_rule")
@@ -9741,12 +9748,12 @@ class CfnService(
9741
9748
  '''Optional deployment parameters that control how many tasks run during a deployment and the ordering of stopping and starting tasks.
9742
9749
 
9743
9750
  :param alarms: Information about the CloudWatch alarms.
9744
- :param bake_time_in_minutes:
9751
+ :param bake_time_in_minutes: The duration when both blue and green service revisions are running simultaneously after the production traffic has shifted. The following rules apply when you don't specify a value: - For rolling deployments, the value is set to 3 hours (180 minutes). - When you use an external deployment controller ( ``EXTERNAL`` ), or the CodeDeploy blue/green deployment controller ( ``CODE_DEPLOY`` ), the value is set to 3 hours (180 minutes). - For all other cases, the value is set to 36 hours (2160 minutes).
9745
9752
  :param deployment_circuit_breaker: .. epigraph:: The deployment circuit breaker can only be used for services using the rolling update ( ``ECS`` ) deployment type. The *deployment circuit breaker* determines whether a service deployment will fail if the service can't reach a steady state. If you use the deployment circuit breaker, a service deployment will transition to a failed state and stop launching new tasks. If you use the rollback option, when a service deployment fails, the service is rolled back to the last deployment that completed successfully. For more information, see `Rolling update <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-type-ecs.html>`_ in the *Amazon Elastic Container Service Developer Guide*
9746
- :param lifecycle_hooks:
9753
+ :param lifecycle_hooks: An array of deployment lifecycle hook objects to run custom logic at specific stages of the deployment lifecycle.
9747
9754
  :param maximum_percent: If a service is using the rolling update ( ``ECS`` ) deployment type, the ``maximumPercent`` parameter represents an upper limit on the number of your service's tasks that are allowed in the ``RUNNING`` or ``PENDING`` state during a deployment, as a percentage of the ``desiredCount`` (rounded down to the nearest integer). This parameter enables you to define the deployment batch size. For example, if your service is using the ``REPLICA`` service scheduler and has a ``desiredCount`` of four tasks and a ``maximumPercent`` value of 200%, the scheduler may start four new tasks before stopping the four older tasks (provided that the cluster resources required to do this are available). The default ``maximumPercent`` value for a service using the ``REPLICA`` service scheduler is 200%. The Amazon ECS scheduler uses this parameter to replace unhealthy tasks by starting replacement tasks first and then stopping the unhealthy tasks, as long as cluster resources for starting replacement tasks are available. For more information about how the scheduler replaces unhealthy tasks, see `Amazon ECS services <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs_services.html>`_ . If a service is using either the blue/green ( ``CODE_DEPLOY`` ) or ``EXTERNAL`` deployment types, and tasks in the service use the EC2 launch type, the *maximum percent* value is set to the default value. The *maximum percent* value is used to define the upper limit on the number of the tasks in the service that remain in the ``RUNNING`` state while the container instances are in the ``DRAINING`` state. .. epigraph:: You can't specify a custom ``maximumPercent`` value for a service that uses either the blue/green ( ``CODE_DEPLOY`` ) or ``EXTERNAL`` deployment types and has tasks that use the EC2 launch type. If the service uses either the blue/green ( ``CODE_DEPLOY`` ) or ``EXTERNAL`` deployment types, and the tasks in the service use the Fargate launch type, the maximum percent value is not used. The value is still returned when describing your service.
9748
9755
  :param minimum_healthy_percent: If a service is using the rolling update ( ``ECS`` ) deployment type, the ``minimumHealthyPercent`` represents a lower limit on the number of your service's tasks that must remain in the ``RUNNING`` state during a deployment, as a percentage of the ``desiredCount`` (rounded up to the nearest integer). This parameter enables you to deploy without using additional cluster capacity. For example, if your service has a ``desiredCount`` of four tasks and a ``minimumHealthyPercent`` of 50%, the service scheduler may stop two existing tasks to free up cluster capacity before starting two new tasks. If any tasks are unhealthy and if ``maximumPercent`` doesn't allow the Amazon ECS scheduler to start replacement tasks, the scheduler stops the unhealthy tasks one-by-one — using the ``minimumHealthyPercent`` as a constraint — to clear up capacity to launch replacement tasks. For more information about how the scheduler replaces unhealthy tasks, see `Amazon ECS services <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs_services.html>`_ . For services that *do not* use a load balancer, the following should be noted: - A service is considered healthy if all essential containers within the tasks in the service pass their health checks. - If a task has no essential containers with a health check defined, the service scheduler will wait for 40 seconds after a task reaches a ``RUNNING`` state before the task is counted towards the minimum healthy percent total. - If a task has one or more essential containers with a health check defined, the service scheduler will wait for the task to reach a healthy status before counting it towards the minimum healthy percent total. A task is considered healthy when all essential containers within the task have passed their health checks. The amount of time the service scheduler can wait for is determined by the container health check settings. For services that *do* use a load balancer, the following should be noted: - If a task has no essential containers with a health check defined, the service scheduler will wait for the load balancer target group health check to return a healthy status before counting the task towards the minimum healthy percent total. - If a task has an essential container with a health check defined, the service scheduler will wait for both the task to reach a healthy status and the load balancer target group health check to return a healthy status before counting the task towards the minimum healthy percent total. The default value for a replica service for ``minimumHealthyPercent`` is 100%. The default ``minimumHealthyPercent`` value for a service using the ``DAEMON`` service schedule is 0% for the AWS CLI , the AWS SDKs, and the APIs and 50% for the AWS Management Console. The minimum number of healthy tasks during a deployment is the ``desiredCount`` multiplied by the ``minimumHealthyPercent`` /100, rounded up to the nearest integer value. If a service is using either the blue/green ( ``CODE_DEPLOY`` ) or ``EXTERNAL`` deployment types and is running tasks that use the EC2 launch type, the *minimum healthy percent* value is set to the default value. The *minimum healthy percent* value is used to define the lower limit on the number of the tasks in the service that remain in the ``RUNNING`` state while the container instances are in the ``DRAINING`` state. .. epigraph:: You can't specify a custom ``minimumHealthyPercent`` value for a service that uses either the blue/green ( ``CODE_DEPLOY`` ) or ``EXTERNAL`` deployment types and has tasks that use the EC2 launch type. If a service is using either the blue/green ( ``CODE_DEPLOY`` ) or ``EXTERNAL`` deployment types and is running tasks that use the Fargate launch type, the minimum healthy percent value is not used, although it is returned when describing your service.
9749
- :param strategy:
9756
+ :param strategy: The deployment strategy for the service. Choose from these valid values:. - ``ROLLING`` - When you create a service which uses the rolling update ( ``ROLLING`` ) deployment strategy, the Amazon ECS service scheduler replaces the currently running tasks with new tasks. The number of tasks that Amazon ECS adds or removes from the service during a rolling update is controlled by the service deployment configuration. - ``BLUE_GREEN`` - A blue/green deployment strategy ( ``BLUE_GREEN`` ) is a release methodology that reduces downtime and risk by running two identical production environments called blue and green. With Amazon ECS blue/green deployments, you can validate new service revisions before directing production traffic to them. This approach provides a safer way to deploy changes with the ability to quickly roll back if needed.
9750
9757
 
9751
9758
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-service-deploymentconfiguration.html
9752
9759
  :exampleMetadata: fixture=_generated
@@ -9816,7 +9823,14 @@ class CfnService(
9816
9823
 
9817
9824
  @builtins.property
9818
9825
  def bake_time_in_minutes(self) -> typing.Optional[jsii.Number]:
9819
- '''
9826
+ '''The duration when both blue and green service revisions are running simultaneously after the production traffic has shifted.
9827
+
9828
+ The following rules apply when you don't specify a value:
9829
+
9830
+ - For rolling deployments, the value is set to 3 hours (180 minutes).
9831
+ - When you use an external deployment controller ( ``EXTERNAL`` ), or the CodeDeploy blue/green deployment controller ( ``CODE_DEPLOY`` ), the value is set to 3 hours (180 minutes).
9832
+ - For all other cases, the value is set to 36 hours (2160 minutes).
9833
+
9820
9834
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-service-deploymentconfiguration.html#cfn-ecs-service-deploymentconfiguration-baketimeinminutes
9821
9835
  '''
9822
9836
  result = self._values.get("bake_time_in_minutes")
@@ -9841,7 +9855,8 @@ class CfnService(
9841
9855
  def lifecycle_hooks(
9842
9856
  self,
9843
9857
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnService.DeploymentLifecycleHookProperty"]]]]:
9844
- '''
9858
+ '''An array of deployment lifecycle hook objects to run custom logic at specific stages of the deployment lifecycle.
9859
+
9845
9860
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-service-deploymentconfiguration.html#cfn-ecs-service-deploymentconfiguration-lifecyclehooks
9846
9861
  '''
9847
9862
  result = self._values.get("lifecycle_hooks")
@@ -9904,7 +9919,11 @@ class CfnService(
9904
9919
 
9905
9920
  @builtins.property
9906
9921
  def strategy(self) -> typing.Optional[builtins.str]:
9907
- '''
9922
+ '''The deployment strategy for the service. Choose from these valid values:.
9923
+
9924
+ - ``ROLLING`` - When you create a service which uses the rolling update ( ``ROLLING`` ) deployment strategy, the Amazon ECS service scheduler replaces the currently running tasks with new tasks. The number of tasks that Amazon ECS adds or removes from the service during a rolling update is controlled by the service deployment configuration.
9925
+ - ``BLUE_GREEN`` - A blue/green deployment strategy ( ``BLUE_GREEN`` ) is a release methodology that reduces downtime and risk by running two identical production environments called blue and green. With Amazon ECS blue/green deployments, you can validate new service revisions before directing production traffic to them. This approach provides a safer way to deploy changes with the ability to quickly roll back if needed.
9926
+
9908
9927
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-service-deploymentconfiguration.html#cfn-ecs-service-deploymentconfiguration-strategy
9909
9928
  '''
9910
9929
  result = self._values.get("strategy")
@@ -10035,10 +10054,15 @@ class CfnService(
10035
10054
  lifecycle_stages: typing.Sequence[builtins.str],
10036
10055
  role_arn: builtins.str,
10037
10056
  ) -> None:
10038
- '''
10039
- :param hook_target_arn:
10040
- :param lifecycle_stages:
10041
- :param role_arn:
10057
+ '''A deployment lifecycle hook runs custom logic at specific stages of the deployment process.
10058
+
10059
+ Currently, you can use Lambda functions as hook targets.
10060
+
10061
+ For more information, see `Lifecycle hooks for Amazon ECS service deployments <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-lifecycle-hooks.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
10062
+
10063
+ :param hook_target_arn: The Amazon Resource Name (ARN) of the hook target. Currently, only Lambda function ARNs are supported. You must provide this parameter when configuring a deployment lifecycle hook.
10064
+ :param lifecycle_stages: The lifecycle stages at which to run the hook. Choose from these valid values:. - RECONCILE_SERVICE The reconciliation stage that only happens when you start a new service deployment with more than 1 service revision in an ACTIVE state. You can use a lifecycle hook for this stage. - PRE_SCALE_UP The green service revision has not started. The blue service revision is handling 100% of the production traffic. There is no test traffic. You can use a lifecycle hook for this stage. - POST_SCALE_UP The green service revision has started. The blue service revision is handling 100% of the production traffic. There is no test traffic. You can use a lifecycle hook for this stage. - TEST_TRAFFIC_SHIFT The blue and green service revisions are running. The blue service revision handles 100% of the production traffic. The green service revision is migrating from 0% to 100% of test traffic. You can use a lifecycle hook for this stage. - POST_TEST_TRAFFIC_SHIFT The test traffic shift is complete. The green service revision handles 100% of the test traffic. You can use a lifecycle hook for this stage. - PRODUCTION_TRAFFIC_SHIFT Production traffic is shifting to the green service revision. The green service revision is migrating from 0% to 100% of production traffic. You can use a lifecycle hook for this stage. - POST_PRODUCTION_TRAFFIC_SHIFT The production traffic shift is complete. You can use a lifecycle hook for this stage. You must provide this parameter when configuring a deployment lifecycle hook.
10065
+ :param role_arn: The Amazon Resource Name (ARN) of the IAM role that grants Amazon ECS permission to call Lambda functions on your behalf. For more information, see `Permissions required for Lambda functions in Amazon ECS blue/green deployments <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/blue-green-permissions.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
10042
10066
 
10043
10067
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-service-deploymentlifecyclehook.html
10044
10068
  :exampleMetadata: fixture=_generated
@@ -10068,7 +10092,10 @@ class CfnService(
10068
10092
 
10069
10093
  @builtins.property
10070
10094
  def hook_target_arn(self) -> builtins.str:
10071
- '''
10095
+ '''The Amazon Resource Name (ARN) of the hook target. Currently, only Lambda function ARNs are supported.
10096
+
10097
+ You must provide this parameter when configuring a deployment lifecycle hook.
10098
+
10072
10099
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-service-deploymentlifecyclehook.html#cfn-ecs-service-deploymentlifecyclehook-hooktargetarn
10073
10100
  '''
10074
10101
  result = self._values.get("hook_target_arn")
@@ -10077,7 +10104,52 @@ class CfnService(
10077
10104
 
10078
10105
  @builtins.property
10079
10106
  def lifecycle_stages(self) -> typing.List[builtins.str]:
10080
- '''
10107
+ '''The lifecycle stages at which to run the hook. Choose from these valid values:.
10108
+
10109
+ - RECONCILE_SERVICE
10110
+
10111
+ The reconciliation stage that only happens when you start a new service deployment with more than 1 service revision in an ACTIVE state.
10112
+
10113
+ You can use a lifecycle hook for this stage.
10114
+
10115
+ - PRE_SCALE_UP
10116
+
10117
+ The green service revision has not started. The blue service revision is handling 100% of the production traffic. There is no test traffic.
10118
+
10119
+ You can use a lifecycle hook for this stage.
10120
+
10121
+ - POST_SCALE_UP
10122
+
10123
+ The green service revision has started. The blue service revision is handling 100% of the production traffic. There is no test traffic.
10124
+
10125
+ You can use a lifecycle hook for this stage.
10126
+
10127
+ - TEST_TRAFFIC_SHIFT
10128
+
10129
+ The blue and green service revisions are running. The blue service revision handles 100% of the production traffic. The green service revision is migrating from 0% to 100% of test traffic.
10130
+
10131
+ You can use a lifecycle hook for this stage.
10132
+
10133
+ - POST_TEST_TRAFFIC_SHIFT
10134
+
10135
+ The test traffic shift is complete. The green service revision handles 100% of the test traffic.
10136
+
10137
+ You can use a lifecycle hook for this stage.
10138
+
10139
+ - PRODUCTION_TRAFFIC_SHIFT
10140
+
10141
+ Production traffic is shifting to the green service revision. The green service revision is migrating from 0% to 100% of production traffic.
10142
+
10143
+ You can use a lifecycle hook for this stage.
10144
+
10145
+ - POST_PRODUCTION_TRAFFIC_SHIFT
10146
+
10147
+ The production traffic shift is complete.
10148
+
10149
+ You can use a lifecycle hook for this stage.
10150
+
10151
+ You must provide this parameter when configuring a deployment lifecycle hook.
10152
+
10081
10153
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-service-deploymentlifecyclehook.html#cfn-ecs-service-deploymentlifecyclehook-lifecyclestages
10082
10154
  '''
10083
10155
  result = self._values.get("lifecycle_stages")
@@ -10086,7 +10158,10 @@ class CfnService(
10086
10158
 
10087
10159
  @builtins.property
10088
10160
  def role_arn(self) -> builtins.str:
10089
- '''
10161
+ '''The Amazon Resource Name (ARN) of the IAM role that grants Amazon ECS permission to call Lambda functions on your behalf.
10162
+
10163
+ For more information, see `Permissions required for Lambda functions in Amazon ECS blue/green deployments <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/blue-green-permissions.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
10164
+
10090
10165
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-service-deploymentlifecyclehook.html#cfn-ecs-service-deploymentlifecyclehook-rolearn
10091
10166
  '''
10092
10167
  result = self._values.get("role_arn")
@@ -10230,7 +10305,7 @@ class CfnService(
10230
10305
 
10231
10306
  Services with tasks that use the ``awsvpc`` network mode (for example, those with the Fargate launch type) only support Application Load Balancers and Network Load Balancers. Classic Load Balancers are not supported. Also, when you create any target groups for these services, you must choose ``ip`` as the target type, not ``instance`` . Tasks that use the ``awsvpc`` network mode are associated with an elastic network interface, not an Amazon EC2 instance.
10232
10307
 
10233
- :param advanced_configuration:
10308
+ :param advanced_configuration: The advanced settings for the load balancer used in blue/green deployments. Specify the alternate target group, listener rules, and IAM role required for traffic shifting during blue/green deployments.
10234
10309
  :param container_name: The name of the container (as it appears in a container definition) to associate with the load balancer. You need to specify the container name when configuring the target group for an Amazon ECS load balancer.
10235
10310
  :param container_port: The port on the container to associate with the load balancer. This port must correspond to a ``containerPort`` in the task definition the tasks in the service are using. For tasks that use the EC2 launch type, the container instance they're launched on must allow ingress traffic on the ``hostPort`` of the port mapping.
10236
10311
  :param load_balancer_name: The name of the load balancer to associate with the Amazon ECS service or task set. If you are using an Application Load Balancer or a Network Load Balancer the load balancer name parameter should be omitted.
@@ -10283,7 +10358,10 @@ class CfnService(
10283
10358
  def advanced_configuration(
10284
10359
  self,
10285
10360
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnService.AdvancedConfigurationProperty"]]:
10286
- '''
10361
+ '''The advanced settings for the load balancer used in blue/green deployments.
10362
+
10363
+ Specify the alternate target group, listener rules, and IAM role required for traffic shifting during blue/green deployments.
10364
+
10287
10365
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-service-loadbalancer.html#cfn-ecs-service-loadbalancer-advancedconfiguration
10288
10366
  '''
10289
10367
  result = self._values.get("advanced_configuration")
@@ -10902,7 +10980,7 @@ class CfnService(
10902
10980
 
10903
10981
  :param port: The listening port number for the Service Connect proxy. This port is available inside of all of the tasks within the same namespace. To avoid changing your applications in client Amazon ECS services, set this to the same port that the client application uses by default. 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* .
10904
10982
  :param dns_name: The ``dnsName`` is the name that you use in the applications of client tasks to connect to this service. The name must be a valid DNS name but doesn't need to be fully-qualified. The name can include up to 127 characters. The name can include lowercase letters, numbers, underscores (_), hyphens (-), and periods (.). The name can't start with a hyphen. If this parameter isn't specified, the default value of ``discoveryName.namespace`` is used. If the ``discoveryName`` isn't specified, the port mapping name from the task definition is used in ``portName.namespace`` . To avoid changing your applications in client Amazon ECS services, set this to the same name that the client application uses by default. For example, a few common names are ``database`` , ``db`` , or the lowercase name of a database, such as ``mysql`` or ``redis`` . 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* .
10905
- :param test_traffic_rules:
10983
+ :param test_traffic_rules: The configuration for test traffic routing rules used during blue/green deployments with Amazon ECS Service Connect. This allows you to route a portion of traffic to the new service revision of your service for testing before shifting all production traffic.
10906
10984
 
10907
10985
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-service-serviceconnectclientalias.html
10908
10986
  :exampleMetadata: fixture=_generated
@@ -10976,7 +11054,10 @@ class CfnService(
10976
11054
  def test_traffic_rules(
10977
11055
  self,
10978
11056
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnService.ServiceConnectTestTrafficRulesProperty"]]:
10979
- '''
11057
+ '''The configuration for test traffic routing rules used during blue/green deployments with Amazon ECS Service Connect.
11058
+
11059
+ This allows you to route a portion of traffic to the new service revision of your service for testing before shifting all production traffic.
11060
+
10980
11061
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-service-serviceconnectclientalias.html#cfn-ecs-service-serviceconnectclientalias-testtrafficrules
10981
11062
  '''
10982
11063
  result = self._values.get("test_traffic_rules")
@@ -11502,8 +11583,13 @@ class CfnService(
11502
11583
  *,
11503
11584
  header: typing.Union[_IResolvable_da3f097b, typing.Union["CfnService.ServiceConnectTestTrafficRulesHeaderProperty", typing.Dict[builtins.str, typing.Any]]],
11504
11585
  ) -> None:
11505
- '''
11506
- :param header:
11586
+ '''The test traffic routing configuration for Amazon ECS blue/green deployments.
11587
+
11588
+ This configuration allows you to define rules for routing specific traffic to the new service revision during the deployment process, allowing for safe testing before full production traffic shift.
11589
+
11590
+ For more information, see `Service Connect for Amazon ECS blue/green deployments <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect-blue-green.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
11591
+
11592
+ :param header: The HTTP header-based routing rules that determine which requests should be routed to the new service version during blue/green deployment testing. These rules provide fine-grained control over test traffic routing based on request headers.
11507
11593
 
11508
11594
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-service-serviceconnecttesttrafficrules.html
11509
11595
  :exampleMetadata: fixture=_generated
@@ -11536,7 +11622,10 @@ class CfnService(
11536
11622
  def header(
11537
11623
  self,
11538
11624
  ) -> typing.Union[_IResolvable_da3f097b, "CfnService.ServiceConnectTestTrafficRulesHeaderProperty"]:
11539
- '''
11625
+ '''The HTTP header-based routing rules that determine which requests should be routed to the new service version during blue/green deployment testing.
11626
+
11627
+ These rules provide fine-grained control over test traffic routing based on request headers.
11628
+
11540
11629
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-service-serviceconnecttesttrafficrules.html#cfn-ecs-service-serviceconnecttesttrafficrules-header
11541
11630
  '''
11542
11631
  result = self._values.get("header")