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.
- aws_cdk/_jsii/__init__.py +1 -1
- aws_cdk/_jsii/{aws-cdk-lib@2.207.0.jsii.tgz → aws-cdk-lib@2.208.0.jsii.tgz} +0 -0
- aws_cdk/aws_aiops/__init__.py +16 -12
- aws_cdk/aws_amazonmq/__init__.py +8 -18
- aws_cdk/aws_appstream/__init__.py +36 -4
- aws_cdk/aws_bedrock/__init__.py +191 -72
- aws_cdk/aws_certificatemanager/__init__.py +45 -0
- aws_cdk/aws_cloudfront/__init__.py +12 -2
- aws_cdk/aws_connect/__init__.py +107 -3
- aws_cdk/aws_customerprofiles/__init__.py +27 -22
- aws_cdk/aws_docdb/__init__.py +5 -3
- aws_cdk/aws_ec2/__init__.py +53 -11
- aws_cdk/aws_ecs/__init__.py +118 -29
- aws_cdk/aws_events/__init__.py +142 -0
- aws_cdk/aws_gamelift/__init__.py +2 -2
- aws_cdk/aws_guardduty/__init__.py +86 -0
- aws_cdk/aws_kinesisfirehose/__init__.py +377 -4
- aws_cdk/aws_logs/__init__.py +53 -4
- aws_cdk/aws_mediapackagev2/__init__.py +881 -0
- aws_cdk/aws_omics/__init__.py +13 -10
- aws_cdk/aws_quicksight/__init__.py +111 -4
- aws_cdk/aws_rds/__init__.py +208 -10
- aws_cdk/aws_s3/__init__.py +775 -5
- aws_cdk/aws_s3express/__init__.py +61 -3
- aws_cdk/aws_s3tables/__init__.py +254 -0
- aws_cdk/aws_sagemaker/__init__.py +524 -137
- aws_cdk/aws_ssm/__init__.py +48 -0
- aws_cdk/aws_transfer/__init__.py +49 -0
- aws_cdk/aws_wisdom/__init__.py +1185 -100
- {aws_cdk_lib-2.207.0.dist-info → aws_cdk_lib-2.208.0.dist-info}/METADATA +2 -2
- {aws_cdk_lib-2.207.0.dist-info → aws_cdk_lib-2.208.0.dist-info}/RECORD +35 -35
- {aws_cdk_lib-2.207.0.dist-info → aws_cdk_lib-2.208.0.dist-info}/LICENSE +0 -0
- {aws_cdk_lib-2.207.0.dist-info → aws_cdk_lib-2.208.0.dist-info}/NOTICE +0 -0
- {aws_cdk_lib-2.207.0.dist-info → aws_cdk_lib-2.208.0.dist-info}/WHEEL +0 -0
- {aws_cdk_lib-2.207.0.dist-info → aws_cdk_lib-2.208.0.dist-info}/top_level.txt +0 -0
aws_cdk/aws_ec2/__init__.py
CHANGED
|
@@ -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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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.
|
|
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
|
-
|
|
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.
|
|
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.
|
|
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,
|
aws_cdk/aws_ecs/__init__.py
CHANGED
|
@@ -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
|
-
|
|
9244
|
-
|
|
9245
|
-
|
|
9246
|
-
:param
|
|
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
|
-
|
|
10040
|
-
|
|
10041
|
-
|
|
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
|
-
|
|
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")
|