

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.

# Konfigurieren von AWS AppConfig Agent Lambda-Erweiterung
<a name="appconfig-integration-lambda-extensions-config"></a>

Sie können die Erweiterung konfigurieren, indem Sie die folgenden AWS Lambda Umgebungsvariablen ändern. Weitere Informationen finden Sie [ im *AWS Lambda Entwicklerhandbuch*](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html) unter Verwenden von AWS Lambda Umgebungsvariablen. 

**Konfigurationsdaten vorab abrufen **

Die Umgebungsvariable `AWS_APPCONFIG_EXTENSION_PREFETCH_LIST` kann die Startzeit Ihrer Funktion verbessern. Wenn die AWS AppConfig Agent Lambda-Erweiterung initialisiert wird, ruft sie die angegebene Konfiguration ab, AWS AppConfig bevor Lambda beginnt, um Ihre Funktion zu initialisieren und Ihren Handler aufzurufen. In einigen Fällen sind die Konfigurationsdaten bereits im lokalen Cache verfügbar, bevor Ihre Funktion sie anfordert. 

Um die Prefetch-Funktion zu verwenden, setzen Sie den Wert der Umgebungsvariablen auf den Pfad, der Ihren Konfigurationsdaten entspricht. Wenn Ihre Konfiguration beispielsweise einer Anwendung, einer Umgebung und einem Konfigurationsprofil mit den Namen „my\_application“, „my\_environment“ und „my\_configuration\_data“ entspricht, wäre der Pfad wie folgt. `/applications/my_application/environments/my_environment/configurations/my_configuration_data` Sie können mehrere Konfigurationselemente angeben, indem Sie sie als kommagetrennte Liste auflisten (Wenn Sie einen Ressourcennamen haben, der ein Komma enthält, verwenden Sie den ID-Wert der Ressource anstelle ihres Namens). 

**Zugreifen auf Konfigurationsdaten von einem anderen Konto aus **

Die AWS AppConfig Agent Lambda-Erweiterung kann Konfigurationsdaten von einem anderen Konto abrufen, indem sie eine IAM-Rolle angibt, die [ Berechtigungen für ](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_permissions-to-switch.html) die Daten erteilt. Gehen Sie folgendermaßen vor, um dies einzurichten: 

1. Erstellen Sie in dem Konto, das für die Verwaltung der Konfigurationsdaten verwendet AWS AppConfig wird, eine Rolle mit einer Vertrauensrichtlinie, die dem Konto, das die Lambda-Funktion ausführt, Zugriff auf die `appconfig:GetLatestConfiguration` Aktionen `appconfig:StartConfigurationSession` und gewährt, zusammen mit den teilweisen oder vollständigen ARNs, die den AWS AppConfig Konfigurationsressourcen entsprechen.

1. Fügen Sie in dem Konto, auf dem die Lambda-Funktion ausgeführt wird, der Lambda-Funktion die `AWS_APPCONFIG_EXTENSION_ROLE_ARN` Umgebungsvariable mit dem ARN der in Schritt 1 erstellten Rolle hinzu.

1. (Optional) Bei Bedarf [ kann eine ](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-user_externalid.html) externe ID mithilfe der `AWS_APPCONFIG_EXTENSION_ROLE_EXTERNAL_ID` Umgebungsvariablen angegeben werden. Ebenso kann ein Sitzungsname mithilfe der `AWS_APPCONFIG_EXTENSION_ROLE_SESSION_NAME` Umgebungsvariablen konfiguriert werden.

**Anmerkung**  
Notieren Sie die folgenden Informationen:  
Die AWS AppConfig Agent Lambda-Erweiterung kann nur Daten von einem Konto abrufen. Wenn Sie eine IAM-Rolle angeben, kann die Erweiterung keine Konfigurationsdaten von dem Konto abrufen, in dem die Lambda-Funktion ausgeführt wird.
AWS Lambda protokolliert mithilfe von Amazon Logs Informationen über die AWS AppConfig Agent Lambda-Erweiterung und die Lambda-Funktion. CloudWatch 
Die folgende Tabelle enthält eine Spalte mit ** Beispielwerten**. Je nach Bildschirmauflösung müssen Sie möglicherweise zum Ende der Tabelle und dann nach rechts scrollen, um die Spalte anzuzeigen.



| Umgebungsvariable | Details | Standardwert | Beispielwerte | 
| --- | --- | --- | --- | 
| `AWS_APPCONFIG_EXTENSION_EXPERIMENT_ASSIGNMENT_LOG_DESTINATION` | Diese Umgebungsvariable ermöglicht es dem AWS AppConfig Agenten, Aufzeichnungen über die Versuchszuweisung zu protokollieren, die jedes Vorkommen einer Versuchsbehandlung erfassen, die zu einem bestimmten Zeitpunkt einer bestimmten Entität zugewiesen wurde. Mögliche Werte: `file:<path>/` gibt ein Basisverzeichnis an, in dem die Aufzeichnungen der Aufgaben auf die Festplatte geschrieben werden; `stderr` gibt an, dass die Aufzeichnungen der Aufgaben an stderr ausgegeben werden. Für diese Funktion ist die AWS AppConfig Agent Lambda-Erweiterung Version 2.0.20159 oder höher erforderlich. | Keine | `file:/tmp/aws-appconfig/assignments/`<br />`stderr` | 
| `AWS_APPCONFIG_EXTENSION_HTTP_PORT` | Diese Umgebungsvariable gibt den Port an, auf dem der lokale HTTP-Server ausgeführt wird, der die Erweiterung hostet. | 2772 | 2772 | 
| `AWS_APPCONFIG_EXTENSION_LOG_LEVEL` | Diese Umgebungsvariable gibt den Detaillierungsgrad an, den der Agent protokolliert. Jede Ebene umfasst die aktuelle Ebene und alle höheren Ebenen. Der Wert unterscheidet nicht zwischen Groß- und Kleinschreibung. Die Protokollebenen sind von den meisten bis zu den am wenigsten detaillierten: `trace` `debug``info`,`warn`, `error``fatal`, und`none`. Das `trace` Protokoll enthält detaillierte Informationen über den Agenten, einschließlich Zeitinformationen. | info | trace<br />debug<br />info<br />warnen<br />error<br />tödlich<br />Keine | 
| `AWS_APPCONFIG_EXTENSION_MAX_CONNECTIONS` | Diese Umgebungsvariable konfiguriert die maximale Anzahl von Verbindungen, von denen die Erweiterung Konfigurationen abruft. AWS AppConfig | 3 | 3 | 
| `AWS_APPCONFIG_EXTENSION_POLL_INTERVAL_SECONDS` | Diese Umgebungsvariable steuert, wie oft der Agent AWS AppConfig nach aktualisierten Konfigurationsdaten fragt. Sie können eine Anzahl von Sekunden für das Intervall angeben. Sie können auch eine Zahl mit einer Zeiteinheit angeben: s für Sekunden, m für Minuten und h für Stunden. Wenn keine Einheit angegeben ist, verwendet der Agent standardmäßig Sekunden. Zum Beispiel ergeben 60, 60 Sekunden und 1 Minute dasselbe Abfrageintervall.  | 45 | 45<br />45 Sekunden<br />5m<br />1 h | 
| `AWS_APPCONFIG_EXTENSION_POLL_TIMEOUT_MILLIS` | Diese Umgebungsvariable steuert die maximale Zeitspanne in Millisekunden, ab der die Erweiterung AWS AppConfig beim Aktualisieren von Daten im Cache auf eine Antwort wartet. Wenn die Erweiterung AWS AppConfig nicht innerhalb der angegebenen Zeit reagiert, überspringt sie dieses Abfrageintervall und gibt die zuvor aktualisierten zwischengespeicherten Daten zurück. | 3000 ms | 3000<br />300 ms<br />5 s | 
| `AWS_APPCONFIG_EXTENSION_PREFETCH_LIST` | Diese Umgebungsvariable gibt die Konfigurationsdaten an, die der Agent anfordert, AWS AppConfig sobald er gestartet wird. In einer kommagetrennten Liste können mehrere Konfigurationsbezeichner angegeben werden. Durch das Vorabrufen von Konfigurationsdaten von AWS AppConfig kann die Kaltstartzeit Ihrer Funktion erheblich reduziert werden. | Keine | MyApp:MyEnv:MyConfig<br />abcd123:efgh456:ijkl789<br />MyApp:MyEnv:Config1,MyApp:MyEnv:Config2 | 
| AWS\_APPCONFIG\_EXTENSION\_PROXY\_HEADERS | Diese Umgebungsvariable spezifiziert Header, die von dem Proxy benötigt werden, auf den in der Umgebungsvariablen verwiesen wird. AWS\_APPCONFIG\_EXTENSION\_PROXY\_URL Der Wert ist eine durch Kommas getrennte Liste von Headern. | Keine | Header: Wert<br />h1: v1, h2: v2 | 
| AWS\_APPCONFIG\_EXTENSION\_PROXY\_URL | Diese Umgebungsvariable gibt die Proxy-URL an, die für Verbindungen von der AWS AppConfig Erweiterung zu verwendet werden soll AWS-Services. HTTPSund HTTP URLs werden unterstützt. | Keine | http://localhostund URLs werden unterstützt. ----sep----:7474<br />https://my-proxy.example.com | 
| AWS\_APPCONFIG\_EXTENSION\_ROLE\_ARN | Diese Umgebungsvariable gibt den IAM-Rollen-ARN an, der einer Rolle entspricht, die von der AWS AppConfig Erweiterung zum Abrufen der Konfiguration übernommen werden sollte. | Keine | arn:aws:iam: :123456789012: role/MyRole | 
| AWS\_APPCONFIG\_EXTENSION\_ROLE\_EXTERNAL\_ID | Diese Umgebungsvariable gibt die externe ID an, die in Verbindung mit dem angenommenen Rollen-ARN verwendet werden soll. | Keine | MyExternalId | 
| AWS\_APPCONFIG\_EXTENSION\_ROLE\_SESSION\_NAME | Diese Umgebungsvariable gibt den Sitzungsnamen an, der den Anmeldeinformationen für die angenommene IAM-Rolle zugeordnet werden soll. | Keine | AWSAppConfigAgentSession | 
| AWS\_APPCONFIG\_EXTENSION\_SERVICE\_REGION | Diese Umgebungsvariable gibt eine alternative Region an, die die Erweiterung verwenden soll, um den AWS AppConfig Dienst aufzurufen. Wenn nicht definiert, verwendet die Erweiterung den Endpunkt in der aktuellen Region. | Keine | us-east-1<br />eu-west-1 | 
| `AWS_APPCONFIG_EXTENSION_MANIFEST` | Diese Umgebungsvariable konfiguriert den AWS AppConfig Agenten so, dass er zusätzliche konfigurationsspezifische Funktionen wie das Abrufen mehrerer Konten und das Speichern der Konfiguration auf der Festplatte nutzt. Weitere Informationen zu diesen Funktionen finden Sie unter [Verwenden eines Manifests, um zusätzliche Abruffunktionen zu aktivieren](appconfig-agent-how-to-use-additional-features.md).  | Keine | Bei Verwendung der Konfiguration als Manifest AWS AppConfig :. `MyApp:MyEnv:MyManifestConfig`<br />Beim Laden des Manifests von der Festplatte: `file:/path/to/manifest.json` | 
| `AWS_APPCONFIG_EXTENSION_WAIT_ON_MANIFEST` | Diese Umgebungsvariable konfiguriert den AWS AppConfig Agenten so, dass er wartet, bis das Manifest verarbeitet ist, bevor der Start abgeschlossen wird. | true | true<br />false | 