Description Requests Responses 特殊错误 Examples 相关操作

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`	指定表的新吞吐量，包含 `ReadCapacityUnits` 和 `WriteCapacityUnits` 的值。请参阅管理 DynamoDB 预置容量表的设置。类型: 数组	是
`ProvisionedThroughput` :`ReadCapacityUnits`	为指定表设置在 `ReadCapacityUnits` 将负载与其他操作进行平衡之前，每秒使用的一致 DynamoDB 的最小数量。最终一致性读取操作所需的工作量小于一致性读取操作所需的工作量，因此设置为每秒 50 个一致性 `ReadCapacityUnits` 可提供每秒 100 个最终一致性 `ReadCapacityUnits`。类型: 数字	是
`ProvisionedThroughput` :`WriteCapacityUnits`	为指定表设置在 `WriteCapacityUnits` 将负载与其他操作进行平衡之前，每秒使用的 DynamoDB 最小数。类型: 数字	是

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`	表的主键（简单或复合）结构。的名称-值对是必需的，`HashKeyElement` 的名称-值对是可选的（仅对于复合主键是必需的）。`RangeKeyElement`最大哈希键大小为 2048 个字节。最大范围键大小为 1024 个字节。两个限制是分开实施的（即，您可以组合使用哈希 + 范围 2048 + 1024 键）。有关主键的更多信息，请参阅主键。类型: 复合主键的 `HashKeyElement`、`HashKeyElement` 和 `RangeKeyElement` 的映射。
`ProvisionedThroughput`	指定表的当前吞吐量设置，包括 `LastIncreaseDateTime` 的值（如果适用），`LastDecreaseDateTime`（如果适用）类型: 数组
`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"}
}