중요
이 단원에서 언급되는 API 버전 2011-12-05는 사용 중단되었으며 새 애플리케이션에 사용해서는 안 됩니다.
현재 하위 수준 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가 다른 작업과 로드 밸런스를 맞출 때까지 지정 테이블에서 사용되는 consistent Eventually consistent read 작업은 consistent read 작업에 비해 필요한 부하가 적습니다. 따라서 초당 consistent 형식: 숫자 |
예 |
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 작업을 사용하여 테이블 상태를 확인합니다. 유형: 문자열 |
특수 오류
| Error | 설명 |
|---|---|
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"}
}관련 작업
