DescribeResourcesModification - 变更实例规格或系统盘类型之前，查询某一可用区下实例规格或系统盘的库存情况 - 云服务器 ECS

调用DescribeResourcesModification变更实例规格或系统盘类型之前，查询某一可用区下实例规格或系统盘的库存情况。

接口说明

常见变更场景示例如下：

示例 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
&公共请求参数

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
ecs:DescribeResourcesModification	get	*Instance `acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}`	无	无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	待变更实例所属的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。	cn-hangzhou
ResourceId	string	是	待变更规格或系统盘类型的实例 ID（InstanceId）。	i-bp67acfmxazb4p****
MigrateAcrossZone	boolean	否	是否支持跨集群升级实例规格。取值范围： true：支持。 false：不支持。默认值：false。当参数 MigrateAcrossZone 取值为 true 时，一旦您根据返回信息升级了云服务器，请留意以下注意事项：经典网络类型实例：对于已停售的实例规格，非 I/O 优化实例变配到 I/O 优化实例时，实例私网 IP 地址、云盘设备名和软件授权码会发生变化。对于 Linux 实例，普通云盘（cloud）会被识别为 xvda 或者 xvdb 等，高效云盘（cloud_efficiency）和 SSD 云盘（cloud_ssd）会被识别为 vda 或者 vdb 等。对于正常售卖的实例规格族，实例的私网 IP 地址会发生变化。专有网络 VPC 类型实例：对于已停售的实例规格，非 I/O 优化实例变配到 I/O 优化实例时，云服务器云盘设备名和软件授权码会发生变化。Linux 实例的普通云盘（cloud）会被识别为 xvda 或者 xvdb 等，高效云盘（cloud_efficiency）和 SSD 云盘（cloud_ssd）会被识别为 vda 或者 vdb 等。	true
DestinationResource	string	是	待变更的实例资源类型。取值范围： InstanceType：实例规格。 SystemDisk：系统盘类型。取值为 SystemDisk 时，必须同时指定 InstanceType 参数。表示目标规格要求的云盘类型。	InstanceType
OperationType	string	否	更改资源配置的操作类型。包年包月资源的取值范围： Upgrade：升级资源。 Downgrade：降级资源。 RenewDowngrade：续费降配。 RenewModify：过期实例的续费变配。按量付费资源的取值：Upgrade。默认值：Upgrade。	Upgrade
InstanceType	string	否	目标实例规格。更多信息，请参见实例规格族，也可以调用 DescribeInstanceTypes 接口获得最新的规格表。当参数 DestinationResource 取值为 SystemDisk 时，必须同时指定 InstanceType 参数。表示目标规格要求的云盘类型。	ecs.g7.large
Cores	integer	否	目标实例规格的 vCPU 内核数目。取值请参见实例规格族。仅当 DestinationResource=InstanceType 参数有效，Cores 为有效参数。	2
Memory	float	否	目标实例规格的内存大小，单位为 GiB。取值请参见实例规格族。仅当 DestinationResource=InstanceType，Memory 才为有效参数。	8.0
ZoneId	string	否	目标可用区 ID。当需要跨可用区变更实例规格时，需要指定该参数。	cn-hangzhou-e
Conditions	array	否	条件列表。
	string	否	目前仅支持 DiskCategory，表示查询当前实例变更云盘类型后支持变配到的规格。仅当 DestinationResource=InstanceType，Conditions 为有效参数。	DiskCategory

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
AvailableZones	array<object>	数据中心信息 AvailableZone 组成的集合。
AvailableZone	object
ZoneId	string	可用区 ID。	cn-hangzhou-e
Status	string	资源状态。可能值： Available：资源充足。 SoldOut：资源已售罄。	Available
StatusCategory	string	根据库存详细分类资源类别。可能值： WithStock：库存充足。 ClosedWithStock：库存接近水位低线。 WithoutStock：库存告罄。	WithStock
RegionId	string	地域 ID。	cn-hangzhou
AvailableResources	array<object>	可供创建的具体资源组成的数组。
AvailableResource	object
Type	string	资源类型。可能值： InstanceType：实例规格。 SystemDisk：系统盘类型。	InstanceType
SupportedResources	array<object>	支持的可供创建的具体资源组成的数组。
SupportedResource	object
Status	string	资源状态。可能值： Available：资源充足。 SoldOut：资源已售罄。	Available
Value	string	资源值。	ecs.g7.large
Max	integer	云盘容量范围的最大值。仅当入参 DestinationResource 取值为 SystemDisk 时该参数才生效。	2048
Unit	string	云盘容量的单位。仅当入参 DestinationResource 取值为 SystemDisk 时该参数才生效。	GiB
StatusCategory	string	根据库存详细分类资源类别。可能值： WithStock：库存充足。 ClosedWithStock：库存接近水位低线。 WithoutStock：库存告罄。	WithStock
Min	integer	云盘容量范围的最小值。仅当入参 DestinationResource 取值为 SystemDisk 时该参数才生效。	20
ConditionSupportedResources	array<object>	有条件支持的可供创建的具体资源列表。满足条件后，可以将当前资源变更到列表中的资源。
ConditionSupportedResource	object	有条件支持的可供创建的具体资源列表。满足条件后，可以将当前资源变更到列表中的资源。
Conditions	array<object>	条件列表。
Condition	object	条件列表。
Key	string	条件名。目前可选值： DiskCategory：盘类型不满足。	DiskCategory
Status	string	资源的库存状态。可能值： Available：资源充足。 SoldOut：资源已售罄。	Available
Value	string	资源值。	ecs.g5.large
Max	integer	云盘容量范围的最大值。仅当入参 DestinationResource 取值为 SystemDisk 时该参数才生效。	2048
Unit	string	云盘容量的单位。仅当入参 DestinationResource 取值为 SystemDisk 时该参数才生效。	GiB
StatusCategory	string	根据库存详细分类资源类别。可能值： WithStock：库存充足。 ClosedWithStock：库存接近水位低线。 WithoutStock：库存告罄。	WithStock
Min	integer	云盘容量范围的最小值。仅当入参 DestinationResource 取值为 SystemDisk 时该参数才生效。	20

示例

正常返回示例

JSON格式

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "AvailableZones": {
    "AvailableZone": [
      {
        "ZoneId": "cn-hangzhou-e",
        "Status": "Available",
        "StatusCategory": "WithStock",
        "RegionId": "cn-hangzhou",
        "AvailableResources": {
          "AvailableResource": [
            {
              "Type": "InstanceType",
              "SupportedResources": {
                "SupportedResource": [
                  {
                    "Status": "Available",
                    "Value": "ecs.g7.large",
                    "Max": 2048,
                    "Unit": "GiB",
                    "StatusCategory": "WithStock",
                    "Min": 20
                  }
                ]
              },
              "ConditionSupportedResources": {
                "ConditionSupportedResource": [
                  {
                    "Conditions": {
                      "Condition": [
                        {
                          "Key": "DiskCategory"
                        }
                      ]
                    },
                    "Status": "Available",
                    "Value": "ecs.g5.large",
                    "Max": 2048,
                    "Unit": "GiB",
                    "StatusCategory": "WithStock",
                    "Min": 20
                  }
                ]
              }
            }
          ]
        }
      }
    ]
  }
}

错误码

HTTP status code	错误码	错误信息	描述
400	Invalid.OperationType	The specified operationType is not valid.	指定的参数 operationType 无效。
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.	指定的参数 InstanceChargeType 无效。
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.	提供的RegionId不存在
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.	指定的参数 IoOptimized 无效。
404	Invalid.NetworkCategory	The specified NetworkCategory is not valid.	指定的参数 NetworkCategory 无效。
404	Invalid.SpotStrategy	The specified SpotStrategy is not valid.	竞价策略参数无效。
404	Invalid.ResourceId	The specified ResourceId is not valid.	指定的参数 ResourceId 无效。
404	Invalid.InstancePayType	The specified InstancePayType is not valid.	指定的参数 InstanceChargeType 无效。
404	Invalid.OperationType	The specified OperationType is not valid.	指定的参数 operationType 无效。
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	OpenAPI 错误码发生变更、OpenAPI 入参发生变更、OpenAPI 返回结构发生变更	查看变更详情
2022-09-14	OpenAPI 错误码发生变更、OpenAPI 入参发生变更	查看变更详情
2022-09-14	OpenAPI 错误码发生变更、OpenAPI 入参发生变更	查看变更详情