Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mengambil data konfigurasi tanpa Agen AWS AppConfig
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. 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 menghubungi publik APIs langsung dari layanan pesawat AWS AppConfig data.
Layanan data plane menggunakan dua tindakan API, [StartConfigurationSession](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_StartConfigurationSession.html)dan [GetLatestConfiguration](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_GetLatestConfiguration.html). Layanan pesawat data juga menggunakan [titik akhir terpisah](https://docs.aws.amazon.com/general/latest/gr/appconfig.html#appconfigdata_data_plane) dari bidang AWS AppConfig kontrol.
**catatan**
Layanan bidang data menggantikan proses pengambilan data konfigurasi sebelumnya dengan menggunakan tindakan `GetConfiguration` API. `GetConfiguration`API sudah usang.
**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 [StartConfigurationSession](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_StartConfigurationSession.html)API. Klien sesi Anda kemudian melakukan panggilan berkala [GetLatestConfiguration](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_GetLatestConfiguration.html)untuk memeriksa dan mengambil data terbaru yang tersedia.
Saat menelepon`StartConfigurationSession`, 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 Anda`GetLatestConfiguration`. Anda *harus* menggunakan token baru di `GetLatestConfiguration` response (`NextPollConfigurationToken`) di setiap panggilan berikutnya`GetLatestConfiguration`. Untuk mendukung kasus penggunaan polling yang panjang, token berlaku hingga 24 jam. Jika `GetLatestConfiguration` panggilan menggunakan token kedaluwarsa, sistem akan kembali`BadRequestException`.
Saat menelepon`GetLatestConfiguration`, kode klien Anda mengirimkan `ConfigurationToken` nilai terbaru yang dimilikinya dan diterima sebagai tanggapan:
+ `NextPollConfigurationToken`: `ConfigurationToken` nilai yang akan digunakan pada panggilan berikutnya ke`GetLatestConfiguration`.
+ `NextPollIntervalInSeconds`: durasi yang harus ditunggu klien sebelum melakukan panggilan berikutnya`GetLatestConfiguration`.
+ Konfigurasi: data terbaru yang ditujukan untuk sesi tersebut. Ini mungkin kosong jika klien sudah memiliki versi konfigurasi terbaru.
**penting**
Perhatikan informasi penting berikut.
[StartConfigurationSession](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_StartConfigurationSession.html)API 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 memanggil`kms:Decrypt`. Untuk informasi selengkapnya, lihat [Mendekripsi di Referensi AWS Key Management Service](https://docs.aws.amazon.com/kms/latest/APIReference/API_Decrypt.html) *API*.
Operasi API yang sebelumnya digunakan untuk mengambil data konfigurasi`GetConfiguration`, tidak digunakan lagi. Operasi `GetConfiguration` API 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-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](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_StartConfigurationSession.html#API_appconfigdata_StartConfigurationSession_ResponseSyntax)untuk memanggil [GetLatestConfiguration](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_GetLatestConfiguration.html)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 dari`StartConfigurationSession`. 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-token next configuration token mydata.json
```
**penting**
Perhatikan detail penting berikut tentang operasi `GetLatestConfiguration` API:
`GetLatestConfiguration`Respons mencakup `Configuration` bagian yang menunjukkan data konfigurasi. `Configuration`Bagian ini hanya muncul jika sistem menemukan data konfigurasi baru atau yang diperbarui. Jika sistem tidak menemukan data konfigurasi baru atau yang diperbarui, maka `Configuration` datanya kosong.
Anda menerima yang baru `ConfigurationToken` dalam setiap tanggapan dari`GetLatestConfiguration`.
Sebaiknya atur frekuensi polling panggilan `GetLatestConfiguration` API Anda berdasarkan anggaran, frekuensi penerapan konfigurasi yang diharapkan, dan jumlah target untuk konfigurasi.