Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Step Functions lässt sich in seine eigene API als Serviceintegration integrieren. Erfahren Sie, wie Sie Step Functions verwenden, um eine neue Ausführung einer Zustandsmaschine direkt aus dem Aufgabenstatus einer laufenden Ausführung heraus zu starten. Verwenden Sie beim Erstellen neuer Workflows verschachtelte Workflow-Ausführungen, um die Komplexität Ihrer Haupt-Workflows zu reduzieren und gängige Prozesse wiederzuverwenden.
Hauptmerkmale der Integration von Optimized Step Functions
Das Ausführen einer Aufgabe (.sync) Integrationsmuster ist verfügbar.
Beachten Sie, dass es keine Optimierungen für die Request Response (Antwort anfordern) Warten Sie auf einen Rückruf mit Task Token Integrationsmuster gibt.
Weitere Informationen finden Sie hier:
Optimierte Step Functions APIs
-
-
Unterstützte Parameter
Workflow-Beispiele
Das folgende Beispiel enthält einen Task-Status, der die Ausführung eines anderen Zustandsautomaten startet und wartet, bis sie abgeschlossen ist.
{
"Type":"Task",
"Resource":"arn:aws:states:::states:startExecution.sync:2",
"Parameters":{
"Input":{
"Comment": "Hello world!"
},
"StateMachineArn":"arn:aws:states:us-east-1:123456789012:stateMachine:HelloWorld",
"Name":"ExecutionName"
},
"End":true
}Das folgende Beispiel enthält einen Task-Status, der die Ausführung eines anderen Zustandsautomaten startet.
{
"Type":"Task",
"Resource":"arn:aws:states:::states:startExecution",
"Parameters":{
"Input":{
"Comment": "Hello world!"
},
"StateMachineArn":"arn:aws:states:us-east-1:123456789012:stateMachine:HelloWorld",
"Name":"ExecutionName"
},
"End":true
}Das Folgende enthält einen Task-Zustand zur Implementierung des Callback- Service-Integrationsmusters.
{
"Type":"Task",
"Resource":"arn:aws:states:::states:startExecution.waitForTaskToken",
"Parameters":{
"Input":{
"Comment": "Hello world!",
"token.$": "$$.Task.Token"
},
"StateMachineArn":"arn:aws:states:us-east-1:123456789012:stateMachine:HelloWorld",
"Name":"ExecutionName"
},
"End":true
}
Um eine verschachtelte Workflow-Ausführung der übergeordneten Ausführung zuzuordnen, mit der sie gestartet wurde, übergeben Sie einen speziell benannten Parameter, der die Ausführungs-ID enthält, die aus dem Context-Objekt abgerufen wurde. Wenn Sie eine verschachtelte Ausführung starten, verwenden Sie einen Parameter namens AWS_STEP_FUNCTIONS_STARTED_BY_EXECUTION_ID. Übergeben Sie die Ausführungs-ID, indem Sie .$ sie an den Parameternamen anhängen und mit auf die ID im Context-Objekt verweisen. $$.Execution.Id Weitere Informationen finden Sie unter Zugreifen auf das Context-Objekt.
{
"Type":"Task",
"Resource":"arn:aws:states:::states:startExecution.sync",
"Parameters":{
"Input":{
"Comment": "Hello world!",
"AWS_STEP_FUNCTIONS_STARTED_BY_EXECUTION_ID.$": "$$.Execution.Id"
},
"StateMachineArn":"arn:aws:states:us-east-1:123456789012:stateMachine:HelloWorld",
"Name":"ExecutionName"
},
"End":true
}Verschachtelte Zustandsautomaten geben Folgendes zurück:
| Ressource | Output |
|---|---|
| Startexecution.sync | String |
| Startexecution.sync:2 | JSON |
Beide warten, bis der verschachtelte Zustandsautomat fertig ist, aber sie geben verschiedene Output-Formate zurück. Wenn Sie beispielsweise eine Lambda-Funktion erstellen, die das Objekt zurückgibt{ "MyKey": "MyValue" }, würden Sie die folgenden Antworten erhalten:
Für startExecution.sync:
{
<other fields>
"Output": "{ \"MyKey\": \"MyValue\" }"
}Für startExecution.sync:2:
{
<other fields>
"Output": {
"MyKey": "MyValue"
}
}Konfiguration von IAM-Berechtigungen für verschachtelte Zustandsmaschinen
Ein übergeordneter Zustandsmaschine bestimmt anhand von Abfragen und Ereignissen, ob ein untergeordneter Zustandsmaschine die Ausführung abgeschlossen hat. Für Abfragen ist eine Genehmigung erforderlich, states:DescribeExecution während für Ereignisse, die EventBridge an Step Functions gesendet werden, Berechtigungen für events:PutTargetsevents:PutRule, und events:DescribeRule erforderlich sind. Wenn diese Berechtigungen in Ihrer IAM-Rolle fehlen, kann es zu einer Verzögerung kommen, bis ein übergeordneter Zustandsmaschine erfährt, dass die Ausführung des untergeordneten Zustandsmaschinen abgeschlossen ist.
Verwenden Sie für einen Zustandsmaschine, der die Ausführung eines einzelnen verschachtelten Workflows erfordertStartExecution, eine IAM-Richtlinie, die die Berechtigungen auf diesen Zustandsmaschine beschränkt.
IAM-Richtlinien für den Aufruf verschachtelter Step Functions Functions-Workflows
Verwenden Sie für eine Zustandsmaschine, die die Ausführung eines einzelnen verschachtelten Workflows erfordertStartExecution, eine IAM-Richtlinie, die die Berechtigungen auf diese Zustandsmaschine beschränkt.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"states:StartExecution"
],
"Resource": [
"arn:aws:states:[[region]]:[[accountId]]:stateMachine:[[stateMachineName]]"
]
}
]
}Weitere Informationen finden Sie hier:
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"states:StartExecution"
],
"Resource": [
"arn:aws:states:[[region]]:[[accountId]]:stateMachine:[[stateMachineName]]"
]
},
{
"Effect": "Allow",
"Action": [
"states:DescribeExecution",
"states:StopExecution"
],
"Resource": [
"arn:aws:states:[[region]]:[[accountId]]:execution:[[stateMachineName]]:*"
]
},
{
"Effect": "Allow",
"Action": [
"events:PutTargets",
"events:PutRule",
"events:DescribeRule"
],
"Resource": [
"arn:aws:events:[[region]]:[[accountId]]:rule/StepFunctionsGetEventsForStepFunctionsExecutionRule"
]
}
]
}Erforderliche ARN-Typen
Beachten Sie in der Richtlinie für Synchronous, dass ein State-Machine-ARN states:StartExecution erforderlich ist, wohingegen states:DescribeExecution und ein Ausführungs-ARN states:StopExecution erforderlich ist.
Wenn Sie irrtümlicherweise alle drei Aktionen kombinieren, ist der JSON-Code gültig, die IAM-Richtlinie jedoch falsch. Eine falsche Richtlinie kann zu festgefahrenen Workflows und/oder Zugriffsproblemen während der Workflow-Ausführung führen.
Weitere Informationen zu verschachtelten Workflow-Ausführungen finden Sie unter Starten Sie Workflow-Ausführungen von einem Aufgabenstatus aus in Step Functions.
