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.
# Das SDK einrichten für JavaScript
In den Themen in diesem Abschnitt wird erklärt, wie das SDK JavaScript für die Verwendung in Webbrowsern und mit Node.js installiert wird. Außerdem wird gezeigt, wie das SDK geladen wird, sodass Sie auf die vom SDK unterstützten Web-Services zugreifen können.
**Anmerkung**
React Native-Entwickler sollten AWS Amplify es verwenden, um neue Projekte auf zu erstellen AWS. Einzelheiten finden Sie im [aws-sdk-react-native](https://github.com/amazon-archives/aws-sdk-react-native)Archiv.
**Topics**
+ [Voraussetzungen](jssdk-prerequisites.md)
+ [Installation des SDK für JavaScript](installing-jssdk.md)
+ [Das SDK wird geladen für JavaScript](loading-the-jssdk.md)
+ [Aktualisierung des SDK für Version 1 JavaScript](upgrading-from-v1.md)
# Voraussetzungen
Stellen Sie vor der Verwendung von fest AWS SDK für JavaScript, ob Ihr Code in Node.js oder in Webbrowsern ausgeführt werden muss. Führen Sie anschließend die folgenden Schritte aus:
+ Im Fall von Node.js installieren Sie Node.js auf Ihren Servern, wenn nicht bereits geschehen.
+ Im Fall von Webbrowsern identifizieren Sie die Browserversionen, die Sie unterstützen müssen.
**Topics**
+ [Eine AWS Node.js -Umgebung einrichten](setting-up-node.md)
+ [Unterstützte Webbrowser](browsers-supported.md)
# Eine AWS Node.js -Umgebung einrichten
Verwenden Sie eine der folgenden Methoden, um eine AWS Node.js -Umgebung einzurichten, in der Sie Ihre Anwendung ausführen können:
+ Wählen Sie ein Amazon Machine Image (AMI) mit vorinstalliertem Node.js und erstellen Sie mit diesem AMI eine Amazon EC2 EC2-Instance. Wählen Sie bei der Erstellung Ihrer Amazon EC2 EC2-Instance Ihr AMI aus der AWS Marketplace. Suchen Sie nach Node.js und wählen Sie eine AMI-Option, die eine vorinstallierte Version von Node.js (32-Bit oder 64-Bit) enthält. AWS Marketplace
+ Erstellen Sie eine Amazon EC2 EC2-Instance und installieren Sie Node.js darauf. Weitere Informationen zur Installation von Node.js auf einer Amazon Linux-Instance finden Sie unter[Tutorial: Node.js auf einer Amazon EC2 EC2-Instance einrichten](setting-up-node-on-ec2-instance.md).
+ Erstellen Sie eine serverlose Umgebung AWS Lambda , in der Sie Node.js als Lambda-Funktion ausführen. Weitere Informationen zur Verwendung von Node.js in einer Lambda-Funktion finden Sie unter [Programming Model (Node.js)](https://docs.aws.amazon.com/lambda/latest/dg/programming-model.html) im *AWS Lambda Developer Guide*.
+ Stellen Sie Ihre Node.js -Anwendung auf bereit AWS Elastic Beanstalk. Weitere Informationen zur Verwendung von Node.js mit Elastic Beanstalk finden Sie unter [Deployment Node.js Applications to AWS Elastic Beanstalk](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/create_deploy_nodejs.html) im *AWS Elastic Beanstalk Developer* Guide.
# Unterstützte Webbrowser
Das SDK für JavaScript unterstützt alle modernen Webbrowser, einschließlich der folgenden Mindestversionen:
****
| Browser | Version |
| --- | --- |
| Google Chrome | 28.0\$1 |
| Mozilla Firefox | 26.0\$1 |
| Oper | 17.0\$1 |
| Microsoft Edge | 25.10\$1 |
| Windows Internet Explorer | – |
| Apple Safari | 5\$1 |
| Android-Browser | 4.3\$1 |
**Anmerkung**
Frameworks wie AWS Amplify bieten möglicherweise nicht die gleiche Browserunterstützung wie das SDK für JavaScript. Weitere Informationen finden Sie in der Dokumentation eines Frameworks.
# Installation des SDK für JavaScript
Ob und wie Sie das installieren, AWS SDK für JavaScript hängt davon ab, ob der Code in den Modulen von Node.js oder in Browserskripten ausgeführt wird.
Nicht alle Services sind sofort im SDK verfügbar. Welche Dienste derzeit von der unterstützt werden AWS SDK für JavaScript, finden Sie unter [https://github.com/aws/aws-sdk-js/.md blob/master/SERVICES](https://github.com/aws/aws-sdk-js/blob/master/SERVICES.md)
------
#### [ Node ]
Die bevorzugte Methode zur Installation von AWS SDK für JavaScript for Node.js ist die Verwendung von [npm, dem Paketmanager Node.js](https://www.npmjs.com/). Geben Sie dazu Folgendes in der Befehlszeile ein.
```
npm install aws-sdk
```
Falls Sie folgende Fehlermeldung sehen:
```
npm WARN deprecated node-uuid@1.4.8: Use uuid module instead
```
Geben Sie die folgenden Befehle in der Befehlszeile ein:
```
npm uninstall --save node-uuid
npm install --save uuid
```
------
#### [ Browser ]
Sie müssen das SDK zur Nutzung in Browser-Skripts nicht installieren. Sie können das gehostete SDK-Paket direkt von Amazon Web Services mit einem Skript in Ihre HTML-Seiten laden. Das gehostete SDK-Paket unterstützt die Untergruppe der AWS Dienste, die die gemeinsame Nutzung von Ressourcen zwischen verschiedenen Quellen (CROSS Origin Resource Sharing, CORS) erzwingen. Weitere Informationen finden Sie unter [Das SDK wird geladen für JavaScript](loading-the-jssdk.md).
Sie können einen benutzerdefinierten Build des SDK erstellen, in dem Sie die spezifischen Web-Services und -Versionen, die Sie verwenden möchten, auswählen. Anschließend laden Sie Ihr benutzerdefiniertes SDK-Paket für die lokale Entwicklung herunter und hosten es für die Verwendung in Ihrer Anwendung. Weitere Informationen zum Erstellen eines benutzerdefinierten SDKs finden Sie unter [Erstellen des SDK für Browser](building-sdk-for-browsers.md).
Sie können minifizierte und nicht verkleinerte verteilbare Versionen der aktuellen Version von folgender Adresse herunterladen: AWS SDK für JavaScript GitHub
[https://github.com/aws/aws-sdk-js/tree/master/dist](https://github.com/aws/aws-sdk-js/tree/master/dist)
------
## Installieren mit Bower
[Bower](https://bower.io) ist ein Paket-Manager für das Web. Nachdem Sie Bower installiert haben, können Sie damit das SDK installieren. Geben Sie Folgendes in einem Terminalfenster ein, um das SDK mit Bower zu installieren:
```
bower install aws-sdk-js
```
# Das SDK wird geladen für JavaScript
Wie Sie das SDK für laden, JavaScript hängt davon ab, ob Sie es laden, um es in einem Webbrowser oder in Node.js auszuführen.
Nicht alle Services sind sofort im SDK verfügbar. Welche Dienste derzeit von der unterstützt werden AWS SDK für JavaScript, finden Sie unter [https://github.com/aws/aws-sdk-js/blob/master/SERVICES.md](https://github.com/aws/aws-sdk-js/blob/master/SERVICES.md)
------
#### [ Node.js ]
Nachdem Sie das SDK installiert haben, können Sie das AWS Paket in Ihre Node-Anwendung laden, indem `require` Sie.
```
var AWS = require('aws-sdk');
```
------
#### [ React Native ]
Um das SDK in einem React Native Projekt zu verwenden, installieren Sie zunächst das SDK mit npm:
```
npm install aws-sdk
```
Verwenden Sie den folgenden Code, um in Ihrer Anwendung auf die mit React Native kompatible Version des SDKs zu verweisen:
```
var AWS = require('aws-sdk/dist/aws-sdk-react-native');
```
------
#### [ Browser ]
Der schnellste Weg, mit dem SDK zu beginnen, besteht darin, das gehostete SDK-Paket direkt von Amazon Web Services zu laden. Um dies zu tun, fügen Sie ein `
```
[Die aktuelle SDK\$1VERSION\$1NUMBER finden Sie in der API-Referenz für das SDK im API-Referenzhandbuch. JavaScript AWS SDK für JavaScript](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/)
Nachdem das SDK in Ihrer Seite geladen wurde, ist es über die globale Variable `AWS` (oder `window.AWS`) verfügbar.
Wenn Sie zum Bündeln Ihrer Code- und Modulabhängigkeiten [browserify](http://browserify.org) verwenden, laden Sie das SDK mit `require`, genauso wie in Node.js.
------
# Aktualisierung des SDK für Version 1 JavaScript
Die folgenden Hinweise helfen Ihnen, das SDK für JavaScript von Version 1 auf Version 2 zu aktualisieren.
## Automatische Konvertierung von Base64- und Zeitstempeltypen bei Eingabe/Ausgabe
Das SDK verschlüsselt und entschlüsselt nun Base64-kodierte Werte sowie Zeitstempelwerte automatisch für den Benutzer. Diese Änderung wirkt sich auf alle Operationen aus, in denen Base64- oder Zeitstempelwerte von einer Anforderung gesendet oder in einer Antwort zurückgegeben wurden, die Base64-kodierte Werte zulässt.
Benutzer-Code, der zuvor Base64 konvertierte, ist nicht mehr erforderlich. Als Base64 verschlüsselte Werte werden jetzt von Serverantworten als Buffer-Objekte zurückgegeben und können auch als Buffer-Eingabe übergeben werden. Beispiel: Die folgenden `SQS.sendMessage`-Parameter aus Version 1:
```
var params = {
MessageBody: 'Some Message',
MessageAttributes: {
attrName: {
DataType: 'Binary',
BinaryValue: new Buffer('example text').toString('base64')
}
}
};
```
Können folgendermaßen neu geschrieben werden.
```
var params = {
MessageBody: 'Some Message',
MessageAttributes: {
attrName: {
DataType: 'Binary',
BinaryValue: 'example text'
}
}
};
```
Hier sehen Sie, wie die Nachricht gelesen wird.
```
sqs.receiveMessage(params, function(err, data) {
// buf is
var buf = data.Messages[0].MessageAttributes.attrName.BinaryValue;
console.log(buf.toString()); // "example text"
});
```
## response.data wurde verschoben. RequestId nach response.RequestID
Das SDK speichert Anfragen IDs für alle Dienste jetzt an einer konsistenten Stelle im `response` Objekt und nicht innerhalb der Eigenschaft. `response.data` Dies verbessert die Konsistenz zwischen Diensten, die Anfragen auf unterschiedliche IDs Weise bereitstellen. Auch die Umbenennung der `response.data.RequestId`-Eigenschaft in `response.requestId` (`this.requestId` innerhalb einer Callback-Funktion) ist eine wichtige Änderung.
Ändern Sie Ihren Code wie folgt:
```
svc.operation(params, function (err, data) {
console.log('Request ID:', data.RequestId);
});
```
In Folgendes:
```
svc.operation(params, function () {
console.log('Request ID:', this.requestId);
});
```
## Freigelegte Wrapper-Elemente
Wenn Sie `AWS.ElastiCache`, `AWS.RDS` oder `AWS.Redshift` verwenden, müssen Sie auf die Antwort über die Ausgabeeigenschaft der obersten Ebene in der Antwort für einige Operationen zugreifen.
Beispiel: Die `RDS.describeEngineDefaultParameters`-Methode gab Folgendes zurück.
```
{ Parameters: [ ... ] }
```
Sie gibt nun Folgendes zurück.
```
{ EngineDefaults: { Parameters: [ ... ] } }
```
Die Liste der betroffenen Operationen für jeden Service werden in der folgenden Tabelle aufgeführt.
****
| Client-Klasse | Operationen |
| --- | --- |
| `AWS.ElastiCache` | `authorizeCacheSecurityGroupIngress` `createCacheCluster` `createCacheParameterGroup` `createCacheSecurityGroup` `createCacheSubnetGroup` `createReplicationGroup` `deleteCacheCluster` `deleteReplicationGroup` `describeEngineDefaultParameters` `modifyCacheCluster` `modifyCacheSubnetGroup` `modifyReplicationGroup` `purchaseReservedCacheNodesOffering` `rebootCacheCluster` `revokeCacheSecurityGroupIngress` |
| `AWS.RDS` | `addSourceIdentifierToSubscription` `authorizeDBSecurityGroupIngress` `copyDBSnapshot` `createDBInstance` `createDBInstanceReadReplica` `createDBParameterGroup` `createDBSecurityGroup` `createDBSnapshot` `createDBSubnetGroup` `createEventSubscription` `createOptionGroup` `deleteDBInstance` `deleteDBSnapshot` `deleteEventSubscription` `describeEngineDefaultParameters` `modifyDBInstance` `modifyDBSubnetGroup` `modifyEventSubscription` `modifyOptionGroup` `promoteReadReplica` `purchaseReservedDBInstancesOffering` `rebootDBInstance` `removeSourceIdentifierFromSubscription` `restoreDBInstanceFromDBSnapshot` `restoreDBInstanceToPointInTime` `revokeDBSecurityGroupIngress` |
| `AWS.Redshift` | `authorizeClusterSecurityGroupIngress` `authorizeSnapshotAccess` `copyClusterSnapshot` `createCluster` `createClusterParameterGroup` `createClusterSecurityGroup` `createClusterSnapshot` `createClusterSubnetGroup` `createEventSubscription` `createHsmClientCertificate` `createHsmConfiguration` `deleteCluster` `deleteClusterSnapshot` `describeDefaultClusterParameters` `disableSnapshotCopy` `enableSnapshotCopy` `modifyCluster` `modifyClusterSubnetGroup` `modifyEventSubscription` `modifySnapshotCopyRetentionPeriod` `purchaseReservedNodeOffering` `rebootCluster` `restoreFromClusterSnapshot` `revokeClusterSecurityGroupIngress` `revokeSnapshotAccess` `rotateEncryptionKey` |
## Gelöschte Client-Eigenschaften
Die Eigenschaften `.Client` und `.client` wurden aus Service-Objekten entfernt. Wenn Sie die `.Client`-Eigenschaft in einer Service-Klasse oder eine `.client`-Eigenschaft in einer Service-Objekt-Instance verwenden, entfernen Sie diese aus Ihrem Code.
Der folgende Code wurde mit Version 1 des SDK verwendet für JavaScript:
```
var sts = new AWS.STS.Client();
// or
var sts = new AWS.STS();
sts.client.operation(...);
```
sollte wie folgt geändert werden.
```
var sts = new AWS.STS();
sts.operation(...)
```