Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Cara yang disarankan untuk mengambil data konfigurasi AWS AppConfig adalah dengan menggunakan Agen yang dikembangkan dan dikelola Amazon. AWS AppConfig Dengan agen, Anda dapat menyimpan data konfigurasi secara lokal dan secara asinkron melakukan polling layanan pesawat AWS AppConfig data untuk pembaruan. Proses caching/polling ini memastikan bahwa data konfigurasi Anda selalu tersedia untuk aplikasi Anda sambil meminimalkan latensi dan biaya. Jika Anda memilih untuk tidak menggunakan agen, Anda dapat menghubungi publik APIs langsung dari layanan pesawat AWS AppConfig data.
Layanan data plane menggunakan dua tindakan API, StartConfigurationSessiondan GetLatestConfiguration. Layanan pesawat data juga menggunakan titik akhir terpisah dari bidang AWS AppConfig kontrol.
catatan
Layanan bidang data menggantikan proses pengambilan data konfigurasi sebelumnya dengan menggunakan tindakan GetConfiguration API. GetConfigurationAPI tidak digunakan lagi.
Cara kerjanya
Begini cara kerja proses panggilan langsung AWS AppConfig APIs menggunakan layanan pesawat data.
Aplikasi Anda mengambil data konfigurasi dengan terlebih dahulu membuat sesi konfigurasi menggunakan operasi StartConfigurationSessionAPI. 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 ke
GetLatestConfiguration.
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:ConfigurationTokennilai 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.
-
StartConfigurationSessionAPI hanya boleh 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 a
KmsKeyIdentifier, permintaan Anda untuk menerima konfigurasi harus menyertakan izin untuk memanggilkms:Decrypt. Untuk informasi selengkapnya, lihat Mendekripsi di Referensi AWS Key Management Service API. -
Operasi API yang sebelumnya digunakan untuk mengambil data konfigurasi
GetConfiguration, tidak digunakan lagi. OperasiGetConfigurationAPI tidak mendukung konfigurasi terenkripsi.
(Contoh) Mengambil konfigurasi dengan memanggil AWS AppConfig APIs
AWS CLI Contoh berikut menunjukkan cara mengambil data konfigurasi dengan menggunakan operasi AWS AppConfig Data StartConfigurationSession dan GetLatestConfiguration API. Perintah pertama memulai sesi konfigurasi. Panggilan ini mencakup IDs (atau nama) AWS AppConfig aplikasi, lingkungan, dan profil konfigurasi. API mengembalikan sebuah yang InitialConfigurationToken digunakan untuk mengambil data konfigurasi Anda.
aws appconfigdata start-configuration-session \ --application-identifierapplication_name_or_ID\ --environment-identifierenvironment_name_or_ID\ --configuration-profile-identifierconfiguration_profile_name_or_ID
Sistem merespons dengan informasi dalam format berikut.
{ "InitialConfigurationToken":initial configuration token}
Setelah memulai sesi, gunakan InitialConfigurationTokenuntuk memanggil GetLatestConfigurationuntuk mengambil data konfigurasi Anda. Data konfigurasi disimpan ke mydata.json file.
aws appconfigdata get-latest-configuration \ --configuration-tokeninitial configuration tokenmydata.json
Panggilan pertama untuk GetLatestConfiguration menggunakan yang ConfigurationToken diperoleh dariStartConfigurationSession. Informasi berikut dikembalikan.
{ "NextPollConfigurationToken" :next configuration token, "ContentType" :content type of configuration, "NextPollIntervalInSeconds" :60}
Panggilan selanjutnya GetLatestConfiguration harus diberikan NextPollConfigurationToken dari respons sebelumnya.
aws appconfigdata get-latest-configuration \ --configuration-tokennext configuration tokenmydata.json
penting
Perhatikan detail penting berikut tentang operasi GetLatestConfiguration API:
-
GetLatestConfigurationResponsnya mencakupConfigurationbagian yang menunjukkan data konfigurasi.ConfigurationBagian ini hanya muncul jika sistem menemukan data konfigurasi baru atau yang diperbarui. Jika sistem tidak menemukan data konfigurasi baru atau yang diperbarui, makaConfigurationdatanya kosong. -
Anda menerima yang baru
ConfigurationTokendalam setiap tanggapan dariGetLatestConfiguration. -
Sebaiknya atur frekuensi polling panggilan
GetLatestConfigurationAPI Anda berdasarkan anggaran, frekuensi penerapan konfigurasi yang diharapkan, dan jumlah target untuk konfigurasi.
