Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Utilizzo della CLI di AWS
<a name="single-region-aws-cli"></a>

La CLI di AWS fornisce un’interfaccia a riga di comando per la gestione dei cluster Aurora DSQL. L’esempio seguente illustra le operazioni comuni relative alla gestione dei cluster.

## Creazione di un cluster
<a name="create-cluster"></a>

Creazione di un cluster utilizzando il comando **create-cluster**.

**Nota**  
La creazione di cluster è un’operazione asincrona. Invocare l’API **GetCluster** fino a quando lo stato non cambia a `ACTIVE`. Una volta diventato attivo, è possibile connettersi al cluster.

**Example Comando**  

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

**Nota**  
Per disabilitare la protezione dall’eliminazione durante la creazione, includere il `--no-deletion-protection-enabled`.

**Example Risposta**  

```
{
    "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"
    }
}
```

## Descrizione di un cluster
<a name="get-cluster"></a>

Ottenere informazioni su un cluster utilizzando il comando **get-cluster**.

**Example Comando**  

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

**Example Risposta**  

```
{
    "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"
    }
}
```

## Aggiornamento di un cluster
<a name="update-cluster"></a>

Aggiornamento di un cluster esistente utilizzando il comando **update-cluster**.

**Nota**  
Gli aggiornamenti sono operazioni asincrone. Per visualizzare le modifiche, invocare l’API **GetCluster** fino a quando lo stato non cambia a `ACTIVE`.

**Example Comando**  

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

**Example Risposta**  

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

## Eliminazione di un cluster
<a name="delete-cluster"></a>

Eliminazione di un cluster esistente utilizzando il comando **delete-cluster**.

**Nota**  
È possibile eliminare solo i cluster per i quali è disabilitata la protezione da eliminazione. Quando si crea un cluster, la protezione dall’eliminazione viene abilitata per impostazione predefinita.

**Example Comando**  

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

**Example Risposta**  

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

## Elencazione dei cluster
<a name="list-clusters"></a>

Elencazione dei cluster usando il comando **list-clusters**.

**Example Comando**  

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

**Example Risposta**  

```
{
    "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"
        }
    ]
}
```