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

# Pengantar pengujian cloud dengan sam remote test-event
<a name="using-sam-cli-remote-test-event"></a>

Gunakan AWS Serverless Application Model perintah Command Line Interface (AWS SAM CLI) `sam remote test-event` untuk mengakses dan mengelola peristiwa pengujian yang dapat dibagikan untuk AWS Lambda fungsi Anda.

Untuk mempelajari lebih lanjut tentang peristiwa pengujian yang dapat dibagikan, lihat [Acara pengujian yang dapat dibagikan](https://docs.aws.amazon.com/lambda/latest/dg/testing-functions.html#creating-shareable-events) di Panduan *AWS Lambda Pengembang*.

**Topics**
+ [Siapkan AWS SAMCLI untuk digunakan sam remote test-event](#using-sam-cli-remote-test-event-setup)
+ [Menggunakan sam remote test-event perintah](#using-sam-cli-remote-test-event-use)
+ [Menggunakan acara uji yang dapat dibagikan](#using-sam-cli-remote-test-event-invoke)
+ [Mengelola acara uji yang dapat dibagikan](#using-sam-cli-remote-test-event-manage)

## Prasyarat
<a name="using-sam-cli-remote-test-event-prerequisites"></a>

Untuk menggunakan`sam remote test-event`, instal AWS SAMCLI dengan menyelesaikan yang berikut ini:
+ [AWS SAM prasyarat](prerequisites.md).
+ [Instal AWS SAMCLI](install-sam-cli.md).

Jika Anda sudah AWS SAM CLI menginstal, kami sarankan untuk meningkatkan ke versi terbaru dari AWS SAMCLI versi. Untuk mempelajari selengkapnya, lihat [Upgrade AWS SAMCLI](manage-sam-cli-versions.md#manage-sam-cli-versions-upgrade).

Sebelum menggunakan`sam remote test-event`, kami merekomendasikan pemahaman dasar tentang hal-hal berikut:
+ [Mengkonfigurasi AWS SAMCLI](using-sam-cli-configure.md).
+ [Buat aplikasi Anda di AWS SAM](using-sam-cli-init.md).
+ [Pengantar bangunan dengan AWS SAM](using-sam-cli-build.md).
+ [Pengantar penerapan dengan AWS SAM](using-sam-cli-deploy.md).
+ [Pengantar penggunaan sam sync untuk menyinkronkan ke AWS Cloud](using-sam-cli-sync.md).

## Siapkan AWS SAMCLI untuk digunakan sam remote test-event
<a name="using-sam-cli-remote-test-event-setup"></a>

Selesaikan langkah-langkah pengaturan berikut untuk menggunakan AWS SAM CLI `sam remote test-event` perintah:

1. **Konfigurasikan AWS SAM CLI untuk menggunakan Akun AWS** - Acara pengujian yang dapat dibagikan untuk Lambda dapat diakses dan dikelola oleh pengguna dalam hal yang sama. Akun AWS Untuk mengkonfigurasi AWS SAM CLI untuk menggunakan Anda Akun AWS, lihat[Mengkonfigurasi AWS SAMCLI](using-sam-cli-configure.md).

1. **Konfigurasikan izin untuk acara pengujian yang dapat dibagikan — Untuk mengakses dan mengelola peristiwa** pengujian yang dapat dibagikan, Anda harus memiliki izin yang tepat. Untuk mempelajari selengkapnya, lihat [Acara pengujian yang dapat dibagikan](https://docs.aws.amazon.com/lambda/latest/dg/testing-functions.html#creating-shareable-events) di *Panduan AWS Lambda Pengembang*.

## Menggunakan sam remote test-event perintah
<a name="using-sam-cli-remote-test-event-use"></a>

 AWS SAM CLI`sam remote test-event`Perintah ini menyediakan subperintah berikut yang dapat Anda gunakan untuk mengakses dan mengelola peristiwa pengujian yang dapat dibagikan:
+ `delete`— Hapus acara pengujian yang dapat dibagikan dari registri EventBridge skema Amazon.
+ `get`— Dapatkan acara uji yang dapat dibagikan dari registri EventBridge skema.
+ `list`— Buat daftar peristiwa pengujian yang dapat dibagikan untuk fungsi dari registri EventBridge skema.
+ `put`— Simpan acara dari file lokal ke registri EventBridge skema.

Untuk membuat daftar subperintah ini menggunakan AWS SAM CLI, jalankan yang berikut ini:

```
$ sam remote test-event --help
```

### Menghapus acara pengujian yang dapat dibagikan
<a name="using-sam-cli-remote-test-event-use-delete"></a>

Anda dapat menghapus peristiwa pengujian yang dapat dibagikan dengan menggunakan `delete` subperintah bersama dengan yang berikut:
+ Berikan nama acara pengujian yang dapat dibagikan untuk dihapus.
+ Berikan ID yang dapat diterima dari fungsi Lambda yang terkait dengan acara tersebut.
+ Jika Anda memberikan ID logis fungsi Lambda, Anda juga harus memberikan nama AWS CloudFormation tumpukan yang terkait dengan fungsi Lambda.

Berikut ini adalah contohnya:

```
$ sam remote test-event delete HelloWorldFunction --stack-name sam-app --name demo-event
```

Untuk daftar opsi yang akan digunakan dengan `delete` subperintah, lihat[sam remote test-event delete](sam-cli-command-reference-remote-test-event-delete.md). Anda juga dapat menjalankan yang berikut ini dari AWS SAM CLI:

```
$ sam remote test-event delete --help
```

### Mendapatkan acara uji yang dapat dibagikan
<a name="using-sam-cli-remote-test-event-use-get"></a>

Anda bisa mendapatkan acara pengujian yang dapat dibagikan dari registri EventBridge skema dengan menggunakan `get` subperintah bersama dengan yang berikut:
+ Berikan nama acara uji yang dapat dibagikan untuk didapatkan.
+ Berikan ID yang dapat diterima dari fungsi Lambda yang terkait dengan acara tersebut.
+ Jika Anda memberikan ID logis fungsi Lambda, Anda juga harus memberikan nama AWS CloudFormation tumpukan yang terkait dengan fungsi Lambda.

Berikut ini adalah contoh yang mendapatkan acara pengujian yang dapat dibagikan bernama `demo-event` yang terkait dengan fungsi `HelloWorldFunction` Lambda dari `sam-app` tumpukan. Perintah ini akan mencetak acara ke konsol Anda.

```
$ sam remote test-event get HelloWorldFunction --stack-name sam-app --name demo-event
```

Untuk mendapatkan acara pengujian yang dapat dibagikan dan menyimpannya ke mesin lokal Anda, gunakan `--output-file` opsi dan berikan jalur dan nama file. Berikut ini adalah contoh yang menyimpan `demo-event` seperti `demo-event.json` pada direktori kerja saat ini:

```
$ sam remote test-event get HelloWorldFunction --stack-name sam-app --name demo-event --output-file demo-event.json
```

Untuk daftar opsi yang akan digunakan dengan `get` subperintah, lihat[sam remote test-event get](sam-cli-command-reference-remote-test-event-get.md). Anda juga dapat menjalankan yang berikut ini dari AWS SAM CLI:

```
$ sam remote test-event get --help
```

### Daftar acara uji yang dapat dibagikan
<a name="using-sam-cli-remote-test-event-use-list"></a>

Anda dapat mencantumkan semua peristiwa pengujian yang dapat dibagikan untuk fungsi Lambda tertentu dari registri skema. Gunakan `list` subperintah bersama dengan yang berikut ini:
+ Berikan ID yang dapat diterima dari fungsi Lambda yang terkait dengan peristiwa.
+ Jika Anda memberikan ID logis fungsi Lambda, Anda juga harus memberikan nama CloudFormation tumpukan yang terkait dengan fungsi Lambda.

Berikut ini adalah contoh yang memperoleh daftar semua peristiwa pengujian yang dapat dibagikan yang terkait dengan fungsi `HelloWorldFunction` Lambda dari tumpukan: `sam-app`

```
$ sam remote test-event list HelloWorldFunction --stack-name sam-app
```

Untuk daftar opsi yang akan digunakan dengan `list` subperintah, lihat[sam remote test-event list](sam-cli-command-reference-remote-test-event-list.md). Anda juga dapat menjalankan yang berikut ini dari AWS SAM CLI:

```
$ sam remote test-event list --help
```

### Menyimpan acara uji yang dapat dibagikan
<a name="using-sam-cli-remote-test-event-use-put"></a>

Anda dapat menyimpan peristiwa pengujian yang dapat dibagikan ke registri EventBridge skema. Gunakan `put` subperintah bersama dengan yang berikut ini:
+ Berikan ID yang dapat diterima dari fungsi Lambda yang terkait dengan peristiwa pengujian yang dapat dibagikan.
+ Berikan nama untuk acara pengujian yang dapat dibagikan.
+ Berikan jalur file dan nama ke acara lokal untuk diunggah.

Berikut ini adalah contoh yang menyimpan `demo-event.json` acara lokal sebagai `demo-event` dan mengaitkannya dengan fungsi `HelloWorldFunction` Lambda dari `sam-app` tumpukan:

```
$ sam remote test-event put HelloWorldFunction --stack-name sam-app --name demo-event --file demo-event.json
```

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 ke perintah Anda.

Untuk daftar opsi yang akan digunakan dengan `put` subperintah, lihat[sam remote test-event put](sam-cli-command-reference-remote-test-event-put.md). Anda juga dapat menjalankan yang berikut ini dari AWS SAM CLI:

```
$ sam remote test-event put --help
```

## Menggunakan acara uji yang dapat dibagikan
<a name="using-sam-cli-remote-test-event-invoke"></a>

Gunakan peristiwa pengujian yang dapat dibagikan untuk menguji fungsi Lambda Anda di dengan AWS Cloud `sam remote invoke` perintah. Untuk mempelajari selengkapnya, lihat [Lulus peristiwa pengujian yang dapat dibagikan ke fungsi Lambda di cloud](using-sam-cli-remote-invoke.md#using-sam-cli-remote-invoke-shareable).

## Mengelola acara uji yang dapat dibagikan
<a name="using-sam-cli-remote-test-event-manage"></a>

Topik ini berisi contoh bagaimana Anda dapat mengelola dan menggunakan peristiwa pengujian yang dapat dibagikan.

### Dapatkan acara pengujian yang dapat dibagikan, modifikasi, dan gunakan
<a name="using-sam-cli-remote-test-event-manage-example1"></a>

Anda bisa mendapatkan acara pengujian yang dapat dibagikan dari registri EventBridge skema, memodifikasinya secara lokal, dan menggunakan peristiwa pengujian lokal dengan fungsi Lambda Anda di. AWS Cloud Berikut ini adalah contohnya:

1. **Mengambil peristiwa pengujian yang dapat dibagikan - Gunakan `sam remote test-event get` subperintah untuk mengambil peristiwa pengujian** yang dapat dibagikan untuk fungsi Lambda tertentu dan menyimpannya secara lokal:

   ```
   $ sam remote test-event get HelloWorldFunction --stack-name sam-app --name demo-event --output-file demo-event.json
   ```

1. **Ubah acara pengujian yang dapat dibagikan** - Gunakan editor teks pilihan Anda untuk memodifikasi acara pengujian yang dapat dibagikan.

1. **Gunakan acara pengujian yang dapat dibagikan** - Gunakan `sam remote invoke` perintah dan berikan jalur file dan nama acara dengan`--event-file`:

   ```
   $ sam remote invoke HelloWorldFunction --stack-name sam-app --event-file demo-event.json
   ```

### Dapatkan acara pengujian yang dapat dibagikan, modifikasi, unggah, dan gunakan
<a name="using-sam-cli-remote-test-event-manage-example2"></a>

Anda bisa mendapatkan acara pengujian yang dapat dibagikan dari registri EventBridge skema, memodifikasinya secara lokal, dan mengunggahnya. Kemudian, Anda dapat lulus acara pengujian yang dapat dibagikan langsung ke fungsi Lambda Anda di. AWS Cloud Berikut ini adalah contohnya:

1. **Mengambil peristiwa pengujian yang dapat dibagikan - Gunakan `sam remote test-event get` subperintah untuk mengambil peristiwa pengujian** yang dapat dibagikan untuk fungsi Lambda tertentu dan menyimpannya secara lokal:

   ```
   $ sam remote test-event get HelloWorldFunction --stack-name sam-app --name demo-event --output-file demo-event.json
   ```

1. **Ubah acara pengujian yang dapat dibagikan** - Gunakan editor teks pilihan Anda untuk memodifikasi acara pengujian yang dapat dibagikan.

1. **Unggah peristiwa pengujian yang dapat dibagikan** — Gunakan `sam remote test-event put` subperintah untuk mengunggah dan menyimpan peristiwa pengujian yang dapat dibagikan ke registri skema. EventBridge Dalam contoh ini, kami menggunakan `--force` opsi untuk menimpa versi lama dari pengujian kami yang dapat dibagikan:

   ```
   $ sam remote test-event put HelloWorldFunction --stack-name sam-app --name demo-event --file demo-event.json --force
   ```

1. **Lulus peristiwa pengujian yang dapat dibagikan ke fungsi Lambda Anda** — Gunakan `sam remote invoke` perintah untuk meneruskan peristiwa pengujian yang dapat dibagikan langsung ke fungsi Lambda Anda di: AWS Cloud

   ```
   $ sam remote invoke HelloWorldFunction --stack-name sam-app --test-event-name demo-event
   ```