本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
重要
This section refers to API version 2011-12-05,
which is deprecated and should not be used for new
applications.
如需目前低階 的文件API，請參閱 Amazon DynamoDB API參考。
描述
更新特定資料表的佈建輸送量。設定資料表的輸送量可協助您管理效能，此為 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
|
指定資料表的新輸送量，包括 類型：陣列 |
是 |
ProvisionedThroughput
:ReadCapacityUnits |
設定 DynamoDB 與其他操作平衡負載之前，所指定資料表每秒所需的最低一致性 最終一致讀取操作比一致性讀取負擔更輕，因此每秒 50 次一致性 類型：數字 |
是 |
ProvisionedThroughput
:WriteCapacityUnits |
設定 DynamoDB 與其他操作平衡負載之前，所指定資料表每秒所需的最低 類型：數字 |
是 |
回應
語法
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 狀態。 |
範例
請求範例
// 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"}
}相關動作
