调用ModifyDiskSpec变配一块云盘,或者修改一块ESSD云盘的性能级别。

接口说明

请确保在使用该接口前,您已充分了解云盘的计费方式和价格

调用该接口完成以下操作时,您需要注意:

  • 修改ESSD云盘性能级别:
    • 包年包月ESSD云盘仅支持升级性能级别,按量付费ESSD云盘支持升级和降低性能级别。
    • ESSD云盘的状态必须是使用中(In_Use)状态或者待挂载(Available)状态。
    • 若ESSD云盘已挂载到ECS实例上,实例必须处于运行中(Running)状态或者已停止(Stopped)状态,ECS实例不能处于过期或者账号欠费状态。
    • 由于ESSD云盘性能级别受容量限制,如果您无法升级性能级别,可以扩容(ResizeDisk)后重新操作。更多详情,请参见ESSD云盘

调用接口后,新的云盘类型立即生效,阿里云按照新的云盘类型及云盘性能级别单价计算消费账单。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ModifyDiskSpec

系统规定参数。取值:ModifyDiskSpec

DiskId String d-bp131n0q38u3a4zi****

云盘的ID。

DiskCategory String cloud_ssd

变配一块云盘,即修改一块云盘的类型。取值范围:

  • cloud_essd:ESSD云盘
  • cloud_ssd:SSD云盘
  • cloud_efficiency:高效云盘

默认值:空,表示不变配云盘。

说明 以上有效取值按云盘性能降序排列。如果指定的云盘是包年包月云盘,则不允许降配云盘。
PerformanceLevel String PL2

修改一块ESSD云盘的性能级别。取值范围:

  • PL1(默认):单盘最高随机读写IOPS 5万。
  • PL2:单盘最高随机读写IOPS 10万。
  • PL3:单盘最高随机读写IOPS 100万。
DryRun Boolean false

是否只预检此次请求。取值范围:

  • true:发送检查请求。检查项包括是否填写了必需参数、请求格式、业务限制和ECS库存。如果检查不通过,则返回对应错误。如果检查通过,则返回错误码DryRunOperation
  • false(默认):发送正常请求,通过检查后返回2XX HTTP状态码并且直接变配云盘或修改ESSD性能等级。

返回数据

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

请求ID。

TaskId String t-bp67acfmxazb4p****

变配云盘的任务ID。

说明 如果您只修改了一块ESSD云盘的性能级别,则不会返回该参数。

示例

请求示例

https://ecs.aliyuncs.com/?Action=ModifyDiskSpec
&DiskId=d-bp131n0q38u3a4zi****
&PerformanceLevel=PL2
&<公共请求参数>

正常返回示例

XML 格式

<ModifyDiskSpecResponse>
      <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</ModifyDiskSpecResponse>

JSON 格式

{
	"RequestId":"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

错误码

HttpCode 错误码 错误信息 描述
404 InvalidDiskId.NotFound The specified disk does not exist. 指定的磁盘不存在。请您检查磁盘 ID 是否正确。
403 DiskInArrears The specified operation is denied as your disk owing fee. 指定的磁盘已欠费。
404 InvalidInstanceId.NotFound The specified InstanceId does not exist. 指定的实例不存在,请您检查实例ID是否正确。
403 InstanceExpiredOrInArrears The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode). 包年包月实例已过期,请您续费后再进行操作。
403 IncorrectDiskStatus The current disk status does not support this operation. 当前的磁盘不支持此操作,请您确认磁盘处于正常使用状态,是否欠费。
403 DiskCreatingSnapshot The operation is denied due to a snapshot of the specified disk is not completed yet. 指定的磁盘正在创建快照。
403 OperationDenied The type of the disk does not support the operation. 此磁盘种类不支持指定的操作。
400 InvalidPerformanceLevel.Malformed The specified parameter PerformanceLevel is not valid. 指定的参数“PerformanceLevel”无效。
403 OperationDenied.PerformanceLevelNotMatch The specified PerformanceLevel and disk size do not match. 指定的性能等级与磁盘大小不匹配。
400 InvalidDiskCategory.ValueNotSupported The specified parameter "DiskCategory" is not valid. 参数DiskCategory不合法。

访问错误中心查看更多错误码。