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

Menguji mesin status dengan TestState API

Gambaran umum

Anda dapat menguji status yang didukung menggunakan TestState fitur di Step Functions konsolAWSCommand Line Interface (AWS CLI), atau SDK.

TestStateAPI menerima definisi status dan menjalankannya. Ini memungkinkan Anda untuk menguji status tanpa membuat mesin negara atau memperbarui mesin status yang ada. Anda dapat memberikan:

TestStateAPI mengasumsikan IAM peran yang harus berisi IAM izin yang diperlukan untuk sumber daya yang diakses status Anda. Saat Anda menentukan tiruan, menentukan peran menjadi opsional, memungkinkan Anda menguji logika mesin status tanpa mengonfigurasi IAM izin. Untuk informasi tentang izin yang mungkin diperlukan oleh negara bagian, lihatIAMizin untuk menggunakan API TestState .

Topik

Menggunakan level inspeksi di TestState API

Saat menguji status menggunakan TestStateAPI, Anda dapat menentukan jumlah detail yang ingin Anda lihat di hasil pengujian. Misalnya, jika Anda telah menggunakan filter pemrosesan data input dan output seperti InputPathatau ResultPath, Anda dapat melihat hasil pemrosesan data menengah dan akhir. Step Functionsmenyediakan tingkat inspeksi berikut:

Semua level ini juga mengembalikan status dan nextState bidang. statusmenunjukkan status eksekusi negara. Misalnya,, SUCCEEDEDFAILED,RETRIABLE, danCAUGHT_ERROR. nextStatemenunjukkan nama negara bagian berikutnya untuk transisi ke. Jika Anda belum menentukan status berikutnya dalam definisi Anda, bidang ini mengembalikan nilai kosong.

Untuk informasi tentang pengujian status menggunakan tingkat inspeksi ini di Step Functions konsol danAWS CLI, lihat Menguji status menggunakan konsol AWS Step Functions danMenguji status menggunakan AWS CLI.

INFO InspectionLevel

Jika tes berhasil, level ini menunjukkan output status. Jika tes gagal, level ini menunjukkan output kesalahan. Secara default, Step Functions tetapkan level Inspeksi ke INFO jika Anda tidak menentukan level.

DEBUG Inspeksi Level

Jika tes berhasil, level ini menunjukkan output status dan hasil pemrosesan data input dan output.

Jika tes gagal, level ini menunjukkan output kesalahan. Tingkat ini menunjukkan hasil pemrosesan data menengah hingga titik kegagalan. Misalnya, katakan bahwa Anda menguji status Tugas yang memanggil Lambda fungsi. Bayangkan Anda telah menerapkanInputPath,Parameter,Menentukan output status menggunakan Step ResultPath Functions, dan Memfilter output status menggunakan OutputPath filter ke status Tugas. Katakan bahwa doa gagal. Dalam hal ini, DEBUG level menunjukkan hasil pemrosesan data berdasarkan penerapan filter dalam urutan sebagai berikut:

Informasi diagnostik yang tersedia di level ini dapat membantu Anda memecahkan masalah yang terkait dengan integrasi layanan atau aliran pemrosesan data input dan output yang mungkin telah Anda tentukan.

TRACE Inspection Level

Step Functionsmenyediakan tingkat TRACE untuk menguji Tugas HTTP. Level ini mengembalikan informasi tentang permintaan HTTP yang Step Functions membuat dan merespons yang dikembalikan oleh HTTPS API. Respons mungkin berisi informasi, seperti header dan badan permintaan. Selain itu, Anda dapat melihat output status dan hasil pemrosesan data input dan output di level ini.

Jika tes gagal, level ini menunjukkan output kesalahan.

Level ini hanya berlaku untuk HTTP Task. Step Functionsmelempar kesalahan jika Anda menggunakan level ini untuk tipe status lainnya.

Saat Anda mengatur level Inspeksi ke TRACE, Anda juga dapat melihat rahasia yang disertakan dalam EventBridge koneksi. Untuk melakukan ini, Anda harus mengatur revealSecrets parameter ke true dalam TestStateAPI. Selain itu, Anda harus memastikan bahwa IAM pengguna yang memanggil TestState API memiliki izin untuk states:RevealSecrets tindakan tersebut. Untuk contoh IAM kebijakan yang menetapkan states:RevealSecrets izin, lihatIAMizin untuk menggunakan API TestState . Tanpa izin ini, Step Functions melempar kesalahan akses ditolak.

Jika Anda mengatur revealSecrets parameter kefalse, Step Functions menghilangkan semua rahasia dalam permintaan HTTP dan data respons. Perhatikan bahwa Anda tidak dapat menggunakan revealSecrets saat mengejek diaktifkan. Jika Anda menentukan keduanya revealSecrets dan tiruan dalam permintaan TestState API, Step Functions mengembalikan pengecualian validasi.

IAMizin untuk menggunakan API TestState

IAMPengguna yang memanggil TestState API harus memiliki izin untuk melakukan states:TestState tindakan. Saat Anda tidak menggunakan ejekan, IAM pengguna juga harus memiliki izin untuk melakukan iam:PassRole tindakan untuk meneruskan peran eksekusi. Step Functions Selain itu, jika Anda mengatur revealSecrets parameter ketrue, IAM pengguna harus memiliki izin untuk melakukan states:RevealSecrets tindakan. Tanpa izin ini, Step Functions melempar kesalahan akses ditolak.

Perhatikan bahwa saat Anda menentukan tiruan dalam permintaan TestState API, Anda dapat menguji logika mesin status tanpa memberikan peran eksekusi (lihat detail selengkapnya di bawah Integrasi layanan Mocking). Bila Anda tidak menggunakan tiruan, Anda harus memberikan peran eksekusi yang berisi izin yang diperlukan untuk sumber daya yang diakses negara Anda. Untuk informasi tentang izin yang mungkin diperlukan oleh negara bagian Anda, lihat Mengelola peran eksekusi.

Menguji status menggunakan konsol AWS Step Functions

Anda dapat menguji status di konsol dan memeriksa output status atau aliran pemrosesan data input dan output. Untuk Tugas HTTP, Anda dapat menguji permintaan dan respons HTTP mentah.

Menguji status menggunakan AWS CLI

Anda dapat menguji status menggunakan TestStateAPI di fileAWS CLI. API ini menerima definisi status dan menjalankannya.

Untuk setiap status, Anda dapat menentukan jumlah detail yang ingin Anda lihat dalam hasil tes. Rincian ini memberikan informasi tambahan tentang eksekusi negara, termasuk input dan output hasil pengolahan data dan permintaan HTTP dan informasi respon. Contoh berikut menampilkan berbagai level inspeksi yang dapat Anda tentukan untuk TestState API.

Bagian ini berisi contoh-contoh berikut yang menjelaskan bagaimana Anda dapat menggunakan berbagai tingkat inspeksi yang Step Functions disediakan dalamAWS CLI:

Contoh 1: Menggunakan INFO InspectionLevel untuk menguji status Choice

Untuk menguji status menggunakan INFO InspectionLevel diAWS CLI, jalankan test-state perintah seperti yang ditunjukkan pada contoh berikut.

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::account-id:role/myRole \
    --input '{"number": 2}'

Contoh ini menggunakan status Pilihan untuk menentukan jalur eksekusi untuk status berdasarkan input numerik yang Anda berikan. Secara default, Step Functions atur inspectionLevel ke INFO jika Anda tidak menetapkan level.

Step Functionsmengembalikan output berikut.

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

Contoh 2: Menggunakan DEBUG InspectionLevel untuk men-debug pemrosesan data input dan output dalam status Pass

Untuk menguji status menggunakan DEBUG InspectionLevel diAWS CLI, jalankan test-state perintah seperti yang ditunjukkan pada contoh berikut.

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::account-id:role/myRole \
    --input '{"payload": {"foo": "bar"}}' \
    --inspection-level DEBUG

Contoh ini menggunakan Lulus status alur kerja status untuk menampilkan bagaimana Step Functions filter dan memanipulasi input data JSON menggunakan input dan output filter pengolahan data. Contoh ini menggunakan filter ini:InputPath,Parameter,Menentukan output status menggunakan Step ResultPath Functions, danMemfilter output status menggunakan OutputPath.

Step Functionsmengembalikan output berikut.

{
    "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"
}

Contoh 3: Menggunakan TRACE InspectionLevel dan RevealSecrets untuk memeriksa permintaan HTTP yang dikirim ke HTTPS API

Untuk menguji Tugas HTTP menggunakan TRACE InspectionLevel bersama dengan parameter RevealSecrets diAWS CLI, jalankan test-state perintah seperti yang ditunjukkan pada contoh berikut.

aws stepfunctions test-state \
    --definition '{"Type": "Task", "Resource": "arn:aws:states:::http:invoke", "Parameters": {"Method": "GET", "Authentication": {"ConnectionArn": "arn:aws:events:region:account-id: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::account-id:role/myRole \
    --inspection-level TRACE \
    --reveal-secrets

Contoh ini menguji apakah Tugas HTTP memanggil HTTPS API yang ditentukan,https://httpbin.org/. Ini juga menunjukkan permintaan HTTP dan data respons untuk panggilan API.

Step Functionsmengembalikan output mirip dengan contoh asli dalam dokumentasi saat ini.

Contoh 4: Menggunakan utilitas jq untuk memfilter dan mencetak respons yang dikembalikan TestState API

TestState API mengembalikan data JSON sebagai string yang lolos dalam responsnya. AWS CLIContoh berikut memperluas Contoh 3 dan menggunakan jq utilitas untuk memfilter dan mencetak respons HTTP yang dikembalikan TestState API dalam format yang dapat dibaca manusia. Untuk informasi tentang jq dan petunjuk pemasangannya, lihat jq on GitHub.

aws stepfunctions test-state \
    --definition '{"Type": "Task", "Resource": "arn:aws:states:::http:invoke", "Parameters": {"Method": "GET", "Authentication": {"ConnectionArn": "arn:aws:events:region:account-id: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::account-id:role/myRole \
    --inspection-level TRACE \
    --reveal-secrets \
    | jq '.inspectionData.response.body | fromjson'

Contoh berikut menunjukkan output yang dikembalikan dalam format yang dapat dibaca manusia.

{
  "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|region",
    "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"
}

Menguji dan men-debug aliran data input dan output

TestStateAPI berguna untuk menguji dan men-debug data yang mengalir melalui alur kerja Anda. Bagian ini memberikan beberapa konsep kunci dan menjelaskan cara menggunakan TestState untuk tujuan ini.

Konsep utama

DalamStep Functions, proses penyaringan dan manipulasi data JSON saat melewati status di mesin negara Anda disebut pemrosesan input dan output. Untuk informasi tentang cara kerjanya, lihatMemproses input dan output di Step Functions.

Semua jenis status dalam Amazon States Language (ASL) (Tugas, Paralel, Peta, Lulus, Tunggu, Pilihan, Sukses, dan Gagal) berbagi satu set bidang umum untuk memfilter dan memanipulasi data JSON yang melewatinya. Bidang-bidang ini adalah: InputPathParameter,ResultSelector,,Menentukan output status menggunakan Step ResultPath Functions, danMemfilter output status menggunakan OutputPath. Support untuk setiap bidang bervariasi di seluruh negara bagian. Saat runtime, Step Functions terapkan setiap bidang dalam urutan tertentu. Diagram berikut menunjukkan urutan di mana bidang ini diterapkan ke data di dalam status Tugas:

Daftar berikut menjelaskan urutan penerapan bidang pemrosesan input dan output yang ditunjukkan pada diagram.

Bidang pemrosesan input dan output ini bersifat opsional. Jika Anda tidak menggunakan salah satu bidang ini dalam definisi status Anda, tugas akan menggunakan input status mentah, dan mengembalikan hasil tugas sebagai output status.

Menggunakan TestState untuk memeriksa pemrosesan input dan output

Saat Anda memanggil TestState API dan menyetel inspectionLevel parameternyaDEBUG, respons API menyertakan objek yang dipanggilinspectionData. Objek ini berisi bidang untuk membantu Anda memeriksa bagaimana data disaring atau dimanipulasi dalam status saat dijalankan. Contoh berikut menunjukkan inspectionData objek untuk status Tugas.

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

Dalam contoh ini, setiap bidang yang berisi after awalan, menunjukkan data setelah bidang tertentu diterapkan. Misalnya, afterInputPath menunjukkan efek penerapan InputPath bidang untuk memfilter input status mentah. Diagram berikut memetakan setiap bidang definisi ASL ke bidang yang sesuai dalam inspectionData objek:

Untuk contoh penggunaan TestState API untuk men-debug pemrosesan input dan output, lihat berikut ini:

Untuk status Peta secara khusus, saat inspectionLevel disetel keDEBUG, inspectionData objek menyertakan bidang tambahan yang membantu Anda memeriksa bagaimana status Peta mengekstrak dan mengubah item. Anda dapat mempelajari lebih lanjut bidang ini di bawah Memahami bagian data pemeriksaan status Peta.

Memahami data pemeriksaan keadaan Peta

Saat Anda menguji status Peta dengan inspectionLevel disetel keDEBUG, respons TestState API menyertakan bidang tambahan dalam inspectionData objek yang menunjukkan cara status Peta memproses data:

Bidang ini memungkinkan Anda memvalidasi bahwa transformasi data status Peta dan konfigurasi toleransi kegagalan berfungsi dengan benar sebelum penerapan.

Apa yang dapat Anda uji dan tegaskan dengan API TestState

TestState API memungkinkan Anda untuk menulis pengujian unit komprehensif untuk mesin status Anda. Anda dapat menegaskan beberapa aspek logika mesin status Anda, termasuk yang berikut ini:

Penanganan kesalahan: Tangkap atau Coba Ulang mana yang berlaku

Saat Anda mengolok-olok kesalahan, Anda dapat menggunakan TestState API untuk melihat penangan kesalahan mana yang diaktifkan.

Untuk blok Catch, Anda dapat menegaskan:

Untuk blok Coba lagi, Anda dapat menegaskan:

Transformasi data: Pemrosesan input dan output

Menggunakan TestState API, Anda dapat memvalidasi bagaimana data status Anda diubah pada setiap tahap pemrosesan.

Anda dapat menegaskan:

Transformasi status peta: ItemSelector,, ItemsPath, ItemBatcher ItemsPointer

Untuk status Peta, Anda dapat menggunakan TestState API untuk melihat bagaimana item diekstraksi dan diubah.

Anda dapat menegaskan:

Memetakan ambang kegagalan status: Status Pengujian. ExceedToleratedFailureThreshold

Uji apakah sejumlah iterasi gagal tertentu memicu ambang kegagalan yang ditoleransi.

Anda dapat menegaskan:

Propagasi kesalahan di Peta dan status Paralel

Saat menguji status dalam status Peta atau Paralel, kesalahan menyebar ke penangan kesalahan status induk seperti yang terjadi dalam eksekusi nyata.

Menentukan sumber kesalahan dengan State errorCausedBy

Saat mengejek kesalahan untuk status Peta atau Paralel, Anda harus menentukan sub-status mana yang menyebabkan kesalahan menggunakan parameter. stateConfiguration.errorCausedByState Ini sangat penting saat menguji kesalahan wildcard sepertiStates.TaskFailed. States.TaskFailedadalah kesalahan wildcard yang berlaku untuk kegagalan status Tugas apa pun. Untuk menguji bagaimana Peta atau status Paralel menangani kesalahan ini, Anda perlu mengidentifikasi sub-status tertentu yang melemparkannya. Lihat contoh di bawah ini:

aws stepfunctions test-state \
  --definition '{...Map or Parallel state definition...}' \
  --input '[...]' \
  --state-configuration '{"errorCausedByState": "ProcessItem"}' \
  --mock '{"errorOutput": {"error": "States.TaskFailed", "cause": "Task execution failed"}}'

Dalam contoh ini, errorCausedByState katakan TestState bahwa status ProcessItem "" dalam Map/Parallel alur kerja menimbulkan kesalahan. Penangan Catch atau Retry Map/Parallel state induk akan memproses kesalahan seperti yang terjadi selama eksekusi aktual. nextStateBidang dalam respons menunjukkan penangan kesalahan mana yang menangkap kesalahan. Anda dapat menegaskan:

Integrasi layanan mengejek

TestState API mendukung mengejek hasil integrasi layanan, memungkinkan Anda untuk menguji logika mesin status Anda tanpa memanggil layanan yang sebenarnya. AWS

Kapan harus menggunakan ejekan

Mengejek berguna untuk:

Saat Anda menentukan tiruan, roleArn parameter menjadi opsional, memungkinkan Anda untuk fokus pada pengujian definisi mesin status Anda tanpa berurusan dengan masalah terkait izin.

Sintaks mengejek dasar

Untuk mengejek hasil integrasi layanan:

aws stepfunctions test-state \
  --definition '{
    "Type": "Task",
    "Resource": "arn:aws:states:::lambda:invoke",
    "Arguments": {
      "FunctionName": "MyFunction",
      "Payload.$": "$"
    },
    "End": true
  }' \
  --input '{"key": "value"}' \
  --mock '{"result": "{\"Payload\": {\"statusCode\": 200, \"body\": \"Success\"}}"}'

Untuk mengejek kesalahan:

aws stepfunctions test-state \
  --definition '{
    "Type": "Task",
    "Resource": "arn:aws:states:::lambda:invoke",
    "Arguments": {...},
    "End": true
  }' \
  --input '{"key": "value"}' \
  --mock '{"errorOutput": {"error": "Lambda.ServiceException", "cause": "Service unavailable"}}'

Mode validasi tiruan

TestState API memvalidasi respons tiruan terhadap model API AWS layanan untuk memastikan kebenarannya. Anda dapat mengontrol perilaku validasi menggunakan fieldValidationMode parameter:

Contoh dengan mode validasi:

aws stepfunctions test-state \
  --definition '{
    "Type": "Task",
    "Resource": "arn:aws:states:::dynamodb:putItem",
    "Parameters": {...},
    "End": true
  }' \
  --input '{"key": "value"}' \
  --mock '{"fieldValidationMode": "STRICT", "result": "{\"Attributes\": {...}}"}'

Menguji Peta dan status Paralel

TestState API mendukung pengujian status Peta dan Paralel saat tiruan ditentukan. Ini memungkinkan Anda untuk menguji pemrosesan input dan output dari status aliran ini.

Memahami pengujian status Peta

Saat menguji status Peta dengan TestState API, Anda menguji pemrosesan input dan output status Peta tanpa menjalankan iterasi di dalamnya. Pendekatan ini memungkinkan Anda untuk menguji:

Anda tidak menguji apa yang terjadi di dalam ItemProcessor (status yang memproses setiap item).

Menguji status Peta

Saat menguji status Peta, hasil yang diejek harus mewakili output dari seluruh status Peta. Hasil tiruan harus berupa array JSON atau objek JSON yang valid tergantung pada konfigurasi status Peta Anda. Lihat contoh di bawah ini:

aws stepfunctions test-state \
  --definition '{
    "Type": "Map",
    "ItemsPath": "$.items",
    "ItemSelector": {
      "value.$": "$$.Map.Item.Value",
      "index.$": "$$.Map.Item.Index"
    },
    "ItemProcessor": {
      "ProcessorConfig": {"Mode": "INLINE"},
      "StartAt": "ProcessItem",
      "States": {
        "ProcessItem": {
          "Type": "Task",
          "Resource": "arn:aws:states:::lambda:invoke",
          "End": true
        }
      }
    },
    "End": true
  }' \
  --input '{"items": [1, 2, 3, 4, 5]}' \
  --mock '{"result": "[10, 20, 30, 40, 50]"}' \
  --inspection-level DEBUG

Menguji status Peta Terdistribusi

Status Peta Terdistribusi diuji mirip dengan status Peta sebaris. Saat Peta Anda menggunakan ItemReader to read from S3, berikan data langsung di input (seolah-olah sudah dibaca dari S3). Contoh:

aws stepfunctions test-state \
  --definition '{
    "Type": "Map",
    "ItemReader": {
      "Resource": "arn:aws:states:::s3:getObject",
      "Parameters": {
        "Bucket": "my-bucket",
        "Key": "orders.json"
      }
    },
    "ItemsPath": "$.orders",
    "ItemProcessor": {
      "ProcessorConfig": {"Mode": "DISTRIBUTED"},
      ...
    },
    "ToleratedFailureCount": 5,
    "End": true
  }' \
  --input '{
    "orders": [
      {"orderId": "123"},
      {"orderId": "456"},
      {"orderId": "789"}
    ]
  }' \
  --mock '{"result": "..."}'

Populasi Konteks Otomatis

Saat menguji status dalam status Peta (menggunakan stateName parameter) tanpa memberikan context parameter, TestState secara otomatis mengisi objek Context dengan nilai default. Ini termasuk bidang konteks khusus Peta seperti:

Menguji status Paralel

Saat menguji status Paralel, hasil tiruan harus berupa array JSON dengan satu elemen untuk setiap cabang, dalam urutan yang sama seperti cabang yang muncul dalam definisi.

Aktivitas Pengujian, .sync, dan. waitForTaskToken menyatakan

TestState API mendukung pengujian status Aktivitas, pola integrasi layanan.sync, dan. waitForTaskPola token saat tiruan ditentukan. Tanpa tiruan, menjalankan status ini melalui TestState API akan mengembalikan pengecualian validasi.

Iterasi melalui definisi mesin negara

Anda dapat memberikan definisi mesin status lengkap ke TestState API dan menentukan status mana yang akan diuji menggunakan stateName parameter. Ini memungkinkan Anda untuk menguji status tertentu dalam konteks mesin status lengkap Anda. Anda juga dapat menguji rantai dengan menggunakan output dan nextState dari satu tes sebagai input ke tes berikutnya. Ini memungkinkan Anda untuk menguji jalur eksekusi sebagian atau lengkap dalam mesin status Anda.

Menggunakan bidang konteks di TestState API

contextParameter memungkinkan Anda untuk memberikan nilai untuk objek Context yang biasanya akan diisi selama eksekusi. Ini berguna untuk menguji status yang mereferensikan nilai konteks seperti ID eksekusi, nama negara, atau waktu yang dimasukkan. Contoh di bawah ini menunjukkan bagaimana Anda dapat menggunakan objek Context dalam panggilan TestState API Anda:

aws stepfunctions test-state \
  --definition '{
    "Type": "Task",
    "Resource": "arn:aws:states:::lambda:invoke",
    "Arguments": {
      "FunctionName": "MyFunction",
      "Payload": {
        "executionId.$": "$$.Execution.Id",
        "stateName.$": "$$.State.Name",
        "enteredTime.$": "$$.State.EnteredTime"
      }
    },
    "End": true
  }' \
  --input '{"data": "value"}' \
  --context '{
    "Execution": {
      "Id": "arn:aws:states:us-east-1:123456789012:execution:MyStateMachine:test-exec-123",
      "Name": "test-exec-123",
      "StartTime": "2024-01-01T10:00:00.000Z"
    },
    "State": {
      "Name": "ProcessData",
      "EnteredTime": "2024-01-01T10:00:05.000Z"
    }
  }' \
  --mock '{"result": "{\"status\": \"success\"}"}'

Menguji coba lagi dan penanganan kesalahan

TestState API memungkinkan Anda untuk mensimulasikan skenario coba lagi dan menguji logika penanganan kesalahan dengan menentukan upaya coba lagi dan kesalahan ejekan.

Mensimulasikan upaya coba lagi

aws stepfunctions test-state \
  --definition '{
    "Type": "Task",
    "Resource": "arn:aws:states:::lambda:invoke",
    "Arguments": {...},
    "Retry": [{
      "ErrorEquals": ["Lambda.ServiceException"],
      "IntervalSeconds": 2,
      "MaxAttempts": 3,
      "BackoffRate": 2.0
    }],
    "End": true
  }' \
  --input '{"data": "value"}' \
  --state-configuration '{"retrierRetryCount": 1}' \
  --mock '{"errorOutput": {"error": "Lambda.ServiceException", "cause": "Service error"}}' \
  --inspection-level DEBUG

Respons mencakup rincian kesalahan dalam InspectionData:

{
  "status": "RETRIABLE",
  "inspectionData": {
    "errorDetails": {
      "retryBackoffIntervalSeconds": 4,
      "retryIndex": 0
    }
  }
}

Tanggapan ini menunjukkan:

Menguji catch handler

Saat kesalahan diejek dan cocok dengan penangan Catch, nextState bidang dalam respons TestState API menunjukkan status mana yang akan menangani kesalahan tersebut. Dalam contoh di bawah ini:

Untuk permintaan TestState API yang diberikan di bawah ini,

aws stepfunctions test-state \
  --definition '{
    "Type": "Task",
    "Resource": "arn:aws:states:::lambda:invoke",
    "Arguments": {...},
    "Catch": [{
      "ErrorEquals": ["Lambda.TooManyRequestsException"],
      "ResultPath": "$.error",
      "Next": "HandleThrottling"
    }],
    "Next": "Success"
  }' \
  --input '{"data": "value"}' \
  --mock '{"errorOutput": {"error": "Lambda.TooManyRequestsException", "cause": "Rate exceeded"}}' \
  --inspection-level DEBUG

Respons API yang diharapkan harus:

{
  "status": "CAUGHT_ERROR",
  "nextState": "HandleThrottling",
  "error": "Lambda.TooManyRequestsException",
  "cause": "Rate exceeded",
  "output": "{\"data\": \"value\", \"error\": {\"Error\": \"Lambda.TooManyRequestsException\", \"Cause\": \"Rate exceeded\"}}",
  "inspectionData": {
    "errorDetails": {
      "catchIndex": 0
    }
  }
}

Tanggapan ini menunjukkan bahwa:

Anda juga dapat menguji apa yang terjadi ketika semua upaya coba lagi habis dengan meningkatkan RetryCount nilai dalam objek konteks Anda.