本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
UpdateTable
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
更新给定表的预置吞吐量。设置表的吞吐量可帮助您管理性能,并且是 DynamoDB 的预置吞吐量功能的一部分。有关更多信息,请参阅管理 DynamoDB 预置容量表的设置。
预配置的吞吐量值可以根据Amazon DynamoDB 中的服务、账户和表配额中列出的最大值和最小值进行升级或降级。
该表必须处于 ACTIVE
状态,此操作才能成功。UpdateTable 是一个异步操作;在执行操作时,表处于 UPDATING
状态。当表处于 UPDATING
状态时,该表在调用前仍具有预置吞吐量。仅当表在 UpdateTable 操作后返回 ACTIVE
状态时,新的预置吞吐量设置才有效。
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.UpdateTable content-type: application/x-amz-json-1.0 {"TableName":"Table1", "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":15} }
名称 | 描述 | 必需 |
---|---|---|
TableName
|
要更新的表的名称。 类型: 字符串 |
是 |
ProvisionedThroughput
|
指定表的新吞吐量,包含 类型: 数组 |
是 |
ProvisionedThroughput
:ReadCapacityUnits |
为指定表设置在 最终一致性读取操作所需的工作量小于一致性读取操作所需的工作量,因此设置为每秒 50 个一致性 类型: 数字 |
是 |
ProvisionedThroughput
:WriteCapacityUnits |
为指定表设置在 类型: 数字 |
是 |
Responses
Syntax
HTTP/1.1 200 OK x-amzn-RequestId: CSOC7TJPLR0OOKIRLGOHVAICUFVV4KQNSO5AEMVJF66Q9ASUAAJG Content-Type: application/json Content-Length: 311 Date: Tue, 12 Jul 2011 21:31:03 GMT {"TableDescription": {"CreationDateTime":1.321657838135E9, "KeySchema": {"HashKeyElement":{"AttributeName":"AttributeValue1","AttributeType":"S"}, "RangeKeyElement":{"AttributeName":"AttributeValue2","AttributeType":"N"}}, "ProvisionedThroughput": {"LastDecreaseDateTime":1.321661704489E9, "LastIncreaseDateTime":1.321663607695E9, "ReadCapacityUnits":5, "WriteCapacityUnits":10}, "TableName":"Table1", "TableStatus":"UPDATING"}}
名称 | 描述 |
---|---|
CreationDateTime |
创建表的日期。 类型: 数字 |
KeySchema
|
表的主键(简单或复合)结构。的名称-值对是必需的, 类型: 复合主键的 |
ProvisionedThroughput |
指定表的当前吞吐量设置,包括 类型: 数组 |
TableName
|
已更新的表的名称。 类型: 字符串 |
TableStatus
|
表的当前状态(CREATING 、ACTIVE 、DELETING 或 UPDATING ),应为 UPDATING 。
使用 DescribeTables 操作检查表的状态。 类型: 字符串 |
特殊错误
错误 | 描述 |
---|---|
ResourceNotFoundException
|
找不到指定的表。 |
ResourceInUseException |
该表未处于 ACTIVE 状态。
|
Examples
示例请求
// This header is abbreviated. // For a sample of a complete header, see DynamoDB 低级 API. POST / HTTP/1.1 x-amz-target: DynamoDB_20111205.UpdateTable content-type: application/x-amz-json-1.0 {"TableName":"comp1", "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":15} }
示例响应
HTTP/1.1 200 OK content-type: application/x-amz-json-1.0 content-length: 390 Date: Sat, 19 Nov 2011 00:46:47 GMT {"TableDescription": {"CreationDateTime":1.321657838135E9, "KeySchema": {"HashKeyElement":{"AttributeName":"user","AttributeType":"S"}, "RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}}, "ProvisionedThroughput": {"LastDecreaseDateTime":1.321661704489E9, "LastIncreaseDateTime":1.321663607695E9, "ReadCapacityUnits":5, "WriteCapacityUnits":10}, "TableName":"comp1", "TableStatus":"UPDATING"} }