AWS Security ChangesHomeSearch

AWS cli medium security documentation change

Service: cli · 2026-05-16 · Security-related medium

File: cli/latest/reference/arc-region-switch/get-plan-execution.md

Summary

Added documentation for new 'lambdaEventSourceMappingConfig' execution block in region switch plans. Updated CLI version references from 2.34.45 to 2.34.48. Added default value (100) for EC2 Auto Scaling target percentage.

Security assessment

The change introduces 'externalId' field described as a 'secret key' for cross-account Lambda event source mapping configurations. This indicates added security controls for preventing confused deputy attacks through external ID validation. The documentation now explicitly addresses secure cross-account access patterns.

Diff

diff --git a/cli/latest/reference/arc-region-switch/get-plan-execution.md b/cli/latest/reference/arc-region-switch/get-plan-execution.md
index a16ce7411..904267320 100644
--- a//cli/latest/reference/arc-region-switch/get-plan-execution.md
+++ b//cli/latest/reference/arc-region-switch/get-plan-execution.md
@@ -15 +15 @@
-  * [AWS CLI 2.34.45 Command Reference](../../index.html) »
+  * [AWS CLI 2.34.48 Command Reference](../../index.html) »
@@ -424 +424 @@ plan -> (structure)
->>>>>> This is a Tagged Union structure. Only one of the following top level keys can be set: `customActionLambdaConfig`, `ec2AsgCapacityIncreaseConfig`, `executionApprovalConfig`, `arcRoutingControlConfig`, `globalAuroraConfig`, `parallelConfig`, `regionSwitchPlanConfig`, `ecsCapacityIncreaseConfig`, `eksResourceScalingConfig`, `route53HealthCheckConfig`, `documentDbConfig`, `rdsPromoteReadReplicaConfig`, `rdsCreateCrossRegionReadReplicaConfig`.
+>>>>>> This is a Tagged Union structure. Only one of the following top level keys can be set: `customActionLambdaConfig`, `ec2AsgCapacityIncreaseConfig`, `executionApprovalConfig`, `arcRoutingControlConfig`, `globalAuroraConfig`, `parallelConfig`, `regionSwitchPlanConfig`, `ecsCapacityIncreaseConfig`, `eksResourceScalingConfig`, `route53HealthCheckConfig`, `documentDbConfig`, `rdsPromoteReadReplicaConfig`, `rdsCreateCrossRegionReadReplicaConfig`, `lambdaEventSourceMappingConfig`.
@@ -574 +574 @@ plan -> (structure)
->>>>>>>> The target percentage that you specify for EC2 Auto Scaling groups.
+>>>>>>>> The target percentage that you specify for EC2 Auto Scaling groups. The default is 100.
@@ -763 +763 @@ plan -> (structure)
->>>>>>>>>> This is a Tagged Union structure. Only one of the following top level keys can be set: `customActionLambdaConfig`, `ec2AsgCapacityIncreaseConfig`, `executionApprovalConfig`, `arcRoutingControlConfig`, `globalAuroraConfig`, `parallelConfig`, `regionSwitchPlanConfig`, `ecsCapacityIncreaseConfig`, `eksResourceScalingConfig`, `route53HealthCheckConfig`, `documentDbConfig`, `rdsPromoteReadReplicaConfig`, `rdsCreateCrossRegionReadReplicaConfig`.
+>>>>>>>>>> This is a Tagged Union structure. Only one of the following top level keys can be set: `customActionLambdaConfig`, `ec2AsgCapacityIncreaseConfig`, `executionApprovalConfig`, `arcRoutingControlConfig`, `globalAuroraConfig`, `parallelConfig`, `regionSwitchPlanConfig`, `ecsCapacityIncreaseConfig`, `eksResourceScalingConfig`, `route53HealthCheckConfig`, `documentDbConfig`, `rdsPromoteReadReplicaConfig`, `rdsCreateCrossRegionReadReplicaConfig`, `lambdaEventSourceMappingConfig`.
@@ -913 +913 @@ plan -> (structure)
->>>>>>>>>>>> The target percentage that you specify for EC2 Auto Scaling groups.
+>>>>>>>>>>>> The target percentage that you specify for EC2 Auto Scaling groups. The default is 100.
@@ -1188 +1188 @@ plan -> (structure)
->>>>>>>>>>>> The target percentage specified for the configuration.
+>>>>>>>>>>>> The target percentage specified for the configuration. The default is 100.
@@ -1328 +1328 @@ plan -> (structure)
->>>>>>>>>>>> The target percentage for the configuration.
+>>>>>>>>>>>> The target percentage for the configuration. The default is 100.
@@ -1594,0 +1595,86 @@ plan -> (structure)
+>>>>>>>>>> 
+>>>>>>>>>> lambdaEventSourceMappingConfig -> (structure)
+>>>>>>>>>>
+>>>>>>>>>>> A Lambda event source mapping execution block.
+>>>>>>>>>>> 
+>>>>>>>>>>> timeoutMinutes -> (integer)
+>>>>>>>>>>>
+>>>>>>>>>>>> The timeout value specified for the configuration.
+>>>>>>>>>>>> 
+>>>>>>>>>>>> Constraints:
+>>>>>>>>>>>> 
+>>>>>>>>>>>>   * min: `1`
+>>>>>>>>>>>> 
+
+>>>>>>>>>>> 
+>>>>>>>>>>> action -> (string) [required]
+>>>>>>>>>>>
+>>>>>>>>>>>> The action to take - whether to `enable` or `disable` an event source mapping.
+>>>>>>>>>>>> 
+>>>>>>>>>>>> Possible values:
+>>>>>>>>>>>> 
+>>>>>>>>>>>>   * `enable`
+>>>>>>>>>>>>   * `disable`
+>>>>>>>>>>>> 
+
+>>>>>>>>>>> 
+>>>>>>>>>>> regionEventSourceMappings -> (map) [required]
+>>>>>>>>>>>
+>>>>>>>>>>>> Per-region configuration for which Lambda event source mapping to enable or disable when activating or deactivating a region.
+>>>>>>>>>>>> 
+>>>>>>>>>>>> Constraints:
+>>>>>>>>>>>> 
+>>>>>>>>>>>>   * min: `1`
+>>>>>>>>>>>>   * max: `2`
+>>>>>>>>>>>> 
+
+>>>>>>>>>>>> 
+>>>>>>>>>>>> key -> (string)
+>>>>>>>>>>>>
+>>>>>>>>>>>>> Constraints:
+>>>>>>>>>>>>> 
+>>>>>>>>>>>>>   * pattern: `[a-z]{2}-[a-z-]+-\d+`
+>>>>>>>>>>>>> 
+
+>>>>>>>>>>>> 
+>>>>>>>>>>>> value -> (structure)
+>>>>>>>>>>>>
+>>>>>>>>>>>>> The Amazon Web Services Lambda event source mapping configuration, containing the resource ARN and optional cross-account configuration.
+>>>>>>>>>>>>> 
+>>>>>>>>>>>>> crossAccountRole -> (string)
+>>>>>>>>>>>>>
+>>>>>>>>>>>>>> The cross account role for the configuration.
+>>>>>>>>>>>>>> 
+>>>>>>>>>>>>>> Constraints:
+>>>>>>>>>>>>>> 
+>>>>>>>>>>>>>>   * pattern: `arn:aws[a-zA-Z0-9-]*:iam::[0-9]{12}:role/.+`
+>>>>>>>>>>>>>> 
+
+>>>>>>>>>>>>> 
+>>>>>>>>>>>>> externalId -> (string)
+>>>>>>>>>>>>>
+>>>>>>>>>>>>>> The external ID (secret key) for the configuration.
+>>>>>>>>>>>>> 
+>>>>>>>>>>>>> arn -> (string) [required]
+>>>>>>>>>>>>>
+>>>>>>>>>>>>>> The Amazon Resource Name (ARN) of the Lambda event source mapping.
+>>>>>>>>>>>>>> 
+>>>>>>>>>>>>>> Constraints:
+>>>>>>>>>>>>>> 
+>>>>>>>>>>>>>>   * pattern: `arn:aws[a-zA-Z-]*:lambda:[a-z0-9-]+:\d{12}:event-source-mapping:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}`
+>>>>>>>>>>>>>> 
+
+>>>>>>>>>>> 
+>>>>>>>>>>> ungraceful -> (structure)
+>>>>>>>>>>>
+>>>>>>>>>>>> The settings for ungraceful execution.
+>>>>>>>>>>>> 
+>>>>>>>>>>>> behavior -> (string)
+>>>>>>>>>>>>
+>>>>>>>>>>>>> Set to `skip` to skip executing this event source mapping step during an ungraceful execution.
+>>>>>>>>>>>>> 
+>>>>>>>>>>>>> Possible values:
+>>>>>>>>>>>>> 
+>>>>>>>>>>>>>   * `skip`
+>>>>>>>>>>>>> 
+
@@ -1614,0 +1701 @@ plan -> (structure)
+>>>>>>>>>>   * `LambdaEventSourceMapping`
@@ -1726 +1813 @@ plan -> (structure)
->>>>>>>> The target percentage specified for the configuration.
+>>>>>>>> The target percentage specified for the configuration. The default is 100.
@@ -1866 +1953 @@ plan -> (structure)
->>>>>>>> The target percentage for the configuration.
+>>>>>>>> The target percentage for the configuration. The default is 100.
@@ -2132,0 +2220,86 @@ plan -> (structure)
+>>>>>> 
+>>>>>> lambdaEventSourceMappingConfig -> (structure)
+>>>>>>
+>>>>>>> A Lambda event source mapping execution block.
+>>>>>>> 
+>>>>>>> timeoutMinutes -> (integer)
+>>>>>>>
+>>>>>>>> The timeout value specified for the configuration.
+>>>>>>>> 
+>>>>>>>> Constraints:
+>>>>>>>> 
+>>>>>>>>   * min: `1`
+>>>>>>>> 
+
+>>>>>>> 
+>>>>>>> action -> (string) [required]
+>>>>>>>
+>>>>>>>> The action to take - whether to `enable` or `disable` an event source mapping.
+>>>>>>>> 
+>>>>>>>> Possible values:
+>>>>>>>> 
+>>>>>>>>   * `enable`
+>>>>>>>>   * `disable`
+>>>>>>>> 
+
+>>>>>>> 
+>>>>>>> regionEventSourceMappings -> (map) [required]
+>>>>>>>
+>>>>>>>> Per-region configuration for which Lambda event source mapping to enable or disable when activating or deactivating a region.
+>>>>>>>> 
+>>>>>>>> Constraints:
+>>>>>>>> 
+>>>>>>>>   * min: `1`
+>>>>>>>>   * max: `2`
+>>>>>>>> 
+
+>>>>>>>> 
+>>>>>>>> key -> (string)
+>>>>>>>>
+>>>>>>>>> Constraints:
+>>>>>>>>> 
+>>>>>>>>>   * pattern: `[a-z]{2}-[a-z-]+-\d+`
+>>>>>>>>> 
+
+>>>>>>>> 
+>>>>>>>> value -> (structure)
+>>>>>>>>
+>>>>>>>>> The Amazon Web Services Lambda event source mapping configuration, containing the resource ARN and optional cross-account configuration.
+>>>>>>>>> 
+>>>>>>>>> crossAccountRole -> (string)
+>>>>>>>>>
+>>>>>>>>>> The cross account role for the configuration.
+>>>>>>>>>> 
+>>>>>>>>>> Constraints:
+>>>>>>>>>> 
+>>>>>>>>>>   * pattern: `arn:aws[a-zA-Z0-9-]*:iam::[0-9]{12}:role/.+`
+>>>>>>>>>> 
+
+>>>>>>>>> 
+>>>>>>>>> externalId -> (string)
+>>>>>>>>>
+>>>>>>>>>> The external ID (secret key) for the configuration.
+>>>>>>>>> 
+>>>>>>>>> arn -> (string) [required]
+>>>>>>>>>
+>>>>>>>>>> The Amazon Resource Name (ARN) of the Lambda event source mapping.
+>>>>>>>>>> 
+>>>>>>>>>> Constraints:
+>>>>>>>>>> 
+>>>>>>>>>>   * pattern: `arn:aws[a-zA-Z-]*:lambda:[a-z0-9-]+:\d{12}:event-source-mapping:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}`
+>>>>>>>>>> 
+
+>>>>>>> 
+>>>>>>> ungraceful -> (structure)
+>>>>>>>
+>>>>>>>> The settings for ungraceful execution.
+>>>>>>>> 
+>>>>>>>> behavior -> (string)
+>>>>>>>>