aws-cdk-lib 2.149.0__py3-none-any.whl → 2.150.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/__init__.py +4 -8
- aws_cdk/_jsii/__init__.py +1 -1
- aws_cdk/_jsii/{aws-cdk-lib@2.149.0.jsii.tgz → aws-cdk-lib@2.150.0.jsii.tgz} +0 -0
- aws_cdk/aws_bedrock/__init__.py +30 -26
- aws_cdk/aws_cloudformation/__init__.py +4 -8
- aws_cdk/aws_cloudtrail/__init__.py +30 -558
- aws_cdk/aws_cloudwatch/__init__.py +1 -1
- aws_cdk/aws_codepipeline/__init__.py +11 -5
- aws_cdk/aws_cognito/__init__.py +1 -2
- aws_cdk/aws_ec2/__init__.py +82 -4
- aws_cdk/aws_ecs/__init__.py +10 -8
- aws_cdk/aws_eks/__init__.py +26 -20
- aws_cdk/aws_elasticloadbalancingv2/__init__.py +2 -2
- aws_cdk/aws_emr/__init__.py +18 -20
- aws_cdk/aws_fsx/__init__.py +25 -23
- aws_cdk/aws_glue/__init__.py +3 -3
- aws_cdk/aws_guardduty/__init__.py +6 -4
- aws_cdk/aws_iam/__init__.py +8 -5
- aws_cdk/aws_lambda/__init__.py +19 -2
- aws_cdk/aws_logs/__init__.py +9 -0
- aws_cdk/aws_qbusiness/__init__.py +21 -7
- aws_cdk/aws_rds/__init__.py +15 -9
- aws_cdk/aws_sagemaker/__init__.py +10 -10
- aws_cdk/aws_stepfunctions_tasks/__init__.py +6 -8
- aws_cdk/aws_synthetics/__init__.py +15 -1
- aws_cdk/custom_resources/__init__.py +91 -23
- aws_cdk/pipelines/__init__.py +1 -1
- aws_cdk/region_info/__init__.py +32 -12
- {aws_cdk_lib-2.149.0.dist-info → aws_cdk_lib-2.150.0.dist-info}/METADATA +1 -1
- {aws_cdk_lib-2.149.0.dist-info → aws_cdk_lib-2.150.0.dist-info}/RECORD +34 -34
- {aws_cdk_lib-2.149.0.dist-info → aws_cdk_lib-2.150.0.dist-info}/LICENSE +0 -0
- {aws_cdk_lib-2.149.0.dist-info → aws_cdk_lib-2.150.0.dist-info}/NOTICE +0 -0
- {aws_cdk_lib-2.149.0.dist-info → aws_cdk_lib-2.150.0.dist-info}/WHEEL +0 -0
- {aws_cdk_lib-2.149.0.dist-info → aws_cdk_lib-2.150.0.dist-info}/top_level.txt +0 -0
|
@@ -14799,7 +14799,7 @@ class Alarm(
|
|
|
14799
14799
|
def add_alarm_action(self, *actions: IAlarmAction) -> None:
|
|
14800
14800
|
'''Trigger this action if the alarm fires.
|
|
14801
14801
|
|
|
14802
|
-
Typically
|
|
14802
|
+
Typically SnsAction or AutoScalingAction.
|
|
14803
14803
|
|
|
14804
14804
|
:param actions: -
|
|
14805
14805
|
'''
|
|
@@ -5139,7 +5139,7 @@ class CfnWebhook(
|
|
|
5139
5139
|
'''
|
|
5140
5140
|
:param scope: Scope in which this resource is defined.
|
|
5141
5141
|
:param id: Construct identifier for this resource (unique in its scope).
|
|
5142
|
-
:param authentication: Supported options are GITHUB_HMAC, IP, and UNAUTHENTICATED. - For information about the authentication scheme implemented by GITHUB_HMAC, see `Securing your webhooks <https://docs.aws.amazon.com/https://developer.github.com/webhooks/securing/>`_ on the GitHub Developer website. - IP rejects webhooks trigger requests unless they originate from an IP address in the IP range whitelisted in the authentication configuration. - UNAUTHENTICATED accepts all webhook trigger requests regardless of origin.
|
|
5142
|
+
:param authentication: Supported options are GITHUB_HMAC, IP, and UNAUTHENTICATED. .. epigraph:: When creating CodePipeline webhooks, do not use your own credentials or reuse the same secret token across multiple webhooks. For optimal security, generate a unique secret token for each webhook you create. The secret token is an arbitrary string that you provide, which GitHub uses to compute and sign the webhook payloads sent to CodePipeline, for protecting the integrity and authenticity of the webhook payloads. Using your own credentials or reusing the same token across multiple webhooks can lead to security vulnerabilities. - For information about the authentication scheme implemented by GITHUB_HMAC, see `Securing your webhooks <https://docs.aws.amazon.com/https://developer.github.com/webhooks/securing/>`_ on the GitHub Developer website. - IP rejects webhooks trigger requests unless they originate from an IP address in the IP range whitelisted in the authentication configuration. - UNAUTHENTICATED accepts all webhook trigger requests regardless of origin.
|
|
5143
5143
|
:param authentication_configuration: Properties that configure the authentication applied to incoming webhook trigger requests. The required properties depend on the authentication type. For GITHUB_HMAC, only the ``SecretToken`` property must be set. For IP, only the ``AllowedIPRange`` property must be set to a valid CIDR range. For UNAUTHENTICATED, no properties can be set.
|
|
5144
5144
|
:param filters: A list of rules applied to the body/payload sent in the POST request to a webhook URL. All defined rules must pass for the request to be accepted and the pipeline started.
|
|
5145
5145
|
:param target_action: The name of the action in a pipeline you want to connect to the webhook. The action must be from the source (first) stage of the pipeline.
|
|
@@ -5354,7 +5354,7 @@ class CfnWebhook(
|
|
|
5354
5354
|
'''The authentication applied to incoming webhook trigger requests.
|
|
5355
5355
|
|
|
5356
5356
|
:param allowed_ip_range: The property used to configure acceptance of webhooks in an IP address range. For IP, only the ``AllowedIPRange`` property must be set. This property must be set to a valid CIDR range.
|
|
5357
|
-
:param secret_token: The property used to configure GitHub authentication. For GITHUB_HMAC, only the ``SecretToken`` property must be set.
|
|
5357
|
+
:param secret_token: The property used to configure GitHub authentication. For GITHUB_HMAC, only the ``SecretToken`` property must be set. .. epigraph:: When creating CodePipeline webhooks, do not use your own credentials or reuse the same secret token across multiple webhooks. For optimal security, generate a unique secret token for each webhook you create. The secret token is an arbitrary string that you provide, which GitHub uses to compute and sign the webhook payloads sent to CodePipeline, for protecting the integrity and authenticity of the webhook payloads. Using your own credentials or reusing the same token across multiple webhooks can lead to security vulnerabilities.
|
|
5358
5358
|
|
|
5359
5359
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-codepipeline-webhook-webhookauthconfiguration.html
|
|
5360
5360
|
:exampleMetadata: fixture=_generated
|
|
@@ -5393,9 +5393,11 @@ class CfnWebhook(
|
|
|
5393
5393
|
|
|
5394
5394
|
@builtins.property
|
|
5395
5395
|
def secret_token(self) -> typing.Optional[builtins.str]:
|
|
5396
|
-
'''The property used to configure GitHub authentication.
|
|
5396
|
+
'''The property used to configure GitHub authentication. For GITHUB_HMAC, only the ``SecretToken`` property must be set.
|
|
5397
5397
|
|
|
5398
|
-
|
|
5398
|
+
.. epigraph::
|
|
5399
|
+
|
|
5400
|
+
When creating CodePipeline webhooks, do not use your own credentials or reuse the same secret token across multiple webhooks. For optimal security, generate a unique secret token for each webhook you create. The secret token is an arbitrary string that you provide, which GitHub uses to compute and sign the webhook payloads sent to CodePipeline, for protecting the integrity and authenticity of the webhook payloads. Using your own credentials or reusing the same token across multiple webhooks can lead to security vulnerabilities.
|
|
5399
5401
|
|
|
5400
5402
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-codepipeline-webhook-webhookauthconfiguration.html#cfn-codepipeline-webhook-webhookauthconfiguration-secrettoken
|
|
5401
5403
|
'''
|
|
@@ -5520,7 +5522,7 @@ class CfnWebhookProps:
|
|
|
5520
5522
|
) -> None:
|
|
5521
5523
|
'''Properties for defining a ``CfnWebhook``.
|
|
5522
5524
|
|
|
5523
|
-
:param authentication: Supported options are GITHUB_HMAC, IP, and UNAUTHENTICATED. - For information about the authentication scheme implemented by GITHUB_HMAC, see `Securing your webhooks <https://docs.aws.amazon.com/https://developer.github.com/webhooks/securing/>`_ on the GitHub Developer website. - IP rejects webhooks trigger requests unless they originate from an IP address in the IP range whitelisted in the authentication configuration. - UNAUTHENTICATED accepts all webhook trigger requests regardless of origin.
|
|
5525
|
+
:param authentication: Supported options are GITHUB_HMAC, IP, and UNAUTHENTICATED. .. epigraph:: When creating CodePipeline webhooks, do not use your own credentials or reuse the same secret token across multiple webhooks. For optimal security, generate a unique secret token for each webhook you create. The secret token is an arbitrary string that you provide, which GitHub uses to compute and sign the webhook payloads sent to CodePipeline, for protecting the integrity and authenticity of the webhook payloads. Using your own credentials or reusing the same token across multiple webhooks can lead to security vulnerabilities. - For information about the authentication scheme implemented by GITHUB_HMAC, see `Securing your webhooks <https://docs.aws.amazon.com/https://developer.github.com/webhooks/securing/>`_ on the GitHub Developer website. - IP rejects webhooks trigger requests unless they originate from an IP address in the IP range whitelisted in the authentication configuration. - UNAUTHENTICATED accepts all webhook trigger requests regardless of origin.
|
|
5524
5526
|
:param authentication_configuration: Properties that configure the authentication applied to incoming webhook trigger requests. The required properties depend on the authentication type. For GITHUB_HMAC, only the ``SecretToken`` property must be set. For IP, only the ``AllowedIPRange`` property must be set to a valid CIDR range. For UNAUTHENTICATED, no properties can be set.
|
|
5525
5527
|
:param filters: A list of rules applied to the body/payload sent in the POST request to a webhook URL. All defined rules must pass for the request to be accepted and the pipeline started.
|
|
5526
5528
|
:param target_action: The name of the action in a pipeline you want to connect to the webhook. The action must be from the source (first) stage of the pipeline.
|
|
@@ -5586,6 +5588,10 @@ class CfnWebhookProps:
|
|
|
5586
5588
|
def authentication(self) -> builtins.str:
|
|
5587
5589
|
'''Supported options are GITHUB_HMAC, IP, and UNAUTHENTICATED.
|
|
5588
5590
|
|
|
5591
|
+
.. epigraph::
|
|
5592
|
+
|
|
5593
|
+
When creating CodePipeline webhooks, do not use your own credentials or reuse the same secret token across multiple webhooks. For optimal security, generate a unique secret token for each webhook you create. The secret token is an arbitrary string that you provide, which GitHub uses to compute and sign the webhook payloads sent to CodePipeline, for protecting the integrity and authenticity of the webhook payloads. Using your own credentials or reusing the same token across multiple webhooks can lead to security vulnerabilities.
|
|
5594
|
+
|
|
5589
5595
|
- For information about the authentication scheme implemented by GITHUB_HMAC, see `Securing your webhooks <https://docs.aws.amazon.com/https://developer.github.com/webhooks/securing/>`_ on the GitHub Developer website.
|
|
5590
5596
|
- IP rejects webhooks trigger requests unless they originate from an IP address in the IP range whitelisted in the authentication configuration.
|
|
5591
5597
|
- UNAUTHENTICATED accepts all webhook trigger requests regardless of origin.
|
aws_cdk/aws_cognito/__init__.py
CHANGED
|
@@ -10971,8 +10971,7 @@ class CfnUserPoolUICustomizationAttachment(
|
|
|
10971
10971
|
@builtins.property
|
|
10972
10972
|
@jsii.member(jsii_name="attrId")
|
|
10973
10973
|
def attr_id(self) -> builtins.str:
|
|
10974
|
-
'''
|
|
10975
|
-
|
|
10974
|
+
'''
|
|
10976
10975
|
:cloudformationAttribute: Id
|
|
10977
10976
|
'''
|
|
10978
10977
|
return typing.cast(builtins.str, jsii.get(self, "attrId"))
|
aws_cdk/aws_ec2/__init__.py
CHANGED
|
@@ -11250,7 +11250,7 @@ class CfnEC2Fleet(
|
|
|
11250
11250
|
:param placement: The location where the instance launched, if applicable.
|
|
11251
11251
|
:param priority: The priority for the launch template override. The highest priority is launched first. If the On-Demand ``AllocationStrategy`` is set to ``prioritized`` , EC2 Fleet uses priority to determine which launch template override to use first in fulfilling On-Demand capacity. If the Spot ``AllocationStrategy`` is set to ``capacity-optimized-prioritized`` , EC2 Fleet uses priority on a best-effort basis to determine which launch template override to use in fulfilling Spot capacity, but optimizes for capacity first. Valid values are whole numbers starting at ``0`` . The lower the number, the higher the priority. If no number is set, the launch template override has the lowest priority. You can set the same priority for different launch template overrides.
|
|
11252
11252
|
:param subnet_id: The IDs of the subnets in which to launch the instances. Separate multiple subnet IDs using commas (for example, ``subnet-1234abcdeexample1, subnet-0987cdef6example2`` ). A request of type ``instant`` can have only one subnet ID.
|
|
11253
|
-
:param weighted_capacity: The number of units provided by the specified instance type. .. epigraph:: When specifying weights, the price used in the ``lowest-price`` and ``price-capacity-optimized`` allocation strategies is per *unit* hour (where the instance price is divided by the specified weight). However, if all the specified weights are above the requested ``TargetCapacity`` , resulting in only 1 instance being launched, the price used is per *instance* hour.
|
|
11253
|
+
:param weighted_capacity: The number of units provided by the specified instance type. These are the same units that you chose to set the target capacity in terms of instances, or a performance characteristic such as vCPUs, memory, or I/O. If the target capacity divided by this value is not a whole number, Amazon EC2 rounds the number of instances to the next whole number. If this value is not specified, the default is 1. .. epigraph:: When specifying weights, the price used in the ``lowest-price`` and ``price-capacity-optimized`` allocation strategies is per *unit* hour (where the instance price is divided by the specified weight). However, if all the specified weights are above the requested ``TargetCapacity`` , resulting in only 1 instance being launched, the price used is per *instance* hour.
|
|
11254
11254
|
|
|
11255
11255
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest.html
|
|
11256
11256
|
:exampleMetadata: fixture=_generated
|
|
@@ -11455,6 +11455,9 @@ class CfnEC2Fleet(
|
|
|
11455
11455
|
def weighted_capacity(self) -> typing.Optional[jsii.Number]:
|
|
11456
11456
|
'''The number of units provided by the specified instance type.
|
|
11457
11457
|
|
|
11458
|
+
These are the same units that you chose to set the target capacity in terms of instances, or a performance characteristic such as vCPUs, memory, or I/O.
|
|
11459
|
+
|
|
11460
|
+
If the target capacity divided by this value is not a whole number, Amazon EC2 rounds the number of instances to the next whole number. If this value is not specified, the default is 1.
|
|
11458
11461
|
.. epigraph::
|
|
11459
11462
|
|
|
11460
11463
|
When specifying weights, the price used in the ``lowest-price`` and ``price-capacity-optimized`` allocation strategies is per *unit* hour (where the instance price is divided by the specified weight). However, if all the specified weights are above the requested ``TargetCapacity`` , resulting in only 1 instance being launched, the price used is per *instance* hour.
|
|
@@ -45095,7 +45098,7 @@ class CfnSpotFleet(
|
|
|
45095
45098
|
:param priority: The priority for the launch template override. The highest priority is launched first. If ``OnDemandAllocationStrategy`` is set to ``prioritized`` , Spot Fleet uses priority to determine which launch template override to use first in fulfilling On-Demand capacity. If the Spot ``AllocationStrategy`` is set to ``capacityOptimizedPrioritized`` , Spot Fleet uses priority on a best-effort basis to determine which launch template override to use in fulfilling Spot capacity, but optimizes for capacity first. Valid values are whole numbers starting at ``0`` . The lower the number, the higher the priority. If no number is set, the launch template override has the lowest priority. You can set the same priority for different launch template overrides.
|
|
45096
45099
|
:param spot_price: The maximum price per unit hour that you are willing to pay for a Spot Instance. We do not recommend using this parameter because it can lead to increased interruptions. If you do not specify this parameter, you will pay the current Spot price. .. epigraph:: If you specify a maximum price, your instances will be interrupted more frequently than if you do not specify this parameter.
|
|
45097
45100
|
:param subnet_id: The ID of the subnet in which to launch the instances.
|
|
45098
|
-
:param weighted_capacity: The number of units provided by the specified instance type. .. epigraph:: When specifying weights, the price used in the ``
|
|
45101
|
+
:param weighted_capacity: The number of units provided by the specified instance type. These are the same units that you chose to set the target capacity in terms of instances, or a performance characteristic such as vCPUs, memory, or I/O. If the target capacity divided by this value is not a whole number, Amazon EC2 rounds the number of instances to the next whole number. If this value is not specified, the default is 1. .. epigraph:: When specifying weights, the price used in the ``lowestPrice`` and ``priceCapacityOptimized`` allocation strategies is per *unit* hour (where the instance price is divided by the specified weight). However, if all the specified weights are above the requested ``TargetCapacity`` , resulting in only 1 instance being launched, the price used is per *instance* hour.
|
|
45099
45102
|
|
|
45100
45103
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-launchtemplateoverrides.html
|
|
45101
45104
|
:exampleMetadata: fixture=_generated
|
|
@@ -45269,9 +45272,12 @@ class CfnSpotFleet(
|
|
|
45269
45272
|
def weighted_capacity(self) -> typing.Optional[jsii.Number]:
|
|
45270
45273
|
'''The number of units provided by the specified instance type.
|
|
45271
45274
|
|
|
45275
|
+
These are the same units that you chose to set the target capacity in terms of instances, or a performance characteristic such as vCPUs, memory, or I/O.
|
|
45276
|
+
|
|
45277
|
+
If the target capacity divided by this value is not a whole number, Amazon EC2 rounds the number of instances to the next whole number. If this value is not specified, the default is 1.
|
|
45272
45278
|
.. epigraph::
|
|
45273
45279
|
|
|
45274
|
-
When specifying weights, the price used in the ``
|
|
45280
|
+
When specifying weights, the price used in the ``lowestPrice`` and ``priceCapacityOptimized`` allocation strategies is per *unit* hour (where the instance price is divided by the specified weight). However, if all the specified weights are above the requested ``TargetCapacity`` , resulting in only 1 instance being launched, the price used is per *instance* hour.
|
|
45275
45281
|
|
|
45276
45282
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-launchtemplateoverrides.html#cfn-ec2-spotfleet-launchtemplateoverrides-weightedcapacity
|
|
45277
45283
|
'''
|
|
@@ -45904,7 +45910,7 @@ class CfnSpotFleet(
|
|
|
45904
45910
|
:param subnet_id: The IDs of the subnets in which to launch the instances. To specify multiple subnets, separate them using commas; for example, "subnet-1234abcdeexample1, subnet-0987cdef6example2". If you specify a network interface, you must specify any subnets as part of the network interface instead of using this parameter.
|
|
45905
45911
|
:param tag_specifications: The tags to apply during creation.
|
|
45906
45912
|
:param user_data: The base64-encoded user data that instances use when starting up. User data is limited to 16 KB.
|
|
45907
|
-
:param weighted_capacity: The number of units provided by the specified instance type. These are the same units that you chose to set the target capacity in terms of instances, or a performance characteristic such as vCPUs, memory, or I/O. If the target capacity divided by this value is not a whole number, Amazon EC2 rounds the number of instances to the next whole number. If this value is not specified, the default is 1.
|
|
45913
|
+
:param weighted_capacity: The number of units provided by the specified instance type. These are the same units that you chose to set the target capacity in terms of instances, or a performance characteristic such as vCPUs, memory, or I/O. If the target capacity divided by this value is not a whole number, Amazon EC2 rounds the number of instances to the next whole number. If this value is not specified, the default is 1. .. epigraph:: When specifying weights, the price used in the ``lowestPrice`` and ``priceCapacityOptimized`` allocation strategies is per *unit* hour (where the instance price is divided by the specified weight). However, if all the specified weights are above the requested ``TargetCapacity`` , resulting in only 1 instance being launched, the price used is per *instance* hour.
|
|
45908
45914
|
|
|
45909
45915
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetlaunchspecification.html
|
|
45910
45916
|
:exampleMetadata: fixture=_generated
|
|
@@ -46304,6 +46310,9 @@ class CfnSpotFleet(
|
|
|
46304
46310
|
These are the same units that you chose to set the target capacity in terms of instances, or a performance characteristic such as vCPUs, memory, or I/O.
|
|
46305
46311
|
|
|
46306
46312
|
If the target capacity divided by this value is not a whole number, Amazon EC2 rounds the number of instances to the next whole number. If this value is not specified, the default is 1.
|
|
46313
|
+
.. epigraph::
|
|
46314
|
+
|
|
46315
|
+
When specifying weights, the price used in the ``lowestPrice`` and ``priceCapacityOptimized`` allocation strategies is per *unit* hour (where the instance price is divided by the specified weight). However, if all the specified weights are above the requested ``TargetCapacity`` , resulting in only 1 instance being launched, the price used is per *instance* hour.
|
|
46307
46316
|
|
|
46308
46317
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetlaunchspecification.html#cfn-ec2-spotfleet-spotfleetlaunchspecification-weightedcapacity
|
|
46309
46318
|
'''
|
|
@@ -72275,6 +72284,51 @@ class Instance(
|
|
|
72275
72284
|
check_type(argname="argument commands", value=commands, expected_type=typing.Tuple[type_hints["commands"], ...]) # pyright: ignore [reportGeneralTypeIssues]
|
|
72276
72285
|
return typing.cast(None, jsii.invoke(self, "addUserData", [*commands]))
|
|
72277
72286
|
|
|
72287
|
+
@jsii.member(jsii_name="applyCloudFormationInit")
|
|
72288
|
+
def apply_cloud_formation_init(
|
|
72289
|
+
self,
|
|
72290
|
+
init: CloudFormationInit,
|
|
72291
|
+
*,
|
|
72292
|
+
config_sets: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
72293
|
+
embed_fingerprint: typing.Optional[builtins.bool] = None,
|
|
72294
|
+
ignore_failures: typing.Optional[builtins.bool] = None,
|
|
72295
|
+
include_role: typing.Optional[builtins.bool] = None,
|
|
72296
|
+
include_url: typing.Optional[builtins.bool] = None,
|
|
72297
|
+
print_log: typing.Optional[builtins.bool] = None,
|
|
72298
|
+
timeout: typing.Optional[_Duration_4839e8c3] = None,
|
|
72299
|
+
) -> None:
|
|
72300
|
+
'''Use a CloudFormation Init configuration at instance startup.
|
|
72301
|
+
|
|
72302
|
+
This does the following:
|
|
72303
|
+
|
|
72304
|
+
- Attaches the CloudFormation Init metadata to the Instance resource.
|
|
72305
|
+
- Add commands to the instance UserData to run ``cfn-init`` and ``cfn-signal``.
|
|
72306
|
+
- Update the instance's CreationPolicy to wait for the ``cfn-signal`` commands.
|
|
72307
|
+
|
|
72308
|
+
:param init: -
|
|
72309
|
+
:param config_sets: ConfigSet to activate. Default: ['default']
|
|
72310
|
+
:param embed_fingerprint: Force instance replacement by embedding a config fingerprint. If ``true`` (the default), a hash of the config will be embedded into the UserData, so that if the config changes, the UserData changes. - If the EC2 instance is instance-store backed or ``userDataCausesReplacement`` is set, this will cause the instance to be replaced and the new configuration to be applied. - If the instance is EBS-backed and ``userDataCausesReplacement`` is not set, the change of UserData will make the instance restart but not be replaced, and the configuration will not be applied automatically. If ``false``, no hash will be embedded, and if the CloudFormation Init config changes nothing will happen to the running instance. If a config update introduces errors, you will not notice until after the CloudFormation deployment successfully finishes and the next instance fails to launch. Default: true
|
|
72311
|
+
:param ignore_failures: Don't fail the instance creation when cfn-init fails. You can use this to prevent CloudFormation from rolling back when instances fail to start up, to help in debugging. Default: false
|
|
72312
|
+
:param include_role: Include --role argument when running cfn-init and cfn-signal commands. This will be the IAM instance profile attached to the EC2 instance Default: false
|
|
72313
|
+
:param include_url: Include --url argument when running cfn-init and cfn-signal commands. This will be the cloudformation endpoint in the deployed region e.g. https://cloudformation.us-east-1.amazonaws.com Default: false
|
|
72314
|
+
:param print_log: Print the results of running cfn-init to the Instance System Log. By default, the output of running cfn-init is written to a log file on the instance. Set this to ``true`` to print it to the System Log (visible from the EC2 Console), ``false`` to not print it. (Be aware that the system log is refreshed at certain points in time of the instance life cycle, and successful execution may not always show up). Default: true
|
|
72315
|
+
:param timeout: Timeout waiting for the configuration to be applied. Default: Duration.minutes(5)
|
|
72316
|
+
'''
|
|
72317
|
+
if __debug__:
|
|
72318
|
+
type_hints = typing.get_type_hints(_typecheckingstub__53b303537c54bd04722c794882b372a979c13db12619a012ce63ca57718733ff)
|
|
72319
|
+
check_type(argname="argument init", value=init, expected_type=type_hints["init"])
|
|
72320
|
+
options = ApplyCloudFormationInitOptions(
|
|
72321
|
+
config_sets=config_sets,
|
|
72322
|
+
embed_fingerprint=embed_fingerprint,
|
|
72323
|
+
ignore_failures=ignore_failures,
|
|
72324
|
+
include_role=include_role,
|
|
72325
|
+
include_url=include_url,
|
|
72326
|
+
print_log=print_log,
|
|
72327
|
+
timeout=timeout,
|
|
72328
|
+
)
|
|
72329
|
+
|
|
72330
|
+
return typing.cast(None, jsii.invoke(self, "applyCloudFormationInit", [init, options]))
|
|
72331
|
+
|
|
72278
72332
|
@builtins.property
|
|
72279
72333
|
@jsii.member(jsii_name="connections")
|
|
72280
72334
|
def connections(self) -> "Connections":
|
|
@@ -72782,6 +72836,10 @@ class InstanceClass(enum.Enum):
|
|
|
72782
72836
|
'''Graphics-optimized instances powered by AWS Graviton2 Processors and NVIDIA T4G Tensor Core GPUs, 5th generation.'''
|
|
72783
72837
|
G5G = "G5G"
|
|
72784
72838
|
'''Graphics-optimized instances powered by AWS Graviton2 Processors and NVIDIA T4G Tensor Core GPUs, 5th generation.'''
|
|
72839
|
+
GRAPHICS6 = "GRAPHICS6"
|
|
72840
|
+
'''Graphics-optimized instances, 6th generation.'''
|
|
72841
|
+
G6 = "G6"
|
|
72842
|
+
'''Graphics-optimized instances, 6th generation.'''
|
|
72785
72843
|
PARALLEL2 = "PARALLEL2"
|
|
72786
72844
|
'''Parallel-processing optimized instances, 2nd generation.'''
|
|
72787
72845
|
P2 = "P2"
|
|
@@ -86586,6 +86644,12 @@ class VpcEndpointService(
|
|
|
86586
86644
|
|
|
86587
86645
|
jsii.create(self.__class__, self, [scope, id, props])
|
|
86588
86646
|
|
|
86647
|
+
@jsii.python.classproperty
|
|
86648
|
+
@jsii.member(jsii_name="DEFAULT_PREFIX")
|
|
86649
|
+
def DEFAULT_PREFIX(cls) -> builtins.str:
|
|
86650
|
+
'''The default value for a VPC Endpoint Service name prefix, useful if you do not have a synthesize-time region literal available (all you have is ``{ "Ref": "AWS::Region" }``).'''
|
|
86651
|
+
return typing.cast(builtins.str, jsii.sget(cls, "DEFAULT_PREFIX"))
|
|
86652
|
+
|
|
86589
86653
|
@builtins.property
|
|
86590
86654
|
@jsii.member(jsii_name="acceptanceRequired")
|
|
86591
86655
|
def acceptance_required(self) -> builtins.bool:
|
|
@@ -104316,6 +104380,20 @@ def _typecheckingstub__82601f36068811ad664f607ef04191e661dad31e73a2a8f4f2c40217f
|
|
|
104316
104380
|
"""Type checking stubs"""
|
|
104317
104381
|
pass
|
|
104318
104382
|
|
|
104383
|
+
def _typecheckingstub__53b303537c54bd04722c794882b372a979c13db12619a012ce63ca57718733ff(
|
|
104384
|
+
init: CloudFormationInit,
|
|
104385
|
+
*,
|
|
104386
|
+
config_sets: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
104387
|
+
embed_fingerprint: typing.Optional[builtins.bool] = None,
|
|
104388
|
+
ignore_failures: typing.Optional[builtins.bool] = None,
|
|
104389
|
+
include_role: typing.Optional[builtins.bool] = None,
|
|
104390
|
+
include_url: typing.Optional[builtins.bool] = None,
|
|
104391
|
+
print_log: typing.Optional[builtins.bool] = None,
|
|
104392
|
+
timeout: typing.Optional[_Duration_4839e8c3] = None,
|
|
104393
|
+
) -> None:
|
|
104394
|
+
"""Type checking stubs"""
|
|
104395
|
+
pass
|
|
104396
|
+
|
|
104319
104397
|
def _typecheckingstub__2d4dc63c6e6ee3ddc68d5dd204d8ac5ef1f1dec37a7b84d636225df1c2f17d22(
|
|
104320
104398
|
*,
|
|
104321
104399
|
instance_type: InstanceType,
|
aws_cdk/aws_ecs/__init__.py
CHANGED
|
@@ -9605,7 +9605,7 @@ class CfnService(
|
|
|
9605
9605
|
- For tasks that are hosted on Amazon EC2 instances, the Amazon ECS container agent must register the available logging drivers with the ``ECS_AVAILABLE_LOGGING_DRIVERS`` environment variable before containers placed on that instance can use these log configuration options. For more information, see `Amazon ECS container agent configuration <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-config.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
|
|
9606
9606
|
- For tasks that are on AWS Fargate , because you don't have access to the underlying infrastructure your tasks are hosted on, any additional software needed must be installed outside of the task. For example, the Fluentd output aggregators or a remote host running Logstash to send Gelf logs to.
|
|
9607
9607
|
|
|
9608
|
-
:param log_driver: The log driver to use for the container. For tasks on AWS Fargate , the supported log drivers are ``awslogs`` , ``splunk`` , and ``awsfirelens`` . For tasks hosted on Amazon EC2 instances, the supported log drivers are ``awslogs`` , ``fluentd`` , ``gelf`` , ``json-file`` , ``journald`` , ``
|
|
9608
|
+
:param log_driver: The log driver to use for the container. For tasks on AWS Fargate , the supported log drivers are ``awslogs`` , ``splunk`` , and ``awsfirelens`` . For tasks hosted on Amazon EC2 instances, the supported log drivers are ``awslogs`` , ``fluentd`` , ``gelf`` , ``json-file`` , ``journald`` , ``syslog`` , ``splunk`` , and ``awsfirelens`` . For more information about using the ``awslogs`` log driver, see `Send Amazon ECS logs to CloudWatch <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using_awslogs.html>`_ in the *Amazon Elastic Container Service Developer Guide* . For more information about using the ``awsfirelens`` log driver, see `Send Amazon ECS logs to an AWS service or AWS Partner <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using_firelens.html>`_ . .. epigraph:: If you have a custom driver that isn't listed, you can fork the Amazon ECS container agent project that's `available on GitHub <https://docs.aws.amazon.com/https://github.com/aws/amazon-ecs-agent>`_ and customize it to work with that driver. We encourage you to submit pull requests for changes that you would like to have included. However, we don't currently provide support for running modified copies of this software.
|
|
9609
9609
|
:param options: The configuration options to send to the log driver. This parameter requires version 1.19 of the Docker Remote API or greater on your container instance. To check the Docker Remote API version on your container instance, log in to your container instance and run the following command: ``sudo docker version --format '{{.Server.APIVersion}}'``
|
|
9610
9610
|
:param secret_options: The secrets to pass to the log configuration. For more information, see `Specifying sensitive data <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/specifying-sensitive-data.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
|
|
9611
9611
|
|
|
@@ -9648,7 +9648,7 @@ class CfnService(
|
|
|
9648
9648
|
|
|
9649
9649
|
For tasks on AWS Fargate , the supported log drivers are ``awslogs`` , ``splunk`` , and ``awsfirelens`` .
|
|
9650
9650
|
|
|
9651
|
-
For tasks hosted on Amazon EC2 instances, the supported log drivers are ``awslogs`` , ``fluentd`` , ``gelf`` , ``json-file`` , ``journald`` , ``
|
|
9651
|
+
For tasks hosted on Amazon EC2 instances, the supported log drivers are ``awslogs`` , ``fluentd`` , ``gelf`` , ``json-file`` , ``journald`` , ``syslog`` , ``splunk`` , and ``awsfirelens`` .
|
|
9652
9652
|
|
|
9653
9653
|
For more information about using the ``awslogs`` log driver, see `Send Amazon ECS logs to CloudWatch <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using_awslogs.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
|
|
9654
9654
|
|
|
@@ -12090,7 +12090,7 @@ class CfnTaskDefinition(
|
|
|
12090
12090
|
:param scope: Scope in which this resource is defined.
|
|
12091
12091
|
:param id: Construct identifier for this resource (unique in its scope).
|
|
12092
12092
|
:param container_definitions: A list of container definitions in JSON format that describe the different containers that make up your task. For more information about container definition parameters and defaults, see `Amazon ECS Task Definitions <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_defintions.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
|
|
12093
|
-
:param cpu: The number of ``cpu`` units used by the task. If you use the EC2 launch type, this field is optional. Any value can be used. If you use the Fargate launch type, this field is required. You must use one of the following values. The value that you choose determines your range of valid values for the ``memory`` parameter. The CPU units cannot be less than 1 vCPU when you use Windows containers on Fargate. - 256 (.25 vCPU) - Available ``memory`` values: 512 (0.5 GB), 1024 (1 GB), 2048 (2 GB) - 512 (.5 vCPU) - Available ``memory`` values: 1024 (1 GB), 2048 (2 GB), 3072 (3 GB), 4096 (4 GB) - 1024 (1 vCPU) - Available ``memory`` values: 2048 (2 GB), 3072 (3 GB), 4096 (4 GB), 5120 (5 GB), 6144 (6 GB), 7168 (7 GB), 8192 (8 GB) - 2048 (2 vCPU) - Available ``memory`` values: 4096 (4 GB) and 16384 (16 GB) in increments of 1024 (1 GB) - 4096 (4 vCPU) - Available ``memory`` values: 8192 (8 GB) and 30720 (30 GB) in increments of 1024 (1 GB) - 8192 (8 vCPU) - Available ``memory`` values: 16 GB and 60 GB in 4 GB increments This option requires Linux platform ``1.4.0`` or later. - 16384 (16vCPU) - Available ``memory`` values: 32GB and 120 GB in 8 GB increments This option requires Linux platform ``1.4.0`` or later.
|
|
12093
|
+
:param cpu: The number of ``cpu`` units used by the task. If you use the EC2 launch type, this field is optional. Any value can be used. If you use the Fargate launch type, this field is required. You must use one of the following values. The value that you choose determines your range of valid values for the ``memory`` parameter. If you use the EC2 launch type, this field is optional. Supported values are between ``128`` CPU units ( ``0.125`` vCPUs) and ``10240`` CPU units ( ``10`` vCPUs). The CPU units cannot be less than 1 vCPU when you use Windows containers on Fargate. - 256 (.25 vCPU) - Available ``memory`` values: 512 (0.5 GB), 1024 (1 GB), 2048 (2 GB) - 512 (.5 vCPU) - Available ``memory`` values: 1024 (1 GB), 2048 (2 GB), 3072 (3 GB), 4096 (4 GB) - 1024 (1 vCPU) - Available ``memory`` values: 2048 (2 GB), 3072 (3 GB), 4096 (4 GB), 5120 (5 GB), 6144 (6 GB), 7168 (7 GB), 8192 (8 GB) - 2048 (2 vCPU) - Available ``memory`` values: 4096 (4 GB) and 16384 (16 GB) in increments of 1024 (1 GB) - 4096 (4 vCPU) - Available ``memory`` values: 8192 (8 GB) and 30720 (30 GB) in increments of 1024 (1 GB) - 8192 (8 vCPU) - Available ``memory`` values: 16 GB and 60 GB in 4 GB increments This option requires Linux platform ``1.4.0`` or later. - 16384 (16vCPU) - Available ``memory`` values: 32GB and 120 GB in 8 GB increments This option requires Linux platform ``1.4.0`` or later.
|
|
12094
12094
|
:param ephemeral_storage: The ephemeral storage settings to use for tasks run with the task definition.
|
|
12095
12095
|
:param execution_role_arn: The Amazon Resource Name (ARN) of the task execution role that grants the Amazon ECS container agent permission to make AWS API calls on your behalf. For informationabout the required IAM roles for Amazon ECS, see `IAM roles for Amazon ECS <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/security-ecs-iam-role-overview.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
|
|
12096
12096
|
:param family: The name of a family that this task definition is registered to. Up to 255 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed. A family groups multiple versions of a task definition. Amazon ECS gives the first task definition that you registered to a family a revision number of 1. Amazon ECS gives sequential revision numbers to each task definition that you add. .. epigraph:: To use revision numbers when you update a task definition, specify this property. If you don't specify a value, AWS CloudFormation generates a new task definition each time that you update it.
|
|
@@ -12644,7 +12644,7 @@ class CfnTaskDefinition(
|
|
|
12644
12644
|
:param repository_credentials: The private repository authentication credentials to use.
|
|
12645
12645
|
:param resource_requirements: The type and amount of a resource to assign to a container. The only supported resource is a GPU.
|
|
12646
12646
|
:param secrets: The secrets to pass to the container. For more information, see `Specifying Sensitive Data <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/specifying-sensitive-data.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
|
|
12647
|
-
:param start_timeout: Time duration (in seconds) to wait before giving up on resolving dependencies for a container. For example, you specify two containers in a task definition with containerA having a dependency on containerB reaching a ``COMPLETE`` , ``SUCCESS`` , or ``HEALTHY`` status. If a ``startTimeout`` value is specified for containerB and it doesn't reach the desired status within that time then containerA gives up and not start. This results in the task transitioning to a ``STOPPED`` state. .. epigraph:: When the ``ECS_CONTAINER_START_TIMEOUT`` container agent configuration variable is used, it's enforced independently from this start timeout value. For tasks using the Fargate launch type, the task or service requires the following platforms: - Linux platform version ``1.3.0`` or later. - Windows platform version ``1.0.0`` or later. For tasks using the EC2 launch type, your container instances require at least version ``1.26.0`` of the container agent to use a container start timeout value. However, we recommend using the latest container agent version. For information about checking your agent version and updating to the latest version, see `Updating the Amazon ECS Container Agent <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-update.html>`_ in the *Amazon Elastic Container Service Developer Guide* . If you're using an Amazon ECS-optimized Linux AMI, your instance needs at least version ``1.26.0-1`` of the ``ecs-init`` package. If your container instances are launched from version ``20190301`` or later, then they contain the required versions of the container agent and ``ecs-init`` . For more information, see `Amazon ECS-optimized Linux AMI <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-optimized_AMI.html>`_ in the *Amazon Elastic Container Service Developer Guide* . The valid values are 2-120 seconds.
|
|
12647
|
+
:param start_timeout: Time duration (in seconds) to wait before giving up on resolving dependencies for a container. For example, you specify two containers in a task definition with containerA having a dependency on containerB reaching a ``COMPLETE`` , ``SUCCESS`` , or ``HEALTHY`` status. If a ``startTimeout`` value is specified for containerB and it doesn't reach the desired status within that time then containerA gives up and not start. This results in the task transitioning to a ``STOPPED`` state. .. epigraph:: When the ``ECS_CONTAINER_START_TIMEOUT`` container agent configuration variable is used, it's enforced independently from this start timeout value. For tasks using the Fargate launch type, the task or service requires the following platforms: - Linux platform version ``1.3.0`` or later. - Windows platform version ``1.0.0`` or later. For tasks using the EC2 launch type, your container instances require at least version ``1.26.0`` of the container agent to use a container start timeout value. However, we recommend using the latest container agent version. For information about checking your agent version and updating to the latest version, see `Updating the Amazon ECS Container Agent <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-update.html>`_ in the *Amazon Elastic Container Service Developer Guide* . If you're using an Amazon ECS-optimized Linux AMI, your instance needs at least version ``1.26.0-1`` of the ``ecs-init`` package. If your container instances are launched from version ``20190301`` or later, then they contain the required versions of the container agent and ``ecs-init`` . For more information, see `Amazon ECS-optimized Linux AMI <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-optimized_AMI.html>`_ in the *Amazon Elastic Container Service Developer Guide* . The valid values for Fargate are 2-120 seconds.
|
|
12648
12648
|
:param stop_timeout: Time duration (in seconds) to wait before the container is forcefully killed if it doesn't exit normally on its own. For tasks using the Fargate launch type, the task or service requires the following platforms: - Linux platform version ``1.3.0`` or later. - Windows platform version ``1.0.0`` or later. The max stop timeout value is 120 seconds and if the parameter is not specified, the default value of 30 seconds is used. For tasks that use the EC2 launch type, if the ``stopTimeout`` parameter isn't specified, the value set for the Amazon ECS container agent configuration variable ``ECS_CONTAINER_STOP_TIMEOUT`` is used. If neither the ``stopTimeout`` parameter or the ``ECS_CONTAINER_STOP_TIMEOUT`` agent configuration variable are set, then the default values of 30 seconds for Linux containers and 30 seconds on Windows containers are used. Your container instances require at least version 1.26.0 of the container agent to use a container stop timeout value. However, we recommend using the latest container agent version. For information about checking your agent version and updating to the latest version, see `Updating the Amazon ECS Container Agent <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-update.html>`_ in the *Amazon Elastic Container Service Developer Guide* . If you're using an Amazon ECS-optimized Linux AMI, your instance needs at least version 1.26.0-1 of the ``ecs-init`` package. If your container instances are launched from version ``20190301`` or later, then they contain the required versions of the container agent and ``ecs-init`` . For more information, see `Amazon ECS-optimized Linux AMI <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-optimized_AMI.html>`_ in the *Amazon Elastic Container Service Developer Guide* . The valid values are 2-120 seconds.
|
|
12649
12649
|
:param system_controls: A list of namespaced kernel parameters to set in the container. This parameter maps to ``Sysctls`` in the `Create a container <https://docs.aws.amazon.com/https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate>`_ section of the `Docker Remote API <https://docs.aws.amazon.com/https://docs.docker.com/engine/api/v1.35/>`_ and the ``--sysctl`` option to `docker run <https://docs.aws.amazon.com/https://docs.docker.com/engine/reference/run/#security-configuration>`_ . For example, you can configure ``net.ipv4.tcp_keepalive_time`` setting to maintain longer lived connections.
|
|
12650
12650
|
:param ulimits: A list of ``ulimits`` to set in the container. This parameter maps to ``Ulimits`` in the `Create a container <https://docs.aws.amazon.com/https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate>`_ section of the `Docker Remote API <https://docs.aws.amazon.com/https://docs.docker.com/engine/api/v1.35/>`_ and the ``--ulimit`` option to `docker run <https://docs.aws.amazon.com/https://docs.docker.com/engine/reference/run/>`_ . Valid naming values are displayed in the `Ulimit <https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_Ulimit.html>`_ data type. This parameter requires version 1.18 of the Docker Remote API or greater on your container instance. To check the Docker Remote API version on your container instance, log in to your container instance and run the following command: ``sudo docker version --format '{{.Server.APIVersion}}'`` .. epigraph:: This parameter is not supported for Windows containers.
|
|
@@ -13467,7 +13467,7 @@ class CfnTaskDefinition(
|
|
|
13467
13467
|
|
|
13468
13468
|
For tasks using the EC2 launch type, your container instances require at least version ``1.26.0`` of the container agent to use a container start timeout value. However, we recommend using the latest container agent version. For information about checking your agent version and updating to the latest version, see `Updating the Amazon ECS Container Agent <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-update.html>`_ in the *Amazon Elastic Container Service Developer Guide* . If you're using an Amazon ECS-optimized Linux AMI, your instance needs at least version ``1.26.0-1`` of the ``ecs-init`` package. If your container instances are launched from version ``20190301`` or later, then they contain the required versions of the container agent and ``ecs-init`` . For more information, see `Amazon ECS-optimized Linux AMI <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-optimized_AMI.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
|
|
13469
13469
|
|
|
13470
|
-
The valid values are 2-120 seconds.
|
|
13470
|
+
The valid values for Fargate are 2-120 seconds.
|
|
13471
13471
|
|
|
13472
13472
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-taskdefinition-containerdefinition.html#cfn-ecs-taskdefinition-containerdefinition-starttimeout
|
|
13473
13473
|
'''
|
|
@@ -15196,7 +15196,7 @@ class CfnTaskDefinition(
|
|
|
15196
15196
|
) -> None:
|
|
15197
15197
|
'''The ``LogConfiguration`` property specifies log configuration options to send to a custom log driver for the container.
|
|
15198
15198
|
|
|
15199
|
-
:param log_driver: The log driver to use for the container. For tasks on AWS Fargate , the supported log drivers are ``awslogs`` , ``splunk`` , and ``awsfirelens`` . For tasks hosted on Amazon EC2 instances, the supported log drivers are ``awslogs`` , ``fluentd`` , ``gelf`` , ``json-file`` , ``journald`` , ``
|
|
15199
|
+
:param log_driver: The log driver to use for the container. For tasks on AWS Fargate , the supported log drivers are ``awslogs`` , ``splunk`` , and ``awsfirelens`` . For tasks hosted on Amazon EC2 instances, the supported log drivers are ``awslogs`` , ``fluentd`` , ``gelf`` , ``json-file`` , ``journald`` , ``syslog`` , ``splunk`` , and ``awsfirelens`` . For more information about using the ``awslogs`` log driver, see `Send Amazon ECS logs to CloudWatch <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using_awslogs.html>`_ in the *Amazon Elastic Container Service Developer Guide* . For more information about using the ``awsfirelens`` log driver, see `Send Amazon ECS logs to an AWS service or AWS Partner <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using_firelens.html>`_ . .. epigraph:: If you have a custom driver that isn't listed, you can fork the Amazon ECS container agent project that's `available on GitHub <https://docs.aws.amazon.com/https://github.com/aws/amazon-ecs-agent>`_ and customize it to work with that driver. We encourage you to submit pull requests for changes that you would like to have included. However, we don't currently provide support for running modified copies of this software.
|
|
15200
15200
|
:param options: The configuration options to send to the log driver. This parameter requires version 1.19 of the Docker Remote API or greater on your container instance. To check the Docker Remote API version on your container instance, log in to your container instance and run the following command: ``sudo docker version --format '{{.Server.APIVersion}}'``
|
|
15201
15201
|
:param secret_options: The secrets to pass to the log configuration. For more information, see `Specifying sensitive data <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/specifying-sensitive-data.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
|
|
15202
15202
|
|
|
@@ -15241,7 +15241,7 @@ class CfnTaskDefinition(
|
|
|
15241
15241
|
|
|
15242
15242
|
For tasks on AWS Fargate , the supported log drivers are ``awslogs`` , ``splunk`` , and ``awsfirelens`` .
|
|
15243
15243
|
|
|
15244
|
-
For tasks hosted on Amazon EC2 instances, the supported log drivers are ``awslogs`` , ``fluentd`` , ``gelf`` , ``json-file`` , ``journald`` , ``
|
|
15244
|
+
For tasks hosted on Amazon EC2 instances, the supported log drivers are ``awslogs`` , ``fluentd`` , ``gelf`` , ``json-file`` , ``journald`` , ``syslog`` , ``splunk`` , and ``awsfirelens`` .
|
|
15245
15245
|
|
|
15246
15246
|
For more information about using the ``awslogs`` log driver, see `Send Amazon ECS logs to CloudWatch <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using_awslogs.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
|
|
15247
15247
|
|
|
@@ -16666,7 +16666,7 @@ class CfnTaskDefinitionProps:
|
|
|
16666
16666
|
'''Properties for defining a ``CfnTaskDefinition``.
|
|
16667
16667
|
|
|
16668
16668
|
:param container_definitions: A list of container definitions in JSON format that describe the different containers that make up your task. For more information about container definition parameters and defaults, see `Amazon ECS Task Definitions <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_defintions.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
|
|
16669
|
-
:param cpu: The number of ``cpu`` units used by the task. If you use the EC2 launch type, this field is optional. Any value can be used. If you use the Fargate launch type, this field is required. You must use one of the following values. The value that you choose determines your range of valid values for the ``memory`` parameter. The CPU units cannot be less than 1 vCPU when you use Windows containers on Fargate. - 256 (.25 vCPU) - Available ``memory`` values: 512 (0.5 GB), 1024 (1 GB), 2048 (2 GB) - 512 (.5 vCPU) - Available ``memory`` values: 1024 (1 GB), 2048 (2 GB), 3072 (3 GB), 4096 (4 GB) - 1024 (1 vCPU) - Available ``memory`` values: 2048 (2 GB), 3072 (3 GB), 4096 (4 GB), 5120 (5 GB), 6144 (6 GB), 7168 (7 GB), 8192 (8 GB) - 2048 (2 vCPU) - Available ``memory`` values: 4096 (4 GB) and 16384 (16 GB) in increments of 1024 (1 GB) - 4096 (4 vCPU) - Available ``memory`` values: 8192 (8 GB) and 30720 (30 GB) in increments of 1024 (1 GB) - 8192 (8 vCPU) - Available ``memory`` values: 16 GB and 60 GB in 4 GB increments This option requires Linux platform ``1.4.0`` or later. - 16384 (16vCPU) - Available ``memory`` values: 32GB and 120 GB in 8 GB increments This option requires Linux platform ``1.4.0`` or later.
|
|
16669
|
+
:param cpu: The number of ``cpu`` units used by the task. If you use the EC2 launch type, this field is optional. Any value can be used. If you use the Fargate launch type, this field is required. You must use one of the following values. The value that you choose determines your range of valid values for the ``memory`` parameter. If you use the EC2 launch type, this field is optional. Supported values are between ``128`` CPU units ( ``0.125`` vCPUs) and ``10240`` CPU units ( ``10`` vCPUs). The CPU units cannot be less than 1 vCPU when you use Windows containers on Fargate. - 256 (.25 vCPU) - Available ``memory`` values: 512 (0.5 GB), 1024 (1 GB), 2048 (2 GB) - 512 (.5 vCPU) - Available ``memory`` values: 1024 (1 GB), 2048 (2 GB), 3072 (3 GB), 4096 (4 GB) - 1024 (1 vCPU) - Available ``memory`` values: 2048 (2 GB), 3072 (3 GB), 4096 (4 GB), 5120 (5 GB), 6144 (6 GB), 7168 (7 GB), 8192 (8 GB) - 2048 (2 vCPU) - Available ``memory`` values: 4096 (4 GB) and 16384 (16 GB) in increments of 1024 (1 GB) - 4096 (4 vCPU) - Available ``memory`` values: 8192 (8 GB) and 30720 (30 GB) in increments of 1024 (1 GB) - 8192 (8 vCPU) - Available ``memory`` values: 16 GB and 60 GB in 4 GB increments This option requires Linux platform ``1.4.0`` or later. - 16384 (16vCPU) - Available ``memory`` values: 32GB and 120 GB in 8 GB increments This option requires Linux platform ``1.4.0`` or later.
|
|
16670
16670
|
:param ephemeral_storage: The ephemeral storage settings to use for tasks run with the task definition.
|
|
16671
16671
|
:param execution_role_arn: The Amazon Resource Name (ARN) of the task execution role that grants the Amazon ECS container agent permission to make AWS API calls on your behalf. For informationabout the required IAM roles for Amazon ECS, see `IAM roles for Amazon ECS <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/security-ecs-iam-role-overview.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
|
|
16672
16672
|
:param family: The name of a family that this task definition is registered to. Up to 255 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed. A family groups multiple versions of a task definition. Amazon ECS gives the first task definition that you registered to a family a revision number of 1. Amazon ECS gives sequential revision numbers to each task definition that you add. .. epigraph:: To use revision numbers when you update a task definition, specify this property. If you don't specify a value, AWS CloudFormation generates a new task definition each time that you update it.
|
|
@@ -16979,6 +16979,8 @@ class CfnTaskDefinitionProps:
|
|
|
16979
16979
|
|
|
16980
16980
|
If you use the EC2 launch type, this field is optional. Any value can be used. If you use the Fargate launch type, this field is required. You must use one of the following values. The value that you choose determines your range of valid values for the ``memory`` parameter.
|
|
16981
16981
|
|
|
16982
|
+
If you use the EC2 launch type, this field is optional. Supported values are between ``128`` CPU units ( ``0.125`` vCPUs) and ``10240`` CPU units ( ``10`` vCPUs).
|
|
16983
|
+
|
|
16982
16984
|
The CPU units cannot be less than 1 vCPU when you use Windows containers on Fargate.
|
|
16983
16985
|
|
|
16984
16986
|
- 256 (.25 vCPU) - Available ``memory`` values: 512 (0.5 GB), 1024 (1 GB), 2048 (2 GB)
|
aws_cdk/aws_eks/__init__.py
CHANGED
|
@@ -65,6 +65,7 @@ In addition, the library also supports defining Kubernetes resource manifests wi
|
|
|
65
65
|
* [Manually importing k8s specs and CRD's](#manually-importing-k8s-specs-and-crds)
|
|
66
66
|
* [Patching Kubernetes Resources](#patching-kubernetes-resources)
|
|
67
67
|
* [Querying Kubernetes Resources](#querying-kubernetes-resources)
|
|
68
|
+
* [Add-ons](#add-ons)
|
|
68
69
|
* [Using existing clusters](#using-existing-clusters)
|
|
69
70
|
* [Logging](#logging)
|
|
70
71
|
* [Known Issues and Limitations](#known-issues-and-limitations)
|
|
@@ -1850,6 +1851,21 @@ Specifically, since the above use-case is quite common, there is an easier way t
|
|
|
1850
1851
|
load_balancer_address = cluster.get_service_load_balancer_address("my-service")
|
|
1851
1852
|
```
|
|
1852
1853
|
|
|
1854
|
+
## Add-ons
|
|
1855
|
+
|
|
1856
|
+
[Add-ons](https://docs.aws.amazon.com/eks/latest/userguide/eks-add-ons.html) is a software that provides supporting operational capabilities to Kubernetes applications. The EKS module supports adding add-ons to your cluster using the `eks.Addon` class.
|
|
1857
|
+
|
|
1858
|
+
```python
|
|
1859
|
+
# cluster: eks.Cluster
|
|
1860
|
+
|
|
1861
|
+
|
|
1862
|
+
eks.Addon(self, "Addon",
|
|
1863
|
+
cluster=cluster,
|
|
1864
|
+
addon_name="aws-guardduty-agent",
|
|
1865
|
+
addon_version="v1.6.1"
|
|
1866
|
+
)
|
|
1867
|
+
```
|
|
1868
|
+
|
|
1853
1869
|
## Using existing clusters
|
|
1854
1870
|
|
|
1855
1871
|
The Amazon EKS library allows defining Kubernetes resources such as [Kubernetes
|
|
@@ -2656,22 +2672,17 @@ class AddonProps:
|
|
|
2656
2672
|
:param cluster: The EKS cluster the Add-On is associated with.
|
|
2657
2673
|
:param addon_version: Version of the Add-On. You can check all available versions with describe-addon-versons. For example, this lists all available versions for the ``eks-pod-identity-agent`` addon: $ aws eks describe-addon-versions --addon-name eks-pod-identity-agent --query 'addons[*].addonVersions[*].addonVersion' Default: the latest version.
|
|
2658
2674
|
|
|
2659
|
-
:exampleMetadata:
|
|
2675
|
+
:exampleMetadata: infused
|
|
2660
2676
|
|
|
2661
2677
|
Example::
|
|
2662
2678
|
|
|
2663
|
-
# The code below shows an example of how to instantiate this type.
|
|
2664
|
-
# The values are placeholders you should change.
|
|
2665
|
-
from aws_cdk import aws_eks as eks
|
|
2666
|
-
|
|
2667
2679
|
# cluster: eks.Cluster
|
|
2668
2680
|
|
|
2669
|
-
addon_props = eks.AddonProps(
|
|
2670
|
-
addon_name="addonName",
|
|
2671
|
-
cluster=cluster,
|
|
2672
2681
|
|
|
2673
|
-
|
|
2674
|
-
|
|
2682
|
+
eks.Addon(self, "Addon",
|
|
2683
|
+
cluster=cluster,
|
|
2684
|
+
addon_name="aws-guardduty-agent",
|
|
2685
|
+
addon_version="v1.6.1"
|
|
2675
2686
|
)
|
|
2676
2687
|
'''
|
|
2677
2688
|
if __debug__:
|
|
@@ -16684,22 +16695,17 @@ class Addon(
|
|
|
16684
16695
|
):
|
|
16685
16696
|
'''Represents an Amazon EKS Add-On.
|
|
16686
16697
|
|
|
16687
|
-
:exampleMetadata:
|
|
16698
|
+
:exampleMetadata: infused
|
|
16688
16699
|
|
|
16689
16700
|
Example::
|
|
16690
16701
|
|
|
16691
|
-
# The code below shows an example of how to instantiate this type.
|
|
16692
|
-
# The values are placeholders you should change.
|
|
16693
|
-
from aws_cdk import aws_eks as eks
|
|
16694
|
-
|
|
16695
16702
|
# cluster: eks.Cluster
|
|
16696
16703
|
|
|
16697
|
-
addon = eks.Addon(self, "MyAddon",
|
|
16698
|
-
addon_name="addonName",
|
|
16699
|
-
cluster=cluster,
|
|
16700
16704
|
|
|
16701
|
-
|
|
16702
|
-
|
|
16705
|
+
eks.Addon(self, "Addon",
|
|
16706
|
+
cluster=cluster,
|
|
16707
|
+
addon_name="aws-guardduty-agent",
|
|
16708
|
+
addon_version="v1.6.1"
|
|
16703
16709
|
)
|
|
16704
16710
|
'''
|
|
16705
16711
|
|
|
@@ -9281,7 +9281,7 @@ class CfnTargetGroup(
|
|
|
9281
9281
|
) -> None:
|
|
9282
9282
|
'''Specifies a target group attribute.
|
|
9283
9283
|
|
|
9284
|
-
:param key: The name of the attribute. The following attributes are supported by all load balancers: - ``deregistration_delay.timeout_seconds`` - The amount of time, in seconds, for Elastic Load Balancing to wait before changing the state of a deregistering target from ``draining`` to ``unused`` . The range is 0-3600 seconds. The default value is 300 seconds. If the target is a Lambda function, this attribute is not supported. - ``stickiness.enabled`` - Indicates whether target stickiness is enabled. The value is ``true`` or ``false`` . The default is ``false`` . - ``stickiness.type`` - Indicates the type of stickiness. The possible values are: - ``lb_cookie`` and ``app_cookie`` for Application Load Balancers. - ``source_ip`` for Network Load Balancers. - ``source_ip_dest_ip`` and ``source_ip_dest_ip_proto`` for Gateway Load Balancers. The following attributes are supported by Application Load Balancers and Network Load Balancers: - ``load_balancing.cross_zone.enabled`` - Indicates whether cross zone load balancing is enabled. The value is ``true`` , ``false`` or ``use_load_balancer_configuration`` . The default is ``use_load_balancer_configuration`` . - ``target_group_health.dns_failover.minimum_healthy_targets.count`` - The minimum number of targets that must be healthy. If the number of healthy targets is below this value, mark the zone as unhealthy in DNS, so that traffic is routed only to healthy zones. The possible values are ``off`` or an integer from 1 to the maximum number of targets. The default is ``
|
|
9284
|
+
:param key: The name of the attribute. The following attributes are supported by all load balancers: - ``deregistration_delay.timeout_seconds`` - The amount of time, in seconds, for Elastic Load Balancing to wait before changing the state of a deregistering target from ``draining`` to ``unused`` . The range is 0-3600 seconds. The default value is 300 seconds. If the target is a Lambda function, this attribute is not supported. - ``stickiness.enabled`` - Indicates whether target stickiness is enabled. The value is ``true`` or ``false`` . The default is ``false`` . - ``stickiness.type`` - Indicates the type of stickiness. The possible values are: - ``lb_cookie`` and ``app_cookie`` for Application Load Balancers. - ``source_ip`` for Network Load Balancers. - ``source_ip_dest_ip`` and ``source_ip_dest_ip_proto`` for Gateway Load Balancers. The following attributes are supported by Application Load Balancers and Network Load Balancers: - ``load_balancing.cross_zone.enabled`` - Indicates whether cross zone load balancing is enabled. The value is ``true`` , ``false`` or ``use_load_balancer_configuration`` . The default is ``use_load_balancer_configuration`` . - ``target_group_health.dns_failover.minimum_healthy_targets.count`` - The minimum number of targets that must be healthy. If the number of healthy targets is below this value, mark the zone as unhealthy in DNS, so that traffic is routed only to healthy zones. The possible values are ``off`` or an integer from 1 to the maximum number of targets. The default is ``1`` . - ``target_group_health.dns_failover.minimum_healthy_targets.percentage`` - The minimum percentage of targets that must be healthy. If the percentage of healthy targets is below this value, mark the zone as unhealthy in DNS, so that traffic is routed only to healthy zones. The possible values are ``off`` or an integer from 1 to 100. The default is ``off`` . - ``target_group_health.unhealthy_state_routing.minimum_healthy_targets.count`` - The minimum number of targets that must be healthy. If the number of healthy targets is below this value, send traffic to all targets, including unhealthy targets. The possible values are 1 to the maximum number of targets. The default is 1. - ``target_group_health.unhealthy_state_routing.minimum_healthy_targets.percentage`` - The minimum percentage of targets that must be healthy. If the percentage of healthy targets is below this value, send traffic to all targets, including unhealthy targets. The possible values are ``off`` or an integer from 1 to 100. The default is ``off`` . The following attributes are supported only if the load balancer is an Application Load Balancer and the target is an instance or an IP address: - ``load_balancing.algorithm.type`` - The load balancing algorithm determines how the load balancer selects targets when routing requests. The value is ``round_robin`` , ``least_outstanding_requests`` , or ``weighted_random`` . The default is ``round_robin`` . - ``load_balancing.algorithm.anomaly_mitigation`` - Only available when ``load_balancing.algorithm.type`` is ``weighted_random`` . Indicates whether anomaly mitigation is enabled. The value is ``on`` or ``off`` . The default is ``off`` . - ``slow_start.duration_seconds`` - The time period, in seconds, during which a newly registered target receives an increasing share of the traffic to the target group. After this time period ends, the target receives its full share of traffic. The range is 30-900 seconds (15 minutes). The default is 0 seconds (disabled). - ``stickiness.app_cookie.cookie_name`` - Indicates the name of the application-based cookie. Names that start with the following prefixes are not allowed: ``AWSALB`` , ``AWSALBAPP`` , and ``AWSALBTG`` ; they're reserved for use by the load balancer. - ``stickiness.app_cookie.duration_seconds`` - The time period, in seconds, during which requests from a client should be routed to the same target. After this time period expires, the application-based cookie is considered stale. The range is 1 second to 1 week (604800 seconds). The default value is 1 day (86400 seconds). - ``stickiness.lb_cookie.duration_seconds`` - The time period, in seconds, during which requests from a client should be routed to the same target. After this time period expires, the load balancer-generated cookie is considered stale. The range is 1 second to 1 week (604800 seconds). The default value is 1 day (86400 seconds). The following attribute is supported only if the load balancer is an Application Load Balancer and the target is a Lambda function: - ``lambda.multi_value_headers.enabled`` - Indicates whether the request and response headers that are exchanged between the load balancer and the Lambda function include arrays of values or strings. The value is ``true`` or ``false`` . The default is ``false`` . If the value is ``false`` and the request contains a duplicate header field name or query parameter key, the load balancer uses the last value sent by the client. The following attributes are supported only by Network Load Balancers: - ``deregistration_delay.connection_termination.enabled`` - Indicates whether the load balancer terminates connections at the end of the deregistration timeout. The value is ``true`` or ``false`` . For new UDP/TCP_UDP target groups the default is ``true`` . Otherwise, the default is ``false`` . - ``preserve_client_ip.enabled`` - Indicates whether client IP preservation is enabled. The value is ``true`` or ``false`` . The default is disabled if the target group type is IP address and the target group protocol is TCP or TLS. Otherwise, the default is enabled. Client IP preservation cannot be disabled for UDP and TCP_UDP target groups. - ``proxy_protocol_v2.enabled`` - Indicates whether Proxy Protocol version 2 is enabled. The value is ``true`` or ``false`` . The default is ``false`` . - ``target_health_state.unhealthy.connection_termination.enabled`` - Indicates whether the load balancer terminates connections to unhealthy targets. The value is ``true`` or ``false`` . The default is ``true`` . - ``target_health_state.unhealthy.draining_interval_seconds`` - The amount of time for Elastic Load Balancing to wait before changing the state of an unhealthy target from ``unhealthy.draining`` to ``unhealthy`` . The range is 0-360000 seconds. The default value is 0 seconds. Note: This attribute can only be configured when ``target_health_state.unhealthy.connection_termination.enabled`` is ``false`` . The following attributes are supported only by Gateway Load Balancers: - ``target_failover.on_deregistration`` - Indicates how the Gateway Load Balancer handles existing flows when a target is deregistered. The possible values are ``rebalance`` and ``no_rebalance`` . The default is ``no_rebalance`` . The two attributes ( ``target_failover.on_deregistration`` and ``target_failover.on_unhealthy`` ) can't be set independently. The value you set for both attributes must be the same. - ``target_failover.on_unhealthy`` - Indicates how the Gateway Load Balancer handles existing flows when a target is unhealthy. The possible values are ``rebalance`` and ``no_rebalance`` . The default is ``no_rebalance`` . The two attributes ( ``target_failover.on_deregistration`` and ``target_failover.on_unhealthy`` ) cannot be set independently. The value you set for both attributes must be the same.
|
|
9285
9285
|
:param value: The value of the attribute.
|
|
9286
9286
|
|
|
9287
9287
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-elasticloadbalancingv2-targetgroup-targetgroupattribute.html
|
|
@@ -9324,7 +9324,7 @@ class CfnTargetGroup(
|
|
|
9324
9324
|
The following attributes are supported by Application Load Balancers and Network Load Balancers:
|
|
9325
9325
|
|
|
9326
9326
|
- ``load_balancing.cross_zone.enabled`` - Indicates whether cross zone load balancing is enabled. The value is ``true`` , ``false`` or ``use_load_balancer_configuration`` . The default is ``use_load_balancer_configuration`` .
|
|
9327
|
-
- ``target_group_health.dns_failover.minimum_healthy_targets.count`` - The minimum number of targets that must be healthy. If the number of healthy targets is below this value, mark the zone as unhealthy in DNS, so that traffic is routed only to healthy zones. The possible values are ``off`` or an integer from 1 to the maximum number of targets. The default is ``
|
|
9327
|
+
- ``target_group_health.dns_failover.minimum_healthy_targets.count`` - The minimum number of targets that must be healthy. If the number of healthy targets is below this value, mark the zone as unhealthy in DNS, so that traffic is routed only to healthy zones. The possible values are ``off`` or an integer from 1 to the maximum number of targets. The default is ``1`` .
|
|
9328
9328
|
- ``target_group_health.dns_failover.minimum_healthy_targets.percentage`` - The minimum percentage of targets that must be healthy. If the percentage of healthy targets is below this value, mark the zone as unhealthy in DNS, so that traffic is routed only to healthy zones. The possible values are ``off`` or an integer from 1 to 100. The default is ``off`` .
|
|
9329
9329
|
- ``target_group_health.unhealthy_state_routing.minimum_healthy_targets.count`` - The minimum number of targets that must be healthy. If the number of healthy targets is below this value, send traffic to all targets, including unhealthy targets. The possible values are 1 to the maximum number of targets. The default is 1.
|
|
9330
9330
|
- ``target_group_health.unhealthy_state_routing.minimum_healthy_targets.percentage`` - The minimum percentage of targets that must be healthy. If the percentage of healthy targets is below this value, send traffic to all targets, including unhealthy targets. The possible values are ``off`` or an integer from 1 to 100. The default is ``off`` .
|