Mengambil konfigurasi dengan langsung memanggil APIs - AWS AppConfig

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

Mengambil konfigurasi dengan langsung memanggil APIs

Aplikasi Anda mengambil data konfigurasi dengan terlebih dahulu membuat sesi konfigurasi menggunakan StartConfigurationSessionAPIoperasi. Klien sesi Anda kemudian melakukan panggilan berkala GetLatestConfigurationuntuk memeriksa dan mengambil data terbaru yang tersedia.

Saat meneleponStartConfigurationSession, kode Anda mengirimkan informasi berikut:

  • Pengidentifikasi (ID atau nama) AWS AppConfig aplikasi, lingkungan, dan profil konfigurasi yang dilacak sesi.

  • (Opsional) Jumlah minimum waktu klien sesi harus menunggu di antara panggilan keGetLatestConfiguration.

Sebagai tanggapan, AWS AppConfig berikan InitialConfigurationToken untuk diberikan kepada klien sesi dan digunakan saat pertama kali memanggil GetLatestConfiguration sesi itu.

penting

Token ini hanya boleh digunakan sekali dalam panggilan pertama AndaGetLatestConfiguration. Anda harus menggunakan token baru di GetLatestConfiguration response (NextPollConfigurationToken) di setiap panggilan berikutnyaGetLatestConfiguration. Untuk mendukung kasus penggunaan polling yang panjang, token berlaku hingga 24 jam. Jika GetLatestConfiguration panggilan menggunakan token kedaluwarsa, sistem akan kembaliBadRequestException.

Saat meneleponGetLatestConfiguration, kode klien Anda mengirimkan ConfigurationToken nilai terbaru yang dimiliki dan diterima sebagai tanggapan:

  • NextPollConfigurationToken: ConfigurationToken nilai yang akan digunakan pada panggilan berikutnya keGetLatestConfiguration.

  • NextPollIntervalInSeconds: durasi yang harus ditunggu klien sebelum melakukan panggilan berikutnyaGetLatestConfiguration.

  • Konfigurasi: data terbaru yang ditujukan untuk sesi tersebut. Ini mungkin kosong jika klien sudah memiliki versi konfigurasi terbaru.

penting

Perhatikan informasi penting berikut.

  • StartConfigurationSessionAPISeharusnya hanya dipanggil sekali per aplikasi, lingkungan, profil konfigurasi, dan klien untuk membuat sesi dengan layanan. Ini biasanya dilakukan dalam startup aplikasi Anda atau segera sebelum pengambilan konfigurasi pertama.

  • Jika konfigurasi Anda digunakan menggunakan aKmsKeyIdentifier, permintaan Anda untuk menerima konfigurasi harus menyertakan izin untuk memanggilkms:Decrypt. Untuk informasi selengkapnya, lihat Dekripsi di Referensi.AWS Key Management Service API

  • APIOperasi yang sebelumnya digunakan untuk mengambil data konfigurasi,GetConfiguration, tidak digunakan lagi. GetConfigurationAPIOperasi tidak mendukung konfigurasi terenkripsi.