sam remote invoke

Halaman ini memberikan informasi referensi untuk AWS Serverless Application Model perintah Command Line Interface (AWS SAMCLI)sam remote invoke.

• Untuk pengantar AWS SAMCLI, lihatApa itu AWS SAMCLI?.

• Untuk dokumentasi tentang penggunaan AWS SAMCLI sam remote invoke perintah, lihatPengantar pengujian di cloud dengan sam remote invoke.

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

Penggunaan

$ sam remote invoke <arguments> <options>

Pendapat

ID Sumber Daya

ID 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, secara otomatis AWS SAM CLI akan 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. Ini 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 maka 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 yang AWS SAM CLI akan dilakukan:

• Tumpukan yang berisi dua fungsi Lambda dan antrean Amazon SQS — Ini 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 sumber daya Lambda tunggal.

• Tumpukan yang berisi satu antrian Amazon SQS dan dua aplikasi Kinesis Data Streams — The akan AWS SAM CLI 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 file AWS SAMCLI konfigurasi Anda.

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 file. AWS SAMCLI

--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

Boto3Parameter tambahan 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 berikut ini:

• Lambda dengan respon buffer - Lambda.client.Invoke

• Lambda dengan streaming respons - Lambda.client.invoke_with_response_stream

Amazon Simple Queue Service (Amazon SQS)

Parameter tambahan berikut dapat digunakan untuk mengirim pesan ke antrean 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 kredensi Anda untuk mendapatkan AWS kredensil.

--region TEXT

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

--stack-name TEXT

Nama AWS CloudFormation tumpukan sumber daya milik.

--test-event-name NAME

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

catatan

Opsi ini hanya mendukung fungsi Lambda.