Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Di API Gateway, penerapan REST API diwakili oleh sumber daya Deployment. Ini mirip dengan executable API yang diwakili oleh sumber daya. RestApi
Agar klien dapat memanggil API Anda, Anda harus membuat penerapan dan mengaitkan tahapan dengannya. Sebuah panggung diwakili oleh sumber daya Panggung. 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 diSiapkan panggung untuk REST API di API Gateway.
Buat deployment
Prosedur berikut menunjukkan cara membuat penerapan untuk REST API.
Anda harus telah membuat REST API sebelum menerapkannya untuk pertama kalinya. Untuk informasi selengkapnya, lihat Kembangkan REST APIs di API Gateway.
Konsol API Gateway memungkinkan Anda men-deploy API dengan membuat deployment dan mengaitkannya dengan tahap baru atau yang sudah ada.
Masuk ke konsol API Gateway di https://console.aws.amazon.com/apigateway
. -
Di panel APIsnavigasi, pilih API yang ingin Anda terapkan.
-
Di panel Resources, pilih Deploy API.
-
Untuk Stage, pilih dari berikut ini:
-
Untuk membuat tahap baru, pilih Tahap baru, lalu masukkan nama di Nama panggung. Secara opsional, Anda dapat memberikan deskripsi untuk penyebaran dalam deskripsi Deployment.
-
Untuk memilih tahap yang ada, pilih nama panggung dari menu tarik-turun. Anda mungkin ingin memberikan deskripsi penerapan baru dalam deskripsi Deployment.
-
Untuk membuat penyebaran yang tidak terkait dengan tahap, pilih Tidak ada tahap. Nanti, Anda dapat mengaitkan penerapan ini dengan sebuah panggung.
-
-
Pilih Deploy.
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
Setelah memodifikasi pengaturan tahap, Anda harus menerapkan ulang API agar perubahan diterapkan.
catatan
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.
-
Jika Anda belum berada di panel Tahapan, di panel navigasi utama, pilih Tahapan.
Pilih tahap yang ingin Anda perbarui.
-
Pada tab Riwayat Deployment, pilih penyebaran yang ingin Anda gunakan untuk tahap.
-
Pilih Ubah penerapan aktif.
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 diMenggunakan variabel stage untuk REST API di API Gateway.
