AWS cli: Lambda checkpoint-durable-execution: add XAmznTraceId option

Service: cli · 2026-10-15 · Documentation low

File: cli/latest/reference/lambda/checkpoint-durable-execution.md

Summary

Adds the optional XAmznTraceId string (0-8192 chars) to ChainedInvokeOptions for the START update of a chained invocation, letting callers supply an X-Ray trace header; otherwise the child invocation inherits the parent durable execution's trace header. Updates shorthand and JSON syntax examples and the CLI version footer to 2.38.1.

Security assessment

The added field only propagates an X-Ray tracing header for chained durable executions, which is observability/troubleshooting functionality. It does not change authentication, authorization, encryption, or data exposure, and no vulnerability or advisory is referenced.

Evidence

+          "XAmznTraceId": "string"

Diff

diff --git a/cli/latest/reference/lambda/checkpoint-durable-execution.md b/cli/latest/reference/lambda/checkpoint-durable-execution.md
index 015937d..8c3d604 100644
--- a//cli/latest/reference/lambda/checkpoint-durable-execution.md
+++ b//cli/latest/reference/lambda/checkpoint-durable-execution.md
@@ -15 +15 @@
-  * [AWS CLI 2.38.0 Command Reference](../../index.html) »
+  * [AWS CLI 2.38.1 Command Reference](../../index.html) »
@@ -330,0 +331,13 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/lambda
+>>> 
+>>> XAmznTraceId -> (string)
+>>>
+>>>> The optional X-Ray trace header to use when starting the chained invocation. If you omit this value, the child invocation inherits the parent durable execution’s trace header.
+>>>> 
+>>>> Specify this value on the `START` update for the chained invocation operation. For more information about the header format, see [Tracing header](https://docs.aws.amazon.com/xray/latest/devguide/xray-concepts.html#xray-concepts-tracingheader) in the _X-Ray Developer Guide_ .
+>>>> 
+>>>> Constraints:
+>>>> 
+>>>>   * min: `0`
+>>>>   * max: `8192`
+>>>> 
+
@@ -335 +348 @@ Shorthand Syntax:
-    Id=string,ParentId=string,Name=string,Type=string,SubType=string,Action=string,Payload=string,Error={ErrorMessage=string,ErrorType=string,ErrorData=string,StackTrace=[string,string]},ContextOptions={ReplayChildren=boolean},StepOptions={NextAttemptDelaySeconds=integer},WaitOptions={WaitSeconds=integer},CallbackOptions={TimeoutSeconds=integer,HeartbeatTimeoutSeconds=integer},ChainedInvokeOptions={FunctionName=string,TenantId=string} ...
+    Id=string,ParentId=string,Name=string,Type=string,SubType=string,Action=string,Payload=string,Error={ErrorMessage=string,ErrorType=string,ErrorData=string,StackTrace=[string,string]},ContextOptions={ReplayChildren=boolean},StepOptions={NextAttemptDelaySeconds=integer},WaitOptions={WaitSeconds=integer},CallbackOptions={TimeoutSeconds=integer,HeartbeatTimeoutSeconds=integer},ChainedInvokeOptions={FunctionName=string,TenantId=string,XAmznTraceId=string} ...
@@ -371 +384,2 @@ JSON Syntax:
-          "TenantId": "string"
+          "TenantId": "string",
+          "XAmznTraceId": "string"
@@ -830 +844 @@ NewExecutionState -> (structure)
-  * [AWS CLI 2.38.0 Command Reference](../../index.html) »
+  * [AWS CLI 2.38.1 Command Reference](../../index.html) »