Die AWS SDK für JavaScript Version 2 ist erreicht end-of-support. Wir empfehlen Ihnen, auf [AWS SDK für JavaScript Version 3](https://docs.aws.amazon.com//sdk-for-javascript/v3/developer-guide/) zu migrieren. Weitere Einzelheiten und Informationen zur Migration finden Sie in dieser [Ankündigung](https://aws.amazon.com/blogs//developer/announcing-end-of-support-for-aws-sdk-for-javascript-v2/).
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.
# Verwenden des Global Configuration Object
Es gibt zwei Möglichkeiten, das SDK zu konfigurieren:
+ Legen Sie die globale Konfiguration mithilfe von `AWS.Config` fest.
+ Übergeben Sie zusätzliche Konfigurationsinformationen an ein Serviceobjekt.
Das Festlegen der globalen Konfiguration mithilfe von `AWS.Config` ist häufig zu Beginn einfacher, aber die Service-Level-Konfiguration bietet mehr Kontrolle über die einzelnen Services. Die über `AWS.Config` festgelegte globale Konfiguration bietet Standardeinstellungen, die auf die anschließend von Ihnen erstellten Serviceobjekte angewandt werden und deren Konfiguration vereinfachen. Sie können jedoch die Konfiguration der einzelnen Serviceobjekte aktualisieren, sollten Ihre Anforderungen von der globalen Konfiguration abweichen.
## Einrichten der globalen Konfiguration
Nachdem Sie das `aws-sdk`-Paket in Ihren Code geladen haben, können Sie die globale Variable ` AWS` verwenden, um auf die SDK-Klassen zuzugreifen und mit einzelnen Services zu interagieren. Das SDK enthält ein globales Konfigurationsobjekt, `AWS.Config`, über das Sie die SDK-Konfigurationseinstellungen angeben können, die von Ihrer Anwendung benötigt werden.
Konfigurieren Sie das SDK, indem Sie `AWS.Config`-Eigenschaften entsprechend Ihren Anwendungsanforderungen festlegen. Die folgende Tabelle bietet eine Übersicht über `AWS.Config`-Eigenschaften, die bei der Konfiguration des SDK häufig verwendet werden.
****
| Konfigurationsoptionen | Description |
| --- | --- |
| credentials | Pflichtfeld Gibt die Anmeldeinformationen an, die für den Zugriff auf Services und Ressourcen verwendet werden. |
| region | Pflichtfeld Gibt die Region an, in der Anfragen für Dienste vorgenommen werden. |
| maxRetries | Optional. Gibt die maximale Anzahl der Wiederholungsversuche für eine bestimmte Anforderung an. |
| logger | Optional. Gibt ein Logger-Objekt an, auf das die Debugging-Informationen geschrieben wurden. |
| update | Optional. Aktualisiert die aktuelle Konfiguration mit neuen Werten. |
Weitere Informationen zum Konfigurationsobjekt finden Sie [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Config.html](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Config.html)in der API-Referenz.
### Globale Konfigurationsbeispiele
Sie müssen die Region und die Anmeldeinformationen in `AWS.Config` festlegen. Sie können diese Eigenschaften als Teil des `AWS.Config`-Konstruktors definieren, wie im folgenden Browser-Skriptbeispiel gezeigt:
```
var myCredentials = new AWS.CognitoIdentityCredentials({IdentityPoolId:'IDENTITY_POOL_ID'});
var myConfig = new AWS.Config({
credentials: myCredentials, region: 'us-west-2'
});
```
Sie können diese Eigenschaften auch nach dem Erstellen von `AWS.Config` mithilfe der `update`-Methode festlegen, wie im folgenden Beispiel anhand der Aktualisierung der Region gezeigt:
```
myConfig = new AWS.Config();
myConfig.update({region: 'us-east-1'});
```
Sie können Ihre Standard-Anmeldeinformationen abrufen, indem Sie die statische ` getCredentials`-Methode `AWS.config` aufrufen:
```
var AWS = require("aws-sdk");
AWS.config.getCredentials(function(err) {
if (err) console.log(err.stack);
// credentials not loaded
else {
console.log("Access key:", AWS.config.credentials.accessKeyId);
}
});
```
Wenn Sie Ihre Region in Ihrer `config` Datei korrekt angegeben haben, erhalten Sie diesen Wert auf ähnliche Weise, indem Sie die `AWS_SDK_LOAD_CONFIG` Umgebungsvariable is auf einen beliebigen Wert setzen und die statische `region` Eigenschaft von aufrufen`AWS.config`:
```
var AWS = require("aws-sdk");
console.log("Region: ", AWS.config.region);
```
## Festlegen der Konfiguration nach Service
Auf jeden Dienst, den Sie im SDK verwenden, JavaScript wird über ein Dienstobjekt zugegriffen, das Teil der API für diesen Dienst ist. Um beispielsweise auf den Amazon S3 S3-Service zuzugreifen, erstellen Sie das Amazon S3 S3-Serviceobjekt. Sie können für einen bestimmten Service Konfigurationseinstellungen als Teil des Konstruktors für dieses Serviceobjekt definieren. Wenn Sie die Konfigurationswerte auf einem Serviceobjekt festlegen, übernimmt der Konstruktor alle Konfigurationswerte, die von `AWS.Config` verwendet werden, einschließlich der Anmeldeinformationen.
Wenn Sie beispielsweise auf Amazon EC2-Objekte in mehreren Regionen zugreifen müssen, erstellen Sie ein Amazon EC2-Serviceobjekt für jede Region und legen Sie dann die Regionskonfiguration für jedes Serviceobjekt entsprechend fest.
```
var ec2_regionA = new AWS.EC2({region: 'ap-southeast-2', maxRetries: 15, apiVersion: '2014-10-01'});
var ec2_regionB = new AWS.EC2({region: 'us-east-1', maxRetries: 15, apiVersion: '2014-10-01'});
```
Sie können die Konfigurationswerte für einen bestimmten Service auch definieren, wenn Sie das SDK mithilfe von `AWS.Config` konfigurieren. Das globale Konfigurationsobjekt unterstützt viele servicespezifische Konfigurationsoptionen. Weitere Informationen zur servicespezifischen Konfiguration finden Sie [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Config.html](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Config.html)in der AWS SDK für JavaScript API-Referenz.
## Unveränderliche Konfigurationsdaten
Globale Konfigurationsänderungen gelten für Anfragen für alle neu erstellten Serviceobjekte. Neu erstellte Serviceobjekte werden zunächst mit den aktuellen globalen Konfigurationsdaten und anschließend mit den lokalen Konfigurationsoptionen konfiguriert. Am globalen `AWS.config`-Objekt vorgenommene Aktualisierungen gelten nicht für zuvor erstellte Serviceobjekte.
Vorhandene Serviceobjekte müssen manuell mit neuen Konfigurationsdaten aktualisiert werden oder Sie müssen ein neues Serviceobjekt erstellen und verwenden, welches über die neuen Konfigurationsdaten verfügt. Das folgende Beispiel erstellt ein neues Amazon S3 S3-Serviceobjekt mit neuen Konfigurationsdaten:
```
s3 = new AWS.S3(s3.config);
```