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，直到表删除完成。

表在发出请求的 Amazon 账户关联区域，以及接收请求的 Amazon 区域（例如 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

重要

描述

注意

请求

语法

响应

语法

特殊错误

示例

示例请求

示例响应

相关操作