
# 删除A号码报备信息 - DeletePvCallerNumber
#### 接口功能
企业用户通过该接口删除租户A号码报备信息。
#### 使用说明
仅使用隐私号业务的用户可调用此接口。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限管理](https://support.huaweicloud.com/productdesc-PrivateNumber/privatenumber_permissions.html)。
#### URI
DELETE /v1.0/privatenumber/a-number
#### 接口类型
表1接口类型说明 
|   请求方法    |            DELETE            |
|---|---|
| **访问URI** | /v1.0/privatenumber/a-number |
| **通信协议**  | HTTPS                        |
   
#### 请求参数
表2请求Headers参数说明 
| 参数名称         | 是否必选 | 参数类型   | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
|:---|:---|:---|:---|
| Content-Type | 否    | String | **参数解释：** 消息体的类型（格式）。 **约束限制：** 不涉及。 **取值范围：** 固定填写为application/json;charset=UTF-8。 **默认取值：** 不涉及。                    |
| X-Auth-Token | 是    | String | 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 说明： - Token的有效期为24小时，到期后请重新获取。  - 使用AKSK鉴权不需要携带此参数。   |
   
表3请求Body参数说明 
| 参数名称    | 是否必选 | 参数类型       | 说明                                                                                                                      |
|:---|:---|:---|:---|
| numbers | 是    | String\[\] | A号码，最多10个。 号码格式：填写为全局号码格式（国内号码），如：+86138\*\*\*\*0021或+8675528\*\*\*\*01。 |
   
#### 响应参数
表4响应结果参数 
| 参数名称       | 是否必选 | 参数类型   | 说明                                 |
|:---|:---|:---|:---|
| result     | 否    | String | 值为"Delete Successful."，响应码为200时携带。 |
| error_code | 否    | String | 错误码，响应码不为200时携带。                   |
| error_msg  | 否    | String | 错误描述，响应码不为200时携带。                  |
   
#### 结果码说明
表5响应结果码 
| 响应码                                                                                          | 返回值       | 英文描述                   | 说明       |
|:---|:---|:---|:---|
| 200                                                                                          | -         | Success.               | 成功。      |
| 400       | PPT.0001  | Internal server error. | 系统内部错误。  |
| 400       | PPT.0002  | Invalid Parameter.     | 无效参数。    |
| 400       | PPT.0009  | Order does not exist.  | 订单不存在。   |
| 400       | PPT.00039 | Operation failed.      | 操作失败。    |
| 403                                                                                          | PPT.0007  | Request unauthorized.  | 请求鉴权未通过。 |
   
#### 接口示例
- 请求示例
  ```
  DELETE /v1.0/privatenumber/a-number 
  {     
     "numbers":["+86185****6002"]
  }
  ```
  
- 响应示例
  ```
  成功：
  HTTP/1.1 200 
  Content-Type: application/json;charset=UTF-8 
  {
      "result": "Delete Successful."
  }
  失败：
  HTTP/1.1 403
  Content-Type: application/json;charset=UTF-8
  {
     "error_code":"PPT.0007",
     "error_msg": "Request unauthorized."
  }
  ```
  
 
