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

Richieste

Sintassi

// 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

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. Consultare Modalità con capacità allocata di 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: 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 per visualizzare lo stato della tabella. Tipo: string

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

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

• CreateTable

• DescribeTables