文档中心

云服务器

请输入

云盘

AttachVolume - 挂载云盘

调用AttachVolume接口挂载云盘到云主机。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：AttachVolume

要执行的操作，取值：AttachVolume。

Version string 必选示例值：2020-04-01

API的版本，取值：2020-04-01。

DeleteWithInstance boolean 可选示例值：true

释放实例时，该云盘是否随实例一起释放，默认为false。

true：云盘随实例一起释放。

false：云盘不随实例一起释放。

InstanceId string 必选示例值：i-3tiefmkskq3vj0x0****

被挂载的ECS实例ID。

VolumeId string 必选示例值：vol-3tir92lne23vj0x****

待挂载的云盘ID。

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

请求示例

GET /?Action=AttachVolume&Version=2020-04-01&InstanceId=i-3tir90q84q3vj0x1****&VolumeId=vol-3tir92lne23vj0x1**** HTTP/1.1​
Host: open.volcengineapi.com​
Region: cn-beijing​
ServiceName: storage_ebs​

返回示例

{​
    "ResponseMetadata": {​
        "RequestId": "202106232008120102251331430A0D****",​
        "Action": "AttachVolume",​
        "Version": "2020-04-01",​
        "Service": "storage_ebs",​
        "Region": "cn-beijing"​
    },​
    "Result": {}​
}​

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	MissingVolumeID	The specified parameter VolumeId is missing.	缺少云盘ID。
400	MissingInstanceID	Missing instance ID.	缺少实例ID。
403	VolumeCannotAttachAcrossZones	Volumes cannot be attached across different availability zones.	云盘禁止跨可用区挂载。
403	VolumeCannotAttachAcrossAccount	Volumes cannot be attached across different master accounts.	云盘和实例无法跨主账户挂载。
403	ErrorVolumeStatusCannotAttach	Invalid volume status for volume attaching.	该状态的云盘不支持挂载。
404	VolumeNotFound	The specified volume does not exist.	云盘不存在。
404	ErrorInvalidInstanceStatus	Instance status exception.	云主机状态异常。
404	ErrorInstanceNotFound	Instance not found.	云主机未查询到。
412	ErrorVolumeStatusInMigration	Volume is undergoing data migration.	云盘正在数据迁移中。
412	ErrorVolumeStatusInChanging	Volume type is being changed.	云盘正在变配中。
412	VolumeStatusInRollbacking	Volume is being rolled back.	云盘正在回滚中。
412	VolumeStatusCannotAttach	Invalid volume status for volume attaching.	该状态的云盘不支持挂载。
412	AlreadyExitOrder	Order in progress, cannot perform operation.	订单进行中，无法进行操作。
412	ErrInstanceLimitExceeded	You've reached the limit on the number of volumes that can be attached to the instance.	您已达到可挂载到实例的云盘数量限制。
500	ResourceLockError	Failed to lock resource: [resourceId]	资源加锁失败：[resourceId]。

最近更新时间：2026.01.07 17:09:44

这个页面对您有帮助吗？

有用

无用