sam remote invoke - AWS Serverless Application Model
PenggunaanPendapatOpsiContoh

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

sam remote invoke

Halaman ini memberikan informasi referensi untuk Antarmuka Baris AWS Serverless Application Model Perintah (AWS SAM CLI) sam remote invoke perintah.

sam remote invokePerintah memanggil sumber daya yang didukung di file. AWS Cloud

Penggunaan

$ sam remote invoke <arguments> <options>

Pendapat

ID Sumber Daya

ID dari sumber daya yang seharusnya dipanggil.

Argumen ini menerima nilai-nilai berikut:

  • Nama Sumber Daya Amazon (ARN) — ARN sumber daya.

    Tip

    Gunakan sam list stack-outputs --stack-name <stack-name> untuk mendapatkan ARN sumber daya Anda.

  • Logical ID — ID logis dari sumber daya. Anda juga harus memberikan nama AWS CloudFormation tumpukan menggunakan --stack-name opsi.

  • ID Fisik — ID fisik sumber daya. ID ini akan dibuat saat Anda menerapkan sumber daya menggunakan AWS CloudFormation.

    Tip

    Gunakan sam list resources --stack-name <stack-name> untuk mendapatkan ID fisik sumber daya Anda.

Saat Anda memberikan ARN atau ID fisik:

Jika Anda memberikan ARN atau ID fisik, jangan berikan nama tumpukan. Ketika nama tumpukan disediakan menggunakan --stack-name opsi, atau ketika nama tumpukan didefinisikan dalam file konfigurasi Anda, AWS SAM CLI akan secara otomatis memproses ID sumber daya Anda sebagai nilai ID logis dari AWS CloudFormation tumpukan.

Bila Anda tidak memberikan ID sumber daya:

Jika Anda tidak memberikan ID sumber daya, tetapi memberikan nama tumpukan dengan --stack-name opsi, AWS SAM CLI akan mencoba untuk secara otomatis memanggil sumber daya di AWS CloudFormation tumpukan Anda menggunakan logika berikut:

  1. The AWS SAM CLI akan mengidentifikasi jenis sumber daya dalam urutan berikut dan pindah ke langkah berikutnya setelah jenis sumber daya ditemukan di tumpukan Anda:

    1. Lambda

    2. Step Functions

    3. Amazon SQS

    4. Kinesis Data Streams

  2. Jika jenis sumber daya memiliki sumber daya tunggal di tumpukan Anda, AWS SAM CLI akan memanggilnya. Jika beberapa sumber daya dari jenis sumber daya ada di tumpukan Anda, AWS SAM CLI akan mengembalikan kesalahan.

Berikut ini adalah contoh dari apa AWS SAM CLI akan melakukan:

  • Tumpukan yang berisi dua fungsi Lambda dan antrian Amazon SQS — The AWS SAM CLI akan menemukan jenis sumber daya Lambda dan pengembalian dan kesalahan karena tumpukan berisi lebih dari satu fungsi Lambda.

  • Tumpukan yang berisi fungsi Lambda dan dua aplikasi Amazon Kinesis Data Streams — The AWS SAM CLI akan menemukan fungsi Lambda dan memanggilnya karena tumpukan berisi satu sumber daya Lambda.

  • Tumpukan yang berisi satu antrian Amazon SQS dan dua aplikasi Kinesis Data Streams — The AWS SAM CLI akan menemukan antrian Amazon SQS dan memanggilnya karena tumpukan berisi satu antrian Amazon SQS.

Opsi

--beta-features | --no-beta-features

Izinkan atau tolak fitur beta.

--config-env TEXT

Tentukan lingkungan yang akan digunakan dari AWS SAM CLI file konfigurasi.

Default: default

--config-file FILENAME

Tentukan jalur dan nama file file konfigurasi Anda.

Untuk informasi selengkapnya tentang file konfigurasi, lihat Mengkonfigurasi AWS SAMCLI.

Default: samconfig.toml di root direktori proyek Anda.

--debug

Aktifkan logging debug. Ini mencetak pesan debug dan stempel waktu yang dihasilkan oleh AWS SAM CLI.

--event, -e TEXT

Acara untuk dikirim ke sumber daya target.

--event-file FILENAME

Path ke file yang berisi acara untuk dikirim ke sumber daya target.

--help, -h

Tampilkan pesan bantuan dan keluar.

--output [ text | json ]

Output hasil pemanggilan Anda dalam format output tertentu.

json— Metadata permintaan dan respons sumber daya dikembalikan dalam struktur JSON. Respons berisi output SDK lengkap.

text— Metadata permintaan dikembalikan dalam struktur teks. Respons sumber daya dikembalikan dalam format output dari sumber daya yang dipanggil.

--parameter

Tambahan Boto3parameter yang dapat Anda berikan ke sumber daya yang dipanggil.

Amazon Kinesis Data Streams

Parameter tambahan berikut dapat digunakan untuk menempatkan catatan dalam aliran data Kinesis:

  • ExplicitHashKey='string'

  • PartitionKey='string'

  • SequenceNumberForOrdering='string'

  • StreamARN='string'

Untuk deskripsi setiap parameter, lihat Kinesis.client.PUT_RECORD.

AWS Lambda

Parameter tambahan berikut dapat digunakan untuk memanggil sumber daya Lambda dan menerima respons buffer:

  • ClientContext='base64-encoded string'

  • InvocationType='[ DryRun | Event | RequestResponse ]'

  • LogType='[ None | Tail ]'

  • Qualifier='string'

Parameter tambahan berikut dapat digunakan untuk memanggil sumber daya Lambda dengan streaming respons:

  • ClientContext='base64-encoded string'

  • InvocationType='[ DryRun | RequestResponse ]'

  • LogType='[ None | Tail ]'

  • Qualifier='string'

Untuk deskripsi setiap parameter, lihat yang berikut ini:

Amazon Simple Queue Service (Amazon SQS)

Parameter tambahan berikut dapat digunakan untuk mengirim pesan ke antrian Amazon SQS:

  • DelaySeconds=integer

  • MessageAttributes='json string'

  • MessageDeduplicationId='string'

  • MessageGroupId='string'

  • MessageSystemAttributes='json string'

Untuk deskripsi setiap parameter, lihat Sqs.client.send_message.

AWS Step Functions

Parameter tambahan berikut dapat digunakan untuk memulai eksekusi mesin negara:

  • name='string'

  • traceHeader='string'

Untuk deskripsi setiap parameter, lihat SFN.Client.START_EXECUTION.

--profile TEXT

Profil spesifik dari file kredensialmu untuk mendapatkan AWS kredensialnya.

--region TEXT

Wilayah AWS Sumber daya. Misalnya, us-east-1.

--stack-name TEXT

Nama AWS CloudFormation tumpukan yang dimiliki sumber daya.

--test-event-name NAME

Nama acara pengujian yang dapat dibagikan untuk diteruskan ke fungsi Lambda Anda.

catatan

Opsi ini hanya mendukung fungsi Lambda.

Contoh

Contoh berikut memanggil sumber daya yang didukung di AWS Cloud dan mengaktifkan logging debug, yang mencetak pesan debug dan stempel waktu yang dihasilkan oleh AWS SAM CLI:

$ sam remote invoke--debug