aws-cdk-lib 2.186.0__py3-none-any.whl → 2.188.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 +303 -119
- aws_cdk/_jsii/__init__.py +1 -1
- aws_cdk/_jsii/{aws-cdk-lib@2.186.0.jsii.tgz → aws-cdk-lib@2.188.0.jsii.tgz} +0 -0
- aws_cdk/aws_amplify/__init__.py +136 -0
- aws_cdk/aws_apigateway/__init__.py +69 -17
- aws_cdk/aws_apigatewayv2/__init__.py +88 -0
- aws_cdk/aws_appconfig/__init__.py +30 -14
- aws_cdk/aws_appsync/__init__.py +14 -5
- aws_cdk/aws_arczonalshift/__init__.py +4 -4
- aws_cdk/aws_bedrock/__init__.py +637 -32
- aws_cdk/aws_budgets/__init__.py +8 -8
- aws_cdk/aws_cassandra/__init__.py +4 -2
- aws_cdk/aws_ce/__init__.py +2 -2
- aws_cdk/aws_cloudformation/__init__.py +3 -3
- aws_cdk/aws_cloudfront/__init__.py +11 -0
- aws_cdk/aws_cloudtrail/__init__.py +4 -18
- aws_cdk/aws_cloudwatch/__init__.py +50 -50
- aws_cdk/aws_codebuild/__init__.py +32 -1
- aws_cdk/aws_codepipeline/__init__.py +47 -32
- aws_cdk/aws_codepipeline_actions/__init__.py +2786 -1042
- aws_cdk/aws_codestarnotifications/__init__.py +16 -16
- aws_cdk/aws_cognito/__init__.py +8 -2
- aws_cdk/aws_config/__init__.py +2 -5
- aws_cdk/aws_datazone/__init__.py +287 -226
- aws_cdk/aws_detective/__init__.py +3 -3
- aws_cdk/aws_dynamodb/__init__.py +37 -0
- aws_cdk/aws_ec2/__init__.py +2448 -442
- aws_cdk/aws_ecr/__init__.py +143 -0
- aws_cdk/aws_ecr_assets/__init__.py +115 -4
- aws_cdk/aws_ecs/__init__.py +51 -0
- aws_cdk/aws_eks/__init__.py +222 -6
- aws_cdk/aws_events/__init__.py +8 -11
- aws_cdk/aws_events_targets/__init__.py +136 -0
- aws_cdk/aws_forecast/__init__.py +1 -1
- aws_cdk/aws_fsx/__init__.py +2 -2
- aws_cdk/aws_gamelift/__init__.py +11 -11
- aws_cdk/aws_iam/__init__.py +6 -4
- aws_cdk/aws_identitystore/__init__.py +6 -4
- aws_cdk/aws_iotsitewise/__init__.py +623 -0
- aws_cdk/aws_kinesisfirehose/__init__.py +38 -0
- aws_cdk/aws_kms/__init__.py +10 -11
- aws_cdk/aws_lakeformation/__init__.py +3 -3
- aws_cdk/aws_lambda/__init__.py +105 -4
- aws_cdk/aws_lambda_event_sources/__init__.py +87 -25
- aws_cdk/aws_lambda_nodejs/__init__.py +5 -24
- aws_cdk/aws_lex/__init__.py +985 -5
- aws_cdk/aws_logs/__init__.py +18 -0
- aws_cdk/aws_logs_destinations/__init__.py +146 -0
- aws_cdk/aws_mediaconnect/__init__.py +714 -290
- aws_cdk/aws_mwaa/__init__.py +9 -9
- aws_cdk/aws_networkfirewall/__init__.py +44 -0
- aws_cdk/aws_notifications/__init__.py +4 -4
- aws_cdk/aws_omics/__init__.py +225 -1
- aws_cdk/aws_opensearchserverless/__init__.py +31 -23
- aws_cdk/aws_organizations/__init__.py +1 -1
- aws_cdk/aws_pcaconnectorad/__init__.py +3 -2
- aws_cdk/aws_quicksight/__init__.py +268 -50
- aws_cdk/aws_rds/__init__.py +186 -10
- aws_cdk/aws_route53/__init__.py +5 -5
- aws_cdk/aws_route53recoverycontrol/__init__.py +41 -2
- aws_cdk/aws_rum/__init__.py +13 -10
- aws_cdk/aws_s3/__init__.py +3 -6
- aws_cdk/aws_s3_assets/__init__.py +70 -1
- aws_cdk/aws_s3_deployment/__init__.py +4 -0
- aws_cdk/aws_sagemaker/__init__.py +47 -4
- aws_cdk/aws_scheduler_targets/__init__.py +4 -16
- aws_cdk/aws_securitylake/__init__.py +2 -2
- aws_cdk/aws_servicecatalog/__init__.py +4 -0
- aws_cdk/aws_sns/__init__.py +1 -1
- aws_cdk/aws_ssmincidents/__init__.py +10 -10
- aws_cdk/aws_stepfunctions/__init__.py +23 -17
- aws_cdk/aws_stepfunctions_tasks/__init__.py +4 -0
- aws_cdk/aws_synthetics/__init__.py +9 -0
- aws_cdk/aws_systemsmanagersap/__init__.py +160 -0
- aws_cdk/aws_transfer/__init__.py +19 -10
- aws_cdk/aws_wafv2/__init__.py +512 -1141
- aws_cdk/cloud_assembly_schema/__init__.py +60 -10
- aws_cdk/cx_api/__init__.py +38 -2
- aws_cdk/pipelines/__init__.py +52 -2
- {aws_cdk_lib-2.186.0.dist-info → aws_cdk_lib-2.188.0.dist-info}/METADATA +4 -4
- {aws_cdk_lib-2.186.0.dist-info → aws_cdk_lib-2.188.0.dist-info}/RECORD +85 -85
- {aws_cdk_lib-2.186.0.dist-info → aws_cdk_lib-2.188.0.dist-info}/WHEEL +1 -1
- {aws_cdk_lib-2.186.0.dist-info → aws_cdk_lib-2.188.0.dist-info}/LICENSE +0 -0
- {aws_cdk_lib-2.186.0.dist-info → aws_cdk_lib-2.188.0.dist-info}/NOTICE +0 -0
- {aws_cdk_lib-2.186.0.dist-info → aws_cdk_lib-2.188.0.dist-info}/top_level.txt +0 -0
aws_cdk/aws_budgets/__init__.py
CHANGED
|
@@ -76,7 +76,7 @@ class CfnBudget(
|
|
|
76
76
|
):
|
|
77
77
|
'''The ``AWS::Budgets::Budget`` resource allows customers to take pre-defined actions that will trigger once a budget threshold has been exceeded.
|
|
78
78
|
|
|
79
|
-
creates, replaces, or deletes budgets for Billing and Cost Management. For more information, see `Managing Your Costs with Budgets <https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/budgets-managing-costs.html>`_ in the *
|
|
79
|
+
creates, replaces, or deletes budgets for Billing and Cost Management. For more information, see `Managing Your Costs with Budgets <https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/budgets-managing-costs.html>`_ in the *Billing and Cost Management User Guide* .
|
|
80
80
|
|
|
81
81
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-budgets-budget.html
|
|
82
82
|
:cloudformationResource: AWS::Budgets::Budget
|
|
@@ -405,7 +405,7 @@ class CfnBudget(
|
|
|
405
405
|
:param cost_filters: The cost filters, such as ``Region`` , ``Service`` , ``LinkedAccount`` , ``Tag`` , or ``CostCategory`` , that are applied to a budget. AWS Budgets supports the following services as a ``Service`` filter for RI budgets: - Amazon EC2 - Amazon Redshift - Amazon Relational Database Service - Amazon ElastiCache - Amazon OpenSearch Service
|
|
406
406
|
:param cost_types: The types of costs that are included in this ``COST`` budget. ``USAGE`` , ``RI_UTILIZATION`` , ``RI_COVERAGE`` , ``SAVINGS_PLANS_UTILIZATION`` , and ``SAVINGS_PLANS_COVERAGE`` budgets do not have ``CostTypes`` .
|
|
407
407
|
:param planned_budget_limits: A map containing multiple ``BudgetLimit`` , including current or future limits. ``PlannedBudgetLimits`` is available for cost or usage budget and supports both monthly and quarterly ``TimeUnit`` . For monthly budgets, provide 12 months of ``PlannedBudgetLimits`` values. This must start from the current month and include the next 11 months. The ``key`` is the start of the month, ``UTC`` in epoch seconds. For quarterly budgets, provide four quarters of ``PlannedBudgetLimits`` value entries in standard calendar quarter increments. This must start from the current quarter and include the next three quarters. The ``key`` is the start of the quarter, ``UTC`` in epoch seconds. If the planned budget expires before 12 months for monthly or four quarters for quarterly, provide the ``PlannedBudgetLimits`` values only for the remaining periods. If the budget begins at a date in the future, provide ``PlannedBudgetLimits`` values from the start date of the budget. After all of the ``BudgetLimit`` values in ``PlannedBudgetLimits`` are used, the budget continues to use the last limit as the ``BudgetLimit`` . At that point, the planned budget provides the same experience as a fixed budget. ``DescribeBudget`` and ``DescribeBudgets`` response along with ``PlannedBudgetLimits`` also contain ``BudgetLimit`` representing the current month or quarter limit present in ``PlannedBudgetLimits`` . This only applies to budgets that are created with ``PlannedBudgetLimits`` . Budgets that are created without ``PlannedBudgetLimits`` only contain ``BudgetLimit`` . They don't contain ``PlannedBudgetLimits`` .
|
|
408
|
-
:param time_period: The period of time that is covered by a budget. The period has a start date and an end date. The start date must come before the end date. There are no restrictions on the end date. The start date for a budget. If you created your budget and didn't specify a start date, the start date defaults to the start of the chosen time period (MONTHLY, QUARTERLY, or ANNUALLY). For example, if you create your budget on January 24, 2019, choose ``MONTHLY`` , and don't set a start date, the start date defaults to ``01/01/19 00:00 UTC`` . The defaults are the same for the
|
|
408
|
+
:param time_period: The period of time that is covered by a budget. The period has a start date and an end date. The start date must come before the end date. There are no restrictions on the end date. The start date for a budget. If you created your budget and didn't specify a start date, the start date defaults to the start of the chosen time period (MONTHLY, QUARTERLY, or ANNUALLY). For example, if you create your budget on January 24, 2019, choose ``MONTHLY`` , and don't set a start date, the start date defaults to ``01/01/19 00:00 UTC`` . The defaults are the same for the Billing and Cost Management console and the API. You can change your start date with the ``UpdateBudget`` operation. After the end date, AWS deletes the budget and all associated notifications and subscribers.
|
|
409
409
|
|
|
410
410
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-budgets-budget-budgetdata.html
|
|
411
411
|
:exampleMetadata: fixture=_generated
|
|
@@ -606,7 +606,7 @@ class CfnBudget(
|
|
|
606
606
|
|
|
607
607
|
The period has a start date and an end date. The start date must come before the end date. There are no restrictions on the end date.
|
|
608
608
|
|
|
609
|
-
The start date for a budget. If you created your budget and didn't specify a start date, the start date defaults to the start of the chosen time period (MONTHLY, QUARTERLY, or ANNUALLY). For example, if you create your budget on January 24, 2019, choose ``MONTHLY`` , and don't set a start date, the start date defaults to ``01/01/19 00:00 UTC`` . The defaults are the same for the
|
|
609
|
+
The start date for a budget. If you created your budget and didn't specify a start date, the start date defaults to the start of the chosen time period (MONTHLY, QUARTERLY, or ANNUALLY). For example, if you create your budget on January 24, 2019, choose ``MONTHLY`` , and don't set a start date, the start date defaults to ``01/01/19 00:00 UTC`` . The defaults are the same for the Billing and Cost Management console and the API.
|
|
610
610
|
|
|
611
611
|
You can change your start date with the ``UpdateBudget`` operation.
|
|
612
612
|
|
|
@@ -1403,8 +1403,8 @@ class CfnBudget(
|
|
|
1403
1403
|
|
|
1404
1404
|
The period has a start date and an end date. The start date must come before the end date. There are no restrictions on the end date.
|
|
1405
1405
|
|
|
1406
|
-
:param end: The end date for a budget. If you didn't specify an end date, AWS set your end date to ``06/15/87 00:00 UTC`` . The defaults are the same for the
|
|
1407
|
-
:param start: The start date for a budget. If you created your budget and didn't specify a start date, the start date defaults to the start of the chosen time period (MONTHLY, QUARTERLY, or ANNUALLY). For example, if you create your budget on January 24, 2019, choose ``MONTHLY`` , and don't set a start date, the start date defaults to ``01/01/19 00:00 UTC`` . The defaults are the same for the
|
|
1406
|
+
:param end: The end date for a budget. If you didn't specify an end date, AWS set your end date to ``06/15/87 00:00 UTC`` . The defaults are the same for the Billing and Cost Management console and the API. After the end date, AWS deletes the budget and all the associated notifications and subscribers. You can change your end date with the ``UpdateBudget`` operation.
|
|
1407
|
+
:param start: The start date for a budget. If you created your budget and didn't specify a start date, the start date defaults to the start of the chosen time period (MONTHLY, QUARTERLY, or ANNUALLY). For example, if you create your budget on January 24, 2019, choose ``MONTHLY`` , and don't set a start date, the start date defaults to ``01/01/19 00:00 UTC`` . The defaults are the same for the Billing and Cost Management console and the API. You can change your start date with the ``UpdateBudget`` operation. Valid values depend on the value of ``BudgetType`` : - If ``BudgetType`` is ``COST`` or ``USAGE`` : Valid values are ``MONTHLY`` , ``QUARTERLY`` , and ``ANNUALLY`` . - If ``BudgetType`` is ``RI_UTILIZATION`` or ``RI_COVERAGE`` : Valid values are ``DAILY`` , ``MONTHLY`` , ``QUARTERLY`` , and ``ANNUALLY`` .
|
|
1408
1408
|
|
|
1409
1409
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-budgets-budget-timeperiod.html
|
|
1410
1410
|
:exampleMetadata: fixture=_generated
|
|
@@ -1434,7 +1434,7 @@ class CfnBudget(
|
|
|
1434
1434
|
def end(self) -> typing.Optional[builtins.str]:
|
|
1435
1435
|
'''The end date for a budget.
|
|
1436
1436
|
|
|
1437
|
-
If you didn't specify an end date, AWS set your end date to ``06/15/87 00:00 UTC`` . The defaults are the same for the
|
|
1437
|
+
If you didn't specify an end date, AWS set your end date to ``06/15/87 00:00 UTC`` . The defaults are the same for the Billing and Cost Management console and the API.
|
|
1438
1438
|
|
|
1439
1439
|
After the end date, AWS deletes the budget and all the associated notifications and subscribers. You can change your end date with the ``UpdateBudget`` operation.
|
|
1440
1440
|
|
|
@@ -1447,7 +1447,7 @@ class CfnBudget(
|
|
|
1447
1447
|
def start(self) -> typing.Optional[builtins.str]:
|
|
1448
1448
|
'''The start date for a budget.
|
|
1449
1449
|
|
|
1450
|
-
If you created your budget and didn't specify a start date, the start date defaults to the start of the chosen time period (MONTHLY, QUARTERLY, or ANNUALLY). For example, if you create your budget on January 24, 2019, choose ``MONTHLY`` , and don't set a start date, the start date defaults to ``01/01/19 00:00 UTC`` . The defaults are the same for the
|
|
1450
|
+
If you created your budget and didn't specify a start date, the start date defaults to the start of the chosen time period (MONTHLY, QUARTERLY, or ANNUALLY). For example, if you create your budget on January 24, 2019, choose ``MONTHLY`` , and don't set a start date, the start date defaults to ``01/01/19 00:00 UTC`` . The defaults are the same for the Billing and Cost Management console and the API.
|
|
1451
1451
|
|
|
1452
1452
|
You can change your start date with the ``UpdateBudget`` operation.
|
|
1453
1453
|
|
|
@@ -1642,7 +1642,7 @@ class CfnBudgetsAction(
|
|
|
1642
1642
|
):
|
|
1643
1643
|
'''The ``AWS::Budgets::BudgetsAction`` resource enables you to take predefined actions that are initiated when a budget threshold has been exceeded.
|
|
1644
1644
|
|
|
1645
|
-
For more information, see `Managing Your Costs with Budgets <https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/budgets-managing-costs.html>`_ in the *
|
|
1645
|
+
For more information, see `Managing Your Costs with Budgets <https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/budgets-managing-costs.html>`_ in the *Billing and Cost Management User Guide* .
|
|
1646
1646
|
|
|
1647
1647
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-budgets-budgetsaction.html
|
|
1648
1648
|
:cloudformationResource: AWS::Budgets::BudgetsAction
|
|
@@ -263,7 +263,7 @@ class CfnKeyspace(
|
|
|
263
263
|
|
|
264
264
|
For more information about multi-Region replication, see `Multi-Region replication <https://docs.aws.amazon.com/keyspaces/latest/devguide/multiRegion-replication.html>`_ in the *Amazon Keyspaces Developer Guide* .
|
|
265
265
|
|
|
266
|
-
:param region_list: Specifies the AWS Regions that the keyspace is replicated in. You must specify at least two
|
|
266
|
+
:param region_list: Specifies the AWS Regions that the keyspace is replicated in. You must specify at least two Regions, including the Region that the keyspace is being created in. To specify a Region `that's disabled by default <https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html#rande-manage-enable>`_ , you must first enable the Region. For more information, see `Multi-Region replication in AWS Regions disabled by default <https://docs.aws.amazon.com/keyspaces/latest/devguide/multiRegion-replication_how-it-works.html#howitworks_mrr_opt_in>`_ in the *Amazon Keyspaces Developer Guide* .
|
|
267
267
|
:param replication_strategy: The options are:. - ``SINGLE_REGION`` (optional) - ``MULTI_REGION`` If no value is specified, the default is ``SINGLE_REGION`` . If ``MULTI_REGION`` is specified, ``RegionList`` is required.
|
|
268
268
|
|
|
269
269
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cassandra-keyspace-replicationspecification.html
|
|
@@ -294,7 +294,9 @@ class CfnKeyspace(
|
|
|
294
294
|
def region_list(self) -> typing.Optional[typing.List[builtins.str]]:
|
|
295
295
|
'''Specifies the AWS Regions that the keyspace is replicated in.
|
|
296
296
|
|
|
297
|
-
You must specify at least two
|
|
297
|
+
You must specify at least two Regions, including the Region that the keyspace is being created in.
|
|
298
|
+
|
|
299
|
+
To specify a Region `that's disabled by default <https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html#rande-manage-enable>`_ , you must first enable the Region. For more information, see `Multi-Region replication in AWS Regions disabled by default <https://docs.aws.amazon.com/keyspaces/latest/devguide/multiRegion-replication_how-it-works.html#howitworks_mrr_opt_in>`_ in the *Amazon Keyspaces Developer Guide* .
|
|
298
300
|
|
|
299
301
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cassandra-keyspace-replicationspecification.html#cfn-cassandra-keyspace-replicationspecification-regionlist
|
|
300
302
|
'''
|
aws_cdk/aws_ce/__init__.py
CHANGED
|
@@ -1076,9 +1076,9 @@ class CfnCostCategory(
|
|
|
1076
1076
|
metaclass=jsii.JSIIMeta,
|
|
1077
1077
|
jsii_type="aws-cdk-lib.aws_ce.CfnCostCategory",
|
|
1078
1078
|
):
|
|
1079
|
-
'''The ``AWS::CE::CostCategory`` resource creates groupings of cost that you can use across products in the
|
|
1079
|
+
'''The ``AWS::CE::CostCategory`` resource creates groupings of cost that you can use across products in the Billing and Cost Management console, such as Cost Explorer and AWS Budgets.
|
|
1080
1080
|
|
|
1081
|
-
For more information, see `Managing Your Costs with Cost Categories <https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/manage-cost-categories.html>`_ in the *
|
|
1081
|
+
For more information, see `Managing Your Costs with Cost Categories <https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/manage-cost-categories.html>`_ in the *Billing and Cost Management User Guide* .
|
|
1082
1082
|
|
|
1083
1083
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ce-costcategory.html
|
|
1084
1084
|
:cloudformationResource: AWS::CE::CostCategory
|
|
@@ -5460,7 +5460,7 @@ class CfnStack(
|
|
|
5460
5460
|
You must acknowledge IAM capabilities for nested stacks that contain IAM resources. Also, verify that you have cancel update stack permissions, which is required if an update rolls back. For more information about IAM and CloudFormation , see `Controlling access with AWS Identity and Access Management <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/control-access-with-iam.html>`_ in the *AWS CloudFormation User Guide* .
|
|
5461
5461
|
.. epigraph::
|
|
5462
5462
|
|
|
5463
|
-
A subset of ``AWS::CloudFormation::Stack`` resource type properties listed below are available to customers using CloudFormation , AWS CDK , and
|
|
5463
|
+
A subset of ``AWS::CloudFormation::Stack`` resource type properties listed below are available to customers using CloudFormation , AWS CDK , and Cloud Control to configure.
|
|
5464
5464
|
|
|
5465
5465
|
- ``NotificationARNs``
|
|
5466
5466
|
- ``Parameters``
|
|
@@ -5468,7 +5468,7 @@ class CfnStack(
|
|
|
5468
5468
|
- ``TemplateURL``
|
|
5469
5469
|
- ``TimeoutInMinutes``
|
|
5470
5470
|
|
|
5471
|
-
These properties can be configured only when using
|
|
5471
|
+
These properties can be configured only when using Cloud Control . This is because the below properties are set by the parent stack, and thus cannot be configured using CloudFormation or AWS CDK but only Cloud Control .
|
|
5472
5472
|
|
|
5473
5473
|
- ``Capabilities``
|
|
5474
5474
|
- ``Description``
|
|
@@ -5483,7 +5483,7 @@ class CfnStack(
|
|
|
5483
5483
|
|
|
5484
5484
|
Customers that configure ``AWS::CloudFormation::Stack`` using CloudFormation and AWS CDK can do so for nesting a CloudFormation stack as a resource in their top-level template.
|
|
5485
5485
|
|
|
5486
|
-
These read-only properties can be accessed only when using
|
|
5486
|
+
These read-only properties can be accessed only when using Cloud Control .
|
|
5487
5487
|
|
|
5488
5488
|
- ``ChangeSetId``
|
|
5489
5489
|
- ``CreationTime``
|
|
@@ -19123,6 +19123,7 @@ class ImportSource(
|
|
|
19123
19123
|
path: builtins.str,
|
|
19124
19124
|
*,
|
|
19125
19125
|
deploy_time: typing.Optional[builtins.bool] = None,
|
|
19126
|
+
display_name: typing.Optional[builtins.str] = None,
|
|
19126
19127
|
readers: typing.Optional[typing.Sequence[_IGrantable_71c4f5de]] = None,
|
|
19127
19128
|
source_kms_key: typing.Optional[_IKey_5f11635f] = None,
|
|
19128
19129
|
asset_hash: typing.Optional[builtins.str] = None,
|
|
@@ -19136,6 +19137,7 @@ class ImportSource(
|
|
|
19136
19137
|
|
|
19137
19138
|
:param path: the path to the local file.
|
|
19138
19139
|
:param deploy_time: Whether or not the asset needs to exist beyond deployment time; i.e. are copied over to a different location and not needed afterwards. Setting this property to true has an impact on the lifecycle of the asset, because we will assume that it is safe to delete after the CloudFormation deployment succeeds. For example, Lambda Function assets are copied over to Lambda during deployment. Therefore, it is not necessary to store the asset in S3, so we consider those deployTime assets. Default: false
|
|
19140
|
+
:param display_name: A display name for this asset. If supplied, the display name will be used in locations where the asset identifier is printed, like in the CLI progress information. If the same asset is added multiple times, the display name of the first occurrence is used. The default is the construct path of the Asset construct, with respect to the enclosing stack. If the asset is produced by a construct helper function (such as ``lambda.Code.fromAsset()``), this will look like ``MyFunction/Code``. We use the stack-relative construct path so that in the common case where you have multiple stacks with the same asset, we won't show something like ``/MyBetaStack/MyFunction/Code`` when you are actually deploying to production. Default: - Stack-relative construct path
|
|
19139
19141
|
:param readers: A list of principals that should be able to read this asset from S3. You can use ``asset.grantRead(principal)`` to grant read permissions later. Default: - No principals that can read file asset.
|
|
19140
19142
|
:param source_kms_key: The ARN of the KMS key used to encrypt the handler code. Default: - the default server-side encryption with Amazon S3 managed keys(SSE-S3) key will be used.
|
|
19141
19143
|
:param asset_hash: Specify a custom hash for this asset. If ``assetHashType`` is set it must be set to ``AssetHashType.CUSTOM``. For consistency, this custom hash will be SHA256 hashed and encoded as hex. The resulting hash will be the asset hash. NOTE: the hash is used in order to identify a specific revision of the asset, and used for optimizing and caching deployment activities related to this asset such as packaging, uploading to Amazon S3, etc. If you chose to customize the hash, you will need to make sure it is updated every time the asset changes, or otherwise it is possible that some deployments will not be invalidated. Default: - based on ``assetHashType``
|
|
@@ -19150,6 +19152,7 @@ class ImportSource(
|
|
|
19150
19152
|
check_type(argname="argument path", value=path, expected_type=type_hints["path"])
|
|
19151
19153
|
options = _AssetOptions_2aa69621(
|
|
19152
19154
|
deploy_time=deploy_time,
|
|
19155
|
+
display_name=display_name,
|
|
19153
19156
|
readers=readers,
|
|
19154
19157
|
source_kms_key=source_kms_key,
|
|
19155
19158
|
asset_hash=asset_hash,
|
|
@@ -19253,6 +19256,7 @@ class InlineImportSource(
|
|
|
19253
19256
|
working_directory="workingDirectory"
|
|
19254
19257
|
),
|
|
19255
19258
|
deploy_time=False,
|
|
19259
|
+
display_name="displayName",
|
|
19256
19260
|
exclude=["exclude"],
|
|
19257
19261
|
follow_symlinks=cdk.SymlinkFollowMode.NEVER,
|
|
19258
19262
|
ignore_mode=cdk.IgnoreMode.GLOB,
|
|
@@ -23513,6 +23517,7 @@ class S3ImportSource(
|
|
|
23513
23517
|
working_directory="workingDirectory"
|
|
23514
23518
|
),
|
|
23515
23519
|
deploy_time=False,
|
|
23520
|
+
display_name="displayName",
|
|
23516
23521
|
exclude=["exclude"],
|
|
23517
23522
|
follow_symlinks=cdk.SymlinkFollowMode.NEVER,
|
|
23518
23523
|
ignore_mode=cdk.IgnoreMode.GLOB,
|
|
@@ -25226,6 +25231,7 @@ class AssetImportSource(
|
|
|
25226
25231
|
working_directory="workingDirectory"
|
|
25227
25232
|
),
|
|
25228
25233
|
deploy_time=False,
|
|
25234
|
+
display_name="displayName",
|
|
25229
25235
|
exclude=["exclude"],
|
|
25230
25236
|
follow_symlinks=cdk.SymlinkFollowMode.NEVER,
|
|
25231
25237
|
ignore_mode=cdk.IgnoreMode.GLOB,
|
|
@@ -25239,6 +25245,7 @@ class AssetImportSource(
|
|
|
25239
25245
|
path: builtins.str,
|
|
25240
25246
|
*,
|
|
25241
25247
|
deploy_time: typing.Optional[builtins.bool] = None,
|
|
25248
|
+
display_name: typing.Optional[builtins.str] = None,
|
|
25242
25249
|
readers: typing.Optional[typing.Sequence[_IGrantable_71c4f5de]] = None,
|
|
25243
25250
|
source_kms_key: typing.Optional[_IKey_5f11635f] = None,
|
|
25244
25251
|
asset_hash: typing.Optional[builtins.str] = None,
|
|
@@ -25251,6 +25258,7 @@ class AssetImportSource(
|
|
|
25251
25258
|
'''
|
|
25252
25259
|
:param path: the path to the local file.
|
|
25253
25260
|
:param deploy_time: Whether or not the asset needs to exist beyond deployment time; i.e. are copied over to a different location and not needed afterwards. Setting this property to true has an impact on the lifecycle of the asset, because we will assume that it is safe to delete after the CloudFormation deployment succeeds. For example, Lambda Function assets are copied over to Lambda during deployment. Therefore, it is not necessary to store the asset in S3, so we consider those deployTime assets. Default: false
|
|
25261
|
+
:param display_name: A display name for this asset. If supplied, the display name will be used in locations where the asset identifier is printed, like in the CLI progress information. If the same asset is added multiple times, the display name of the first occurrence is used. The default is the construct path of the Asset construct, with respect to the enclosing stack. If the asset is produced by a construct helper function (such as ``lambda.Code.fromAsset()``), this will look like ``MyFunction/Code``. We use the stack-relative construct path so that in the common case where you have multiple stacks with the same asset, we won't show something like ``/MyBetaStack/MyFunction/Code`` when you are actually deploying to production. Default: - Stack-relative construct path
|
|
25254
25262
|
:param readers: A list of principals that should be able to read this asset from S3. You can use ``asset.grantRead(principal)`` to grant read permissions later. Default: - No principals that can read file asset.
|
|
25255
25263
|
:param source_kms_key: The ARN of the KMS key used to encrypt the handler code. Default: - the default server-side encryption with Amazon S3 managed keys(SSE-S3) key will be used.
|
|
25256
25264
|
:param asset_hash: Specify a custom hash for this asset. If ``assetHashType`` is set it must be set to ``AssetHashType.CUSTOM``. For consistency, this custom hash will be SHA256 hashed and encoded as hex. The resulting hash will be the asset hash. NOTE: the hash is used in order to identify a specific revision of the asset, and used for optimizing and caching deployment activities related to this asset such as packaging, uploading to Amazon S3, etc. If you chose to customize the hash, you will need to make sure it is updated every time the asset changes, or otherwise it is possible that some deployments will not be invalidated. Default: - based on ``assetHashType``
|
|
@@ -25265,6 +25273,7 @@ class AssetImportSource(
|
|
|
25265
25273
|
check_type(argname="argument path", value=path, expected_type=type_hints["path"])
|
|
25266
25274
|
options = _AssetOptions_2aa69621(
|
|
25267
25275
|
deploy_time=deploy_time,
|
|
25276
|
+
display_name=display_name,
|
|
25268
25277
|
readers=readers,
|
|
25269
25278
|
source_kms_key=source_kms_key,
|
|
25270
25279
|
asset_hash=asset_hash,
|
|
@@ -28824,6 +28833,7 @@ def _typecheckingstub__f5d4750ca4d7703f815ca46be8b91e46ea0b813f42846026dff63e00f
|
|
|
28824
28833
|
path: builtins.str,
|
|
28825
28834
|
*,
|
|
28826
28835
|
deploy_time: typing.Optional[builtins.bool] = None,
|
|
28836
|
+
display_name: typing.Optional[builtins.str] = None,
|
|
28827
28837
|
readers: typing.Optional[typing.Sequence[_IGrantable_71c4f5de]] = None,
|
|
28828
28838
|
source_kms_key: typing.Optional[_IKey_5f11635f] = None,
|
|
28829
28839
|
asset_hash: typing.Optional[builtins.str] = None,
|
|
@@ -29496,6 +29506,7 @@ def _typecheckingstub__62441d3d3228ae5fb69aaca12e603944f07f9335dae80f70ce3b04e8e
|
|
|
29496
29506
|
path: builtins.str,
|
|
29497
29507
|
*,
|
|
29498
29508
|
deploy_time: typing.Optional[builtins.bool] = None,
|
|
29509
|
+
display_name: typing.Optional[builtins.str] = None,
|
|
29499
29510
|
readers: typing.Optional[typing.Sequence[_IGrantable_71c4f5de]] = None,
|
|
29500
29511
|
source_kms_key: typing.Optional[_IKey_5f11635f] = None,
|
|
29501
29512
|
asset_hash: typing.Optional[builtins.str] = None,
|
|
@@ -1980,7 +1980,7 @@ class CfnEventDataStore(
|
|
|
1980
1980
|
) -> None:
|
|
1981
1981
|
'''A single selector statement in an advanced event selector.
|
|
1982
1982
|
|
|
1983
|
-
:param field: A field in a CloudTrail event record on which to filter events to be logged. For event data stores for CloudTrail Insights events, AWS Config configuration items, Audit Manager evidence, or events outside of AWS , the field is used only for selecting events as filtering is not supported. For CloudTrail management events, supported fields include ``eventCategory`` (required), ``eventSource`` , and ``readOnly`` . The following additional fields are available for event data stores: ``eventName`` , ``eventType`` , ``sessionCredentialFromConsole`` , and ``userIdentity.arn`` . For CloudTrail data events, supported fields include ``eventCategory`` (required), ``resources.type`` (required), ``eventName`` , ``readOnly`` , and ``resources.ARN`` . The following additional fields are available for event data stores: ``eventSource`` , ``eventType`` , ``sessionCredentialFromConsole`` , and ``userIdentity.arn`` . For CloudTrail network activity events, supported fields include ``eventCategory`` (required), ``eventSource`` (required), ``eventName`` , ``errorCode`` , and ``vpcEndpointId`` . For event data stores for CloudTrail Insights events, AWS Config configuration items, Audit Manager evidence, or events outside of AWS , the only supported field is ``eventCategory`` . .. epigraph:: Selectors don't support the use of wildcards like ``*`` . To match multiple values with a single condition, you may use ``StartsWith`` , ``EndsWith`` , ``NotStartsWith`` , or ``NotEndsWith`` to explicitly match the beginning or end of the event field. - *``readOnly``* - This is an optional field that is only used for management events and data events. This field can be set to ``Equals`` with a value of ``true`` or ``false`` . If you do not add this field, CloudTrail logs both ``read`` and ``write`` events. A value of ``true`` logs only ``read`` events. A value of ``false`` logs only ``write`` events. - *``eventSource``* - This field is only used for management events, data events (for event data stores only), and network activity events. For management events for trails, this is an optional field that can be set to ``NotEquals`` ``kms.amazonaws.com`` to exclude KMS management events, or ``NotEquals`` ``rdsdata.amazonaws.com`` to exclude RDS management events. For management and data events for event data stores, you can use it to include or exclude any event source and can use any operator. For network activity events, this is a required field that only uses the ``Equals`` operator. Set this field to the event source for which you want to log network activity events. If you want to log network activity events for multiple event sources, you must create a separate field selector for each event source.
|
|
1983
|
+
:param field: A field in a CloudTrail event record on which to filter events to be logged. For event data stores for CloudTrail Insights events, AWS Config configuration items, Audit Manager evidence, or events outside of AWS , the field is used only for selecting events as filtering is not supported. For CloudTrail management events, supported fields include ``eventCategory`` (required), ``eventSource`` , and ``readOnly`` . The following additional fields are available for event data stores: ``eventName`` , ``eventType`` , ``sessionCredentialFromConsole`` , and ``userIdentity.arn`` . For CloudTrail data events, supported fields include ``eventCategory`` (required), ``resources.type`` (required), ``eventName`` , ``readOnly`` , and ``resources.ARN`` . The following additional fields are available for event data stores: ``eventSource`` , ``eventType`` , ``sessionCredentialFromConsole`` , and ``userIdentity.arn`` . For CloudTrail network activity events, supported fields include ``eventCategory`` (required), ``eventSource`` (required), ``eventName`` , ``errorCode`` , and ``vpcEndpointId`` . For event data stores for CloudTrail Insights events, AWS Config configuration items, Audit Manager evidence, or events outside of AWS , the only supported field is ``eventCategory`` . .. epigraph:: Selectors don't support the use of wildcards like ``*`` . To match multiple values with a single condition, you may use ``StartsWith`` , ``EndsWith`` , ``NotStartsWith`` , or ``NotEndsWith`` to explicitly match the beginning or end of the event field. - *``readOnly``* - This is an optional field that is only used for management events and data events. This field can be set to ``Equals`` with a value of ``true`` or ``false`` . If you do not add this field, CloudTrail logs both ``read`` and ``write`` events. A value of ``true`` logs only ``read`` events. A value of ``false`` logs only ``write`` events. - *``eventSource``* - This field is only used for management events, data events (for event data stores only), and network activity events. For management events for trails, this is an optional field that can be set to ``NotEquals`` ``kms.amazonaws.com`` to exclude KMS management events, or ``NotEquals`` ``rdsdata.amazonaws.com`` to exclude RDS management events. For management and data events for event data stores, you can use it to include or exclude any event source and can use any operator. For network activity events, this is a required field that only uses the ``Equals`` operator. Set this field to the event source for which you want to log network activity events. If you want to log network activity events for multiple event sources, you must create a separate field selector for each event source. For a list of services supporting network activity events, see `Logging network activity events <https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-network-events-with-cloudtrail.html>`_ in the *AWS CloudTrail User Guide* . - *``eventName``* - This is an optional field that is only used for data events, management events (for event data stores only), and network activity events. You can use any operator with ``eventName`` . You can use it to filter in or filter out specific events. You can have multiple values for this field, separated by commas. - *``eventCategory``* - This field is required and must be set to ``Equals`` . - For CloudTrail management events, the value must be ``Management`` . - For CloudTrail data events, the value must be ``Data`` . - For CloudTrail network activity events, the value must be ``NetworkActivity`` . The following are used only for event data stores: - For CloudTrail Insights events, the value must be ``Insight`` . - For AWS Config configuration items, the value must be ``ConfigurationItem`` . - For Audit Manager evidence, the value must be ``Evidence`` . - For events outside of AWS , the value must be ``ActivityAuditLog`` . - *``eventType``* - This is an optional field available only for event data stores, which is used to filter management and data events on the event type. For information about available event types, see `CloudTrail record contents <https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-record-contents.html#ct-event-type>`_ in the *AWS CloudTrail user guide* . - *``errorCode``* - This field is only used to filter CloudTrail network activity events and is optional. This is the error code to filter on. Currently, the only valid ``errorCode`` is ``VpceAccessDenied`` . ``errorCode`` can only use the ``Equals`` operator. - *``sessionCredentialFromConsole``* - This is an optional field available only for event data stores, which is used to filter management and data events based on whether the events originated from an AWS Management Console session. ``sessionCredentialFromConsole`` can only use the ``Equals`` and ``NotEquals`` operators. - *``resources.type``* - This field is required for CloudTrail data events. ``resources.type`` can only use the ``Equals`` operator. For a list of available resource types for data events, see `Data events <https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#logging-data-events>`_ in the *AWS CloudTrail User Guide* . You can have only one ``resources.type`` field per selector. To log events on more than one resource type, add another selector. - *``resources.ARN``* - The ``resources.ARN`` is an optional field for data events. You can use any operator with ``resources.ARN`` , but if you use ``Equals`` or ``NotEquals`` , the value must exactly match the ARN of a valid resource of the type you've specified in the template as the value of resources.type. To log all data events for all objects in a specific S3 bucket, use the ``StartsWith`` operator, and include only the bucket ARN as the matching value. For more information about the ARN formats of data event resources, see `Actions, resources, and condition keys for AWS services <https://docs.aws.amazon.com/service-authorization/latest/reference/reference_policies_actions-resources-contextkeys.html>`_ in the *Service Authorization Reference* . .. epigraph:: You can't use the ``resources.ARN`` field to filter resource types that do not have ARNs. - *``userIdentity.arn``* - This is an optional field available only for event data stores, which is used to filter management and data events on the userIdentity ARN. You can use any operator with ``userIdentity.arn`` . For more information on the userIdentity element, see `CloudTrail userIdentity element <https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html>`_ in the *AWS CloudTrail User Guide* . - *``vpcEndpointId``* - This field is only used to filter CloudTrail network activity events and is optional. This field identifies the VPC endpoint that the request passed through. You can use any operator with ``vpcEndpointId`` .
|
|
1984
1984
|
:param ends_with: An operator that includes events that match the last few characters of the event record field specified as the value of ``Field`` .
|
|
1985
1985
|
:param equal_to: An operator that includes events that match the exact value of the event record field specified as the value of ``Field`` . This is the only valid operator that you can use with the ``readOnly`` , ``eventCategory`` , and ``resources.type`` fields.
|
|
1986
1986
|
:param not_ends_with: An operator that excludes events that match the last few characters of the event record field specified as the value of ``Field`` .
|
|
@@ -2058,15 +2058,8 @@ class CfnEventDataStore(
|
|
|
2058
2058
|
|
|
2059
2059
|
For management and data events for event data stores, you can use it to include or exclude any event source and can use any operator.
|
|
2060
2060
|
|
|
2061
|
-
For network activity events, this is a required field that only uses the ``Equals`` operator. Set this field to the event source for which you want to log network activity events. If you want to log network activity events for multiple event sources, you must create a separate field selector for each event source.
|
|
2061
|
+
For network activity events, this is a required field that only uses the ``Equals`` operator. Set this field to the event source for which you want to log network activity events. If you want to log network activity events for multiple event sources, you must create a separate field selector for each event source. For a list of services supporting network activity events, see `Logging network activity events <https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-network-events-with-cloudtrail.html>`_ in the *AWS CloudTrail User Guide* .
|
|
2062
2062
|
|
|
2063
|
-
The following are valid values for network activity events:
|
|
2064
|
-
|
|
2065
|
-
- ``cloudtrail.amazonaws.com``
|
|
2066
|
-
- ``ec2.amazonaws.com``
|
|
2067
|
-
- ``kms.amazonaws.com``
|
|
2068
|
-
- ``s3.amazonaws.com``
|
|
2069
|
-
- ``secretsmanager.amazonaws.com``
|
|
2070
2063
|
- *``eventName``* - This is an optional field that is only used for data events, management events (for event data stores only), and network activity events. You can use any operator with ``eventName`` . You can use it to filter in or filter out specific events. You can have multiple values for this field, separated by commas.
|
|
2071
2064
|
- *``eventCategory``* - This field is required and must be set to ``Equals`` .
|
|
2072
2065
|
- For CloudTrail management events, the value must be ``Management`` .
|
|
@@ -3386,7 +3379,7 @@ class CfnTrail(
|
|
|
3386
3379
|
) -> None:
|
|
3387
3380
|
'''A single selector statement in an advanced event selector.
|
|
3388
3381
|
|
|
3389
|
-
:param field: A field in a CloudTrail event record on which to filter events to be logged. For event data stores for CloudTrail Insights events, AWS Config configuration items, Audit Manager evidence, or events outside of AWS , the field is used only for selecting events as filtering is not supported. For CloudTrail management events, supported fields include ``eventCategory`` (required), ``eventSource`` , and ``readOnly`` . The following additional fields are available for event data stores: ``eventName`` , ``eventType`` , ``sessionCredentialFromConsole`` , and ``userIdentity.arn`` . For CloudTrail data events, supported fields include ``eventCategory`` (required), ``resources.type`` (required), ``eventName`` , ``readOnly`` , and ``resources.ARN`` . The following additional fields are available for event data stores: ``eventSource`` , ``eventType`` , ``sessionCredentialFromConsole`` , and ``userIdentity.arn`` . For CloudTrail network activity events, supported fields include ``eventCategory`` (required), ``eventSource`` (required), ``eventName`` , ``errorCode`` , and ``vpcEndpointId`` . For event data stores for CloudTrail Insights events, AWS Config configuration items, Audit Manager evidence, or events outside of AWS , the only supported field is ``eventCategory`` . .. epigraph:: Selectors don't support the use of wildcards like ``*`` . To match multiple values with a single condition, you may use ``StartsWith`` , ``EndsWith`` , ``NotStartsWith`` , or ``NotEndsWith`` to explicitly match the beginning or end of the event field. - *``readOnly``* - This is an optional field that is only used for management events and data events. This field can be set to ``Equals`` with a value of ``true`` or ``false`` . If you do not add this field, CloudTrail logs both ``read`` and ``write`` events. A value of ``true`` logs only ``read`` events. A value of ``false`` logs only ``write`` events. - *``eventSource``* - This field is only used for management events, data events (for event data stores only), and network activity events. For management events for trails, this is an optional field that can be set to ``NotEquals`` ``kms.amazonaws.com`` to exclude KMS management events, or ``NotEquals`` ``rdsdata.amazonaws.com`` to exclude RDS management events. For management and data events for event data stores, you can use it to include or exclude any event source and can use any operator. For network activity events, this is a required field that only uses the ``Equals`` operator. Set this field to the event source for which you want to log network activity events. If you want to log network activity events for multiple event sources, you must create a separate field selector for each event source.
|
|
3382
|
+
:param field: A field in a CloudTrail event record on which to filter events to be logged. For event data stores for CloudTrail Insights events, AWS Config configuration items, Audit Manager evidence, or events outside of AWS , the field is used only for selecting events as filtering is not supported. For CloudTrail management events, supported fields include ``eventCategory`` (required), ``eventSource`` , and ``readOnly`` . The following additional fields are available for event data stores: ``eventName`` , ``eventType`` , ``sessionCredentialFromConsole`` , and ``userIdentity.arn`` . For CloudTrail data events, supported fields include ``eventCategory`` (required), ``resources.type`` (required), ``eventName`` , ``readOnly`` , and ``resources.ARN`` . The following additional fields are available for event data stores: ``eventSource`` , ``eventType`` , ``sessionCredentialFromConsole`` , and ``userIdentity.arn`` . For CloudTrail network activity events, supported fields include ``eventCategory`` (required), ``eventSource`` (required), ``eventName`` , ``errorCode`` , and ``vpcEndpointId`` . For event data stores for CloudTrail Insights events, AWS Config configuration items, Audit Manager evidence, or events outside of AWS , the only supported field is ``eventCategory`` . .. epigraph:: Selectors don't support the use of wildcards like ``*`` . To match multiple values with a single condition, you may use ``StartsWith`` , ``EndsWith`` , ``NotStartsWith`` , or ``NotEndsWith`` to explicitly match the beginning or end of the event field. - *``readOnly``* - This is an optional field that is only used for management events and data events. This field can be set to ``Equals`` with a value of ``true`` or ``false`` . If you do not add this field, CloudTrail logs both ``read`` and ``write`` events. A value of ``true`` logs only ``read`` events. A value of ``false`` logs only ``write`` events. - *``eventSource``* - This field is only used for management events, data events (for event data stores only), and network activity events. For management events for trails, this is an optional field that can be set to ``NotEquals`` ``kms.amazonaws.com`` to exclude KMS management events, or ``NotEquals`` ``rdsdata.amazonaws.com`` to exclude RDS management events. For management and data events for event data stores, you can use it to include or exclude any event source and can use any operator. For network activity events, this is a required field that only uses the ``Equals`` operator. Set this field to the event source for which you want to log network activity events. If you want to log network activity events for multiple event sources, you must create a separate field selector for each event source. For a list of services supporting network activity events, see `Logging network activity events <https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-network-events-with-cloudtrail.html>`_ in the *AWS CloudTrail User Guide* . - *``eventName``* - This is an optional field that is only used for data events, management events (for event data stores only), and network activity events. You can use any operator with ``eventName`` . You can use it to filter in or filter out specific events. You can have multiple values for this field, separated by commas. - *``eventCategory``* - This field is required and must be set to ``Equals`` . - For CloudTrail management events, the value must be ``Management`` . - For CloudTrail data events, the value must be ``Data`` . - For CloudTrail network activity events, the value must be ``NetworkActivity`` . The following are used only for event data stores: - For CloudTrail Insights events, the value must be ``Insight`` . - For AWS Config configuration items, the value must be ``ConfigurationItem`` . - For Audit Manager evidence, the value must be ``Evidence`` . - For events outside of AWS , the value must be ``ActivityAuditLog`` . - *``eventType``* - This is an optional field available only for event data stores, which is used to filter management and data events on the event type. For information about available event types, see `CloudTrail record contents <https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-record-contents.html#ct-event-type>`_ in the *AWS CloudTrail user guide* . - *``errorCode``* - This field is only used to filter CloudTrail network activity events and is optional. This is the error code to filter on. Currently, the only valid ``errorCode`` is ``VpceAccessDenied`` . ``errorCode`` can only use the ``Equals`` operator. - *``sessionCredentialFromConsole``* - This is an optional field available only for event data stores, which is used to filter management and data events based on whether the events originated from an AWS Management Console session. ``sessionCredentialFromConsole`` can only use the ``Equals`` and ``NotEquals`` operators. - *``resources.type``* - This field is required for CloudTrail data events. ``resources.type`` can only use the ``Equals`` operator. For a list of available resource types for data events, see `Data events <https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#logging-data-events>`_ in the *AWS CloudTrail User Guide* . You can have only one ``resources.type`` field per selector. To log events on more than one resource type, add another selector. - *``resources.ARN``* - The ``resources.ARN`` is an optional field for data events. You can use any operator with ``resources.ARN`` , but if you use ``Equals`` or ``NotEquals`` , the value must exactly match the ARN of a valid resource of the type you've specified in the template as the value of resources.type. To log all data events for all objects in a specific S3 bucket, use the ``StartsWith`` operator, and include only the bucket ARN as the matching value. For more information about the ARN formats of data event resources, see `Actions, resources, and condition keys for AWS services <https://docs.aws.amazon.com/service-authorization/latest/reference/reference_policies_actions-resources-contextkeys.html>`_ in the *Service Authorization Reference* . .. epigraph:: You can't use the ``resources.ARN`` field to filter resource types that do not have ARNs. - *``userIdentity.arn``* - This is an optional field available only for event data stores, which is used to filter management and data events on the userIdentity ARN. You can use any operator with ``userIdentity.arn`` . For more information on the userIdentity element, see `CloudTrail userIdentity element <https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html>`_ in the *AWS CloudTrail User Guide* . - *``vpcEndpointId``* - This field is only used to filter CloudTrail network activity events and is optional. This field identifies the VPC endpoint that the request passed through. You can use any operator with ``vpcEndpointId`` .
|
|
3390
3383
|
:param ends_with: An operator that includes events that match the last few characters of the event record field specified as the value of ``Field`` .
|
|
3391
3384
|
:param equal_to: An operator that includes events that match the exact value of the event record field specified as the value of ``Field`` . This is the only valid operator that you can use with the ``readOnly`` , ``eventCategory`` , and ``resources.type`` fields.
|
|
3392
3385
|
:param not_ends_with: An operator that excludes events that match the last few characters of the event record field specified as the value of ``Field`` .
|
|
@@ -3464,15 +3457,8 @@ class CfnTrail(
|
|
|
3464
3457
|
|
|
3465
3458
|
For management and data events for event data stores, you can use it to include or exclude any event source and can use any operator.
|
|
3466
3459
|
|
|
3467
|
-
For network activity events, this is a required field that only uses the ``Equals`` operator. Set this field to the event source for which you want to log network activity events. If you want to log network activity events for multiple event sources, you must create a separate field selector for each event source.
|
|
3468
|
-
|
|
3469
|
-
The following are valid values for network activity events:
|
|
3460
|
+
For network activity events, this is a required field that only uses the ``Equals`` operator. Set this field to the event source for which you want to log network activity events. If you want to log network activity events for multiple event sources, you must create a separate field selector for each event source. For a list of services supporting network activity events, see `Logging network activity events <https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-network-events-with-cloudtrail.html>`_ in the *AWS CloudTrail User Guide* .
|
|
3470
3461
|
|
|
3471
|
-
- ``cloudtrail.amazonaws.com``
|
|
3472
|
-
- ``ec2.amazonaws.com``
|
|
3473
|
-
- ``kms.amazonaws.com``
|
|
3474
|
-
- ``s3.amazonaws.com``
|
|
3475
|
-
- ``secretsmanager.amazonaws.com``
|
|
3476
3462
|
- *``eventName``* - This is an optional field that is only used for data events, management events (for event data stores only), and network activity events. You can use any operator with ``eventName`` . You can use it to filter in or filter out specific events. You can have multiple values for this field, separated by commas.
|
|
3477
3463
|
- *``eventCategory``* - This field is required and must be set to ``Equals`` .
|
|
3478
3464
|
- For CloudTrail management events, the value must be ``Management`` .
|
|
@@ -10847,23 +10847,19 @@ class Statistic(enum.Enum):
|
|
|
10847
10847
|
|
|
10848
10848
|
Example::
|
|
10849
10849
|
|
|
10850
|
-
|
|
10851
|
-
|
|
10852
|
-
# delivery_stream: firehose.DeliveryStream
|
|
10853
|
-
|
|
10850
|
+
# matchmaking_rule_set: gamelift.MatchmakingRuleSet
|
|
10854
10851
|
|
|
10855
|
-
# Alarm that triggers when the per-second average of
|
|
10856
|
-
|
|
10857
|
-
expression="
|
|
10852
|
+
# Alarm that triggers when the per-second average of not placed matches exceed 10%
|
|
10853
|
+
rule_evaluation_ratio = cloudwatch.MathExpression(
|
|
10854
|
+
expression="1 - (ruleEvaluationsPassed / ruleEvaluationsFailed)",
|
|
10858
10855
|
using_metrics={
|
|
10859
|
-
"
|
|
10860
|
-
"
|
|
10856
|
+
"rule_evaluations_passed": matchmaking_rule_set.metric_rule_evaluations_passed(statistic=cloudwatch.Statistic.SUM),
|
|
10857
|
+
"rule_evaluations_failed": matchmaking_rule_set.metric("ruleEvaluationsFailed")
|
|
10861
10858
|
}
|
|
10862
10859
|
)
|
|
10863
|
-
|
|
10864
10860
|
cloudwatch.Alarm(self, "Alarm",
|
|
10865
|
-
metric=
|
|
10866
|
-
threshold=0.
|
|
10861
|
+
metric=rule_evaluation_ratio,
|
|
10862
|
+
threshold=0.1,
|
|
10867
10863
|
evaluation_periods=3
|
|
10868
10864
|
)
|
|
10869
10865
|
'''
|
|
@@ -12594,29 +12590,31 @@ class AlarmProps(CreateAlarmOptions):
|
|
|
12594
12590
|
|
|
12595
12591
|
Example::
|
|
12596
12592
|
|
|
12597
|
-
|
|
12593
|
+
import aws_cdk.aws_cloudwatch as cloudwatch
|
|
12598
12594
|
|
|
12599
|
-
|
|
12600
|
-
log_group=log_group,
|
|
12601
|
-
metric_namespace="MyApp",
|
|
12602
|
-
metric_name="Latency",
|
|
12603
|
-
filter_pattern=logs.FilterPattern.exists("$.latency"),
|
|
12604
|
-
metric_value="$.latency",
|
|
12605
|
-
dimensions={
|
|
12606
|
-
"ErrorCode": "$.errorCode"
|
|
12607
|
-
},
|
|
12608
|
-
unit=cloudwatch.Unit.MILLISECONDS
|
|
12609
|
-
)
|
|
12595
|
+
# alias: lambda.Alias
|
|
12610
12596
|
|
|
12611
|
-
#
|
|
12612
|
-
|
|
12597
|
+
# or add alarms to an existing group
|
|
12598
|
+
# blue_green_alias: lambda.Alias
|
|
12613
12599
|
|
|
12614
|
-
|
|
12615
|
-
|
|
12616
|
-
|
|
12617
|
-
|
|
12618
|
-
|
|
12600
|
+
alarm = cloudwatch.Alarm(self, "Errors",
|
|
12601
|
+
comparison_operator=cloudwatch.ComparisonOperator.GREATER_THAN_THRESHOLD,
|
|
12602
|
+
threshold=1,
|
|
12603
|
+
evaluation_periods=1,
|
|
12604
|
+
metric=alias.metric_errors()
|
|
12619
12605
|
)
|
|
12606
|
+
deployment_group = codedeploy.LambdaDeploymentGroup(self, "BlueGreenDeployment",
|
|
12607
|
+
alias=alias,
|
|
12608
|
+
deployment_config=codedeploy.LambdaDeploymentConfig.LINEAR_10PERCENT_EVERY_1MINUTE,
|
|
12609
|
+
alarms=[alarm
|
|
12610
|
+
]
|
|
12611
|
+
)
|
|
12612
|
+
deployment_group.add_alarm(cloudwatch.Alarm(self, "BlueGreenErrors",
|
|
12613
|
+
comparison_operator=cloudwatch.ComparisonOperator.GREATER_THAN_THRESHOLD,
|
|
12614
|
+
threshold=1,
|
|
12615
|
+
evaluation_periods=1,
|
|
12616
|
+
metric=blue_green_alias.metric_errors()
|
|
12617
|
+
))
|
|
12620
12618
|
'''
|
|
12621
12619
|
if __debug__:
|
|
12622
12620
|
type_hints = typing.get_type_hints(_typecheckingstub__b2e7c873c118fbc1f6cf26e1bb5bd3d8549040c626a6450f2d686bb07b87266b)
|
|
@@ -14861,29 +14859,31 @@ class Alarm(
|
|
|
14861
14859
|
|
|
14862
14860
|
Example::
|
|
14863
14861
|
|
|
14864
|
-
|
|
14862
|
+
import aws_cdk.aws_cloudwatch as cloudwatch
|
|
14865
14863
|
|
|
14866
|
-
|
|
14867
|
-
log_group=log_group,
|
|
14868
|
-
metric_namespace="MyApp",
|
|
14869
|
-
metric_name="Latency",
|
|
14870
|
-
filter_pattern=logs.FilterPattern.exists("$.latency"),
|
|
14871
|
-
metric_value="$.latency",
|
|
14872
|
-
dimensions={
|
|
14873
|
-
"ErrorCode": "$.errorCode"
|
|
14874
|
-
},
|
|
14875
|
-
unit=cloudwatch.Unit.MILLISECONDS
|
|
14876
|
-
)
|
|
14864
|
+
# alias: lambda.Alias
|
|
14877
14865
|
|
|
14878
|
-
#
|
|
14879
|
-
|
|
14866
|
+
# or add alarms to an existing group
|
|
14867
|
+
# blue_green_alias: lambda.Alias
|
|
14880
14868
|
|
|
14881
|
-
|
|
14882
|
-
|
|
14883
|
-
|
|
14884
|
-
|
|
14885
|
-
|
|
14869
|
+
alarm = cloudwatch.Alarm(self, "Errors",
|
|
14870
|
+
comparison_operator=cloudwatch.ComparisonOperator.GREATER_THAN_THRESHOLD,
|
|
14871
|
+
threshold=1,
|
|
14872
|
+
evaluation_periods=1,
|
|
14873
|
+
metric=alias.metric_errors()
|
|
14874
|
+
)
|
|
14875
|
+
deployment_group = codedeploy.LambdaDeploymentGroup(self, "BlueGreenDeployment",
|
|
14876
|
+
alias=alias,
|
|
14877
|
+
deployment_config=codedeploy.LambdaDeploymentConfig.LINEAR_10PERCENT_EVERY_1MINUTE,
|
|
14878
|
+
alarms=[alarm
|
|
14879
|
+
]
|
|
14886
14880
|
)
|
|
14881
|
+
deployment_group.add_alarm(cloudwatch.Alarm(self, "BlueGreenErrors",
|
|
14882
|
+
comparison_operator=cloudwatch.ComparisonOperator.GREATER_THAN_THRESHOLD,
|
|
14883
|
+
threshold=1,
|
|
14884
|
+
evaluation_periods=1,
|
|
14885
|
+
metric=blue_green_alias.metric_errors()
|
|
14886
|
+
))
|
|
14887
14887
|
'''
|
|
14888
14888
|
|
|
14889
14889
|
def __init__(
|