AttachDisk
为一台ECS实例挂载一块按数据盘或系统盘
服务地址:
华东1 金融云
输入参数
只看必填
InstanceId待挂载ECS实例的ID
DiskId待挂载的磁盘ID
Device磁盘设备名称
DeleteWithInstance释放实例时
请选择布尔值
Bootable是否作为系统盘挂载
请选择布尔值
Password挂载系统盘时
KeyPairName挂载系统盘时
Force是否是强制挂载请求
请选择布尔值
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

调用该接口时,您需要注意:

  • 实例和磁盘必须在同一个可用区。

  • 磁盘的状态必须为待挂载Available)。

  • 挂载数据盘时:

    • 目标 ECS 实例必须处于运行中Running)或者已停止Stopped)状态。
    • 如果是您单独购买的磁盘,计费方式必须是按量付费。
    • 从 ECS 实例上卸载的系统盘作为数据盘挂载时,不限制计费方式。
    • 弹性临时盘一旦卸载,只能重新挂载至其原始实例。
  • 挂载系统盘时:

    • 目标 ECS 实例必须是卸载该系统盘时的源实例。
    • 目标 ECS 实例必须处于已停止Stopped)状态。
    • 您必须设置实例登录凭证。
    • 弹性临时盘不支持挂载为系统盘。
    • 更多关于挂载系统盘的信息,请参见卸载或挂载系统盘
  • 查询 ECS 实例信息时,如果返回数据中包含{"OperationLocks": {"LockReason" : "security"}},则禁止一切操作。

  • 开启多重挂载特性的云盘,只能挂载到支持 NVMe 协议的实例上。 更多信息,请参见ESSD 云盘支持 NVMe以及使用多重挂载功能

请求参数

字段名称字段详情
InstanceIdstring

待挂载 ECS 实例的 ID。

示例值:i-bp1dq5lozx5f4pmd****参考取值来源:
    RunInstances
    StopInstances
    StartInstances
    CreateInstance
    RebootInstances
    DescribeInstances
    ModifyManagedInstance
    RenewReservedInstances
    DetachInstanceRamRole
    AttachInstanceRamRole
    DeregisterManagedInstance
    PurchaseReservedInstancesOffering
DiskIdstring

待挂载的磁盘 ID。磁盘(DiskId)和实例(InstanceId)必须在同一个可用区。展开详情

示例值:d-bp1j4l5axzdy6ftk****参考取值来源:
    CreateDisk
    DescribeDisks
Devicestring

磁盘设备名称。展开详情

示例值:testDeviceName
DeleteWithInstanceboolean

释放实例时,该磁盘是否随实例一起释放。取值范围:展开详情

示例值:false
Bootableboolean

是否作为系统盘挂载。取值范围:展开详情

示例值:false
Passwordstring

挂载系统盘时,设置实例的用户名密码,仅对 administrator 和 root 用户名生效,其他用户名不生效。长度为 8 至 30 个字符,必须同时包含大小写英文字母、数字和特殊符号中的三类字符。特殊符号可以是:展开详情

示例值:EcsV587!
KeyPairNamestring

挂载系统盘时,为 Linux 系统 ECS 实例绑定的 SSH 密钥对的名称。展开详情

示例值:KeyPairTestName参考取值来源:
    DetachKeyPair
    CreateKeyPair
    AttachKeyPair
    ImportKeyPair
    DescribeKeyPairs
Forceboolean

是否是强制挂载请求。取值范围:展开详情

示例值:false

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
变更历史
变更时间变更内容概要操作
2025-01-14
变更错误码500
2025-01-06
变更错误码403
2024-12-30
变更错误码400
变更错误码403
2024-11-27
变更错误码400
2024-07-08
变更错误码404
  • 1
  • 2
  • 10 条/页