aws:executeAwsApi— Panggil dan jalankan AWS API operasi - AWS Systems Manager

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

aws:executeAwsApi— Panggil dan jalankan AWS API operasi

Memanggil dan menjalankan AWS API operasi. Sebagian besar API operasi didukung, meskipun tidak semua API operasi telah diuji. APIOperasi streaming, seperti GetObjectoperasi, tidak didukung. Jika Anda tidak yakin apakah API operasi yang ingin Anda gunakan adalah operasi streaming, tinjau dokumentasi Boto3 untuk layanan tersebut guna menentukan apakah API memerlukan input atau output streaming. Kami secara teratur memperbarui versi Boto3 yang digunakan oleh tindakan ini. Namun, setelah rilis versi Boto3 baru, diperlukan waktu hingga beberapa minggu agar perubahan tercermin dalam tindakan ini. Setiap aws:executeAwsApi tindakan dapat berjalan hingga durasi maksimum 25 detik. Untuk contoh lebih lanjut tentang cara menggunakan tindakan ini, lihatContoh runbook tambahan.

Masukan

Input ditentukan oleh API operasi yang Anda pilih.

YAML
action: aws:executeAwsApi
inputs:
  Service: The official namespace of the service
  Api: The API operation or method name
  API operation inputs or parameters: A value
outputs: # These are user-specified outputs
- Name: The name for a user-specified output key
  Selector: A response object specified by using jsonpath format
  Type: The data type
JSON
{
   "action":"aws:executeAwsApi",
   "inputs":{
      "Service":"The official namespace of the service",
      "Api":"The API operation or method name",
      "API operation inputs or parameters":"A value"
   },
   "outputs":[ These are user-specified outputs
      {
         "Name":"The name for a user-specified output key",
         "Selector":"A response object specified by using JSONPath format",
         "Type":"The data type"
      }
   ]
}
Layanan

Layanan AWS Namespace yang berisi API operasi yang ingin Anda jalankan. Anda dapat melihat daftar Layanan AWS ruang nama yang didukung di Layanan yang tersedia dari. AWS SDK for Python (Boto3) Namespace dapat ditemukan di bagian Klien. Misalnya, namespace untuk Systems Manager adalah ssm. Namespace untuk Amazon Elastic Compute Cloud (AmazonEC2) adalah. ec2

Tipe: String

Wajib: Ya

Api

Nama API operasi yang ingin Anda jalankan. Anda dapat melihat API operasi (juga disebut metode) dengan memilih layanan di navigasi kiri pada halaman Referensi Layanan berikut. Pilih metode di bagian Klien untuk layanan yang ingin Anda jalankan. Misalnya, semua API operasi (metode) untuk Amazon Relational Database Service (RDSAmazon) tercantum di halaman berikut: Metode RDSAmazon.

Tipe: String

Diperlukan: Ya

APIinput operasi

Satu atau lebih input API operasi. Anda dapat melihat input yang tersediaI (dikenal dengan parameter) dengan memilih layanan di navigasi kiri pada halaman Referensi Layanan berikut. Pilih metode di bagian Klien untuk layanan yang ingin Anda jalankan. Misalnya, semua metode untuk Amazon RDS tercantum di halaman berikut: RDSMetode Amazon. Pilih metode describe_db_instances dan gulir ke bawah untuk melihat parameter yang tersedia, seperti, Nama, dan Nilai. DBInstanceIdentifier

YAML
inputs:
  Service: The official namespace of the service
  Api: The API operation name
  API input 1: A value
  API Input 2: A value
  API Input 3: A value
JSON
"inputs":{
      "Service":"The official namespace of the service",
      "Api":"The API operation name",
      "API input 1":"A value",
      "API Input 2":"A value",
      "API Input 3":"A value"
}

Jenis: Ditentukan oleh API operasi yang dipilih

Wajib: Ya

Output

Output ditentukan oleh pengguna berdasarkan respons dari API operasi yang dipilih.

Nama

Nama untuk output.

Jenis: String

Wajib: Ya

Pemilih

JSONPathUntuk atribut tertentu dalam objek respon. Anda dapat melihat obyek respon dengan memilih layanan di navigasi kiri pada halaman Referensi Layanan berikut. Pilih metode di bagian Klien untuk layanan yang ingin Anda jalankan. Misalnya, semua metode untuk Amazon RDS tercantum di halaman berikut: RDSMetode Amazon. Pilih metode describe_db_instances dan gulir ke bawah ke bagian Struktur Respon. DBInstancesterdaftar sebagai objek respons.

Jenis: Integer, Boolean, String,, StringList, StringMap atau MapList

Wajib: Ya

Jenis

Jenis data untuk elemen respon.

Jenis: Bervariasi

Wajib: Ya