# 删除表
#### 功能介绍
DeleteTable操作删除表及其所有项。在DeleteTable请求之后，指定的表一直处于DELETING状态，直到KVS完成删除。
#### URI
POST /v1/delete-table
表1Query参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                   |
|:---|:---|:---|:---|
| store_name | 否    | String | 仓名，全域唯一，不同租户的仓名不能相同。 - 格式：${prefix}-${region-code}-${account-id}，其中prefix为自定义前缀，region-code为KVS集群所在的区域代码，account-id为用户的账户id - 取值字符限制：\[a-z0-9-\]+ - 长度：\[16,52\] 说明： "-"不能出现在名字头部或尾部 |
#### 请求参数
表2请求Body参数 
| 参数         | 是否必选 | 参数类型   | 描述                                           |
|:---|:---|:---|:---|
| table_name | 是    | String | 表名。 - 长度：\[3, 52\] - 取值字符限制：\[a-zA-Z0-9_-\]+ |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数                            | 参数类型                                                                                     | 描述                                        |
|:---|:---|:---|
| table_name                    | String                                                                                   | 表名。 - 长度：\[3, 52\] - 取值字符限制：\[a-z0-9_-\]+ |
| primary_key_schema            | [primary_key_schema] object                   | 主键模板, 最多1个，必须指定主键schema。                  |
| local_secondary_index_schema  | Array of [local_secondary_index] objects   | 本地二级索引模板，可以多个。                            |
| global_secondary_index_schema | Array of [global_secondary_index] objects | 全局二级索引模板。                                 |
| run_time_info                 | [run_time_info] object                             | 运行信息。                                     |
   
 表4primary_key_schema 
| 参数               | 参数类型                                                   | 描述             |
|:---|:---|:---|
| shard_key_fields | Array of [field] objects | 分区键字段名数组，顺序组合。 |
| shard_mode       | String                                                 | 分区模式。          |
| sort_key_fields  | Array of [field] objects | 排序键字段名数组，顺序组合。 |
   
 表5local_secondary_index 
| 参数              | 参数类型                                                   | 描述             |
|:---|:---|:---|
| index_name      | String                                                 | 二级索引名称，表内唯一。   |
| sort_key_fields | Array of [field] objects | 排序键字段名数组，顺序组合。 |
| abstract_fields | Array of strings                                       | 摘要字段名数组。       |
   
 表6global_secondary_index 
| 参数                     | 参数类型                                                                           | 描述                                      |
|:---|:---|:---|
| index_name             | String                                                                         | 二级索引名称，表内唯一。                            |
| shard_key_fields       | Array of [field] objects                         | 分区键字段名数组，顺序组合。                          |
| shard_mode             | String                                                                         | 分区模式。                                   |
| sort_key_fields        | Array of [field] objects                         | 排序键字段名数组，顺序组合。                          |
| abstract_fields        | Array of strings                                                               | 摘要字段名数组。                                |
| provisioned_throughput | [provisioned_throughput] object | 预置吞吐读写请求单元数，在bill_mode="provisioned"有效。 |
   
 表7field 
| 参数    | 参数类型    | 描述          |
|:---|:---|:---|
| name  | String  | 字段名。        |
| order | Boolean | bool值预留无意义。 |
   
 表8provisioned_throughput 
| 参数  | 参数类型 | 描述          |
|:---|:---|:---|
| rcu | Long | 预置表级读请求单元数。 |
| wcu | Long | 预置表级写请求单元数。 |
   
 表9run_time_info 
| 参数                           | 参数类型                                                                                               | 描述         |
|:---|:---|:---|
| table_info                   | [table_info] object                                             | 表信息。       |
| local_secondary_index_infos  | Array of [secondary_index_info] objects               | 索引状态。      |
| global_secondary_index_infos | Array of [global_secondary_index_info] objects | 全局二级索引运行态。 |
   
 表10table_info 
| 参数           | 参数类型   | 描述                                        |
|:---|:---|:---|
| table_status | String | 表状态。 - "creating" - "active" - "deleting" |
   
 表11secondary_index_info 
| 参数           | 参数类型   | 描述                                           |
|:---|:---|:---|
| index_name   | String | 索引状态。 - 长度：\[1, 255\] - 取值字符限制：\[a-z0-9_-\]+ |
| index_status | String | 索引状态。 - "creating" - "active" - "deleting"   |
   
 表12global_secondary_index_info 
| 参数           | 参数类型   | 描述                                           |
|:---|:---|:---|
| index_name   | String | 二级索引名称。                                      |
| index_status | String | 二级索引名称。 - "creating" - "active" - "deleting" |
   
**状态码：404**
表13响应Body参数 
| 参数         | 参数类型   | 描述         |
|:---|:---|:---|
| error_code | String | 请求返回的错误码。  |
| error_msg  | String | 请求返回的错误信息。 |
   
**状态码：409**
表14响应Body参数 
| 参数         | 参数类型   | 描述         |
|:---|:---|:---|
| error_code | String | 请求返回的错误码。  |
| error_msg  | String | 请求返回的错误信息。 |
   
#### 请求示例
在test-store仓内，删除表名为test-table的表
```
POST https://test-store.{endpoint}/v1/delete-table
{
  "table_name" : "test-table"
}
```
#### 响应示例
**状态码：200**
表示删除表成功。
```
{
  "table_name" : "test-table",
  "primary_key_schema" : {
    "shard_key_fields" : [ {
      "name" : "owner",
      "order" : true
    } ],
    "sort_key_fields" : [ {
      "name" : "filename",
      "order" : true
    } ]
  }
}
```
#### 状态码
| 状态码 | 描述       |
|:---|:---|
| 200 | 表示删除表成功。 |
| 404 | 表不存在。    |
| 409 | 表请求冲突。   |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-kvs/ErrorCode.html)。