Querying the Target Flavors to Which an ECS Flavor Can Be Changed¶
Function¶
An ECS flavor cannot be changed to certain flavors. This API is used to query the target flavors to which a specified ECS flavor can be changed.
URI¶
GET /v2.1/{project_id}/resize_flavors?instance_uuid={instance_uuid}&source_flavor_id={source_flavor_id}&source_flavor_name={source_flavor_name}&sort_key={sort_key}&sort_dir={sort_dir}&limit={limit}&marker={marker}
Table 1 describes the parameters in the URI.
Parameter | Mandatory | Description |
---|---|---|
project_id | Yes | Specifies the project ID. |
Note
One of the instance_uuid, source_flavor_id, and source_flavor_name parameters must be configured. If multiple parameters are configured, the system processes the instance_uuid, source_flavor_id, and source_flavor_name parameters in descending order by default.
Table 2 describes the request parameters.
Parameter | Mandatory | Type | Description |
---|---|---|---|
instance_uuid | No | String | Specifies the ID, in UUID format, of the target ECS. |
source_flavor_id | No | String | Specifies the source flavor ID. |
source_flavor_name | No | String | Specifies the source flavor name. |
sort_key | No | String | Indicates the field for sorting. Options:
|
sort_dir | No | String | Specifies the ascending or descending sorting. Options:
|
limit | No | Integer | Specifies the maximum number of flavors that can be displayed on one page. The default value is 1,000. |
marker | No | String | Uses the ID of the last flavor on one page as the paging marker. |
Request¶
None
Response¶
Table 3 describes the response parameters.
Parameter | Type | Description |
---|---|---|
id | String | Specifies the ECS flavor ID. |
name | String | Specifies the name of the ECS flavor. |
vcpus | Integer | Specifies the number of vCPUs in the ECS flavor. |
ram | Integer | Specifies the memory size (MB) in the ECS flavor. |
disk | Integer | Specifies the system disk size in the ECS flavor. This parameter has not been used. Its default value is 0. |
swap | String | Specifies the swap partition size required by the ECS flavor. This parameter has not been used. Its default value is "". |
OS-FLV-EXT-DATA:ephemeral | Integer | Specifies the temporary disk size. This is an extended attribute. This parameter has not been used. Its default value is 0. |
OS-FLV-DISABLED:disabled | Boolean | This is an extended attribute, specifying whether a flavor is available.
Note This parameter is not used. |
rxtx_factor | Float | This is an extended attribute. Note This parameter is not used. |
rxtx_quota | String | Specifies the software constraints of the network bandwidth that can be used by the ECS. This parameter has not been used. Its default value is null. |
rxtx_cap | String | Specifies the hardware constraints of the network bandwidth that can be used by the ECS. This parameter has not been used. Its default value is null. |
os-flavor-access:is_public | Boolean | Specifies whether a flavor is available to all tenants. This is an extended attribute.
Default value: true |
links | Array of objects | Specifies the shortcut link of the ECS flavor. For details, see Table 5. |
extra_specs | Array of objects | Specifies the extended field of the ECS specifications. For details, see Table 6. |
Parameter | Mandatory | Type | Description |
---|---|---|---|
rel | Yes | String | Specifies the shortcut link marker name. |
href | Yes | String | Specifies the shortcut link. |
type | Yes | String | Specifies the shortcut link type. This parameter has not been used. Its default value is null. |
Example Request¶
GET https://{endpoint}/v1/{project_id}/cloudservers/resize_flavors?source_flavor_id=c3.xlarge.2
Example Response¶
{
"flavors": [
{
"id": "c3.15xlarge.2",
"name": "c3.15xlarge.2",
"vcpus": "60",
"ram": 131072,
"disk": "0",
"swap": "",
"links": [
{
"rel": "self",
"href": "https://compute-ext.region.example.com/v1.0/743b4c0428d94531b9f2add666642e6b/flavors/c3.15xlarge.2",
"type": null
},
{
"rel": "bookmark",
"href": "https://compute-ext.region.example.com/743b4c0428d94531b9f2add666642e6b/flavors/c3.15xlarge.2",
"type": null
}
],
"OS-FLV-EXT-DATA:ephemeral": 0,
"rxtx_factor": 1,
"OS-FLV-DISABLED:disabled": false,
"rxtx_quota": null,
"rxtx_cap": null,
"os-flavor-access:is_public": true,
"extra_specs": {
"ecs:virtualization_env_types": "CloudCompute",
"ecs:generation": "c3",
"ecs:performancetype": "computingv3",
"resource_type": "IOoptimizedC3_2"
}
}
]
}
Returned Values¶
Error Codes¶
See Error Codes.