# 数据集彻底删除
#### 功能介绍
只针对从obs上传的数据，在删除数据集的时候要关联删除OBS下对应的原始数据。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/productdesc-pangulm/pangulm_01_0020.html)。
#### URI
POST /v1/{project_id}/workspaces/{workspace_id}/data-management/dataset/permanent-delete
#### 请求参数
表1请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释：** 用户Token。 用于获取操作API的权限。如[图4](https://support.huaweicloud.com/api-pangulm/pangulm_05_0009.html#pangulm_05_0009__fig10797003103)中响应消息头中X-Subject-Token的值即为Token。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 |
| Content-Type | 是    | String | **参数解释：** 发送的实体的MIME类型。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** application/json                                                                                                                                                                       |
   
表2请求Body参数 
| 参数           | 是否必选 | 参数类型        | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
|:---|:---|:---|:---|
| dataset_name | 是    | string      | **参数解释：** 数据集名称。 **约束限制：** 名称长度范围\[1,128\]。 **取值范围：** 不涉及。 **默认取值：** 不涉及。                                                                                                                                                                                                                                                                         |
| catalog      | 否    | CatalogEnum | **参数解释：** 数据集形态。 **约束限制：** 不涉及。 **取值范围：** - ORIGINAL：执行数据导入产生的数据集类型。  - PROCESS：执行数据加工产生的数据集类型。  - PUBLISH：执行数据发布产生的数据集类型。   **默认取值：** 不涉及。 |
| delete_obs   | 否    | boolean     | **参数解释：** 删除obs数据。 **约束限制：** 不涉及。 **取值范围：** - true：删除obs数据。  - false：不删除obs数据。   **默认取值：** 不涉及。                                                                                                      |
   
#### 响应参数
| 参数           | 参数类型        | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
|:---|:---|:---|
| dataset_name | string      | **参数解释：** 数据集名称。 **约束限制：** 不涉及。 **取值范围：** 名称长度范围\[1,128\]。 **默认取值：** 不涉及。                                                                                                                                                                                                                                                                                  |
| catalog      | CatalogEnum | **参数解释：** 数据集形态。 **约束限制：** 不涉及。 **取值范围：** - ORIGINAL：执行数据导入产生的数据集类型。  - PROCESS：执行数据加工产生的数据集类型。  - PUBLISH：执行数据发布产生的数据集类型。   **默认取值：** 不涉及。 |
| result       | boolean     | **参数解释：** 操作结果。 **约束限制：** 不涉及。 **取值范围：** - true：删除成功。  - false：删除失败。   **默认取值：** 不涉及。                                                                                                                                    |
   
#### 请求示例
彻底删除数据集对应的OBS原始数据
```
POST https://{endpoint}/v1/{project_id}/workspaces/{workspace_id}/data-management/dataset/permanent-delete
Request Header:
Content_Type: application/json
X-Auth-Token: MIIVV...
Request Params:
dataset_name: pub_345135233
catalog: PROCESS
delete_obs:true
```
#### 响应示例
```
{
    "DatasetOperationResp": [
        {
            "dataset_name": pub_345135233,
            "catalog": PROCESS,
            "result": true,
        },
     ]
}
```
#### 状态码
请参见[状态码](https://support.huaweicloud.com/api-pangulm/pangulm_05_0019.html)。
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-pangulm/pangulm_05_0020.html)。