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.

# Erste Schritte mit dem AWS SDK für JavaScript
<a name="getting-started"></a>

Der AWS SDK für JavaScript ermöglicht den Zugriff auf Webdienste entweder in Browserskripten oder in Node.js. In diesem Abschnitt finden Sie zwei Übungen für den Einstieg, die Ihnen zeigen, wie Sie mit dem SDK für JavaScript jede dieser JavaScript Umgebungen arbeiten.

**Topics**
+ [Erste Schritte in einem Browser-Skript](getting-started-browser.md)
+ [Erste Schritte in Node.js](getting-started-nodejs.md)

# Erste Schritte in einem Browser-Skript
<a name="getting-started-browser"></a>

![\[JavaScript code example that applies to browser execution\]](http://docs.aws.amazon.com/de_de/sdk-for-javascript/v2/developer-guide/images/browsericon.png)

**Dieses Beispiel eines Browser-Skripts zeigt Ihnen:**
+ So greifen Sie mit Amazon Cognito Identity über ein Browserskript auf AWS Dienste zu.
+ So verwandeln Sie Text mit Amazon Polly in synthetisierte Sprache.
+ Wie ein Presigner-Objekt verwendet wird, um eine vorsignierte URL zu erstellen.

## Das Szenario
<a name="getting-started-browser-scenario"></a>

Amazon Polly ist ein Cloud-Service, der Text in naturgetreue Sprache umwandelt. Sie können Amazon Polly verwenden, um Anwendungen zu entwickeln, die das Engagement und die Barrierefreiheit erhöhen. Amazon Polly unterstützt mehrere Sprachen und beinhaltet eine Vielzahl lebensechter Stimmen. Weitere Informationen zu Amazon Polly finden Sie im [https://docs.aws.amazon.com/polly/latest/dg/](https://docs.aws.amazon.com/polly/latest/dg/).

Das Beispiel zeigt, wie Sie ein einfaches Browser-Skript einrichten und ausführen, das den von Ihnen eingegebenen Text aufnimmt, diesen Text an Amazon Polly sendet und dann die URL des synthetisierten Audios des Textes zurückgibt, damit Sie ihn abspielen können. Das Browserskript verwendet Amazon Cognito Identity, um Anmeldeinformationen bereitzustellen, die für den Zugriff auf AWS Dienste erforderlich sind. Sie werden die grundlegenden Muster für das Laden und Verwenden des SDK JavaScript in Browserskripten sehen.

**Anmerkung**  
Das Abspielen der Sprachausgabe in diesem Beispiel hängt davon ab, ob Sie einen Browser ausführen, der HTML 5-Audio unterstützt.

![\[Veranschaulichung der Interaktion eines Browser-Skripts mit den Diensten Amazon Cognito Identity und Amazon Polly\]](http://docs.aws.amazon.com/de_de/sdk-for-javascript/v2/developer-guide/images/browserscenario.png)


Das Browserskript verwendet das SDK, um Text mithilfe der JavaScript folgenden Komponenten zu synthetisieren: APIs
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/CognitoIdentityCredentials.html](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/CognitoIdentityCredentials.html) Konstruktor
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Polly/Presigner.html](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Polly/Presigner.html) Konstruktor
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Polly/Presigner.html#getSynthesizeSpeechUrl-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Polly/Presigner.html#getSynthesizeSpeechUrl-property)

## Schritt 1: Erstellen Sie einen Amazon Cognito Cognito-Identitätspool
<a name="getting-started-browser-create-identity-pool"></a>

In dieser Übung erstellen und verwenden Sie einen Amazon Cognito Cognito-Identitätspool, um nicht authentifizierten Zugriff auf Ihr Browserskript für den Amazon Polly bereitzustellen. Durch die Erstellung eines Identitätspools werden auch zwei IAM-Rollen erstellt, eine zur Unterstützung von Benutzern, die von einem Identitätsanbieter authentifiziert wurden, und die andere zur Unterstützung nicht authentifizierter Gastbenutzer.

In dieser Übung arbeiten wir nur mit der Rolle für nicht authentifizierte Benutzer, um uns auf die Aufgabe zu konzentrieren. Sie können die Unterstützung für einen Identitätsanbieter und authentifizierte Benutzer zu einem späteren Zeitpunkt integrieren. Weitere Informationen zum Hinzufügen eines Amazon Cognito-Identitätspools finden Sie unter [Tutorial: Creating an Identity Pool](https://docs.aws.amazon.com/cognito/latest/developerguide/tutorial-create-identity-pool.html) im *Amazon Cognito Developer Guide*.

**So erstellen Sie einen Amazon Cognito Cognito-Identitätspool**

1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon Cognito Cognito-Konsole unter [https://console.aws.amazon.com/cognito/](https://console.aws.amazon.com/cognito/).

1. Wählen Sie im linken Navigationsbereich **Identity Pools** aus.

1. Wählen Sie **Identitätspool erstellen**.

1. Wählen Sie unter **Vertrauensstellung im Identitätspool konfigurieren** die Option **Gastzugriff** für die Benutzerauthentifizierung aus.

1. Wählen **Sie unter Berechtigungen konfigurieren** die Option **Neue IAM-Rolle erstellen** aus und geben Sie einen Namen (z. B. *getStartedRole*) in den **IAM-Rollennamen** ein.

1. Geben **Sie unter Eigenschaften konfigurieren** einen Namen ein (z. B. *getStartedPool*) im Feld **Identitätspoolname**.

1. Bestätigen Sie unter **Überprüfen und erstellen** die Auswahl, die Sie für Ihren neuen Identitätspool getroffen haben. Wählen Sie **Bearbeiten**, um zum Assistenten zurückzukehren und Einstellungen zu ändern. Wählen Sie danach **Identitätspool erstellen** aus.

1. Notieren Sie sich die **Identitätspool-ID** und die **Region** des neu erstellten Amazon Cognito Cognito-Identitätspools. Sie benötigen diese Werte, um sie zu ersetzen *IDENTITY\$1POOL\$1ID* und einzugeben*REGION*. [Schritt 4: Schreiben des Browser-Skripts](#getting-started-browser-write-sample)

Nachdem Sie Ihren Amazon Cognito Cognito-Identitätspool erstellt haben, können Sie Berechtigungen für Amazon Polly hinzufügen, die von Ihrem Browserskript benötigt werden.

## Schritt 2: Fügen Sie der erstellten IAM-Rolle eine Richtlinie hinzu
<a name="getting-started-browser-iam-role"></a>

Um den Browserskriptzugriff auf Amazon Polly für die Sprachsynthese zu aktivieren, verwenden Sie die nicht authentifizierte IAM-Rolle, die für Ihren Amazon Cognito Cognito-Identitätspool erstellt wurde. Dazu müssen Sie der Rolle eine IAM-Richtlinie hinzufügen. Weitere Informationen zum Ändern von IAM-Rollen finden Sie unter [Ändern einer Rollenberechtigungsrichtlinie](https://docs.aws.amazon.com/IAM/latest/UserGuide/roles-managingrole-editing-console.html#roles-modify_permissions-policy) im *IAM-Benutzerhandbuch*.

**So fügen Sie der IAM-Rolle, die nicht authentifizierten Benutzern zugeordnet ist, eine Amazon Polly Polly-Richtlinie hinzu**

1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die IAM-Konsole unter. [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)

1. Wählen Sie im linken Navigationsbereich **Roles** aus.

1. Wählen Sie den Namen der Rolle aus, die Sie ändern möchten (z. B. *getStartedRole*), und wählen Sie dann die Registerkarte **Berechtigungen**.

1. Wählen Sie **Berechtigungen hinzufügen** aus und wählen Sie dann **Richtlinien anfügen** aus.

1. Suchen Sie auf der Seite „**Berechtigungen hinzufügen**“ für diese Rolle nach dem Kontrollkästchen für und aktivieren Sie es **AmazonPollyReadOnly**.
**Anmerkung**  
Sie können diesen Prozess verwenden, um den Zugriff auf jeden AWS Dienst zu aktivieren.

1. Wählen Sie **Add permissions** (Berechtigungen hinzufügen) aus.

Nachdem Sie Ihren Amazon Cognito Cognito-Identitätspool erstellt und Ihrer IAM-Rolle für nicht authentifizierte Benutzer Berechtigungen für Amazon Polly hinzugefügt haben, können Sie die Webseite und das Browserskript erstellen.

## Schritt 3: Erstellen der HTML-Seite
<a name="getting-started-browser-create-html"></a>

Die Beispielanwendung besteht aus einer einzelnen HTML-Seite, die die Benutzeroberfläche und das Browser-Skript enthält. Um zu beginnen, erstellen Sie ein HTML-Dokument und kopieren Sie in dieses den folgenden Inhalt. Die Seite enthält ein Eingabefeld und eine Schaltfläche, ein `<audio>`-Element zum Abspielen der Sprachausgabe und ein `<p>`-Element zum Anzeigen von Nachrichten. (Beachten Sie, dass das vollständige Beispiel unten auf dieser Seite angezeigt wird.)

Weitere Informationen zum `<audio>`-Element finden Sie unter [Audio](https://www.w3schools.com/tags/tag_audio.asp).

```
<!DOCTYPE html>
<html>
  <head>
    <meta charset="UTF-8">
    <title>AWS SDK for JavaScript - Browser Getting Started Application</title>
  </head>

  <body>
    <div id="textToSynth">
      <input autofocus size="23" type="text" id="textEntry" value="It's very good to meet you."/>
      <button class="btn default" onClick="speakText()">Synthesize</button>
      <p id="result">Enter text above then click Synthesize</p>
    </div>
    <audio id="audioPlayback" controls>
      <source id="audioSource" type="audio/mp3" src="">
    </audio>
    <!-- (script elements go here) -->
 </body>
</html>
```

Speichern Sie die HTML-Datei und nennen Sie diese `polly.html`. Nach dem Erstellen der Benutzeroberfläche für die Anwendung können Sie den Browser-Skriptcode hinzufügen, der die Anwendung ausführt.

## Schritt 4: Schreiben des Browser-Skripts
<a name="getting-started-browser-write-sample"></a>

Wenn Sie das Browser-Skript erstellen, müssen Sie zunächst das SDK für einbeziehen, JavaScript indem Sie ein `<script>` Element nach dem Element auf der `<audio>` Seite hinzufügen. [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/)

```
<script src="https://sdk.amazonaws.com/js/aws-sdk-SDK_VERSION_NUMBER.min.js"></script>
```

Fügen Sie dann ein neues `<script type="text/javascript">`-Element nach dem SDK-Eintrag hinzu. Sie fügen das Browser-Skript diesem Element hinzu. Legen Sie die AWS Region und die Anmeldeinformationen für das SDK fest. Als Nächstes erstellen Sie eine Funktion mit dem Namen `speakText()`, die von der Schaltfläche als Ereignishandler aufgerufen wird.

Um Sprache mit Amazon Polly zu synthetisieren, müssen Sie eine Vielzahl von Parametern angeben, darunter das Soundformat der Ausgabe, die Abtastrate, die ID der zu verwendenden Stimme und den wiederzugeben Text. Wenn Sie erstmalig die Parameter erstellen, setzen Sie den `Text:`-Parameter auf eine leere Zeichenfolge; der `Text:`-Parameter wird auf den Wert gesetzt, den Sie aus dem `<input>`-Element auf der Webseite abgerufen haben. Ersetzen Sie *IDENTITY\$1POOL\$1ID* und *REGION* im folgenden Code durch die Werte, die unter angegeben sind. [Schritt 1: Erstellen Sie einen Amazon Cognito Cognito-Identitätspool](#getting-started-browser-create-identity-pool)

```
    <script type="text/javascript">

        // Initialize the Amazon Cognito credentials provider
        AWS.config.region = 'REGION';
        AWS.config.credentials = new AWS.CognitoIdentityCredentials({IdentityPoolId: 'IDENTITY_POOL_ID'});

        // Function invoked by button click
        function speakText() {
            // Create the JSON parameters for getSynthesizeSpeechUrl
            var speechParams = {
                OutputFormat: "mp3",
                SampleRate: "16000",
                Text: "",
                TextType: "text",
                VoiceId: "Matthew"
            };
            speechParams.Text = document.getElementById("textEntry").value;
```

Amazon Polly gibt synthetisierte Sprache als Audiostream zurück. Der einfachste Weg, dieses Audio in einem Browser abzuspielen, besteht darin, Amazon Polly das Audio unter einer vordefinierten URL zur Verfügung zu stellen, die Sie dann als `src` Attribut des `<audio>` Elements auf der Webseite festlegen können.

Erstellen Sie ein neues `AWS.Polly`-Serviceobjekt. Erstellen Sie dann das `AWS.Polly.Presigner`-Objekt, das Sie zum Erstellen der vorsignierten URL verwenden, von der die Sprachausgabe abgerufen werden kann. Sie müssen die Sprachparameter, die Sie definiert haben sowie das `AWS.Polly`-Serviceobjekt, das Sie erstellt haben, an den `AWS.Polly.Presigner`-Konstruktor übergeben.

Nach dem Erstellen des Presigner-Objekts, rufen Sie die `getSynthesizeSpeechUrl`-Methode dieses Objekts auf und übergeben Sie die Sprachparameter. Wenn diese Aktion erfolgreich ist, gibt diese Methode die URL der Sprachausgabe zurück, die Sie dann dem `<audio>`-Element für die Wiedergabe zuweisen.

```
            // Create the Polly service object and presigner object
            var polly = new AWS.Polly({apiVersion: '2016-06-10'});
            var signer = new AWS.Polly.Presigner(speechParams, polly)

            // Create presigned URL of synthesized speech file
            signer.getSynthesizeSpeechUrl(speechParams, function(error, url) {
            if (error) {
                document.getElementById('result').innerHTML = error;
            } else {
                document.getElementById('audioSource').src = url;
                document.getElementById('audioPlayback').load();
                document.getElementById('result').innerHTML = "Speech ready to play.";
            }
          });
        }
    </script>
```

## Schritt 5: Ausführen des Beispiels
<a name="getting-started-browser-run-sample"></a>

Um die Beispielanwendung auszuführen, laden Sie `polly.html` in einen Webbrowser. So sollte die Browser-Präsentation ungefähr aussehen.

![\[Browser-Schnittstelle der Webanwendung\]](http://docs.aws.amazon.com/de_de/sdk-for-javascript/v2/developer-guide/images/browsergetstarted.png)


Geben Sie einen Satz in das Eingabefeld ein, der in Sprache umgewandelt werden soll, und wählen Sie dann **Synthesize (Generieren)** aus. Wenn das Audio zum Abspielen bereit ist, wird eine Meldung angezeigt. Verwenden Sie die Steuerelemente des Audio-Players zum Anhören der Sprachausgabe.

## Vollständiges Beispiel
<a name="getting-started-browser-full-sample"></a>

Hier finden Sie die vollständige HTML-Seite mit dem Browser-Skript. Es ist auch [hier verfügbar. GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascript/example_code//browserstart/polly.html)

```
<!DOCTYPE html>
<html>
  <head>
    <meta charset="UTF-8">
    <title>AWS SDK for JavaScript - Browser Getting Started Application</title>
  </head>

  <body>
    <div id="textToSynth">
      <input autofocus size="23" type="text" id="textEntry" value="It's very good to meet you."/>
      <button class="btn default" onClick="speakText()">Synthesize</button>
      <p id="result">Enter text above then click Synthesize</p>
    </div>
    <audio id="audioPlayback" controls>
      <source id="audioSource" type="audio/mp3" src="">
    </audio>
    <script src="https://sdk.amazonaws.com/js/aws-sdk-2.410.0.min.js"></script>
    <script type="text/javascript">

        // Initialize the Amazon Cognito credentials provider
        AWS.config.region = 'REGION';
        AWS.config.credentials = new AWS.CognitoIdentityCredentials({IdentityPoolId: 'IDENTITY_POOL_ID'});

        // Function invoked by button click
        function speakText() {
            // Create the JSON parameters for getSynthesizeSpeechUrl
            var speechParams = {
                OutputFormat: "mp3",
                SampleRate: "16000",
                Text: "",
                TextType: "text",
                VoiceId: "Matthew"
            };
            speechParams.Text = document.getElementById("textEntry").value;

            // Create the Polly service object and presigner object
            var polly = new AWS.Polly({apiVersion: '2016-06-10'});
            var signer = new AWS.Polly.Presigner(speechParams, polly)

            // Create presigned URL of synthesized speech file
            signer.getSynthesizeSpeechUrl(speechParams, function(error, url) {
            if (error) {
                document.getElementById('result').innerHTML = error;
            } else {
                document.getElementById('audioSource').src = url;
                document.getElementById('audioPlayback').load();
                document.getElementById('result').innerHTML = "Speech ready to play.";
            }
          });
        }
    </script>
  </body>
</html>
```

## Mögliche Erweiterungen
<a name="getting-started-browser-variations"></a>

Im Folgenden finden Sie Varianten dieser Anwendung, mit denen Sie die Verwendung des SDK JavaScript in einem Browserskript weiter untersuchen können.
+ Experimentieren Sie mit anderen Sound-Ausgabeformaten.
+ Fügen Sie die Option hinzu, eine der verschiedenen von Amazon Polly bereitgestellten Stimmen auszuwählen.
+ Integrieren Sie einen Identitätsanbieter wie Facebook oder Amazon, um ihn mit der authentifizierten IAM-Rolle zu verwenden.

# Erste Schritte in Node.js
<a name="getting-started-nodejs"></a>

![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/de_de/sdk-for-javascript/v2/developer-guide/images/nodeicon.png)

**Dieses Node.js-Codebeispiel zeigt:**
+ Wie das `package.json`-Manifest für Ihr Projekt erstellt wird.
+ Wie die Module, die Ihr Projekt verwendet, installiert und eingeschlossen werden.
+ So erstellen Sie ein Amazon Simple Storage Service (Amazon S3) -Serviceobjekt aus der `AWS.S3` Client-Klasse.
+ So erstellen Sie einen Amazon S3 S3-Bucket und laden ein Objekt in diesen Bucket hoch.

## Das Szenario
<a name="getting-started-nodejs-scenario"></a>

Das Beispiel zeigt, wie Sie ein einfaches Modul Node.js einrichten und ausführen, das einen Amazon S3 S3-Bucket erstellt und ihm dann ein Textobjekt hinzufügt. 

Da Bucket-Namen in Amazon S3 global eindeutig sein müssen, beinhaltet dieses Beispiel ein Drittanbieter-Modul Node.js, das einen eindeutigen ID-Wert generiert, den Sie in den Bucket-Namen integrieren können. Dieses zusätzliche Modul trägt den Namen `uuid`.

## Erforderliche Aufgaben
<a name="getting-started-nodejs-prerequisites"></a>

Zum Einrichten und Ausführen dieses Beispiels müssen Sie zunächst diese Aufgaben abschließen:
+ Erstellen Sie ein Arbeitsverzeichnis zum Entwickeln Ihres Node.js-Moduls. Geben Sie diesem Verzeichnis den Namen `awsnodesample`. Beachten Sie, dass das Verzeichnis an einem Speicherort erstellt werden muss, der von Anwendungen aktualisiert werden kann. Beispiel: Erstellen Sie bei Windows das Verzeichnis nicht unter "C:\$1Programme".
+ Installieren Sie Node.js. Weitere Informationen finden Sie auf der [Node.js-Website](https://nodejs.org). Unter [https://nodejs finden Sie Downloads der aktuellen Version und der LTS-Version von Node.js für eine Vielzahl von Betriebssystemen. org/en/download/current](https://nodejs.org/en/download/current/)/.

**Contents**
+ [Das Szenario](#getting-started-nodejs-scenario)
+ [Erforderliche Aufgaben](#getting-started-nodejs-prerequisites)
+ [Schritt 1: Installieren Sie das SDK und die Abhängigkeiten](#getting-started-nodejs-install-sdk)
+ [Schritt 2: Konfigurieren Sie Ihre Anmeldeinformationen](#getting-started-nodejs-credentials)
+ [Schritt 3: Erstellen Sie das Paket-JSON für das Projekt](#getting-started-nodejs-download)
+ [Schritt 4: Schreiben des Node.js-Codes](#getting-started-nodejs-js-code)
+ [Schritt 5: Ausführen des Beispiels](#getting-started-nodejs-run-sample)

## Schritt 1: Installieren Sie das SDK und die Abhängigkeiten
<a name="getting-started-nodejs-install-sdk"></a>

Sie installieren das SDK für das JavaScript Paket mit [npm (dem Paketmanager Node.js)](https://www.npmjs.com). 

Geben Sie im `awsnodesample`-Verzeichnis im Paket den folgenden Befehl in die Befehlszeile ein.

```
npm install aws-sdk
```

Mit diesem Befehl wird das SDK für JavaScript in Ihrem Projekt installiert und aktualisiert`package.json`, sodass das SDK als Projektabhängigkeit aufgeführt wird. Sie finden Informationen zu diesem Paket , indem Sie nach "aws-sdk" auf der [npm-Website suchen](https://www.npmjs.com).

Als Nächstes installieren Sie das `uuid`-Modul in das Projekt, indem Sie den folgenden Befehl zur Installation des Moduls und Aktualisierung von `package.json` in die Befehlszeile eingeben. Weitere Informationen zu `uuid` finden Sie auf der Seite des Moduls unter [https://www.npmjs.com/package/uuid](https://www.npmjs.com/package/uuid).

```
npm install uuid
```

Diese Pakete und der zugehörige Code werden im `node_modules`-Unterverzeichnis Ihres Projekts installiert.

Weitere Informationen zum Installieren von Node.js-Paketen finden Sie unter [Herunterladen und Installieren von lokalen Paketen](https://docs.npmjs.com/getting-started/installing-npm-packages-locally) und [Erstellen von Node.js-Modulen](https://docs.npmjs.com/getting-started/creating-node-modules) auf der [Node.js-Paketmanager (npm)-Website](https://www.npmjs.com). Informationen zum Herunterladen und Installieren von finden Sie unter AWS SDK für JavaScript. [Installation des SDK für JavaScript](installing-jssdk.md)

## Schritt 2: Konfigurieren Sie Ihre Anmeldeinformationen
<a name="getting-started-nodejs-credentials"></a>

Sie müssen Anmeldeinformationen angeben, AWS damit das SDK nur auf Ihr Konto und die zugehörigen Ressourcen zugreifen kann. Weitere Informationen zum Abrufen Ihrer Kontoanmeldeinformationen finden Sie unter [SDK-Authentifizierung mit AWS](getting-your-credentials.md).

Um diese Informationen zu speichern, empfehlen wir Ihnen, eine gemeinsame Anmeldeinformationsdatei zu erstellen. Um zu erfahren wie dies geht, vgl. [Laden der Anmeldeinformationen in Node.js aus der freigegebenen Anmeldeinformationsdatei](loading-node-credentials-shared.md). Ihre Anmeldeinformationsdatei sollte dem folgenden Beispiel ähneln.

```
[default]
aws_access_key_id = YOUR_ACCESS_KEY_ID
aws_secret_access_key = YOUR_SECRET_ACCESS_KEY
```

Sie können feststellen, ob Sie Ihre Anmeldeinformationen korrekt festgelegt haben, indem Sie den folgenden Code mit Node.js ausführen:

```
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 festgelegt haben, können Sie diesen Wert ebenfalls anzeigen, indem Sie die `AWS_SDK_LOAD_CONFIG` Umgebungsvariable auf einen beliebigen Wert setzen und den folgenden Code verwenden:

```
var AWS = require("aws-sdk");

console.log("Region: ", AWS.config.region);
```

## Schritt 3: Erstellen Sie das Paket-JSON für das Projekt
<a name="getting-started-nodejs-download"></a>

Nachdem Sie das `awsnodesample`-Projektverzeichnis erstellt haben, erstellen und fügen Sie eine `package.json`-Datei für die Speicherung der Metadaten für Ihr Node.js-Projekt hinzu. Einzelheiten zur Verwendung `package.json` in einem Node.js -Projekt finden Sie unter [Erstellen einer package.json-Datei](https://docs.npmjs.com/creating-a-package-json-file).

Erstellen Sie im Projektverzeichnis eine neue Datei namens `package.json`. Fügen Sie dann dieses JSON der Datei hinzu.

```
{
  "dependencies": {},
  "name": "aws-nodejs-sample",
  "description": "A simple Node.js application illustrating usage of the SDK for JavaScript.",
  "version": "1.0.1",
  "main": "sample.js",
  "devDependencies": {},
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "author": "NAME",
  "license": "ISC"
}
```

Speichern Sie die Datei. Wenn Sie die benötigten Module installieren, wird der `dependencies`-Teil der Datei abgeschlossen. [Eine JSON-Datei, die ein Beispiel für diese Abhängigkeiten zeigt, finden Sie hier unter. GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascript/example_code/nodegetstarted/example_package.json) 

## Schritt 4: Schreiben des Node.js-Codes
<a name="getting-started-nodejs-js-code"></a>

Erstellen Sie eine neue Datei mit dem Namen `sample.js`, wohin Sie den Beispielcode speichern möchten. Fügen Sie zunächst die `require` Funktionsaufrufe hinzu, um das SDK für JavaScript und die `uuid` Module einzubeziehen, sodass sie für Sie verfügbar sind.

Erstellen Sie einen eindeutigen Bucket-Namen, der zur Erstellung eines Amazon S3 S3-Buckets verwendet wird, indem Sie in diesem Fall `'node-sdk-sample-'` einen eindeutigen ID-Wert an ein erkennbares Präfix anhängen. Sie generieren die eindeutige ID durch Aufrufen des `uuid`-Moduls. Erstellen Sie dann einen Namen für den `Key`-Parameter, der zum Hochladen eines Objekts in den Bucket verwendet wird.

Erstellen Sie ein `promise`-Objekt zum Aufrufen der `createBucket`-Methode des `AWS.S3`-Serviceobjekts. Bei einer erfolgreichen Antwort erstellen Sie die erforderlichen Parameter zum Hochladen von Text in den neu erstellten Bucket. Bei Verwendung eines anderen Promise rufen Sie die `putObject`-Methode auf, um das Textobjekt in den Bucket hochzuladen.

```
// Load the SDK and UUID
var AWS = require("aws-sdk");
var uuid = require("uuid");

// Create unique bucket name
var bucketName = "node-sdk-sample-" + uuid.v4();
// Create name for uploaded object key
var keyName = "hello_world.txt";

// Create a promise on S3 service object
var bucketPromise = new AWS.S3({ apiVersion: "2006-03-01" })
  .createBucket({ Bucket: bucketName })
  .promise();

// Handle promise fulfilled/rejected states
bucketPromise
  .then(function (data) {
    // Create params for putObject call
    var objectParams = {
      Bucket: bucketName,
      Key: keyName,
      Body: "Hello World!",
    };
    // Create object upload promise
    var uploadPromise = new AWS.S3({ apiVersion: "2006-03-01" })
      .putObject(objectParams)
      .promise();
    uploadPromise.then(function (data) {
      console.log(
        "Successfully uploaded data to " + bucketName + "/" + keyName
      );
    });
  })
  .catch(function (err) {
    console.error(err, err.stack);
  });
```

Diesen Beispielcode finden Sie [hier auf GitHub.](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascript/example_code/nodegetstarted/sample.js)

## Schritt 5: Ausführen des Beispiels
<a name="getting-started-nodejs-run-sample"></a>

Geben Sie den folgenden Befehl ein, um das Beispiel auszuführen.

```
node sample.js
```

Wenn der Upload erfolgreich ist, sehen Sie eine Bestätigungsmeldung in der Befehlszeile. Sie können zudem den Bucket und das hochgeladene Textobjekt in der [Amazon S3-Konsole](https://console.aws.amazon.com/s3/) finden.