Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Abrufen von Konfigurationsdaten ohne AWS AppConfig Agent

Die empfohlene Methode zum Abrufen von Konfigurationsdaten von AWS AppConfig ist die Verwendung des Amazon-developed und verwalteten AWS AppConfig Agenten. Mit dem Agenten können Sie Konfigurationsdaten lokal zwischenspeichern und den AWS AppConfig Datenebenendienst asynchron nach Updates abfragen. Dieser caching/polling Prozess stellt sicher, dass Ihre Konfigurationsdaten für Ihre Anwendung immer verfügbar sind, und minimiert gleichzeitig Latenz und Kosten. Wenn Sie den Agenten lieber nicht verwenden möchten, können Sie öffentliche APIs direkt vom AWS AppConfig Datenebenendienst aus aufrufen.

Der Datenebenendienst verwendet zwei API-Aktionen, StartConfigurationSession und GetLatestConfiguration. Der Datenebenendienst verwendet auch separate Endpunkte von der AWS AppConfig Steuerungsebene.

Funktionsweise

So funktioniert das direkte Aufrufen von AWS AppConfig APIs mithilfe des Datenebenendienstes.

Ihre Anwendung ruft Konfigurationsdaten ab, indem sie zunächst mithilfe des StartConfigurationSession API-Vorgangs eine Konfigurationssitzung einrichtet. Der Client Ihrer Sitzung ruft dann regelmäßig auf, um GetLatestConfiguration nach den neuesten verfügbaren Daten zu suchen und diese abzurufen.

Wenn Sie anrufenStartConfigurationSession, sendet Ihr Code die folgenden Informationen:

AWS AppConfig Stellt als Antwort eine InitialConfigurationToken an den Client der Sitzung zur Verfügung, die beim ersten Aufruf GetLatestConfiguration der Sitzung verwendet werden kann.

Beim Anruf sendet Ihr Client-Code den neuesten ConfigurationToken WertGetLatestConfiguration, den er hat, und erhält als Antwort:

(Beispiel) Abrufen einer Konfiguration durch Aufrufen AWS AppConfig APIs

Das folgende AWS CLI Beispiel zeigt, wie Konfigurationsdaten mithilfe der AWS AppConfig Daten StartConfigurationSession - und GetLatestConfiguration API-Operationen abgerufen werden. Der erste Befehl startet eine Konfigurationssitzung. Dieser Aufruf beinhaltet die IDs (oder Namen) der AWS AppConfig Anwendung, der Umgebung und des Konfigurationsprofils. Die API gibt einen zurück, der zum Abrufen Ihrer Konfigurationsdaten InitialConfigurationToken verwendet wird.

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 

Das System gibt Informationen im folgenden Format zurück.

{
   "InitialConfigurationToken": initial configuration token
}

Verwenden Sie nach dem Start einer Sitzung InitialConfigurationToken den Befehl to call, GetLatestConfiguration um Ihre Konfigurationsdaten abzurufen. Die Konfigurationsdaten werden in der mydata.json Datei gespeichert.

aws appconfigdata get-latest-configuration \
    --configuration-token initial configuration token mydata.json

Der erste Aufruf, der das ConfigurationToken erhaltene von GetLatestConfiguration verwendetStartConfigurationSession. Die folgenden Informationen werden zurückgegeben.

{
    "NextPollConfigurationToken" : next configuration token,
    "ContentType" : content type of configuration,
    "NextPollIntervalInSeconds" : 60
}  

Nachfolgende Aufrufe von GetLatestConfiguration müssen NextPollConfigurationToken aus der vorherigen Antwort stammen.

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