Meneruskan parameter ke API layanan

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 tindakan DescribeSnapshots API untuk mengintegrasikan dengan Amazon EC2, Anda harus menentukan bidang sebagai. Filters Jika Anda tidak menggunakan bentuk jamak, Step Functions mengembalikan galat berikut:

The field Filter is not supported by Step Functions.

Lulus JSON statis sebagai parameter

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

Misalnya, untuk mengatur parameter RetryStrategy untuk API SubmitJob untuk AWS Batch, Anda dapat menyertakan hal-hal berikut 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 menerbitkan ke topik Amazon SNS bernama. myTopic

"Resource": "arn:aws:states:::sns:publish",
  "Parameters": {
     "TopicArn": "arn:aws:sns:us-east-2:123456789012: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 masukan status sebagai parameter menggunakan Jalur

Anda dapat melewati bagian dari masukan negara sebagai parameter dengan menggunakan jalur. Jalur adalah string, diawali dengan $, yang digunakan untuk mengidentifikasi komponen dalam teks JSON. Langkah Fungsi jalan menggunakan JsonPathsintaks.

Untuk menentukan bahwa parameter menggunakan jalur, akhiri nama parameter dengan.$. Misalnya, jika input state Anda berisi teks dalam node bernamamessage, Anda bisa meneruskan teks itu sebagai parameter menggunakan path.

Pertimbangkan masukan negara berikut:

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

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

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

Langkah Fungsi kemudian melewati nilai foo sebagai parameter.

Untuk informasi selengkapnya tentang cara menggunakan parameter dalam Step Functions, lihat hal-hal berikut ini:

• Pengolahan Input dan Output

• InputPath, Parameter dan ResultSelector

Meneruskan Simpul Objek Konteks sebagai Parameter

Selain konten statis, dan simpul dari input status, Anda dapat meneruskan simpul dari objek konteks sebagai parameter. Objek konteks adalah data JSON dinamis yang ada selama eksekusi mesin status. Ini mencakup informasi tentang mesin status Anda dan eksekusi saat ini. Anda dapat mengakses objek konteks menggunakan jalur di kolom "Parameters" ketetapan status.

Untuk informasi selengkapnya tentang objek konteks dan cara mengakses data tersebut kolom "Parameters", lihat hal-hal berikut ini:

• Objek konteks

• Mengakses Obyek Konteks

• Dapatkan Token dari Object Konteks