sam local invoke

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

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

• Untuk dokumentasi tentang penggunaan AWS SAMCLI sam local invoke subperintah, lihatPengantar pengujian dengan sam local invoke.

sam local invokeSubperintah memulai pemanggilan satu kali fungsi secara lokal. AWS Lambda

Penggunaan

$ sam local invoke <arguments> <options>

catatan

Jika Anda memiliki lebih dari satu fungsi yang ditentukan dalam AWS SAM template Anda, berikan ID logis fungsi yang ingin Anda panggil.

Pendapat

ID Sumber Daya

ID fungsi Lambda untuk dipanggil.

Argumen ini opsional. Jika aplikasi Anda berisi satu fungsi Lambda, CLI akan AWS SAM memanggilnya. Jika aplikasi Anda berisi beberapa fungsi, berikan ID fungsi yang akan dipanggil.

Nilai yang valid: ID logis sumber daya atau ARN sumber daya.

Opsi

--add-host LIST

Meneruskan nama host ke pemetaan alamat IP ke file host wadah Docker. Parameter ini dapat dilewatkan beberapa kali.

Contoh: --add-host example.com:127.0.0.1

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

Izinkan atau tolak fitur beta.

--config-env TEXT

Nama lingkungan yang menentukan nilai parameter default dalam file konfigurasi yang akan digunakan. Nilai default-nya adalah “default”. Untuk informasi selengkapnya tentang file konfigurasi, lihat AWS SAMCLIberkas konfigurasi.

--config-file PATH

Jalur dan nama file dari file konfigurasi yang berisi nilai parameter default yang akan digunakan. Nilai default-nya adalah ”samconfig.toml“ di root direktori proyek. Untuk informasi selengkapnya tentang file konfigurasi, lihat AWS SAMCLIberkas konfigurasi.

--container-env-vars

(Opsional) Teruskan variabel lingkungan untuk kontainer citra fungsi Lambda ketika debugging lokal.

--container-host TEXT

Host kontainer Lambda yang teremulasi secara lokal. Nilai default-nya adalah localhost. Jika Anda ingin menjalankan AWS SAMCLI penampung Docker di macOS, Anda dapat menentukan. host.docker.internal Jika Anda ingin menjalankan wadah pada host yang berbeda dari AWS SAMCLI, Anda dapat menentukan alamat IP dari host jarak jauh.

--container-host-interface TEXT

Alamat IP dari antarmuka jaringan host tempat kontainer port harus terikat. Nilai default-nya adalah 127.0.0.1. Gunakan 0.0.0.0 untuk mengikat ke semua antarmuka.

--debug

Mengaktifkan logging debug untuk mencetak pesan debug yang AWS SAMCLI dihasilkan, dan untuk menampilkan stempel waktu.

--debug-args TEXT

Argumen tambahan untuk meneruskan ke debugger.

--debug-port, -d TEXT

Ketika ditentukan, mulai kontainer fungsi Lambda dalam modus debug dan ekspos port ini pada host lokal.

--debugger-path TEXT

Jalur host ke debugger yang dipasang ke kontainer Lambda.

--docker-network TEXT

Nama atau ID jaringan Docker yang ada yang harus terhubung dengan kontainer Docker Lambda, bersama dengan jaringan bridge default. Jika tidak ditentukan, kontainer Lambda hanya terhubung ke jaringan Docker bridge default.

--docker-volume-basedir, -v TEXT

Lokasi direktori dasar tempat AWS SAM file ada. Jika Docker berjalan pada mesin jarak jauh, Anda harus memasang jalur tempat AWS SAM file ada di mesin Docker dan memodifikasi nilai ini agar sesuai dengan mesin jarak jauh.

--env-vars, -n PATH

File JSON yang berisi nilai-nilai untuk variabel lingkungan fungsi Lambda ini. Untuk informasi selengkapnya tentang file variabel lingkungan, lihat File variabel lingkungan.

--event, -e PATH

File JSON yang berisi data peristiwa yang diteruskan ke fungsi Lambda ketika dipanggil. Jika Anda tidak menentukan opsi ini, tidak ada peristiwa yang diterima. Untuk meng-input JSON dari stdin, Anda harus meneruskan nilai '-'. Untuk detail tentang format pesan acara dari berbagai AWS layanan, lihat Bekerja dengan layanan lain di Panduan AWS Lambda Pengembang.

--force-image-build

Menentukan apakah AWS SAMCLI harus membangun kembali gambar yang digunakan untuk memanggil fungsi Lambda dengan lapisan.

--help

Menunjukkan pesan ini dan keluar.

--hook-name TEXT

Nama hook yang digunakan untuk memperluas AWS SAMCLI fungsionalitas.

Nilai yang diterima:terraform.

--invoke-image TEXT

URI dari gambar kontainer yang ingin Anda gunakan untuk pemanggilan fungsi lokal. Secara default, AWS SAM tarik gambar kontainer dari Amazon ECR Public (yang tercantum dalamRepositori citra). Gunakan opsi ini untuk menarik citra dari lokasi lain.

Misalnya, sam local invoke MyFunction --invoke-image amazon/aws-sam-cli-emulation-image-python3.8.

--layer-cache-basedir DIRECTORY

Menentukan lokasi direktori dasar tempat layer yang digunakan templat Anda diunduh.

--log-file, -l TEXT

Berkas log untuk mengirim log waktu aktif.

--no-event

Memanggil fungsi dengan peristiwa kosong.

--parameter-overrides

(Opsional) String yang berisi penggantian AWS CloudFormation parameter yang dikodekan sebagai pasangan nilai kunci. Menggunakan format yang sama dengan AWS Command Line Interface (AWS CLI). Misalnya: 'ParameterKey=KeyPairName, ParameterValue = MyKey ParameterKey =InstanceType, ParameterValue =t1.micro'.

Opsi ini tidak kompatibel dengan--hook-name.

--profile TEXT

Profil spesifik dari file kredensyal Anda yang mendapat AWS kredensyal.

--region TEXT

AWS Wilayah untuk disebarkan. Misalnya, us-east-1.

--save-params

Simpan parameter yang Anda berikan pada baris perintah ke file AWS SAM konfigurasi.

--shutdown

Mengemulasi peristiwa shutdown setelah pemanggilan selesai, untuk menguji penanganan ekstensi perilaku shutdown.

--skip-prepare-infra

Melewati tahap persiapan jika tidak ada perubahan infrastruktur yang dilakukan. Gunakan dengan --hook-name opsi.

--skip-pull-image

Secara default, Lambda AWS SAMCLI memeriksa lingkungan runtime jarak jauh terbaru Lambda dan memperbarui gambar lokal Anda secara otomatis agar tetap sinkron.

Tentukan opsi ini untuk melewatkan menarik Docker gambar terbaru untuk lingkungan runtime Lambda Anda.

--template, -t PATH

File AWS SAM template.

Opsi ini tidak kompatibel dengan--hook-name.

catatan

Jika Anda menentukan opsi ini, hanya AWS SAM memuat template dan sumber daya lokal yang ditunjuknya.

--terraform-plan-file

Jalur relatif atau absolut ke file Terraform paket lokal Anda saat menggunakan AWS SAMCLI withTerraform Cloud. Opsi ini mengharuskan --hook-name diatur keterraform.