Konfigurationen durch direktes Aufrufen abrufen APIs - AWS AppConfig

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.

Konfigurationen durch direktes Aufrufen abrufen APIs

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

Wenn Sie anrufenStartConfigurationSession, 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 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.

  • Der StartConfigurationSessionAPIsollte 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 APIReferenz.

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