Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Siapkan panggung untuk REST API di API Gateway
Tahap adalah referensi bernama untuk penerapan, yang merupakan snapshot dari API. Anda menggunakan [Stage](https://docs.aws.amazon.com/apigateway/latest/api/API_Stage.html) untuk mengelola dan mengoptimalkan penerapan tertentu. Misalnya, Anda dapat mengonfigurasi pengaturan tahap untuk mengaktifkan caching, menyesuaikan pembatasan permintaan, mengonfigurasi logging, menentukan variabel tahap, atau melampirkan rilis kenari untuk pengujian. Bagian berikut menunjukkan cara membuat dan mengkonfigurasi panggung Anda.
## Buat panggung baru
Setelah penerapan awal, Anda dapat menambahkan lebih banyak tahapan dan mengaitkannya dengan penerapan yang ada. Anda dapat menggunakan konsol API Gateway untuk membuat tahap baru, atau Anda dapat memilih tahap yang ada saat menerapkan API. Secara umum, Anda dapat menambahkan tahap baru ke penerapan API sebelum menerapkan ulang API. Untuk membuat tahap baru menggunakan konsol API Gateway, ikuti langkah-langkah berikut:
1. Masuk ke konsol API Gateway di [https://console.aws.amazon.com/apigateway](https://console.aws.amazon.com/apigateway).
1. Pilih REST API.
1. Di panel navigasi utama, pilih **Tahapan** di bawah API.
1. Dari panel navigasi **Tahapan**, pilih **Buat tahap**.
1. Untuk **nama Panggung**, masukkan nama, misalnya,**prod**.
**catatan**
Nama panggung hanya dapat berisi karakter alfanumerik, tanda hubung, dan garis bawah. Panjang maksimum adalah 128 karakter.
1. (Opsional). Untuk **Deskripsi**, masukkan deskripsi panggung.
1. Untuk **Deployment**, pilih tanggal dan waktu penerapan API yang ada yang ingin Anda kaitkan dengan tahap ini.
1. Di bawah **Pengaturan tambahan**, Anda dapat menentukan pengaturan tambahan untuk panggung Anda.
1. Pilih **Buat panggung**.
## Ubah pengaturan panggung
Setelah penerapan API berhasil, tahap diisi dengan pengaturan default. Anda dapat menggunakan konsol atau API Gateway REST API untuk mengubah pengaturan panggung, termasuk caching API dan logging. Jika Anda telah memodifikasi titik akhir default REST API Anda, saat Anda memperbarui tahapan, modifikasi akan disebarkan ke semua tahapan API Anda. Langkah-langkah berikut menunjukkan cara melakukannya menggunakan **editor Stage** dari konsol API Gateway.
1. Masuk ke konsol API Gateway di [https://console.aws.amazon.com/apigateway](https://console.aws.amazon.com/apigateway).
1. Pilih REST API.
1. Di panel navigasi utama, pilih **Tahapan** di bawah API.
1. Di panel **Tahapan**, pilih nama panggung.
1. Di bagian **Detail tahap**, pilih **Edit**.
1. (Opsional) Untuk **deskripsi Tahap**, edit deskripsi.
1. Untuk **pengaturan tambahan**, Anda mengubah pengaturan berikut:
**Pengaturan cache**
Untuk mengaktifkan caching API untuk stage, aktifkan **cache API Provision**. Kemudian konfigurasikan **caching tingkat metode Default, **Kapasitas cache**, **Enkripsi data cache**, Cache time-to-live (TTL), serta persyaratan apa pun untuk pembatalan** **cache** per kunci.
Caching tidak aktif sampai Anda mengaktifkan caching tingkat metode default atau mengaktifkan cache tingkat metode untuk metode tertentu.
Untuk informasi selengkapnya tentang pengaturan cache, lihat[Pengaturan cache untuk REST APIs di API Gateway](api-gateway-caching.md).
Jika Anda mengaktifkan caching API untuk tahap API, AWS akun Anda mungkin dikenakan biaya untuk caching API. Caching tidak memenuhi syarat untuk Tingkat AWS Gratis.
**Pengaturan pelambatan**
**Untuk menetapkan target pelambatan tingkat tahap untuk semua metode yang terkait dengan API ini, aktifkan Throttling.**
Untuk **Rate**, masukkan target rate. Ini adalah tarif, dalam permintaan per detik, token ditambahkan ke ember token. Tingkat tingkat tahap tidak boleh lebih dari tingkat [tingkat akun seperti yang ditentukan](api-gateway-request-throttling.md#apig-request-throttling-account-level-limits) dalam. [Kuota untuk mengonfigurasi dan menjalankan REST API di API Gateway](api-gateway-execution-service-limits-table.md)
Untuk **Burst**, masukkan target burst rate. Laju burst, adalah kapasitas ember token. Ini memungkinkan lebih banyak permintaan melalui untuk jangka waktu tertentu daripada tingkat target. Tingkat ledakan tingkat tahap ini tidak boleh lebih dari tingkat burst rate [akun seperti yang ditentukan](api-gateway-request-throttling.md#apig-request-throttling-account-level-limits) dalam. [Kuota untuk mengonfigurasi dan menjalankan REST API di API Gateway](api-gateway-execution-service-limits-table.md)
Tarif pelambatan bukanlah batas yang sulit, dan diterapkan atas dasar upaya terbaik. Dalam beberapa kasus, klien dapat melebihi target yang Anda tetapkan. Jangan mengandalkan pembatasan untuk mengontrol biaya atau memblokir akses ke API. Pertimbangkan [AWS Budgets](https://docs.aws.amazon.com/cost-management/latest/userguide/budgets-managing-costs.html)untuk menggunakan untuk memantau biaya dan [AWS WAF](https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html)mengelola permintaan API.
**Pengaturan firewall dan sertifikat**
Untuk mengaitkan ACL AWS WAF web dengan panggung, pilih ACL web dari daftar dropdown **Web ACL**. Jika diinginkan, pilih **Blokir Permintaan API jika WebACL tidak dapat dievaluasi (**Gagal- Tutup).
Untuk memilih sertifikat klien untuk tahap Anda, pilih sertifikat dari menu tarik-turun **sertifikat Klien**.
1. Pilih **Lanjutkan**.
1. Tinjau perubahan Anda dan pilih **Simpan perubahan**.
1. Untuk mengaktifkan CloudWatch Log Amazon untuk semua metode yang terkait dengan tahap API Gateway API ini, di bagian **Log dan penelusuran**, pilih **Edit**.
**catatan**
Untuk mengaktifkan CloudWatch Log, Anda juga harus menentukan ARN dari peran IAM yang memungkinkan API Gateway untuk menulis informasi ke CloudWatch Log atas nama pengguna Anda. Untuk melakukannya, pilih **Pengaturan** dari panel navigasi **APIs**utama. Kemudian, untuk **peran CloudWatch log**, masukkan ARN dari peran IAM.
Untuk skenario aplikasi umum, peran IAM dapat melampirkan kebijakan terkelola [Amazon APIGateway PushToCloudWatchLogs](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonAPIGatewayPushToCloudWatchLogs.html).
Peran IAM juga harus berisi pernyataan hubungan kepercayaan berikut:
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "",
"Effect": "Allow",
"Principal": {
"Service": "apigateway.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
Untuk informasi selengkapnya CloudWatch, lihat *[Panduan CloudWatch Pengguna Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html)*.
1. Pilih level logging dari menu dropdown **CloudWatch Log**. Level logging adalah sebagai berikut:
+ **Mati** - Logging tidak diaktifkan untuk tahap ini.
+ **Hanya kesalahan** - Logging diaktifkan hanya untuk kesalahan.
+ **Kesalahan dan info log** - Logging diaktifkan untuk semua acara.
1. Pilih **Penelusuran data** agar API Gateway melaporkan ke CloudWatch pencatatan jejak data untuk tahap Anda. Ini dapat berguna untuk memecahkan masalah APIs, tetapi dapat mengakibatkan pencatatan data sensitif.
**catatan**
Kami menyarankan Anda untuk tidak menggunakan **data tracing** untuk produksi APIs.
1. Pilih **Metrik terperinci** agar API Gateway melaporkan ke CloudWatch metrik API`API calls`,,, `Latency` `Integration latency``400 errors`, dan. `500 errors` Untuk informasi selengkapnya CloudWatch, lihat [Pemantauan dasar dan pemantauan terperinci](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch-metrics-basic-detailed.html) di Panduan CloudWatch Pengguna Amazon.
**penting**
Akun Anda dikenakan biaya untuk mengakses metrik tingkat metode, tetapi bukan CloudWatch metrik tingkat API atau tingkat tahap.
1. Untuk mengaktifkan pencatatan akses ke tujuan, aktifkan **Pencatatan akses khusus**.
1. Untuk **ARN tujuan log Access**, masukkan ARN grup log atau aliran Firehose.
Format ARN untuk Firehose adalah. `arn:aws:firehose:{{{region}}}:{{{account-id}}}:deliverystream/amazon-apigateway-{{{your-stream-name}}}` Nama aliran Firehose Anda harus. `amazon-apigateway-{{{your-stream-name}}}`
1. Dalam **format Log**, masukkan format log. Untuk mempelajari lebih lanjut tentang contoh format log, lihat[CloudWatch format log untuk API Gateway](set-up-logging.md#apigateway-cloudwatch-log-formats).
1. Untuk mengaktifkan [AWS X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-services-apigateway.html)penelusuran untuk tahap API, pilih **penelusuran X-Ray**. Untuk informasi selengkapnya, lihat [Lacak permintaan pengguna ke REST APIs menggunakan X-Ray di API Gateway](apigateway-xray.md).
1. Pilih **Simpan perubahan**. Menerapkan ulang API Anda agar pengaturan baru diterapkan.
## Ganti pengaturan tingkat panggung
Setelah menyesuaikan setelan tingkat tahap, Anda dapat menggantinya untuk setiap metode API. Beberapa opsi ini dapat mengakibatkan biaya tambahan untuk Anda Akun AWS.
1. Untuk mengonfigurasi penggantian metode, perluas panggung di bawah panel navigasi sekunder, lalu pilih metode.
1. **Untuk **penggantian Metode**, pilih Edit.**
1. Untuk mengaktifkan CloudWatch pengaturan tingkat metode, untuk **CloudWatch Log**, pilih level logging.
1. Untuk mengaktifkan pencatatan jejak data untuk metode Anda, pilih **Penelusuran data**.
**catatan**
Kami menyarankan Anda untuk tidak menggunakan **data tracing** untuk produksi APIs.
1. **Untuk mengaktifkan metrik detail tingkat metode, pilih Metrik terperinci.** Akun Anda dikenakan biaya untuk mengakses metrik tingkat metode, tetapi bukan CloudWatch metrik tingkat API atau tingkat tahap.
1. **Untuk mengaktifkan pelambatan tingkat metode, pilih Throttling.** Masukkan opsi tingkat metode yang sesuai. Untuk mempelajari selengkapnya tentang throttling, lihat. [Throttle request ke REST APIs Anda untuk throughput yang lebih baik di API Gateway](api-gateway-request-throttling.md)
1. Untuk mengkonfigurasi cache tingkat metode, pilih **Aktifkan cache metode**. Jika Anda mengubah pengaturan caching tingkat metode default di **detail Tahap**, itu tidak memengaruhi pengaturan ini.
1. Pilih **Simpan**.