ResizeDisk

扩容一块数据盘。

描述

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

  • 该接口暂时仅支持扩容数据盘,不支持扩容系统盘。
  • 仅支持扩容磁盘类型为普通云盘(cloud)、高效云盘(cloud_efficiency)和 SSD 云盘(cloud_ssd)的数据盘。
  • 当磁盘正在创建快照时,不允许扩容。
  • 对于已挂载的数据盘:
    • 磁盘挂载的实例的状态必须为 运行中(Running)或者 已停止(Stopped)。
    • 扩容后,您需要在控制台 重启实例 或者调用 API RebootInstance 使操作生效。
  • 磁盘挂载的实例的状态必须为 运行中(Running)或者 已停止(Stopped)。
  • 扩容后,您需要在控制台 重启实例 或者调用 API RebootInstance 使操作生效。
  • 扩容时,不会修改磁盘分区和文件系统,您需要在扩容后自行分配存储空间。

调试

前往【API Explorer】在线调试,API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力,能显著降低使用云 API 的难度,强烈推荐使用。

请求参数

名称 类型 是否必选 示例值 描述
DiskId String d-diskid1

磁盘 ID。

NewSize Integer 2100

希望扩容到的磁盘容量大小。单位为 GiB。取值范围:

  • 普通云盘(Cloud):5~2000
  • 高效云盘(Cloud_efficiency):5~2000
  • SSD 云盘(Cloud_ssd):5~2000

指定的新磁盘容量必须比原磁盘容量大。且 2 TB 以下的磁盘不能扩容到 2 TB 以上。

Action String ResizeDisk

系统规定参数。取值:ResizeDisk

ClientToken String 123e4567-e89b-12d3-a456-426655440000

保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符,且不能超过 64 个字符。更多详情,请参阅 如何保证幂等性。

OwnerAccount String ECSforCloud@Alibaba.com

RAM 用户的账号登录名称。

Type String running

是否在线扩容磁盘。

返回参数

名称 类型 示例值 描述
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求 ID。

示例

请求示例


https://ecs.aliyuncs.com/?Action=ResizeDisk
&DiskId=d-diskid1
&NewSize=2100
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&<公共请求参数>

正常返回示例

XML 格式

<ResizeDiskResponse>
  <RequestId>F3CD6886-D8D0-4FEE-B93E-1B73239673DE</RequestId>
</ResizeDiskResponse>

JSON 格式

{
	"RequestId":"F3CD6886-D8D0-4FEE-B93E-1B73239673DE"
}

错误码

HttpCode 错误码 错误信息 描述
403 InvalidDataDiskSize.ValueNotSupported The specified DataDisk.n.Size beyond the permitted range, or the capacity of snapshot exceeds the size limit of the specified disk category. 指定的数据盘大小已超过最大允许值。
403 OperationDenied The type of the disk does not support the operation. 此磁盘种类不支持指定的操作。
403 OperationDenied The status of the disk or the instance that the disk is attaching with does not support the operation. 此磁盘或实例状态无法执行指定的操作。
403 InstanceExpiredOrInArrears The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode). 包年包月实例已过期,请您续费后再进行操作。
400 InvalidDataDiskCategory.ValueNotSupported %s 参数不支持。
400 InvalidParameter.Conflict %s 参数冲突。
400 InvalidDataDiskSize.ValueNotSupported %s 参数不支持。
403 InvalidDiskSize Specified new disk size is less than or equal the original disk size. 指定的新磁盘大小必须要小于或等于原始磁盘大小。
400 IncompleteParamter Some fields can not be null in this request. 请求中缺失参数。
403 InstanceLockedForSecurity The instance is locked due to security. 您的资源被安全锁定,拒绝操作。
403 InvalidDiskCategory.NotSupported The specified disk category is not supported. 该云盘类型不支持。

查看本产品错误码

发布者:佚, 佚名,转转请注明出处:https://www.cms2.cn/aliyun/1941.html

发表评论

邮箱地址不会被公开。 必填项已用*标注