DeleteTable

重要

本節涉及不該再用於新應用程式的已棄用 API 版本 2011-12-05。

如需目前低階 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`	要刪除的資料表的名稱。類型：字串	是

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`	資料表的主索引鍵 (簡單或複合) 結構。需要 `HashKeyElement` 的名稱值組，且可選用 `RangeKeyElement` 的名稱值組 (僅適用於複合主索引鍵)。如需主索引鍵的詳細資訊，請參閱主索引鍵。類型：複合主索引鍵的 `HashKeyElement` 或 `HashKeyElement` 和 `RangeKeyElement` 映射。
`ProvisionedThroughput`	指定資料表的輸送量，包括 `ReadCapacityUnits` 與 `WriteCapacityUnits` 的值。請參閱 DynamoDB 佈建容量模式。
`ProvisionedThroughput`: `ReadCapacityUnits`	DynamoDB 與其他操作平衡負載之前，所指定資料表每秒所需的最低 `ReadCapacityUnits` 數目。類型：數字
`ProvisionedThroughput`: `WriteCapacityUnits`	DynamoDB 與其他操作平衡負載之前，所指定資料表每秒所需的最低 `WriteCapacityUnits` 數目。類型：數字
`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"
}

DeleteTable

重要

描述

注意

請求

語法

回應

語法

特殊錯誤

範例

請求範例

回應範例

相關動作