本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
路径
在 Amazon States Language中,路径是以 $
开头的字符串,您可使用该字符串来标识 JSON 文本中的组件。路径遵循JsonPathInputPath
、ResultPath
和 OutputPath
的值时,可以指定访问输入子集的路径。有关更多信息,请参阅 Step Functions 中的输入和输出处理。
注意
您还可以使用状态定义的 Parameters
字段中的路径指定输入或上下文对象的 JSON 节点。请参阅 将参数传递给服务 API。
如果您的字段名包含任何未包含在 JsonPath ABNFmember-name-shorthand
定义中的字符,则必须使用方括号表示法。因此,要对标点符号(不包括_
)等特殊字符进行编码,必须使用方括号表示法。例如,$.abc.['def ghi']
。
引用路径
引用路径 是一种语法存在限制的路径,它只能标识 JSON 结构中的单个节点:
-
您可以使用句点 (
.
) 和方括号 ([ ]
) 表示法访问对象字段。 -
不支持像
length()
这样的函数。 -
不支持非符号的词法运算符,例如
subsetof
。 -
不支持按正则表达式或引用 JSON 结构中的其他值进行筛选。
-
不支持运算符
@
,
:
、、和?
例如,如果状态输入数据包含以下值:
{
"foo": 123,
"bar": ["a", "b", "c"],
"car": {
"cdr": true
}
}
以下引用路径将返回以下内容。
$.foo => 123
$.bar => ["a", "b", "c"]
$.car.cdr => true
某些状态使用路径和引用路径来控制状态机的流,或者配置状态的设置或选项。有关更多信息,请参阅中的使用数据流模拟器对工作流输入和输出路径处理
展平由数组组成的数组
如果状态机中的 Parallel 或 Map 状态返回由数组组成的数组,则可以使用 ResultSelector 字段将他们转换为一个平面数组。您可以将此字段包含在 Parallel 或 Map 状态定义中,以操纵这些状态的结果。
要展平数组,请在 ResultSelector
字段中使用 JMESPath 语法 [*]
"ResultSelector": { "flattenArray.$": "$[*][*]" }
有关演示如何展平数组的示例,请参阅以下教程中的第 3 步: