選取您的 Cookie 偏好設定

我們使用提供自身網站和服務所需的基本 Cookie 和類似工具。我們使用效能 Cookie 收集匿名統計資料,以便了解客戶如何使用我們的網站並進行改進。基本 Cookie 無法停用,但可以按一下「自訂」或「拒絕」以拒絕效能 Cookie。

如果您同意,AWS 與經核准的第三方也會使用 Cookie 提供實用的網站功能、記住您的偏好設定,並顯示相關內容,包括相關廣告。若要接受或拒絕所有非必要 Cookie,請按一下「接受」或「拒絕」。若要進行更詳細的選擇,請按一下「自訂」。

失敗的工作流程狀態

焦點模式
失敗的工作流程狀態 - AWS Step Functions

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

Fail 狀態 ("Type": "Fail") 會停止執行狀態機器,並將其標記為失敗,除非被Catch區塊攔截。

Fail 狀態僅允許使用 Type和 來自一組常見狀態Comment欄位的欄位。 工作流程中的常見狀態欄位此外,Fail 狀態允許使用下列欄位。

Cause (選用)

描述錯誤原因的自訂字串。您可以為操作或診斷目的指定此欄位。

在 JSONata 狀態中,您也可以指定 JSONata 表達式。

CausePath (選用,僅限 JSONPath)

如果您想要使用參考路徑從狀態輸入動態提供錯誤原因的詳細說明,請使用 CausePath。解決時,參考路徑必須選取包含字串值的欄位。

您也可以CausePath使用內部函數來指定 ,以傳回字串。這些內部是: States.Format、、States.JsonToStringStates.ArrayGetItemStates.Base64DecodeStates.Hash States.Base64EncodeStates.UUID

重要
  • 您可以在失敗狀態定義中指定 CauseCausePath,但不能同時指定兩者。

  • 作為資訊安全最佳實務,我們建議您從原因描述中移除任何敏感資訊或內部系統詳細資訊。

Error (選用)

您可以使用重試擷取欄位提供錯誤名稱來執行錯誤處理。您也可以提供操作或診斷用途的錯誤名稱。

在 JSONata 狀態中,您也可以指定 JSONata 表達式。

ErrorPath (選用,僅限 JSONPath)

如果您想要使用參考路徑從狀態輸入動態提供錯誤的名稱,請使用 ErrorPath。解決時,參考路徑必須選取包含字串值的欄位。

您也可以ErrorPath使用內部函數來指定 ,以傳回字串。這些內部是: States.Format、、States.JsonToStringStates.ArrayGetItemStates.Base64DecodeStates.Hash States.Base64EncodeStates.UUID

重要
  • 您可以在失敗狀態定義中指定 ErrorErrorPath,但不能同時指定兩者。

  • 作為資訊安全最佳實務,我們建議您從錯誤名稱中移除任何敏感資訊或內部系統詳細資訊。

由於 Fail 狀態一律會結束狀態機器,因此沒有 Next 欄位,也不需要 End 欄位。

失敗狀態定義範例

下列失敗狀態定義範例會指定靜態ErrorCause欄位值。

"FailState": { "Type": "Fail", "Cause": "Invalid response.", "Error": "ErrorA" }

下列失敗狀態定義範例會動態使用參考路徑來解析 ErrorCause 欄位值。

"FailState": { "Type": "Fail", "CausePath": "$.Cause", "ErrorPath": "$.Error" }

下列失敗狀態定義範例使用 States.Format 內部函數動態指定 ErrorCause 欄位值。

"FailState": { "Type": "Fail", "CausePath": "States.Format('This is a custom error message for {}, caused by {}.', $.Error, $.Cause)", "ErrorPath": "States.Format('{}', $.Error)" }

在本頁面

下一個主題:

教學課程和研討會

上一個主題:

Succeed
隱私權網站條款Cookie 偏好設定
© 2025, Amazon Web Services, Inc.或其附屬公司。保留所有權利。