DeleteTable - Amazon DynamoDB
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

DeleteTable

重要

This section refers to API version 2011-12-05, which is deprecated and should not be used for new applications.

有关当前低级别 API 的文档,请参阅 Amazon DynamoDB API Reference

Description

操作删除表及其所有项目。DeleteTable在发出 DeleteTable 请求后,指定的表将处于 DELETING 状态,直到 DynamoDB 完成删除。如果表处于 ACTIVE 状态,您可以将其删除。如果表处于 CREATINGUPDATING 状态,则 DynamoDB 返回 ResourceInUseException 错误。如果指定的表不存在,DynamoDB 将返回 ResourceNotFoundException。 如果表已处于 DELETING 状态,则不会返回错误。

注意

DynamoDB 可能会继续接受处于 GetItem 状态的表上的数据层面操作请求(如 PutItemDELETING),直到表删除完成。

在与发出请求的 AWS 账户和接收请求的 AWS 区域(如 dynamodb.us-west-1.amazonaws.com.cn)关联的表中,表是唯一的。每个 DynamoDB 终端节点都完全独立。例如,如果您有两个名为“MyTable”的表,一个在 dynamodb.us-west-2.amazonaws.com.cn 中,另一个在 dynamodb.us-west-1 中。amazonaws.com.cn 中,它们是完全独立的,不会共享任何数据;删除一个不会删除另一个。

使用 DescribeTables 操作检查表的状态。

Requests

Syntax

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

要删除的表的名称。

类型: 字符串

Responses

Syntax

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有关主键的更多信息,请参阅主键

类型: 复合主键的 HashKeyElementHashKeyElementRangeKeyElement 的映射。

ProvisionedThroughput 指定表的吞吐量,由 ReadCapacityUnitsWriteCapacityUnits 的值组成。 请参阅管理 DynamoDB 预置容量表的设置
ProvisionedThroughput: ReadCapacityUnits

ReadCapacityUnits 将负载与其他操作进行平衡之前,为指定表每秒使用的最少 DynamoDB 数。

类型: 数字

ProvisionedThroughput: WriteCapacityUnits

WriteCapacityUnits 将负载与其他操作进行平衡之前,指定表每秒使用的 DynamoDB 的最小数量。

类型: 数字

TableName

已删除的表的名称。

类型: 字符串

TableStatus 表的当前状态 (DELETING)。表删除之后,对该表的后续请求将返回 resource not found

使用 DescribeTables 操作检查表的状态。

类型: 字符串

特殊错误

错误 描述
ResourceInUseException 表处于 CREATINGUPDATING 状态,无法删除。

Examples

示例请求

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