<table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> <p><strong>API</strong></p> </td> <td> <p><strong>描述</strong></p> </td> </tr> <tr> <td> <p>AttachDiskToInstance</p> </td> <td> <p>挂载云磁盘到云主机实例。<br /> <br /> 挂载云磁盘需要通过登陆认证获取令牌。<br /> 调用接口是，需要注意：<br /> 1. 云磁盘的状态必须为ToAttach（待挂载）;<br /> 2. 云磁盘类型必须和云主机类型对应;<br /> 调用该接口之前，可以调用ListDisks接口查询当前云磁盘的信息。<br /> 调用该接口之前，可以调用ListAbleAttachInstance接口将查询出所有可挂载的云主机实例。<br /> 该接口是异步操作，接口调用成功返回信息后需要等待片刻才能完成。</p> </td> </tr> <tr> <td> <p>CheckQuota</p> </td> <td> <p>扩容时配额校验<br /> 校验内容：1）扩容后的磁盘大小不能小于原来的磁盘大小<br /> 2）单个实例磁盘大小配额<br /> 3）单块磁盘大小配额</p> </td> </tr> <tr> <td> <p>CreateDisk</p> </td> <td> <p>创建一块或多块付费的数据云磁盘。云磁盘的类型可通过ListAllEbsTypes接口查询。<br /> <br /> 创建云磁盘需要通过登陆认证获取令牌。<br /> 创建云磁盘会涉及到资源计费，建议提前了解云磁盘EBS的计费方式。<br /> <br /> 说明：该接口已过期，不建议继续使用，创建磁盘请使用新接口CreateDiskNew</p> </td> </tr> <tr> <td> <p>CreateDiskNew</p> </td> <td> <p>创建一块或多块付费的数据云磁盘。云磁盘的类型可通过ListAllEbsTypes接口查询。<br /> <br /> 创建云磁盘需要通过登陆认证获取令牌。<br /> 创建云磁盘会涉及到资源计费，建议提前了解云磁盘EBS的计费方式。</p> </td> </tr> <tr> <td> <p>DeleteDisk</p> </td> <td> <p>释放付费数据云磁盘。云磁盘的类型可通过ListAllEbsTypes接口查询。<br /> <br /> 释放云磁盘需要通过登陆认证获取令牌。<br /> 只有当云磁盘的状态为如下几种之一时，才能释放，否则抛出异常：<br /> 1. Available（可用）<br /> 2. CreateFailed（创建失败）<br /> 3. DestroyFailed（删除失败）<br /> 4. ToAttach（待挂载）<br /> 目前删除云磁盘会同步删除该云磁盘对应快照（包括手动快照和自动快照），可以通过设置needDeleteSnapshot=false来关闭该功能。<br /> 该接口是异步操作，接口调用成功返回信息后需要等待片刻才能完成。</p> </td> </tr> <tr> <td> <p>DetachDisk</p> </td> <td> <p>从云主机实例上卸载付费云磁盘。云磁盘的类型可通过ListAllEbsTypes接口查询。<br /> <br /> 卸载云磁盘需要通过登陆认证获取令牌。<br /> 使用该接口时，需要注意：<br /> 1. 云磁盘的EnableFlag属性必须是true;<br /> 2. 云磁盘必须已经挂载到云主机实例;<br /> 3. 云磁盘的状态必须为Available或者DestroyFailed;<br /> 4. 与磁盘的计费方式不能为 Monthly（按月付费）;<br /> 可以通过ListDisks接口查询云磁盘信息的上述信息。<br /> 该接口是异步操作，接口调用成功返回信息后需要等待片刻才能完成。</p> </td> </tr> <tr> <td> <p>GetDisk</p> </td> <td> <p>根据云磁盘Id获取云磁盘详细信息。</p> </td> </tr> <tr> <td> <p>ListAbleAttachInstance</p> </td> <td> <p>查询云磁盘可挂载的所有云主机实例。<br /> <br /> 该接口通常是在调用AttachDiskToInstance接口之前调用，用来保证云磁盘将要挂载的云主机类型状态的有效性。</p> </td> </tr> <tr> <td> <p>ListAbleRelateDisks</p> </td> <td> <p>查询出所有能被快照策略关联的云磁盘列表。<br /> <br /> 调用接口时，需要注意：<br /> 1. 该接口返回的数据为分页数据，默认情况下页码值为1，每页显示数据条数为10。</p> </td> </tr> <tr> <td> <p>ListAllEbsTypes</p> </td> <td> <p>查询云磁盘产品规格。</p> </td> </tr> <tr> <td> <p>ListDiskByPolicyId</p> </td> <td> <p>查询出关联同一快照策略的磁盘列表。<br /> <br /> 调用接口时，需要注意：<br /> 1. 只能查询如下状态的云磁盘信息：<br /> ToAttach：待挂载<br /> Attaching：挂载中<br /> Deteaching：卸载中<br /> Available：可用<br /> Destroying：删除中<br /> DestroyFailed：删除失败<br /> 2. 云磁盘所在的云主机的状态必须在如下状态中：<br /> Running：运行中<br /> Stopped：已关机<br /> Starting：启动中<br /> Stopping：关机中<br /> Destroying：删除中<br /> 3. 返回的数据为分页查询结果，默认情况下页码为1，每页显示10条数据。</p> </td> </tr> <tr> <td> <p>ListDisks</p> </td> <td> <p>查询云磁盘信息。<br /> <br /> 调用接口时，需要注意：<br /> 1. 接口采用分页查询的方式，默认页码为1，每页显示1000条数据。</p> </td> </tr> <tr> <td> <p>ListEbsTypes</p> </td> <td> <p>查询云磁盘产品规格。<br /> 门户中每种云磁盘类型都对应着相应的云磁盘产品规格，例如SSD型云硬盘对应的产品规格名称为ebs.s1。</p> </td> </tr> <tr> <td> <p>ModifyDiskAttribute</p> </td> <td> <p>修改云磁盘属性。<br /> <br /> 修改云磁盘的属性需要通过登陆认证获取令牌。</p> </td> </tr> <tr> <td> <p>ModifyEbsAttribute</p> </td> <td> <p>修改云磁盘的属性<br /> <br /> 修改云磁盘的属性需要通过登陆认证获取令牌。<br /> 通过获取的磁盘uuid查询到需要修改的磁盘在进行判断，区分数据盘和系统盘，并判断是否为本地盘否则将会抛出异常提醒。</p> </td> </tr> <tr> <td> <p>UpgradeDisk</p> </td> <td> <p>云磁盘扩容。<br /> <br /> 扩容云磁盘需要通过登陆认证获取令牌。<br /> 扩容云磁盘会涉及到资源计费，建议提前了解云磁盘EBS的计费方式。<br /> 调用该接口时，需要注意：<br /> 1. 只有数据盘（类型为DATADISK）才能扩容，系统盘（类型为ROOT）不能扩容;<br /> 2. 云磁盘的状态为 Available 或 Destroyfailed 才能扩容;<br /> 3. 云磁盘的操作状态为Normal时才能扩容;<br /> 4. 扩容后的磁盘容量不能小于原来磁盘容量;<br /> 5. 对于已到期的磁盘不能进行扩容;<br /> 6. 如果云磁盘计费方式是包年/包月，则要重新计算云磁盘开始时间、到期时间及周期 。</p> </td> </tr> </tbody> </table>