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

# DescribeTables
<a name="API_DescribeTables_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_DescribeTables_Description"></a>

Restituisce informazioni sulla tabella, inclusi lo stato corrente della tabella, lo schema della chiave primaria e la data di creazione della tabella. I risultati di DescribeTable sono a consistenza finale. Se si utilizza DescribeTable troppo presto nel processo di creazione di una tabella, DynamoDB restituisce una `ResourceNotFoundException`. Se si utilizza DescribeTable troppo presto nel processo di aggiornamento di una tabella, i nuovi valori potrebbero non essere immediatamente disponibili.

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

### Sintassi
<a name="API_DescribeTables_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.DescribeTable
content-type: application/x-amz-json-1.0

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


****  

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

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

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

```
HTTP/1.1 200 
x-amzn-RequestId: 8966d095-71e9-11e0-a498-71d736f27375
content-type: application/x-amz-json-1.0
Content-Length: 543


{"Table":
    {"CreationDateTime":1.309988345372E9,
    ItemCount:1,
    "KeySchema":
        {"HashKeyElement":{"AttributeName":"AttributeName1","AttributeType":"S"},
        "RangeKeyElement":{"AttributeName":"AttributeName2","AttributeType":"N"}},
    "ProvisionedThroughput":{"LastIncreaseDateTime": Date, "LastDecreaseDateTime": Date, "ReadCapacityUnits":10,"WriteCapacityUnits":10},
    "TableName":"Table1",
    "TableSizeBytes":1,
    "TableStatus":"ACTIVE"
    }
}
```


****  

|  Nome  |  Descrizione  | 
| --- | --- | 
|  Table  |  Un container per la tabella descritta. Tipo: string  | 
| CreationDateTime | La data in cui la tabella è stata creata in [formato orario epoch UNIX](http://www.epochconverter.com/). | 
|  ItemCount  |  Il numero di elementi nella tabella specificata. DynamoDB aggiorna questo valore ogni sei ore circa. Le modifiche recenti potrebbero non essere riflesse in questo valore. 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). La dimensione massima della chiave hash è 2048 byte. La dimensione massima della chiave di intervallo è 1024 byte. Entrambi i limiti sono applicati separatamente (cioè è possibile avere una chiave hash \$1 intervallo combinato, ovvero 2048\$11024). Per ulteriori informazioni sulle chiavi primarie, vedere [Chiave primaria](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey). | 
| ProvisionedThroughput  | Velocità effettiva assegnata, costituita dai valori per LastIncreaseDateTime(se applicabile), LastDecreaseDateTime (se applicabile),ReadCapacityUnits e WriteCapacityUnits. Se la velocità effettiva della tabella non è mai stata aumentata o ridotta, DynamoDB non restituisce valori per tali elementi. Consultare [Modalità con capacità allocata di DynamoDB](provisioned-capacity-mode.md).Tipo: Array  | 
|  TableName  |  Il nome della tabella richiesta.  Tipo: string  | 
|  TableSizeBytes  |  La dimensione totale della tabella specificata in byte. DynamoDB aggiorna questo valore ogni sei ore circa. Le modifiche recenti potrebbero non essere riflesse in questo valore. Tipo: numero  | 
|  TableStatus  | Lo stato corrente della tabella (CREATING, ACTIVE, DELETING o UPDATING). Una volta che la tabella si trova nello stato ACTIVE, è possibile aggiungere i dati.  | 

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

Non esiste alcun errore specifico per questa operazione.

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

 Gli esempi seguenti mostrano una richiesta POST HTTP e una risposta tramite l'operazione DescribeTable per una tabella denominata "comp-table". La tabella dispone di una chiave primaria composita.

### Richiesta di esempio
<a name="API_DescribeTables_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.DescribeTable
content-type: application/x-amz-json-1.0

{"TableName":"users"}
```

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

```
HTTP/1.1 200 
x-amzn-RequestId: 8966d095-71e9-11e0-a498-71d736f27375
content-type: application/x-amz-json-1.0
content-length: 543

{"Table":
    {"CreationDateTime":1.309988345372E9,
    "ItemCount":23,
    "KeySchema":
        {"HashKeyElement":{"AttributeName":"user","AttributeType":"S"},
        "RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}},
    "ProvisionedThroughput":{"LastIncreaseDateTime": 1.309988345384E9, "ReadCapacityUnits":10,"WriteCapacityUnits":10},
    "TableName":"users",
    "TableSizeBytes":949,
    "TableStatus":"ACTIVE"
    }
}
```

## Operazioni correlate
<a name="API_DescribeTables_Related_Actions"></a>
+  [CreateTable](API_CreateTable_v20111205.md) 
+  [DeleteTable](API_DeleteTable_v20111205.md) 
+  [ListTables](API_ListTables_v20111205.md)