本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# UpdateTable
<a name="API_UpdateTable_v20111205"></a>

**重要**  
***本節涉及不該再用於新應用程式的已棄用 API 版本 2011-12-05。***  
 **如需目前低階 API 的文件，請參閱[Amazon DynamoDB API 參考](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/)。**

## 描述
<a name="API_updatetable_Description"></a>

更新特定資料表的佈建輸送量。設定資料表的輸送量可協助您管理效能，此為 DynamoDB 佈建輸送量功能的一部分。如需更多詳細資訊，請參閱 [DynamoDB 佈建容量模式](provisioned-capacity-mode.md)。

佈建輸送量數值可以根據 [Amazon DynamoDB 中的配額](ServiceQuotas.md) 中所列最大值和最小值來升級或降級。

資料表必須處於 `ACTIVE` 狀態，這項操作才會成功。UpdateTable 為非同步操作；執行操作時，資料表處於 `UPDATING` 狀態。資料表處於 `UPDATING` 狀態時，仍具有呼叫之前的佈建輸送量。只有資料表在 UpdateTable 操作後回到 `ACTIVE` 狀態時，新的佈建輸送量設定才會生效。

## 請求
<a name="API_UpdateTable_RequestParameters"></a>

### 語法
<a name="API_UpdateTable_RequestParameters.syntax"></a>

```
// 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 佈建容量模式](provisioned-capacity-mode.md)。類型：陣列  | 是 | 
| ProvisionedThroughput :ReadCapacityUnits |  設定 DynamoDB 與其他操作平衡負載之前，所指定資料表每秒所需的最低一致性 `ReadCapacityUnits` 數目。 最終一致讀取操作比一致性讀取負擔更輕，因此每秒 50 次一致性 `ReadCapacityUnits` 的設定可提供每秒 100 次最終一致 `ReadCapacityUnits`。類型：數字  | 是 | 
| ProvisionedThroughput :WriteCapacityUnits |  設定 DynamoDB 與其他操作平衡負載之前，所指定資料表每秒所需的最低 `WriteCapacityUnits` 數目。類型：數字  | 是 | 

## 回應
<a name="API_UpdateTable_ResponseElements"></a>

### 語法
<a name="API_UpdateTable_ResponseElements.syntax"></a>

```
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 個位元組。此兩項限制皆為分別執行 (意即可出現雜湊 \$1 範圍 2048 \$1 1024 位元的合併索引鍵)。如需主索引鍵的詳細資訊，請參閱 [主索引鍵](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey)。類型：複合主索引鍵的 `HashKeyElement` 或 `HashKeyElement` 和 `RangeKeyElement` 映射。 | 
| ProvisionedThroughput | 所指定資料表的目前輸送量設定，包括 `LastIncreaseDateTime` (如適用)、`LastDecreaseDateTime` (如適用) 的值。類型：陣列  | 
|  TableName  |  已更新的資料表名稱。 類型：字串  | 
|  TableStatus  | 資料表目前的狀態 (CREATING、ACTIVE、DELETING 或 UPDATING)，目前應該為 UPDATING。使用 [DescribeTables](API_DescribeTables_v20111205.md) 操作來查看資料表狀態。類型：字串 | 

## 特殊錯誤
<a name="API_UpdateTable_SpecialErrors"></a>


****  

|  錯誤  |  描述  | 
| --- | --- | 
| ResourceNotFoundException  | 找不到指定的資料表。 | 
| ResourceInUseException | 資料表不處於 ACTIVE 狀態。 | 

## 範例
<a name="API_UpdateTable_Examples"></a>

### 請求範例
<a name="API_UpdateTable_Examples_Request"></a>

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

### 回應範例
<a name="API_UpdateTable_Examples_Response"></a>

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

## 相關動作
<a name="API_UpdateTable_Related_Actions"></a>
+  [CreateTable](API_CreateTable_v20111205.md) 
+  [DescribeTables](API_DescribeTables_v20111205.md) 
+  [DeleteTable](API_DeleteTable_v20111205.md)