本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
重要
This section refers to API version 2011-12-05,
which is deprecated and should not be used for new
applications.
如需目前低階 的文件API，請參閱 Amazon DynamoDB API參考。
描述
DeleteTable 操作會刪除資料表及其所有項目。在發出 DeleteTable 請求後，指定的資料表會處於 DELETING 狀態，直到 DynamoDB 完成刪除為止。如果資料表處於 ACTIVE 狀態，則可予以刪除。如果資料表處於 CREATING 或 UPDATING 狀態，則 DynamoDB 會傳回 ResourceInUseException 錯誤。如果指定的資料表不存在，則 DynamoDB 會傳回 ResourceNotFoundException。如果資料表已處於 DELETING 狀態，則不會傳回任何錯誤。
注意
DynamoDB 可能會繼續接受 DELETING 狀態的資料表的資料平面操作請求 (例如 GetItem 和 PutItem)，直到資料表刪除完成。
與發出請求 AWS 的帳戶以及接收請求 AWS 的區域 （例如 dynamodb.us-west-1.amazonaws.com) 相關聯的資料表是唯一的。每個 DynamoDB 端點都是完全獨立的。例如，如果您有兩個名為「」的資料表MyTable，其中一個在 dynamodb.us-west-2.amazonaws.com 中，另一個在 dynamodb.us-west-1.amazonaws.com 中，它們是完全獨立的，不會共用任何資料；刪除一個不會刪除另一個。
使用 DescribeTables 操作來檢查資料表的狀態。
請求
語法
// This header is abbreviated. // For a sample of a complete header, see DynamoDB 低階 API. POST / HTTP/1.1 x-amz-target: DynamoDB_20111205.DeleteTable content-type: application/x-amz-json-1.0 {"TableName":"Table1"}
| 名稱 | 描述 | 必要 |
|---|---|---|
TableName
|
要刪除的資料表的名稱。 類型：字串 |
是 |
回應
語法
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"
}
}| 名稱 | 描述 |
|---|---|
TableDescription
|
資料表屬性的容器。 |
CreationDateTime |
建立資料表時的日期。 類型：數字 |
KeySchema
|
資料表的主索引鍵 (簡單或複合) 結構。需要 類型：複合主索引鍵的 |
ProvisionedThroughput
|
指定資料表的輸送量，包括 ReadCapacityUnits 與 WriteCapacityUnits 的值。請參閱 DynamoDB 佈建容量模式。 |
ProvisionedThroughput:
ReadCapacityUnits |
DynamoDB 與其他操作平衡負載之前，所指定資料表每秒所需的最低 類型：數字 |
ProvisionedThroughput:
WriteCapacityUnits |
DynamoDB 與其他操作平衡負載之前，所指定資料表每秒所需的最低 類型：數字 |
TableName
|
已刪除的資料表的名稱。 類型：字串 |
TableStatus
|
資料表目前的狀態 (DELETING)。一旦資料表遭刪除，後續對資料表的請求會傳回 resource
not found。使用 DescribeTables 操作來檢查資料表的狀態。 類型：字串 |
特殊錯誤
| 錯誤 | 描述 |
|---|---|
ResourceInUseException
|
資料表處於狀態 CREATING 或 UPDATING，而且無法刪除。 |
範例
請求範例
// This header is abbreviated. For a sample of a complete header, see DynamoDB 低階 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"}
回應範例
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"
}相關動作
