

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à.

# DeleteTable
<a name="API_DeleteTable_v20111205"></a>

**Importante**  
***In questa sezione si fa riferimento alla versione API 2011-12-05, che è obsoleta e non deve essere utilizzata per le nuove applicazioni.***  
 **Per informazioni sull'API di basso livello corrente, consulta la [Amazon DynamoDB API Reference](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/).**

## Descrizione
<a name="API_DeleteTable_Description"></a>

L'operazione `DeleteTable` elimina una tabella e tutti i suoi elementi. Dopo una richiesta `DeleteTable`, la tabella specificata si trova nello stato `DELETING` finché DynamoDB non completa l'eliminazione. Se la tabella si trova nello stato `ACTIVE`, è possibile eliminarlo. Se una tabella si trova nello `CREATING` o `UPDATING`, allora DynamoDB restituisce un errore `ResourceInUseException`. Se la tabella specificata non esiste, DynamoDB restituisce un `ResourceNotFoundException`. Se la tabella si trova già nello stato `DELETING`, non viene restituito alcun errore. 

**Nota**  
DynamoDB potrebbe continuare ad accettare le richieste di operazioni del piano dati, ad esempio `GetItem` e`PutItem`, su una tabella nello stato `DELETING` fino al completamento dell'eliminazione della tabella.

Le tabelle sono univoche tra quelle associate all'account AWS che effettua la richiesta e alla regione AWS che riceve la richiesta (ad esempio dynamodb.us-west-2.amazonaws.com). Ogni endpoint DynamoDB è completamente indipendente. Ad esempio, se sono presenti due tabelle chiamate "MyTable", una in dynamodb.us-west-2.amazonaws.com e una in dynamodb.us-west-1.amazonaws.com, queste tabelle sono completamente indipendenti e non condividono alcun dato; l'eliminazione di una non implica l'eliminazione dell'altra.

Utilizza l'operazione [DescribeTables](API_DescribeTables_v20111205.md) per visualizzare lo stato della tabella. 

## Richieste
<a name="API_DeleteTable_RequestParameters"></a>

### Sintassi
<a name="API_DeleteTable_RequestParameters.syntax"></a>

```
// This header is abbreviated. 
// For a sample of a complete header, see API DynamoDB di basso livello.
POST / HTTP/1.1 
x-amz-target: DynamoDB_20111205.DeleteTable 
content-type: application/x-amz-json-1.0

{"TableName":"Table1"}
```


****  

|  Nome  |  Descrizione  |  Richiesto | 
| --- | --- | --- | 
|  TableName  |   Il nome della tabella da eliminare.   Tipo: string   |  Sì  | 

## Risposte
<a name="API_DeleteTable_CommonResponseElements"></a>

### Sintassi
<a name="API_DeleteTable_CommonResponseElements.syntax"></a>

```
HTTP/1.1 200 OK
x-amzn-RequestId: 4HONCKIVH1BFUDQ1U68CTG3N27VV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 311
Date: Sun, 14 Aug 2011 22:56:22 GMT

{"TableDescription":
    {"CreationDateTime":1.313362508446E9,
    "KeySchema":
        {"HashKeyElement":{"AttributeName":"user","AttributeType":"S"},
        "RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}},
    "ProvisionedThroughput":{"ReadCapacityUnits":10,"WriteCapacityUnits":10},
    "TableName":"Table1",
    "TableStatus":"DELETING"
    }
}
```


****  

|  Nome  |  Descrizione  | 
| --- | --- | 
| TableDescription  | Un container per le proprietà della tabella. | 
| CreationDateTime | La data in cui è stata creata la tabella.Tipo: numero  | 
| KeySchema  | La struttura della chiave primaria (semplice o composita) per la tabella. Una coppia nome-valore per `HashKeyElement` è obbligatoria mentre una coppia nome-valore per `RangeKeyElement` è facoltativa (richiesta solo per le chiavi primarie composite). Per ulteriori informazioni sulle chiavi primarie, vedere [Chiave primaria](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey).Tipo: mappa di `HashKeyElement`, oppure `HashKeyElement` e `RangeKeyElement` per una chiave primaria composita. | 
| ProvisionedThroughput  | Velocità effettiva per la tabella specificata, costituita dai valori per ReadCapacityUnits e WriteCapacityUnits. Consultare [Modalità con capacità allocata di DynamoDB](provisioned-capacity-mode.md). | 
| ProvisionedThroughput: ReadCapacityUnits |  Il numero minimo di `ReadCapacityUnits` consumate al secondo per la tabella specificata prima che DynamoDB bilanci il carico con altre operazioni. Tipo: numero  | 
| ProvisionedThroughput: WriteCapacityUnits | Il numero minimo di `WriteCapacityUnits` consumate al secondo per la tabella specificata prima che DynamoDB bilanci il carico con altre operazioni.Tipo: numero  | 
|  TableName  |  Il nome della tabella eliminata. Tipo: string   | 
|  TableStatus  | Lo stato corrente della tabella (DELETING). Una volta che la tabella viene eliminata, le richieste successive per la tabella restituiscono resource not found. Utilizza l'operazione [DescribeTables](API_DescribeTables_v20111205.md) per visualizzare lo stato della tabella. Tipo: string | 

## Errori speciali
<a name="API_DeleteTable_SpecialErrors"></a>


****  

|  Errore  |  Descrizione  | 
| --- | --- | 
|  ResourceInUseException  |  La tabella è nello stato CREATING o UPDATING e non può essere eliminata.  | 

## Esempi
<a name="API_DeleteTable_Examples"></a>

### Richiesta di esempio
<a name="API_DeleteTable_Examples_Request"></a>

```
// This header is abbreviated. For a sample of a complete header, see API DynamoDB di basso livello.
POST / HTTP/1.1 
x-amz-target: DynamoDB_20111205.DeleteTable
content-type: application/x-amz-json-1.0
content-length: 40

{"TableName":"favorite-movies-table"}
```

### Risposta di esempio
<a name="API_DeleteTable_Examples_Response"></a>

```
HTTP/1.1 200 OK
x-amzn-RequestId: 4HONCKIVH1BFUDQ1U68CTG3N27VV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 160
Date: Sun, 14 Aug 2011 17:20:03 GMT

{"TableDescription":
    {"CreationDateTime":1.313362508446E9,
    "KeySchema":
        {"HashKeyElement":{"AttributeName":"name","AttributeType":"S"}},
    "TableName":"favorite-movies-table",
    "TableStatus":"DELETING"
}
```

## Operazioni correlate
<a name="API_DeleteTable_Related_Actions"></a>
+  [CreateTable](API_CreateTable_v20111205.md) 
+  [DescribeTables](API_DescribeTables_v20111205.md) 