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	要删除的表的名称。 类型：字符串	是

响应

语法

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

相关操作

• CreateTable

• DescribeTables