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

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

DeleteTable

重要

本节介绍已经弃用的 API 版本 2011-12-05,不应用于新应用程序。

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

描述

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

注意

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

表在发出请求的 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

要删除的表的名称。

类型:字符串

响应

语法

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 的映射,或者复合主键的 HashKeyElementRangeKeyElement

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

DynamoDB 平衡负载和其他操作前,指定表每秒消耗的 ReadCapacityUnits 的最小数量。

类型:数字

ProvisionedThroughput: WriteCapacityUnits

DynamoDB 平衡负载和其他操作前,指定表每秒消耗的 WriteCapacityUnits 的最小数量。

类型:数字

TableName

已删除的表的名称。

类型:字符串

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

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

类型:字符串

特殊错误

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

示例

示例请求

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