Verwenden TestState API, um einen Zustand in Step Functions zu testen

Der TestStateAPIakzeptiert die Definition eines einzelnen Zustands und führt ihn aus. Sie können einen Status testen, ohne eine Zustandsmaschine zu erstellen oder eine vorhandene Zustandsmaschine zu aktualisieren.

Mit TestState API dem können Sie Folgendes testen:

Um einen Status zu testen, können Sie auch die Step FunctionsKonsole oder die verwendenSDK. AWS Command Line Interface (AWS CLI)

Das TestState API nimmt eine IAM Rolle an, die die erforderlichen IAM Berechtigungen für die Ressourcen enthalten muss, auf die Ihr Bundesstaat zugreift. Informationen zu den Berechtigungen, die ein Staat möglicherweise benötigt, finden Sie unterIAMBerechtigungen für die Verwendung TestState API.

Überlegungen zur Verwendung von TestState API

Mit TestStateAPIdem können Sie jeweils nur einen Status testen. Zu den Staaten, die Sie testen können, gehören die folgenden:

Beachten Sie bei der TestState API Verwendung von die folgenden Überlegungen.

Verwenden von Inspektionsstufen in TestState API

Um einen Zustand mit dem zu testen TestStateAPI, geben Sie die Definition dieses Zustands an. Der Test gibt dann eine Ausgabe zurück. Für jeden Status können Sie angeben, wie viele Details Sie in den Testergebnissen anzeigen möchten. Diese Details enthalten zusätzliche Informationen über den Bundesstaat, den Sie testen. Wenn Sie beispielsweise Eingabe- und Ausgabedatenverarbeitungsfilter wie InputPathoder ResultPathin einem Bundesstaat verwendet haben, können Sie die Zwischen- und Enddaten der Datenverarbeitung einsehen.

Step Functionsbietet die folgenden Ebenen, um die Details anzugeben, die Sie anzeigen möchten:

Bei all diesen Ebenen werden auch die nextState Felder status und zurückgegeben. statusgibt den Status der Ausführung im Status an. Zum BeispielSUCCEEDED, FAILEDRETRIABLE, undCAUGHT_ERROR. nextStategibt den Namen des nächsten Status an, zu dem der Übergang erfolgen soll. Wenn Sie in Ihrer Definition keinen nächsten Status definiert haben, gibt dieses Feld einen leeren Wert zurück.

Informationen zum Testen eines Zustands mithilfe dieser Inspektionsstufen in der Step Functions Konsole und AWS CLI finden Sie unter Testen eines Zustands (Konsole) undTesten eines Zustands mit AWS CLI.

INFO inspectionLevel

Wenn der Test erfolgreich ist, zeigt diese Stufe die Statusausgabe an. Wenn der Test fehlschlägt, zeigt diese Stufe die Fehlerausgabe an. Step FunctionsLegt standardmäßig die Inspektionsstufe auf fest, INFOwenn Sie keine Stufe angeben.

Die folgende Abbildung zeigt einen Test für den Status „Bestanden“, der erfolgreich ist. Die Inspektionsstufe für diesen Status ist auf eingestellt, INFOund die Ausgabe für den Status wird auf der Registerkarte Ausgabe angezeigt.

Die folgende Abbildung zeigt einen Test, der für einen Task-Status fehlgeschlagen ist, wenn die Inspektionsstufe auf eingestellt ist INFO. Auf der Registerkarte Ausgabe wird die Fehlerausgabe angezeigt, die den Fehlernamen und eine ausführliche Erklärung der Fehlerursache enthält.

DEBUG inspectionLevel

Wenn der Test erfolgreich ist, werden auf dieser Ebene die Statusausgabe und das Ergebnis der Eingabe- und Ausgabedatenverarbeitung angezeigt.

Schlägt der Test fehl, zeigt diese Stufe die Fehlerausgabe an. Auf dieser Ebene werden die Zwischenergebnisse der Datenverarbeitung bis zum Zeitpunkt des Fehlers angezeigt. Angenommen, Sie haben einen Task-Status getestet, der eine Lambda Funktion aufruft. Stellen Sie sich vor, Sie hätten die Filtern der Statusausgabe mithilfe von Workflows OutputPath in Step Functions Filter InputPathParameter,Zustandsausgabe mithilfe von Workflows ResultPath in Step Functions angeben, und auf den Status Task angewendet. Angenommen, der Aufruf ist fehlgeschlagen. In diesem Fall zeigt die DEBUG Ebene die Datenverarbeitungsergebnisse, die auf der Anwendung der Filter basieren, in der folgenden Reihenfolge an:

Die auf dieser Ebene verfügbaren Diagnoseinformationen können Ihnen bei der Behebung von Problemen im Zusammenhang mit einer Serviceintegration oder einem von Ihnen definierten Ablauf der Eingabe- und Ausgabedatenverarbeitung helfen.

Die folgende Abbildung zeigt einen Test für den Status „Bestanden“, der erfolgreich ist. Die Inspektionsstufe für diesen Status ist auf DEBUGeingestellt. Die Registerkarte Eingabe-/Ausgabeverarbeitung in der folgenden Abbildung zeigt das Ergebnis der Anwendung von Parametersauf die für diesen Status bereitgestellte Eingabe.

Die folgende Abbildung zeigt einen Test, der für einen Task-Status fehlgeschlagen ist, wenn die Inspektionsstufe auf eingestellt ist DEBUG. Die Registerkarte Eingabe-/Ausgabeverarbeitung in der folgenden Abbildung zeigt das Ergebnis der Eingabe- und Ausgabedatenverarbeitung für den Status bis zum Zeitpunkt des Fehlers.

TRACE inspectionLevel

Step Functionsgibt die TRACEEbene an, auf der eine HTTPAufgabe getestet werden kann. Diese Ebene gibt Informationen über die HTTP Anfrage zurück, die gestellt wurde, Step Functions und über die Antwort, die ein Drittanbieter API zurückgibt. Die Antwort kann Informationen wie Header und Anfragetext enthalten. Darüber hinaus können Sie den Status, die Ausgabe und das Ergebnis der Eingabe- und Ausgabedatenverarbeitung auf dieser Ebene anzeigen.

Wenn der Test fehlschlägt, zeigt diese Stufe die Fehlerausgabe an.

Diese Stufe gilt nur für HTTP Task. Step Functionsgibt einen Fehler aus, wenn Sie diese Ebene für andere Statustypen verwenden.

Wenn Sie die Inspektionsebene auf einstellen TRACE, können Sie auch die in der EventBridge Verbindung enthaltenen Geheimnisse einsehen. Dazu müssen Sie den revealSecrets Parameter true in der auf setzen TestStateAPI. Darüber hinaus müssen Sie sicherstellen, dass der IAM Benutzer, der den aufruft, TestState API über die Berechtigung für die states:RevealSecrets Aktion verfügt. Ein Beispiel für eine IAM Richtlinie, die die states:RevealSecrets Berechtigung festlegt, finden Sie unterIAMBerechtigungen für die Verwendung TestState API. Ohne diese Berechtigung wird der Fehler Step Functions „Zugriff verweigert“ ausgegeben.

Wenn Sie den revealSecrets Parameter auf setzenfalse, werden alle Geheimnisse in Step Functions den HTTP Anforderungs- und Antwortdaten ausgelassen.

Die folgende Abbildung zeigt einen Test für eine HTTP Aufgabe, der erfolgreich war. Die Inspektionsstufe für diesen Status ist auf TRACEeingestellt. Die Registerkarte „HTTPAnfrage und Antwort“ in der folgenden Abbildung zeigt das Ergebnis des API Anrufs eines Drittanbieters.

IAMBerechtigungen für die Verwendung TestState API

Der IAM Benutzer, der den aufruft, TestState API muss über die erforderlichen Berechtigungen verfügen, um die states:TestState iam:PassRole AND-Aktionen auszuführen. Wenn Sie den revealSecretsParameter auf festlegen, müssen Sie außerdem sicherstellentrue, dass der IAM Benutzer über die erforderlichen Berechtigungen zum Ausführen der states:RevealSecrets Aktion verfügt. Ohne diese Berechtigung wird der Fehler Step Functions „Zugriff verweigert“ ausgegeben.

Sie müssen außerdem sicherstellen, dass Ihre Ausführungsrolle die erforderlichen IAM Berechtigungen für die Ressourcen enthält, auf die Ihr Bundesstaat zugreift. Informationen zu den Berechtigungen, die ein Staat möglicherweise benötigt, finden Sie unter Ausführungsrollen verwalten.

Im folgenden IAM Richtlinienbeispiel werden die states:RevealSecrets Berechtigungen states:TestStateiam:PassRole, und festgelegt.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "states:TestState",
        "states:RevealSecrets",
        "iam:PassRole"
      ],
      "Resource": "*"
    }
  ]
}

Testen eines Zustands (Konsole)

Sie können einen Status in der Konsole testen und die Statusausgabe oder den Ablauf der Eingabe- und Ausgabedatenverarbeitung überprüfen. Bei einer HTTPAufgabe können Sie die HTTP Rohanforderung und -antwort testen.

Testen eines Zustands mit AWS CLI

Sie können einen unterstützten Status mit dem TestStateAPIin testenAWS CLI. Dadurch wird die Definition eines Zustands API akzeptiert und ausgeführt.

Für jeden Status können Sie angeben, wie viele Details Sie in den Testergebnissen anzeigen möchten. Diese Details enthalten zusätzliche Informationen über die Ausführung des Status, einschließlich der Ergebnisse der Eingabe- und Ausgabedatenverarbeitung sowie der HTTP Anfrage- und Antwortinformationen. In den folgenden Beispielen werden die verschiedenen Inspektionsstufen veranschaulicht, die Sie für die angeben können TestState API. Denken Sie daran, das zu ersetzen italicized Text mit Ihren ressourcenspezifischen Informationen.

Dieser Abschnitt enthält die folgenden Beispiele, in denen beschrieben wird, wie Sie die verschiedenen Inspektionsebenen verwenden können, die Folgendes Step Functions bieten: AWS CLI

Beispiel 1: Wird verwendet INFO inspectionLevel , um einen Choice-Status zu testen

Um einen Status mit dem INFO inspectionLevelin zu testen AWS CLI, führen Sie den test-state Befehl aus, wie im folgenden Beispiel gezeigt.

aws stepfunctions test-state \
    --definition '{"Type": "Choice", "Choices": [{"Variable": "$.number", "NumericEquals": 1, "Next": "Equals 1"}, {"Variable": "$.number", "NumericEquals": 2, "Next": "Equals 2"}], "Default": "No Match"}' \
    --role-arn arn:aws:iam::123456789012:role/myRole \
    --input '{"number": 2}'

In diesem Beispiel wird der Status Choice verwendet, um den Ausführungspfad für den Status anhand der von Ihnen angegebenen numerischen Eingabe zu bestimmen. Step FunctionsLegt standardmäßig inspectionLevel auf fest, INFO wenn Sie keine Stufe festlegen.

Step Functionsgibt die folgende Ausgabe zurück.

{
    "output": "{\"number\": 2}",
    "nextState": "Equals 2",
    "status": "SUCCEEDED"
}

Beispiel 2: Wird DEBUG inspectionLevel zum Debuggen der Eingabe- und Ausgabedatenverarbeitung im Status Pass verwendet

Um einen Status mit dem DEBUG inspectionLevelin zu testen AWS CLI, führen Sie den test-state Befehl wie im folgenden Beispiel gezeigt aus.

aws stepfunctions test-state \
    --definition '{"Type": "Pass", "InputPath": "$.payload", "Parameters": {"data": 1}, "ResultPath": "$.result", "OutputPath": "$.result.data", "Next": "Another State"}' \
    --role-arn arn:aws:iam::123456789012:role/myRole \
    --input '{"payload": {"foo": "bar"}}' \
    --inspection-level DEBUG

In diesem Beispiel wird anhand eines Workflow-Status übergeben Zustands veranschaulicht, wie JSON Eingabedaten mithilfe der Eingabe- und Step Functions Ausgabedatenverarbeitungsfilter gefiltert und bearbeitet werden. In diesem Beispiel werden die folgenden Filter verwendet:InputPath, ParameterZustandsausgabe mithilfe von Workflows ResultPath in Step Functions angeben, und. Filtern der Statusausgabe mithilfe von Workflows OutputPath in Step Functions

Step Functionsgibt die folgende Ausgabe zurück.

{
    "output": "1",
    "inspectionData": {
        "input": "{\"payload\": {\"foo\": \"bar\"}}",
        "afterInputPath": "{\"foo\":\"bar\"}",
        "afterParameters": "{\"data\":1}",
        "afterResultSelector": "{\"data\":1}",
        "afterResultPath": "{\"payload\":{\"foo\":\"bar\"},\"result\":{\"data\":1}}"
    },
    "nextState": "Another State",
    "status": "SUCCEEDED"
}

Beispiel 3: Verwendung von TRACE inspectionLevel und revealSecrets zur Überprüfung der an einen Drittanbieter gesendeten HTTP Anfrage API

Um eine HTTPAufgabe mit dem TRACE inspectionLevelzusammen mit dem revealSecretsParameter in zu testen AWS CLI, führen Sie den test-state Befehl aus, wie im folgenden Beispiel gezeigt.

aws stepfunctions test-state \
    --definition '{"Type": "Task", "Resource": "arn:aws:states:::http:invoke", "Parameters": {"Method": "GET", "Authentication": {"ConnectionArn": "arn:aws:events:us-east-1:123456789012:connection/MyConnection/0000000-0000-0000-0000-000000000000"}, "ApiEndpoint": "https://httpbin.org/get", "Headers": {"definitionHeader": "h1"}, "RequestBody": {"message": "Hello from Step Functions!"}, "QueryParameters": {"queryParam": "q1"}}, "End": true}' \
    --role-arn arn:aws:iam::123456789012:role/myRole \
    --inspection-level TRACE \
    --reveal-secrets

In diesem Beispiel wird getestet, ob der HTTP Task den angegebenen Drittanbieter aufruftAPI,https://httpbin.org/. Außerdem werden die HTTP Anforderungs- und Antwortdaten für den API Anruf angezeigt.

{
    "output": "{\"Headers\":{\"date\":[\"Tue, 21 Nov 2023 00:06:17 GMT\"],\"access-control-allow-origin\":[\"*\"],\"content-length\":[\"620\"],\"server\":[\"gunicorn/19.9.0\"],\"access-control-allow-credentials\":[\"true\"],\"content-type\":[\"application/json\"]},\"ResponseBody\":{\"args\":{\"QueryParam1\":\"QueryParamValue1\",\"queryParam\":\"q1\"},\"headers\":{\"Authorization\":\"Basic XXXXXXXX\",\"Content-Type\":\"application/json; charset=UTF-8\",\"Customheader1\":\"CustomHeaderValue1\",\"Definitionheader\":\"h1\",\"Host\":\"httpbin.org\",\"Range\":\"bytes=0-262144\",\"Transfer-Encoding\":\"chunked\",\"User-Agent\":\"Amazon|StepFunctions|HttpInvoke|us-east-1\",\"X-Amzn-Trace-Id\":\"Root=1-0000000-0000-0000-0000-000000000000\"},\"origin\":\"12.34.567.891\",\"url\":\"https://httpbin.org/get?queryParam=q1&QueryParam1=QueryParamValue1\"},\"StatusCode\":200,\"StatusText\":\"OK\"}",
    "inspectionData": {
        "input": "{}",
        "afterInputPath": "{}",
        "afterParameters": "{\"Method\":\"GET\",\"Authentication\":{\"ConnectionArn\":\"arn:aws:events:us-east-1:123456789012:connection/foo/a59c10f0-a315-4c1f-be6a-559b9a0c6250\"},\"ApiEndpoint\":\"https://httpbin.org/get\",\"Headers\":{\"definitionHeader\":\"h1\"},\"RequestBody\":{\"message\":\"Hello from Step Functions!\"},\"QueryParameters\":{\"queryParam\":\"q1\"}}",
        "result": "{\"Headers\":{\"date\":[\"Tue, 21 Nov 2023 00:06:17 GMT\"],\"access-control-allow-origin\":[\"*\"],\"content-length\":[\"620\"],\"server\":[\"gunicorn/19.9.0\"],\"access-control-allow-credentials\":[\"true\"],\"content-type\":[\"application/json\"]},\"ResponseBody\":{\"args\":{\"QueryParam1\":\"QueryParamValue1\",\"queryParam\":\"q1\"},\"headers\":{\"Authorization\":\"Basic XXXXXXXX\",\"Content-Type\":\"application/json; charset=UTF-8\",\"Customheader1\":\"CustomHeaderValue1\",\"Definitionheader\":\"h1\",\"Host\":\"httpbin.org\",\"Range\":\"bytes=0-262144\",\"Transfer-Encoding\":\"chunked\",\"User-Agent\":\"Amazon|StepFunctions|HttpInvoke|us-east-1\",\"X-Amzn-Trace-Id\":\"Root=1-0000000-0000-0000-0000-000000000000\"},\"origin\":\"12.34.567.891\",\"url\":\"https://httpbin.org/get?queryParam=q1&QueryParam1=QueryParamValue1\"},\"StatusCode\":200,\"StatusText\":\"OK\"}",
        "afterResultSelector": "{\"Headers\":{\"date\":[\"Tue, 21 Nov 2023 00:06:17 GMT\"],\"access-control-allow-origin\":[\"*\"],\"content-length\":[\"620\"],\"server\":[\"gunicorn/19.9.0\"],\"access-control-allow-credentials\":[\"true\"],\"content-type\":[\"application/json\"]},\"ResponseBody\":{\"args\":{\"QueryParam1\":\"QueryParamValue1\",\"queryParam\":\"q1\"},\"headers\":{\"Authorization\":\"Basic XXXXXXXX\",\"Content-Type\":\"application/json; charset=UTF-8\",\"Customheader1\":\"CustomHeaderValue1\",\"Definitionheader\":\"h1\",\"Host\":\"httpbin.org\",\"Range\":\"bytes=0-262144\",\"Transfer-Encoding\":\"chunked\",\"User-Agent\":\"Amazon|StepFunctions|HttpInvoke|us-east-1\",\"X-Amzn-Trace-Id\":\"Root=1-0000000-0000-0000-0000-000000000000\"},\"origin\":\"12.34.567.891\",\"url\":\"https://httpbin.org/get?queryParam=q1&QueryParam1=QueryParamValue1\"},\"StatusCode\":200,\"StatusText\":\"OK\"}",
        "afterResultPath": "{\"Headers\":{\"date\":[\"Tue, 21 Nov 2023 00:06:17 GMT\"],\"access-control-allow-origin\":[\"*\"],\"content-length\":[\"620\"],\"server\":[\"gunicorn/19.9.0\"],\"access-control-allow-credentials\":[\"true\"],\"content-type\":[\"application/json\"]},\"ResponseBody\":{\"args\":{\"QueryParam1\":\"QueryParamValue1\",\"queryParam\":\"q1\"},\"headers\":{\"Authorization\":\"Basic XXXXXXXX\",\"Content-Type\":\"application/json; charset=UTF-8\",\"Customheader1\":\"CustomHeaderValue1\",\"Definitionheader\":\"h1\",\"Host\":\"httpbin.org\",\"Range\":\"bytes=0-262144\",\"Transfer-Encoding\":\"chunked\",\"User-Agent\":\"Amazon|StepFunctions|HttpInvoke|us-east-1\",\"X-Amzn-Trace-Id\":\"Root=1-0000000-0000-0000-0000-000000000000\"},\"origin\":\"12.34.567.891\",\"url\":\"https://httpbin.org/get?queryParam=q1&QueryParam1=QueryParamValue1\"},\"StatusCode\":200,\"StatusText\":\"OK\"}",
        "request": {
            "protocol": "https",
            "method": "GET",
            "url": "https://httpbin.org/get?queryParam=q1&QueryParam1=QueryParamValue1",
            "headers": "[definitionHeader: h1, Authorization: Basic XXXXXXXX, CustomHeader1: CustomHeaderValue1, User-Agent: Amazon|StepFunctions|HttpInvoke|us-east-1, Range: bytes=0-262144]",
            "body": "{\"message\":\"Hello from Step Functions!\",\"BodyKey1\":\"BodyValue1\"}"
        },
        "response": {
            "protocol": "https",
            "statusCode": "200",
            "statusMessage": "OK",
            "headers": "[date: Tue, 21 Nov 2023 00:06:17 GMT, content-type: application/json, content-length: 620, server: gunicorn/19.9.0, access-control-allow-origin: *, access-control-allow-credentials: true]",
            "body": "{\n  \"args\": {\n    \"QueryParam1\": \"QueryParamValue1\", \n    \"queryParam\": \"q1\"\n  }, \n  \"headers\": {\n    \"Authorization\": \"Basic XXXXXXXX\", \n    \"Content-Type\": \"application/json; charset=UTF-8\", \n    \"Customheader1\": \"CustomHeaderValue1\", \n    \"Definitionheader\": \"h1\", \n    \"Host\": \"httpbin.org\", \n    \"Range\": \"bytes=0-262144\", \n    \"Transfer-Encoding\": \"chunked\", \n    \"User-Agent\": \"Amazon|StepFunctions|HttpInvoke|us-east-1\", \n    \"X-Amzn-Trace-Id\": \"Root=1-0000000-0000-0000-0000-000000000000\"\n  }, \n  \"origin\": \"12.34.567.891\", \n  \"url\": \"https://httpbin.org/get?queryParam=q1&QueryParam1=QueryParamValue1\"\n}\n"
        }
    },
    "status": "SUCCEEDED"
}

Beispiel 4: Verwenden des jq-Dienstprogramms zum Filtern und Drucken der Antwort, TestState API die zurückgesendet wird

Das TestState API gibt in seiner Antwort JSON Daten als Escape-Zeichenketten zurück. Das folgende AWS CLI Beispiel erweitert Beispiel 3 und verwendet das jq Hilfsprogramm, um die TestState API zurückgegebene HTTP Antwort in einem für Menschen lesbaren Format zu filtern und auszudrucken. Weitere Informationen jq und Installationsanweisungen finden Sie unter jq on. GitHub

aws stepfunctions test-state \
    --definition '{"Type": "Task", "Resource": "arn:aws:states:::http:invoke", "Parameters": {"Method": "GET", "Authentication": {"ConnectionArn": "arn:aws:events:us-east-1:123456789012:connection/MyConnection/0000000-0000-0000-0000-000000000000"}, "ApiEndpoint": "https://httpbin.org/get", "Headers": {"definitionHeader": "h1"}, "RequestBody": {"message": "Hello from Step Functions!"}, "QueryParameters": {"queryParam": "q1"}}, "End": true}' \
    --role-arn arn:aws:iam::123456789012:role/myRole \
    --inspection-level TRACE \
    --reveal-secrets \
    | jq '.inspectionData.response.body | fromjson'

Das folgende Beispiel zeigt die Ausgabe, die in einem für Menschen lesbaren Format zurückgegeben wird.

{
  "args": {
    "QueryParam1": "QueryParamValue1",
    "queryParam": "q1"
  },
  "headers": {
    "Authorization": "Basic XXXXXXXX",
    "Content-Type": "application/json; charset=UTF-8",
    "Customheader1": "CustomHeaderValue1",
    "Definitionheader": "h1",
    "Host": "httpbin.org",
    "Range": "bytes=0-262144",
    "Transfer-Encoding": "chunked",
    "User-Agent": "Amazon|StepFunctions|HttpInvoke|us-east-1",
    "X-Amzn-Trace-Id": "Root=1-0000000-0000-0000-0000-000000000000"
  },
  "origin": "12.34.567.891",
  "url": "https://httpbin.org/get?queryParam=q1&QueryParam1=QueryParamValue1"
}

Testen und Debuggen des Eingabe- und Ausgabedatenflusses

Das TestState API ist hilfreich beim Testen und Debuggen der Daten, die durch Ihren Workflow fließen. Dieser Abschnitt enthält einige wichtige Konzepte und erklärt, wie Sie den TestState für diesen Zweck verwenden können.

Die wichtigsten Konzepte

In Step Functions wird der Prozess des Filterns und Bearbeitens von JSON Daten beim Durchlaufen der Zustände in Ihrer Zustandsmaschine als Eingabe- und Ausgabeverarbeitung bezeichnet. Weitere Information zur Funktionsweise finden Sie unter Eingabe und Ausgabe in Step Functions verarbeiten.

Alle Zustandstypen in Amazon States Language (ASL) (Task, Parallel, Map, Pass, Wait, Choice, Succeed und Fail) haben gemeinsame Felder zum Filtern und Bearbeiten der JSON Daten, die sie durchlaufen, gemeinsam. Diese Felder sind: InputPathParameter, ResultSelectorZustandsausgabe mithilfe von Workflows ResultPath in Step Functions angeben, undFiltern der Statusausgabe mithilfe von Workflows OutputPath in Step Functions. Die Support für jedes Feld ist von Bundesstaat zu Bundesstaat unterschiedlich. Step FunctionsWendet zur Laufzeit jedes Feld in einer bestimmten Reihenfolge an. Das folgende Diagramm zeigt die Reihenfolge, in der diese Felder auf die Daten innerhalb eines Task-Status angewendet werden:

In der folgenden Liste wird die Reihenfolge beschrieben, in der die Eingabe- und Ausgabeverarbeitungsfelder im Diagramm angewendet werden.

Diese Eingabe- und Ausgabeverarbeitungsfelder sind optional. Wenn Sie keines dieser Felder in Ihrer Bundesstaatendefinition verwenden, verwendet die Aufgabe die unverarbeitete Statuseingabe und gibt das Aufgabenergebnis als Statusausgabe zurück.

Wird verwendet TestState , um die Eingabe- und Ausgabeverarbeitung zu überprüfen

Wenn Sie den aufrufen TestState API und den inspectionLevel Parameter auf setzenDEBUG, enthält die API Antwort ein aufgerufenes ObjektinspectionData. Dieses Objekt enthält Felder, anhand derer Sie überprüfen können, wie Daten innerhalb des Status gefiltert oder manipuliert wurden, als sie ausgeführt wurden. Das folgende Beispiel zeigt das inspectionData Objekt für einen Task-Status.

"inspectionData":   {
  "input": string, 
  "afterInputPath": string, 
  "afterParameters": string, 
  "result": string, 
  "afterResultSelector": string, 
  "afterResultPath": string,
  "output": string 
}

In diesem Beispiel zeigt jedes Feld, das das after Präfix enthält, die Daten an, nachdem ein bestimmtes Feld angewendet wurde. afterInputPathZeigt beispielsweise, wie sich das Anwenden des InputPath Felds auf das Filtern der Rohstatuseingabe auswirkt. Das folgende Diagramm ordnet jedes ASLDefinitionsfeld dem entsprechenden Feld im inspectionData Objekt zu:

Beispiele für die Verwendung von TestState API zum Debuggen der Eingabe- und Ausgabeverarbeitung finden Sie im Folgenden: