Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Meneruskan parameter ke API layanan di Step Functions
<a name="connect-parameters"></a>

**Mengelola status dan mengubah data**  
Pelajari tentang [Melewati data antar status dengan variabel](workflow-variables.md) dan [Mengubah data dengan JSONata](transforming-data.md).

Gunakan bidang `Parameters` di status `Task` untuk mengontrol parameter yang diteruskan ke layanan API.

Di dalam `Parameters` bidang, Anda harus menggunakan bentuk jamak dari parameter array dalam tindakan API. Misalnya, jika Anda menggunakan bidang [Filter](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeSnapshots.html#API_DescribeSnapshots_RequestParameters) dari tindakan `DescribeSnapshots` API untuk mengintegrasikan dengan Amazon EC2, Anda harus mendefinisikan bidang sebagai`Filters`. Jika Anda tidak menggunakan bentuk jamak, Step Functions mengembalikan kesalahan berikut:

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

## Lulus JSON statis sebagai parameter
<a name="connect-parameters-json"></a>

Anda dapat menyertakan objek JSON langsung dalam ketetapan mesin status Anda untuk melewatkan sebagai parameter ke sumber daya.

Misalnya, untuk menyetel `RetryStrategy` parameter `SubmitJob` API AWS Batch, Anda dapat menyertakan yang berikut ini dalam parameter Anda.

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

Anda juga dapat meneruskan beberapa parameter dengan JSON statis. Sebagai contoh yang lebih lengkap, berikut ini adalah `Resource` dan `Parameters` bidang spesifikasi tugas yang diterbitkan ke topik Amazon SNS bernama. `{{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"
       }
     }
  },
```

## Lulus input status sebagai parameter menggunakan Paths
<a name="connect-parameters-path"></a>

Anda dapat meneruskan bagian dari input status sebagai parameter dengan menggunakan [jalur](amazon-states-language-paths.md). Jalur adalah string, diawali dengan `$`, yang digunakan untuk mengidentifikasi komponen dalam teks JSON. Jalur Step Functions menggunakan [JsonPath](https://datatracker.ietf.org/wg/jsonpath/about/)sintaks.

Untuk menentukan bahwa parameter menggunakan jalur, akhiri nama parameter dengan`.$`. Misalnya, jika input status Anda berisi teks dalam node bernama`message`, Anda dapat meneruskan teks itu sebagai parameter menggunakan jalur.

Pertimbangkan masukan status berikut:

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

Untuk meneruskan nilai node bernama `message` sebagai parameter bernama`myMessage`, tentukan sintaks berikut:

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

Step Functions kemudian melewati nilai `foo` sebagai parameter.

Untuk informasi selengkapnya tentang cara menggunakan parameter dalam Step Functions, lihat hal-hal berikut ini:
+ [Memproses input dan output](concepts-input-output-filtering.md)
+ [Memanipulasi parameter dalam alur kerja Step Functions](input-output-inputpath-params.md)

## Lewati node objek Konteks sebagai parameter
<a name="connect-parameters-context"></a>

Selain konten statis, dan node dari input status, Anda dapat meneruskan node dari objek Context sebagai parameter. Objek Context adalah data JSON dinamis yang ada selama eksekusi mesin negara. Ini mencakup informasi tentang mesin status Anda dan eksekusi saat ini. Anda dapat mengakses objek Context menggunakan jalur di `Parameters` bidang definisi status.



Untuk informasi selengkapnya tentang objek Context dan cara mengakses data tersebut dari `"Parameters"` bidang, lihat berikut ini:
+ [Mengakses data eksekusi dari objek Context di Step Functions](input-output-contextobject.md)
+ [Mengakses objek Context](input-output-contextobject.md#contextobject-access)
+ [Dapatkan Token dari objek Context](connect-to-resource.md#wait-token-contextobject)