
# 删除通道号
#### 功能介绍
删除通道号。
#### URI
DELETE /v1/aim-sa/ports/{port_id}
表1路径参数 
| 参数      | 是否必选 | 参数类型   | 描述                             |
|:---|:---|:---|:---|
| port_id | 是    | String | 通道号ID。 最小长度：**32** 最大长度：**32** |
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                       |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
   
#### 响应参数
**状态码： 200**
表3响应Body参数 
| 参数   | 参数类型                                                                          | 描述        |
|:---|:---|:---|
| data | [DeletePortResponseBody] object | 通道号删除返回体。 |
   
 表4DeletePortResponseBody 
| 参数   | 参数类型                                      | 描述   |
|:---|:---|:---|
| data | [data] object | 消息体。 |
   
 表5data 
| 参数        | 参数类型    | 描述                              |
|:---|:---|:---|
| port      | String  | 通道号。                            |
| port_type | Integer | 通道号类型。 - 1：普通 - 3：前缀号段 - 5：后缀号段 |
   
**状态码： 400**
表6响应Body参数 
| 参数         | 参数类型   | 描述    |
|:---|:---|:---|
| error_code | String | 错误码。  |
| error_msg  | String | 结果详情。 |
   
**状态码： 500**
表7响应Body参数 
| 参数         | 参数类型   | 描述    |
|:---|:---|:---|
| error_code | String | 错误码。  |
| error_msg  | String | 结果详情。 |
   
#### 请求示例
根据通道号ID删除通道号。
```
https://koomessage.myhuaweicloud.cn/v1/aim-sa/ports/d78ef595032d4a7babe29a9f7872cccc
```
#### 响应示例
**状态码： 200**
返回信息。
```
{
  "data" : {
    "data" : {
      "port" : "0611421",
      "port_type" : 1
    }
  }
}
```
#### 状态码
| 状态码 | 描述    |
|:---|:---|
| 200 | 返回信息。 |
| 400 | 非法参数。 |
| 500 | 内部错误。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-koomessage/ErrorCode.html)。
