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

# AWS SAMCLIreferensi perintah
<a name="serverless-sam-cli-command-reference"></a>

Bagian ini mencakup informasi referensi tentang AWS SAMCLI perintah. Ini termasuk rincian tentang penggunaan, daftar lengkap dari berbagai opsi yang tersedia untuk setiap perintah, dan informasi tambahan. Jika berlaku, informasi tambahan mencakup detail seperti argumen, variabel lingkungan, dan peristiwa. Lihat setiap perintah untuk detailnya. Untuk petunjuk tentang menginstal AWS SAMCLI, lihat[Instal AWS SAMCLI](install-sam-cli.md).

**Topics**
+ [sam build](sam-cli-command-reference-sam-build.md)
+ [sam delete](sam-cli-command-reference-sam-delete.md)
+ [sam deploy](sam-cli-command-reference-sam-deploy.md)
+ [sam init](sam-cli-command-reference-sam-init.md)
+ [sam list](sam-cli-command-reference-sam-list.md)
+ [sam local callback](sam-cli-command-reference-sam-local-callback.md)
+ [sam local execution](sam-cli-command-reference-sam-local-execution.md)
+ [sam local generate-event](sam-cli-command-reference-sam-local-generate-event.md)
+ [sam local invoke](sam-cli-command-reference-sam-local-invoke.md)
+ [sam local start-api](sam-cli-command-reference-sam-local-start-api.md)
+ [sam local start-lambda](sam-cli-command-reference-sam-local-start-lambda.md)
+ [sam logs](sam-cli-command-reference-sam-logs.md)
+ [sam package](sam-cli-command-reference-sam-package.md)
+ [sam pipeline bootstrap](sam-cli-command-reference-sam-pipeline-bootstrap.md)
+ [sam pipeline init](sam-cli-command-reference-sam-pipeline-init.md)
+ [sam publish](sam-cli-command-reference-sam-publish.md)
+ [sam remote callback](sam-cli-command-reference-sam-remote-callback.md)
+ [sam remote execution](sam-cli-command-reference-sam-remote-execution.md)
+ [sam remote invoke](sam-cli-command-reference-remote-invoke.md)
+ [sam remote test-event](sam-cli-command-reference-remote-test-event.md)
+ [sam sync](sam-cli-command-reference-sam-sync.md)
+ [sam traces](sam-cli-command-reference-sam-traces.md)
+ [sam validate](sam-cli-command-reference-sam-validate.md)

# sam build
<a name="sam-cli-command-reference-sam-build"></a>

Halaman ini memberikan informasi referensi untuk AWS Serverless Application Model perintah Command Line Interface (AWS SAMCLI)`sam build`.
+ Untuk pengantar AWS SAMCLI, lihat [Apa itu AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)
+ Untuk dokumentasi tentang penggunaan AWS SAMCLI `sam build` perintah, lihat[Pengantar bangunan dengan AWS SAM](using-sam-cli-build.md).

`sam build`Perintah menyiapkan aplikasi untuk langkah-langkah selanjutnya dalam alur kerja pengembang, seperti pengujian lokal atau penyebaran ke file. AWS Cloud

## Penggunaan
<a name="ref-sam-cli-build-usage"></a>

```
$ sam build <arguments> <options>
```

## Pendapat
<a name="ref-sam-cli-build-args"></a>

**ID Sumber Daya**  <a name="ref-sam-cli-build-args-resource-id"></a>
Tidak wajib. Instruksikan AWS SAM untuk membangun sumber daya tunggal yang dideklarasikan dalam [AWS SAM template](what-is-sam-overview.md#what-is-sam-template). Artefak build untuk sumber daya yang ditentukan akan menjadi satu-satunya yang tersedia untuk perintah berikutnya dalam alur kerja, mis. `sam package` dan `sam deploy`.

## Opsi
<a name="ref-sam-cli-build-options"></a>

`--base-dir, -s DIRECTORY`  <a name="ref-sam-cli-build-options-base-dir"></a>
Selesaikan jalur relatif ke fungsi atau kode sumber lapisan sehubungan dengan direktori ini. Gunakan opsi ini jika Anda ingin mengubah cara jalur relatif ke folder kode sumber diselesaikan. Secara default, jalur relatif diselesaikan sehubungan dengan lokasi templat AWS SAM .  
Selain sumber daya dalam aplikasi root atau tumpukan yang sedang Anda bangun, opsi ini juga memberlakukan aplikasi atau tumpukan nest.  
Opsi ini berlaku untuk tipe sumber daya dan properti berikut:  
+ Tipe sumber daya: Properti `AWS::Serverless::Function`: `CodeUri`
+ Tipe sumber daya: Atribut Sumber Daya`AWS::Serverless::Function`: Entri `Metadata`: `DockerContext`
+ Tipe sumber daya: Properti `AWS::Serverless::LayerVersion`: `ContentUri`
+ Tipe sumber daya: Properti `AWS::Lambda::Function`: `Code`
+ Tipe sumber daya: Properti `AWS::Lambda::LayerVersion`: `Content`

`--beta-features | --no-beta-features`  <a name="ref-sam-cli-build-options-beta-features"></a>
Izinkan atau tolak fitur beta.

`--build-dir, -b DIRECTORY`  <a name="ref-sam-cli-build-options-build-dir"></a>
Jalur ke direktori tempat artefak build disimpan. Direktori ini dan semua isinya akan dihapus dengan opsi ini.

`--build-image TEXT`  <a name="ref-sam-cli-build-options-build-image"></a>
URI dari citra kontainer yang ingin Anda tarik untuk build. Secara default, AWS SAM menarik citra kontainer dari Amazon ECR Publik. Gunakan opsi ini untuk menarik citra dari lokasi lain.  
Anda dapat menentukan opsi ini beberapa kali. Setiap instans dari opsi ini dapat mengambil baik string atau pasangan kunci-nilai. Jika Anda menentukan string, string adalah URI citra kontainer untuk digunakan untuk semua sumber daya dalam aplikasi Anda. Misalnya, `sam build --use-container --build-image amazon/aws-sam-cli-build-image-python3.8`. Jika Anda menentukan pasangan kunci-nilai, kuncinya adalah nama sumber daya, dan nilainya adalah URI citra kontainer untuk digunakan untuk sumber daya tersebut. Sebagai contoh, `sam build --use-container --build-image Function1=amazon/aws-sam-cli-build-image-python3.8`. Dengan pasangan kunci-nilai, Anda dapat menentukan citra kontainer yang berbeda untuk sumber daya yang berbeda.  
Opsi ini hanya berlaku jika opsi `--use-container` ditentukan, jika tidak akan terjadi kesalahan.

`--build-in-source | --no-build-in-source`  <a name="ref-sam-cli-build-options-build-in-source"></a>
Berikan `--build-in-source` untuk membangun proyek Anda langsung di folder sumber.  
`--build-in-source`Opsi ini mendukung runtime dan metode build berikut:  
+ **Runtime** - Setiap Node.js runtime yang didukung oleh opsi. `sam init --runtime`
+ **Membangun metode** —`Makefile`,`esbuild`.
`--build-in-source`Opsi ini tidak kompatibel dengan opsi berikut:  
+ `--hook-name`
+ `--use-container `
*Default*: `--no-build-in-source`

`--cached | --no-cached`  <a name="ref-sam-cli-build-options-cached"></a>
Mengaktifkan atau menonaktifkan build cache. Gunakan opsi ini untuk menggunakan kembali artefak build yang belum berubah dari build sebelumnya. AWS SAM mengevaluasi apakah Anda telah mengubah file apa pun di direktori proyek Anda. Secara default, build tidak di-cache. Jika `--no-cached` opsi dipanggil, itu akan mengganti `cached = true` pengaturan di samconfig.toml.  
AWS SAM tidak mengevaluasi apakah Anda telah mengubah modul pihak ketiga yang bergantung pada proyek Anda, di mana Anda belum menyediakan versi tertentu. Misalnya, jika fungsi Python Anda menyertakan `requirements.txt` file dengan entri`requests=1.x`, dan versi modul permintaan terbaru berubah dari `1.1` ke`1.2`, maka AWS SAM tidak menarik versi terbaru hingga Anda menjalankan build yang tidak di-cache.

`--cache-dir`  <a name="ref-sam-cli-build-options-cached-dir"></a>
Direktori tempat artefak cache disimpan saat `--cached` ditentukan. Direktori cache default adalah `.aws-sam/cache`.

`--config-env TEXT`  <a name="ref-sam-cli-build-options-config-env"></a>
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](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="ref-sam-cli-build-options-config-file"></a>
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](serverless-sam-cli-config.md).

`--container-env-var, -e TEXT`  <a name="ref-sam-cli-build-options-container-env-var"></a>
Variabel lingkungan yang akan diteruskan ke kontainer build. Anda dapat menentukan opsi ini beberapa kali. Setiap instans opsi ini mengambil pasangan kunci-nilai, dengan penjelasan kunci adalah variabel sumber daya dan lingkungan, dan nilai adalah nilai variabel lingkungan. Sebagai contoh: `--container-env-var Function1.GITHUB_TOKEN=TOKEN1 --container-env-var Function2.GITHUB_TOKEN=TOKEN2`.  
Opsi ini hanya berlaku jika opsi `--use-container` ditentukan, jika tidak akan terjadi kesalahan.

`--container-env-var-file, -ef PATH`  <a name="ref-sam-cli-build-options-container-env-var-file"></a>
Nama jalur dan file dari file JSON yang berisi nilai-nilai untuk variabel lingkungan kontainer ini. Untuk informasi selengkapnya tentang file variabel lingkungan kontainer, lihat [File variabel lingkungan kontainer](serverless-sam-cli-using-build.md#serverless-sam-cli-using-container-environment-file).  
Opsi ini hanya berlaku jika opsi `--use-container` ditentukan, jika tidak akan terjadi kesalahan.

`--debug`  <a name="ref-sam-cli-build-options-debug"></a>
Mengaktifkan logging debug untuk mencetak pesan debug yang AWS SAMCLI dihasilkan, dan untuk menampilkan stempel waktu.

`--docker-network TEXT`  <a name="ref-sam-cli-build-options-docker-network"></a>
Menentukan nama atau ID dari Docker jaringan yang ada yang kontainer Docker Lambda harus terhubung ke, bersama dengan jaringan jembatan default. Jika tidak ditentukan, kontainer Lambda hanya terhubung ke jaringan jembatan Docker default.

`--exclude, -x`  <a name="ref-sam-cli-build-options-exclude"></a>
Nama sumber daya untuk dikecualikan dari`sam build`. Misalnya, jika template Anda berisi`Function1`,`Function2`, `Function3` dan Anda menjalankan`sam build --exclude Function2`, hanya `Function1` dan `Function3` akan dibangun.

`--help`  <a name="ref-sam-cli-build-options-help"></a>
Menunjukkan pesan ini dan keluar.

`--hook-name TEXT`  <a name="ref-sam-cli-build-options-hook-name"></a>
Nama hook yang digunakan untuk memperluas AWS SAMCLI fungsionalitas.  
Nilai yang diterima:`terraform`.

`--manifest , -m PATH`  <a name="ref-sam-cli-build-options-manifest"></a>
Jalur ke file manifest dependensi kustom (misalnya, package.json) yang akan digunakan bukan default.

`--mount-symlinks`  <a name="ref-sam-cli-build-options-mount-symlinks"></a>
Memastikan symlink yang AWS SAMCLI selalu dipasang yang ada dalam file untuk dibangun atau dipanggil. Ini hanya berlaku untuk symlink di direktori tingkat atas (yaitu, symlink yang langsung berada di root fungsi). Secara default, symlink tidak dipasang kecuali yang diperlukan `build-in-source` untuk digunakan `node_modules` di NodeJS.

`--no-use-container`  <a name="ref-sam-cli-build-options-no-use-container"></a>
Opsi yang memungkinkan Anda menggunakan toolkit IDE untuk mengatur perilaku default. Anda juga dapat menggunakan `sam build --no-use-container` untuk menjalankan build di mesin lokal Anda alih-alih wadah docker.

`--parallel`  <a name="ref-sam-cli-build-options-parallel"></a>
Mengaktifkan build paralel. Gunakan opsi ini untuk membangun fungsi dan lapisan AWS SAM template Anda secara paralel. Secara default, fungsi dan lapisan dibangun secara berurutan.

`--parameter-overrides`  <a name="ref-sam-cli-build-options-parameter-overrides"></a>
(Opsional) String yang berisi penggantian 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`  <a name="ref-sam-cli-build-options-profile"></a>
Profil spesifik dari file kredensialmu yang mendapat AWS kredensialnya.

`--region TEXT`  <a name="ref-sam-cli-build-options-region"></a>
 Wilayah AWS Untuk menyebarkan ke. Misalnya, us-east-1.

`--save-params`  <a name="ref-sam-cli-build-options-save-params"></a>
Simpan parameter yang Anda berikan pada baris perintah ke file AWS SAM konfigurasi.

`--skip-prepare-infra`  <a name="ref-sam-cli-build-options-skip-prepare-infra"></a>
Melewati tahap persiapan jika tidak ada perubahan infrastruktur yang dilakukan. Gunakan dengan `--hook-name` opsi.

`--skip-pull-image`  <a name="ref-sam-cli-build-options-skip-pull-image"></a>
Menentukan apakah perintah harus melewatkan menarik ke bawah citra Docker terbaru untuk waktu aktif Lambda.

`--template-file, --template, -t PATH`  <a name="ref-sam-cli-build-options-template-file"></a>
Path dan nama file file AWS SAM template`[default: template.[yaml|yml]]`. Opsi ini tidak kompatibel dengan`--hook-name`.

`--terraform-project-root-path`  <a name="ref-sam-cli-build-options-terraform-project-root-path"></a>
Jalur relatif atau absolut ke direktori tingkat atas yang berisi file Terraform konfigurasi atau kode sumber fungsi Anda. Jika file-file ini terletak di luar direktori yang berisi modul Terraform root Anda, gunakan opsi ini untuk menentukan jalur absolut atau relatifnya. Opsi ini mengharuskan `--hook-name` diatur ke`terraform`.

`--use-container`, `-u`  <a name="ref-sam-cli-build-options-use-container"></a>
Jika fungsi Anda tergantung pada paket yang memiliki dependensi terkompilasi secara native, gunakan opsi ini untuk membangun fungsi Anda di dalam kontainer Docker mirip Lambda.

## Contoh
<a name="sam-cli-command-reference-sam-build-examples"></a>

Untuk contoh terperinci dan panduan mendalam tentang penggunaan `sam build` subperintah, lihat. [Pengantar bangunan dengan AWS SAM](using-sam-cli-build.md)

# sam delete
<a name="sam-cli-command-reference-sam-delete"></a>

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

Untuk pengantar AWS SAMCLI, lihat [Apa itu AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

`sam delete`Perintah menghapus AWS SAM aplikasi dengan menghapus CloudFormation tumpukan, artefak yang dikemas dan digunakan ke Amazon S3 dan Amazon ECR, dan file template. AWS SAM 

Perintah ini juga memeriksa apakah ada tumpukan pendamping Amazon ECR yang diterapkan, dan jika demikian meminta pengguna untuk menghapus tumpukan itu dan repositori Amazon ECR. Jika `--no-prompts` ditentukan, maka tumpukan pendamping dan repositori Amazon ECR dihapus secara default.

## Penggunaan
<a name="sam-cli-command-reference-sam-delete-usage"></a>

```
$ sam delete <options>
```

## Opsi
<a name="sam-cli-command-reference-sam-delete-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-delete-options-config-env"></a>
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](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-delete-options-config-file"></a>
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](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-delete-options-debug"></a>
Mengaktifkan logging debug untuk mencetak pesan debug yang AWS SAMCLI dihasilkan dan untuk menampilkan stempel waktu.

`--help`  <a name="sam-cli-command-reference-sam-delete-options-help"></a>
Menunjukkan pesan ini dan keluar.

`--no-prompts`  <a name="sam-cli-command-reference-sam-delete-options-no-prompts"></a>
Tentukan opsi ini agar AWS SAM beroperasi dalam mode non-interaktif. Nama tumpukan harus disediakan, baik dengan `--stack-name` opsi, atau dalam `toml` file konfigurasi.

`--profile TEXT`  <a name="sam-cli-command-reference-sam-delete-options-profile"></a>
Profil spesifik dari file kredensialmu yang mendapat AWS kredensialnya.

`--region TEXT`  <a name="sam-cli-command-reference-sam-delete-options-region"></a>
 AWS Wilayah untuk disebarkan. Misalnya, us-east-1.

`--s3-bucket`  <a name="sam-cli-command-reference-sam-delete-options-s3-bucket"></a>
Jalur bucket Amazon S3 yang ingin Anda hapus.

`--s3-prefix`  <a name="sam-cli-command-reference-sam-delete-options-s3-prefix"></a>
Awalan bucket Amazon S3 yang ingin Anda hapus.

`--save-params`  <a name="sam-cli-command-reference-sam-delete-options-save-params"></a>
Simpan parameter yang Anda berikan pada baris perintah ke file AWS SAM konfigurasi.

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-delete-options-stack-name"></a>
Nama CloudFormation tumpukan yang ingin Anda hapus.

## Contoh
<a name="sam-cli-command-reference-sam-delete-examples"></a>

Perintah berikut menghapus tumpukan`MY-STACK`. 

```
$ sam delete --stack-name MY-STACK
```

Perintah berikut menghapus tumpukan `MY-STACK` dan bucket S3: `sam-s3-demo-bucket`

```
$ sam delete \
    --stack-name MyStack \
    --s3-bucket MySAMBucket
```

# sam deploy
<a name="sam-cli-command-reference-sam-deploy"></a>

Halaman ini memberikan informasi referensi untuk AWS Serverless Application Model perintah Command Line Interface (AWS SAMCLI)`sam deploy`.
+ Untuk pengantar AWS SAMCLI, lihat [Apa itu AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)
+ Untuk dokumentasi tentang penggunaan AWS SAMCLI `sam deploy` perintah, lihat[Pengantar penerapan dengan AWS SAM](using-sam-cli-deploy.md).

`sam deploy`Perintah menyebarkan aplikasi untuk AWS Cloud menggunakan AWS CloudFormation.

## Penggunaan
<a name="ref-sam-cli-deploy-usage"></a>

```
$ <environment variables> sam deploy <options>
```

## Variabel-variabel lingkungan
<a name="ref-sam-cli-deploy-env"></a>

`SAM_CLI_POLL_DELAY`  <a name="ref-sam-cli-deploy-env-sam-cli-poll-delay"></a>
Atur variabel `SAM_CLI_POLL_DELAY` lingkungan dengan nilai detik di shell Anda untuk mengonfigurasi seberapa sering AWS SAM CLI memeriksa status CloudFormation tumpukan, yang berguna saat melihat pelambatan dari. CloudFormation Variabel env ini digunakan untuk polling panggilan `describe_stack` API, yang dibuat saat berjalan. `sam deploy`   
Berikut ini adalah contoh dari variabel ini:  

```
$ SAM_CLI_POLL_DELAY=5 sam deploy
```

## Opsi
<a name="ref-sam-cli-deploy-options"></a>

`--capabilities LIST`  <a name="ref-sam-cli-deploy-options-capabilities"></a>
Daftar kemampuan yang harus Anda tentukan CloudFormation untuk memungkinkan membuat tumpukan tertentu. Beberapa templat tumpukan mungkin menyertakan sumber daya yang memengaruhi izin di Anda Akun AWS, misalnya, dengan membuat pengguna baru AWS Identity and Access Management (IAM). Untuk tumpukan tersebut, Anda harus secara eksplisit menerima kemampuannya dengan menentukan opsi ini. Nilai yang valid adalah hanya `CAPABILITY_IAM` dan `CAPABILITY_NAMED_IAM`. Jika Anda memiliki sumber daya IAM, maka Anda dapat menentukan salah satu kemampuan. Jika Anda memiliki sumber daya IAM dengan nama khusus, maka Anda harus menentukan`CAPABILITY_NAMED_IAM`. Jika Anda tidak menentukan opsi ini, maka operasi mengembalikan `InsufficientCapabilities` kesalahan.  
Ketika Anda menyebarkan aplikasi yang berisi aplikasi bersarang, Anda harus menggunakan `CAPABILITY_AUTO_EXPAND` untuk mengakui aplikasi berisi aplikasi bersarang. Untuk informasi selengkapnya, lihat [Men-deploy aplikasi nest](serverless-sam-template-nested-applications.md#serverless-sam-templates-nested-applications-deploying).

`--config-env TEXT`  <a name="ref-sam-cli-deploy-options-config-env"></a>
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](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="ref-sam-cli-deploy-options-config-file"></a>
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](serverless-sam-cli-config.md).

`--confirm-changeset | --no-confirm-changeset`  <a name="ref-sam-cli-deploy-options-confirm-changeset"></a>
Prompt untuk mengonfirmasi apakah AWS SAMCLI penerapan set perubahan yang dihitung.

`--debug`  <a name="ref-sam-cli-deploy-options-debug"></a>
Aktifkan logging debug untuk mencetak pesan debug yang AWS SAMCLI dihasilkan dan untuk menampilkan stempel waktu.

`--disable-rollback | --no-disable-rollback`  <a name="ref-sam-cli-deploy-options-disable-rollback"></a>
Tentukan apakah akan memutar kembali CloudFormation tumpukan Anda jika terjadi kesalahan selama penerapan. Secara default, jika ada kesalahan selama penerapan, CloudFormation tumpukan Anda akan kembali ke status stabil terakhir. Jika Anda menentukan `--disable-rollback` dan terjadi kesalahan selama penerapan, maka sumber daya yang dibuat atau diperbarui sebelum kesalahan terjadi tidak dibatalkan.

`--fail-on-empty-changeset | --no-fail-on-empty-changeset`  <a name="ref-sam-cli-deploy-options-fail-on-empty-changeset"></a>
Tentukan apakah akan mengembalikan kode keluar bukan nol jika tidak ada perubahan yang harus dilakukan pada tumpukan. Perilaku default-nya adalah mengembalikan kode keluar nonkosong.

`--force-upload`  <a name="ref-sam-cli-deploy-options-force-upload"></a>
Tentukan opsi ini untuk mengunggah artefak bahkan jika artefak itu cocok dengan artefak yang ada di bucket Amazon S3. Mencocokkan artefak dibatalkan.

`--guided, -g`  <a name="ref-sam-cli-deploy-options-guided"></a>
Tentukan opsi ini untuk memiliki petunjuk AWS SAMCLI penggunaan untuk memandu Anda melalui penerapan.

`--help`  <a name="ref-sam-cli-deploy-options-help"></a>
Tampilkan pesan ini dan keluar.

`--image-repositories TEXT`  <a name="ref-sam-cli-deploy-options-image-repositories"></a>
Pemetaan fungsi ke URI repositori Amazon ECR mereka. Fungsi referensi dengan ID logisnya. Berikut ini adalah contohnya:  

```
$ sam deploy --image-repositories Function1=123456789012.dkr.ecr.us-east-1.amazonaws.com/my-repo
```
Anda dapat menentukan opsi ini beberapa kali dalam satu perintah.

`--image-repository TEXT`  <a name="ref-sam-cli-deploy-options-image-repository"></a>
Nama repositori Amazon ECR tempat perintah ini mengunggah gambar fungsi Anda. Opsi ini diperlukan untuk fungsi yang dideklarasikan dengan jenis `Image` paket.

`--kms-key-id TEXT`  <a name="ref-sam-cli-deploy-options-kms-key-id"></a>
ID kunci AWS Key Management Service (AWS KMS) yang digunakan untuk mengenkripsi artefak yang diam di bucket Amazon S3. Jika Anda tidak menentukan opsi ini, AWS SAM gunakan kunci enkripsi yang dikelola Amazon S3.

`--metadata`  <a name="ref-sam-cli-deploy-options-metadata"></a>
Peta metadata untuk melampirkan ke semua artefak yang direferensikan dalam templat Anda.

`--no-execute-changeset`  <a name="ref-sam-cli-deploy-options-no-execute-changeset"></a>
Menunjukkan apakah akan menerapkan changeset. Tentukan opsi ini jika Anda ingin melihat perubahan tumpukan Anda sebelum menerapkan set perubahan. Perintah ini membuat CloudFormation changeset dan kemudian keluar tanpa menerapkan changeset. Untuk menerapkan changeset, jalankan perintah yang sama tanpa opsi ini.

`--no-progressbar`  <a name="ref-sam-cli-deploy-options-no-progressbar"></a>
Jangan tampilkan baris progres saat mengunggah artefak ke Amazon S3.

`--notification-arns LIST`  <a name="ref-sam-cli-deploy-options-notification-arns"></a>
Daftar ARNs topik Amazon Simple Notification Service (Amazon SNS) CloudFormation yang terkait dengan tumpukan.

`--on-failure [ROLLBACK | DELETE | DO_NOTHING]`  <a name="ref-sam-cli-deploy-options-on-failure"></a>
Tentukan tindakan yang akan diambil saat tumpukan gagal dibuat.  
Pilihan berikut tersedia:  
+ `ROLLBACK`— Menggulung kembali tumpukan ke keadaan baik yang diketahui sebelumnya.
+ `DELETE`— Menggulung kembali tumpukan ke keadaan baik yang diketahui sebelumnya, jika ada. Jika tidak, menghapus tumpukan.
+ `DO_NOTHING`— Tidak memutar kembali atau menghapus tumpukan. Efeknya sama dengan efek`--disable-rollback`.
Perilaku bawaannya adalah `ROLLBACK`.  
Anda dapat menentukan `--disable-rollback` opsi atau `--on-failure` opsi, tetapi tidak keduanya.

`--parameter-overrides LIST`  <a name="ref-sam-cli-deploy-options-parameter-overrides"></a>
String yang berisi penggantian CloudFormation parameter yang dikodekan sebagai pasangan kunci-nilai. Setiap override menggunakan format`ParameterKey=name,ParameterValue=value`. Beberapa penggantian dipisahkan oleh spasi. Berikut adalah dua contoh:  

```
$ sam deploy --parameter-overrides ParameterKey=value1,ParameterValue=value2
```

```
$ sam deploy --parameter-overrides ParameterKey=value1,ParameterValue=value2 ParameterKey=hello,ParameterValue=world ParameterKey=apple,ParameterValue=banana
```

`--profile TEXT`  <a name="ref-sam-cli-deploy-options-profile"></a>
Profil spesifik dari file kredensialmu yang mendapat AWS kredensialnya.

`--region TEXT`  <a name="ref-sam-cli-deploy-options-region"></a>
 Wilayah AWS Untuk menyebarkan ke. Misalnya, us-east-1.

`--resolve-image-repos`  <a name="ref-sam-cli-deploy-options-resolve-image-repos"></a>
Secara otomatis membuat repositori Amazon ECR untuk digunakan untuk pengemasan dan penerapan untuk penerapan yang tidak dipandu. Opsi ini hanya berlaku untuk fungsi dan lapisan dengan `PackageType: Image` ditentukan. Jika Anda menentukan `--guided` opsi, maka AWS SAMCLI mengabaikan. `--resolve-image-repos`  
Jika AWS SAM secara otomatis membuat repositori ECR Amazon untuk fungsi atau lapisan dengan opsi ini, dan Anda kemudian menghapus fungsi atau lapisan tersebut dari AWS SAM templat Anda, maka repositori ECR Amazon yang sesuai akan dihapus secara otomatis.

`--resolve-s3`  <a name="ref-sam-cli-deploy-options-resolve-s3"></a>
Buat bucket Amazon S3 secara otomatis untuk digunakan untuk pengemasan dan penerapan untuk penerapan yang tidak dipandu. Jika Anda menentukan `--guided` opsi, maka AWS SAM CLI mengabaikan. `--resolve-s3` Jika Anda menentukan opsi `--s3-bucket` dan `--resolve-s3` opsi, maka terjadi kesalahan.

`--role-arn TEXT`  <a name="ref-sam-cli-deploy-options-role-arn"></a>
Nama Sumber Daya Amazon (ARN) dari peran IAM yang CloudFormation diasumsikan saat menerapkan kumpulan perubahan.

`--s3-bucket TEXT`  <a name="ref-sam-cli-deploy-options-s3-bucket"></a>
Nama bucket Amazon S3 tempat perintah ini mengunggah template Anda. CloudFormation Jika template Anda lebih besar dari 51.200 byte, maka `--s3-bucket` opsi atau opsi diperlukan`--resolve-s3`. Jika Anda menentukan opsi `--s3-bucket` dan `--resolve-s3` opsi, maka terjadi kesalahan.

`--s3-prefix TEXT`  <a name="ref-sam-cli-deploy-options-s3-prefix"></a>
Prefiks ditambahkan ke nama artefak yang diunggah ke bucket Amazon S3. Nama prefiks adalah nama jalur (nama folder) untuk bucket Amazon S3.

`--save-params`  <a name="ref-sam-cli-deploy-options-save-params"></a>
Simpan parameter yang Anda berikan pada baris perintah ke file AWS SAM konfigurasi.

`--signing-profiles LIST`  <a name="ref-sam-cli-deploy-options-signing-profiles"></a>
Daftar profil penandatanganan untuk menandatangani paket deployment Anda. Opsi ini mengambil daftar pasangan kunci-nilai, dengan penjelasan kunci adalah nama fungsi atau lapisan untuk menandatangani, dan nilai adalah profil penandatanganan, dengan pemilik profil opsional yang dibatasi dengan `:`. Misalnya, `FunctionNameToSign=SigningProfileName1 LayerNameToSign=SigningProfileName2:SigningProfileOwner`.

`--stack-name TEXT`  <a name="ref-sam-cli-deploy-options-stack-name"></a>
(Wajib) Nama CloudFormation tumpukan yang Anda gunakan. Jika Anda menentukan tumpukan yang ada, maka perintah memperbarui tumpukan. Jika Anda menentukan tumpukan baru, maka perintah membuatnya.

`--tags LIST`  <a name="ref-sam-cli-deploy-options-tags"></a>
Daftar tag untuk dikaitkan dengan tumpukan yang dibuat atau diperbarui. CloudFormation juga menyebarkan tag ini ke sumber daya di tumpukan yang mendukungnya.

`--template-file, --template, -t PATH`  <a name="ref-sam-cli-deploy-options-template-file"></a>
Path dan nama file tempat AWS SAM template Anda berada.  
Jika Anda menentukan opsi ini, maka AWS SAM gunakan hanya templat dan sumber daya lokal yang ditunjukkannya.

`--use-json`  <a name="ref-sam-cli-deploy-options-use-json"></a>
Output JSON untuk CloudFormation template. Output default-nya adalah YAML.

## Contoh
<a name="sam-cli-command-reference-sam-deploy-examples"></a>

Untuk contoh terperinci dan panduan mendalam tentang penggunaan `sam deploy` subperintah, lihat. [Pengantar penerapan dengan AWS SAM](using-sam-cli-deploy.md)

# sam init
<a name="sam-cli-command-reference-sam-init"></a>

Halaman ini memberikan informasi referensi untuk AWS Serverless Application Model perintah Command Line Interface (AWS SAMCLI)`sam init`.
+ Untuk pengantar AWS SAMCLI, lihat [Apa itu AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)
+ Untuk dokumentasi tentang penggunaan AWS SAMCLI `sam init` perintah, lihat[Buat aplikasi Anda di AWS SAM](using-sam-cli-init.md).

`sam init`Perintah ini menyediakan opsi untuk menginisialisasi aplikasi tanpa server baru.

## Penggunaan
<a name="sam-cli-command-reference-sam-init-usage"></a>

```
$ sam init <options>
```

## Opsi
<a name="sam-cli-command-reference-sam-init-options"></a>

`--app-template TEXT`  <a name="sam-cli-command-reference-sam-init-options-app-template"></a>
Pengenal templat aplikasi terkelola yang ingin Anda gunakan. Jika Anda tidak yakin, hubungi `sam init` tanpa opsi untuk alur kerja interaktif.  
Parameter ini diperlukan jika `--no-interactive` ditentukan dan `--location` tidak disediakan.  
Parameter ini hanya tersedia dalam AWS SAMCLI versi 0.30.0 dan yang lebih baru. Menentukan parameter ini dengan versi sebelumnya menyebabkan kesalahan.

`--application-insights | --no-application-insights`  <a name="sam-cli-command-reference-sam-init-options-application-insights"></a>
 Aktifkan pemantauan Amazon CloudWatch Application Insights untuk aplikasi Anda. Untuk mempelajari selengkapnya, lihat [Menggunakan CloudWatch Application Insights untuk memantau aplikasi tanpa AWS SAM server Anda](monitor-app-insights.md).   
 Opsi default-nya adalah `--no-application-insights`. 

`--architecture, -a [ x86_64 | arm64 ]`  <a name="sam-cli-command-reference-sam-init-options-architecture"></a>
Arsitektur set instruksi untuk fungsi Lambda aplikasi Anda. Tentukan salah satu `x86_64` atau`arm64`.

`--base-image [ amazon/dotnet8-base | amazon/dotnet6-base | amazon/java25-base | amazon/java21-base | amazon/java17-base | amazon/java11-base | amazon/nodejs24.x-base | amazon/nodejs22.x-base | amazon/nodejs20.x-base | amazon/nodejs18.x-base | amazon/nodejs16.x-base | amazon/python3.14-base | amazon/python3.13-base | amazon/python3.12-base | amazon/python3.11-base | amazon/python3.10-base | amazon/python3.9-base | amazon/python3.8-base | amazon/ruby3.4-base | amazon/ruby3.3-base | amazon/ruby3.2-base ]`  <a name="sam-cli-command-reference-sam-init-options-base-image"></a>
Citra dasar dari aplikasi Anda. Opsi ini hanya berlaku jika tipe paketnya adalah `Image`.  
Parameter ini diperlukan jika `--no-interactive` ditentukan, `--package-type` ditentukan sebagai `Image`, dan `--location` tidak ditentukan.

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-init-options-config-env"></a>
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](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-init-options-config-file"></a>
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](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-init-options-debug"></a>
Mengaktifkan logging debug untuk mencetak pesan debug yang AWS SAMCLI dihasilkan, dan untuk menampilkan stempel waktu.

`--dependency-manager, -d [ gradle | mod | maven | bundler | npm | cli-package | pip ]`  <a name="sam-cli-command-reference-sam-init-options-dependency-manager"></a>
Manajer dependensi waktu aktif Lambda Anda.

`--extra-content`  <a name="sam-cli-command-reference-sam-init-options-extra-content"></a>
Ganti parameter kustom apa pun dalam `cookiecutter.json` konfigurasi template, misalnya,`{"customParam1": "customValue1", "customParam2":"customValue2"}`.

`--help, -h`  <a name="sam-cli-command-reference-sam-init-options-help"></a>
Menunjukkan pesan ini dan keluar.

`--location, -l TEXT`  <a name="sam-cli-command-reference-sam-init-options-location"></a>
Lokasi templat atau aplikasi (Git, Mercurial, HTTP/HTTPS, file .zip, jalur).  
Parameter ini diperlukan jika `--no-interactive` ditentukan dan `--runtime`, `--name`, dan `--app-template` tidak disediakan.  
Untuk repositori Git, Anda harus menggunakan lokasi root repositori.  
Untuk jalur lokal, templatnya harus dalam bentuk antara file. zip atau format [Cookiecutter](https://cookiecutter.readthedocs.io/en/latest/README.html).

`--name, -n TEXT`  <a name="sam-cli-command-reference-sam-init-options-name"></a>
Nama proyek Anda yang akan dihasilkan sebagai direktori.  
Parameter ini diperlukan jika `--no-interactive` ditentukan dan `--location` tidak disediakan.

`--no-input`  <a name="sam-cli-command-reference-sam-init-options-no-input"></a>
Menonaktifkan prompt Cookiecutter dan menerima nilai vcfdefault yang ditentukan dalam konfigurasi templat.

`--no-interactive`  <a name="sam-cli-command-reference-sam-init-options-no-interactive"></a>
Nonaktifkan prompt interaktif untuk parameter init, dan gagal jika nilai-nilai yang diperlukan tidak ada.

`--output-dir, -o PATH`  <a name="sam-cli-command-reference-sam-init-options-output-dir"></a>
Lokasi tempat aplikasi diinisialisasi adalah output.

`--package-type [ Zip | Image ]`  <a name="sam-cli-command-reference-sam-init-options-package-type"></a>
Tipe paket aplikasi contoh. `Zip` membuat arsip file .zip, dan `Image` membuat citra kontainer.

`--runtime, -r [ dotnet8 | dotnet6 | java25 | java21 | java17 | java11 | nodejs24.x | nodejs22.x | nodejs20.x | nodejs18.x | nodejs16.x | python3.14 | python3.13 | python3.12 | python3.11 | python3.10 | python3.9 | python3.8 | ruby3.4 | ruby3.3 | ruby3.2 ]`  <a name="sam-cli-command-reference-sam-init-options-runtime"></a>
Waktu aktif Lambda aplikasi Anda. Opsi ini hanya berlaku jika tipe paketnya adalah `Zip`.  
Parameter ini diperlukan jika `--no-interactive` ditentukan, `--package-type` ditentukan sebagai `Zip`, dan `--location` tidak ditentukan.

`--save-params`  <a name="sam-cli-command-reference-sam-init-options-save-params"></a>
Simpan parameter yang Anda berikan pada baris perintah ke file AWS SAM konfigurasi.

`--tracing | --no-tracing`  <a name="sam-cli-command-reference-sam-init-options-tracing"></a>
Aktifkan AWS X-Ray penelusuran untuk fungsi Lambda Anda.

## Contoh
<a name="sam-cli-command-reference-sam-init-examples"></a>

Untuk contoh terperinci dan panduan mendalam tentang penggunaan `sam init` subperintah, lihat. [Buat aplikasi Anda di AWS SAM](using-sam-cli-init.md)

# sam list
<a name="sam-cli-command-reference-sam-list"></a>

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

Untuk pengantar AWS SAMCLI, lihat [Apa itu AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

`sam list`Perintah tersebut mengeluarkan informasi penting tentang sumber daya dalam aplikasi tanpa server Anda dan status aplikasi tanpa server Anda. Gunakan **sam list** sebelum dan sesudah penerapan untuk membantu selama pengembangan lokal dan cloud.

## Penggunaan
<a name="sam-cli-command-reference-sam-list-usage"></a>

```
$ sam list <options> <subcommand>
```

## Opsi
<a name="sam-cli-command-reference-sam-list-options"></a>

`--help, -h`  <a name="sam-cli-command-reference-sam-list-options-help"></a>
Tampilkan pesan ini dan keluar.

## Subperintah
<a name="sam-cli-command-reference-sam-list-subcommands"></a>

`endpoints`  <a name="sam-cli-command-reference-sam-list-subcommands-endpoints"></a>
Menampilkan daftar cloud dan titik akhir lokal dari CloudFormation tumpukan Anda. Untuk informasi selengkapnya, lihat [sam list endpoints](sam-cli-command-reference-sam-list-endpoints.md).

`resources`  <a name="sam-cli-command-reference-sam-list-subcommands-resources"></a>
Menampilkan sumber daya dalam template AWS Serverless Application Model (AWS SAM) Anda yang dibuat pada AWS CloudFormation saat penerapan. Untuk informasi selengkapnya, lihat [sam list resources](sam-cli-command-reference-sam-list-resources.md).

`stack-outputs`  <a name="sam-cli-command-reference-sam-list-subcommands-stack-outputs"></a>
Menampilkan output CloudFormation tumpukan Anda dari CloudFormation template AWS SAM atau. Lihat informasi yang lebih lengkap di [sam list stack-outputs](sam-cli-command-reference-sam-list-stack-outputs.md).

# sam list endpoints
<a name="sam-cli-command-reference-sam-list-endpoints"></a>

Halaman ini memberikan informasi referensi untuk AWS Serverless Application Model `sam list endpoints` subperintah Command Line Interface (AWS SAMCLI).

Untuk pengantar AWS SAMCLI, lihat [Apa itu AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

`sam list endpoints`Subperintah menampilkan daftar cloud dan endpoint lokal dari tumpukan Anda CloudFormation . Anda dapat berinteraksi dengan sumber daya ini melalui **sam sync** perintah **sam local** dan.

AWS Lambda dan jenis sumber daya Amazon API Gateway didukung dengan perintah ini.

**catatan**  
Domain khusus didukung saat dikonfigurasi untuk sumber daya Amazon API Gateway Anda. Perintah ini akan menampilkan domain kustom alih-alih titik akhir default.

## Penggunaan
<a name="sam-cli-command-reference-sam-list-endpoints-usage"></a>

```
$ sam list endpoints <options>
```

## Opsi
<a name="sam-cli-command-reference-sam-list-endpoints-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-list-endpoints-options-config-env"></a>
Nama lingkungan yang menentukan nilai parameter default dalam file konfigurasi yang akan digunakan.  
*Nilai default*: `default`  
Untuk informasi selengkapnya tentang file konfigurasi, lihat [AWS SAMCLIberkas konfigurasi](serverless-sam-cli-config.md).

`--config-file TEXT`  <a name="sam-cli-command-reference-sam-list-endpoints-options-config-file"></a>
Jalur dan nama file dari file konfigurasi yang berisi nilai parameter default yang akan digunakan.  
*Nilai default*: `samconfig.toml` di direktori kerja saat ini.  
Untuk informasi selengkapnya tentang file konfigurasi, lihat [AWS SAMCLIberkas konfigurasi](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-list-endpoints-options-debug"></a>
Aktifkan pencatatan debug untuk mencetak pesan debug yang dihasilkan oleh stempel waktu AWS SAMCLI with.

`--help, -h`  <a name="sam-cli-command-reference-sam-list-endpoints-options-help"></a>
Tampilkan pesan ini dan keluar.

`--output [json|table]`  <a name="sam-cli-command-reference-sam-list-endpoints-options-output"></a>
Tentukan format untuk hasil keluaran.  
*Nilai default*: `table`

`--profile TEXT`  <a name="sam-cli-command-reference-sam-list-endpoints-options-profile"></a>
Pilih profil tertentu dari file kredensialmu untuk mendapatkan AWS kredensialnya.

`--region TEXT`  <a name="sam-cli-command-reference-sam-list-endpoints-options-region"></a>
Atur AWS wilayah layanan. Misalnya, `us-east-1`.

`--save-params`  <a name="sam-cli-command-reference-sam-list-endpoints-options-save-params"></a>
Simpan parameter yang Anda berikan pada baris perintah ke file AWS SAM konfigurasi.

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-list-endpoints-options-stack-name"></a>
Nama CloudFormation tumpukan yang digunakan. Nama tumpukan dapat ditemukan di file aplikasi Anda atau `samconfig.toml` file konfigurasi yang ditunjuk.  
Ketika opsi ini tidak ditentukan, sumber daya lokal yang ditentukan dalam template Anda akan ditampilkan.

`--template-file, --template, -t PATH`  <a name="sam-cli-command-reference-sam-list-endpoints-options-template"></a>
AWS SAM berkas templat.  
*Nilai default*: `template.[yaml|yml|json]`

## Contoh
<a name="sam-cli-command-reference-sam-list-endpoints-examples"></a>

Menampilkan output, dalam format json, dari titik akhir sumber daya yang diterapkan dari tumpukan Anda CloudFormation bernama. `test-stack`

```
$ sam list endpoints --stack-name test-stack --output json
			
[
  {
    "LogicalResourceId": "HelloWorldFunction",
    "PhysicalResourceId": "sam-app-test-list-HelloWorldFunction-H85Y7yIV7ZLq",
    "CloudEndpoint": "https://zt55oi7kbljxjmcoahsj3cknwu0rposq.lambda-url.us-east-1.on.aws/",
    "Methods": "-"
  },
  {
    "LogicalResourceId": "ServerlessRestApi",
    "PhysicalResourceId": "uj80uoe2o2",
    "CloudEndpoint": [
      "https://uj80uoe2o2.execute-api.us-east-1.amazonaws.com/Prod",
      "https://uj80uoe2o2.execute-api.us-east-1.amazonaws.com/Stage"
    ],
    "Methods": [
      "/hello['get']"
    ]
  }
]
```

# sam list resources
<a name="sam-cli-command-reference-sam-list-resources"></a>

Halaman ini memberikan informasi referensi untuk AWS Serverless Application Model `sam list resources` subperintah Command Line Interface (AWS SAMCLI).

Untuk pengantar AWS SAMCLI, lihat [Apa itu AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

`sam list resources`Subperintah menampilkan sumber daya dalam template AWS Serverless Application Model (AWS SAM) Anda yang dibuat AWS CloudFormation oleh AWS SAM transformasi saat penerapan.

Gunakan **sam list resources** dengan AWS SAM template sebelum penerapan untuk melihat sumber daya yang akan dibuat. Berikan nama CloudFormation tumpukan untuk melihat daftar konsolidasi yang mencakup sumber daya yang digunakan.

**catatan**  
Untuk menghasilkan daftar sumber daya dari AWS SAM template Anda, transformasi lokal template Anda dilakukan. Sumber daya yang akan digunakan dengan kondisi, seperti dalam wilayah tertentu, termasuk dalam daftar ini.

## Penggunaan
<a name="sam-cli-command-reference-sam-list-resources-usage"></a>

```
$ sam list resources <options>
```

## Opsi
<a name="sam-cli-command-reference-sam-list-resources-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-config-env"></a>
Nama lingkungan yang menentukan nilai parameter default dalam file konfigurasi yang akan digunakan.  
*Nilai default*: `default`  
Untuk informasi selengkapnya tentang file konfigurasi, lihat [AWS SAMCLIberkas konfigurasi](serverless-sam-cli-config.md).

`--config-file TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-config-file"></a>
Jalur dan nama file dari file konfigurasi yang berisi nilai parameter default yang akan digunakan.  
*Nilai default*: `samconfig.toml` di direktori kerja saat ini.  
Untuk informasi selengkapnya tentang file konfigurasi, lihat [AWS SAMCLIberkas konfigurasi](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-list-resources-options-debug"></a>
Aktifkan pencatatan debug untuk mencetak pesan debug yang dihasilkan oleh stempel waktu AWS SAMCLI with.

`--help, -h`  <a name="sam-cli-command-reference-sam-list-resources-options-help"></a>
Tampilkan pesan ini dan keluar.

`--output [json|table]`  <a name="sam-cli-command-reference-sam-list-resources-options-output"></a>
Tentukan format untuk hasil keluaran.  
*Nilai default*: `table`

`--profile TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-profile"></a>
Pilih profil tertentu dari file kredensialmu untuk mendapatkan AWS kredensialnya.

`--region TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-region"></a>
Atur AWS wilayah layanan. Misalnya, `us-east-1`.

`--save-params`  <a name="sam-cli-command-reference-sam-list-resources-options-save-params"></a>
Simpan parameter yang Anda berikan pada baris perintah ke file AWS SAM konfigurasi.

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-stack-name"></a>
Nama CloudFormation tumpukan yang digunakan. Nama tumpukan dapat ditemukan di file aplikasi Anda atau `samconfig.toml` file konfigurasi yang ditunjuk.  
Ketika disediakan, sumber daya logis IDs dari template Anda akan dipetakan ke fisik yang sesuai IDs di CloudFormation. Untuk mempelajari lebih lanjut tentang fisik IDs, lihat [Bidang sumber daya](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resources-section-structure.html#resources-section-structure-resource-fields) di *Panduan AWS CloudFormation Pengguna*.  
Ketika opsi ini tidak ditentukan, sumber daya lokal yang ditentukan dalam template Anda akan ditampilkan.

`--template-file, --template, -t PATH`  <a name="sam-cli-command-reference-sam-list-resources-options-"></a>
AWS SAM berkas templat.  
*Nilai default*: `template.[yaml|yml|json]`

## Contoh
<a name="sam-cli-command-reference-sam-list-resources-examples"></a>

Menampilkan output, dalam format tabel, sumber daya lokal dari AWS SAM template Anda dan sumber daya yang digunakan dari CloudFormation tumpukan Anda bernama`test-stack`. Jalankan dari direktori yang sama dengan template lokal Anda.

```
$ sam list resources --stack-name test-stack --output table
			
-------------------------------------------------------------------------------------------------------------------------
Logical ID                                                   Physical ID
-------------------------------------------------------------------------------------------------------------------------
HelloWorldFunction                                           sam-app-test-list-HelloWorldFunction-H85Y7yIV7ZLq
HelloWorldFunctionHelloWorldPermissionProd                   sam-app-test-list-
                                                             HelloWorldFunctionHelloWorldPermissionProd-1QH7CPOCBL2IK
HelloWorldFunctionRole                                       sam-app-test-list-HelloWorldFunctionRole-SRJDMJ6F7F41
ServerlessRestApi                                            uj80uoe2o2
ServerlessRestApiDeployment47fc2d5f9d                        pncw5f
ServerlessRestApiProdStage                                   Prod
ServerlessRestApiDeploymentf5716dc08b                        -
-------------------------------------------------------------------------------------------------------------------------
```

# sam list stack-outputs
<a name="sam-cli-command-reference-sam-list-stack-outputs"></a>

Halaman ini memberikan informasi referensi untuk AWS Serverless Application Model `sam list stack-outputs` subperintah Command Line Interface (AWS SAMCLI).

Untuk pengantar AWS SAMCLI, lihat [Apa itu AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

`sam list stack-outputs`Subperintah menampilkan output AWS CloudFormation tumpukan Anda dari AWS Serverless Application Model (AWS SAM) atau CloudFormation template. Untuk informasi selengkapnya`Outputs`, lihat [Output](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/outputs-section-structure.html) di *Panduan AWS CloudFormation Pengguna*.

## Penggunaan
<a name="sam-cli-command-reference-sam-list-stack-outputs-usage"></a>

```
$ sam list stack-outputs <options>
```

## Opsi
<a name="sam-cli-command-reference-sam-list-stack-outputs-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-config-env"></a>
Nama lingkungan yang menentukan nilai parameter default dalam file konfigurasi yang akan digunakan.  
*Nilai default*: `default`  
Untuk informasi selengkapnya tentang file konfigurasi, lihat [AWS SAMCLIberkas konfigurasi](serverless-sam-cli-config.md).

`--config-file TEXT`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-config-file"></a>
Jalur dan nama file dari file konfigurasi yang berisi nilai parameter default yang akan digunakan.  
*Nilai default*: `samconfig.toml` di direktori kerja saat ini.  
Untuk informasi selengkapnya tentang file konfigurasi, lihat [AWS SAMCLIberkas konfigurasi](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-debug"></a>
Aktifkan pencatatan debug untuk mencetak pesan debug yang dihasilkan oleh stempel waktu AWS SAMCLI with.

`--help, -h`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-help"></a>
Tampilkan pesan ini dan keluar.

`--output [json|table]`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-output"></a>
Tentukan format untuk hasil keluaran.  
*Nilai default*: `table`

`--profile TEXT`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-profile"></a>
Pilih profil tertentu dari file kredensi Anda untuk mendapatkan AWS kredensional.

`--region TEXT`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-region"></a>
Atur AWS wilayah layanan. Misalnya, `us-east-1`.

`--save-params`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-save-params"></a>
Simpan parameter yang Anda berikan pada baris perintah ke file AWS SAM konfigurasi.

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-"></a>
Nama CloudFormation tumpukan yang digunakan. Nama tumpukan dapat ditemukan di file aplikasi Anda atau `samconfig.toml` file konfigurasi yang ditunjuk.  
Opsi ini diperlukan.

## Contoh
<a name="sam-cli-command-reference-sam-list-stack-outputs-examples"></a>

Menampilkan output, dalam format tabel, sumber daya dalam CloudFormation tumpukan Anda bernama`test-stack`.

```
$ sam list stack-outputs --stack-name test-stack --output table
			
------------------------------------------------------------------------------------------------------------------------
OutputKey                                OutputValue                              Description
------------------------------------------------------------------------------------------------------------------------
HelloWorldFunctionIamRole                arn:aws:iam::account-number:role/sam-      Implicit IAM Role created for Hello
                                         app-test-list-HelloWorldFunctionRole-    World function
                                         SRJDMJ6F7F41
HelloWorldApi                            https://uj80uoe2o2.execute-api.us-       API Gateway endpoint URL for Prod
                                         east-1.amazonaws.com/Prod/hello/         stage for Hello World function
HelloWorldFunction                       arn:aws:lambda:us-                       Hello World Lambda Function ARN
                                         east-1:account-number:function:sam-app-
                                         test-list-
                                         HelloWorldFunction-H85Y7yIV7ZLq
------------------------------------------------------------------------------------------------------------------------
```

# sam local callback
<a name="sam-cli-command-reference-sam-local-callback"></a>

Halaman ini memberikan informasi referensi untuk AWS Serverless Application Model perintah Command Line Interface (AWS SAMCLI)`sam local callback`.

Untuk pengantar AWS SAMCLI, lihat [Apa itu AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

`sam local callback`Perintah ini memungkinkan Anda mengirim callback ke eksekusi fungsi lokal yang tahan lama selama pengembangan dan pengujian.

## Penggunaan
<a name="sam-cli-command-reference-sam-local-callback-usage"></a>

```
$ sam local callback <subcommand> <options>
```

## Opsi
<a name="sam-cli-command-reference-sam-local-callback-options"></a>

`--help, -h`  <a name="sam-cli-command-reference-sam-local-callback-options-help"></a>
Tampilkan pesan ini dan keluar.

## Subperintah
<a name="sam-cli-command-reference-sam-local-callback-subcommands"></a>

`succeed`  <a name="sam-cli-command-reference-sam-local-callback-subcommands-succeed"></a>
Kirim callback yang berhasil ke eksekusi fungsi yang tahan lama. Untuk informasi selengkapnya, lihat [sam local callback succeed](sam-cli-command-reference-sam-local-callback-succeed.md).

`fail`  <a name="sam-cli-command-reference-sam-local-callback-subcommands-fail"></a>
Kirim callback kegagalan ke eksekusi fungsi yang tahan lama. Untuk informasi selengkapnya, lihat [sam local callback fail](sam-cli-command-reference-sam-local-callback-fail.md).

`heartbeat`  <a name="sam-cli-command-reference-sam-local-callback-subcommands-heartbeat"></a>
Kirim panggilan balik detak jantung ke eksekusi fungsi yang tahan lama. Lihat informasi yang lebih lengkap di [sam local callback heartbeat](sam-cli-command-reference-sam-local-callback-heartbeat.md).

# sam local callback succeed
<a name="sam-cli-command-reference-sam-local-callback-succeed"></a>

Kirim callback yang berhasil ke eksekusi fungsi yang tahan lama.

## Penggunaan
<a name="ref-sam-cli-local-callback-succeed-usage"></a>

```
$ sam local callback succeed CALLBACK_ID [OPTIONS]
```

## Argumen yang Diperlukan
<a name="ref-sam-cli-local-callback-succeed-arguments"></a>

`CALLBACK_ID`  
Pengenal unik callback untuk mengirim respons sukses.

## Opsi
<a name="ref-sam-cli-local-callback-succeed-options"></a>

`-r, --result TEXT`  
Sukses hasil payload sebagai string.

`--region TEXT`  
Atur AWS Wilayah layanan (misalnya,`us-east-1`).

`--profile TEXT`  
Pilih profil tertentu dari file kredensi Anda untuk mendapatkan AWS kredensional.

`--config-env TEXT`  
Nama lingkungan menentukan nilai parameter default dalam file konfigurasi. Default: `default`

`--config-file TEXT`  
File konfigurasi yang berisi nilai parameter default. Default: `samconfig.toml`

`--save-params`  
Simpan parameter yang disediakan melalui baris perintah ke file konfigurasi.

`--beta-features / --no-beta-features`  
Aktifkan/Nonaktifkan fitur beta.

`--debug`  
Aktifkan pencatatan debug untuk mencetak pesan debug yang dihasilkan oleh AWS SAM CLI dan menampilkan stempel waktu.

`-h, --help`  
Menunjukkan pesan ini dan keluar.

## Contoh
<a name="ref-sam-cli-local-callback-succeed-examples"></a>

Kirim callback sukses tanpa hasil:

```
$ sam local callback succeed my-callback-id
```

Kirim callback sukses dengan hasil:

```
$ sam local callback succeed my-callback-id --result 'Task completed successfully'
```

Kirim callback sukses dengan opsi singkat:

```
$ sam local callback succeed my-callback-id -r 'Success result'
```

# sam local callback fail
<a name="sam-cli-command-reference-sam-local-callback-fail"></a>

Kirim callback kegagalan ke eksekusi fungsi yang tahan lama.

## Penggunaan
<a name="ref-sam-cli-local-callback-fail-usage"></a>

```
$ sam local callback fail CALLBACK_ID [OPTIONS]
```

## Argumen yang Diperlukan
<a name="ref-sam-cli-local-callback-fail-arguments"></a>

`CALLBACK_ID`  
Pengenal unik callback untuk mengirim respons kegagalan.

## Opsi
<a name="ref-sam-cli-local-callback-fail-options"></a>

`--error-data TEXT`  
Data kesalahan tambahan.

`--stack-trace TEXT`  
Tumpukan entri jejak. Opsi ini dapat ditentukan beberapa kali.

`--error-type TEXT`  
Jenis kesalahan.

`--error-message TEXT`  
Pesan kesalahan terperinci.

`--region TEXT`  
Atur AWS Wilayah layanan (misalnya,`us-east-1`).

`--profile TEXT`  
Pilih profil tertentu dari file kredensialmu untuk mendapatkan AWS kredensialnya.

`--config-env TEXT`  
Nama lingkungan menentukan nilai parameter default dalam file konfigurasi. Default: `default`

`--config-file TEXT`  
File konfigurasi yang berisi nilai parameter default. Default: `samconfig.toml`

`--save-params`  
Simpan parameter yang disediakan melalui baris perintah ke file konfigurasi.

`--beta-features / --no-beta-features`  
Aktifkan/Nonaktifkan fitur beta.

`--debug`  
Aktifkan pencatatan debug untuk mencetak pesan debug yang dihasilkan oleh AWS SAM CLI dan menampilkan stempel waktu.

`-h, --help`  
Menunjukkan pesan ini dan keluar.

## Contoh
<a name="ref-sam-cli-local-callback-fail-examples"></a>

Kirim panggilan balik kegagalan tanpa parameter:

```
$ sam local callback fail my-callback-id
```

Kirim panggilan balik kegagalan dengan pesan kesalahan:

```
$ sam local callback fail my-callback-id --error-message 'Task failed'
```

Kirim panggilan balik kegagalan dengan semua parameter:

```
$ sam local callback fail my-callback-id --error-message 'Task failed' --error-type 'ValidationError' --stack-trace 'at line 42' --error-data '{"code": 500}'
```

# sam local callback heartbeat
<a name="sam-cli-command-reference-sam-local-callback-heartbeat"></a>

Kirim panggilan balik detak jantung ke eksekusi fungsi yang tahan lama.

## Penggunaan
<a name="ref-sam-cli-local-callback-heartbeat-usage"></a>

```
$ sam local callback heartbeat CALLBACK_ID [OPTIONS]
```

## Argumen yang Diperlukan
<a name="ref-sam-cli-local-callback-heartbeat-arguments"></a>

`CALLBACK_ID`  
Pengenal unik panggilan balik untuk mengirim detak jantung ke.

## Opsi
<a name="ref-sam-cli-local-callback-heartbeat-options"></a>

`--region TEXT`  
Atur AWS Wilayah layanan (misalnya,`us-east-1`).

`--profile TEXT`  
Pilih profil tertentu dari file kredensialmu untuk mendapatkan AWS kredensialnya.

`--config-env TEXT`  
Nama lingkungan menentukan nilai parameter default dalam file konfigurasi. Default: `default`

`--config-file TEXT`  
File konfigurasi yang berisi nilai parameter default. Default: `samconfig.toml`

`--save-params`  
Simpan parameter yang disediakan melalui baris perintah ke file konfigurasi.

`--beta-features / --no-beta-features`  
Aktifkan/Nonaktifkan fitur beta.

`--debug`  
Aktifkan pencatatan debug untuk mencetak pesan debug yang dihasilkan oleh AWS SAM CLI dan menampilkan stempel waktu.

`-h, --help`  
Menunjukkan pesan ini dan keluar.

## Contoh
<a name="ref-sam-cli-local-callback-heartbeat-examples"></a>

Kirim panggilan balik detak jantung:

```
$ sam local callback heartbeat my-callback-id
```

# sam local execution
<a name="sam-cli-command-reference-sam-local-execution"></a>

Halaman ini memberikan informasi referensi untuk AWS Serverless Application Model perintah Command Line Interface (AWS SAMCLI)`sam local execution`.

Untuk pengantar AWS SAMCLI, lihat [Apa itu AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

`sam local execution`Perintah ini memungkinkan Anda untuk mengelola dan memeriksa eksekusi fungsi lokal yang tahan lama selama pengembangan dan pengujian.

**catatan**  
Perintah ini mungkin tidak memerlukan akses ke AWS kredensi.

## Penggunaan
<a name="sam-cli-command-reference-sam-local-execution-usage"></a>

```
$ sam local execution <subcommand> <options>
```

## Opsi
<a name="sam-cli-command-reference-sam-local-execution-options"></a>

`--help, -h`  <a name="sam-cli-command-reference-sam-local-execution-options-help"></a>
Tampilkan pesan ini dan keluar.

## Subperintah
<a name="sam-cli-command-reference-sam-local-execution-subcommands"></a>

`get`  <a name="sam-cli-command-reference-sam-local-execution-subcommands-get"></a>
Dapatkan detail eksekusi fungsi yang tahan lama. Untuk informasi selengkapnya, lihat [sam local execution get](sam-cli-command-reference-sam-local-execution-get.md).

`history`  <a name="sam-cli-command-reference-sam-local-execution-subcommands-history"></a>
Dapatkan riwayat eksekusi eksekusi fungsi yang tahan lama. Untuk informasi selengkapnya, lihat [sam local execution history](sam-cli-command-reference-sam-local-execution-history.md).

`stop`  <a name="sam-cli-command-reference-sam-local-execution-subcommands-stop"></a>
Hentikan eksekusi fungsi yang tahan lama. Lihat informasi yang lebih lengkap di [sam local execution stop](sam-cli-command-reference-sam-local-execution-stop.md).

# sam local execution get
<a name="sam-cli-command-reference-sam-local-execution-get"></a>

Ambil detail eksekusi fungsi tahan lama tertentu.

**catatan**  
Perintah ini mungkin tidak memerlukan akses ke AWS kredensi.

## Penggunaan
<a name="ref-sam-cli-local-execution-get-usage"></a>

```
$ sam local execution get DURABLE_EXECUTION_ARN [OPTIONS]
```

## Argumen yang Diperlukan
<a name="ref-sam-cli-local-execution-get-arguments"></a>

`DURABLE_EXECUTION_ARN`  
Nama Sumber Daya Amazon (ARN) dari eksekusi fungsi tahan lama untuk mengambil detailnya.

## Opsi
<a name="ref-sam-cli-local-execution-get-options"></a>

`--format [summary|json]`  
Format keluaran. Default: `summary`

`--region TEXT`  
Atur AWS Wilayah layanan (misalnya,`us-east-1`).

`--profile TEXT`  
Pilih profil tertentu dari file kredensialmu untuk mendapatkan AWS kredensialnya.

`--config-env TEXT`  
Nama lingkungan menentukan nilai parameter default dalam file konfigurasi. Default: `default`

`--config-file TEXT`  
File konfigurasi yang berisi nilai parameter default. Default: `samconfig.toml`

`--save-params`  
Simpan parameter yang disediakan melalui baris perintah ke file konfigurasi.

`--beta-features / --no-beta-features`  
Aktifkan/Nonaktifkan fitur beta.

`--debug`  
Aktifkan pencatatan debug untuk mencetak pesan debug yang dihasilkan oleh AWS SAM CLI dan menampilkan stempel waktu.

`-h, --help`  
Menunjukkan pesan ini dan keluar.

## Contoh
<a name="ref-sam-cli-local-execution-get-examples"></a>

Dapatkan detail eksekusi dengan format ringkasan default:

```
$ sam local execution get arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id
```

Dapatkan detail eksekusi dalam format JSON:

```
$ sam local execution get arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id --format json
```

# sam local execution history
<a name="sam-cli-command-reference-sam-local-execution-history"></a>

Dapatkan riwayat eksekusi eksekusi fungsi yang tahan lama.

## Penggunaan
<a name="ref-sam-cli-local-execution-history-usage"></a>

```
$ sam local execution history EXECUTION_ID [OPTIONS]
```

## Argumen yang Diperlukan
<a name="ref-sam-cli-local-execution-history-arguments"></a>

`EXECUTION_ID`  
Pengidentifikasi unik dari eksekusi fungsi tahan lama untuk mengambil riwayat.

## Opsi
<a name="ref-sam-cli-local-execution-history-options"></a>

`--format [table|json]`  
Format keluaran. Default: `table`

`--region TEXT`  
Atur AWS Wilayah layanan (misalnya,`us-east-1`).

`--profile TEXT`  
Pilih profil tertentu dari file kredensialmu untuk mendapatkan AWS kredensialnya.

`--config-env TEXT`  
Nama lingkungan menentukan nilai parameter default dalam file konfigurasi. Default: `default`

`--config-file TEXT`  
File konfigurasi yang berisi nilai parameter default. Default: `samconfig.toml`

`--save-params`  
Simpan parameter yang disediakan melalui baris perintah ke file konfigurasi.

`--beta-features / --no-beta-features`  
Aktifkan/Nonaktifkan fitur beta.

`--debug`  
Aktifkan pencatatan debug untuk mencetak pesan debug yang dihasilkan oleh AWS SAM CLI dan menampilkan stempel waktu.

`-h, --help`  
Menunjukkan pesan ini dan keluar.

## Contoh
<a name="ref-sam-cli-local-execution-history-examples"></a>

Dapatkan riwayat eksekusi dalam format tabel:

```
$ sam local execution history my-execution-id
```

Dapatkan riwayat eksekusi dalam format JSON:

```
$ sam local execution history my-execution-id --format json
```

# sam local execution stop
<a name="sam-cli-command-reference-sam-local-execution-stop"></a>

Hentikan eksekusi fungsi tahan lama yang berjalan.

**catatan**  
Perintah ini mungkin tidak memerlukan akses ke AWS kredensional.

## Penggunaan
<a name="ref-sam-cli-local-execution-stop-usage"></a>

```
$ sam local execution stop DURABLE_EXECUTION_ARN [OPTIONS]
```

## Argumen yang Diperlukan
<a name="ref-sam-cli-local-execution-stop-arguments"></a>

`DURABLE_EXECUTION_ARN`  
Nama Sumber Daya Amazon (ARN) dari eksekusi fungsi tahan lama untuk berhenti.

## Opsi
<a name="ref-sam-cli-local-execution-stop-options"></a>

`--error-message TEXT`  
Pesan galat untuk dikaitkan dengan eksekusi yang dihentikan.

`--error-type TEXT`  
Jenis kesalahan untuk dikaitkan dengan eksekusi yang dihentikan.

`--error-data TEXT`  
Data kesalahan untuk dikaitkan dengan eksekusi yang dihentikan.

`--stack-trace TEXT`  
Tumpukan entri jejak. Opsi ini dapat ditentukan beberapa kali.

`--region TEXT`  
Atur AWS Wilayah layanan (misalnya,`us-east-1`).

`--profile TEXT`  
Pilih profil tertentu dari file kredensialmu untuk mendapatkan AWS kredensialnya.

`--config-env TEXT`  
Nama lingkungan menentukan nilai parameter default dalam file konfigurasi. Default: `default`

`--config-file TEXT`  
File konfigurasi yang berisi nilai parameter default. Default: `samconfig.toml`

`--save-params`  
Simpan parameter yang disediakan melalui baris perintah ke file konfigurasi.

`--beta-features / --no-beta-features`  
Aktifkan/Nonaktifkan fitur beta.

`--debug`  
Aktifkan pencatatan debug untuk mencetak pesan debug yang dihasilkan oleh AWS SAM CLI dan menampilkan stempel waktu.

`-h, --help`  
Menunjukkan pesan ini dan keluar.

## Contoh
<a name="ref-sam-cli-local-execution-stop-examples"></a>

Hentikan eksekusi tanpa detail kesalahan:

```
$ sam local execution stop arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id
```

Hentikan eksekusi dengan pesan kesalahan dan ketik:

```
$ sam local execution stop arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id --error-message "Execution cancelled" --error-type "UserCancellation"
```

Hentikan eksekusi dengan detail kesalahan lengkap dan jejak tumpukan:

```
$ sam local execution stop arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id --error-message "Task failed" --error-type "TaskFailure" --error-data '{"reason":"timeout"}' --stack-trace "at function1()" --stack-trace "at function2()"
```

# sam local generate-event
<a name="sam-cli-command-reference-sam-local-generate-event"></a>

Halaman ini memberikan informasi referensi untuk AWS Serverless Application Model `sam local generate-event` subperintah Command Line Interface (AWS SAMCLI).
+ Untuk pengantar AWS SAMCLI, lihat [Apa itu AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)
+ Untuk dokumentasi tentang penggunaan AWS SAMCLI `sam local generate-event` perintah, lihat[Pengantar pengujian dengan sam local generate-event](using-sam-cli-local-generate-event.md).

`sam local generate-event`Subperintah menghasilkan sampel payload peristiwa untuk didukung. Layanan AWS

## Penggunaan
<a name="ref-sam-cli-local-generate-event-usage"></a>

```
$ sam local generate-event <options> <service> <event> <event-options>
```

## Opsi
<a name="ref-sam-cli-local-generate-event-options"></a>

`--config-env TEXT`  <a name="ref-sam-cli-local-generate-event-options-config-env"></a>
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](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="ref-sam-cli-local-generate-event-options-config-file"></a>
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](serverless-sam-cli-config.md).

`--help`  <a name="ref-sam-cli-local-generate-event-options-help"></a>
Menunjukkan pesan ini dan keluar.

## Layanan
<a name="ref-sam-cli-local-generate-event-service"></a>

Untuk melihat daftar layanan yang didukung, jalankan yang berikut ini:

```
$ sam local generate-event
```

## Peristiwa
<a name="ref-sam-cli-local-generate-event-event"></a>

Untuk melihat daftar peristiwa yang didukung yang dapat dihasilkan untuk setiap layanan, jalankan yang berikut ini:

```
$ sam local generate-event <service>
```

## Opsi acara
<a name="ref-sam-cli-local-generate-event-event-options"></a>

Untuk melihat daftar opsi acara yang didukung yang dapat Anda ubah, jalankan yang berikut ini:

```
$ sam local generate-event <service> <event> --help
```

## Contoh
<a name="sam-cli-command-reference-sam-local-generate-event-examples"></a>

Untuk contoh tentang menggunakan `sam local generate-event` subperintah, lihat. [Hasilkan contoh acara](using-sam-cli-local-generate-event.md#using-sam-cli-local-generate-event-generate)

# sam local invoke
<a name="sam-cli-command-reference-sam-local-invoke"></a>

Halaman ini memberikan informasi referensi untuk AWS Serverless Application Model `sam local invoke` subperintah Command Line Interface (AWS SAMCLI).
+ Untuk pengantar AWS SAMCLI, lihat [Apa itu AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)
+ Untuk dokumentasi tentang penggunaan AWS SAMCLI `sam local invoke` subperintah, lihat[Pengantar pengujian dengan sam local invoke](using-sam-cli-local-invoke.md).

`sam local invoke`Subperintah memulai pemanggilan satu kali fungsi secara lokal. AWS Lambda 

**catatan**  
Tidak disarankan untuk menggunakan kemampuan pemanggilan lokal SAM CLI dalam kode yang tidak tepercaya. Untuk memiliki isolasi lengkap dari lingkungan lokal Anda, jalankan kode di layanan Lambda secara langsung.

**catatan**  
Untuk fungsi yang tahan lama, `sam local invoke` mendukung eksekusi stateful dengan checkpointing dan replay otomatis. Wadah tetap berjalan selama eksekusi fungsi tahan lama untuk menangani persistensi status dan dimulainya kembali.

## Penggunaan
<a name="ref-sam-cli-local-invoke-usage"></a>

```
$ 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.

## Argumen
<a name="ref-sam-cli-local-invoke-args"></a>

**ID Sumber Daya**  <a name="ref-sam-cli-local-invoke-args-resource-id"></a>
ID dari 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
<a name="ref-sam-cli-local-invoke-options"></a>

`--add-host LIST`  <a name="ref-sam-cli-local-invoke-options-add-host"></a>
Meneruskan nama host ke pemetaan alamat IP ke file host wadah Docker. Parameter ini dapat dilewatkan beberapa kali.  

**Example**  
Contoh: `--add-host example.com:127.0.0.1`

`--beta-features | --no-beta-features`  <a name="ref-sam-cli-local-invoke-options-beta-features"></a>
Izinkan atau tolak fitur beta.

`--config-env TEXT`  <a name="ref-sam-cli-local-invoke-options-config-env"></a>
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](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="ref-sam-cli-local-invoke-options-config-file"></a>
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](serverless-sam-cli-config.md).

`--container-env-vars`  <a name="ref-sam-cli-local-invoke-options-container-env-vars"></a>
(Opsional) Teruskan variabel lingkungan untuk kontainer citra fungsi Lambda ketika debugging lokal.

`--container-host TEXT`  <a name="ref-sam-cli-local-invoke-options-container-host"></a>
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`  <a name="ref-sam-cli-local-invoke-options-container-host-interface"></a>
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`  <a name="ref-sam-cli-local-invoke-options-debug"></a>
Mengaktifkan logging debug untuk mencetak pesan debug yang AWS SAMCLI dihasilkan, dan untuk menampilkan stempel waktu.

`--debug-args TEXT`  <a name="ref-sam-cli-local-invoke-options-debug-args"></a>
Argumen tambahan untuk meneruskan ke debugger.

`--debug-port, -d TEXT`  <a name="ref-sam-cli-local-invoke-options-debug-port"></a>
Ketika ditentukan, mulai kontainer fungsi Lambda dalam modus debug dan ekspos port ini pada host lokal.

`--debugger-path TEXT`  <a name="ref-sam-cli-local-invoke-options-debugger-path"></a>
Jalur host ke debugger yang dipasang ke kontainer Lambda.

`--docker-network TEXT`  <a name="ref-sam-cli-local-invoke-options-docker-network"></a>
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`  <a name="ref-sam-cli-local-invoke-options-docker-volume-basedir"></a>
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.

`--durable-execution-name TEXT`  <a name="ref-sam-cli-local-invoke-options-durable-execution-name"></a>
Nama untuk eksekusi yang tahan lama (hanya untuk fungsi tahan lama)

`--env-vars, -n PATH`  <a name="ref-sam-cli-local-invoke-options-env-vars"></a>
JSON atau `.env` file yang berisi nilai untuk variabel lingkungan fungsi Lambda. Format file terdeteksi secara otomatis. Untuk informasi selengkapnya tentang file variabel lingkungan, lihat [File variabel lingkungan](serverless-sam-cli-using-invoke.md#serverless-sam-cli-using-invoke-environment-file).

`--event, -e PATH`  <a name="ref-sam-cli-local-invoke-options-event"></a>
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](https://docs.aws.amazon.com/lambda/latest/dg/lambda-services.html) di *Panduan AWS Lambda Pengembang*.

`--force-image-build`  <a name="ref-sam-cli-local-invoke-options-force-image-build"></a>
Menentukan apakah AWS SAMCLI harus membangun kembali gambar yang digunakan untuk memanggil fungsi Lambda dengan lapisan.

`--help`  <a name="ref-sam-cli-local-invoke-options-help"></a>
Menunjukkan pesan ini dan keluar.

`--hook-name TEXT`  <a name="ref-sam-cli-local-invoke-options-hook-name"></a>
Nama hook yang digunakan untuk memperluas AWS SAMCLI fungsionalitas.  
Nilai yang diterima:`terraform`.

`--invoke-image TEXT`  <a name="ref-sam-cli-local-invoke-options-invoke-image"></a>
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 dalam[Repositori gambar untuk AWS SAM](serverless-image-repositories.md)). 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`  <a name="ref-sam-cli-local-invoke-options-layer-cache-basedir"></a>
Menentukan lokasi direktori dasar tempat layer yang digunakan templat Anda diunduh.

`--log-file, -l TEXT`  <a name="ref-sam-cli-local-invoke-options-log-file"></a>
Berkas log untuk mengirim log waktu aktif.

`--mount-symlinks`  <a name="ref-sam-cli-local-invoke-options-mount-symlinks"></a>
Memastikan symlink yang AWS SAMCLI selalu dipasang yang ada dalam file untuk dibangun atau dipanggil. Ini hanya berlaku untuk symlink di direktori tingkat atas (yaitu, symlink yang langsung berada di root fungsi). Secara default, symlink tidak dipasang kecuali yang diperlukan `build-in-source` untuk digunakan `node_modules` di NodeJS.

`--no-event`  <a name="ref-sam-cli-local-invoke-options-no-event"></a>
Memanggil fungsi dengan peristiwa kosong.

`--no-memory-limit`  <a name="ref-sam-cli-local-invoke-options-no-memory-limit"></a>
Menghapus batasan memori dalam wadah selama pemanggilan lokal, bahkan ketika memori dikonfigurasi dalam AWS SAM template.

`--parameter-overrides`  <a name="ref-sam-cli-local-invoke-options-parameter-overrides"></a>
String yang berisi penggantian CloudFormation parameter yang dikodekan sebagai pasangan kunci-nilai. Gunakan format yang sama dengan AWS Command Line Interface (AWS CLI). AWS SAMCLIFormatnya adalah kunci eksplisit dan kata kunci nilai, setiap penggantian dipisahkan oleh spasi. Berikut adalah dua contoh:  
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world`
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world ParameterKey=example1,ParameterValue=example2 ParameterKey=apple,ParameterValue=banana`

`--profile TEXT`  <a name="ref-sam-cli-local-invoke-options-profile"></a>
Profil spesifik dari file kredensyal Anda yang mendapat AWS kredensyal.

`--region TEXT`  <a name="ref-sam-cli-local-invoke-options-region"></a>
 AWS Wilayah untuk dikerahkan ke. Misalnya, us-east-1.

`--runtime TEXT`  <a name="ref-sam-cli-local-invoke-options-runtime"></a>
Menggunakan runtime yang ditentukan untuk menjalankan fungsi Lambda secara lokal. Ini mengesampingkan runtime yang ditentukan dalam file. `template.yml` Ini juga memungkinkan pengujian fungsi Lambda dengan runtime yang berbeda tanpa memodifikasi konfigurasi fungsi asli.

`--save-params`  <a name="ref-sam-cli-local-invoke-options-save-params"></a>
Simpan parameter yang Anda berikan pada baris perintah ke file AWS SAM konfigurasi.

`--shutdown`  <a name="ref-sam-cli-local-invoke-options-shutdown"></a>
Mengemulasi peristiwa shutdown setelah pemanggilan selesai, untuk menguji penanganan ekstensi perilaku shutdown.

`--skip-prepare-infra`  <a name="ref-sam-cli-local-invoke-options-skip-prepare-infra"></a>
Melewati tahap persiapan jika tidak ada perubahan infrastruktur yang dilakukan. Gunakan dengan `--hook-name` opsi.

`--skip-pull-image`  <a name="ref-sam-cli-local-invoke-options-skip-pull-image"></a>
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`  <a name="ref-sam-cli-local-invoke-options-template"></a>
File AWS SAM template.  
Opsi ini tidak kompatibel dengan`--hook-name`.  
Jika Anda menentukan opsi ini, hanya AWS SAM memuat template dan sumber daya lokal yang ditunjuknya.

`--tenant-id TEXT`  <a name="ref-sam-cli-local-invoke-options-tenancyconfig"></a>
ID penyewa untuk fungsi Lambda multi-penyewa. Digunakan untuk memastikan isolasi komputasi antara penyewa yang berbeda. Diperlukan saat menjalankan fungsi yang dikonfigurasi dengan mode isolasi penyewa.

`--terraform-plan-file`  <a name="ref-sam-cli-local-invoke-options-terraform-plan-file"></a>
Jalur relatif atau absolut ke file Terraform paket lokal Anda saat menggunakan AWS SAMCLI withTerraform Cloud. Opsi ini mengharuskan `--hook-name` diatur ke`terraform`.

## Contoh
<a name="sam-cli-command-reference-sam-local-invoke-examples"></a>

Contoh berikut menggunakan peristiwa yang dihasilkan untuk pengujian lokal dengan menggunakan `s3.json` acara untuk memanggil fungsi Lambda secara lokal

```
$ sam local invoke --event events/s3.json S3JsonLoggerFunction
```

Contoh berikut menguji fungsi ` HelloWorldFunction` menggunakan Python 3.11 runtime

```
$ sam local invoke --runtime python3.11 HelloWorldFunction
```

Contoh berikut menguji fungsi ` HelloWorldFunction` dengan nama eksekusi tahan lama

```
$ sam local invoke HelloWorldFunction --durable-execution-name my-execution
```

# sam local start-api
<a name="sam-cli-command-reference-sam-local-start-api"></a>

Halaman ini memberikan informasi referensi untuk AWS Serverless Application Model `sam local start-api` subperintah Command Line Interface (AWS SAMCLI).
+ Untuk pengantar AWS SAMCLI, lihat [Apa itu AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)
+ Untuk dokumentasi tentang penggunaan AWS SAMCLI `sam local start-api` subperintah, lihat[Pengantar pengujian dengan sam local start-api](using-sam-cli-local-start-api.md).

`sam local start-api`Subperintah menjalankan AWS Lambda fungsi Anda secara lokal untuk menguji melalui host server HTTP lokal.

## Penggunaan
<a name="ref-sam-cli-local-start-api-usage"></a>

```
$ sam local start-api <options>
```

## Opsi
<a name="ref-sam-cli-local-start-api-options"></a>

`--add-host LIST`  <a name="ref-sam-cli-local-start-api-options-add-host"></a>
Meneruskan nama host ke pemetaan alamat IP ke file host wadah Docker. Parameter ini dapat dilewatkan beberapa kali.  

**Example**  
Contoh: `--add-host example.com:127.0.0.1`

`--beta-features | --no-beta-features`  <a name="ref-sam-cli-local-start-api-options-beta-features"></a>
Izinkan atau tolak fitur beta.

`--config-env TEXT`  <a name="ref-sam-cli-local-start-api-options-config-env"></a>
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](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="ref-sam-cli-local-start-api-options-config-file"></a>
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](serverless-sam-cli-config.md).

`--container-env-vars`  <a name="ref-sam-cli-local-start-api-options-container-env-vars"></a>
Tidak wajib. Teruskan variabel lingkungan ke kontainer citra saat debugging lokal.

`--container-host TEXT`  <a name="ref-sam-cli-local-start-api-options-container-host"></a>
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`  <a name="ref-sam-cli-local-start-api-options-container-host-interface"></a>
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`  <a name="ref-sam-cli-local-start-api-options-debug"></a>
Mengaktifkan logging debug untuk mencetak pesan debug yang dihasilkan oleh AWS SAMCLI dan menampilkan stempel waktu.

`--debug-args TEXT`  <a name="ref-sam-cli-local-start-api-options-debug-args"></a>
Argumen tambahan untuk diteruskan ke debugger.

`--debug-function`  <a name="ref-sam-cli-local-start-api-options-debug-function"></a>
Tidak wajib. Menentukan fungsi Lambda untuk diberlakukan opsi debug ketika `--warm-containers` ditentukan. Parameter ini berlaku untuk `--debug-port`, `--debugger-path`, dan `--debug-args`.

`--debug-port, -d TEXT`  <a name="ref-sam-cli-local-start-api-options-debug-port"></a>
Ketika ditentukan, mulai kontainer fungsi Lambda dalam modus debug dan ekspos port ini pada host lokal.

`--debugger-path TEXT`  <a name="ref-sam-cli-local-start-api-options-debugger-path"></a>
Jalan host ke debugger yang akan dipasang ke kontainer Lambda.

`--docker-network TEXT`  <a name="ref-sam-cli-local-start-api-options-docker-network"></a>
Nama atau ID dari jaringan Docker yang ada tempat Lambda Docker terhubung, bersama dengan jaringan bridge default. Jika tidak ditentukan, kontainer Lambda hanya terhubung ke jaringan Docker bridge default.

` --docker-volume-basedir, -v TEXT`  <a name="ref-sam-cli-local-start-api-options-docker-volume-basedir"></a>
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`  <a name="ref-sam-cli-local-start-api-options-env-vars"></a>
JSON atau `.env` file yang berisi nilai untuk variabel lingkungan fungsi Lambda. Format file terdeteksi secara otomatis.

`--force-image-build`  <a name="ref-sam-cli-local-start-api-options-force-image-build"></a>
Menentukan apakah AWS SAM CLI harus membangun kembali gambar yang digunakan untuk memanggil fungsi dengan lapisan.

`--help`  <a name="ref-sam-cli-local-start-api-options-help"></a>
Menunjukkan pesan ini dan keluar.

`--hook-name TEXT`  <a name="ref-sam-cli-local-start-api-options-hook-name"></a>
Nama hook yang digunakan untuk memperluas AWS SAMCLI fungsionalitas.  
Nilai yang diterima:`terraform`.

`--host TEXT`  <a name="ref-sam-cli-local-start-api-options-host"></a>
Nama host lokal atau alamat IP untuk diikatkan (default: '127.0.0.1').

`--invoke-image TEXT`  <a name="ref-sam-cli-local-start-api-options-invoke-image"></a>
URI gambar kontainer yang ingin Anda gunakan untuk fungsi Lambda Anda. Secara default, AWS SAM tarik gambar kontainer dari Amazon ECR Public. Gunakan opsi ini untuk menarik citra dari lokasi lain.  
Anda dapat menentukan opsi ini beberapa kali. Setiap instans dari opsi ini dapat mengambil baik string atau pasangan kunci-nilai. Jika Anda menentukan string, itu adalah URI dari gambar kontainer yang akan digunakan untuk semua fungsi dalam aplikasi Anda. Misalnya, `sam local start-api --invoke-image public.ecr.aws/sam/emu-python3.8`. Jika Anda menentukan pasangan kunci-nilai, kuncinya adalah nama sumber daya, dan nilainya adalah URI citra kontainer untuk digunakan untuk sumber daya tersebut. Sebagai contoh, `sam local start-api --invoke-image public.ecr.aws/sam/emu-python3.8 --invoke-image Function1=amazon/aws-sam-cli-emulation-image-python3.8 `. Dengan pasangan kunci-nilai, Anda dapat menentukan citra kontainer yang berbeda untuk sumber daya yang berbeda.

`--layer-cache-basedir DIRECTORY`  <a name="ref-sam-cli-local-start-api-options-layer-cache-basedir"></a>
Menentukan lokasi basedir tempat Layer yang digunakan templat Anda terunduh.

`--log-file, -l TEXT`  <a name="ref-sam-cli-local-start-api-options-log-file"></a>
Berkas log untuk mengirim log waktu aktif.

`--no-memory-limit`  <a name="ref-sam-cli-local-start-api-options-no-memory-limit"></a>
Menghapus batasan memori dalam wadah selama pemanggilan lokal, bahkan ketika memori dikonfigurasi dalam AWS SAM template.

`--parameter-overrides`  <a name="ref-sam-cli-local-start-api-options-parameter-overrides"></a>
String yang berisi penggantian CloudFormation parameter yang dikodekan sebagai pasangan kunci-nilai. Gunakan format yang sama dengan AWS Command Line Interface (AWS CLI). AWS SAMCLIFormatnya adalah kunci eksplisit dan kata kunci nilai, setiap penggantian dipisahkan oleh spasi. Berikut adalah dua contoh:  
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world`
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world ParameterKey=example1,ParameterValue=example2 ParameterKey=apple,ParameterValue=banana`

`--port, -p INTEGER`  <a name="ref-sam-cli-local-start-api-options-port"></a>
Nomor port lokal untuk didengarkan (default: '3000').

`--profile TEXT`  <a name="ref-sam-cli-local-start-api-options-profile"></a>
Profil spesifik dari file kredensyal Anda yang mendapat AWS kredensyal.

`--region TEXT`  <a name="ref-sam-cli-local-start-api-options-region"></a>
 AWS Wilayah untuk dikerahkan ke. Misalnya, us-east-1.

`--save-params`  <a name="ref-sam-cli-local-start-api-options-save-params"></a>
Simpan parameter yang Anda berikan pada baris perintah ke file AWS SAM konfigurasi.

`--shutdown`  <a name="ref-sam-cli-local-start-api-options-shutdown"></a>
Mengemulasi peristiwa shutdown setelah pemanggilan selesai, untuk menguji penanganan ekstensi perilaku shutdown.

`--skip-prepare-infra`  <a name="ref-sam-cli-local-start-api-options-skip-prepare-infra"></a>
Melewati tahap persiapan jika tidak ada perubahan infrastruktur yang dilakukan. Gunakan dengan `--hook-name` opsi.

`--skip-pull-image`  <a name="ref-sam-cli-local-start-api-options-skip-pull-image"></a>
Menentukan apakah CLI harus melewatkan menarik ke bawah citra Docker terbaru untuk waktu aktif Lambda.

`--ssl-cert-file PATH`  <a name="ref-sam-cli-local-start-api-options-ssl-cert-file"></a>
Jalur ke file sertifikat SSL (default: Tidak ada). Saat menggunakan opsi ini, `--ssl-key-file` opsi juga harus digunakan.

`--ssl-key-file PATH`  <a name="ref-sam-cli-local-start-api-options-static-dir"></a>
Jalur ke file kunci SSL (default: Tidak ada). Saat menggunakan opsi ini, `--ssl-cert-file` opsi juga harus digunakan.

`--static-dir, -s TEXT`  <a name="ref-sam-cli-local-start-api-options-static-dir"></a>
Setiap aset statis (misalnya,CSS/JavaScript/HTML) file yang terletak di direktori ini disajikan di`/`.

`--template, -t PATH`  <a name="ref-sam-cli-local-start-api-options-template"></a>
File AWS SAM template.  
Jika Anda menentukan opsi ini, hanya AWS SAM memuat templat dan sumber daya lokal yang ditunjukkannya.

`--terraform-plan-file`  <a name="ref-sam-cli-local-start-api-options-terraform-plan-file"></a>
Jalur relatif atau absolut ke file Terraform paket lokal Anda saat menggunakan AWS SAMCLI withTerraform Cloud. Opsi ini mengharuskan `--hook-name` diatur ke`terraform`.

`--warm-containers [EAGER | LAZY]`  <a name="ref-sam-cli-local-start-api-options-warm-containers"></a>
Tidak wajib. Menentukan bagaimana AWS SAMCLI mengelola kontainer untuk setiap fungsi.  
Tersedia dua opsi:  
   `EAGER`: Kontainer untuk semua fungsi dimuat saat pertama dimulai dan terus ada di antara pemanggilan.  
   `LAZY`: Kontainer hanya dimuat ketika setiap fungsi pertama kali dipanggil. Kontainer tersebut terus ada untuk pemanggilan tambahan.

## Contoh
<a name="sam-cli-command-reference-sam-local-start-api-examples"></a>

Contoh berikut memulai server lokal, memungkinkan Anda untuk menguji aplikasi Anda melalui API. Agar perintah ini berfungsi, aplikasi harus diinstal dan Docker harus berjalan.

```
$ sam local start-api --port 3000
```

# sam local start-lambda
<a name="sam-cli-command-reference-sam-local-start-lambda"></a>

Halaman ini memberikan informasi referensi untuk AWS Serverless Application Model `sam local start-lambda` subperintah Command Line Interface (AWS SAMCLI).
+ Untuk pengantar AWS SAMCLI, lihat [Apa itu AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)
+ Untuk dokumentasi tentang penggunaan AWS SAMCLI `sam local start-lambda` subperintah, lihat[Pengantar pengujian dengan sam local start-lambda](using-sam-cli-local-start-lambda.md).

`sam local start-lambda`Subperintah memulai endpoint lokal untuk ditiru. AWS Lambda

## Penggunaan
<a name="ref-sam-cli-local-start-lambda-usage"></a>

```
$ sam local start-lambda <options>
```

## Opsi
<a name="ref-sam-cli-local-start-lambda-options"></a>

`--add-host LIST`  <a name="ref-sam-cli-local-start-lambda-options-add-host"></a>
Meneruskan nama host ke pemetaan alamat IP ke file host wadah Docker. Parameter ini dapat dilewatkan beberapa kali.  

**Example**  
Contoh: `--add-host example.com:127.0.0.1`

`--beta-features | --no-beta-features`  <a name="ref-sam-cli-local-start-lambda-options-beta-features"></a>
Izinkan atau tolak fitur beta.

`--config-env TEXT`  <a name="ref-sam-cli-local-start-lambda-options-config-env"></a>
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](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="ref-sam-cli-local-start-lambda-options-config-file"></a>
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](serverless-sam-cli-config.md).

`--container-env-vars`  <a name="ref-sam-cli-local-start-lambda-options-container-env-vars"></a>
Tidak wajib. Teruskan variabel lingkungan ke kontainer citra saat debugging lokal.

`--container-host TEXT`  <a name="ref-sam-cli-local-start-lambda-options-container-host"></a>
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`  <a name="ref-sam-cli-local-start-lambda-options-container-host-interface"></a>
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`  <a name="ref-sam-cli-local-start-lambda-options-debug"></a>
Mengaktifkan logging debug untuk mencetak pesan debug yang dihasilkan oleh AWS SAMCLI dan menampilkan stempel waktu.

`--debug-args TEXT`  <a name="ref-sam-cli-local-start-lambda-options-debug-args"></a>
Argumen tambahan untuk diteruskan ke debugger.

`--debug-function`  <a name="ref-sam-cli-local-start-lambda-options-debug-function"></a>
Tidak wajib. Menentukan fungsi Lambda untuk diberlakukan opsi debug ketika `--warm-containers` ditentukan. Parameter ini berlaku untuk `--debug-port`, `--debugger-path`, dan `--debug-args`.

`--debug-port, -d TEXT`  <a name="ref-sam-cli-local-start-lambda-options-debug-port"></a>
Ketika ditentukan, mulai kontainer fungsi Lambda dalam modus debug, dan ekspos port ini pada host lokal.

`--debugger-path TEXT`  <a name="ref-sam-cli-local-start-lambda-options-debugger-path"></a>
Jalur host ke debugger yang akan dipasang ke dalam kontainer Lambda.

`--docker-network TEXT`  <a name="ref-sam-cli-local-start-lambda-options-docker-network"></a>
Nama atau ID jaringan Docker yang ada tempat Lambda Docker kontainer harus terhubung, bersama dengan jaringan bridge default. Jika ini ditentukan, kontainer Lambda hanya terhubung ke jaringan Docker bridge default.

`--docker-volume-basedir, -v TEXT`  <a name="ref-sam-cli-local-start-lambda-options-docker-volume-basedir"></a>
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`  <a name="ref-sam-cli-local-start-lambda-options-env-vars"></a>
JSON atau `.env` file yang berisi nilai untuk variabel lingkungan fungsi Lambda. Format file terdeteksi secara otomatis.

`--force-image-build`  <a name="ref-sam-cli-local-start-lambda-options-force-image-build"></a>
Tentukan apakah CLI harus membangun kembali gambar yang digunakan untuk menjalankan fungsi dengan lapisan.

`--help`  <a name="ref-sam-cli-local-start-lambda-options-help"></a>
Menunjukkan pesan ini dan keluar.

`--hook-name TEXT`  <a name="ref-sam-cli-local-start-lambda-options-hook-name"></a>
Nama hook yang digunakan untuk memperluas AWS SAMCLI fungsionalitas.  
Nilai yang diterima:`terraform`.

`--host TEXT`  <a name="ref-sam-cli-local-start-lambda-options-host"></a>
Nama host lokal atau alamat IP untuk diikatkan (default: '127.0.0.1').

`--invoke-image TEXT`  <a name="ref-sam-cli-local-start-lambda-options-invoke-image"></a>
URI dari gambar kontainer yang ingin Anda gunakan untuk pemanggilan fungsi lokal. Secara default, AWS SAM tarik gambar kontainer dari Amazon ECR Public. Gunakan opsi ini untuk menarik citra dari lokasi lain.  
Misalnya, `sam local start-lambda MyFunction --invoke-image amazon/aws-sam-cli-emulation-image-python3.8`.

`--layer-cache-basedir DIRECTORY`  <a name="ref-sam-cli-local-start-lambda-options-layer-cache-basedir"></a>
Menentukan lokasi basedir tempat layer yang digunakan templat Anda terunduh.

`--log-file, -l TEXT`  <a name="ref-sam-cli-local-start-lambda-options-log-file"></a>
Berkas log untuk mengirim log waktu aktif.

`--no-memory-limit`  <a name="ref-sam-cli-local-start-lambda-options-no-memory-limit"></a>
Menghapus batasan memori dalam wadah selama pemanggilan lokal, bahkan ketika memori dikonfigurasi dalam AWS SAM template.

`--parameter-overrides`  <a name="ref-sam-cli-local-start-lambda-options-parameter-overrides"></a>
String yang berisi penggantian CloudFormation parameter yang dikodekan sebagai pasangan kunci-nilai. Gunakan format yang sama dengan AWS Command Line Interface (AWS CLI). AWS SAMCLIFormatnya adalah kunci eksplisit dan kata kunci nilai, setiap penggantian dipisahkan oleh spasi. Berikut adalah dua contoh:  
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world`
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world ParameterKey=example1,ParameterValue=example2 ParameterKey=apple,ParameterValue=banana`

`--port, -p INTEGER`  <a name="ref-sam-cli-local-start-lambda-options-port"></a>
Nomor port lokal untuk didengarkan (default: '3001').

`--profile TEXT`  <a name="ref-sam-cli-local-start-lambda-options-profile"></a>
Profil spesifik dari file kredensyal Anda yang mendapat AWS kredensyal.

`--region TEXT`  <a name="ref-sam-cli-local-start-lambda-options-region"></a>
 AWS Wilayah untuk dikerahkan ke. Misalnya, us-east-1.

`--save-params`  <a name="ref-sam-cli-local-start-lambda-options-save-params"></a>
Simpan parameter yang Anda berikan pada baris perintah ke file AWS SAM konfigurasi.

`--shutdown`  <a name="ref-sam-cli-local-start-lambda-options-shutdown"></a>
Mengemulasi peristiwa shutdown setelah pemanggilan selesai, untuk menguji penanganan ekstensi perilaku shutdown.

`--skip-prepare-infra`  <a name="ref-sam-cli-local-start-lambda-options-skip-prepare-infra"></a>
Melewati tahap persiapan jika tidak ada perubahan infrastruktur yang dilakukan. Gunakan dengan `--hook-name` opsi.

`--skip-pull-image`  <a name="ref-sam-cli-local-start-lambda-options-skip-pull-image"></a>
Menentukan apakah CLI harus melewatkan menarik gambar Docker terbaru untuk runtime Lambda.

`--template, -t PATH`  <a name="ref-sam-cli-local-start-lambda-options-template"></a>
File AWS SAM template.  
Jika Anda menentukan opsi ini, hanya AWS SAM memuat template dan sumber daya lokal yang ditunjuknya. Opsi ini tidak kompatibel dengan`--hook-name`.

`--terraform-plan-file`  <a name="ref-sam-cli-local-start-lambda-options-terraform-plan-file"></a>
Jalur relatif atau absolut ke file Terraform paket lokal Anda saat menggunakan AWS SAMCLI withTerraform Cloud. Opsi ini mengharuskan `--hook-name` diatur ke`terraform`.

`--warm-containers [EAGER | LAZY]`  <a name="ref-sam-cli-local-start-lambda-options-warm-containers"></a>
Tidak wajib. Menentukan bagaimana AWS SAMCLI mengelola kontainer untuk setiap fungsi.  
Tersedia dua opsi:  
+ `EAGER`: Kontainer untuk semua fungsi dimuat saat pertama dimulai dan terus ada di antara pemanggilan.
+ `LAZY`: Kontainer hanya dimuat ketika setiap fungsi pertama kali dipanggil. Kontainer tersebut terus ada untuk pemanggilan tambahan.

## Contoh
<a name="sam-cli-command-reference-sam-local-start-lambda-examples"></a>

Untuk contoh terperinci dan panduan mendalam tentang penggunaan `sam local start-lambda` subperintah, lihat. [Pengantar pengujian dengan sam local start-lambda](using-sam-cli-local-start-lambda.md)

# sam logs
<a name="sam-cli-command-reference-sam-logs"></a>

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

Untuk pengantar AWS SAMCLI, lihat [Apa itu AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

`sam logs`Perintah mengambil log yang dihasilkan oleh AWS Lambda fungsi Anda.

## Penggunaan
<a name="sam-cli-command-reference-sam-logs-usage"></a>

```
$ sam logs <options>
```

## Opsi
<a name="sam-cli-command-reference-sam-logs-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-logs-options-config-env"></a>
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](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-logs-options-config-file"></a>
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](serverless-sam-cli-config.md).

`--cw-log-group LIST`  <a name="sam-cli-command-reference-sam-logs-options-cw-log-group"></a>
Termasuk log dari grup CloudWatch log Log yang Anda tentukan. Jika Anda menentukan opsi ini bersama dengan`name`, AWS SAM termasuk log dari grup log yang ditentukan selain log dari sumber daya bernama.

`--debug`  <a name="sam-cli-command-reference-sam-logs-options-debug"></a>
Mengaktifkan logging debug untuk mencetak pesan debug yang dihasilkan oleh AWS SAMCLI dan menampilkan stempel waktu.

`---end-time, e TEXT`  <a name="sam-cli-command-reference-sam-logs-options-end-time"></a>
Mengambil log sampai saat ini. Waktu dapat berupa nilai-nilai relatif seperti '5 menit yang lalu', 'besok', atau stempel waktu yang diformat seperti '01-01-2018 10.10.10'.

`--filter TEXT`  <a name="sam-cli-command-reference-sam-logs-options-filter"></a>
Memungkinkan Anda menentukan ekspresi untuk menemukan log yang cocok dengan istilah, frasa, atau nilai-nilai dalam peristiwa log Anda dengan cepat. Ini bisa berupa kata kunci sederhana (misalnya, “error”) atau pola yang didukung oleh Amazon CloudWatch Logs. Untuk sintaksnya, lihat [dokumentasi Amazon CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/FilterAndPatternSyntax.html).

`--help`  <a name="sam-cli-command-reference-sam-logs-options-help"></a>
Menunjukkan pesan ini dan keluar.

`--include-traces`  <a name="sam-cli-command-reference-sam-logs-options-include-traces"></a>
Termasuk jejak X-Ray dalam output log.

`--name, -n TEXT`  <a name="sam-cli-command-reference-sam-logs-options-name"></a>
Nama sumber daya untuk mengambil log. Jika sumber daya ini adalah bagian dari CloudFormation tumpukan, ini bisa menjadi ID logis dari sumber daya fungsi di AWS SAM template CloudFormation/. Beberapa nama dapat diberikan dengan mengulangi parameter lagi. Jika sumber daya berada dalam tumpukan bersarang, nama dapat ditambahkan dengan nama nama tumpukan bersarang untuk menarik log dari sumber daya tersebut (/). NestedStackLogicalId ResourceLogicalId Jika nama sumber daya tidak diberikan, tumpukan yang diberikan akan dipindai dan informasi log akan ditarik untuk semua sumber daya yang didukung. Jika Anda tidak menentukan opsi ini, AWS SAM mengambil log untuk semua sumber daya di tumpukan yang Anda tentukan. Jenis sumber daya berikut didukung:  
+ `AWS::Serverless::Function`
+ `AWS::Lambda::Function`
+ `AWS::Serverless::Api`
+ `AWS::ApiGateway::RestApi`
+ `AWS::Serverless::HttpApi`
+ `AWS::ApiGatewayV2::Api`
+ `AWS::Serverless::StateMachine`
+ `AWS::StepFunctions::StateMachine`

`--output TEXT`  <a name="sam-cli-command-reference-sam-logs-options-output"></a>
Menentukan format output untuk log. Untuk mencetak log yang diformat, tentukan`text`. Untuk mencetak log sebagai JSON, tentukan`json`.

`--profile TEXT`  <a name="sam-cli-command-reference-sam-logs-options-profile"></a>
Profil spesifik dari file kredensialmu yang mendapat AWS kredensialnya.

`--region TEXT`  <a name="sam-cli-command-reference-sam-logs-options-region"></a>
 AWS Wilayah untuk dikerahkan ke. Misalnya, us-east-1.

`--save-params`  <a name="sam-cli-command-reference-sam-logs-options-save-params"></a>
Simpan parameter yang Anda berikan pada baris perintah ke file AWS SAM konfigurasi.

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-logs-options-stack-name"></a>
Nama CloudFormation tumpukan yang merupakan bagian dari sumber daya.

`--start-time, -s TEXT`  <a name="sam-cli-command-reference-sam-logs-options-start-time"></a>
Mengambil log mulai saat ini. Waktu dapat berupa nilai-nilai relatif seperti '5 menit lalu', 'kemarin', atau stempel waktu yang diformat seperti '01-01-2018 10.10.10'. Default ke '10 menit yang lalu'.

` --tail, -t`  <a name="sam-cli-command-reference-sam-logs-options-tail"></a>
Mengikuti output log. Ini mengabaikan argumen waktu akhir dan terus mengambil log setelah log tersedia.

## Contoh
<a name="sam-cli-command-reference-sam-logs-examples"></a>

Ketika fungsi Anda adalah bagian dari CloudFormation tumpukan, Anda dapat mengambil log dengan menggunakan ID logis fungsi saat Anda menentukan nama tumpukan.

```
$ sam logs -n HelloWorldFunction --stack-name myStack
```

Lihat log untuk rentang waktu tertentu menggunakan opsi -s (--start-time) dan -e (--end-time).

```
$ sam logs -n HelloWorldFunction --stack-name myStack -s '10min ago' -e '2min ago'
```

Anda juga dapat menambahkan `--tail` opsi untuk menunggu log baru dan melihatnya saat mereka tiba.

```
$ sam logs -n HelloWorldFunction --stack-name myStack --tail
```

Gunakan `--filter` opsi untuk menemukan log yang cocok dengan istilah, frasa, atau nilai dengan cepat dalam peristiwa log Anda.

```
$ sam logs -n HelloWorldFunction --stack-name myStack --filter "error"
```

Lihat log untuk sumber daya di tumpukan anak.

```
$ sam logs --stack-name myStack -n childStack/HelloWorldFunction
```

Log ekor untuk semua sumber daya yang didukung dalam aplikasi Anda.

```
$ sam logs --stack-name sam-app --tail
```

Ambil log untuk fungsi Lambda tertentu dan API Gateway API di aplikasi Anda.

```
$ sam logs --stack-name sam-app --name HelloWorldFunction --name HelloWorldRestApi
```

Ambil log untuk semua sumber daya yang didukung dalam aplikasi Anda, dan juga dari grup log yang ditentukan.

```
$ sam logs --cw-log-group /aws/lambda/myfunction-123 --cw-log-group /aws/lambda/myfunction-456
```

# sam package
<a name="sam-cli-command-reference-sam-package"></a>

 AWS Serverless Application Model Command Line Interface (AWS SAM CLI) mengemas AWS SAM aplikasi.

Perintah ini membuat `.zip` file kode dan dependensi Anda, dan mengunggah file ke Amazon Simple Storage Service (Amazon S3). AWS SAM memungkinkan enkripsi untuk semua file yang disimpan di Amazon S3. Kemudian mengembalikan salinan AWS SAM template Anda, menggantikan referensi ke artefak lokal dengan lokasi Amazon S3 tempat perintah mengunggah artefak.

Secara default ketika Anda menggunakan perintah ini, AWS SAMCLI mengasumsikan bahwa direktori kerja Anda saat ini adalah direktori root proyek Anda. Yang AWS SAMCLI pertama mencoba menemukan file template yang dibangun menggunakan [sam build](sam-cli-command-reference-sam-build.md) perintah, yang terletak di `.aws-sam` subfolder, dan diberi nama`template.yaml`. Selanjutnya, AWS SAMCLI mencoba untuk menemukan file template bernama `template.yaml` atau `template.yml` di direktori kerja saat ini. Jika Anda menentukan `--template` opsi, AWS SAMCLI perilaku default diganti, dan hanya akan mengemas AWS SAM templat itu dan sumber daya lokal yang ditunjuknya.

**catatan**  
[sam deploy](sam-cli-command-reference-sam-deploy.md) sekarang secara implisit melakukan fungsionalitas dari `sam package`. Anda dapat menggunakan perintah [sam deploy](sam-cli-command-reference-sam-deploy.md) langsung ke paket dan men-deploy aplikasi Anda.

## Penggunaan
<a name="sam-cli-command-reference-sam-package-usage"></a>

```
$ sam package <arguments> <options>
```

## Pendapat
<a name="sam-cli-command-reference-sam-package-args"></a>

**ID Sumber Daya**  <a name="sam-cli-command-reference-sam-package-args-resource-id"></a>
ID fungsi Lambda ke paket.  
Argumen ini opsional. Jika aplikasi Anda berisi satu fungsi Lambda, AWS SAM CLI akan mengemasnya. Jika aplikasi Anda berisi beberapa fungsi, berikan ID fungsi untuk mengemas satu fungsi.  
*Nilai yang valid*: ID logis sumber daya atau ARN sumber daya.

## Opsi
<a name="sam-cli-command-reference-sam-package-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-package-options-config-env"></a>
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](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-package-options-config-file"></a>
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](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-package-options-debug"></a>
Mengaktifkan logging debug untuk mencetak pesan debug yang dihasilkan oleh AWS SAMCLI dan menampilkan stempel waktu.

`--force-upload`  <a name="sam-cli-command-reference-sam-package-options-force-upload"></a>
Membatalkan file yang ada di bucket Amazon S3. Tentukan bendera ini untuk mengunggah artefak bahkan jika artefak tersebut cocok dengan artefak yang ada di bucket Amazon S3.

`--help`  <a name="sam-cli-command-reference-sam-package-options-help"></a>
Menunjukkan pesan ini dan keluar.

`--image-repository TEXT`  <a name="sam-cli-command-reference-sam-package-options-image-repository"></a>
URI repositori Amazon Elastic Container Registry (Amazon ECR) tempat perintah ini mengunggah citra fungsi Anda. Diperlukan untuk fungsi dideklarasikan dengan tipe paket `Image`.

`--kms-key-id TEXT`  <a name="sam-cli-command-reference-sam-package-options-kms-key-id"></a>
ID kunci AWS Key Management Service (AWS KMS) yang digunakan untuk mengenkripsi artefak yang diam di bucket Amazon S3. Jika opsi ini tidak ditentukan, maka AWS SAM gunakan kunci enkripsi yang dikelola Amazon S3.

`--metadata`  <a name="sam-cli-command-reference-sam-package-options-metadata"></a>
(Opsional) Peta metadata yang akan dilampirkan ke semua artefak yang direferensikan dalam templat Anda.

`--no-progressbar`  <a name="sam-cli-command-reference-sam-package-options-no-progressbar"></a>
Jangan tampilkan baris progres saat mengunggah artefak ke Amazon S3.

`--output-template-file PATH`  <a name="sam-cli-command-reference-sam-package-options-output-template-file"></a>
Jalur ke file tempat perintah menulis templat terkemas. Jika Anda tidak menentukan jalur, perintah menulis templat ke output standar.

`--profile TEXT`  <a name="sam-cli-command-reference-sam-package-options-profile"></a>
Profil spesifik dari file kredensialmu yang mendapat AWS kredensialnya.

`--region TEXT`  <a name="sam-cli-command-reference-sam-package-options-region"></a>
 AWS Wilayah untuk disebarkan. Misalnya, us-east-1.

`--resolve-s3`  <a name="sam-cli-command-reference-sam-package-options-resolve-s3"></a>
Buat bucket Amazon S3 secara otomatis untuk digunakan untuk pengemasan. Jika Anda menentukan `--resolve-s3` opsi `--s3-bucket` dan opsi, maka kesalahan akan terjadi.

`--s3-bucket TEXT`  <a name="sam-cli-command-reference-sam-package-options-s3-bucket"></a>
Nama bucket Amazon S3 tempat perintah ini mengunggah artefak Anda. Jika artefak Anda lebih besar dari 51.200 byte, maka opsi `--s3-bucket` atau opsi diperlukan. `--resolve-s3` Jika Anda menentukan `--resolve-s3` opsi `--s3-bucket` dan opsi, maka kesalahan akan terjadi.

`--s3-prefix TEXT`  <a name="sam-cli-command-reference-sam-package-options-s3-prefix"></a>
Prefiks yang ditambahkan ke nama artefak diunggah ke bucket Amazon S3. Nama prefiks adalah nama jalur (nama folder) untuk bucket Amazon S3. Ini hanya berlaku untuk fungsi yang dilaporkan dengan tipe paket `Zip`.

`--save-params`  <a name="sam-cli-command-reference-sam-package-options-save-params"></a>
Simpan parameter yang Anda berikan pada baris perintah ke file AWS SAM konfigurasi.

`--signing-profiles LIST`  <a name="sam-cli-command-reference-sam-package-options-signing-profiles"></a>
(Opsional) Daftar profil penandatanganan untuk menandatangani paket deployment Anda. Parameter ini mengambil daftar pasangan kunci-nilai, dengan penjeasan kunci adalah nama fungsi atau lapisan untuk menandatangani, dan nilai adalah profil penandatanganan, dengan pemilik profil opsional yang terbatasi `:`. Misalnya, `FunctionNameToSign=SigningProfileName1 LayerNameToSign=SigningProfileName2:SigningProfileOwner`.

`--template-file, --template, -t PATH`  <a name="sam-cli-command-reference-sam-package-options-template-file"></a>
Path dan nama file tempat AWS SAM template Anda berada.  
Jika Anda menentukan opsi ini, AWS SAM paket hanya template dan sumber daya lokal yang ditunjuknya.

`--use-json`  <a name="sam-cli-command-reference-sam-package-options-use-json"></a>
Output JSON untuk CloudFormation template. YAML digunakan secara default.

## Contoh
<a name="sam-cli-command-reference-sam-package-examples"></a>

Contoh berikut membuat dan mengemas artefak untuk fungsi CodeDeploy dan aplikasi Lambda. Artefak diunggah ke bucket Amazon S3. Output dari perintah adalah file baru bernama`package.yml`.

```
$ sam package \
  --template-file template.yml \
  --output-template-file package.yml \
  --s3-bucket amzn-s3-demo-bucket
```

# sam pipeline bootstrap
<a name="sam-cli-command-reference-sam-pipeline-bootstrap"></a>

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

Untuk pengantar AWS SAMCLI, lihat [Apa itu AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

`sam pipeline bootstrap`Subperintah menghasilkan sumber daya AWS infrastruktur yang diperlukan untuk terhubung ke sistem CI/CD Anda. Langkah ini harus dijalankan untuk setiap tahap penerapan di pipeline Anda sebelum menjalankan **sam pipeline init** perintah.

Subperintah ini menyiapkan sumber daya AWS infrastruktur berikut:
+ Opsi untuk mengonfigurasi izin pipa melalui:
  + Pengguna IAM pipeline dengan ID kunci akses dan kredenal akses kunci rahasia untuk dibagikan dengan sistem. CI/CD 
**catatan**  
Kami merekomendasikan memutar kunci akses secara teratur. Untuk informasi selengkapnya, lihat [Memutar kunci akses secara teratur untuk kasus penggunaan yang memerlukan kredensil jangka panjang](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#rotate-credentials) di Panduan Pengguna *IAM*.
  +  CI/CD Platform yang didukung melalui OIDC. Untuk pengenalan tentang penggunaan OIDC dengan AWS SAM pipeline, buka. [Cara menggunakan otentikasi OIDC dengan pipeline AWS SAM](deploying-with-oidc.md)
+ Peran CloudFormation eksekusi IAM diasumsikan oleh CloudFormation untuk menyebarkan aplikasi. AWS SAM 
+ Ember Amazon S3 untuk menampung artefak. AWS SAM 
+ Opsional, repositori citra Amazon ECR untuk menahan paket deployment Lambda citra kontainer (jika Anda memiliki sumber daya dari tipe paket `Image`).

## Penggunaan
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-usage"></a>

```
$ sam pipeline bootstrap <options>
```

## Opsi
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-options"></a>

`--bitbucket-repo-uuid TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-bitbucket-repo-uuid"></a>
 UUID dari repositori Bitbucket. Opsi ini khusus untuk menggunakan Bitbucket OIDC untuk izin.  
Nilai ini dapat ditemukan di https://bitbucket.org/*workspace*/*repository*/admin/addon/admin/pipelines/openid-connect 

`--bucket TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-bucket"></a>
ARN dari ember Amazon S3 yang menampung artefak. AWS SAM 

`--cicd-provider TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-cicd-provider"></a>
 CI/CD Platform untuk AWS SAM pipa.

`--cloudformation-execution-role TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-cloudformation-execution-role"></a>
ARN dari peran IAM yang akan diasumsikan oleh CloudFormation saat menerapkan tumpukan aplikasi. Berikan hanya jika Anda ingin menggunakan peran Anda sendiri. Jika tidak, perintah akan membuat peran baru.

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-config-env"></a>
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](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-config-file"></a>
Path 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](serverless-sam-cli-config.md).

`--confirm-changeset | --no-confirm-changeset`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-confirm-changeset"></a>
Prompt untuk mengonfirmasi penyebaran sumber daya Anda.

`--create-image-repository | --no-create-image-repository`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-create-image-repository"></a>
Tentukan apakah akan membuat repositori citra Amazon ECR jika tidak ada yang disediakan. Repositori Amazon ECR menyimpan gambar kontainer fungsi Lambda, atau lapisan yang memiliki jenis paket. `Image` Nilai default-nya `--no-create-image-repository`.

`--debug`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-debug"></a>
Mengaktifkan logging debug dan mencetak pesan debug yang AWS SAMCLI dihasilkan, dan untuk menampilkan stempel waktu.

`--deployment-branch TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-deployment-branch"></a>
Nama cabang tempat penerapan akan terjadi. Opsi ini khusus untuk menggunakan GitHub Actions OIDC untuk izin.

`--github-org TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-github-org"></a>
 GitHub Organisasi tempat repositori milik. Jika tidak ada organisasi, masukkan nama pengguna pemilik repositori. Opsi ini khusus untuk menggunakan GitHub Actions OIDC untuk izin.

`--github-repo TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-github-repo"></a>
Nama GitHub repositori tempat penerapan akan terjadi. Opsi ini khusus untuk menggunakan GitHub Actions OIDC untuk izin.

`--gitlab-group TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-gitlab-group"></a>
 GitLab Grup tempat repositori milik. Opsi ini khusus untuk menggunakan GitLab OIDC untuk izin.

`--gitlab-project TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-gitlab-project"></a>
Nama GitLab proyek. Opsi ini khusus untuk menggunakan GitLab OIDC untuk izin.

`--help, -h`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-help"></a>
Menunjukkan pesan ini dan keluar.

`--image-repository TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-image-repository"></a>
ARN dari repositori gambar Amazon ECR yang menyimpan gambar kontainer fungsi Lambda, atau lapisan yang memiliki jenis paket. `Image` Jika tersedia, opsi `--create-image-repository` diabaikan. Jika tidak disediakan dan `--create-image-repository` ditentukan, perintah membuat satu.

`--interactive | --no-interactive`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-interactive"></a>
Nonaktifkan prompt interaktif untuk parameter bootstrap dan gagal jika ada parameter yang diperlukan yang hilang. Nilai default-nya adalah `--interactive`. Untuk perintah ini, `--stage` adalah satu-satunya parameter yang diperlukan.  
Jika `--no-interactive` ditentukan bersama dengan`--use-oidc-provider`, semua parameter yang diperlukan untuk penyedia OIDC Anda harus disertakan.

`--oidc-client-id TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-oidc-client-id"></a>
ID klien dikonfigurasi untuk digunakan dengan penyedia OIDC Anda.

`--oidc-provider [github-actions | gitlab | bitbucket-pipelines]`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-oidc-provider"></a>
Nama CI/CD penyedia yang akan digunakan untuk izin OIDC. GitLab, GitHub, dan Bitbucket didukung.

`--oidc-provider-url TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-oidc-provider-url"></a>
URL untuk penyedia OIDC. Nilai harus dimulai dengan**https://**.

`--permissions-provider [oidc | iam]`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-permissions-provider"></a>
Pilih penyedia izin untuk mengambil peran eksekusi pipeline. Nilai default-nya adalah **iam**.

`--pipeline-execution-role TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-pipeline-execution-role"></a>
ARN IAM role yang akan diterima oleh pengguna alur untuk beroperasi pada tahap ini. Berikan hanya jika Anda ingin menggunakan peran Anda sendiri. Jika tidak disediakan, perintah ini akan membuat peran baru.

`--pipeline-user TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-pipeline-user"></a>
Nama Sumber Daya Amazon (ARN) dari pengguna IAM memiliki ID kunci akses dan kunci akses rahasia yang dibagikan dengan sistem. CI/CD Ini digunakan untuk memberikan izin pengguna IAM ini untuk mengakses AWS akun yang sesuai. Jika tidak disediakan, perintah akan membuat pengguna IAM bersama dengan ID kunci akses dan kredenal kunci akses rahasia.

`--profile TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-profile"></a>
Profil spesifik dari file kredensialmu yang mendapat AWS kredensialnya.

`--region TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-region"></a>
 AWS Wilayah untuk dikerahkan ke. Misalnya, `us-east-1`.

`--save-params`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-save-params"></a>
Simpan parameter yang Anda berikan pada baris perintah ke file AWS SAM konfigurasi.

`--stage TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-stage"></a>
Nama tahap deployment yang sesuai. Ini digunakan sebagai akhiran untuk sumber daya AWS infrastruktur yang dibuat.

## Pemecahan masalah
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-troubleshooting"></a>

### Kesalahan: Parameter yang diperlukan tidak ada
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-troubleshooting-example1"></a>

Kapan `--no-interactive` ditentukan bersama dengan `--use-oidc-provider` dan salah satu parameter yang diperlukan tidak disediakan, pesan kesalahan ini akan ditampilkan bersama dengan deskripsi parameter yang hilang.

## Contoh
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-examples"></a>

Contoh berikut membuat AWS sumber daya yang diperlukan untuk membuat CI/CD sistem Anda, dan mengaktifkan pencatatan debug dan mencetak pesan debug yang dihasilkan oleh AWS SAMCLI: menggunakan peristiwa yang dihasilkan untuk pengujian lokal dengan menggunakan `s3.json` peristiwa untuk menjalankan fungsi Lambda secara lokal

```
$ sam pipeline bootstrap --debug
```

# sam pipeline init
<a name="sam-cli-command-reference-sam-pipeline-init"></a>

Halaman ini memberikan informasi referensi untuk AWS Serverless Application Model `sam pipeline init` subperintah Command Line Interface (AWS SAMCLI).

Untuk pengantar AWS SAMCLI, lihat [Apa itu AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

`sam pipeline init`Subperintah menghasilkan file konfigurasi pipeline yang dapat digunakan CI/CD sistem Anda untuk menyebarkan aplikasi tanpa server. AWS SAM

Sebelum menggunakan **sam pipeline init**, Anda harus mem-bootstrap sumber daya yang diperlukan untuk setiap tahap dalam alur Anda. Anda dapat melakukan ini dengan menjalankan **sam pipeline init --bootstrap** untuk dipandu melalui proses penyiapan dan pembuatan file konfigurasi, atau merujuk ke sumber daya yang telah Anda buat sebelumnya dengan perintah **sam pipeline bootstrap**.

## Penggunaan
<a name="sam-cli-command-reference-sam-pipeline-init-usage"></a>

```
$ sam pipeline init <options>
```

## Opsi
<a name="sam-cli-command-reference-sam-pipeline-init-options"></a>

`--bootstrap`  <a name="sam-cli-command-reference-sam-pipeline-init-options-bootstrap"></a>
Aktifkan mode interaktif yang memandu pengguna melalui pembuatan sumber daya AWS infrastruktur yang diperlukan.

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-pipeline-init-options-config-env"></a>
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](serverless-sam-cli-config.md).

`--config-file TEXT`  <a name="sam-cli-command-reference-sam-pipeline-init-options-config-file"></a>
Jalur dan nama file dari file konfigurasi yang berisi nilai parameter default yang akan digunakan. Nilai default-nya adalah `samconfig.toml` dalam direktori root proyek. Untuk informasi selengkapnya tentang file konfigurasi, lihat [AWS SAMCLIberkas konfigurasi](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-pipeline-init-options-debug"></a>
Mengaktifkan logging debug untuk mencetak pesan debug yang AWS SAMCLI dihasilkan, dan untuk menampilkan stempel waktu.

`--help, -h`  <a name="sam-cli-command-reference-sam-pipeline-init-options-help"></a>
Menunjukkan pesan ini dan keluar.

`--save-params`  <a name="sam-cli-command-reference-sam-pipeline-init-options-save-params"></a>
Simpan parameter yang Anda berikan pada baris perintah ke file AWS SAM konfigurasi.

## Contoh
<a name="sam-cli-command-reference-sam-pipeline-init-examples"></a>

Contoh berikut menunjukkan kepada Anda cara menggunakan `--bootstrap` opsi untuk memungkinkan Anda menelusuri mode interaktif yang memandu Anda melalui pembuatan sumber daya AWS infrastruktur yang diperlukan:

```
$ sam pipeline init --bootstrap
```

# sam publish
<a name="sam-cli-command-reference-sam-publish"></a>

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

Untuk pengantar AWS SAMCLI, lihat [Apa itu AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

`sam publish`Perintah menerbitkan AWS SAM aplikasi ke file. AWS Serverless Application Repository Perintah ini mengambil AWS SAM template yang dikemas dan menerbitkan aplikasi ke Wilayah yang ditentukan AWS .

`sam publish`Perintah mengharapkan AWS SAM template untuk menyertakan `Metadata` bagian yang berisi metadata aplikasi yang diperlukan untuk penerbitan. Di bagian `Metadata`, properti `LicenseUrl` dan `ReadmeUrl` harus merujuk ke bucket Amazon Simple Storage Service (Amazon S3), bukan file lokal. Untuk informasi selengkapnya tentang `Metadata` bagian AWS SAM templat, lihat[Menerbitkan aplikasi Anda dengan AWS SAMCLI](serverless-sam-template-publishing-applications.md).

Secara default, `sam publish` membuat aplikasi sebagai privat. Sebelum akun AWS lainnya diizinkan untuk melihat dan men-deploy aplikasi Anda, Anda harus membaginya. Untuk informasi tentang berbagi aplikasi, lihat [Contoh Kebijakan Berbasis Sumber Daya AWS Serverless Application Repository](https://docs.aws.amazon.com/serverlessrepo/latest/devguide/security_iam_resource-based-policy-examples.html) di *Panduan Developer AWS Serverless Application Repository *.

**catatan**  
Saat ini `sam publish` tidak mendukung penerbitan aplikasi yang di-nest yang ditentukan secara lokal. Jika aplikasi Anda berisi aplikasi bersarang, Anda harus mempublikasikannya secara terpisah ke AWS Serverless Application Repository sebelum memublikasikan aplikasi induk Anda.

## Penggunaan
<a name="sam-cli-command-reference-sam-publish-usage"></a>

```
$ sam publish <options>
```

## Opsi
<a name="sam-cli-command-reference-sam-publish-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-publish-options-config-env"></a>
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](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-publish-options-config-file"></a>
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](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-publish-options-debug"></a>
Menghidupkan logging debug untuk mencetak pesan debug yang AWS SAMCLI dihasilkan, dan untuk menampilkan stempel waktu.

`--help`  <a name="sam-cli-command-reference-sam-publish-options-help"></a>
Menunjukkan pesan ini dan keluar.

`--profile TEXT`  <a name="sam-cli-command-reference-sam-publish-options-profile"></a>
Profil spesifik dari file kredensialmu yang mendapat AWS kredensialnya.

`--region TEXT`  <a name="sam-cli-command-reference-sam-publish-options-region"></a>
 AWS Wilayah untuk disebarkan. Misalnya, us-east-1.

`--save-params`  <a name="sam-cli-command-reference-sam-publish-options-save-params"></a>
Simpan parameter yang Anda berikan pada baris perintah ke file AWS SAM konfigurasi.

`--semantic-version TEXT`  <a name="sam-cli-command-reference-sam-publish-options-semantic-version"></a>
(Opsional) Gunakan opsi ini untuk menyediakan versi semantik aplikasi Anda yang membatalkan properti `SemanticVersion` di bagian `Metadata` dari file templat. Untuk informasi selengkapnya tentang versioning semantik, lihat [Spesifikasi Versioning semantik](https://semver.org/).

`--template, -t PATH`  <a name="sam-cli-command-reference-sam-publish-options-template"></a>
Jalur file AWS SAM template`[default: template.[yaml|yml]]`.

## Contoh
<a name="sam-cli-command-reference-sam-publish-examples"></a>

Untuk mempublikasikan aplikasi:

```
$ sam publish --template packaged.yaml --region us-east-1
```

# sam remote callback
<a name="sam-cli-command-reference-sam-remote-callback"></a>

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

Untuk pengantar AWS SAMCLI, lihat [Apa itu AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

`sam remote callback`Perintah ini memungkinkan Anda mengirim callback ke eksekusi fungsi tahan lama jarak jauh yang berjalan di Lambda AWS .

**catatan**  
Perintah ini memerlukan akses ke AWS kredensial.

## Penggunaan
<a name="sam-cli-command-reference-sam-remote-callback-usage"></a>

```
$ sam remote callback <subcommand> <options>
```

## Opsi
<a name="sam-cli-command-reference-sam-remote-callback-options"></a>

`--help, -h`  <a name="sam-cli-command-reference-sam-remote-callback-options-help"></a>
Tampilkan pesan ini dan keluar.

## Subperintah
<a name="sam-cli-command-reference-sam-remote-callback-subcommands"></a>

`succeed`  <a name="sam-cli-command-reference-sam-remote-callback-subcommands-succeed"></a>
Kirim keberhasilan callback ke eksekusi fungsi tahan lama jarak jauh. Untuk informasi selengkapnya, lihat [sam remote callback succeed](sam-cli-command-reference-sam-remote-callback-succeed.md).

`fail`  <a name="sam-cli-command-reference-sam-remote-callback-subcommands-fail"></a>
Kirim kegagalan callback ke eksekusi fungsi tahan lama jarak jauh. Untuk informasi selengkapnya, lihat [sam remote callback fail](sam-cli-command-reference-sam-remote-callback-fail.md).

`heartbeat`  <a name="sam-cli-command-reference-sam-remote-callback-subcommands-heartbeat"></a>
Kirim detak jantung callback ke eksekusi fungsi tahan lama jarak jauh. Lihat informasi yang lebih lengkap di [sam remote callback heartbeat](sam-cli-command-reference-sam-remote-callback-heartbeat.md).

# sam remote callback succeed
<a name="sam-cli-command-reference-sam-remote-callback-succeed"></a>

Kirim keberhasilan callback ke eksekusi fungsi tahan lama jarak jauh.

**catatan**  
Perintah ini membutuhkan akses ke AWS kredensi.

## Penggunaan
<a name="ref-sam-cli-remote-callback-succeed-usage"></a>

```
$ sam remote callback succeed CALLBACK_ID [OPTIONS]
```

## Argumen yang Diperlukan
<a name="ref-sam-cli-remote-callback-succeed-arguments"></a>

`CALLBACK_ID`  
Pengenal unik callback untuk mengirim respons sukses ke.

## Opsi
<a name="ref-sam-cli-remote-callback-succeed-options"></a>

`-r, --result TEXT`  
Sukses hasil payload sebagai string.

`--region TEXT`  
Atur AWS Wilayah layanan (misalnya,`us-east-1`).

`--profile TEXT`  
Pilih profil tertentu dari file kredensialmu untuk mendapatkan AWS kredensialnya.

`--config-env TEXT`  
Nama lingkungan menentukan nilai parameter default dalam file konfigurasi. Default: `default`

`--config-file TEXT`  
File konfigurasi yang berisi nilai parameter default. Default: `samconfig.toml`

`--save-params`  
Simpan parameter yang disediakan melalui baris perintah ke file konfigurasi.

`--beta-features / --no-beta-features`  
Aktifkan/Nonaktifkan fitur beta.

`--debug`  
Aktifkan pencatatan debug untuk mencetak pesan debug yang dihasilkan oleh AWS SAM CLI dan menampilkan stempel waktu.

`-h, --help`  
Menunjukkan pesan ini dan keluar.

## Contoh
<a name="ref-sam-cli-remote-callback-succeed-examples"></a>

Kirim callback sukses tanpa hasil:

```
$ sam remote callback succeed my-callback-id
```

Kirim callback sukses dengan hasil:

```
$ sam remote callback succeed my-callback-id --result 'Task completed successfully'
```

# sam remote callback fail
<a name="sam-cli-command-reference-sam-remote-callback-fail"></a>

Kirim kegagalan callback ke eksekusi fungsi tahan lama jarak jauh.

**catatan**  
Perintah ini membutuhkan akses ke AWS kredensional.

## Penggunaan
<a name="ref-sam-cli-remote-callback-fail-usage"></a>

```
$ sam remote callback fail CALLBACK_ID [OPTIONS]
```

## Argumen yang Diperlukan
<a name="ref-sam-cli-remote-callback-fail-arguments"></a>

`CALLBACK_ID`  
Pengenal unik callback untuk mengirim respons kegagalan.

## Opsi
<a name="ref-sam-cli-remote-callback-fail-options"></a>

`--error-data TEXT`  
Data kesalahan tambahan.

`--stack-trace TEXT`  
Tumpukan entri jejak. Opsi ini dapat ditentukan beberapa kali.

`--error-type TEXT`  
Jenis kesalahan.

`--error-message TEXT`  
Pesan kesalahan terperinci.

`--region TEXT`  
Atur AWS Wilayah layanan (misalnya,`us-east-1`).

`--profile TEXT`  
Pilih profil tertentu dari file kredensi Anda untuk mendapatkan AWS kredensional.

`--config-env TEXT`  
Nama lingkungan menentukan nilai parameter default dalam file konfigurasi. Default: `default`

`--config-file TEXT`  
File konfigurasi yang berisi nilai parameter default. Default: `samconfig.toml`

`--save-params`  
Simpan parameter yang disediakan melalui baris perintah ke file konfigurasi.

`--beta-features / --no-beta-features`  
Aktifkan/Nonaktifkan fitur beta.

`--debug`  
Aktifkan pencatatan debug untuk mencetak pesan debug yang dihasilkan oleh AWS SAM CLI dan menampilkan stempel waktu.

`-h, --help`  
Menunjukkan pesan ini dan keluar.

## Contoh
<a name="ref-sam-cli-remote-callback-fail-examples"></a>

Kirim panggilan balik kegagalan tanpa parameter:

```
$ sam remote callback fail my-callback-id
```

Kirim panggilan balik kegagalan dengan pesan kesalahan:

```
$ sam remote callback fail my-callback-id --error-message 'Task failed'
```

Kirim panggilan balik kegagalan dengan semua parameter:

```
$ sam remote callback fail my-callback-id --error-message 'Task failed' --error-type 'ValidationError' --stack-trace 'at line 42' --error-data '{"code": 500}'
```

# sam remote callback heartbeat
<a name="sam-cli-command-reference-sam-remote-callback-heartbeat"></a>

Kirim detak jantung callback ke eksekusi fungsi tahan lama jarak jauh.

**catatan**  
Perintah ini membutuhkan akses ke AWS kredensi.

## Penggunaan
<a name="ref-sam-cli-remote-callback-heartbeat-usage"></a>

```
$ sam remote callback heartbeat CALLBACK_ID [OPTIONS]
```

## Argumen yang Diperlukan
<a name="ref-sam-cli-remote-callback-heartbeat-arguments"></a>

`CALLBACK_ID`  
Pengenal unik panggilan balik untuk mengirim detak jantung ke.

## Opsi
<a name="ref-sam-cli-remote-callback-heartbeat-options"></a>

`--region TEXT`  
Atur AWS Wilayah layanan (misalnya,`us-east-1`).

`--profile TEXT`  
Pilih profil tertentu dari file kredensialmu untuk mendapatkan AWS kredensialnya.

`--config-env TEXT`  
Nama lingkungan menentukan nilai parameter default dalam file konfigurasi. Default: `default`

`--config-file TEXT`  
File konfigurasi yang berisi nilai parameter default. Default: `samconfig.toml`

`--save-params`  
Simpan parameter yang disediakan melalui baris perintah ke file konfigurasi.

`--beta-features / --no-beta-features`  
Aktifkan/Nonaktifkan fitur beta.

`--debug`  
Aktifkan pencatatan debug untuk mencetak pesan debug yang dihasilkan oleh AWS SAM CLI dan menampilkan stempel waktu.

`-h, --help`  
Menunjukkan pesan ini dan keluar.

## Contoh
<a name="ref-sam-cli-remote-callback-heartbeat-examples"></a>

Kirim panggilan balik detak jantung:

```
$ sam remote callback heartbeat my-callback-id
```

# sam remote execution
<a name="sam-cli-command-reference-sam-remote-execution"></a>

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

Untuk pengantar AWS SAMCLI, lihat [Apa itu AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

`sam remote execution`Perintah ini memungkinkan Anda untuk mengelola dan memeriksa eksekusi fungsi tahan lama jarak jauh yang berjalan di Lambda AWS .

**catatan**  
Perintah ini memerlukan akses ke AWS kredensial.

## Penggunaan
<a name="sam-cli-command-reference-sam-remote-execution-usage"></a>

```
$ sam remote execution <subcommand> <options>
```

## Opsi
<a name="sam-cli-command-reference-sam-remote-execution-options"></a>

`--help, -h`  <a name="sam-cli-command-reference-sam-remote-execution-options-help"></a>
Tampilkan pesan ini dan keluar.

## Subperintah
<a name="sam-cli-command-reference-sam-remote-execution-subcommands"></a>

`get`  <a name="sam-cli-command-reference-sam-remote-execution-subcommands-get"></a>
Dapatkan detail eksekusi yang tahan lama. Untuk informasi selengkapnya, lihat [sam remote execution get](sam-cli-command-reference-sam-remote-execution-get.md).

`history`  <a name="sam-cli-command-reference-sam-remote-execution-subcommands-history"></a>
Dapatkan riwayat eksekusi eksekusi fungsi yang tahan lama. Untuk informasi selengkapnya, lihat [sam remote execution history](sam-cli-command-reference-sam-remote-execution-history.md).

`stop`  <a name="sam-cli-command-reference-sam-remote-execution-subcommands-stop"></a>
Hentikan eksekusi fungsi yang tahan lama. Lihat informasi yang lebih lengkap di [sam remote execution stop](sam-cli-command-reference-sam-remote-execution-stop.md).

# sam remote execution get
<a name="sam-cli-command-reference-sam-remote-execution-get"></a>

Ambil detail eksekusi fungsi tahan lama tertentu dari AWS Lambda.

ARN eksekusi harus dalam format yang dikembalikan oleh Invoke atau ditemukan di log eksekusi.

**catatan**  
Perintah ini membutuhkan akses ke AWS kredensi.

## Penggunaan
<a name="ref-sam-cli-remote-execution-get-usage"></a>

```
$ sam remote execution get DURABLE_EXECUTION_ARN [OPTIONS]
```

## Argumen yang Diperlukan
<a name="ref-sam-cli-remote-execution-get-arguments"></a>

`DURABLE_EXECUTION_ARN`  
Nama Sumber Daya Amazon (ARN) dari eksekusi fungsi tahan lama untuk mengambil detailnya.

## Opsi
<a name="ref-sam-cli-remote-execution-get-options"></a>

`--format [summary|json]`  
Format keluaran. Default: `summary`

`--region TEXT`  
Atur AWS Wilayah layanan (misalnya,`us-east-1`).

`--profile TEXT`  
Pilih profil tertentu dari file kredensialmu untuk mendapatkan AWS kredensialnya.

`--config-env TEXT`  
Nama lingkungan menentukan nilai parameter default dalam file konfigurasi. Default: `default`

`--config-file TEXT`  
File konfigurasi yang berisi nilai parameter default. Default: `samconfig.toml`

`--save-params`  
Simpan parameter yang disediakan melalui baris perintah ke file konfigurasi.

`--beta-features / --no-beta-features`  
Aktifkan/Nonaktifkan fitur beta.

`--debug`  
Aktifkan pencatatan debug untuk mencetak pesan debug yang dihasilkan oleh AWS SAM CLI dan menampilkan stempel waktu.

`-h, --help`  
Menunjukkan pesan ini dan keluar.

## Contoh
<a name="ref-sam-cli-remote-execution-get-examples"></a>

Dapatkan detail eksekusi dengan format ringkasan default:

```
$ sam remote execution get 'arn:aws:lambda:us-east-1:123456789012:function:my-function:$LATEST/durable-execution/c63eec67-3415-4eb4-a495-116aa3a86278/1d454231-a3ad-3694-aa03-c917c175db55'
```

Dapatkan detail eksekusi dalam format JSON:

```
$ sam remote execution get 'arn:aws:lambda:us-east-1:123456789012:function:my-function:$LATEST/durable-execution/c63eec67-3415-4eb4-a495-116aa3a86278/1d454231-a3ad-3694-aa03-c917c175db55' --format json
```

**catatan**  
Anda harus memastikan bahwa karakter kontrol dalam eksekusi ARN seperti `$` lolos dengan benar saat menggunakan perintah shell.

# sam remote execution history
<a name="sam-cli-command-reference-sam-remote-execution-history"></a>

Ambil riwayat eksekusi eksekusi fungsi tahan lama tertentu dari AWS Lambda.

Eksekusi ARN harus dalam format yang dikembalikan oleh StartDurableExecution atau ditemukan di log eksekusi.

**catatan**  
Perintah ini membutuhkan akses ke AWS kredensi.

## Penggunaan
<a name="ref-sam-cli-remote-execution-history-usage"></a>

```
$ sam remote execution history DURABLE_EXECUTION_ARN [OPTIONS]
```

## Argumen yang Diperlukan
<a name="ref-sam-cli-remote-execution-history-arguments"></a>

`DURABLE_EXECUTION_ARN`  
Nama Sumber Daya Amazon (ARN) dari eksekusi fungsi tahan lama untuk mengambil riwayat.

## Opsi
<a name="ref-sam-cli-remote-execution-history-options"></a>

`--format [table|json]`  
Format keluaran. Default: `table`

`--region TEXT`  
Atur AWS Wilayah layanan (misalnya,`us-east-1`).

`--profile TEXT`  
Pilih profil tertentu dari file kredensialmu untuk mendapatkan AWS kredensialnya.

`--config-env TEXT`  
Nama lingkungan menentukan nilai parameter default dalam file konfigurasi. Default: `default`

`--config-file TEXT`  
File konfigurasi yang berisi nilai parameter default. Default: `samconfig.toml`

`--save-params`  
Simpan parameter yang disediakan melalui baris perintah ke file konfigurasi.

`--beta-features / --no-beta-features`  
Aktifkan/Nonaktifkan fitur beta.

`--debug`  
Aktifkan pencatatan debug untuk mencetak pesan debug yang dihasilkan oleh AWS SAM CLI dan menampilkan stempel waktu.

`-h, --help`  
Menunjukkan pesan ini dan keluar.

## Contoh
<a name="ref-sam-cli-remote-execution-history-examples"></a>

Dapatkan riwayat eksekusi dengan format tabel default:

```
$ sam remote execution history arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id
```

Dapatkan riwayat eksekusi dalam format JSON:

```
$ sam remote execution history arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id --format json
```

# sam remote execution stop
<a name="sam-cli-command-reference-sam-remote-execution-stop"></a>

Hentikan eksekusi fungsi tahan lama yang berjalan di AWS Lambda.

Eksekusi ARN harus dalam format yang dikembalikan oleh StartDurableExecution atau ditemukan di log eksekusi.

**catatan**  
Perintah ini membutuhkan akses ke AWS kredensional.

## Penggunaan
<a name="ref-sam-cli-remote-execution-stop-usage"></a>

```
$ sam remote execution stop DURABLE_EXECUTION_ARN [OPTIONS]
```

## Argumen yang Diperlukan
<a name="ref-sam-cli-remote-execution-stop-arguments"></a>

`DURABLE_EXECUTION_ARN`  
Nama Sumber Daya Amazon (ARN) dari eksekusi fungsi tahan lama untuk berhenti.

## Opsi
<a name="ref-sam-cli-remote-execution-stop-options"></a>

`--error-message TEXT`  
Pesan galat untuk dikaitkan dengan eksekusi yang dihentikan.

`--error-type TEXT`  
Jenis kesalahan untuk dikaitkan dengan eksekusi yang dihentikan.

`--error-data TEXT`  
Data kesalahan untuk dikaitkan dengan eksekusi yang dihentikan.

`--stack-trace TEXT`  
Tumpukan entri jejak. Opsi ini dapat ditentukan beberapa kali.

`--region TEXT`  
Atur AWS Wilayah layanan (misalnya,`us-east-1`).

`--profile TEXT`  
Pilih profil tertentu dari file kredensialmu untuk mendapatkan AWS kredensialnya.

`--config-env TEXT`  
Nama lingkungan menentukan nilai parameter default dalam file konfigurasi. Default: `default`

`--config-file TEXT`  
File konfigurasi yang berisi nilai parameter default. Default: `samconfig.toml`

`--save-params`  
Simpan parameter yang disediakan melalui baris perintah ke file konfigurasi.

`--beta-features / --no-beta-features`  
Aktifkan/Nonaktifkan fitur beta.

`--debug`  
Aktifkan pencatatan debug untuk mencetak pesan debug yang dihasilkan oleh AWS SAM CLI dan menampilkan stempel waktu.

`-h, --help`  
Menunjukkan pesan ini dan keluar.

## Contoh
<a name="ref-sam-cli-remote-execution-stop-examples"></a>

Hentikan eksekusi tanpa detail kesalahan:

```
$ sam remote execution stop arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id
```

Hentikan eksekusi dengan pesan kesalahan dan ketik:

```
$ sam remote execution stop arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id --error-message "Execution cancelled" --error-type "UserCancellation"
```

Hentikan eksekusi dengan detail kesalahan lengkap dan jejak tumpukan:

```
$ sam remote execution stop arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id --error-message "Task failed" --error-type "TaskFailure" --error-data '{"reason":"timeout"}' --stack-trace "at function1()" --stack-trace "at function2()"
```

# sam remote invoke
<a name="sam-cli-command-reference-remote-invoke"></a>

Halaman ini memberikan informasi referensi untuk AWS Serverless Application Model perintah Command Line Interface (AWS SAMCLI)`sam remote invoke`.
+ Untuk pengantar AWS SAMCLI, lihat [Apa itu AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)
+ Untuk dokumentasi tentang penggunaan AWS SAMCLI `sam remote invoke` perintah, lihat[Pengantar pengujian di cloud dengan sam remote invoke](using-sam-cli-remote-invoke.md).

`sam remote invoke`Perintah memanggil sumber daya yang didukung di file. AWS Cloud

## Penggunaan
<a name="sam-cli-command-reference-remote-invoke-usage"></a>

```
$ sam remote invoke <arguments> <options>
```

## Pendapat
<a name="sam-cli-command-reference-remote-invoke-args"></a>

**ID Sumber Daya**  <a name="sam-cli-command-reference-remote-invoke-args-resource-id"></a>
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 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 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 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

   1. Step Functions

   1. Amazon SQS

   1. Kinesis Data Streams

1. 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
<a name="sam-cli-command-reference-remote-invoke-options"></a>

`--beta-features | --no-beta-features`  <a name="sam-cli-command-reference-remote-invoke-options-beta-features"></a>
Izinkan atau tolak fitur beta.

`--config-env TEXT`  <a name="sam-cli-command-reference-remote-invoke-options-config-env"></a>
Tentukan lingkungan yang akan digunakan dari file AWS SAMCLI konfigurasi Anda.  
*Default*: `default`

`--config-file FILENAME`  <a name="sam-cli-command-reference-remote-invoke-options-config-file"></a>
Tentukan jalur dan nama file file konfigurasi Anda.  
Untuk informasi selengkapnya tentang file konfigurasi, lihat [Mengkonfigurasi AWS SAMCLI](using-sam-cli-configure.md).  
*Default*: `samconfig.toml` di root direktori proyek Anda. 

`--debug`  <a name="sam-cli-command-reference-remote-invoke-options-debug"></a>
Aktifkan logging debug. Ini mencetak pesan debug dan stempel waktu yang dihasilkan oleh file. AWS SAMCLI

`--event, -e TEXT`  <a name="sam-cli-command-reference-remote-invoke-options-event"></a>
Acara untuk dikirim ke sumber daya target.

`--event-file FILENAME`  <a name="sam-cli-command-reference-remote-invoke-options-event-file"></a>
Path ke file yang berisi acara untuk dikirim ke sumber daya target.

`--help, -h`  <a name="sam-cli-command-reference-remote-invoke-options-help"></a>
Tampilkan pesan bantuan dan keluar.

`--output [ text | json ]`  <a name="sam-cli-command-reference-remote-invoke-options-output"></a>
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`  <a name="sam-cli-command-reference-remote-invoke-options-parameter"></a>
[https://boto3.amazonaws.com/v1/documentation/api/latest/index.html](https://boto3.amazonaws.com/v1/documentation/api/latest/index.html)Parameter tambahan yang dapat Anda berikan ke sumber daya yang dipanggil.    
**Amazon Kinesis Data Streams**  <a name="sam-cli-command-reference-remote-invoke-options-parameter-kinesis"></a>
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\$1RECORD](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/kinesis/client/put_record.html).  
**AWS Lambda**  <a name="sam-cli-command-reference-remote-invoke-options-parameter-lambda"></a>
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](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/lambda/client/invoke.html)
+ [Lambda dengan streaming respons - Lambda.client.invoke\$1with\$1response\$1stream](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/lambda/client/invoke_with_response_stream.html)  
**Amazon Simple Queue Service (Amazon SQS)**  <a name="sam-cli-command-reference-remote-invoke-options-parameter-sqs"></a>
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\$1message](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sqs/client/send_message.html).  
**AWS Step Functions**  <a name="sam-cli-command-reference-remote-invoke-options-parameter-sf"></a>
Parameter tambahan berikut dapat digunakan untuk memulai eksekusi mesin negara:  
+ `name='string'`
+ `traceHeader='string'`
Untuk deskripsi setiap parameter, lihat [SFN.Client.START\$1EXECUTION](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/stepfunctions/client/start_execution.html).

`--profile TEXT`  <a name="sam-cli-command-reference-remote-invoke-options-profile"></a>
Profil spesifik dari file kredensialmu untuk mendapatkan AWS kredensialnya.

`--region TEXT`  <a name="sam-cli-command-reference-remote-invoke-options-region"></a>
 Wilayah AWS Sumber daya. Misalnya, `us-east-1`.

`--stack-name TEXT`  <a name="sam-cli-command-reference-remote-invoke-options-stack-name"></a>
Nama CloudFormation tumpukan sumber daya milik.

`--tenant-id TEXT`  <a name="ref-sam-cli-local-invoke-options-tenancyconfig"></a>
ID penyewa untuk fungsi Lambda multi-penyewa. Digunakan untuk memastikan isolasi komputasi antara penyewa yang berbeda. Diperlukan saat menjalankan fungsi yang dikonfigurasi dengan mode isolasi penyewa.

`--test-event-name NAME`  <a name="sam-cli-command-reference-remote-invoke-options-test-event-name"></a>
Nama acara pengujian yang dapat dibagikan untuk diteruskan ke fungsi Lambda Anda.  
Opsi ini hanya mendukung fungsi Lambda.

## Contoh
<a name="sam-cli-command-reference-remote-invoke-examples"></a>

Contoh berikut memanggil resource yang didukung di AWS Cloud dan mengaktifkan logging debug, yang mencetak pesan debug dan stempel waktu yang dihasilkan oleh: AWS SAMCLI

```
$ sam remote invoke--debug
```

# sam remote test-event
<a name="sam-cli-command-reference-remote-test-event"></a>

Halaman ini memberikan informasi referensi untuk AWS Serverless Application Model perintah Command Line Interface (AWS SAMCLI)`sam remote test-event`.
+ Untuk pengantar AWS SAMCLI, lihat [Apa itu AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)
+ Untuk dokumentasi tentang penggunaan AWS SAMCLI `sam remote test-event` perintah, lihat[Pengantar pengujian cloud dengan sam remote test-event](using-sam-cli-remote-test-event.md).

`sam remote test-event`Perintah berinteraksi dengan peristiwa pengujian yang dapat dibagikan di registri EventBridge skema Amazon.

## Penggunaan
<a name="sam-cli-command-reference-remote-test-event-usage"></a>

```
$ sam remote test-event <options> <subcommand>
```

## Opsi
<a name="sam-cli-command-reference-remote-test-event-options"></a>

`--help, -h`  <a name="sam-cli-command-reference-remote-invoke-options-help"></a>
Tampilkan pesan bantuan dan keluar.

## Subperintah
<a name="sam-cli-command-reference-remote-test-event-subcommands"></a>

`delete`  
Hapus peristiwa pengujian yang dapat dibagikan dari registri EventBridge skema. Untuk informasi referensi lebih lanjut, lihat[sam remote test-event delete](sam-cli-command-reference-remote-test-event-delete.md).

`get`  
Dapatkan acara pengujian yang dapat dibagikan dari registri EventBridge skema. Untuk informasi referensi lebih lanjut, lihat[sam remote test-event get](sam-cli-command-reference-remote-test-event-get.md).

`list`  
Buat daftar peristiwa pengujian yang dapat dibagikan untuk suatu AWS Lambda fungsi. Untuk informasi referensi lebih lanjut, lihat[sam remote test-event list](sam-cli-command-reference-remote-test-event-list.md).

`put`  
Simpan acara dari file lokal ke registri EventBridge skema. Untuk informasi referensi lebih lanjut, lihat[sam remote test-event put](sam-cli-command-reference-remote-test-event-put.md).

# sam remote test-event delete
<a name="sam-cli-command-reference-remote-test-event-delete"></a>

Halaman ini memberikan informasi referensi untuk AWS Serverless Application Model `sam remote test-event delete` subperintah Command Line Interface (AWS SAMCLI).
+ Untuk pengantar AWS SAMCLI, lihat [Apa itu AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)
+ Untuk dokumentasi tentang penggunaan AWS SAMCLI `sam remote test-event` perintah, lihat[Pengantar pengujian cloud dengan sam remote test-event](using-sam-cli-remote-test-event.md).

`sam remote test-event delete`Subperintah menghapus peristiwa pengujian yang dapat dibagikan dari registri skema Amazon EventBridge .

## Penggunaan
<a name="sam-cli-command-reference-remote-test-event-delete-usage"></a>

```
$ sam remote test-event delete <arguments> <options>
```

## Pendapat
<a name="sam-cli-command-reference-remote-test-event-delete-args"></a>

**ID Sumber Daya**  <a name="sam-cli-command-reference-remote-test-event-delete-args-resource-id"></a>
ID AWS Lambda fungsi yang terkait dengan peristiwa pengujian yang dapat dibagikan.  
Jika Anda memberikan ID logis, Anda juga harus memberikan nilai untuk AWS CloudFormation tumpukan yang terkait dengan fungsi Lambda menggunakan opsi. `--stack-name`  
*Nilai yang valid*: ID logis sumber daya atau sumber dayaARN.

## Opsi
<a name="sam-cli-command-reference-remote-test-event-delete-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-remote-test-event-delete-options-config-env"></a>
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](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-remote-test-event-delete-options-config-file"></a>
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](serverless-sam-cli-config.md).

`--help, -h`  <a name="sam-cli-command-reference-remote-test-event-delete-options-help"></a>
Tampilkan pesan bantuan dan keluar.

`--name TEXT`  <a name="sam-cli-command-reference-remote-test-event-delete-options-name"></a>
Nama acara uji yang dapat dibagikan untuk dihapus.

`--stack-name TEXT`  <a name="sam-cli-command-reference-remote-test-event-delete-options-stack-name"></a>
Nama CloudFormation tumpukan yang terkait dengan fungsi Lambda.  
Opsi ini diperlukan jika Anda memberikan ID logis fungsi Lambda sebagai argumen.

# sam remote test-event get
<a name="sam-cli-command-reference-remote-test-event-get"></a>

Halaman ini memberikan informasi referensi untuk AWS Serverless Application Model `sam remote test-event get` subperintah Command Line Interface (AWS SAMCLI).
+ Untuk pengantar AWS SAMCLI, lihat [Apa itu AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)
+ Untuk dokumentasi tentang penggunaan AWS SAMCLI `sam remote test-event` perintah, lihat[Pengantar pengujian cloud dengan sam remote test-event](using-sam-cli-remote-test-event.md).

`sam remote test-event get`Subperintah mendapatkan acara pengujian yang dapat dibagikan dari registri EventBridge skema Amazon.

## Penggunaan
<a name="sam-cli-command-reference-remote-test-event-get-usage"></a>

```
$ sam remote test-event get <arguments> <options>
```

## Pendapat
<a name="sam-cli-command-reference-remote-test-event-get-args"></a>

**ID Sumber Daya**  <a name="sam-cli-command-reference-remote-test-event-get-args-resource-id"></a>
ID AWS Lambda fungsi yang terkait dengan peristiwa pengujian yang dapat dibagikan untuk mendapatkan.  
Jika Anda memberikan ID logis, Anda juga harus memberikan nilai untuk AWS CloudFormation tumpukan yang terkait dengan fungsi Lambda menggunakan opsi. `--stack-name`  
*Nilai yang valid*: ID logis sumber daya atau sumber dayaARN.

## Opsi
<a name="sam-cli-command-reference-remote-test-event-get-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-remote-test-event-get-options-config-env"></a>
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](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-remote-test-event-get-options-config-file"></a>
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](serverless-sam-cli-config.md).

`--help, -h`  <a name="sam-cli-command-reference-remote-test-event-get-options-help"></a>
Tampilkan pesan bantuan dan keluar.

`--name TEXT`  <a name="sam-cli-command-reference-remote-test-event-get-options-name"></a>
Nama acara uji yang dapat dibagikan untuk didapatkan.

`--output-file FILENAME`  <a name="sam-cli-command-reference-remote-test-event-get-options-output-file"></a>
Jalur file dan nama untuk menyimpan acara di mesin lokal Anda.  
Jika Anda tidak memberikan opsi ini, AWS SAM CLI akan menampilkan konten acara pengujian yang dapat dibagikan ke konsol Anda.

`--stack-name TEXT`  <a name="sam-cli-command-reference-remote-test-event-get-options-stack-name"></a>
Nama CloudFormation tumpukan yang terkait dengan fungsi Lambda.  
Opsi ini diperlukan jika Anda memberikan ID logis fungsi Lambda sebagai argumen.

# sam remote test-event list
<a name="sam-cli-command-reference-remote-test-event-list"></a>

Halaman ini memberikan informasi referensi untuk AWS Serverless Application Model `sam remote test-event list` subperintah Command Line Interface (AWS SAMCLI).
+ Untuk pengantar AWS SAMCLI, lihat [Apa itu AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)
+ Untuk dokumentasi tentang penggunaan AWS SAMCLI `sam remote test-event` perintah, lihat[Pengantar pengujian cloud dengan sam remote test-event](using-sam-cli-remote-test-event.md).

`sam remote test-event list`Subperintah mencantumkan peristiwa pengujian yang dapat dibagikan untuk AWS Lambda fungsi tertentu dari registri EventBridge skema Amazon.

## Penggunaan
<a name="sam-cli-command-reference-remote-test-event-list-usage"></a>

```
$ sam remote test-event list <arguments> <options>
```

## Pendapat
<a name="sam-cli-command-reference-remote-test-event-list-args"></a>

**ID Sumber Daya**  <a name="sam-cli-command-reference-remote-test-event-list-args-resource-id"></a>
ID fungsi Lambda yang terkait dengan peristiwa pengujian yang dapat dibagikan.  
Jika Anda memberikan ID logis, Anda juga harus memberikan nilai untuk AWS CloudFormation tumpukan yang terkait dengan fungsi Lambda menggunakan opsi. `--stack-name`  
*Nilai yang valid*: ID logis sumber daya atau sumber dayaARN.

## Opsi
<a name="sam-cli-command-reference-remote-test-event-list-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-remote-test-event-list-options-config-env"></a>
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](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-remote-test-event-list-options-config-file"></a>
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](serverless-sam-cli-config.md).

`--help, -h`  <a name="sam-cli-command-reference-remote-test-event-list-options-help"></a>
Tampilkan pesan bantuan dan keluar.

`--stack-name TEXT`  <a name="sam-cli-command-reference-remote-test-event-list-options-stack-name"></a>
Nama CloudFormation tumpukan yang terkait dengan fungsi Lambda.  
Opsi ini diperlukan jika Anda memberikan ID logis fungsi Lambda sebagai argumen.

## Contoh
<a name="sam-cli-command-reference-remote-test-event-list-examples"></a>

Untuk contoh tentang menggunakan perintah ini, lihat[Daftar acara uji yang dapat dibagikan](using-sam-cli-remote-test-event.md#using-sam-cli-remote-test-event-use-list).

# sam remote test-event put
<a name="sam-cli-command-reference-remote-test-event-put"></a>

Halaman ini memberikan informasi referensi untuk AWS Serverless Application Model `sam remote test-event put` subperintah Command Line Interface (AWS SAMCLI).
+ Untuk pengantar AWS SAMCLI, lihat [Apa itu AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)
+ Untuk dokumentasi tentang penggunaan AWS SAMCLI `sam remote test-event` perintah, lihat[Pengantar pengujian cloud dengan sam remote test-event](using-sam-cli-remote-test-event.md).

`sam remote test-event put`Subperintah menyimpan peristiwa pengujian yang dapat dibagikan dari mesin lokal Anda ke registri EventBridge skema Amazon.

## Penggunaan
<a name="sam-cli-command-reference-remote-test-event-put-usage"></a>

```
$ sam remote test-event put <arguments> <options>
```

## Pendapat
<a name="sam-cli-command-reference-remote-test-event-put-args"></a>

**ID Sumber Daya**  <a name="sam-cli-command-reference-remote-test-event-put-args-resource-id"></a>
ID AWS Lambda fungsi yang terkait dengan peristiwa pengujian yang dapat dibagikan.  
Jika Anda memberikan ID logis, Anda juga harus memberikan nilai untuk AWS CloudFormation tumpukan yang terkait dengan fungsi Lambda menggunakan opsi. `--stack-name`  
*Nilai yang valid*: ID logis sumber daya atau sumber dayaARN.

## Opsi
<a name="sam-cli-command-reference-remote-test-event-put-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-remote-test-event-put-options-config-env"></a>
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](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-remote-test-event-put-options-config-file"></a>
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](serverless-sam-cli-config.md).

`--file FILENAME`  <a name="sam-cli-command-reference-remote-test-event-put-options-file"></a>
Jalur file dan nama acara ke mesin lokal Anda.  
Berikan `-` sebagai nilai nama file untuk dibaca`stdin`.  
Opsi ini diperlukan.

`--force`, `-f`  <a name="sam-cli-command-reference-remote-test-event-put-options-force"></a>
Menimpa acara pengujian yang dapat dibagikan dengan nama yang sama.

`--help, -h`  <a name="sam-cli-command-reference-remote-test-event-put-options-help"></a>
Tampilkan pesan bantuan dan keluar.

`--name TEXT`  <a name="sam-cli-command-reference-remote-test-event-put-options-name"></a>
Nama untuk menyimpan acara pengujian yang dapat dibagikan sebagai.  
Jika peristiwa pengujian yang dapat dibagikan dengan nama yang sama ada di registri EventBridge skema, AWS SAM CLI maka tidak akan menimpa. Untuk menimpa, tambahkan `--force` opsi.

`--output-file FILENAME`  <a name="sam-cli-command-reference-remote-test-event-put-options-output-file"></a>
Jalur file dan nama untuk menyimpan acara di mesin lokal Anda.  
Jika Anda tidak memberikan opsi ini, AWS SAM CLI akan menampilkan konten acara pengujian yang dapat dibagikan ke konsol Anda.

`--stack-name TEXT`  <a name="sam-cli-command-reference-remote-test-event-put-options-stack-name"></a>
Nama CloudFormation tumpukan yang terkait dengan fungsi Lambda.  
Opsi ini diperlukan jika Anda memberikan ID logis fungsi Lambda sebagai argumen.

## Contoh
<a name="sam-cli-command-reference-remote-test-event-put-examples"></a>

Untuk contoh tentang menggunakan perintah ini, lihat[Menyimpan acara uji yang dapat dibagikan](using-sam-cli-remote-test-event.md#using-sam-cli-remote-test-event-use-put).

# sam sync
<a name="sam-cli-command-reference-sam-sync"></a>

Halaman ini memberikan informasi referensi untuk AWS Serverless Application Model perintah Command Line Interface (AWS SAMCLI)`sam sync`.
+ Untuk pengantar AWS SAMCLI, lihat [Apa itu AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)
+ Untuk dokumentasi tentang penggunaan AWS SAMCLI, lihat[AWS SAM CLI](using-sam-cli.md).

`sam sync`Perintah menyinkronkan perubahan aplikasi lokal ke file. AWS Cloud

## Penggunaan
<a name="sam-cli-command-reference-sam-sync-usage"></a>

```
$ sam sync <options>
```

## Opsi
<a name="sam-cli-command-reference-sam-sync-options"></a>

`--base-dir, -s DIRECTORY`  <a name="sam-cli-command-reference-sam-sync-options-base-dir"></a>
Selesaikan jalur relatif ke fungsi atau kode sumber lapisan sehubungan dengan direktori ini. Gunakan opsi ini untuk mengubah cara jalur relatif ke folder kode sumber diselesaikan. Secara default, jalur relatif diselesaikan sehubungan dengan lokasi AWS SAM template.  
Selain sumber daya dalam aplikasi root atau tumpukan yang Anda buat, opsi ini juga berlaku untuk aplikasi atau tumpukan bersarang. Selain itu, opsi ini berlaku untuk jenis dan properti sumber daya berikut:  
+ Tipe sumber daya: Properti `AWS::Serverless::Function`: `CodeUri`
+ Tipe sumber daya: Atribut Sumber Daya`AWS::Serverless::Function`: Entri `Metadata`: `DockerContext`
+ Tipe sumber daya: Properti `AWS::Serverless::LayerVersion`: `ContentUri`
+ Tipe sumber daya: Properti `AWS::Lambda::Function`: `Code`
+ Tipe sumber daya: Properti `AWS::Lambda::LayerVersion`: `Content`

`--build-image TEXT`  <a name="sam-cli-command-reference-sam-sync-options-build-image"></a>
URI untuk [gambar kontainer](serverless-image-repositories.md#serverless-image-repository-uris) yang ingin Anda gunakan saat membangun aplikasi Anda. Secara default, AWS SAM menggunakan URI repositori gambar kontainer dari Amazon [Elastic Container Registry (Amazon ECR) Registry ECR) Public.](https://docs.aws.amazon.com/AmazonECR/latest/public/what-is-ecr.html) Tentukan opsi ini untuk menggunakan gambar yang berbeda.  
Anda dapat menggunakan opsi ini beberapa kali dalam satu perintah. Setiap opsi menerima string atau pasangan kunci-nilai.  
+ **String** - Tentukan URI gambar kontainer yang akan digunakan semua sumber daya dalam aplikasi Anda. Berikut ini adalah contohnya:

  ```
  $ sam sync --build-image amazon/aws-sam-cli-build-image-python3.8
  ```
+ **Pasangan nilai kunci** - Tentukan nama sumber daya sebagai kunci dan URI gambar kontainer yang akan digunakan dengan sumber daya itu sebagai nilai. Gunakan format ini untuk menentukan URI gambar kontainer yang berbeda untuk setiap sumber daya dalam aplikasi Anda. Berikut ini adalah contohnya:

  ```
  $ sam sync --build-image Function1=amazon/aws-sam-cli-build-image-python3.8
  ```
Opsi ini hanya berlaku jika opsi `--use-container` ditentukan, jika tidak akan terjadi kesalahan.

`--build-in-source | --no-build-in-source`  <a name="sam-cli-command-reference-sam-sync-options-build-in-source"></a>
Menyediakan `--build-in-source` untuk membangun proyek Anda langsung di folder sumber.  
`--build-in-source`Opsi ini mendukung runtime dan metode build berikut:  
+ **Runtime** - Setiap Node.js runtime yang didukung oleh opsi. `sam init --runtime`
+ **Membangun metode** —`Makefile`,`esbuild`.
`--build-in-source`Opsi ini tidak kompatibel dengan opsi berikut:  
+ `--use-container `
*Default*: `--no-build-in-source`

`--capabilities LIST`  <a name="sam-cli-command-reference-sam-sync-options-capabilities"></a>
Daftar kemampuan yang Anda tentukan untuk memungkinkan CloudFormation untuk membuat tumpukan tertentu. Beberapa templat tumpukan mungkin menyertakan sumber daya yang dapat memengaruhi izin di Anda Akun AWS. Misalnya, dengan membuat pengguna baru AWS Identity and Access Management (IAM). Tentukan opsi ini untuk mengganti nilai default. Nilai-nilai yang valid meliputi:  
+ KEMAMPUAN\$1IAM
+ CAPABILITY\$1NAMED\$1IAM
+ CAPABILITY\$1RESOURCE\$1POLICY
+ CAPABILITY\$1AUTO\$1EXPAND
*Default*: `CAPABILITY_NAMED_IAM` dan `CAPABILITY_AUTO_EXPAND`

`--code`  <a name="sam-cli-command-reference-sam-sync-options-code"></a>
Secara default, AWS SAM sinkronisasi semua sumber daya dalam aplikasi Anda. Tentukan opsi ini untuk menyinkronkan hanya sumber daya kode, yang meliputi yang berikut ini:  
+ `AWS::Serverless::Function`
+ `AWS::Lambda::Function`
+ `AWS::Serverless::LayerVersion`
+ `AWS::Lambda::LayerVersion`
+ `AWS::Serverless::Api`
+ `AWS::ApiGateway::RestApi`
+ `AWS::Serverless::HttpApi`
+ `AWS::ApiGatewayV2::Api`
+ `AWS::Serverless::StateMachine`
+ `AWS::StepFunctions::StateMachine`
Untuk menyinkronkan sumber daya kode, AWS SAM gunakan AWS layanan APIs secara langsung, alih-alih AWS CloudFormation menerapkannya. Untuk memperbarui CloudFormation tumpukan Anda, jalankan **sam sync --watch** atau**sam deploy**.

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-sync-options-config-env"></a>
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](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-sync-options-config-file"></a>
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](serverless-sam-cli-config.md).

`--dependency-layer | --no-dependency-layer`  <a name="sam-cli-command-reference-sam-sync-options-dependency-layer"></a>
Menentukan apakah untuk memisahkan dependensi fungsi individu ke lapisan lain untuk mempercepat proses sinkronisasi.  
*Default*: `--dependency-layer`

`--image-repository TEXT`  <a name="sam-cli-command-reference-sam-sync-options-image-repository"></a>
Nama repositori Amazon Elastic Container Registry (Amazon ECR) tempat perintah ini mengunggah citra fungsi Anda. Diperlukan untuk fungsi yang dilaporkan dengan tipe paket `Image`.

`--image-repositories TEXT`  <a name="sam-cli-command-reference-sam-sync-options-image-repositories"></a>
Pemetaan fungsi ke URI repositori Amazon ECR mereka. Fungsi referensi dengan ID logisnya. Berikut ini adalah contohnya:  

```
$ sam sync --image-repositories Function1=123456789012.dkr.ecr.us-east-1.amazonaws.com/my-repo
```
Anda dapat menentukan opsi ini beberapa kali dalam satu perintah.

`--kms-key-id TEXT`  <a name="sam-cli-command-reference-sam-sync-options-kms-key-id"></a>
ID kunci AWS Key Management Service (AWS KMS) yang digunakan untuk mengenkripsi artefak yang diam di bucket Amazon S3. Jika Anda tidak menentukan opsi ini, AWS SAM gunakan kunci enkripsi yang dikelola Amazon S3.

`--metadata`  <a name="sam-cli-command-reference-sam-sync-options-metadata"></a>
Peta metadata untuk dilampirkan ke semua artefak yang Anda referensikan di template Anda.

`--notification-arns LIST`  <a name="sam-cli-command-reference-sam-sync-options-notification-arns"></a>
Daftar ARNs topik Amazon Simple Notification Service (Amazon SNS) CloudFormation yang terkait dengan tumpukan.

`--no-use-container`  <a name="ref-sam-cli-sync-options-no-use-container"></a>
Opsi yang memungkinkan Anda menggunakan toolkit IDE untuk mengatur perilaku default.

`--parameter-overrides`  <a name="sam-cli-command-reference-sam-sync-options-parameter-overrides"></a>
String yang berisi penggantian CloudFormation parameter yang dikodekan sebagai pasangan kunci-nilai. Gunakan format yang sama dengan AWS Command Line Interface (AWS CLI). AWS SAMCLIFormatnya adalah kunci eksplisit dan kata kunci nilai, setiap penggantian dipisahkan oleh spasi. Berikut adalah dua contoh:  
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world`
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world ParameterKey=example1,ParameterValue=example2 ParameterKey=apple,ParameterValue=banana`

`--resource TEXT`  <a name="sam-cli-command-reference-sam-sync-options-resource"></a>
Menentukan jenis sumber daya untuk sinkronisasi. Untuk menyinkronkan beberapa sumber daya, Anda dapat menentukan opsi ini beberapa kali. Opsi ini didukung dengan `--code` opsi. Nilai harus menjadi salah satu sumber daya yang terdaftar di bawah`--code`. Misalnya, `--resource AWS::Serverless::Function --resource AWS::Serverless::LayerVersion`.

`--resource-id TEXT`  <a name="sam-cli-command-reference-sam-sync-options-resource-id"></a>
Menentukan ID sumber daya untuk disinkronkan. Untuk menyinkronkan beberapa sumber daya, Anda dapat menentukan opsi ini beberapa kali. Opsi ini didukung dengan `--code` opsi. Misalnya, `--resource-id Function1 --resource-id Function2`.

`--role-arn TEXT`  <a name="sam-cli-command-reference-sam-sync-options-role-arn"></a>
Nama Sumber Daya Amazon (ARN) dari peran IAM yang CloudFormation diasumsikan saat menerapkan kumpulan perubahan.

`--s3-bucket TEXT`  <a name="sam-cli-command-reference-sam-sync-options-s3-bucket"></a>
Nama bucket Amazon Simple Storage Service (Amazon S3) Simple Storage Service (Amazon S3) tempat perintah ini mengunggah template Anda. CloudFormation Jika template Anda lebih besar dari 51.200 byte, maka opsi `--s3-bucket` atau `--resolve-s3` opsi diperlukan. Jika Anda menentukan opsi `--s3-bucket` dan `--resolve-s3` opsi, maka terjadi kesalahan.

`--s3-prefix TEXT`  <a name="sam-cli-command-reference-sam-sync-options-s3-prefix"></a>
Awalan ditambahkan ke nama artefak yang Anda unggah ke bucket Amazon S3. Nama prefiks adalah nama jalur (nama folder) untuk bucket Amazon S3. Ini hanya berlaku untuk fungsi yang dideklarasikan dengan jenis `Zip` paket.

`--save-params`  <a name="sam-cli-command-reference-sam-sync-options-save-params"></a>
Menyimpan parameter yang Anda berikan pada baris perintah ke file AWS SAM konfigurasi.

`--skip-deploy-sync | --no-skip-deploy-sync`  <a name="sam-cli-command-reference-sam-sync-options-skip-deploy-sync"></a>
Menentukan `--skip-deploy-sync` untuk melewati sinkronisasi infrastruktur awal jika tidak diperlukan. Ini AWS SAMCLI akan membandingkan AWS SAM template lokal Anda dengan CloudFormation template yang diterapkan dan melakukan penerapan hanya jika perubahan terdeteksi.  
Menentukan `--no-skip-deploy-sync` untuk melakukan CloudFormation penyebaran setiap kali `sam sync` dijalankan.  
Untuk mempelajari selengkapnya, lihat [Lewati CloudFormation penerapan awal](using-sam-cli-sync.md#using-sam-cli-sync-options-skip-deploy-sync).  
*Default*: `--skip-deploy-sync`

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-sync-options-stack-name"></a>
Nama CloudFormation tumpukan untuk aplikasi Anda.  
Opsi ini diperlukan.

`--tags LIST`  <a name="sam-cli-command-reference-sam-sync-options-tags"></a>
Daftar tag untuk dikaitkan dengan tumpukan yang dibuat atau diperbarui. CloudFormation juga menyebarkan tag ini ke sumber daya di tumpukan yang mendukungnya.

`--template-file, --template, -t PATH`  <a name="sam-cli-command-reference-sam-sync-options-template-file"></a>
Path dan nama file tempat AWS SAM template Anda berada.  
Jika Anda menentukan opsi ini, maka AWS SAM gunakan hanya templat dan sumber daya lokal yang ditunjukkannya.

`--use-container, -u`  <a name="sam-cli-command-reference-sam-sync-options-use-container"></a>
Jika fungsi Anda bergantung pada paket yang memiliki dependensi yang dikompilasi secara native, gunakan opsi ini untuk membangun fungsi Anda di dalam wadah -like. AWS LambdaDocker  
Saat ini, opsi ini tidak kompatibel dengan`--dependency-layer`. Jika Anda menggunakan `--use-container` dengan`--dependency-layer`, AWS SAMCLI menginformasikan Anda dan melanjutkan dengan`--no-dependency-layer`.

`--watch`  <a name="sam-cli-command-reference-sam-sync-options-watch"></a>
Memulai proses yang mengawasi aplikasi lokal Anda untuk perubahan dan secara otomatis menyinkronkannya ke file. AWS Cloud Secara default, ketika Anda menentukan opsi ini, AWS SAM menyinkronkan semua sumber daya dalam aplikasi Anda saat Anda memperbaruinya. Dengan opsi ini, AWS SAM melakukan CloudFormation penyebaran awal. Kemudian, AWS SAM menggunakan AWS layanan APIs untuk memperbarui sumber daya kode. AWS SAM digunakan CloudFormation untuk memperbarui sumber daya infrastruktur saat Anda memperbarui AWS SAM template Anda.

`--watch-exclude TEXT`  <a name="sam-cli-command-reference-sam-sync-options-watch-exclude"></a>
Mengecualikan file atau folder agar tidak diamati untuk perubahan file. Untuk menggunakan opsi ini, juga `--watch` harus disediakan.  
Opsi ini menerima pasangan kunci-nilai:  
+ **Kunci** — ID logis dari fungsi Lambda dalam aplikasi Anda.
+ **Nilai** - Nama file atau folder terkait untuk dikecualikan.
Saat Anda memperbarui file atau folder apa pun yang ditentukan dengan `--watch-exclude` opsi, tidak AWS SAM CLI akan memulai sinkronisasi. Namun, ketika pembaruan ke file atau folder lain memulai sinkronisasi, file atau folder ini akan disertakan dalam sinkronisasi itu.  
Anda dapat memberikan opsi ini beberapa kali dalam satu perintah.

## Contoh
<a name="sam-cli-command-reference-sam-sync-examples"></a>

Untuk contoh tentang menggunakan perintah ini, lihat[Opsi untuk perintah sinkronisasi sam](using-sam-cli-sync.md#using-sam-cli-sync-options).

# sam traces
<a name="sam-cli-command-reference-sam-traces"></a>

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

Untuk pengantar AWS SAMCLI, lihat [Apa itu AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

`sam traces`Perintah mengambil AWS X-Ray jejak di Anda Akun AWS di. Wilayah AWS

## Penggunaan
<a name="sam-cli-command-reference-sam-traces-usage"></a>

```
$ sam traces <options>
```

## Opsi
<a name="sam-cli-command-reference-sam-traces-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-traces-options-config-env"></a>
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](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-traces-options-config-file"></a>
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](serverless-sam-cli-config.md).

`--end-time TEXT`  <a name="sam-cli-command-reference-sam-traces-options-end-time"></a>
Mengambil jejak hingga saat ini. Waktu dapat berupa nilai-nilai relatif seperti '5 menit yang lalu', 'besok', atau stempel waktu yang diformat seperti '01-01-2018 10.10.10'.

`--output TEXT`  <a name="sam-cli-command-reference-sam-traces-options-output"></a>
Menentukan format output untuk log. Untuk mencetak log yang diformat, tentukan`text`. Untuk mencetak log sebagai JSON, tentukan`json`.

`--save-params`  <a name="sam-cli-command-reference-sam-traces-options-save-params"></a>
Simpan parameter yang Anda berikan pada baris perintah ke file AWS SAM konfigurasi.

`--start-time TEXT`  <a name="sam-cli-command-reference-sam-traces-options-start-time"></a>
Mengambil jejak mulai saat ini. Waktu dapat berupa nilai-nilai relatif seperti '5 menit lalu', 'kemarin', atau stempel waktu yang diformat seperti '01-01-2018 10.10.10'. Default ke '10 menit yang lalu'.

`--tail`  <a name="sam-cli-command-reference-sam-traces-options-tail"></a>
Ekor output jejak. Ini mengabaikan argumen waktu akhir dan terus menampilkan jejak saat tersedia.

`--trace-id TEXT`  <a name="sam-cli-command-reference-sam-traces-options-trace-id"></a>
Pengidentifikasi unik untuk jejak X-Ray.

## Contoh
<a name="sam-cli-command-reference-sam-traces-examples"></a>

Jalankan perintah berikut untuk mengambil jejak X-Ray dengan ID.

```
$ sam traces --trace-id tracing-id-1 --trace-id tracing-id-2
```

Jalankan perintah berikut untuk mengekor jejak X-Ray saat tersedia.

```
$ sam traces --tail
```

# sam validate
<a name="sam-cli-command-reference-sam-validate"></a>

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

Untuk pengantar AWS SAMCLI, lihat [Apa itu AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

`sam validate`Perintah memverifikasi apakah file AWS SAM template valid.

## Penggunaan
<a name="sam-cli-command-reference-sam-validate-usage"></a>

```
$ sam validate <options>
```

## Opsi
<a name="sam-cli-command-reference-sam-validate-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-validate-options-config-env"></a>
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](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-validate-options-config-file"></a>
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](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-validate-options-debug"></a>
Mengaktifkan logging debug untuk mencetak pesan debug yang dihasilkan oleh AWS SAMCLI dan menampilkan stempel waktu.

`--lint`  <a name="sam-cli-command-reference-sam-validate-options-lint"></a>
 Jalankan validasi linting pada template melalui. **cfn-lint** Buat file `cfnlintrc` konfigurasi untuk menentukan parameter tambahan. *Untuk informasi selengkapnya, lihat [cfn-lint](https://github.com/aws-cloudformation/cfn-lint) di repositori.CloudFormation GitHub * 

`--profile TEXT`  <a name="sam-cli-command-reference-sam-validate-options-profile"></a>
Profil spesifik dari file kredensialmu yang mendapat AWS kredensialnya.

`--region TEXT`  <a name="sam-cli-command-reference-sam-validate-options-region"></a>
 AWS Wilayah untuk dikerahkan ke. Misalnya, us-east-1.

`--save-params`  <a name="sam-cli-command-reference-sam-validate-options-save-params"></a>
Simpan parameter yang Anda berikan pada baris perintah ke file AWS SAM konfigurasi.

`--template-file, --template, -t PATH`  <a name="sam-cli-command-reference-sam-validate-options-template-file"></a>
 File AWS SAM template. Nilai default-nya adalah `template.[yaml|yml]`.   
 Jika template Anda ada di direktori kerja Anda saat ini dan diberi nama`template.[yaml|yml|json]`, opsi ini tidak diperlukan.   
 Jika Anda baru saja berlari**sam build**, opsi ini tidak diperlukan. 

## Contoh
<a name="sam-cli-command-reference-sam-validate-examples"></a>

Untuk contoh tentang menggunakan perintah ini untuk memvalidasi template, lihat. [Validasi file AWS SAM template](serverless-sam-cli-using-validate.md)

Untuk contoh tentang penggunaan perintah ini dengan cfn-lint, lihat. [Validasi AWS SAM aplikasi Anda dengan Linter CloudFormation](validate-cfn-lint.md)