文档首页/ AI开发平台ModelArts/ API参考/ Lite Server管理/ Lite Server服务器卸载磁盘 - DetachDevServerVolume
更新时间:2026-01-08 GMT+08:00
分享

Lite Server服务器卸载磁盘 - DetachDevServerVolume

功能介绍

Lite Server服务器卸载磁盘接口用于从Lite Server服务器上卸载已挂载的磁盘。该接口适用于以下场景:当用户需要释放存储资源或重新分配磁盘时,可以通过此接口卸载指定的磁盘。使用该接口的前提条件是Lite Server服务器已创建且处于运行状态、或者停止状态,用户具有卸载磁盘的权限,且指定的磁盘已挂载到服务器上。卸载操作完成后,磁盘将从Lite Server服务器上成功卸载,用户可以将其挂载到其他服务器或进行其他操作。若Lite Server服务器不存在、指定的磁盘未挂载到服务器上,或用户无权限操作,接口将返回相应的错误信息。

接口约束

仅限A3

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

DELETE /v1/{project_id}/dev-servers/{id}/detachvolume/{volume_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:用户项目ID。获取方法请参见获取项目ID和名称

约束限制:1 - 64字符,字母、数字和中划线。

取值范围:不涉及。

默认取值:不涉及。

id

String

参数解释:Lite Server实例ID。

约束限制:^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$。

取值范围:不涉及。

默认取值:不涉及。

volume_id

String

参数解释:要卸载的磁盘ID。

约束限制:[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}。

取值范围:不涉及。

默认取值:不涉及。

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

operation_id

String

参数解释:操作ID。

取值范围:长度为[8,36]个字符。

operation_status

String

参数解释:操作状态。

取值范围:长度为[8,36]个字符。

operation_type

String

参数解释:操作类型。

取值范围:长度为[8,36]个字符。

operation_error

ServerOperationError object

参数解释:错误信息。

表3 ServerOperationError

参数

参数类型

描述

code

String

参数解释:错误编码。

取值范围:长度为[8,36]个字符。

message

String

参数解释:错误信息。

取值范围:长度为[2,512]个字符。

请求示例

响应示例

状态码:200

{
    "operation_id": "UUID",
    "operation_status": "running",
    "operation_type": "node_detach_volume",
}

状态码

状态码

描述

200

错误码

请参见错误码

相关文档