# 场景3：重置某应用运行态所有数据
#### 操作场景
当您应用中的多个逻辑租户均产生很多脏数据，您希望可以一键恢复至应用的初始状态，您可以通过调用"数据清理与重置"的"application-clean-task"接口，自定义"name"参数值删除该应用运行态下的所有数据，重置应用，释放空间。
**重置应用数据会清除应用运行态上的所有数据，将导致数据不可恢复，请谨慎操作。**
#### 涉及接口
- 创建并执行重置应用数据任务 URI格式：POST http://**{Endpoint}** /rdm_**{appID}**_app/services/rdm/basic/api/v1/application-clean-task
  
- 查询任务执行结果 URI格式：GET http://**{Endpoint}** /rdm_**{appID}** _app/services/rdm/basic/api/v1/application-clean-task/**{id}**
  
- 重试重置应用数据任务 URI格式：PUT http://**{Endpoint}** /rdm_**{appID}** _app/services/rdm/basic/api/v1/application-clean-task/**{id}**
  
其中，{endpoint}表示承载REST服务端点的服务器域名或IP地址，{appID}表示应用ID，{id}表示重置应用数据任务ID。
#### 操作步骤
1. 创建并执行重置应用数据任务。
   
   - URI格式：POST http://**{Endpoint}** /rdm_**{appID}**_app/services/rdm/basic/api/v1/application-clean-task
   
   - 参数说明请参见[全量数据服务](https://support.huaweicloud.com/usermanual-idme/idme_clientog_0154.html)的"系统管理API \> 数据清理与重置"。
   
   - 请求示例：
     ```
     POST https://dme.cn-north-4.huaweicloud.com/rdm_fce01234567d41828cf3473b07fa7ae2_app/services/rdm/basic/api/v1/application-clean-task
     X-AUTH-TOKEN: ABCDEFG....
     {
         "name": "ResetTestApp"
     }
     ```
     
   
   - 响应示例： 为篇幅起见，这里只展示部分内容。请求成功时，响应参数如下：
     ```
     {
         "result": "SUCCESS",
         "data": [
             {
                 "id": 576800426431614976,
                 "name": "ResetTestApp",
                 "task_status": "AWAIT_START",
                 "tenant_clean_tasks": [
                     {
                         "id": "576800426490335232",
                         "creator": "Tester_HQ 362613cab50d4f42be5749d111111d4f",
                         "createTime": "2023-12-14T15:58:58.109+0800",
                         "modifier": "Tester_HQ 362613cab50d4f42be5749d111111d4f",
                         "lastUpdateTime": "2023-12-14T15:58:58.109+0800",
                         "rdmVersion": 1,
                         "rdmDeleteFlag": 0,
                         "className": null,
                         "rdmExtensionType": "TenantCleanTask",
                         "hibernateVersion": 1,
                         "tenant": {
                             "id": "-1",
                             "clazz": "Tenant"
                         },
                         "name": "ResetTestApp",
                         "applicationTaskId": 576800426431614976,
                         "cleanTaskTenantId": -1,
                         "type": "TENANT_RESET",
                         "taskStatus": "ONGOING",
                         "retryTimes": 0,
                         "fileStatus": "AWAIT_START",
                         "ddsStatus": "AWAIT_START",
                         "cssStatus": "AWAIT_START",
                         "rdsStatus": "AWAIT_START",
                         "metadataStatus": "AWAIT_START",
                         "failMessage": null
                     },
                     {
                         ......
                     },
                     ......
                 ]
             }
         ],
         "errors": []
     }
     ```
     
   
   
   
   
2. 记录[响应]中"data"的"id"，例如"576800426431614976"。
3. 查询任务执行结果。 
   - URI格式：GET http://**{Endpoint}** /rdm_**{appID}** _app/services/rdm/basic/api/v1/tenant-clean-task/**{id}**
   
   - 参数说明请参见[全量数据服务](https://support.huaweicloud.com/usermanual-idme/idme_clientog_0154.html)的"系统管理API \> 数据清理与重置"。
   
   - 请求示例：
     ```
     GET https://dme.cn-north-4.huaweicloud.com/rdm_fce01234567d41828cf3473b07fa7ae2_app/services/rdm/basic/api/v1/tenant-clean-task/576800426431614976
     X-AUTH-TOKEN: ABCDEFG....
     ```
     
   
   - 响应示例：
     ```
     {
         "result": "SUCCESS",
         "data": [
             {
                 "id": 576800426431614976,
                 "name": "ResetTestApp",
                 "task_status": "SUCCESS",
                 "tenant_clean_tasks": [
                     {
                         "id": "576800426490335232",
                         "creator": "Tester_HQ 362613cab50d4f42be5749d111111d4f",
                         "createTime": "2023-12-14T15:58:58.109+0800",
                         "modifier": "Tester_HQ 362613cab50d4f42be5749d111111d4f",
                         "lastUpdateTime": "2023-12-14T15:58:58.109+0800",
                         "rdmVersion": 5,
                         "rdmDeleteFlag": 0,
                         "className": null,
                         "rdmExtensionType": "TenantCleanTask",
                         "hibernateVersion": 8,
                         "tenant": {
                             "id": "-1",
                             "clazz": "Tenant"
                         },
                         "name": "ResetTestApp",
                         "applicationTaskId": 576800426431614976,
                         "cleanTaskTenantId": -1,
                         "type": "TENANT_RESET",
                         "taskStatus": "SUCCESS",
                         "retryTimes": 0,
                         "fileStatus": "SUCCESS",
                         "ddsStatus": "SUCCESS",
                         "cssStatus": "SUCCESS",
                         "rdsStatus": "SUCCESS",
                         "metadataStatus": "SUCCESS",
                         "failMessage": null
                     },
                     {
                         ......
                     },
                     ......
                 ]
             }
         ],
         "errors": []
     }
     ```
     
   
   
   
   
4. （可选）手动重试重置应用数据任务。 
   - URI格式：PUT http://**{Endpoint}** /rdm_**{appID}** _app/services/rdm/basic/api/v1/tenant-clean-task/**{id}**
   
   - 参数说明请参见[全量数据服务](https://support.huaweicloud.com/usermanual-idme/idme_clientog_0154.html)的"系统管理API \> 数据清理与重置"。
     - 如果响应的"taskStatus"为"success"或"fail"，不允许调用重试接口。
     
     - 如果响应的"taskStatus"为"FAIL_AWAIT_RETRY"，则表示重置失败，正在等待重试。系统会连续3天在凌晨3点自动重试，如果重试3次后仍重置失败，则任务结束。您也可以通过此步骤手动重试。
     
     - 一个"taskStatus"为"FAIL_AWAIT_RETRY"的任务仅支持重试3次。
      
   
   - 请求示例：
     ```
     PUT https://dme.cn-north-4.huaweicloud.com/rdm_fce01234567d41828cf3473b07fa7ae2_app/services/rdm/basic/api/v1/tenant-clean-task/576800426431614976
     X-AUTH-TOKEN: ABCDEFG....
     ```
     
   
   - 响应示例：
     ```
     {
         "result": "SUCCESS",
         "data": [
             {
                 "id": 576800426431614976,
                 "name": "ResetTestApp",
                 "task_status": "SUCCESS",
                 "tenant_clean_tasks": [
                     {
                         "id": "576800426490335232",
                         "creator": "Tester_HQ 362613cab50d4f42be5749d111111d4f",
                         "createTime": "2023-12-14T15:58:58.109+0800",
                         "modifier": "Tester_HQ 362613cab50d4f42be5749d111111d4f",
                         "lastUpdateTime": "2023-12-14T15:58:58.109+0800",
                         "rdmVersion": 5,
                         "rdmDeleteFlag": 0,
                         "className": null,
                         "rdmExtensionType": "TenantCleanTask",
                         "hibernateVersion": 8,
                         "tenant": {
                             "id": "-1",
                             "clazz": "Tenant"
                         },
                         "name": "ResetTestApp",
                         "applicationTaskId": 576800426431614976,
                         "cleanTaskTenantId": -1,
                         "type": "TENANT_RESET",
                         "taskStatus": "ONGOING",
                         "retryTimes": 1,
                         "fileStatus": "SUCCESS",
                         "ddsStatus": "SUCCESS",
                         "cssStatus": "SUCCESS",
                         "rdsStatus": "SUCCESS",
                         "metadataStatus": "SUCCESS",
                         "failMessage": null
                     },
                     {
                         ......
                     },
                     ......
                 ]
             }
         ],
         "errors": []
     }
     ```