Step Functions 中 JSONPath 狀態的內部函數

States.Array 內部函數接受零個或多個引數。解譯器會依提供的順序傳回包含引數值的 JSON 陣列。例如，假設有下列輸入：

{
  "Id": 123456
}

您可以使用

"BuildId.$": "States.Array($.Id)"

這會傳回下列結果：

“BuildId”: [123456]

使用States.ArrayPartition內部 函數來分割大型陣列。您也可以使用此內部來分割資料，然後以較小的區塊傳送承載。

此內部函數需要兩個引數。第一個引數是陣列，而第二個引數定義區塊大小。解譯器會將輸入陣列區塊化為區塊大小所指定大小的多個陣列。如果陣列中剩餘項目的數量小於區塊大小，則最後一個陣列區塊的長度可能會小於先前陣列區塊的長度。

輸入驗證

例如，指定下列輸入陣列：

{"inputArray": [1,2,3,4,5,6,7,8,9] }

您可以使用 States.ArrayPartition函數將陣列分割為四個值的區塊：

"inputArray.$": "States.ArrayPartition($.inputArray,4)"

這會傳回下列陣列區塊：

{"inputArray": [ [1,2,3,4], [5,6,7,8], [9]] }

在先前的範例中，States.ArrayPartition函數會輸出三個陣列。前兩個陣列各包含四個值，如區塊大小所定義。第三個陣列包含剩餘值，且小於定義的區塊大小。

使用States.ArrayContains內部 函數來判斷陣列中是否存在特定值。例如，您可以使用此函數來偵測Map狀態反覆運算中是否有錯誤。

此內部函數需要兩個引數。第一個引數是陣列，而第二個引數是要在陣列中搜尋的值。

輸入驗證

例如，指定下列輸入陣列：

{
   "inputArray": [1,2,3,4,5,6,7,8,9],
   "lookingFor": 5
}

您可以使用 States.ArrayContains函數在 中尋找lookingFor值inputArray：

"contains.$": "States.ArrayContains($.inputArray, $.lookingFor)"

由於存放在 中的值lookingFor包含在 中inputArray， States.ArrayContains會傳回下列結果：

{"contains": true }

使用States.ArrayRange內部 函數來建立新的陣列，其中包含特定範圍的元素。新陣列最多可包含 1000 個元素。

此函數需要三個引數。第一個引數是新陣列的第一個元素，第二個引數是新陣列的最終元素，第三個引數是新陣列中元素之間的增量值。

輸入驗證

例如，下列 States.ArrayRange函數的使用會建立 陣列，其第一個值為 1，最終值為 9，且每個項目第一個值與最終值之間的值會增加 2：

"array.$": "States.ArrayRange(1, 9, 2)"

這會傳回下列陣列：

{"array": [1,3,5,7,9] }

此內部函數會傳回指定的索引值。此函數需要兩個引數。第一個引數是值的陣列，第二個引數是要傳回值的陣列索引。

例如，使用下列 inputArray和 index值：

{
   "inputArray": [1,2,3,4,5,6,7,8,9],
   "index": 5
}

從這些值中，您可以使用 States.ArrayGetItem函數傳回陣列中index位置 5 的值：

"item.$": "States.ArrayGetItem($.inputArray, $.index)"

在此範例中， States.ArrayGetItem會傳回下列結果：

{ "item": 6 }

States.ArrayLength 內部函數會傳回陣列的長度。它有一個引數，即要傳回 長度的陣列。

例如，指定下列輸入陣列：

{
   "inputArray": [1,2,3,4,5,6,7,8,9]
}

您可以使用 States.ArrayLength傳回 的長度inputArray：

"length.$": "States.ArrayLength($.inputArray)"

在此範例中， States.ArrayLength會傳回代表陣列長度的下列 JSON 物件：

{ "length": 9 }

States.ArrayUnique 內部函數會從陣列中移除重複值，並傳回僅包含唯一元素的陣列。此函數會採用陣列，此陣列可取消排序，做為其唯一引數。

例如，以下inputArray包含一系列重複值：

{"inputArray": [1,2,3,3,3,3,3,3,4] }

您可以使用 States.ArrayUnique函數做為 ，並指定要從中移除重複值的陣列：

"array.$": "States.ArrayUnique($.inputArray)"

States.ArrayUnique 函數會傳回以下僅包含唯一元素的陣列，移除所有重複值：

{"array": [1,2,3,4] }

使用States.Base64Encode內部 函數，根據 MIME Base64 編碼機制來編碼資料。您可以使用此函數將資料傳遞至其他 AWS 服務，而無需使用 AWS Lambda 函數。

此函數最多需要 10，000 個字元的資料字串，才能編碼為其唯一的引數。

例如，請考慮下列input字串：

{"input": "Data to encode" }

您可以使用 States.Base64Encode函數將input字串編碼為 MIME Base64 字串：

"base64.$": "States.Base64Encode($.input)"

States.Base64Encode 函數會傳回下列編碼資料以回應：

{"base64": "RGF0YSB0byBlbmNvZGU=" }

使用States.Base64Decode內部 函數，根據 MIME Base64 解碼結構描述解碼資料。您可以使用此函數將資料傳遞至其他服務， AWS 而無需使用 Lambda 函數。

此函數最多需要 10，000 個字元的 Base64 編碼資料字串，才能解碼為其唯一的引數。

例如，假設有下列輸入：

{"base64": "RGF0YSB0byBlbmNvZGU=" }

您可以使用 States.Base64Decode函數將 base64 字串解碼為人類可讀取的字串：

"data.$": "States.Base64Decode($.base64)"

States.Base64Decode function 會傳回下列解碼資料以回應：

{"data": "Decoded data" }

使用States.Hash內部 函數來計算指定輸入的雜湊值。您可以使用此函數將資料傳遞至其他服務， AWS 而無需使用 Lambda 函數。

此函數需要兩個引數。第一個引數是您要計算雜湊值的資料。第二個引數是用來執行雜湊計算的雜湊演算法。您提供的資料必須是包含 10，000 個字元或更少的物件字串。

您指定的雜湊演算法可以是下列任何演算法：

例如，您可以使用此函數，使用指定的 來計算Data字串的雜湊值Algorithm：

{
   "Data": "input data", 
   "Algorithm": "SHA-1" 
}

您可以使用 States.Hash函數來計算雜湊值：

"output.$": "States.Hash($.Data, $.Algorithm)"

States.Hash 函數會傳回下列雜湊值以回應：

{"output": "aaff4a450a104cd177d28d18d7485e8cae074b7" }

使用States.JsonMerge內部 函數將兩個 JSON 物件合併為單一物件。此函數需要三個引數。前兩個引數是您要合併的 JSON 物件。第三個引數是布林值 false。此布林值會判斷是否啟用深度合併模式。

目前，Step Functions 僅支援淺合併模式；因此，您必須將布林值指定為 false。在淺模式中，如果兩個 JSON 物件中都存在相同的金鑰，則後一個物件的金鑰會覆寫第一個物件中的相同金鑰。此外，當您使用淺合併時，不會合併在 JSON 物件內巢狀的物件。

例如，您可以使用 States.JsonMerge函數合併下列共用金鑰 的 JSON 物件a。

{
   "json1": { "a": {"a1": 1, "a2": 2}, "b": 2 },
   "json2": { "a": {"a3": 1, "a4": 2}, "c": 3 }
}

您可以指定 json1 和 json2 物件做為States.JsonMerge函數中的輸入，將它們合併在一起：

"output.$": "States.JsonMerge($.json1, $.json2, false)"

States.JsonMerge 會傳回下列合併的 JSON 物件做為結果。在合併的 JSON 物件 中output，json2物件的金鑰 會a取代json1物件的金鑰 a。此外，a會捨棄json1物件金鑰中的巢狀物件，因為淺層模式不支援合併巢狀物件。

{
   "output": {
      "a": {"a3": 1, "a4": 2},
      "b": 2, 
      "c": 3 
   }
}

States.StringToJson 函數會將逸出 JSON 字串的參考路徑作為其唯一引數。

解譯器會套用 JSON 剖析器，並傳回輸入的剖析 JSON 表單。例如，您可以使用此函數來逸出下列輸入字串：

{
 "escapedJsonString": "{\"foo\": \"bar\"}"
}
                

使用 States.StringToJson函數，並將 指定escapedJsonString為輸入引數：

States.StringToJson($.escapedJsonString)

States.StringToJson 函數會傳回下列結果：

{ "foo": "bar" }

States.JsonToString 函數只需要一個引數，這是包含要以未逸出字串傳回之 JSON 資料的路徑。解譯器會傳回字串，其中包含代表路徑所指定資料的 JSON 文字。例如，您可以提供包含逸出值的下列 JSON 路徑：

{
  "unescapedJson": {
     "foo": "bar"
  }
}

為States.JsonToString函數提供包含在 中的資料unescapedJson：

States.JsonToString($.unescapedJson)
                

States.JsonToString 函數會傳回下列回應：

{\"foo\": \"bar\"}

使用 States.MathRandom 內部函數傳回指定起始編號 （包含） 和結束編號 （專屬） 之間的隨機數字。

您可以使用此函數，在兩個或多個資源之間分配特定任務。

此函數需要三個引數。第一個引數是起始數字，第二個引數是結束數字，最後一個引數控制選用的種子值，請注意，如果您使用此函數搭配相同的種子值，則會傳回相同的數字。

輸入驗證

例如，若要產生介於 1 到 999 之間的隨機數字，您可以使用下列輸入值：

{
   "start": 1,
   "end": 999
}

若要產生隨機數字，請提供 start和 end值給States.MathRandom函數：

"random.$": "States.MathRandom($.start, $.end)"

States.MathRandom 函數會傳回下列隨機數字做為回應：

{"random": 456 }

使用States.MathAdd內部 函數來傳回兩個數字的總和。例如，您可以使用此函數來增加迴圈內的值，而無需叫用 Lambda 函數。

輸入驗證

例如，您可以使用下列值從 111 中減去一個值：

{
   "value1": 111,
   "step": -1
}

然後，使用value1定義為起始值的 States.MathAdd 函數，以及step定義為要遞增的值value1：

"value1.$": "States.MathAdd($.value1, $.step)"

States.MathAdd 函數會傳回下列數字以回應：

{"value1": 110 }

使用States.StringSplit內部 函數將字串分割為 值陣列。此函數需要兩個引數。第一個引數是字串，第二個引數是函數用來分割字串的分隔字元。

{
    "inputString": "1,2,3,4,5",
    "splitter": ","
}

"array.$": "States.StringSplit($.inputString, $.splitter)"

{"array":  ["1","2","3","4","5"] }

{
  "inputString": "This.is+a,test=string",
  "splitter": ".+,="
}

{
  "myStringArray.$": "States.StringSplit($.inputString, $.splitter)"
}

{"myStringArray": [
  "This",
  "is",
  "a",
  "test",
  "string"
]}

使用 States.UUID 內部函數傳回使用隨機數字產生的第 4 版通用唯一識別碼 (v4 UUID)。例如，您可以使用此函數來呼叫需要 UUID 參數的其他 AWS 服務或資源，或在 DynamoDB 資料表中插入項目。

States.UUID 函數呼叫時未指定引數：

"uuid.$": "States.UUID()"

函數會傳回隨機產生的 UUID，如下列範例所示：

{"uuid": "ca4c1140-dcc1-40cd-ad05-7b4aa23df4a8" }

使用States.Format內部 函數從常值和插補值建構字串。此函數會採用一或多個引數。第一個引數的值必須是字串，且可包含字元序列 的零個或多個執行個體{}。內部函數調用中必須具有與發生 一樣多的剩餘引數{}。解譯器會傳回第一個引數中定義的字串，每個引數都會{}取代為內部調用中位置對應引數的值。

例如，您可以使用個人 的下列輸入name，以及將名稱插入其中的template句子：

{
 "name": "Arnav",
 "template": "Hello, my name is {}."
}

使用 States.Format函數並指定template字串和要插入的字串來取代{}字元：

States.Format('Hello, my name is {}.', $.name)

或

States.Format($.template, $.name)

使用上述任一輸入，States.Format函數會傳回完成的字串以回應：

Hello, my name is Arnav.