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.

# Übergeben von Parametern an eine Service-API in Step Functions
<a name="connect-parameters"></a>

**Status verwalten und Daten transformieren**  
Erfahren Sie mehr über das [Übergeben von Daten zwischen Zuständen mithilfe von Variablen](workflow-variables.md) und das [Transformieren von Daten mit JSONata](transforming-data.md).

Über das `Parameters`-Feld in einem `Task`-Status können Sie steuern, welche Parameter an eine Service-API übergeben werden.

Innerhalb des `Parameters` Felds müssen Sie die Pluralform der Array-Parameter in einer API-Aktion verwenden. Wenn Sie beispielsweise das Feld [Filter](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeSnapshots.html#API_DescribeSnapshots_RequestParameters) der `DescribeSnapshots` API-Aktion für die Integration mit Amazon verwenden EC2, müssen Sie das Feld als definieren`Filters`. Wenn Sie die Pluralform nicht verwenden, gibt Step Functions den folgenden Fehler zurück:

```
The field Filter is not supported by Step Functions.
```

## Übergeben Sie statisches JSON als Parameter
<a name="connect-parameters-json"></a>

Sie können ein JSON-Objekt direkt in die Definition Ihres Zustandsautomaten einschließen, um es als Parameter an eine Ressource zu übergeben.

Um beispielsweise den `RetryStrategy` Parameter für die `SubmitJob` API festzulegen AWS Batch, könnten Sie Folgendes in Ihre Parameter aufnehmen.

```
"RetryStrategy": {
  "attempts": 5
}
```

Sie können auch mehrere Parameter mit statischem JSON übergeben. Als vollständigeres Beispiel werden im Folgenden die `Parameters` Felder `Resource` und der Spezifikation einer Aufgabe aufgeführt, die zu einem Amazon SNS SNS-Thema veröffentlicht. `myTopic`

```
"Resource": "arn:aws:states:::sns:publish",
  "Parameters": {
     "TopicArn": "arn:aws:sns:us-east-2:account-id:myTopic",
     "Message": "test message",
     "MessageAttributes": {
       "my attribute no 1": {
         "DataType": "String",
         "StringValue": "value of my attribute no 1"
       },
       "my attribute no 2": {
         "DataType": "String",
         "StringValue": "value of my attribute no 2"
       }
     }
  },
```

## Übergeben Sie Statuseingaben mithilfe von Paths als Parameter
<a name="connect-parameters-path"></a>

Mithilfe von [Pfaden](amazon-states-language-paths.md) können Sie Teile der Statuseingabe als Parameter übergeben. Ein Pfad ist eine Zeichenfolge, die mit beginnt und verwendet wird`$`, um Komponenten innerhalb von JSON-Text zu identifizieren. Step Functions Functions-Pfade verwenden [JsonPath](https://datatracker.ietf.org/wg/jsonpath/about/)Syntax.

Um anzugeben, dass ein Parameter einen Pfad verwendet, beenden Sie den Parameternamen mit`.$`. Wenn Ihre Statuseingabe beispielsweise Text innerhalb eines Knotens mit dem Namen enthält`message`, können Sie diesen Text mithilfe eines Pfads als Parameter übergeben.

Stellen Sie sich die folgende Statuseingabe vor:

```
{
  "comment": "A message in the state input",
  "input": {
    "message": "foo",
    "otherInfo": "bar"
  },
  "data": "example"
}
```

Um den Wert des Knotens `message` als Parameter mit dem Namen zu übergeben`myMessage`, geben Sie die folgende Syntax an:

```
"Parameters": {"myMessage.$": "$.input.message"},
```

Step Functions übergibt den Wert dann `foo` als Parameter.

Weitere Informationen zur Verwendung von Parametern in Step Functions finden Sie im Folgenden:
+ [Eingabe und Ausgabe verarbeiten](concepts-input-output-filtering.md)
+ [Parameter in Step Functions Functions-Workflows manipulieren](input-output-inputpath-params.md)

## Übergeben Sie Context-Objektknoten als Parameter
<a name="connect-parameters-context"></a>

Neben statischen Inhalten und Knoten aus der Statuseingabe können Sie auch Knoten aus dem Context-Objekt als Parameter übergeben. Das Context-Objekt besteht aus dynamischen JSON-Daten, die während der Ausführung einer Zustandsmaschine vorhanden sind. Es enthält unter anderem Informationen über Ihren Zustandsautomaten und die aktuelle Ausführung. Sie können über einen Pfad im `Parameters` Feld einer Statusdefinition auf das Context-Objekt zugreifen.



Weitere Informationen zum Context-Objekt und zum Zugriff auf diese Daten von einem `"Parameters"` Feld aus finden Sie im Folgenden:
+ [Zugreifen auf Ausführungsdaten aus dem Context-Objekt in Step Functions](input-output-contextobject.md)
+ [Zugreifen auf das Context-Objekt](input-output-contextobject.md#contextobject-access)
+ [Ruft ein Token aus dem Context-Objekt ab](connect-to-resource.md#wait-token-contextobject)