DeleteTable - Amazon DynamoDB
DescrizioneRichiesteRisposteErrori specialiEsempiOperazioni correlate

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

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.

Descrizione

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 ePutItem, su una tabella nello stato DELETING fino al completamento dell'eliminazione della tabella.

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

Utilizza l'operazione DescribeTables per visualizzare lo stato della tabella.

Richieste

Sintassi

// This header is abbreviated. 
// For a sample of a complete header, see DynamoDB di basso livello API.
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: stringa

Sì

Risposte

Sintassi

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.

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. Per informazioni, consulta Modalità di capacità fornita da DynamoDB.
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: stringa

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 per visualizzare lo stato della tabella.

▬Tipo: stringa

Errori speciali

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

Esempi

Richiesta di esempio

// This header is abbreviated. For a sample of a complete header, see DynamoDB di basso livello API.
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

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