# DeleteTable
<a name="API_DeleteTable_v20111205"></a>

**중요**  
***이 단원에서 언급되는 API 버전 2011-12-05는 사용 중단되었으며 새 애플리케이션에 사용해서는 안 됩니다.***  
 **현재 하위 수준 API에 대한 설명서는 [Amazon DynamoDB API 참조](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/) 섹션을 참조하세요.**

## 설명
<a name="API_DeleteTable_Description"></a>

`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](API_DescribeTables_v20111205.md) 작업을 사용하여 테이블 상태를 확인합니다.

## 요청
<a name="API_DeleteTable_RequestParameters"></a>

### 구문
<a name="API_DeleteTable_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.DeleteTable 
content-type: application/x-amz-json-1.0

{"TableName":"Table1"}
```


****  

|  명칭  |  설명  |  필수 | 
| --- | --- | --- | 
|  TableName  |   삭제할 테이블 이름   유형: 문자열   |  예  | 

## 응답
<a name="API_DeleteTable_CommonResponseElements"></a>

### 구문
<a name="API_DeleteTable_CommonResponseElements.syntax"></a>

```
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`에서는 선택 사항입니다(복합 기본 키의 경우에만 필요함). 기본 키에 대한 자세한 내용은 [프라이머리 키](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey) 단원을 참조하세요.형식: `HashKeyElement` 맵, 또는 복합 기본 키의 `HashKeyElement` 및 `RangeKeyElement` | 
| ProvisionedThroughput  | 지정 테이블의 처리량으로서 ReadCapacityUnits 값과 WriteCapacityUnits 값으로 구성됩니다. [DynamoDB 프로비저닝된 용량 모드](provisioned-capacity-mode.md) 섹션을 참조하세요. | 
| ProvisionedThroughput: ReadCapacityUnits |  DynamoDB가 다른 작업과 로드 밸런스를 맞출 때까지 지정 테이블에서 사용되는 `ReadCapacityUnits`의 초당 최소 수입니다.형식: 숫자  | 
| ProvisionedThroughput: WriteCapacityUnits | DynamoDB가 다른 작업과 로드 밸런스를 맞출 때까지 지정 테이블에서 사용되는 `WriteCapacityUnits`의 초당 최소 수입니다.형식: 숫자  | 
|  TableName  |  삭제된 테이블 이름 유형: 문자열   | 
|  TableStatus  | 현재 테이블 상태(DELETING) 이후 삭제된 테이블에 대해 요청을 실행하면 resource not found가 반환됩니다.[DescribeTables](API_DescribeTables_v20111205.md) 작업을 사용하여 테이블 상태를 확인합니다.유형: 문자열 | 

## 특수 오류
<a name="API_DeleteTable_SpecialErrors"></a>


****  

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

## 예
<a name="API_DeleteTable_Examples"></a>

### 샘플 요청
<a name="API_DeleteTable_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.DeleteTable
content-type: application/x-amz-json-1.0
content-length: 40

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

### 샘플 응답
<a name="API_DeleteTable_Examples_Response"></a>

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

## 관련 작업
<a name="API_DeleteTable_Related_Actions"></a>
+  [CreateTable](API_CreateTable_v20111205.md) 
+  [DescribeTables](API_DescribeTables_v20111205.md)