DescribeResourcesModification_云服务器 ECS_API文档-阿里云OpenAPI开发者门户

接口说明

常见变更场景示例如下：

示例 1：查询当前实例支持变配的规格

查询实例 i-bp67acfmxazb4p****支持变配到的规格，以及相应规格在实例所属可用区下的库存情况。

http(s)://ecs.aliyuncs.com/?Action=DescribeResourcesModification
&RegionId=cn-hangzhou
&ResourceId=i-bp67acfmxazb4p****
&DestinationResource=InstanceType
&OperationType=Upgrade
&公共请求参数

示例 2：查询当前实例变更云盘类型后支持变配到的规格

查询实例 i-bp67acfmxazb4p****变更云盘类型后，可以变配到的规格，以及相应规格在实例所属可用区下的库存情况。

http(s)://ecs.aliyuncs.com/?Action=DescribeResourcesModification
&RegionId=cn-hangzhou
&ResourceId=i-bp67acfmxazb4p****
&DestinationResource=InstanceType
&OperationType=Upgrade
&Conditions.0=DiskCategory
&公共请求参数

示例 3：查询目标规格要求的云盘类型

查询目标规格（例如 ecs.g7.large）要求的云盘类型（即当前实例 i-bp67acfmxazb4p****变更到该云盘类型后才支持变配到目标规格），以及云盘类型在实例所属可用区下的库存情况。

说明目标规格需通过示例 2 查询。

http(s)://ecs.aliyuncs.com/?Action=DescribeResourcesModification
&RegionId=cn-hangzhou
&ResourceId=i-bp67acfmxazb4p****
&DestinationResource=SystemDisk
&OperationType=Upgrade
&InstanceType=ecs.g7.large
&公共请求参数

流控信息

请求速率为500/60(s)。

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

ecs:DescribeResourcesModification	Get	Instance acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}	无	无

请求参数

字段名称	字段详情
RegionIdstring	待变更实例所属的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。示例值:cn-hangzhou参考取值来源: DescribeRegions
ResourceIdstring	待变更规格或系统盘类型的实例 ID（InstanceId）。示例值:i-bp67acfmxazb4p****参考取值来源: TagResources ListTagResources
MigrateAcrossZoneboolean	是否支持跨集群升级实例规格。取值范围：展开详情示例值:true
DestinationResourcestring	待变更的实例资源类型。取值范围：展开详情示例值:InstanceType
OperationTypestring	更改资源配置的操作类型。展开详情示例值:Upgrade
InstanceTypestring	目标实例规格。更多信息，请参见实例规格族，也可以调用 DescribeInstanceTypes 接口获得最新的规格表。展开详情示例值:ecs.g7.large参考取值来源: DescribeInstanceTypes CreateInstance
Coresinteger<int32>	目标实例规格的 vCPU 内核数目。取值请参见实例规格族。展开详情示例值:2
Memorynumber<float>	目标实例规格的内存大小，单位为 GiB。取值请参见实例规格族。展开详情示例值:8.0
ZoneIdstring	目标可用区 ID。展开详情示例值:cn-hangzhou-e参考取值来源: DescribeZones
Conditionsarray<string>	条件列表。子级条数 <= 10

返回参数

字段名称	字段详情
RequestIdstring	请求 ID。示例值:473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
AvailableZonesobject

返回示例

错误码

没有我想要的错误码, 点击反馈

全局错误码

HTTP 状态码	错误码	错误信息	操作

400	Invalid.OperationType	The specified operationType is not valid.	诊断
400	Invalid.Param	The input parameter DestinationResource that is mandatory for processing this request is not supplied.	诊断
400	Invalid.InstanceChargeType	The specified InstanceChargeType is not valid.	诊断
400	InvalidCondition.Malformed	The specified Condition is not valid.	诊断
403	InvalidDedicatedHostId.NotFound	The specified DedicatedHostId does not exist in our records.	诊断
403	InvalidParam.TypeAndCpuMem.Conflict	The specified 'InstanceType' and 'Cores','Memory' are not blank at the same time.	诊断
403	InvalidParam.Cores	The specified parameter 'Cores' should be empty.	诊断
403	InvalidParam.Memory	The specified parameter 'Memory' should be empty.	诊断
403	InvalidParameter.ResourceOwnerId	The specified parameter ResourceOwnerId is not available anymore.	诊断
404	Invalid.RegionId	The specified RegionId does not exist.	诊断
404	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.	诊断
404	Unavailable.Regions	The available regions does not exists.	诊断
404	Invalid.ResourceType	The ResourceType provided does not exist in our records.	诊断
404	Invalid.DestinationResource	The specified DestinationResource is not valid.	诊断
404	Invalid.IoOptimized	The specified IoOptimized is not valid.	诊断
404	Invalid.NetworkCategory	The specified NetworkCategory is not valid.	诊断
404	Invalid.SpotStrategy	The specified SpotStrategy is not valid.	诊断
404	Invalid.ResourceId	The specified ResourceId is not valid.	诊断
404	Invalid.InstancePayType	The specified InstancePayType is not valid.	诊断
404	Invalid.OperationType	The specified OperationType is not valid.	诊断
404	OperationDenied	The specified operation is denied as this instanceType is not support.	诊断
404	InvalidInstanceId.NotFound	The specified InstanceId provided does not exist in our records.	诊断
404	InvalidResourceId.NotFound	The specified ResourceId is not found in our records.	诊断

变更历史

	变更时间	变更内容概要	操作
	2023-04-14	变更错误码400 新增请求参数Conditions 变更返回参数
	2022-09-14	变更错误码403 变更错误码404 新增请求参数ZoneId