调用ModifyDiskSpec变更一块云盘类型，或者修改一块ESSD云盘的性能级别。
接口说明
请确保在使用该接口前，您已充分了解云盘的计费方式和价格。
调用该接口完成以下操作时，您需要注意：
- 修改ESSD云盘性能级别：
- 包年包月ESSD云盘仅支持升级性能级别。
- 按量付费ESSD云盘支持升级和降低性能级别，但不支持降配到PL0。
- 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。 |
| PerformanceLevel | String | 否 | PL2 |
修改一块ESSD云盘的性能级别。取值范围：
默认值：PL1。 |
| DiskCategory | String | 否 | cloud_essd |
变更一块云盘的类型。取值范围：
默认值：空，表示不变配云盘。 说明
|
| DryRun | Boolean | 否 | false |
是否只预检此次请求。取值范围：
默认值：false。 |
| ProvisionedIops | Long | 否 | 50000 |
是否修改ESSD AutoPL云盘预配置读写IOPS。取值范围：0~min{50000, 1000*容量-基准性能}。 基准性能=min{1,800+50*容量, 50,000} 说明 当DiskCategory取值为cloud_auto时才支持设置该参数。更多信息，请参见ESSD AutoPL云盘和修改ESSD AutoPL云盘预配置信息。 |
| PerformanceControlOptions.IOPS | Integer | 否 | 2000 | 目标云盘IOPS。仅支持修改专属存储集群云盘IOPS。 取值范围：900~单盘最大IOPS，步长100。 更多信息，请参见云盘性能。 |
| PerformanceControlOptions.Throughput | Integer | 否 | 200 |
目标云盘吞吐量，仅支持修改专属存储集群云盘吞吐量，单位MB/s。 取值范围：60~单盘最大吞吐量。 更多信息，请参见云盘性能。 |
| PerformanceControlOptions.Recover | String | 否 | All |
重置云盘性能，仅支持专属存储集群云盘。 设置该参数后，PerformanceControlOptions.IOPS和PerformanceControlOptions.Throughput参数不生效。 目前仅支持设置为All（重置云盘IOPS和吞吐量到初始值）。 |
返回数据
|
名称 |
类型 |
示例值 |
描述 |
| RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
请求ID。 |
| TaskId | String | t-bp67acfmxazb4p**** |
变配云盘的任务ID。 说明 如果您只修改了一块ESSD云盘的性能级别，则不会返回该参数。 |
| OrderId | String | 20413515388**** | 生成的订单ID。 说明 仅在变更或修改包年包月云盘时会返回订单ID。 |
示例
请求示例
http(s)://ecs.aliyuncs.com/?Action=ModifyDiskSpec
&ResourceOwnerId=123
&DiskId=d-bp131n0q38u3a4zi****
&PerformanceLevel=PL2
&DiskCategory=cloud_essd
&DryRun=false
&ProvisionedIops=50000
&公共请求参数正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
t-bp67acfmxazb4p****
5B38289D-88AB-42BD-B021-12FC6942F099
20413515388****
JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"TaskId" : "t-bp67acfmxazb4p****",
"RequestId" : "5B38289D-88AB-42BD-B021-12FC6942F099",
"OrderId" : "20413515388****"
}错误码
|
HttpCode |
错误码 |
错误信息 |
描述 |
| 400 | InvalidPerformanceLevel.Malformed | The specified parameter PerformanceLevel is not valid. | 指定的参数 PerformanceLevel 无效。 |
| 400 | ProvisionedIopsForDiskCategoryUnsupported | The specified disk category does not support provisioned iops. | 指定的磁盘类型不支持预配置IOPS。 |
| 400 | QuotaExceed.DiskCapacity | The used capacity of disk type has exceeded the quota in the zone, %s. | 指定磁盘类型的已用容量超出可用区配额限制，您可以前往配额中心查询和申请提升磁盘容量配额。 |
| 400 | MalformedParameter.PerformanceControlOptions | Parameter invalid, %s. | 参数不合法 |
| 400 | InvalidPerformanceControlOptions.ModifyOperationUnsupported | The specified performance control options are conflicts with disk category or performance level or ProvisionIOPS. | 磁盘性能控制参数与磁盘类型、磁盘性能等级、预配置IOPS参数冲突。 |
| 400 | InvalidOperation.InstanceRenewWithDowngradeInPlan | The operation is denied due to the specified instance has renew with downgrade record in plan. | 存在未生效的续费降配订单。订单生效前不允许此操作。 |
| 403 | DiskInArrears | The specified operation is denied as your disk owing fee. | 指定的磁盘已欠费。 |
| 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. | 此磁盘种类不支持指定的操作。 |
| 403 | OperationDenied.PerformanceLevelNotMatch | The specified PerformanceLevel and disk size do not match. | 指定的性能等级与磁盘大小不匹配。 |
| 403 | InvalidInstanceType.NotSupportDiskCategory | The instanceType of the specified instance does not support this disk category. | 指定的实例规格（InstanceType）不支持当前实例的云盘类别。请尝试更换其它实例规格。关于实例规格支持的云盘类型，请参见实例规格族文档。 |
| 403 | ModifyingDiskCategoryLimitExceed | The amount of modifying disk category exceeds the limit. | 当前地域正在变配的磁盘个数超过上限 |
| 403 | DiskInCoolingPeriod | There is a cooling period after the disk is successfully modified. | 云盘处于变配周期限制中，不可再次发起变配 |
| 403 | NoChangeInDiskCategoryAndPerformanceLevel | There is no change between the parameters transmitted and the current. | 您所传的磁盘种类和性能等级与当前磁盘一致 |
| 403 | OperationDenied.NoStock | The requested resource is sold out in the specified zone; try other types of resources or other regions and zones. | 请求的资源在指定的可用区已售完，请您更换实例规格或者可用区重试，调用 DescribeZones 接口可以获得库存结果。 |
| 403 | InvalidOperation.MultiAttachDisk | Multi attach disk does not support this operation. | 开启多重挂载特性的云盘不支持该操作。 |
| 403 | InvalidDiskCategory.NotSupported | The specified disk category is not supported. | 指定的云盘类型不支持当前操作。 |
| 403 | InvalidPerformanceParameter.DiskNotInDedicatedStorageCluster | The specified disk not in dedicated storage cluster, can not modify performance control options. | 非专属存储集群磁盘不支持修改磁盘性能控制参数。 |
| 403 | InvalidStatus.DiskUnderPerformanceControl | The specified disk is under performance control, any modifications to the category or performance level of the specified disk are unsupported.. | 磁盘处于性能控制状态，无法进行磁盘类型、性能等级变更。 |
| 403 | InvalidStatus.DiskNotReady | This specified disk is not ready, status needs to be either In_use or Available. | 指定磁盘的状态必须是In_use或Available。 |
| 404 | InvalidDiskId.NotFound | The specified disk does not exist. | 指定的磁盘不存在。请您检查磁盘 ID 是否正确。 |
| 404 | InvalidInstanceId.NotFound | The specified InstanceId does not exist. | 指定的实例不存在，请您检查实例ID是否正确。 |
| 500 | InternalError | The request processing has failed due to some unknown error, exception or failure. | 内部错误，请重试。 |
访问错误中心查看更多错误码。
腾讯云1折，限时活动，即将结束： 马上收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠
转转请注明出处：https://www.yunxiaoer.com/150905.html