UpdateTable

重要

本节引用 API 版本 2011-12-05，此版本已被弃用且不应用于新应用程序。

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

说明

更新给定表的预置吞吐量。设置表的吞吐量有助于管理性能，也是 DynamoDB 预置吞吐量功能的一部分。有关更多信息，请参阅管理 DynamoDB 预置容量表的设置。

根据Amazon DynamoDB 中的服务、账户和表配额中列出的最大值和最小值，预置的吞吐量值可以升级或降级。

表必须处于 ACTIVE 状态才能使此操作成功。UpdateTable 是一个异步操作；在执行此操作时，表处于 UPDATING 状态。当表处于 UPDATING 状态时，表仍具有在执行调用前的预置吞吐量。仅当 UpdateTable 操作后，表返回到 ACTIVE 状态时，新的预置吞吐量设置才生效。

请求

语法


// 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`	指定的表的新吞吐量，由 `ReadCapacityUnits` 和 `WriteCapacityUnits` 的值组成。请参阅管理 DynamoDB 预置容量表的设置。类型：数组	是
`ProvisionedThroughput` :`ReadCapacityUnits`	设置在 DynamoDB 与其他操作平衡负载前，指定的表每秒消耗的一致 `ReadCapacityUnits` 的最小数目。最终一致性读取操作所需的工作量要少于常规一致性读取操作，所以，一组每秒 50 次的一致性 `ReadCapacityUnits` 操作会实现最终每秒 100 次一致性 `ReadCapacityUnits` 操作。类型：数字	是
`ProvisionedThroughput` :`WriteCapacityUnits`	设置在 DynamoDB 与其他操作平衡负载前，指定的表每秒消耗的一致 `WriteCapacityUnits` 的最小数目。类型：数字	是

响应

语法


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`	表的主键（简单或者复合）结构。`HashKeyElement` 的名称-值对是必需内容，而 `RangeKeyElement` 的名称-值对为可选内容（只有复合主键才需要该内容）。最大哈希键大小为 2048 字节。最大范围键大小为 1024 字节。两个限制是分别实施的（即，您可以有一个哈希 + 范围 2048 + 1024 组合键）。有关主键的更多信息，请参阅主键。类型：复合主键的 `HashKeyElement`、`HashKeyElement` 和 `RangeKeyElement` 的映射。
`ProvisionedThroughput`	指定的表的当前吞吐量设置，包括 `LastIncreaseDateTime`（如果适用）、`LastDecreaseDateTime`（如果适用）的值。类型：数组
`TableName`	已更新的表的名称。类型：字符串
`TableStatus`	该表的当前状态（`CREATING`、`ACTIVE`、`DELETING` 或 `UPDATING`），应为 `UPDATING`。使用 DescribeTables 操作查看表的状态。类型：字符串

特殊错误

错误	说明
`ResourceNotFoundException`	找不到指定的表。
`ResourceInUseException`	该表未处于 `ACTIVE` 状态。

示例

示例请求


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

UpdateTable

说明

请求

语法

响应

语法

特殊错误

示例

示例请求

示例响应

相关操作