調用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****變更到該云盤類型后才支持變配到目標規格），以及云盤類型在實例所屬可用區下的庫存情況。
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 | 否 | 是否支持跨集群升級實例規格。取值范圍：
默認值：false。 當參數 MigrateAcrossZone 取值為 true 時，一旦您根據返回信息升級了云服務器，請留意以下注意事項：
| true |
| DestinationResource | string | 是 | 待變更的實例資源類型。取值范圍：
| InstanceType |
| OperationType | string | 否 | 更改資源配置的操作類型。
默認值：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 |
返回參數
示例
正常返回示例
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 入參發生變更 | 查看變更詳情 |