Creating an Elastic Resource Pool

Function

This API is used to create elastic resource pools.

URI

URI format
POST /v3/{project_id}/elastic-resource-pools

Parameter description

**Table 1** URI parameter
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID, which is used for resource isolation. For how to obtain the project ID, see Obtaining a Project ID.

Request Parameters

**Table 2** Request parameters
Parameter	Mandatory	Type	Description
elastic_resource_pool_name	Yes	String	Name of a new elastic resource pool. Only digits, letters, and underscores (_) are allowed, but the value cannot contain only digits or start with an underscore (_). The value can contain 1 to 128 characters. NOTE: If the name contains uppercase letters, the system automatically converts them to lowercase letters.
description	No	String	Description. The value can contain a maximum of 256 characters.
cidr_in_vpc	No	String	VPC CIDR associated with the virtual cluster. If it is not specified, the default value 172.16.0.0/12 is used.
max_cu	Yes	Integer	Maximum number of CUs. The value of this parameter must be greater than or equal to the sum of maximum CUs allowed for any queue in the resource pool, and greater than min_cu. Standard edition: The minimum value is 64 CUs. Basic edition: The minimum value is 16 CUs, and the maximum value is 64 CUs.
min_cu	Yes	Integer	Minimum number of CUs. The value of this parameter must be greater than or equal to the sum of the minimum CUs allowed for each queue in the resource pool. The minimum value is 64. Standard edition: The minimum value is 64 CUs. Basic edition: The minimum value is 16 CUs, and the maximum value is 64 CUs.
charging_mode	No	Integer	Billing mode. The default value is 1, which indicates the pay-per-use billing mode.
enterprise_project_id	No	String	Enterprise ID. If this parameter is left blank, the default value 0 is used.
tags	No	Array of objects	Queue tags for identifying cloud resources. A tag consists of a key and a value. For details, see Table 3.
label	No	Object	Attribute field of the elastic resource pool. To purchase the basic version, set this parameter to {"spec":"basic"}. If not set, the default is the standard version.
ipv6_enable	No	boolean	Whether to enable IPv6 Once enabled, the resource pool will be automatically assigned an IPv6 CIDR block. Custom IPv6 CIDR blocks are not currently supported. IPv6 cannot be disabled once enabled. The default value is false. true: IPv6 is enabled. false: IPv6 is disabled.

**Table 3** tags parameters
Parameter	Mandatory	Type	Description
key	Yes	String	Tag key
value	Yes	String	Tag value

Response Parameters

**Table 4** Response parameters
Parameter	Mandatory	Type	Description
is_success	No	Boolean	Whether the request is successfully executed. Value true indicates that the request is successfully executed.
message	No	String	Message content, for example, Success to get tsdb list.
elastic_resource_pool_name	No	String	Elastic resource pool name, for example, elastic_pool_0623_02".

Example Request

Create an elastic resource pool with maximum CUs of 684 and minimum CUs of 684.

{
  "elastic_resource_pool_name" : "elastic_pool_0623_02",
  "description" : "test",
  "cidr_in_vpc" : "172.16.0.0/14",
  "charging_mode" : "1",
  "max_cu" : 684,
  "min_cu" : 684
}

Example Response

{
  "is_success" : true,
  "message" : "Success to get tsdb list",
  "elastic_resource_pool_name" : "elastic_pool_0623_02"
}

Status Codes

Status Code	Description
200	OK
400	Incorrect parameters. For example, creating an existing elastic resource pool.
403	Forbidden

Error Codes

If an error occurs when this API is invoked, the system does not return the result similar to the preceding example, but returns the error code and error information. For details, see Error Codes.

Parent topic: APIs Related to Elastic Resource Pools

Previous topic: APIs Related to Elastic Resource Pools

Next topic: Querying All Elastic Resource Pools