# 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가 다른 작업과 로드 밸런스를 맞출 때까지 지정 테이블에서 사용되는 consistent `ReadCapacityUnits`의 초당 최소 수를 설정합니다. Eventually consistent read 작업은 consistent read 작업에 비해 필요한 부하가 적습니다. 따라서 초당 consistent `ReadCapacityUnits`를 50으로 설정하면 초당 eventually consistent `ReadCapacityUnits`는 100이 됩니다.형식: 숫자  | 예 | 
| 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`에서는 선택 사항입니다(복합 기본 키의 경우에만 필요함). 최대 해시 키 크기는 2,048byte입니다. 최대 범위 키 크기는 1,024byte입니다. 두 키의 크기 제한은 별도로 적용됩니다(해시 \$1 범위 키 2,048 \$1 1,024 합산). 기본 키에 대한 자세한 내용은 [프라이머리 키](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>


****  

|  Error  |  설명  | 
| --- | --- | 
| 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)