Konfigurationen durch direktes Aufrufen von APIs abrufen

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

Beim Aufrufen StartConfigurationSession sendet Ihr Code die folgenden Informationen:

• Identifikatoren (ID oder Name) einer AWS AppConfig Anwendung, einer Umgebung und eines Konfigurationsprofils, das in der Sitzung verfolgt wird.

• (Optional) Die Mindestzeit, die der Client der Sitzung zwischen Aufrufen an GetLatestConfiguration warten muss.

AWS AppConfig Stellt als Antwort eine InitialConfigurationToken bereit, die dem Client der Sitzung übergeben und verwendet werden soll, wenn er diese Sitzung GetLatestConfiguration zum ersten Mal aufruft.

Wichtig

Dieses Token sollte bei Ihrem ersten Aufruf von nur einmal verwendet werdenGetLatestConfiguration. Sie müssen das neue Token in der GetLatestConfiguration Antwort (NextPollConfigurationToken) bei jedem nachfolgenden Aufruf von verwendenGetLatestConfiguration. Um Anwendungsfälle mit langen Umfragen zu unterstützen, sind die Token bis zu 24 Stunden gültig. Wenn ein GetLatestConfiguration Anruf ein abgelaufenes Token verwendet, kehrt das System zurückBadRequestException.

Wenn Sie anrufenGetLatestConfiguration, sendet Ihr Client-Code den neuesten ConfigurationToken Wert, den er hat, und empfängt ihn als Antwort:

• NextPollConfigurationToken: der ConfigurationToken Wert, der beim nächsten Aufruf von verwendet werden sollGetLatestConfiguration.

• NextPollIntervalInSeconds: Die Dauer, für die der Client warten soll, bevor er seinen nächsten Anruf tätigtGetLatestConfiguration.

• Die Konfiguration: Die neuesten Daten, die für die Sitzung vorgesehen sind. Dies kann leer sein, wenn der Client bereits über die neueste Version der Konfiguration verfügt.

Wichtig

Notieren Sie die folgenden wichtigen Informationen.

• Die StartConfigurationSitzungs-API sollte nur einmal pro Anwendung, Umgebung, Konfigurationsprofil und Client aufgerufen werden, um eine Sitzung mit dem Dienst einzurichten. Dies erfolgt in der Regel beim Start Ihrer Anwendung oder unmittelbar vor dem ersten Abrufen einer Konfiguration.

• Wenn Ihre Konfiguration mithilfe von bereitgestellt wirdKmsKeyIdentifier, muss Ihre Anforderung zum Empfang der Konfiguration die Berechtigung zum Aufrufen kms:Decrypt enthalten. Weitere Informationen finden Sie unter Decrypt in der AWS Key Management Service API-Referenz.

• Der API-Vorgang, der zuvor zum Abrufen von Konfigurationsdaten verwendet wurdeGetConfiguration, ist veraltet. Der GetConfiguration API-Vorgang unterstützt keine verschlüsselten Konfigurationen.

Ein Konfigurationsbeispiel wird abgerufen

Das folgende AWS CLI Beispiel zeigt, wie Konfigurationsdaten mithilfe der AWS AppConfig Daten StartConfigurationSession - und GetLatestConfiguration API-Operationen abgerufen werden. Mit dem ersten Befehl wird eine Konfigurationssitzung gestartet. 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 wurde.

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
}

Rufen Sie nach dem Start einer Sitzung mithilfe von InitialConfigurationToken GetLatest Configuration auf, 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 von GetLatestConfiguration verwendet das von ConfigurationToken erhalteneStartConfigurationSession. 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 resultieren.

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

Wichtig

Beachten Sie die folgenden wichtigen Details zum GetLatestConfiguration API-Vorgang:

• Die GetLatestConfiguration Antwort enthält einen Configuration Abschnitt, in dem die Konfigurationsdaten angezeigt werden. Der Configuration Abschnitt wird nur angezeigt, wenn das System neue oder aktualisierte Konfigurationsdaten findet. Wenn das System keine neuen oder aktualisierten Konfigurationsdaten findet, sind die Configuration Daten leer.

• Sie erhalten ConfigurationToken in jeder Antwort von ein neuesGetLatestConfiguration.

• Wir empfehlen, die Abfragehäufigkeit Ihrer GetLatestConfiguration-API-Aufrufe basierend auf Ihrem Budget, der erwarteten Häufigkeit der Konfigurationsbereitstellungen und der Anzahl der Ziele für eine Konfiguration zu optimieren.