DeleteTable - Amazon DynamoDB
설명요청응답특수 오류예관련 작업

DeleteTable

중요

이 단원에서 언급되는 API 버전 2011-12-05는 사용 중단되었으며 새 애플리케이션에 사용해서는 안 됩니다.

현재 하위 수준 API에 대한 설명서는 Amazon DynamoDB API 참조 섹션을 참조하세요.

설명

DeleteTable 작업은 테이블과 테이블에 속한 모든 항목을 삭제합니다. DeleteTable 요청 이후 DynamoDB가 삭제를 완료할 때까지 지정한 테이블은 DELETING 상태가 됩니다. 테이블을 삭제하려면 해당 테이블 상태가 ACTIVE이어야 합니다. 테이블이 CREATING 또는 UPDATING 상태인 경우에는 DynamoDB가 ResourceInUseException 오류를 반환합니다. 그리고 지정한 테이블이 존재하지 않는 경우에는 DynamoDB가 ResourceNotFoundException을 반환합니다. 테이블이 이미 DELETING 상태라면 어떠한 오류도 반환되지 않습니다.

참고

DynamoDB는 테이블 삭제가 완료될 때까지는 DELETING 상태인 테이블에서 GetItem, PutItem 등의 데이터 플레인 작업 요청을 계속 허용할 수 있습니다.

테이블은 요청을 실행하는 AWS 계정 및 요청을 수신하는 AWS 리전(예: dynamodb.us-west-1.amazonaws.com)과 관련된 테이블에서 고유해야 합니다. 각 DynamoDB 엔드포인트는 완전히 독립적입니다. 예를 들어, dynamodb.us-west-2.amazonaws.com 및 dynamodb.us-west-1.amazonaws.com에 "MyTable"이라는 테이블이 각각 있는 경우 해당 테이블은 완전히 독립적이며 데이터를 공유하지 않습니다. 즉, 한 테이블을 삭제해도 다른 테이블이 삭제되지 않습니다.

DescribeTables 작업을 사용하여 테이블 상태를 확인합니다.

요청

구문

// This header is abbreviated. 
// For a sample of a complete header, see DynamoDB 하위 수준 API.
POST / HTTP/1.1 
x-amz-target: DynamoDB_20111205.DeleteTable 
content-type: application/x-amz-json-1.0

{"TableName":"Table1"}
명칭 설명 필수
TableName

삭제할 테이블 이름

유형: 문자열

예

응답

구문

HTTP/1.1 200 OK
x-amzn-RequestId: 4HONCKIVH1BFUDQ1U68CTG3N27VV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 311
Date: Sun, 14 Aug 2011 22:56:22 GMT

{"TableDescription":
    {"CreationDateTime":1.313362508446E9,
    "KeySchema":
        {"HashKeyElement":{"AttributeName":"user","AttributeType":"S"},
        "RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}},
    "ProvisionedThroughput":{"ReadCapacityUnits":10,"WriteCapacityUnits":10},
    "TableName":"Table1",
    "TableStatus":"DELETING"
    }
}
명칭 설명
TableDescription 테이블 속성에 대한 컨테이너
CreationDateTime

테이블 생성 날짜

형식: 숫자

KeySchema

테이블의 기본 키(단순 또는 복합) 구조. HashKeyElement에서는 이름-값 페어가 필수이지만 RangeKeyElement에서는 선택 사항입니다(복합 기본 키의 경우에만 필요함). 기본 키에 대한 자세한 내용은 프라이머리 키 단원을 참조하세요.

형식: HashKeyElement 맵, 또는 복합 기본 키의 HashKeyElement 및 RangeKeyElement
ProvisionedThroughput 지정 테이블의 처리량으로서 ReadCapacityUnits 값과 WriteCapacityUnits 값으로 구성됩니다. DynamoDB 프로비저닝된 용량 모드 섹션을 참조하세요.
ProvisionedThroughput: ReadCapacityUnits

DynamoDB가 다른 작업과 로드 밸런스를 맞출 때까지 지정 테이블에서 사용되는 ReadCapacityUnits의 초당 최소 수입니다.

형식: 숫자

ProvisionedThroughput: WriteCapacityUnits

DynamoDB가 다른 작업과 로드 밸런스를 맞출 때까지 지정 테이블에서 사용되는 WriteCapacityUnits의 초당 최소 수입니다.

형식: 숫자

TableName

삭제된 테이블 이름

유형: 문자열

TableStatus 현재 테이블 상태(DELETING) 이후 삭제된 테이블에 대해 요청을 실행하면 resource not found가 반환됩니다.

DescribeTables 작업을 사용하여 테이블 상태를 확인합니다.

유형: 문자열

특수 오류

Error 설명
ResourceInUseException 테이블이 CREATING 또는 UPDATING 상태이면 삭제할 수 없습니다.

예

샘플 요청

// This header is abbreviated. For a sample of a complete header, see DynamoDB 하위 수준 API.
POST / HTTP/1.1 
x-amz-target: DynamoDB_20111205.DeleteTable
content-type: application/x-amz-json-1.0
content-length: 40

{"TableName":"favorite-movies-table"}

샘플 응답

HTTP/1.1 200 OK
x-amzn-RequestId: 4HONCKIVH1BFUDQ1U68CTG3N27VV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 160
Date: Sun, 14 Aug 2011 17:20:03 GMT

{"TableDescription":
    {"CreationDateTime":1.313362508446E9,
    "KeySchema":
        {"HashKeyElement":{"AttributeName":"name","AttributeType":"S"}},
    "TableName":"favorite-movies-table",
    "TableStatus":"DELETING"
}