Creates a reserved node pool. A reserved node pool reserves a batch of active IP addresses from a vSwitch. It maps each IP address to a hostname based on a rule and maintains the resources for the node pool. When you use the reserved node pool to scale nodes, the corresponding resources are allocated or released.
Try it now
Test
RAM authorization
Request parameters
Parameter | Type | Required | Description | Example |
ClusterId | string | No | The ID of the cluster. | ehpc-hz-FYUr32**** |
Name | string | No | The name of the reserved node pool. | nodepool |
Description | string | No | The description of the reserved node pool. | test |
Count | integer | No | The number of reserved nodes. | 10 |
VSwitchId | string | No | The ID of the vSwitch. | vsw-bp1lfcjbfb099rrjn**** |
HostPrefix | string | No | The prefix of the hostnames for the reserved nodes. | cloud |
HostPostfix | string | No | The suffix of the hostnames for the reserved nodes. | ed |
Response elements
Element | Type | Description | Example |
object | The returned data. | ||
RequestId | string | The ID of the request. | 04F0F334-1335-436C-A1D7-6C044FE73368 |
ReservedNodePoolId | string | The ID of the reserved node pool. | rnp-cdx**** |
Examples
Success response
JSON format
{
"RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
"ReservedNodePoolId": "rnp-cdx****"
}Error codes
HTTP status code | Error code | Error message | Description |
400 | InvalidParams | The specified parameter %s is invalid. | The specified parameter %s is invalid. |
400 | InvalidVswitch | The vSwitch parameter is invalid, or the number of available IP addresses is insufficient. | The vSwitch parameter is invalid, or the number of available IP addresses is insufficient. |
400 | FailToGenId | Generating cluster ID failed. | Failed to generate the cluster ID. Please try again. |
404 | ClusterNotFound | The specified cluster does not exist. | The specified instance does not exist. |
503 | ServiceUnavailable | The request has failed due to a temporary failure of the server | The request has failed due to a temporary failure of the server. |
406 | DbError | A database service error occurred. | Database request failed. |
406 | VswitchOccupied | The vSwitch resource is occupied by other reserved nodepool. | This switch resource is occupied by other reserved node pools |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.