文档首页 > > 开发指南> 删除云硬盘

删除云硬盘

分享
更新时间: 2019/06/25 GMT+08:00

场景描述

当云硬盘不再使用时,您可以删除云硬盘,以释放虚拟资源。

约束限制

  • 当云硬盘状态为available、error、error_extending、error_restoring、error_rollbacking时,才可以删除云硬盘。
  • 对于共享云硬盘,必须从其所挂载的所有的云服务器上卸载成功时,才可以删除。
  • 删除云硬盘时,会同时删除所有云硬盘数据,通过该云硬盘创建的快照也会被删除,请谨慎操作。
  • 已经删除的云硬盘不可恢复,请谨慎操作。

涉及接口

首先需要查询云硬盘列表,获取要删除的云硬盘ID,然后删除该云硬盘。

为了满足以上需求,使用提供以下功能的API:

  • 查询云硬盘列表
  • 删除云硬盘

操作步骤

  1. 查询云硬盘列表。
    • 接口相关信息

      URI格式:GET /v2/{project_id}/volumes

      详情请参考《云硬盘API参考》的“查询云硬盘列表”章节。

    • 请求样例

      GET /v2/000efdc5f9064584b718b181df137bd7/volumes

    • 响应样例
      {
          "volumes": [
              {
                  "id": "6b604cef-9bd8-4f5a-ae56-45839e6e1f0a", 
                  "links": [
                      {
                          "href": "https://volume.localdomain.com:8776/v2/dd14c6ac581f40059e27f5320b60bf2f/volumes/6b604cef-9bd8-4f5a-ae56-45839e6e1f0a", 
                          "rel": "self"
                      }, 
                      {
                          "href": "https://volume.localdomain.com:8776/dd14c6ac581f40059e27f5320b60bf2f/volumes/6b604cef-9bd8-4f5a-ae56-45839e6e1f0a", 
                          "rel": "bookmark"
                      }
                  ], 
                  "name": "zjb_u25_test"
              }, 
              {
                  "id": "2bce4552-9a7d-48fa-8484-abbbf64b206e", 
                  "links": [
                      {
                          "href": "https://volume.localdomain.com:8776/v2/dd14c6ac581f40059e27f5320b60bf2f/volumes/2bce4552-9a7d-48fa-8484-abbbf64b206e", 
                          "rel": "self"
                      }, 
                      {
                          "href": "https://volume.localdomain.com:8776/dd14c6ac581f40059e27f5320b60bf2f/volumes/2bce4552-9a7d-48fa-8484-abbbf64b206e", 
                          "rel": "bookmark"
                      }
                  ], 
                  "name": "zjb_u25_test"
              }, 
              {
                  "id": "3f1b98ec-a8b5-4e92-a727-88def62d5ad3", 
                  "links": [
                      {
                          "href": "https://volume.localdomain.com:8776/v2/dd14c6ac581f40059e27f5320b60bf2f/volumes/3f1b98ec-a8b5-4e92-a727-88def62d5ad3", 
                          "rel": "self"
                      }, 
                      {
                          "href": "https://volume.localdomain.com:8776/dd14c6ac581f40059e27f5320b60bf2f/volumes/3f1b98ec-a8b5-4e92-a727-88def62d5ad3", 
                          "rel": "bookmark"
                      }
                  ], 
                  "name": "zjb_u25_test"
              }
          ], 
          "volumes_links": [
              {
                  "href": "https://volume.localdomain.com:8776/v2/dd14c6ac581f40059e27f5320b60bf2f/volumes?limit=3&marker=3f1b98ec-a8b5-4e92-a727-88def62d5ad3", 
                  "rel": "next"
              }
          ]
      }
  2. 删除云硬盘。
    • 接口相关信息

      URI格式:DELETE /v2/{project_id}/volumes/{volume_id}

      详情请参考《云硬盘API参考》的“删除云硬盘”章节。

    • 请求样例

      DELETE /v2/000efdc5f9064584b718b181df137bd7/baremetalservers/5850a7e7-88dd-4d99-8439-347de8cc0dd7/volume/50ef9435-ca68-4b9b-a837-73377b9fdaa3?cascade=true

      说明:

      cascade=true表示同步删除云硬盘对应的快照。

    • 响应样例

      {
          "error": {
              "message": "XXXX", 
              "code": "XXX"
          }
      }
      其中error是泛指的错误,有badRequest、itemNotFound等,如报错为:
      {
          "badRequest": {
              "message": "XXXX", 
              "code": "XXX"
          }
      }
分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区