aws-cdk-lib 2.148.1__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.148.1.jsii.tgz → aws-cdk-lib@2.150.0.jsii.tgz} +0 -0
- aws_cdk/aws_applicationautoscaling/__init__.py +16 -12
- aws_cdk/aws_bedrock/__init__.py +60 -28
- 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_codebuild/__init__.py +57 -5
- aws_cdk/aws_codecommit/__init__.py +103 -0
- aws_cdk/aws_codedeploy/__init__.py +251 -5
- aws_cdk/aws_codepipeline/__init__.py +80 -5
- aws_cdk/aws_codestarnotifications/__init__.py +90 -4
- aws_cdk/aws_cognito/__init__.py +1 -2
- aws_cdk/aws_deadline/__init__.py +9 -15
- aws_cdk/aws_dms/__init__.py +10 -10
- aws_cdk/aws_ec2/__init__.py +86 -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 +26 -28
- aws_cdk/aws_events/__init__.py +1 -13
- 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_kinesisanalytics/__init__.py +11 -11
- aws_cdk/aws_kinesisanalyticsv2/__init__.py +11 -11
- 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 +18 -12
- aws_cdk/aws_rolesanywhere/__init__.py +22 -13
- aws_cdk/aws_route53profiles/__init__.py +4 -4
- aws_cdk/aws_s3/__init__.py +15 -117
- aws_cdk/aws_sagemaker/__init__.py +10 -10
- aws_cdk/aws_ses/__init__.py +119 -102
- aws_cdk/aws_stepfunctions_tasks/__init__.py +215 -24
- aws_cdk/aws_synthetics/__init__.py +15 -1
- aws_cdk/aws_verifiedpermissions/__init__.py +7 -9
- aws_cdk/aws_wafv2/__init__.py +10 -16
- aws_cdk/aws_workspaces/__init__.py +86 -56
- 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.148.1.dist-info → aws_cdk_lib-2.150.0.dist-info}/METADATA +1 -1
- {aws_cdk_lib-2.148.1.dist-info → aws_cdk_lib-2.150.0.dist-info}/RECORD +51 -51
- {aws_cdk_lib-2.148.1.dist-info → aws_cdk_lib-2.150.0.dist-info}/LICENSE +0 -0
- {aws_cdk_lib-2.148.1.dist-info → aws_cdk_lib-2.150.0.dist-info}/NOTICE +0 -0
- {aws_cdk_lib-2.148.1.dist-info → aws_cdk_lib-2.150.0.dist-info}/WHEEL +0 -0
- {aws_cdk_lib-2.148.1.dist-info → aws_cdk_lib-2.150.0.dist-info}/top_level.txt +0 -0
|
@@ -1248,7 +1248,7 @@ class CfnEventDataStore(
|
|
|
1248
1248
|
) -> None:
|
|
1249
1249
|
'''A single selector statement in an advanced event selector.
|
|
1250
1250
|
|
|
1251
|
-
: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 ``readOnly`` , ``eventCategory`` , and ``eventSource`` . For CloudTrail data events, supported fields include ``readOnly`` , ``eventCategory`` , ``eventName`` , ``resources.type`` , and ``resources.ARN`` . 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`` . - *``readOnly``* - Optional. Can be set to ``Equals`` 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``* - For filtering management events only. This can be set to ``NotEquals`` ``kms.amazonaws.com`` or ``NotEquals`` ``rdsdata.amazonaws.com`` . - *``eventName``* - Can use any operator. You can use it to filter in or filter out any data event logged to CloudTrail, such as ``PutBucket`` or ``GetSnapshotBlock`` . You can have multiple values for this field, separated by commas. - *``eventCategory``* - This 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`` . 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 non- AWS events, the value must be ``ActivityAuditLog`` . - *``resources.type``* - This field is required for CloudTrail data events. ``resources.type`` can only use the ``Equals`` operator, and the value can be one of the following: - ``AWS::DynamoDB::Table`` - ``AWS::Lambda::Function`` - ``AWS::S3::Object`` - ``AWS::AppConfig::Configuration`` - ``AWS::B2BI::Transformer`` - ``AWS::Bedrock::AgentAlias`` - ``AWS::Bedrock::KnowledgeBase`` - ``AWS::Cassandra::Table`` - ``AWS::CloudFront::KeyValueStore`` - ``AWS::CloudTrail::Channel`` - ``AWS::CloudWatch::Metric`` - ``AWS::CodeWhisperer::Customization`` - ``AWS::CodeWhisperer::Profile`` - ``AWS::Cognito::IdentityPool`` - ``AWS::DynamoDB::Stream`` - ``AWS::EC2::Snapshot`` - ``AWS::EMRWAL::Workspace`` - ``AWS::FinSpace::Environment`` - ``AWS::Glue::Table`` - ``AWS::GreengrassV2::ComponentVersion`` - ``AWS::GreengrassV2::Deployment`` - ``AWS::GuardDuty::Detector`` - ``AWS::IoT::Certificate`` - ``AWS::IoT::Thing`` - ``AWS::IoTSiteWise::Asset`` - ``AWS::IoTSiteWise::TimeSeries`` - ``AWS::IoTTwinMaker::Entity`` - ``AWS::IoTTwinMaker::Workspace`` - ``AWS::KendraRanking::ExecutionPlan`` - ``AWS::Kinesis::Stream`` - ``AWS::Kinesis::StreamConsumer`` - ``AWS::KinesisVideo::Stream`` - ``AWS::MachineLearning::MlModel`` - ``AWS::ManagedBlockchain::Network`` - ``AWS::ManagedBlockchain::Node`` - ``AWS::MedicalImaging::Datastore`` - ``AWS::NeptuneGraph::Graph`` - ``AWS::PCAConnectorAD::Connector`` - ``AWS::PCAConnectorSCEP::Connector`` - ``AWS::QApps:QApp`` - ``AWS::QBusiness::Application`` - ``AWS::QBusiness::DataSource`` - ``AWS::QBusiness::Index`` - ``AWS::QBusiness::WebExperience`` - ``AWS::RDS::DBCluster`` - ``AWS::S3::AccessPoint`` - ``AWS::S3ObjectLambda::AccessPoint`` - ``AWS::S3Outposts::Object`` - ``AWS::SageMaker::Endpoint`` - ``AWS::SageMaker::ExperimentTrialComponent`` - ``AWS::SageMaker::FeatureGroup`` - ``AWS::ServiceDiscovery::Namespace`` - ``AWS::ServiceDiscovery::Service`` - ``AWS::SCN::Instance`` - ``AWS::SNS::PlatformEndpoint`` - ``AWS::SNS::Topic`` - ``AWS::SQS::Queue`` - ``AWS::SSM::ManagedNode`` - ``AWS::SSMMessages::ControlChannel`` - ``AWS::StepFunctions::StateMachine`` - ``AWS::SWF::Domain`` - ``AWS::ThinClient::Device`` - ``AWS::ThinClient::Environment`` - ``AWS::Timestream::Database`` - ``AWS::Timestream::Table`` - ``AWS::VerifiedPermissions::PolicyStore`` - ``AWS::XRay::Trace`` You can have only one ``resources.type`` field per selector. To log data events on more than one resource type, add another selector. - *``resources.ARN``* - 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. .. epigraph:: You can't use the ``resources.ARN`` field to filter resource types that do not have ARNs. The ``resources.ARN`` field can be set one of the following. If resources.type equals ``AWS::S3::Object`` , the ARN must be in one of the following formats. 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. The trailing slash is intentional; do not exclude it. Replace the text between less than and greater than symbols (<>) with resource-specific information. - ``arn:<partition>:s3:::<bucket_name>/`` - ``arn:<partition>:s3:::<bucket_name>/<object_path>/`` When resources.type equals ``AWS::DynamoDB::Table`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:dynamodb:<region>:<account_ID>:table/<table_name>`` When resources.type equals ``AWS::Lambda::Function`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:lambda:<region>:<account_ID>:function:<function_name>`` When resources.type equals ``AWS::AppConfig::Configuration`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:appconfig:<region>:<account_ID>:application/<application_ID>/environment/<environment_ID>/configuration/<configuration_profile_ID>`` When resources.type equals ``AWS::B2BI::Transformer`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:b2bi:<region>:<account_ID>:transformer/<transformer_ID>`` When resources.type equals ``AWS::Bedrock::AgentAlias`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:bedrock:<region>:<account_ID>:agent-alias/<agent_ID>/<alias_ID>`` When resources.type equals ``AWS::Bedrock::KnowledgeBase`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:bedrock:<region>:<account_ID>:knowledge-base/<knowledge_base_ID>`` When resources.type equals ``AWS::Cassandra::Table`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:cassandra:<region>:<account_ID>:/keyspace/<keyspace_name>/table/<table_name>`` When resources.type equals ``AWS::CloudFront::KeyValueStore`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:cloudfront:<region>:<account_ID>:key-value-store/<KVS_name>`` When resources.type equals ``AWS::CloudTrail::Channel`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:cloudtrail:<region>:<account_ID>:channel/<channel_UUID>`` When resources.type equals ``AWS::CodeWhisperer::Customization`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:codewhisperer:<region>:<account_ID>:customization/<customization_ID>`` When resources.type equals ``AWS::CodeWhisperer::Profile`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:codewhisperer:<region>:<account_ID>:profile/<profile_ID>`` When resources.type equals ``AWS::Cognito::IdentityPool`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:cognito-identity:<region>:<account_ID>:identitypool/<identity_pool_ID>`` When ``resources.type`` equals ``AWS::DynamoDB::Stream`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:dynamodb:<region>:<account_ID>:table/<table_name>/stream/<date_time>`` When ``resources.type`` equals ``AWS::EC2::Snapshot`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:ec2:<region>::snapshot/<snapshot_ID>`` When ``resources.type`` equals ``AWS::EMRWAL::Workspace`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:emrwal:<region>:<account_ID>:workspace/<workspace_name>`` When ``resources.type`` equals ``AWS::FinSpace::Environment`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:finspace:<region>:<account_ID>:environment/<environment_ID>`` When ``resources.type`` equals ``AWS::Glue::Table`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:glue:<region>:<account_ID>:table/<database_name>/<table_name>`` When ``resources.type`` equals ``AWS::GreengrassV2::ComponentVersion`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:greengrass:<region>:<account_ID>:components/<component_name>`` When ``resources.type`` equals ``AWS::GreengrassV2::Deployment`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:greengrass:<region>:<account_ID>:deployments/<deployment_ID`` When ``resources.type`` equals ``AWS::GuardDuty::Detector`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:guardduty:<region>:<account_ID>:detector/<detector_ID>`` When ``resources.type`` equals ``AWS::IoT::Certificate`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:iot:<region>:<account_ID>:cert/<certificate_ID>`` When ``resources.type`` equals ``AWS::IoT::Thing`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:iot:<region>:<account_ID>:thing/<thing_ID>`` When ``resources.type`` equals ``AWS::IoTSiteWise::Asset`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:iotsitewise:<region>:<account_ID>:asset/<asset_ID>`` When ``resources.type`` equals ``AWS::IoTSiteWise::TimeSeries`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:iotsitewise:<region>:<account_ID>:timeseries/<timeseries_ID>`` When ``resources.type`` equals ``AWS::IoTTwinMaker::Entity`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:iottwinmaker:<region>:<account_ID>:workspace/<workspace_ID>/entity/<entity_ID>`` When ``resources.type`` equals ``AWS::IoTTwinMaker::Workspace`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:iottwinmaker:<region>:<account_ID>:workspace/<workspace_ID>`` When ``resources.type`` equals ``AWS::KendraRanking::ExecutionPlan`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:kendra-ranking:<region>:<account_ID>:rescore-execution-plan/<rescore_execution_plan_ID>`` When ``resources.type`` equals ``AWS::Kinesis::Stream`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:kinesis:<region>:<account_ID>:stream/<stream_name>`` When ``resources.type`` equals ``AWS::Kinesis::Stream`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:kinesis:<region>:<account_ID>:<stream_type>/<stream_name>/consumer/<consumer_name>:<consumer_creation_timestamp>`` When ``resources.type`` equals ``AWS::KinesisVideo::Stream`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:kinesisvideo:<region>:<account_ID>:stream/<stream_name>/<creation_time>`` When ``resources.type`` equals ``AWS::MachineLearning::MlModel`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:machinelearning:<region>:<account_ID>:mlmodel/<model_ID>`` When ``resources.type`` equals ``AWS::ManagedBlockchain::Network`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:managedblockchain:::networks/<network_name>`` When ``resources.type`` equals ``AWS::ManagedBlockchain::Node`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:managedblockchain:<region>:<account_ID>:nodes/<node_ID>`` When ``resources.type`` equals ``AWS::MedicalImaging::Datastore`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:medical-imaging:<region>:<account_ID>:datastore/<data_store_ID>`` When ``resources.type`` equals ``AWS::NeptuneGraph::Graph`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:neptune-graph:<region>:<account_ID>:graph/<graph_ID>`` When ``resources.type`` equals ``AWS::PCAConnectorAD::Connector`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:pca-connector-ad:<region>:<account_ID>:connector/<connector_ID>`` When ``resources.type`` equals ``AWS::PCAConnectorSCEP::Connector`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:pca-connector-scep:<region>:<account_ID>:connector/<connector_ID>`` When ``resources.type`` equals ``AWS::QApps:QApp`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:qapps:<region>:<account_ID>:application/<application_UUID>/qapp/<qapp_UUID>`` When ``resources.type`` equals ``AWS::QBusiness::Application`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:qbusiness:<region>:<account_ID>:application/<application_ID>`` When ``resources.type`` equals ``AWS::QBusiness::DataSource`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:qbusiness:<region>:<account_ID>:application/<application_ID>/index/<index_ID>/data-source/<datasource_ID>`` When ``resources.type`` equals ``AWS::QBusiness::Index`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:qbusiness:<region>:<account_ID>:application/<application_ID>/index/<index_ID>`` When ``resources.type`` equals ``AWS::QBusiness::WebExperience`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:qbusiness:<region>:<account_ID>:application/<application_ID>/web-experience/<web_experience_ID>`` When ``resources.type`` equals ``AWS::RDS::DBCluster`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:rds:<region>:<account_ID>:cluster/<cluster_name>`` When ``resources.type`` equals ``AWS::S3::AccessPoint`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in one of the following formats. To log events on all objects in an S3 access point, we recommend that you use only the access point ARN, don’t include the object path, and use the ``StartsWith`` or ``NotStartsWith`` operators. - ``arn:<partition>:s3:<region>:<account_ID>:accesspoint/<access_point_name>`` - ``arn:<partition>:s3:<region>:<account_ID>:accesspoint/<access_point_name>/object/<object_path>`` When ``resources.type`` equals ``AWS::S3ObjectLambda::AccessPoint`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:s3-object-lambda:<region>:<account_ID>:accesspoint/<access_point_name>`` When ``resources.type`` equals ``AWS::S3Outposts::Object`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:s3-outposts:<region>:<account_ID>:<object_path>`` When ``resources.type`` equals ``AWS::SageMaker::Endpoint`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:sagemaker:<region>:<account_ID>:endpoint/<endpoint_name>`` When ``resources.type`` equals ``AWS::SageMaker::ExperimentTrialComponent`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:sagemaker:<region>:<account_ID>:experiment-trial-component/<experiment_trial_component_name>`` When ``resources.type`` equals ``AWS::SageMaker::FeatureGroup`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:sagemaker:<region>:<account_ID>:feature-group/<feature_group_name>`` When ``resources.type`` equals ``AWS::SCN::Instance`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:scn:<region>:<account_ID>:instance/<instance_ID>`` When ``resources.type`` equals ``AWS::ServiceDiscovery::Namespace`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:servicediscovery:<region>:<account_ID>:namespace/<namespace_ID>`` When ``resources.type`` equals ``AWS::ServiceDiscovery::Service`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:servicediscovery:<region>:<account_ID>:service/<service_ID>`` When ``resources.type`` equals ``AWS::SNS::PlatformEndpoint`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:sns:<region>:<account_ID>:endpoint/<endpoint_type>/<endpoint_name>/<endpoint_ID>`` When ``resources.type`` equals ``AWS::SNS::Topic`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:sns:<region>:<account_ID>:<topic_name>`` When ``resources.type`` equals ``AWS::SQS::Queue`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:sqs:<region>:<account_ID>:<queue_name>`` When ``resources.type`` equals ``AWS::SSM::ManagedNode`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in one of the following formats: - ``arn:<partition>:ssm:<region>:<account_ID>:managed-instance/<instance_ID>`` - ``arn:<partition>:ec2:<region>:<account_ID>:instance/<instance_ID>`` When ``resources.type`` equals ``AWS::SSMMessages::ControlChannel`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:ssmmessages:<region>:<account_ID>:control-channel/<channel_ID>`` When ``resources.type`` equals ``AWS::StepFunctions::StateMachine`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in one of the following formats: - ``arn:<partition>:states:<region>:<account_ID>:stateMachine:<stateMachine_name>`` - ``arn:<partition>:states:<region>:<account_ID>:stateMachine:<stateMachine_name>/<label_name>`` When ``resources.type`` equals ``AWS::SWF::Domain`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:swf:<region>:<account_ID>:domain/<domain_name>`` When ``resources.type`` equals ``AWS::ThinClient::Device`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:thinclient:<region>:<account_ID>:device/<device_ID>`` When ``resources.type`` equals ``AWS::ThinClient::Environment`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:thinclient:<region>:<account_ID>:environment/<environment_ID>`` When ``resources.type`` equals ``AWS::Timestream::Database`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:timestream:<region>:<account_ID>:database/<database_name>`` When ``resources.type`` equals ``AWS::Timestream::Table`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:timestream:<region>:<account_ID>:database/<database_name>/table/<table_name>`` When resources.type equals ``AWS::VerifiedPermissions::PolicyStore`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:verifiedpermissions:<region>:<account_ID>:policy-store/<policy_store_UUID>``
|
|
1251
|
+
: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 ``readOnly`` , ``eventCategory`` , and ``eventSource`` . For CloudTrail data events, supported fields include ``readOnly`` , ``eventCategory`` , ``eventName`` , ``resources.type`` , and ``resources.ARN`` . 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`` . - *``readOnly``* - Optional. Can be set to ``Equals`` 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``* - For filtering management events only. This can be set to ``NotEquals`` ``kms.amazonaws.com`` or ``NotEquals`` ``rdsdata.amazonaws.com`` . - *``eventName``* - Can use any operator. You can use it to filter in or filter out any data event logged to CloudTrail, such as ``PutBucket`` or ``GetSnapshotBlock`` . You can have multiple values for this field, separated by commas. - *``eventCategory``* - This 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`` . 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 non- AWS events, the value must be ``ActivityAuditLog`` . - *``resources.type``* - This field is required for CloudTrail data events. ``resources.type`` can only use the ``Equals`` operator, and the value can be one of the following: - ``AWS::AppConfig::Configuration`` - ``AWS::B2BI::Transformer`` - ``AWS::Bedrock::AgentAlias`` - ``AWS::Bedrock::FlowAlias`` - ``AWS::Bedrock::Guardrail`` - ``AWS::Bedrock::KnowledgeBase`` - ``AWS::Cassandra::Table`` - ``AWS::CloudFront::KeyValueStore`` - ``AWS::CloudTrail::Channel`` - ``AWS::CloudWatch::Metric`` - ``AWS::CodeWhisperer::Customization`` - ``AWS::CodeWhisperer::Profile`` - ``AWS::Cognito::IdentityPool`` - ``AWS::DynamoDB::Stream`` - ``AWS::DynamoDB::Table`` - ``AWS::EC2::Snapshot`` - ``AWS::EMRWAL::Workspace`` - ``AWS::FinSpace::Environment`` - ``AWS::Glue::Table`` - ``AWS::GreengrassV2::ComponentVersion`` - ``AWS::GreengrassV2::Deployment`` - ``AWS::GuardDuty::Detector`` - ``AWS::IoT::Certificate`` - ``AWS::IoT::Thing`` - ``AWS::IoTSiteWise::Asset`` - ``AWS::IoTSiteWise::TimeSeries`` - ``AWS::IoTTwinMaker::Entity`` - ``AWS::IoTTwinMaker::Workspace`` - ``AWS::KendraRanking::ExecutionPlan`` - ``AWS::Kinesis::Stream`` - ``AWS::Kinesis::StreamConsumer`` - ``AWS::KinesisVideo::Stream`` - ``AWS::Lambda::Function`` - ``AWS::MachineLearning::MlModel`` - ``AWS::ManagedBlockchain::Network`` - ``AWS::ManagedBlockchain::Node`` - ``AWS::MedicalImaging::Datastore`` - ``AWS::NeptuneGraph::Graph`` - ``AWS::PaymentCryptography::Alias`` - ``AWS::PaymentCryptography::Key`` - ``AWS::PCAConnectorAD::Connector`` - ``AWS::PCAConnectorSCEP::Connector`` - ``AWS::QApps:QApp`` - ``AWS::QBusiness::Application`` - ``AWS::QBusiness::DataSource`` - ``AWS::QBusiness::Index`` - ``AWS::QBusiness::WebExperience`` - ``AWS::RDS::DBCluster`` - ``AWS::S3::AccessPoint`` - ``AWS::S3::Object`` - ``AWS::S3Express::Object`` - ``AWS::S3ObjectLambda::AccessPoint`` - ``AWS::S3Outposts::Object`` - ``AWS::SageMaker::Endpoint`` - ``AWS::SageMaker::ExperimentTrialComponent`` - ``AWS::SageMaker::FeatureGroup`` - ``AWS::ServiceDiscovery::Namespace`` - ``AWS::ServiceDiscovery::Service`` - ``AWS::SCN::Instance`` - ``AWS::SNS::PlatformEndpoint`` - ``AWS::SNS::Topic`` - ``AWS::SQS::Queue`` - ``AWS::SSM::ManagedNode`` - ``AWS::SSMMessages::ControlChannel`` - ``AWS::StepFunctions::StateMachine`` - ``AWS::SWF::Domain`` - ``AWS::ThinClient::Device`` - ``AWS::ThinClient::Environment`` - ``AWS::Timestream::Database`` - ``AWS::Timestream::Table`` - ``AWS::VerifiedPermissions::PolicyStore`` - ``AWS::XRay::Trace`` You can have only one ``resources.type`` field per selector. To log data events on more than one resource type, add another selector. - *``resources.ARN``* - 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 information about filtering on the ``resources.ARN`` field, see `Filtering data events by resources.ARN <https://docs.aws.amazon.com/awscloudtrail/latest/userguide/filtering-data-events.html#filtering-data-events-resourcearn>`_ in the *AWS CloudTrail User Guide* . .. epigraph:: You can't use the ``resources.ARN`` field to filter resource types that do not have ARNs.
|
|
1252
1252
|
: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`` .
|
|
1253
1253
|
: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.
|
|
1254
1254
|
: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`` .
|
|
@@ -1328,12 +1328,11 @@ class CfnEventDataStore(
|
|
|
1328
1328
|
- For Audit Manager evidence, the value must be ``Evidence`` .
|
|
1329
1329
|
- For non- AWS events, the value must be ``ActivityAuditLog`` .
|
|
1330
1330
|
- *``resources.type``* - This field is required for CloudTrail data events. ``resources.type`` can only use the ``Equals`` operator, and the value can be one of the following:
|
|
1331
|
-
- ``AWS::DynamoDB::Table``
|
|
1332
|
-
- ``AWS::Lambda::Function``
|
|
1333
|
-
- ``AWS::S3::Object``
|
|
1334
1331
|
- ``AWS::AppConfig::Configuration``
|
|
1335
1332
|
- ``AWS::B2BI::Transformer``
|
|
1336
1333
|
- ``AWS::Bedrock::AgentAlias``
|
|
1334
|
+
- ``AWS::Bedrock::FlowAlias``
|
|
1335
|
+
- ``AWS::Bedrock::Guardrail``
|
|
1337
1336
|
- ``AWS::Bedrock::KnowledgeBase``
|
|
1338
1337
|
- ``AWS::Cassandra::Table``
|
|
1339
1338
|
- ``AWS::CloudFront::KeyValueStore``
|
|
@@ -1343,6 +1342,7 @@ class CfnEventDataStore(
|
|
|
1343
1342
|
- ``AWS::CodeWhisperer::Profile``
|
|
1344
1343
|
- ``AWS::Cognito::IdentityPool``
|
|
1345
1344
|
- ``AWS::DynamoDB::Stream``
|
|
1345
|
+
- ``AWS::DynamoDB::Table``
|
|
1346
1346
|
- ``AWS::EC2::Snapshot``
|
|
1347
1347
|
- ``AWS::EMRWAL::Workspace``
|
|
1348
1348
|
- ``AWS::FinSpace::Environment``
|
|
@@ -1360,11 +1360,14 @@ class CfnEventDataStore(
|
|
|
1360
1360
|
- ``AWS::Kinesis::Stream``
|
|
1361
1361
|
- ``AWS::Kinesis::StreamConsumer``
|
|
1362
1362
|
- ``AWS::KinesisVideo::Stream``
|
|
1363
|
+
- ``AWS::Lambda::Function``
|
|
1363
1364
|
- ``AWS::MachineLearning::MlModel``
|
|
1364
1365
|
- ``AWS::ManagedBlockchain::Network``
|
|
1365
1366
|
- ``AWS::ManagedBlockchain::Node``
|
|
1366
1367
|
- ``AWS::MedicalImaging::Datastore``
|
|
1367
1368
|
- ``AWS::NeptuneGraph::Graph``
|
|
1369
|
+
- ``AWS::PaymentCryptography::Alias``
|
|
1370
|
+
- ``AWS::PaymentCryptography::Key``
|
|
1368
1371
|
- ``AWS::PCAConnectorAD::Connector``
|
|
1369
1372
|
- ``AWS::PCAConnectorSCEP::Connector``
|
|
1370
1373
|
- ``AWS::QApps:QApp``
|
|
@@ -1374,6 +1377,8 @@ class CfnEventDataStore(
|
|
|
1374
1377
|
- ``AWS::QBusiness::WebExperience``
|
|
1375
1378
|
- ``AWS::RDS::DBCluster``
|
|
1376
1379
|
- ``AWS::S3::AccessPoint``
|
|
1380
|
+
- ``AWS::S3::Object``
|
|
1381
|
+
- ``AWS::S3Express::Object``
|
|
1377
1382
|
- ``AWS::S3ObjectLambda::AccessPoint``
|
|
1378
1383
|
- ``AWS::S3Outposts::Object``
|
|
1379
1384
|
- ``AWS::SageMaker::Endpoint``
|
|
@@ -1398,280 +1403,12 @@ class CfnEventDataStore(
|
|
|
1398
1403
|
|
|
1399
1404
|
You can have only one ``resources.type`` field per selector. To log data events on more than one resource type, add another selector.
|
|
1400
1405
|
|
|
1401
|
-
- *``resources.ARN``* - 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.
|
|
1406
|
+
- *``resources.ARN``* - 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 information about filtering on the ``resources.ARN`` field, see `Filtering data events by resources.ARN <https://docs.aws.amazon.com/awscloudtrail/latest/userguide/filtering-data-events.html#filtering-data-events-resourcearn>`_ in the *AWS CloudTrail User Guide* .
|
|
1402
1407
|
|
|
1403
1408
|
.. epigraph::
|
|
1404
1409
|
|
|
1405
1410
|
You can't use the ``resources.ARN`` field to filter resource types that do not have ARNs.
|
|
1406
1411
|
|
|
1407
|
-
The ``resources.ARN`` field can be set one of the following.
|
|
1408
|
-
|
|
1409
|
-
If resources.type equals ``AWS::S3::Object`` , the ARN must be in one of the following formats. 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.
|
|
1410
|
-
|
|
1411
|
-
The trailing slash is intentional; do not exclude it. Replace the text between less than and greater than symbols (<>) with resource-specific information.
|
|
1412
|
-
|
|
1413
|
-
- ``arn:<partition>:s3:::<bucket_name>/``
|
|
1414
|
-
- ``arn:<partition>:s3:::<bucket_name>/<object_path>/``
|
|
1415
|
-
|
|
1416
|
-
When resources.type equals ``AWS::DynamoDB::Table`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1417
|
-
|
|
1418
|
-
- ``arn:<partition>:dynamodb:<region>:<account_ID>:table/<table_name>``
|
|
1419
|
-
|
|
1420
|
-
When resources.type equals ``AWS::Lambda::Function`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1421
|
-
|
|
1422
|
-
- ``arn:<partition>:lambda:<region>:<account_ID>:function:<function_name>``
|
|
1423
|
-
|
|
1424
|
-
When resources.type equals ``AWS::AppConfig::Configuration`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1425
|
-
|
|
1426
|
-
- ``arn:<partition>:appconfig:<region>:<account_ID>:application/<application_ID>/environment/<environment_ID>/configuration/<configuration_profile_ID>``
|
|
1427
|
-
|
|
1428
|
-
When resources.type equals ``AWS::B2BI::Transformer`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1429
|
-
|
|
1430
|
-
- ``arn:<partition>:b2bi:<region>:<account_ID>:transformer/<transformer_ID>``
|
|
1431
|
-
|
|
1432
|
-
When resources.type equals ``AWS::Bedrock::AgentAlias`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1433
|
-
|
|
1434
|
-
- ``arn:<partition>:bedrock:<region>:<account_ID>:agent-alias/<agent_ID>/<alias_ID>``
|
|
1435
|
-
|
|
1436
|
-
When resources.type equals ``AWS::Bedrock::KnowledgeBase`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1437
|
-
|
|
1438
|
-
- ``arn:<partition>:bedrock:<region>:<account_ID>:knowledge-base/<knowledge_base_ID>``
|
|
1439
|
-
|
|
1440
|
-
When resources.type equals ``AWS::Cassandra::Table`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1441
|
-
|
|
1442
|
-
- ``arn:<partition>:cassandra:<region>:<account_ID>:/keyspace/<keyspace_name>/table/<table_name>``
|
|
1443
|
-
|
|
1444
|
-
When resources.type equals ``AWS::CloudFront::KeyValueStore`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1445
|
-
|
|
1446
|
-
- ``arn:<partition>:cloudfront:<region>:<account_ID>:key-value-store/<KVS_name>``
|
|
1447
|
-
|
|
1448
|
-
When resources.type equals ``AWS::CloudTrail::Channel`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1449
|
-
|
|
1450
|
-
- ``arn:<partition>:cloudtrail:<region>:<account_ID>:channel/<channel_UUID>``
|
|
1451
|
-
|
|
1452
|
-
When resources.type equals ``AWS::CodeWhisperer::Customization`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1453
|
-
|
|
1454
|
-
- ``arn:<partition>:codewhisperer:<region>:<account_ID>:customization/<customization_ID>``
|
|
1455
|
-
|
|
1456
|
-
When resources.type equals ``AWS::CodeWhisperer::Profile`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1457
|
-
|
|
1458
|
-
- ``arn:<partition>:codewhisperer:<region>:<account_ID>:profile/<profile_ID>``
|
|
1459
|
-
|
|
1460
|
-
When resources.type equals ``AWS::Cognito::IdentityPool`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1461
|
-
|
|
1462
|
-
- ``arn:<partition>:cognito-identity:<region>:<account_ID>:identitypool/<identity_pool_ID>``
|
|
1463
|
-
|
|
1464
|
-
When ``resources.type`` equals ``AWS::DynamoDB::Stream`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1465
|
-
|
|
1466
|
-
- ``arn:<partition>:dynamodb:<region>:<account_ID>:table/<table_name>/stream/<date_time>``
|
|
1467
|
-
|
|
1468
|
-
When ``resources.type`` equals ``AWS::EC2::Snapshot`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1469
|
-
|
|
1470
|
-
- ``arn:<partition>:ec2:<region>::snapshot/<snapshot_ID>``
|
|
1471
|
-
|
|
1472
|
-
When ``resources.type`` equals ``AWS::EMRWAL::Workspace`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1473
|
-
|
|
1474
|
-
- ``arn:<partition>:emrwal:<region>:<account_ID>:workspace/<workspace_name>``
|
|
1475
|
-
|
|
1476
|
-
When ``resources.type`` equals ``AWS::FinSpace::Environment`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1477
|
-
|
|
1478
|
-
- ``arn:<partition>:finspace:<region>:<account_ID>:environment/<environment_ID>``
|
|
1479
|
-
|
|
1480
|
-
When ``resources.type`` equals ``AWS::Glue::Table`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1481
|
-
|
|
1482
|
-
- ``arn:<partition>:glue:<region>:<account_ID>:table/<database_name>/<table_name>``
|
|
1483
|
-
|
|
1484
|
-
When ``resources.type`` equals ``AWS::GreengrassV2::ComponentVersion`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1485
|
-
|
|
1486
|
-
- ``arn:<partition>:greengrass:<region>:<account_ID>:components/<component_name>``
|
|
1487
|
-
|
|
1488
|
-
When ``resources.type`` equals ``AWS::GreengrassV2::Deployment`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1489
|
-
|
|
1490
|
-
- ``arn:<partition>:greengrass:<region>:<account_ID>:deployments/<deployment_ID``
|
|
1491
|
-
|
|
1492
|
-
When ``resources.type`` equals ``AWS::GuardDuty::Detector`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1493
|
-
|
|
1494
|
-
- ``arn:<partition>:guardduty:<region>:<account_ID>:detector/<detector_ID>``
|
|
1495
|
-
|
|
1496
|
-
When ``resources.type`` equals ``AWS::IoT::Certificate`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1497
|
-
|
|
1498
|
-
- ``arn:<partition>:iot:<region>:<account_ID>:cert/<certificate_ID>``
|
|
1499
|
-
|
|
1500
|
-
When ``resources.type`` equals ``AWS::IoT::Thing`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1501
|
-
|
|
1502
|
-
- ``arn:<partition>:iot:<region>:<account_ID>:thing/<thing_ID>``
|
|
1503
|
-
|
|
1504
|
-
When ``resources.type`` equals ``AWS::IoTSiteWise::Asset`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1505
|
-
|
|
1506
|
-
- ``arn:<partition>:iotsitewise:<region>:<account_ID>:asset/<asset_ID>``
|
|
1507
|
-
|
|
1508
|
-
When ``resources.type`` equals ``AWS::IoTSiteWise::TimeSeries`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1509
|
-
|
|
1510
|
-
- ``arn:<partition>:iotsitewise:<region>:<account_ID>:timeseries/<timeseries_ID>``
|
|
1511
|
-
|
|
1512
|
-
When ``resources.type`` equals ``AWS::IoTTwinMaker::Entity`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1513
|
-
|
|
1514
|
-
- ``arn:<partition>:iottwinmaker:<region>:<account_ID>:workspace/<workspace_ID>/entity/<entity_ID>``
|
|
1515
|
-
|
|
1516
|
-
When ``resources.type`` equals ``AWS::IoTTwinMaker::Workspace`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1517
|
-
|
|
1518
|
-
- ``arn:<partition>:iottwinmaker:<region>:<account_ID>:workspace/<workspace_ID>``
|
|
1519
|
-
|
|
1520
|
-
When ``resources.type`` equals ``AWS::KendraRanking::ExecutionPlan`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1521
|
-
|
|
1522
|
-
- ``arn:<partition>:kendra-ranking:<region>:<account_ID>:rescore-execution-plan/<rescore_execution_plan_ID>``
|
|
1523
|
-
|
|
1524
|
-
When ``resources.type`` equals ``AWS::Kinesis::Stream`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1525
|
-
|
|
1526
|
-
- ``arn:<partition>:kinesis:<region>:<account_ID>:stream/<stream_name>``
|
|
1527
|
-
|
|
1528
|
-
When ``resources.type`` equals ``AWS::Kinesis::Stream`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1529
|
-
|
|
1530
|
-
- ``arn:<partition>:kinesis:<region>:<account_ID>:<stream_type>/<stream_name>/consumer/<consumer_name>:<consumer_creation_timestamp>``
|
|
1531
|
-
|
|
1532
|
-
When ``resources.type`` equals ``AWS::KinesisVideo::Stream`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1533
|
-
|
|
1534
|
-
- ``arn:<partition>:kinesisvideo:<region>:<account_ID>:stream/<stream_name>/<creation_time>``
|
|
1535
|
-
|
|
1536
|
-
When ``resources.type`` equals ``AWS::MachineLearning::MlModel`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1537
|
-
|
|
1538
|
-
- ``arn:<partition>:machinelearning:<region>:<account_ID>:mlmodel/<model_ID>``
|
|
1539
|
-
|
|
1540
|
-
When ``resources.type`` equals ``AWS::ManagedBlockchain::Network`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1541
|
-
|
|
1542
|
-
- ``arn:<partition>:managedblockchain:::networks/<network_name>``
|
|
1543
|
-
|
|
1544
|
-
When ``resources.type`` equals ``AWS::ManagedBlockchain::Node`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1545
|
-
|
|
1546
|
-
- ``arn:<partition>:managedblockchain:<region>:<account_ID>:nodes/<node_ID>``
|
|
1547
|
-
|
|
1548
|
-
When ``resources.type`` equals ``AWS::MedicalImaging::Datastore`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1549
|
-
|
|
1550
|
-
- ``arn:<partition>:medical-imaging:<region>:<account_ID>:datastore/<data_store_ID>``
|
|
1551
|
-
|
|
1552
|
-
When ``resources.type`` equals ``AWS::NeptuneGraph::Graph`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1553
|
-
|
|
1554
|
-
- ``arn:<partition>:neptune-graph:<region>:<account_ID>:graph/<graph_ID>``
|
|
1555
|
-
|
|
1556
|
-
When ``resources.type`` equals ``AWS::PCAConnectorAD::Connector`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1557
|
-
|
|
1558
|
-
- ``arn:<partition>:pca-connector-ad:<region>:<account_ID>:connector/<connector_ID>``
|
|
1559
|
-
|
|
1560
|
-
When ``resources.type`` equals ``AWS::PCAConnectorSCEP::Connector`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1561
|
-
|
|
1562
|
-
- ``arn:<partition>:pca-connector-scep:<region>:<account_ID>:connector/<connector_ID>``
|
|
1563
|
-
|
|
1564
|
-
When ``resources.type`` equals ``AWS::QApps:QApp`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1565
|
-
|
|
1566
|
-
- ``arn:<partition>:qapps:<region>:<account_ID>:application/<application_UUID>/qapp/<qapp_UUID>``
|
|
1567
|
-
|
|
1568
|
-
When ``resources.type`` equals ``AWS::QBusiness::Application`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1569
|
-
|
|
1570
|
-
- ``arn:<partition>:qbusiness:<region>:<account_ID>:application/<application_ID>``
|
|
1571
|
-
|
|
1572
|
-
When ``resources.type`` equals ``AWS::QBusiness::DataSource`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1573
|
-
|
|
1574
|
-
- ``arn:<partition>:qbusiness:<region>:<account_ID>:application/<application_ID>/index/<index_ID>/data-source/<datasource_ID>``
|
|
1575
|
-
|
|
1576
|
-
When ``resources.type`` equals ``AWS::QBusiness::Index`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1577
|
-
|
|
1578
|
-
- ``arn:<partition>:qbusiness:<region>:<account_ID>:application/<application_ID>/index/<index_ID>``
|
|
1579
|
-
|
|
1580
|
-
When ``resources.type`` equals ``AWS::QBusiness::WebExperience`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1581
|
-
|
|
1582
|
-
- ``arn:<partition>:qbusiness:<region>:<account_ID>:application/<application_ID>/web-experience/<web_experience_ID>``
|
|
1583
|
-
|
|
1584
|
-
When ``resources.type`` equals ``AWS::RDS::DBCluster`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1585
|
-
|
|
1586
|
-
- ``arn:<partition>:rds:<region>:<account_ID>:cluster/<cluster_name>``
|
|
1587
|
-
|
|
1588
|
-
When ``resources.type`` equals ``AWS::S3::AccessPoint`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in one of the following formats. To log events on all objects in an S3 access point, we recommend that you use only the access point ARN, don’t include the object path, and use the ``StartsWith`` or ``NotStartsWith`` operators.
|
|
1589
|
-
|
|
1590
|
-
- ``arn:<partition>:s3:<region>:<account_ID>:accesspoint/<access_point_name>``
|
|
1591
|
-
- ``arn:<partition>:s3:<region>:<account_ID>:accesspoint/<access_point_name>/object/<object_path>``
|
|
1592
|
-
|
|
1593
|
-
When ``resources.type`` equals ``AWS::S3ObjectLambda::AccessPoint`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1594
|
-
|
|
1595
|
-
- ``arn:<partition>:s3-object-lambda:<region>:<account_ID>:accesspoint/<access_point_name>``
|
|
1596
|
-
|
|
1597
|
-
When ``resources.type`` equals ``AWS::S3Outposts::Object`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1598
|
-
|
|
1599
|
-
- ``arn:<partition>:s3-outposts:<region>:<account_ID>:<object_path>``
|
|
1600
|
-
|
|
1601
|
-
When ``resources.type`` equals ``AWS::SageMaker::Endpoint`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1602
|
-
|
|
1603
|
-
- ``arn:<partition>:sagemaker:<region>:<account_ID>:endpoint/<endpoint_name>``
|
|
1604
|
-
|
|
1605
|
-
When ``resources.type`` equals ``AWS::SageMaker::ExperimentTrialComponent`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1606
|
-
|
|
1607
|
-
- ``arn:<partition>:sagemaker:<region>:<account_ID>:experiment-trial-component/<experiment_trial_component_name>``
|
|
1608
|
-
|
|
1609
|
-
When ``resources.type`` equals ``AWS::SageMaker::FeatureGroup`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1610
|
-
|
|
1611
|
-
- ``arn:<partition>:sagemaker:<region>:<account_ID>:feature-group/<feature_group_name>``
|
|
1612
|
-
|
|
1613
|
-
When ``resources.type`` equals ``AWS::SCN::Instance`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1614
|
-
|
|
1615
|
-
- ``arn:<partition>:scn:<region>:<account_ID>:instance/<instance_ID>``
|
|
1616
|
-
|
|
1617
|
-
When ``resources.type`` equals ``AWS::ServiceDiscovery::Namespace`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1618
|
-
|
|
1619
|
-
- ``arn:<partition>:servicediscovery:<region>:<account_ID>:namespace/<namespace_ID>``
|
|
1620
|
-
|
|
1621
|
-
When ``resources.type`` equals ``AWS::ServiceDiscovery::Service`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1622
|
-
|
|
1623
|
-
- ``arn:<partition>:servicediscovery:<region>:<account_ID>:service/<service_ID>``
|
|
1624
|
-
|
|
1625
|
-
When ``resources.type`` equals ``AWS::SNS::PlatformEndpoint`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1626
|
-
|
|
1627
|
-
- ``arn:<partition>:sns:<region>:<account_ID>:endpoint/<endpoint_type>/<endpoint_name>/<endpoint_ID>``
|
|
1628
|
-
|
|
1629
|
-
When ``resources.type`` equals ``AWS::SNS::Topic`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1630
|
-
|
|
1631
|
-
- ``arn:<partition>:sns:<region>:<account_ID>:<topic_name>``
|
|
1632
|
-
|
|
1633
|
-
When ``resources.type`` equals ``AWS::SQS::Queue`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1634
|
-
|
|
1635
|
-
- ``arn:<partition>:sqs:<region>:<account_ID>:<queue_name>``
|
|
1636
|
-
|
|
1637
|
-
When ``resources.type`` equals ``AWS::SSM::ManagedNode`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in one of the following formats:
|
|
1638
|
-
|
|
1639
|
-
- ``arn:<partition>:ssm:<region>:<account_ID>:managed-instance/<instance_ID>``
|
|
1640
|
-
- ``arn:<partition>:ec2:<region>:<account_ID>:instance/<instance_ID>``
|
|
1641
|
-
|
|
1642
|
-
When ``resources.type`` equals ``AWS::SSMMessages::ControlChannel`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1643
|
-
|
|
1644
|
-
- ``arn:<partition>:ssmmessages:<region>:<account_ID>:control-channel/<channel_ID>``
|
|
1645
|
-
|
|
1646
|
-
When ``resources.type`` equals ``AWS::StepFunctions::StateMachine`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in one of the following formats:
|
|
1647
|
-
|
|
1648
|
-
- ``arn:<partition>:states:<region>:<account_ID>:stateMachine:<stateMachine_name>``
|
|
1649
|
-
- ``arn:<partition>:states:<region>:<account_ID>:stateMachine:<stateMachine_name>/<label_name>``
|
|
1650
|
-
|
|
1651
|
-
When ``resources.type`` equals ``AWS::SWF::Domain`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1652
|
-
|
|
1653
|
-
- ``arn:<partition>:swf:<region>:<account_ID>:domain/<domain_name>``
|
|
1654
|
-
|
|
1655
|
-
When ``resources.type`` equals ``AWS::ThinClient::Device`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1656
|
-
|
|
1657
|
-
- ``arn:<partition>:thinclient:<region>:<account_ID>:device/<device_ID>``
|
|
1658
|
-
|
|
1659
|
-
When ``resources.type`` equals ``AWS::ThinClient::Environment`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1660
|
-
|
|
1661
|
-
- ``arn:<partition>:thinclient:<region>:<account_ID>:environment/<environment_ID>``
|
|
1662
|
-
|
|
1663
|
-
When ``resources.type`` equals ``AWS::Timestream::Database`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1664
|
-
|
|
1665
|
-
- ``arn:<partition>:timestream:<region>:<account_ID>:database/<database_name>``
|
|
1666
|
-
|
|
1667
|
-
When ``resources.type`` equals ``AWS::Timestream::Table`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1668
|
-
|
|
1669
|
-
- ``arn:<partition>:timestream:<region>:<account_ID>:database/<database_name>/table/<table_name>``
|
|
1670
|
-
|
|
1671
|
-
When resources.type equals ``AWS::VerifiedPermissions::PolicyStore`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
1672
|
-
|
|
1673
|
-
- ``arn:<partition>:verifiedpermissions:<region>:<account_ID>:policy-store/<policy_store_UUID>``
|
|
1674
|
-
|
|
1675
1412
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudtrail-eventdatastore-advancedfieldselector.html#cfn-cloudtrail-eventdatastore-advancedfieldselector-field
|
|
1676
1413
|
'''
|
|
1677
1414
|
result = self._values.get("field")
|
|
@@ -2938,7 +2675,7 @@ class CfnTrail(
|
|
|
2938
2675
|
) -> None:
|
|
2939
2676
|
'''A single selector statement in an advanced event selector.
|
|
2940
2677
|
|
|
2941
|
-
: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 ``readOnly`` , ``eventCategory`` , and ``eventSource`` . For CloudTrail data events, supported fields include ``readOnly`` , ``eventCategory`` , ``eventName`` , ``resources.type`` , and ``resources.ARN`` . 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`` . - *``readOnly``* - Optional. Can be set to ``Equals`` 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``* - For filtering management events only. This can be set to ``NotEquals`` ``kms.amazonaws.com`` or ``NotEquals`` ``rdsdata.amazonaws.com`` . - *``eventName``* - Can use any operator. You can use it to filter in or filter out any data event logged to CloudTrail, such as ``PutBucket`` or ``GetSnapshotBlock`` . You can have multiple values for this field, separated by commas. - *``eventCategory``* - This 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`` . 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 non- AWS events, the value must be ``ActivityAuditLog`` . - *``resources.type``* - This field is required for CloudTrail data events. ``resources.type`` can only use the ``Equals`` operator, and the value can be one of the following: - ``AWS::DynamoDB::Table`` - ``AWS::Lambda::Function`` - ``AWS::S3::Object`` - ``AWS::AppConfig::Configuration`` - ``AWS::B2BI::Transformer`` - ``AWS::Bedrock::AgentAlias`` - ``AWS::Bedrock::KnowledgeBase`` - ``AWS::Cassandra::Table`` - ``AWS::CloudFront::KeyValueStore`` - ``AWS::CloudTrail::Channel`` - ``AWS::CloudWatch::Metric`` - ``AWS::CodeWhisperer::Customization`` - ``AWS::CodeWhisperer::Profile`` - ``AWS::Cognito::IdentityPool`` - ``AWS::DynamoDB::Stream`` - ``AWS::EC2::Snapshot`` - ``AWS::EMRWAL::Workspace`` - ``AWS::FinSpace::Environment`` - ``AWS::Glue::Table`` - ``AWS::GreengrassV2::ComponentVersion`` - ``AWS::GreengrassV2::Deployment`` - ``AWS::GuardDuty::Detector`` - ``AWS::IoT::Certificate`` - ``AWS::IoT::Thing`` - ``AWS::IoTSiteWise::Asset`` - ``AWS::IoTSiteWise::TimeSeries`` - ``AWS::IoTTwinMaker::Entity`` - ``AWS::IoTTwinMaker::Workspace`` - ``AWS::KendraRanking::ExecutionPlan`` - ``AWS::Kinesis::Stream`` - ``AWS::Kinesis::StreamConsumer`` - ``AWS::KinesisVideo::Stream`` - ``AWS::MachineLearning::MlModel`` - ``AWS::ManagedBlockchain::Network`` - ``AWS::ManagedBlockchain::Node`` - ``AWS::MedicalImaging::Datastore`` - ``AWS::NeptuneGraph::Graph`` - ``AWS::PCAConnectorAD::Connector`` - ``AWS::PCAConnectorSCEP::Connector`` - ``AWS::QApps:QApp`` - ``AWS::QBusiness::Application`` - ``AWS::QBusiness::DataSource`` - ``AWS::QBusiness::Index`` - ``AWS::QBusiness::WebExperience`` - ``AWS::RDS::DBCluster`` - ``AWS::S3::AccessPoint`` - ``AWS::S3ObjectLambda::AccessPoint`` - ``AWS::S3Outposts::Object`` - ``AWS::SageMaker::Endpoint`` - ``AWS::SageMaker::ExperimentTrialComponent`` - ``AWS::SageMaker::FeatureGroup`` - ``AWS::ServiceDiscovery::Namespace`` - ``AWS::ServiceDiscovery::Service`` - ``AWS::SCN::Instance`` - ``AWS::SNS::PlatformEndpoint`` - ``AWS::SNS::Topic`` - ``AWS::SQS::Queue`` - ``AWS::SSM::ManagedNode`` - ``AWS::SSMMessages::ControlChannel`` - ``AWS::StepFunctions::StateMachine`` - ``AWS::SWF::Domain`` - ``AWS::ThinClient::Device`` - ``AWS::ThinClient::Environment`` - ``AWS::Timestream::Database`` - ``AWS::Timestream::Table`` - ``AWS::VerifiedPermissions::PolicyStore`` - ``AWS::XRay::Trace`` You can have only one ``resources.type`` field per selector. To log data events on more than one resource type, add another selector. - *``resources.ARN``* - 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. .. epigraph:: You can't use the ``resources.ARN`` field to filter resource types that do not have ARNs. The ``resources.ARN`` field can be set one of the following. If resources.type equals ``AWS::S3::Object`` , the ARN must be in one of the following formats. 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. The trailing slash is intentional; do not exclude it. Replace the text between less than and greater than symbols (<>) with resource-specific information. - ``arn:<partition>:s3:::<bucket_name>/`` - ``arn:<partition>:s3:::<bucket_name>/<object_path>/`` When resources.type equals ``AWS::DynamoDB::Table`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:dynamodb:<region>:<account_ID>:table/<table_name>`` When resources.type equals ``AWS::Lambda::Function`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:lambda:<region>:<account_ID>:function:<function_name>`` When resources.type equals ``AWS::AppConfig::Configuration`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:appconfig:<region>:<account_ID>:application/<application_ID>/environment/<environment_ID>/configuration/<configuration_profile_ID>`` When resources.type equals ``AWS::B2BI::Transformer`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:b2bi:<region>:<account_ID>:transformer/<transformer_ID>`` When resources.type equals ``AWS::Bedrock::AgentAlias`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:bedrock:<region>:<account_ID>:agent-alias/<agent_ID>/<alias_ID>`` When resources.type equals ``AWS::Bedrock::KnowledgeBase`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:bedrock:<region>:<account_ID>:knowledge-base/<knowledge_base_ID>`` When resources.type equals ``AWS::Cassandra::Table`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:cassandra:<region>:<account_ID>:/keyspace/<keyspace_name>/table/<table_name>`` When resources.type equals ``AWS::CloudFront::KeyValueStore`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:cloudfront:<region>:<account_ID>:key-value-store/<KVS_name>`` When resources.type equals ``AWS::CloudTrail::Channel`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:cloudtrail:<region>:<account_ID>:channel/<channel_UUID>`` When resources.type equals ``AWS::CodeWhisperer::Customization`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:codewhisperer:<region>:<account_ID>:customization/<customization_ID>`` When resources.type equals ``AWS::CodeWhisperer::Profile`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:codewhisperer:<region>:<account_ID>:profile/<profile_ID>`` When resources.type equals ``AWS::Cognito::IdentityPool`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:cognito-identity:<region>:<account_ID>:identitypool/<identity_pool_ID>`` When ``resources.type`` equals ``AWS::DynamoDB::Stream`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:dynamodb:<region>:<account_ID>:table/<table_name>/stream/<date_time>`` When ``resources.type`` equals ``AWS::EC2::Snapshot`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:ec2:<region>::snapshot/<snapshot_ID>`` When ``resources.type`` equals ``AWS::EMRWAL::Workspace`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:emrwal:<region>:<account_ID>:workspace/<workspace_name>`` When ``resources.type`` equals ``AWS::FinSpace::Environment`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:finspace:<region>:<account_ID>:environment/<environment_ID>`` When ``resources.type`` equals ``AWS::Glue::Table`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:glue:<region>:<account_ID>:table/<database_name>/<table_name>`` When ``resources.type`` equals ``AWS::GreengrassV2::ComponentVersion`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:greengrass:<region>:<account_ID>:components/<component_name>`` When ``resources.type`` equals ``AWS::GreengrassV2::Deployment`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:greengrass:<region>:<account_ID>:deployments/<deployment_ID`` When ``resources.type`` equals ``AWS::GuardDuty::Detector`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:guardduty:<region>:<account_ID>:detector/<detector_ID>`` When ``resources.type`` equals ``AWS::IoT::Certificate`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:iot:<region>:<account_ID>:cert/<certificate_ID>`` When ``resources.type`` equals ``AWS::IoT::Thing`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:iot:<region>:<account_ID>:thing/<thing_ID>`` When ``resources.type`` equals ``AWS::IoTSiteWise::Asset`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:iotsitewise:<region>:<account_ID>:asset/<asset_ID>`` When ``resources.type`` equals ``AWS::IoTSiteWise::TimeSeries`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:iotsitewise:<region>:<account_ID>:timeseries/<timeseries_ID>`` When ``resources.type`` equals ``AWS::IoTTwinMaker::Entity`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:iottwinmaker:<region>:<account_ID>:workspace/<workspace_ID>/entity/<entity_ID>`` When ``resources.type`` equals ``AWS::IoTTwinMaker::Workspace`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:iottwinmaker:<region>:<account_ID>:workspace/<workspace_ID>`` When ``resources.type`` equals ``AWS::KendraRanking::ExecutionPlan`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:kendra-ranking:<region>:<account_ID>:rescore-execution-plan/<rescore_execution_plan_ID>`` When ``resources.type`` equals ``AWS::Kinesis::Stream`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:kinesis:<region>:<account_ID>:stream/<stream_name>`` When ``resources.type`` equals ``AWS::Kinesis::Stream`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:kinesis:<region>:<account_ID>:<stream_type>/<stream_name>/consumer/<consumer_name>:<consumer_creation_timestamp>`` When ``resources.type`` equals ``AWS::KinesisVideo::Stream`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:kinesisvideo:<region>:<account_ID>:stream/<stream_name>/<creation_time>`` When ``resources.type`` equals ``AWS::MachineLearning::MlModel`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:machinelearning:<region>:<account_ID>:mlmodel/<model_ID>`` When ``resources.type`` equals ``AWS::ManagedBlockchain::Network`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:managedblockchain:::networks/<network_name>`` When ``resources.type`` equals ``AWS::ManagedBlockchain::Node`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:managedblockchain:<region>:<account_ID>:nodes/<node_ID>`` When ``resources.type`` equals ``AWS::MedicalImaging::Datastore`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:medical-imaging:<region>:<account_ID>:datastore/<data_store_ID>`` When ``resources.type`` equals ``AWS::NeptuneGraph::Graph`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:neptune-graph:<region>:<account_ID>:graph/<graph_ID>`` When ``resources.type`` equals ``AWS::PCAConnectorAD::Connector`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:pca-connector-ad:<region>:<account_ID>:connector/<connector_ID>`` When ``resources.type`` equals ``AWS::PCAConnectorSCEP::Connector`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:pca-connector-scep:<region>:<account_ID>:connector/<connector_ID>`` When ``resources.type`` equals ``AWS::QApps:QApp`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:qapps:<region>:<account_ID>:application/<application_UUID>/qapp/<qapp_UUID>`` When ``resources.type`` equals ``AWS::QBusiness::Application`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:qbusiness:<region>:<account_ID>:application/<application_ID>`` When ``resources.type`` equals ``AWS::QBusiness::DataSource`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:qbusiness:<region>:<account_ID>:application/<application_ID>/index/<index_ID>/data-source/<datasource_ID>`` When ``resources.type`` equals ``AWS::QBusiness::Index`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:qbusiness:<region>:<account_ID>:application/<application_ID>/index/<index_ID>`` When ``resources.type`` equals ``AWS::QBusiness::WebExperience`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:qbusiness:<region>:<account_ID>:application/<application_ID>/web-experience/<web_experience_ID>`` When ``resources.type`` equals ``AWS::RDS::DBCluster`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:rds:<region>:<account_ID>:cluster/<cluster_name>`` When ``resources.type`` equals ``AWS::S3::AccessPoint`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in one of the following formats. To log events on all objects in an S3 access point, we recommend that you use only the access point ARN, don’t include the object path, and use the ``StartsWith`` or ``NotStartsWith`` operators. - ``arn:<partition>:s3:<region>:<account_ID>:accesspoint/<access_point_name>`` - ``arn:<partition>:s3:<region>:<account_ID>:accesspoint/<access_point_name>/object/<object_path>`` When ``resources.type`` equals ``AWS::S3ObjectLambda::AccessPoint`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:s3-object-lambda:<region>:<account_ID>:accesspoint/<access_point_name>`` When ``resources.type`` equals ``AWS::S3Outposts::Object`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:s3-outposts:<region>:<account_ID>:<object_path>`` When ``resources.type`` equals ``AWS::SageMaker::Endpoint`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:sagemaker:<region>:<account_ID>:endpoint/<endpoint_name>`` When ``resources.type`` equals ``AWS::SageMaker::ExperimentTrialComponent`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:sagemaker:<region>:<account_ID>:experiment-trial-component/<experiment_trial_component_name>`` When ``resources.type`` equals ``AWS::SageMaker::FeatureGroup`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:sagemaker:<region>:<account_ID>:feature-group/<feature_group_name>`` When ``resources.type`` equals ``AWS::SCN::Instance`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:scn:<region>:<account_ID>:instance/<instance_ID>`` When ``resources.type`` equals ``AWS::ServiceDiscovery::Namespace`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:servicediscovery:<region>:<account_ID>:namespace/<namespace_ID>`` When ``resources.type`` equals ``AWS::ServiceDiscovery::Service`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:servicediscovery:<region>:<account_ID>:service/<service_ID>`` When ``resources.type`` equals ``AWS::SNS::PlatformEndpoint`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:sns:<region>:<account_ID>:endpoint/<endpoint_type>/<endpoint_name>/<endpoint_ID>`` When ``resources.type`` equals ``AWS::SNS::Topic`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:sns:<region>:<account_ID>:<topic_name>`` When ``resources.type`` equals ``AWS::SQS::Queue`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:sqs:<region>:<account_ID>:<queue_name>`` When ``resources.type`` equals ``AWS::SSM::ManagedNode`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in one of the following formats: - ``arn:<partition>:ssm:<region>:<account_ID>:managed-instance/<instance_ID>`` - ``arn:<partition>:ec2:<region>:<account_ID>:instance/<instance_ID>`` When ``resources.type`` equals ``AWS::SSMMessages::ControlChannel`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:ssmmessages:<region>:<account_ID>:control-channel/<channel_ID>`` When ``resources.type`` equals ``AWS::StepFunctions::StateMachine`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in one of the following formats: - ``arn:<partition>:states:<region>:<account_ID>:stateMachine:<stateMachine_name>`` - ``arn:<partition>:states:<region>:<account_ID>:stateMachine:<stateMachine_name>/<label_name>`` When ``resources.type`` equals ``AWS::SWF::Domain`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:swf:<region>:<account_ID>:domain/<domain_name>`` When ``resources.type`` equals ``AWS::ThinClient::Device`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:thinclient:<region>:<account_ID>:device/<device_ID>`` When ``resources.type`` equals ``AWS::ThinClient::Environment`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:thinclient:<region>:<account_ID>:environment/<environment_ID>`` When ``resources.type`` equals ``AWS::Timestream::Database`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:timestream:<region>:<account_ID>:database/<database_name>`` When ``resources.type`` equals ``AWS::Timestream::Table`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:timestream:<region>:<account_ID>:database/<database_name>/table/<table_name>`` When resources.type equals ``AWS::VerifiedPermissions::PolicyStore`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format: - ``arn:<partition>:verifiedpermissions:<region>:<account_ID>:policy-store/<policy_store_UUID>``
|
|
2678
|
+
: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 ``readOnly`` , ``eventCategory`` , and ``eventSource`` . For CloudTrail data events, supported fields include ``readOnly`` , ``eventCategory`` , ``eventName`` , ``resources.type`` , and ``resources.ARN`` . 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`` . - *``readOnly``* - Optional. Can be set to ``Equals`` 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``* - For filtering management events only. This can be set to ``NotEquals`` ``kms.amazonaws.com`` or ``NotEquals`` ``rdsdata.amazonaws.com`` . - *``eventName``* - Can use any operator. You can use it to filter in or filter out any data event logged to CloudTrail, such as ``PutBucket`` or ``GetSnapshotBlock`` . You can have multiple values for this field, separated by commas. - *``eventCategory``* - This 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`` . 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 non- AWS events, the value must be ``ActivityAuditLog`` . - *``resources.type``* - This field is required for CloudTrail data events. ``resources.type`` can only use the ``Equals`` operator, and the value can be one of the following: - ``AWS::AppConfig::Configuration`` - ``AWS::B2BI::Transformer`` - ``AWS::Bedrock::AgentAlias`` - ``AWS::Bedrock::FlowAlias`` - ``AWS::Bedrock::Guardrail`` - ``AWS::Bedrock::KnowledgeBase`` - ``AWS::Cassandra::Table`` - ``AWS::CloudFront::KeyValueStore`` - ``AWS::CloudTrail::Channel`` - ``AWS::CloudWatch::Metric`` - ``AWS::CodeWhisperer::Customization`` - ``AWS::CodeWhisperer::Profile`` - ``AWS::Cognito::IdentityPool`` - ``AWS::DynamoDB::Stream`` - ``AWS::DynamoDB::Table`` - ``AWS::EC2::Snapshot`` - ``AWS::EMRWAL::Workspace`` - ``AWS::FinSpace::Environment`` - ``AWS::Glue::Table`` - ``AWS::GreengrassV2::ComponentVersion`` - ``AWS::GreengrassV2::Deployment`` - ``AWS::GuardDuty::Detector`` - ``AWS::IoT::Certificate`` - ``AWS::IoT::Thing`` - ``AWS::IoTSiteWise::Asset`` - ``AWS::IoTSiteWise::TimeSeries`` - ``AWS::IoTTwinMaker::Entity`` - ``AWS::IoTTwinMaker::Workspace`` - ``AWS::KendraRanking::ExecutionPlan`` - ``AWS::Kinesis::Stream`` - ``AWS::Kinesis::StreamConsumer`` - ``AWS::KinesisVideo::Stream`` - ``AWS::Lambda::Function`` - ``AWS::MachineLearning::MlModel`` - ``AWS::ManagedBlockchain::Network`` - ``AWS::ManagedBlockchain::Node`` - ``AWS::MedicalImaging::Datastore`` - ``AWS::NeptuneGraph::Graph`` - ``AWS::PaymentCryptography::Alias`` - ``AWS::PaymentCryptography::Key`` - ``AWS::PCAConnectorAD::Connector`` - ``AWS::PCAConnectorSCEP::Connector`` - ``AWS::QApps:QApp`` - ``AWS::QBusiness::Application`` - ``AWS::QBusiness::DataSource`` - ``AWS::QBusiness::Index`` - ``AWS::QBusiness::WebExperience`` - ``AWS::RDS::DBCluster`` - ``AWS::S3::AccessPoint`` - ``AWS::S3::Object`` - ``AWS::S3Express::Object`` - ``AWS::S3ObjectLambda::AccessPoint`` - ``AWS::S3Outposts::Object`` - ``AWS::SageMaker::Endpoint`` - ``AWS::SageMaker::ExperimentTrialComponent`` - ``AWS::SageMaker::FeatureGroup`` - ``AWS::ServiceDiscovery::Namespace`` - ``AWS::ServiceDiscovery::Service`` - ``AWS::SCN::Instance`` - ``AWS::SNS::PlatformEndpoint`` - ``AWS::SNS::Topic`` - ``AWS::SQS::Queue`` - ``AWS::SSM::ManagedNode`` - ``AWS::SSMMessages::ControlChannel`` - ``AWS::StepFunctions::StateMachine`` - ``AWS::SWF::Domain`` - ``AWS::ThinClient::Device`` - ``AWS::ThinClient::Environment`` - ``AWS::Timestream::Database`` - ``AWS::Timestream::Table`` - ``AWS::VerifiedPermissions::PolicyStore`` - ``AWS::XRay::Trace`` You can have only one ``resources.type`` field per selector. To log data events on more than one resource type, add another selector. - *``resources.ARN``* - 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 information about filtering on the ``resources.ARN`` field, see `Filtering data events by resources.ARN <https://docs.aws.amazon.com/awscloudtrail/latest/userguide/filtering-data-events.html#filtering-data-events-resourcearn>`_ in the *AWS CloudTrail User Guide* . .. epigraph:: You can't use the ``resources.ARN`` field to filter resource types that do not have ARNs.
|
|
2942
2679
|
: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`` .
|
|
2943
2680
|
: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.
|
|
2944
2681
|
: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`` .
|
|
@@ -3018,12 +2755,11 @@ class CfnTrail(
|
|
|
3018
2755
|
- For Audit Manager evidence, the value must be ``Evidence`` .
|
|
3019
2756
|
- For non- AWS events, the value must be ``ActivityAuditLog`` .
|
|
3020
2757
|
- *``resources.type``* - This field is required for CloudTrail data events. ``resources.type`` can only use the ``Equals`` operator, and the value can be one of the following:
|
|
3021
|
-
- ``AWS::DynamoDB::Table``
|
|
3022
|
-
- ``AWS::Lambda::Function``
|
|
3023
|
-
- ``AWS::S3::Object``
|
|
3024
2758
|
- ``AWS::AppConfig::Configuration``
|
|
3025
2759
|
- ``AWS::B2BI::Transformer``
|
|
3026
2760
|
- ``AWS::Bedrock::AgentAlias``
|
|
2761
|
+
- ``AWS::Bedrock::FlowAlias``
|
|
2762
|
+
- ``AWS::Bedrock::Guardrail``
|
|
3027
2763
|
- ``AWS::Bedrock::KnowledgeBase``
|
|
3028
2764
|
- ``AWS::Cassandra::Table``
|
|
3029
2765
|
- ``AWS::CloudFront::KeyValueStore``
|
|
@@ -3033,6 +2769,7 @@ class CfnTrail(
|
|
|
3033
2769
|
- ``AWS::CodeWhisperer::Profile``
|
|
3034
2770
|
- ``AWS::Cognito::IdentityPool``
|
|
3035
2771
|
- ``AWS::DynamoDB::Stream``
|
|
2772
|
+
- ``AWS::DynamoDB::Table``
|
|
3036
2773
|
- ``AWS::EC2::Snapshot``
|
|
3037
2774
|
- ``AWS::EMRWAL::Workspace``
|
|
3038
2775
|
- ``AWS::FinSpace::Environment``
|
|
@@ -3050,11 +2787,14 @@ class CfnTrail(
|
|
|
3050
2787
|
- ``AWS::Kinesis::Stream``
|
|
3051
2788
|
- ``AWS::Kinesis::StreamConsumer``
|
|
3052
2789
|
- ``AWS::KinesisVideo::Stream``
|
|
2790
|
+
- ``AWS::Lambda::Function``
|
|
3053
2791
|
- ``AWS::MachineLearning::MlModel``
|
|
3054
2792
|
- ``AWS::ManagedBlockchain::Network``
|
|
3055
2793
|
- ``AWS::ManagedBlockchain::Node``
|
|
3056
2794
|
- ``AWS::MedicalImaging::Datastore``
|
|
3057
2795
|
- ``AWS::NeptuneGraph::Graph``
|
|
2796
|
+
- ``AWS::PaymentCryptography::Alias``
|
|
2797
|
+
- ``AWS::PaymentCryptography::Key``
|
|
3058
2798
|
- ``AWS::PCAConnectorAD::Connector``
|
|
3059
2799
|
- ``AWS::PCAConnectorSCEP::Connector``
|
|
3060
2800
|
- ``AWS::QApps:QApp``
|
|
@@ -3064,6 +2804,8 @@ class CfnTrail(
|
|
|
3064
2804
|
- ``AWS::QBusiness::WebExperience``
|
|
3065
2805
|
- ``AWS::RDS::DBCluster``
|
|
3066
2806
|
- ``AWS::S3::AccessPoint``
|
|
2807
|
+
- ``AWS::S3::Object``
|
|
2808
|
+
- ``AWS::S3Express::Object``
|
|
3067
2809
|
- ``AWS::S3ObjectLambda::AccessPoint``
|
|
3068
2810
|
- ``AWS::S3Outposts::Object``
|
|
3069
2811
|
- ``AWS::SageMaker::Endpoint``
|
|
@@ -3088,280 +2830,12 @@ class CfnTrail(
|
|
|
3088
2830
|
|
|
3089
2831
|
You can have only one ``resources.type`` field per selector. To log data events on more than one resource type, add another selector.
|
|
3090
2832
|
|
|
3091
|
-
- *``resources.ARN``* - 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.
|
|
2833
|
+
- *``resources.ARN``* - 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 information about filtering on the ``resources.ARN`` field, see `Filtering data events by resources.ARN <https://docs.aws.amazon.com/awscloudtrail/latest/userguide/filtering-data-events.html#filtering-data-events-resourcearn>`_ in the *AWS CloudTrail User Guide* .
|
|
3092
2834
|
|
|
3093
2835
|
.. epigraph::
|
|
3094
2836
|
|
|
3095
2837
|
You can't use the ``resources.ARN`` field to filter resource types that do not have ARNs.
|
|
3096
2838
|
|
|
3097
|
-
The ``resources.ARN`` field can be set one of the following.
|
|
3098
|
-
|
|
3099
|
-
If resources.type equals ``AWS::S3::Object`` , the ARN must be in one of the following formats. 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.
|
|
3100
|
-
|
|
3101
|
-
The trailing slash is intentional; do not exclude it. Replace the text between less than and greater than symbols (<>) with resource-specific information.
|
|
3102
|
-
|
|
3103
|
-
- ``arn:<partition>:s3:::<bucket_name>/``
|
|
3104
|
-
- ``arn:<partition>:s3:::<bucket_name>/<object_path>/``
|
|
3105
|
-
|
|
3106
|
-
When resources.type equals ``AWS::DynamoDB::Table`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3107
|
-
|
|
3108
|
-
- ``arn:<partition>:dynamodb:<region>:<account_ID>:table/<table_name>``
|
|
3109
|
-
|
|
3110
|
-
When resources.type equals ``AWS::Lambda::Function`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3111
|
-
|
|
3112
|
-
- ``arn:<partition>:lambda:<region>:<account_ID>:function:<function_name>``
|
|
3113
|
-
|
|
3114
|
-
When resources.type equals ``AWS::AppConfig::Configuration`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3115
|
-
|
|
3116
|
-
- ``arn:<partition>:appconfig:<region>:<account_ID>:application/<application_ID>/environment/<environment_ID>/configuration/<configuration_profile_ID>``
|
|
3117
|
-
|
|
3118
|
-
When resources.type equals ``AWS::B2BI::Transformer`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3119
|
-
|
|
3120
|
-
- ``arn:<partition>:b2bi:<region>:<account_ID>:transformer/<transformer_ID>``
|
|
3121
|
-
|
|
3122
|
-
When resources.type equals ``AWS::Bedrock::AgentAlias`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3123
|
-
|
|
3124
|
-
- ``arn:<partition>:bedrock:<region>:<account_ID>:agent-alias/<agent_ID>/<alias_ID>``
|
|
3125
|
-
|
|
3126
|
-
When resources.type equals ``AWS::Bedrock::KnowledgeBase`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3127
|
-
|
|
3128
|
-
- ``arn:<partition>:bedrock:<region>:<account_ID>:knowledge-base/<knowledge_base_ID>``
|
|
3129
|
-
|
|
3130
|
-
When resources.type equals ``AWS::Cassandra::Table`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3131
|
-
|
|
3132
|
-
- ``arn:<partition>:cassandra:<region>:<account_ID>:/keyspace/<keyspace_name>/table/<table_name>``
|
|
3133
|
-
|
|
3134
|
-
When resources.type equals ``AWS::CloudFront::KeyValueStore`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3135
|
-
|
|
3136
|
-
- ``arn:<partition>:cloudfront:<region>:<account_ID>:key-value-store/<KVS_name>``
|
|
3137
|
-
|
|
3138
|
-
When resources.type equals ``AWS::CloudTrail::Channel`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3139
|
-
|
|
3140
|
-
- ``arn:<partition>:cloudtrail:<region>:<account_ID>:channel/<channel_UUID>``
|
|
3141
|
-
|
|
3142
|
-
When resources.type equals ``AWS::CodeWhisperer::Customization`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3143
|
-
|
|
3144
|
-
- ``arn:<partition>:codewhisperer:<region>:<account_ID>:customization/<customization_ID>``
|
|
3145
|
-
|
|
3146
|
-
When resources.type equals ``AWS::CodeWhisperer::Profile`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3147
|
-
|
|
3148
|
-
- ``arn:<partition>:codewhisperer:<region>:<account_ID>:profile/<profile_ID>``
|
|
3149
|
-
|
|
3150
|
-
When resources.type equals ``AWS::Cognito::IdentityPool`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3151
|
-
|
|
3152
|
-
- ``arn:<partition>:cognito-identity:<region>:<account_ID>:identitypool/<identity_pool_ID>``
|
|
3153
|
-
|
|
3154
|
-
When ``resources.type`` equals ``AWS::DynamoDB::Stream`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3155
|
-
|
|
3156
|
-
- ``arn:<partition>:dynamodb:<region>:<account_ID>:table/<table_name>/stream/<date_time>``
|
|
3157
|
-
|
|
3158
|
-
When ``resources.type`` equals ``AWS::EC2::Snapshot`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3159
|
-
|
|
3160
|
-
- ``arn:<partition>:ec2:<region>::snapshot/<snapshot_ID>``
|
|
3161
|
-
|
|
3162
|
-
When ``resources.type`` equals ``AWS::EMRWAL::Workspace`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3163
|
-
|
|
3164
|
-
- ``arn:<partition>:emrwal:<region>:<account_ID>:workspace/<workspace_name>``
|
|
3165
|
-
|
|
3166
|
-
When ``resources.type`` equals ``AWS::FinSpace::Environment`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3167
|
-
|
|
3168
|
-
- ``arn:<partition>:finspace:<region>:<account_ID>:environment/<environment_ID>``
|
|
3169
|
-
|
|
3170
|
-
When ``resources.type`` equals ``AWS::Glue::Table`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3171
|
-
|
|
3172
|
-
- ``arn:<partition>:glue:<region>:<account_ID>:table/<database_name>/<table_name>``
|
|
3173
|
-
|
|
3174
|
-
When ``resources.type`` equals ``AWS::GreengrassV2::ComponentVersion`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3175
|
-
|
|
3176
|
-
- ``arn:<partition>:greengrass:<region>:<account_ID>:components/<component_name>``
|
|
3177
|
-
|
|
3178
|
-
When ``resources.type`` equals ``AWS::GreengrassV2::Deployment`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3179
|
-
|
|
3180
|
-
- ``arn:<partition>:greengrass:<region>:<account_ID>:deployments/<deployment_ID``
|
|
3181
|
-
|
|
3182
|
-
When ``resources.type`` equals ``AWS::GuardDuty::Detector`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3183
|
-
|
|
3184
|
-
- ``arn:<partition>:guardduty:<region>:<account_ID>:detector/<detector_ID>``
|
|
3185
|
-
|
|
3186
|
-
When ``resources.type`` equals ``AWS::IoT::Certificate`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3187
|
-
|
|
3188
|
-
- ``arn:<partition>:iot:<region>:<account_ID>:cert/<certificate_ID>``
|
|
3189
|
-
|
|
3190
|
-
When ``resources.type`` equals ``AWS::IoT::Thing`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3191
|
-
|
|
3192
|
-
- ``arn:<partition>:iot:<region>:<account_ID>:thing/<thing_ID>``
|
|
3193
|
-
|
|
3194
|
-
When ``resources.type`` equals ``AWS::IoTSiteWise::Asset`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3195
|
-
|
|
3196
|
-
- ``arn:<partition>:iotsitewise:<region>:<account_ID>:asset/<asset_ID>``
|
|
3197
|
-
|
|
3198
|
-
When ``resources.type`` equals ``AWS::IoTSiteWise::TimeSeries`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3199
|
-
|
|
3200
|
-
- ``arn:<partition>:iotsitewise:<region>:<account_ID>:timeseries/<timeseries_ID>``
|
|
3201
|
-
|
|
3202
|
-
When ``resources.type`` equals ``AWS::IoTTwinMaker::Entity`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3203
|
-
|
|
3204
|
-
- ``arn:<partition>:iottwinmaker:<region>:<account_ID>:workspace/<workspace_ID>/entity/<entity_ID>``
|
|
3205
|
-
|
|
3206
|
-
When ``resources.type`` equals ``AWS::IoTTwinMaker::Workspace`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3207
|
-
|
|
3208
|
-
- ``arn:<partition>:iottwinmaker:<region>:<account_ID>:workspace/<workspace_ID>``
|
|
3209
|
-
|
|
3210
|
-
When ``resources.type`` equals ``AWS::KendraRanking::ExecutionPlan`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3211
|
-
|
|
3212
|
-
- ``arn:<partition>:kendra-ranking:<region>:<account_ID>:rescore-execution-plan/<rescore_execution_plan_ID>``
|
|
3213
|
-
|
|
3214
|
-
When ``resources.type`` equals ``AWS::Kinesis::Stream`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3215
|
-
|
|
3216
|
-
- ``arn:<partition>:kinesis:<region>:<account_ID>:stream/<stream_name>``
|
|
3217
|
-
|
|
3218
|
-
When ``resources.type`` equals ``AWS::Kinesis::Stream`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3219
|
-
|
|
3220
|
-
- ``arn:<partition>:kinesis:<region>:<account_ID>:<stream_type>/<stream_name>/consumer/<consumer_name>:<consumer_creation_timestamp>``
|
|
3221
|
-
|
|
3222
|
-
When ``resources.type`` equals ``AWS::KinesisVideo::Stream`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3223
|
-
|
|
3224
|
-
- ``arn:<partition>:kinesisvideo:<region>:<account_ID>:stream/<stream_name>/<creation_time>``
|
|
3225
|
-
|
|
3226
|
-
When ``resources.type`` equals ``AWS::MachineLearning::MlModel`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3227
|
-
|
|
3228
|
-
- ``arn:<partition>:machinelearning:<region>:<account_ID>:mlmodel/<model_ID>``
|
|
3229
|
-
|
|
3230
|
-
When ``resources.type`` equals ``AWS::ManagedBlockchain::Network`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3231
|
-
|
|
3232
|
-
- ``arn:<partition>:managedblockchain:::networks/<network_name>``
|
|
3233
|
-
|
|
3234
|
-
When ``resources.type`` equals ``AWS::ManagedBlockchain::Node`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3235
|
-
|
|
3236
|
-
- ``arn:<partition>:managedblockchain:<region>:<account_ID>:nodes/<node_ID>``
|
|
3237
|
-
|
|
3238
|
-
When ``resources.type`` equals ``AWS::MedicalImaging::Datastore`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3239
|
-
|
|
3240
|
-
- ``arn:<partition>:medical-imaging:<region>:<account_ID>:datastore/<data_store_ID>``
|
|
3241
|
-
|
|
3242
|
-
When ``resources.type`` equals ``AWS::NeptuneGraph::Graph`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3243
|
-
|
|
3244
|
-
- ``arn:<partition>:neptune-graph:<region>:<account_ID>:graph/<graph_ID>``
|
|
3245
|
-
|
|
3246
|
-
When ``resources.type`` equals ``AWS::PCAConnectorAD::Connector`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3247
|
-
|
|
3248
|
-
- ``arn:<partition>:pca-connector-ad:<region>:<account_ID>:connector/<connector_ID>``
|
|
3249
|
-
|
|
3250
|
-
When ``resources.type`` equals ``AWS::PCAConnectorSCEP::Connector`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3251
|
-
|
|
3252
|
-
- ``arn:<partition>:pca-connector-scep:<region>:<account_ID>:connector/<connector_ID>``
|
|
3253
|
-
|
|
3254
|
-
When ``resources.type`` equals ``AWS::QApps:QApp`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3255
|
-
|
|
3256
|
-
- ``arn:<partition>:qapps:<region>:<account_ID>:application/<application_UUID>/qapp/<qapp_UUID>``
|
|
3257
|
-
|
|
3258
|
-
When ``resources.type`` equals ``AWS::QBusiness::Application`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3259
|
-
|
|
3260
|
-
- ``arn:<partition>:qbusiness:<region>:<account_ID>:application/<application_ID>``
|
|
3261
|
-
|
|
3262
|
-
When ``resources.type`` equals ``AWS::QBusiness::DataSource`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3263
|
-
|
|
3264
|
-
- ``arn:<partition>:qbusiness:<region>:<account_ID>:application/<application_ID>/index/<index_ID>/data-source/<datasource_ID>``
|
|
3265
|
-
|
|
3266
|
-
When ``resources.type`` equals ``AWS::QBusiness::Index`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3267
|
-
|
|
3268
|
-
- ``arn:<partition>:qbusiness:<region>:<account_ID>:application/<application_ID>/index/<index_ID>``
|
|
3269
|
-
|
|
3270
|
-
When ``resources.type`` equals ``AWS::QBusiness::WebExperience`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3271
|
-
|
|
3272
|
-
- ``arn:<partition>:qbusiness:<region>:<account_ID>:application/<application_ID>/web-experience/<web_experience_ID>``
|
|
3273
|
-
|
|
3274
|
-
When ``resources.type`` equals ``AWS::RDS::DBCluster`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3275
|
-
|
|
3276
|
-
- ``arn:<partition>:rds:<region>:<account_ID>:cluster/<cluster_name>``
|
|
3277
|
-
|
|
3278
|
-
When ``resources.type`` equals ``AWS::S3::AccessPoint`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in one of the following formats. To log events on all objects in an S3 access point, we recommend that you use only the access point ARN, don’t include the object path, and use the ``StartsWith`` or ``NotStartsWith`` operators.
|
|
3279
|
-
|
|
3280
|
-
- ``arn:<partition>:s3:<region>:<account_ID>:accesspoint/<access_point_name>``
|
|
3281
|
-
- ``arn:<partition>:s3:<region>:<account_ID>:accesspoint/<access_point_name>/object/<object_path>``
|
|
3282
|
-
|
|
3283
|
-
When ``resources.type`` equals ``AWS::S3ObjectLambda::AccessPoint`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3284
|
-
|
|
3285
|
-
- ``arn:<partition>:s3-object-lambda:<region>:<account_ID>:accesspoint/<access_point_name>``
|
|
3286
|
-
|
|
3287
|
-
When ``resources.type`` equals ``AWS::S3Outposts::Object`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3288
|
-
|
|
3289
|
-
- ``arn:<partition>:s3-outposts:<region>:<account_ID>:<object_path>``
|
|
3290
|
-
|
|
3291
|
-
When ``resources.type`` equals ``AWS::SageMaker::Endpoint`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3292
|
-
|
|
3293
|
-
- ``arn:<partition>:sagemaker:<region>:<account_ID>:endpoint/<endpoint_name>``
|
|
3294
|
-
|
|
3295
|
-
When ``resources.type`` equals ``AWS::SageMaker::ExperimentTrialComponent`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3296
|
-
|
|
3297
|
-
- ``arn:<partition>:sagemaker:<region>:<account_ID>:experiment-trial-component/<experiment_trial_component_name>``
|
|
3298
|
-
|
|
3299
|
-
When ``resources.type`` equals ``AWS::SageMaker::FeatureGroup`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3300
|
-
|
|
3301
|
-
- ``arn:<partition>:sagemaker:<region>:<account_ID>:feature-group/<feature_group_name>``
|
|
3302
|
-
|
|
3303
|
-
When ``resources.type`` equals ``AWS::SCN::Instance`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3304
|
-
|
|
3305
|
-
- ``arn:<partition>:scn:<region>:<account_ID>:instance/<instance_ID>``
|
|
3306
|
-
|
|
3307
|
-
When ``resources.type`` equals ``AWS::ServiceDiscovery::Namespace`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3308
|
-
|
|
3309
|
-
- ``arn:<partition>:servicediscovery:<region>:<account_ID>:namespace/<namespace_ID>``
|
|
3310
|
-
|
|
3311
|
-
When ``resources.type`` equals ``AWS::ServiceDiscovery::Service`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3312
|
-
|
|
3313
|
-
- ``arn:<partition>:servicediscovery:<region>:<account_ID>:service/<service_ID>``
|
|
3314
|
-
|
|
3315
|
-
When ``resources.type`` equals ``AWS::SNS::PlatformEndpoint`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3316
|
-
|
|
3317
|
-
- ``arn:<partition>:sns:<region>:<account_ID>:endpoint/<endpoint_type>/<endpoint_name>/<endpoint_ID>``
|
|
3318
|
-
|
|
3319
|
-
When ``resources.type`` equals ``AWS::SNS::Topic`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3320
|
-
|
|
3321
|
-
- ``arn:<partition>:sns:<region>:<account_ID>:<topic_name>``
|
|
3322
|
-
|
|
3323
|
-
When ``resources.type`` equals ``AWS::SQS::Queue`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3324
|
-
|
|
3325
|
-
- ``arn:<partition>:sqs:<region>:<account_ID>:<queue_name>``
|
|
3326
|
-
|
|
3327
|
-
When ``resources.type`` equals ``AWS::SSM::ManagedNode`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in one of the following formats:
|
|
3328
|
-
|
|
3329
|
-
- ``arn:<partition>:ssm:<region>:<account_ID>:managed-instance/<instance_ID>``
|
|
3330
|
-
- ``arn:<partition>:ec2:<region>:<account_ID>:instance/<instance_ID>``
|
|
3331
|
-
|
|
3332
|
-
When ``resources.type`` equals ``AWS::SSMMessages::ControlChannel`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3333
|
-
|
|
3334
|
-
- ``arn:<partition>:ssmmessages:<region>:<account_ID>:control-channel/<channel_ID>``
|
|
3335
|
-
|
|
3336
|
-
When ``resources.type`` equals ``AWS::StepFunctions::StateMachine`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in one of the following formats:
|
|
3337
|
-
|
|
3338
|
-
- ``arn:<partition>:states:<region>:<account_ID>:stateMachine:<stateMachine_name>``
|
|
3339
|
-
- ``arn:<partition>:states:<region>:<account_ID>:stateMachine:<stateMachine_name>/<label_name>``
|
|
3340
|
-
|
|
3341
|
-
When ``resources.type`` equals ``AWS::SWF::Domain`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3342
|
-
|
|
3343
|
-
- ``arn:<partition>:swf:<region>:<account_ID>:domain/<domain_name>``
|
|
3344
|
-
|
|
3345
|
-
When ``resources.type`` equals ``AWS::ThinClient::Device`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3346
|
-
|
|
3347
|
-
- ``arn:<partition>:thinclient:<region>:<account_ID>:device/<device_ID>``
|
|
3348
|
-
|
|
3349
|
-
When ``resources.type`` equals ``AWS::ThinClient::Environment`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3350
|
-
|
|
3351
|
-
- ``arn:<partition>:thinclient:<region>:<account_ID>:environment/<environment_ID>``
|
|
3352
|
-
|
|
3353
|
-
When ``resources.type`` equals ``AWS::Timestream::Database`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3354
|
-
|
|
3355
|
-
- ``arn:<partition>:timestream:<region>:<account_ID>:database/<database_name>``
|
|
3356
|
-
|
|
3357
|
-
When ``resources.type`` equals ``AWS::Timestream::Table`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3358
|
-
|
|
3359
|
-
- ``arn:<partition>:timestream:<region>:<account_ID>:database/<database_name>/table/<table_name>``
|
|
3360
|
-
|
|
3361
|
-
When resources.type equals ``AWS::VerifiedPermissions::PolicyStore`` , and the operator is set to ``Equals`` or ``NotEquals`` , the ARN must be in the following format:
|
|
3362
|
-
|
|
3363
|
-
- ``arn:<partition>:verifiedpermissions:<region>:<account_ID>:policy-store/<policy_store_UUID>``
|
|
3364
|
-
|
|
3365
2839
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudtrail-trail-advancedfieldselector.html#cfn-cloudtrail-trail-advancedfieldselector-field
|
|
3366
2840
|
'''
|
|
3367
2841
|
result = self._values.get("field")
|
|
@@ -3447,25 +2921,20 @@ class CfnTrail(
|
|
|
3447
2921
|
type: builtins.str,
|
|
3448
2922
|
values: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
3449
2923
|
) -> None:
|
|
3450
|
-
'''
|
|
3451
|
-
|
|
3452
|
-
These are also known as data plane operations. You can specify up to 250 data resources for a trail.
|
|
3453
|
-
|
|
3454
|
-
Configure the ``DataResource`` to specify the resource type and resource ARNs for which you want to log data events.
|
|
3455
|
-
|
|
3456
|
-
You can specify the following resource types in your event selectors for your trail:
|
|
2924
|
+
'''You can configure the ``DataResource`` in an ``EventSelector`` to log data events for the following three resource types:.
|
|
3457
2925
|
|
|
3458
2926
|
- ``AWS::DynamoDB::Table``
|
|
3459
2927
|
- ``AWS::Lambda::Function``
|
|
3460
2928
|
- ``AWS::S3::Object``
|
|
3461
2929
|
|
|
2930
|
+
To log data events for all other resource types including objects stored in `directory buckets <https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html>`_ , you must use `AdvancedEventSelectors <https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedEventSelector.html>`_ . You must also use ``AdvancedEventSelectors`` if you want to filter on the ``eventName`` field.
|
|
2931
|
+
|
|
2932
|
+
Configure the ``DataResource`` to specify the resource type and resource ARNs for which you want to log data events.
|
|
3462
2933
|
.. epigraph::
|
|
3463
2934
|
|
|
3464
2935
|
The total number of allowed data resources is 250. This number can be distributed between 1 and 5 event selectors, but the total cannot exceed 250 across all selectors for the trail.
|
|
3465
2936
|
|
|
3466
|
-
|
|
3467
|
-
|
|
3468
|
-
The following example demonstrates how logging works when you configure logging of all data events for an S3 bucket named ``DOC-EXAMPLE-BUCKET1`` . In this example, the CloudTrail user specified an empty prefix, and the option to log both ``Read`` and ``Write`` data events.
|
|
2937
|
+
The following example demonstrates how logging works when you configure logging of all data events for a general purpose bucket named ``DOC-EXAMPLE-BUCKET1`` . In this example, the CloudTrail user specified an empty prefix, and the option to log both ``Read`` and ``Write`` data events.
|
|
3469
2938
|
|
|
3470
2939
|
- A user uploads an image file to ``DOC-EXAMPLE-BUCKET1`` .
|
|
3471
2940
|
- The ``PutObject`` API operation is an Amazon S3 object-level API. It is recorded as a data event in CloudTrail. Because the CloudTrail user specified an S3 bucket with an empty prefix, events that occur on any object in that bucket are logged. The trail processes and logs the event.
|
|
@@ -3594,7 +3063,7 @@ class CfnTrail(
|
|
|
3594
3063
|
|
|
3595
3064
|
You cannot apply both event selectors and advanced event selectors to a trail.
|
|
3596
3065
|
|
|
3597
|
-
:param data_resources: CloudTrail supports data event logging for Amazon S3 objects, AWS Lambda functions, and Amazon DynamoDB tables with basic event selectors. You can specify up to 250 resources for an individual event selector, but the total number of data resources cannot exceed 250 across all event selectors in a trail. This limit does not apply if you configure resource logging for all data events. For more information, see `Data Events <https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html>`_ and `Limits in AWS CloudTrail <https://docs.aws.amazon.com/awscloudtrail/latest/userguide/WhatIsCloudTrail-Limits.html>`_ in the *AWS CloudTrail User Guide* .
|
|
3066
|
+
:param data_resources: CloudTrail supports data event logging for Amazon S3 objects in standard S3 buckets, AWS Lambda functions, and Amazon DynamoDB tables with basic event selectors. You can specify up to 250 resources for an individual event selector, but the total number of data resources cannot exceed 250 across all event selectors in a trail. This limit does not apply if you configure resource logging for all data events. For more information, see `Data Events <https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html>`_ and `Limits in AWS CloudTrail <https://docs.aws.amazon.com/awscloudtrail/latest/userguide/WhatIsCloudTrail-Limits.html>`_ in the *AWS CloudTrail User Guide* . .. epigraph:: To log data events for all other resource types including objects stored in `directory buckets <https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html>`_ , you must use `AdvancedEventSelectors <https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedEventSelector.html>`_ . You must also use ``AdvancedEventSelectors`` if you want to filter on the ``eventName`` field.
|
|
3598
3067
|
:param exclude_management_event_sources: An optional list of service event sources from which you do not want management events to be logged on your trail. In this release, the list can be empty (disables the filter), or it can filter out AWS Key Management Service or Amazon RDS Data API events by containing ``kms.amazonaws.com`` or ``rdsdata.amazonaws.com`` . By default, ``ExcludeManagementEventSources`` is empty, and AWS KMS and Amazon RDS Data API events are logged to your trail. You can exclude management event sources only in Regions that support the event source.
|
|
3599
3068
|
:param include_management_events: Specify if you want your event selector to include management events for your trail. For more information, see `Management Events <https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html>`_ in the *AWS CloudTrail User Guide* . By default, the value is ``true`` . The first copy of management events is free. You are charged for additional copies of management events that you are logging on any subsequent trail in the same Region. For more information about CloudTrail pricing, see `AWS CloudTrail Pricing <https://docs.aws.amazon.com/cloudtrail/pricing/>`_ .
|
|
3600
3069
|
:param read_write_type: Specify if you want your trail to log read-only events, write-only events, or all. For example, the EC2 ``GetConsoleOutput`` is a read-only API operation and ``RunInstances`` is a write-only API operation. By default, the value is ``All`` .
|
|
@@ -3640,11 +3109,14 @@ class CfnTrail(
|
|
|
3640
3109
|
def data_resources(
|
|
3641
3110
|
self,
|
|
3642
3111
|
) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnTrail.DataResourceProperty"]]]]:
|
|
3643
|
-
'''CloudTrail supports data event logging for Amazon S3 objects, AWS Lambda functions, and Amazon DynamoDB tables with basic event selectors.
|
|
3112
|
+
'''CloudTrail supports data event logging for Amazon S3 objects in standard S3 buckets, AWS Lambda functions, and Amazon DynamoDB tables with basic event selectors.
|
|
3644
3113
|
|
|
3645
3114
|
You can specify up to 250 resources for an individual event selector, but the total number of data resources cannot exceed 250 across all event selectors in a trail. This limit does not apply if you configure resource logging for all data events.
|
|
3646
3115
|
|
|
3647
3116
|
For more information, see `Data Events <https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html>`_ and `Limits in AWS CloudTrail <https://docs.aws.amazon.com/awscloudtrail/latest/userguide/WhatIsCloudTrail-Limits.html>`_ in the *AWS CloudTrail User Guide* .
|
|
3117
|
+
.. epigraph::
|
|
3118
|
+
|
|
3119
|
+
To log data events for all other resource types including objects stored in `directory buckets <https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html>`_ , you must use `AdvancedEventSelectors <https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedEventSelector.html>`_ . You must also use ``AdvancedEventSelectors`` if you want to filter on the ``eventName`` field.
|
|
3648
3120
|
|
|
3649
3121
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudtrail-trail-eventselector.html#cfn-cloudtrail-trail-eventselector-dataresources
|
|
3650
3122
|
'''
|