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 von AWS-CLI
<a name="single-region-aws-cli"></a>

Die AWS-CLI stellt eine Befehlszeilenschnittstelle für die Verwaltung Ihrer Aurora DSQL-Cluster bereit. In den folgenden Beispielen werden häufig verwendete Cluster-Verwaltungsoperationen demonstriert.

## Cluster erstellen
<a name="create-cluster"></a>

Erstellen eines Clusters unter Verwendung des **create-cluster**-Befehls.

**Anmerkung**  
Die Clustererstellung ist ein asynchroner Vorgang. Rufen Sie die **GetCluster**-API auf, bis sich der Status auf `ACTIVE` ändert. Sie können eine Verbindung zu Ihrem Cluster herstellen, nachdem er aktiviert wurde.

**Example Befehl**  

```
aws dsql create-cluster --region us-east-1
```

**Anmerkung**  
Geben Sie das `--no-deletion-protection-enabled`-Flag mit an, um den Löschschutz während der Erstellung zu deaktivieren.

**Example Antwort**  

```
{
    "identifier": "abc0def1baz2quux3quuux4",
    "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/abc0def1baz2quux3quuux4",
    "status": "CREATING",
    "creationTime": "2024-05-25T16:56:49.784000-07:00",
    "deletionProtectionEnabled": true,
    "tag": {},
    "encryptionDetails": {
        "encryptionType": "AWS_OWNED_KMS_KEY",
        "encryptionStatus": "ENABLED"
    }
}
```

## Beschreiben von Clustern
<a name="get-cluster"></a>

Rufen Sie mithilfe des **get-cluster**-Befehls Informationen zu einem Cluster ab.

**Example Befehl**  

```
aws dsql get-cluster \
  --region us-east-1 \
  --identifier {{your_cluster_id}}
```

**Example Antwort**  

```
{
    "identifier": "abc0def1baz2quux3quuux4",
    "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/abc0def1baz2quux3quuux4",
    "status": "ACTIVE",
    "creationTime": "2024-11-27T00:32:14.434000-08:00",
    "deletionProtectionEnabled": false,
    "encryptionDetails": {
        "encryptionType": "CUSTOMER_MANAGED_KMS_KEY",
        "kmsKeyArn": "arn:aws:kms:us-east-1:111122223333:key/123a456b-c789-01de-2f34-g5hi6j7k8lm9",
        "encryptionStatus": "ENABLED"
    }
}
```

## Aktualisieren eines Clusters
<a name="update-cluster"></a>

Aktualisieren Sie einen vorhandenen Cluster mit dem **update-cluster**-Befehl.

**Anmerkung**  
Updates sind asynchrone Vorgänge. Rufen Sie die **GetCluster**-API auf, bis sich der Status auf `ACTIVE` ändert, um Ihre Änderungen zu sehen.

**Example Befehl**  

```
aws dsql update-cluster \
  --region us-east-1 \
  --no-deletion-protection-enabled \
  --identifier {{your_cluster_id}}
```

**Example Antwort**  

```
{
    "identifier": "abc0def1baz2quux3quuux4",
    "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/abc0def1baz2quux3quuux4",
    "status": "UPDATING",
    "creationTime": "2024-05-24T09:15:32.708000-07:00"
}
```

## Löschen eines Clusters
<a name="delete-cluster"></a>

Löschen Sie einen vorhandenen Cluster mit dem **delete-cluster**-Befehl.

**Anmerkung**  
Sie können nur Cluster löschen, für die kein Löschschutz aktiviert ist. Beim Erstellen neuer Cluster ist der Löschschutz standardmäßig aktiviert.

**Example Befehl**  

```
aws dsql delete-cluster \
  --region us-east-1 \
  --identifier {{your_cluster_id}}
```

**Example Antwort**  

```
{
    "identifier": "abc0def1baz2quux3quuux4",
    "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/abc0def1baz2quux3quuux4",
    "status": "DELETING",
    "creationTime": "2024-05-24T09:16:43.778000-07:00"
}
```

## Auflisten von Clustern
<a name="list-clusters"></a>

Listen Sie Ihre Cluster mit dem **list-clusters**-Befehl auf.

**Example Befehl**  

```
aws dsql list-clusters --region us-east-1
```

**Example Antwort**  

```
{
    "clusters": [
        {
            "identifier": "abc0def1baz2quux3quux4quuux",
            "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/abc0def1baz2quux3quux4quuux"
        },
        {
            "identifier": "abc0def1baz2quux3quux5quuuux",
            "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/abc0def1baz2quux3quux5quuuux"
        }
    ]
}
```