Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Membuat penerapan untuk REST API di API Gateway
Di API Gateway, penerapan REST API diwakili oleh sumber daya [Deployment](https://docs.aws.amazon.com/apigateway/latest/api/API_Deployment.html). Ini mirip dengan executable API yang diwakili oleh sumber daya. [RestApi](https://docs.aws.amazon.com/apigateway/latest/api/API_RestApi.html)
Agar klien dapat memanggil API Anda, Anda harus membuat penerapan dan mengaitkan tahapan dengannya. Sebuah panggung diwakili oleh sumber daya [Panggung](https://docs.aws.amazon.com/apigateway/latest/api/API_Stage.html). Ini mewakili snapshot API, termasuk metode, integrasi, model, template pemetaan, dan otorisasi Lambda (sebelumnya dikenal sebagai otorisasi khusus). Saat memperbarui API, Anda dapat menerapkan ulang API dengan mengaitkan tahap baru dengan penerapan yang ada. Kami membahas membuat panggung di[Siapkan panggung untuk REST API di API Gateway](set-up-stages.md).
**Topics**
+ [Buat deployment](#create-deployment)
+ [Langkah selanjutnya untuk penerapan API](#apigateway-deployment-next-steps)
## Buat deployment
Prosedur berikut menunjukkan cara membuat penerapan untuk REST API.
------
#### [ Konsol Manajemen AWS ]
Anda harus telah membuat REST API sebelum menerapkannya untuk pertama kalinya. Untuk informasi selengkapnya, lihat [Kembangkan REST APIs di API Gateway](rest-api-develop.md).
Konsol API Gateway memungkinkan Anda men-deploy API dengan membuat deployment dan mengaitkannya dengan tahap baru atau yang sudah ada.
1. Masuk ke konsol API Gateway di [https://console.aws.amazon.com/apigateway](https://console.aws.amazon.com/apigateway).
1. Di panel **APIs**navigasi, pilih API yang ingin Anda terapkan.
1. Di panel **Resources**, pilih **Deploy API**.
1. Untuk **Stage**, pilih dari berikut ini:
1. Untuk membuat tahap baru, pilih **Tahap baru**, lalu masukkan nama di **Nama panggung**. **Secara opsional, Anda dapat memberikan deskripsi untuk penyebaran dalam deskripsi Deployment.**
1. Untuk memilih tahap yang ada, pilih nama panggung dari menu tarik-turun. Anda mungkin ingin memberikan deskripsi penerapan baru dalam deskripsi **Deployment**.
1. Untuk membuat penyebaran yang tidak terkait dengan tahap, pilih **Tidak ada tahap**. Nanti, Anda dapat mengaitkan penerapan ini dengan sebuah panggung.
1. Pilih **Deploy**.
------
#### [ AWS CLI ]
[Saat membuat penerapan, Anda membuat instance sumber daya Deployment.](https://docs.aws.amazon.com/apigateway/latest/api/API_Deployment.html)
Perintah [create-deployment](https://docs.aws.amazon.com/cli/latest/reference/apigateway/create-deployment.html) berikut membuat penerapan baru:
```
aws apigateway create-deployment --rest-api-id rest-api-id
```
Anda tidak dapat memanggil API sampai Anda mengaitkan penerapan ini dengan sebuah panggung. Dengan tahap yang ada, Anda dapat melakukan ini dengan memperbarui properti [deploymentID stage dengan ID](https://docs.aws.amazon.com/apigateway/latest/api/API_Stage.html#deploymentId) deployment yang baru dibuat. Perintah [update-stage](https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-stage.html) berikut memperbarui tahap dengan penerapan baru. Di konsol, ini disebut **penyebaran aktif**.
```
aws apigateway update-stage \
--rest-api-id rest-api-id \
--stage-name 'stage-name' \
--patch-operations op='replace',path='/deploymentId',value='deployment-id'
```
Saat Anda membuat penerapan, Anda juga dapat mengaitkannya dengan tahap baru secara bersamaan. Perintah [create-deployment](https://docs.aws.amazon.com/cli/latest/reference/apigateway/create-deployment.html) berikut membuat penerapan baru dan mengaitkannya dengan tahap baru yang disebut: `beta`
```
aws apigateway create-deployment \
--rest-api-id rest-api-id \
--stage-name beta
```
------
Untuk menerapkan ulang API, lakukan langkah yang sama. Anda dapat menggunakan kembali tahap yang sama.
## Langkah selanjutnya untuk penerapan API
Berikut ini adalah langkah selanjutnya untuk penerapan API Anda.
Ubah pengaturan panggung
Setelah API diterapkan, Anda dapat memodifikasi pengaturan panggung untuk mengaktifkan atau menonaktifkan cache API, logging, atau meminta pembatasan. Anda juga dapat memilih sertifikat klien untuk backend untuk mengautentikasi API Gateway dan mengatur variabel tahap untuk meneruskan konteks penerapan ke integrasi API saat runtime. Untuk informasi selengkapnya, silakan lihat [Ubah pengaturan panggung](set-up-stages.md#how-to-stage-settings)
Setelah memodifikasi pengaturan tahap, Anda harus menerapkan ulang API agar perubahan diterapkan.
Jika pengaturan yang diperbarui, seperti mengaktifkan logging, memerlukan peran IAM baru, Anda dapat menambahkan peran IAM yang diperlukan tanpa menerapkan ulang API. Namun, mungkin perlu beberapa menit sebelum peran IAM baru berlaku. Sebelum itu terjadi, jejak panggilan API Anda tidak dicatat meskipun Anda telah mengaktifkan opsi logging.
Pilih kombinasi tahap penerapan yang berbeda
Karena penerapan merepresentasikan snapshot API dan tahap menentukan jalur ke dalam snapshot, Anda dapat memilih kombinasi tahap penerapan yang berbeda untuk mengontrol cara pengguna memanggil ke versi API yang berbeda. Ini berguna, misalnya, ketika Anda ingin memutar kembali status API ke penerapan sebelumnya atau menggabungkan 'cabang pribadi' API ke publik.
Prosedur berikut menunjukkan cara melakukannya menggunakan **Stage Editor** di konsol API Gateway. Diasumsikan bahwa Anda harus telah menerapkan API lebih dari sekali.
1. **Jika Anda belum berada di panel **Tahapan**, di panel navigasi utama, pilih Tahapan.**
1. Pilih tahap yang ingin Anda perbarui.
1. Pada tab **Riwayat Deployment**, pilih penyebaran yang ingin Anda gunakan untuk tahap.
1. Pilih **Ubah penerapan aktif**.
1. Konfirmasikan bahwa Anda ingin mengubah penerapan aktif dan pilih **Ubah penerapan aktif di kotak** dialog **Make active deployment**.
Teruskan data khusus penerapan ke API Anda.
Untuk penerapan, Anda dapat menyetel atau memodifikasi variabel tahap untuk meneruskan data khusus penerapan ke integrasi API saat runtime. Anda dapat melakukan ini pada tab **Stage Variables** di **Stage Editor**. Untuk informasi lebih lanjut, lihat petunjuk di[Menggunakan variabel stage untuk REST API di API Gateway](stage-variables.md).