View a markdown version of this page

Mengambil data konfigurasi tanpa AWS AppConfig Agen - AWS AppConfig
(Contoh) Mengambil konfigurasi dengan memanggil AWS AppConfig API

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

Mengambil data konfigurasi tanpa AWS AppConfig Agen

Cara yang disarankan untuk mengambil data konfigurasi AWS AppConfig adalah dengan menggunakan Amazon-developed dan AWS AppConfig Agen yang dikelola. Dengan agen, Anda dapat menyimpan data konfigurasi secara lokal dan secara asinkron mensurvei layanan AWS AppConfig bidang data untuk pembaruan. caching/polling Proses 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 memanggil API publik langsung dari layanan bidang AWS AppConfig data.

Layanan bidang data menggunakan dua tindakan API, StartConfigurationSession dan GetLatestConfiguration. Layanan bidang 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

Berikut cara kerja proses memanggil AWS AppConfig API secara langsung menggunakan layanan bidang data.

Aplikasi Anda mengambil data konfigurasi dengan terlebih dahulu membuat sesi konfigurasi menggunakan operasi StartConfigurationSession API. Klien sesi Anda kemudian melakukan panggilan berkala GetLatestConfiguration untuk memeriksa dan mengambil data terbaru yang tersedia.

Saat meneleponStartConfigurationSession, kode Anda mengirimkan informasi berikut:

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

  • (Opsional) Jumlah minimum waktu yang harus menunggu klien sesi di antara panggilanGetLatestConfiguration.

Sebagai tanggapan, AWS AppConfig memberikan yang InitialConfigurationToken akan diberikan kepada klien sesi dan digunakan saat pertama kali memang GetLatestConfiguration gil sesi itu.

penting

Token ini hanya boleh digunakan sekali dalam panggilan pertama Anda keGetLatestConfiguration. Anda harus menggunakan token baru dalam GetLatestConfiguration response (NextPollConfigurationToken) di setiap panggilan berikutnya keGetLatestConfiguration. Untuk mendukung kasus penggunaan jajak pendapat 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 dimilikinya dan diterima sebagai tanggapan:

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

  • NextPollIntervalInSeconds: durasi klien harus menunggu sebelum melakukan panggilan berikutnyaGetLatestConfiguration.

  • Konfigurasi: data terbaru yang ditujukan untuk sesi. 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 aKmsKeyIdentifier, permintaan Anda untuk menerima konfigurasi harus menyertakan izin untuk meneleponkms: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. Oper GetConfiguration asi API tidak mendukung konfigurasi terenkripsi.

(Contoh) Mengambil konfigurasi dengan memanggil AWS AppConfig API

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 ID (atau nama) AWS AppConfig aplikasi, lingkungan, dan profil konfigurasi. API mengembalikan yang InitialConfigurationToken digunakan untuk mengambil data konfigurasi Anda.

aws appconfigdata start-configuration-session \
    --application-identifier application_name_or_ID \
    --environment-identifier environment_name_or_ID \
    --configuration-profile-identifier configuration_profile_name_or_ID

Sistem merespons dengan informasi dalam format berikut.

{
   "InitialConfigurationToken": initial configuration token
}

Setelah memulai sesi, gunakan InitialConfigurationToken untuk memanggil GetLatestConfiguration untuk mengambil data konfigurasi Anda. Data konfigurasi disimpan ke mydata.json file.

aws appconfigdata get-latest-configuration \
    --configuration-token initial configuration token mydata.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 tanggapan sebelumnya.

aws appconfigdata get-latest-configuration \
    --configuration-token next configuration token mydata.json
penting

Perhatikan detail penting berikut tentang operasi GetLatestConfiguration API:

  • Resp GetLatestConfiguration ons mencakup Configuration bagian yang menunjukkan data konfigurasi. ConfigurationBagian ini hanya muncul jika sistem menemukan data konfigurasi baru atau diperbarui. Jika sistem tidak menemukan data konfigurasi baru atau diperbarui, maka Configuration data tersebut kosong.

  • Anda menerima yang baru ConfigurationToken di setiap tanggapan dariGetLatestConfiguration.

  • Sebaiknya sesuaikan frekuensi polling panggilan GetLatestConfiguration API berdasarkan anggaran, frekuensi penerapan konfigurasi yang diharapkan, dan jumlah target untuk konfigurasi.