vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/dli/api-ref/dli_02_0326.html
Su, Xiaomeng 483e5cc6cc dli_api_20240430 
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com>
Co-authored-by: Su, Xiaomeng <suxiaomeng1@huawei.com>
Co-committed-by: Su, Xiaomeng <suxiaomeng1@huawei.com>
2024-05-15 12:04:03 +00:00

251 lines
19 KiB
HTML
Raw Blame History

<a name="dli_02_0326"></a><a name="dli_02_0326"></a>
<h1 class="topictitle1">Creating an Elastic Resource Pool</h1>
<div id="body0000001205932049"><div class="section" id="dli_02_0326__section15426154210155"><h4 class="sectiontitle">Function</h4><p id="dli_02_0326__p1152691515171">This API is used to create elastic resource pools.</p>
</div>
<div class="section" id="dli_02_0326__section13427194271519"><h4 class="sectiontitle">URI</h4><ul id="dli_02_0326__ul348535565519"><li id="dli_02_0326__li448565565516">URI format<p id="dli_02_0326__p6340131616569"><a name="dli_02_0326__li448565565516"></a><a name="li448565565516"></a>POST /v3/{project_id}/elastic-resource-pools</p>
</li><li id="dli_02_0326__li15501677565">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0326__table6428194212151" frame="border" border="1" rules="all"><caption><b>Table 1 </b>URI parameter</caption><thead align="left"><tr id="dli_02_0326__row1442819420151"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.2.2.1.2.5.1.1"><p id="dli_02_0326__p1142814231514">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.2.2.1.2.5.1.2"><p id="dli_02_0326__p1742920425155">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.2.2.1.2.5.1.3"><p id="dli_02_0326__p34291642141511">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.2.2.2.1.2.5.1.4"><p id="dli_02_0326__p174291242141512">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dli_02_0326__row1142864215159"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.2.2.1.2.5.1.1 "><p id="dli_02_0326__p18430154261515">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.2.2.1.2.5.1.2 "><p id="dli_02_0326__p943020422154">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.2.2.1.2.5.1.3 "><p id="dli_02_0326__p15431114214156">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.2.2.1.2.5.1.4 "><p id="dli_02_0326__p5431154241517">Project ID, which is used for resource isolation. For details about how to obtain its value, see <a href="dli_02_0183.html">Obtaining a Project ID</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
<div class="section" id="dli_02_0326__section13431134218156"><h4 class="sectiontitle">Request</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0326__request_CREATE_ELASTIC_RESOURCE_POOLReq" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request parameters</caption><thead align="left"><tr id="dli_02_0326__row164351542131519"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.1"><p id="dli_02_0326__p144361242201515">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.2"><p id="dli_02_0326__p64376426152">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.3"><p id="dli_02_0326__p19437104212158">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.2.2.5.1.4"><p id="dli_02_0326__p7437104216150">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dli_02_0326__row343564219155"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0326__p343834281516">elastic_resource_pool_name</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0326__p94388429153">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0326__p943854201517">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0326__p84395426152">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.</p>
<div class="note" id="dli_02_0326__note278044811414"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="dli_02_0326__p27811448174119">If the name contains uppercase letters, the system automatically converts them to lowercase letters.</p>
</div></div>
</td>
</tr>
<tr id="dli_02_0326__row114361842181519"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0326__p143944219157">description</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0326__p1244074241519">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0326__p1644034213155">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0326__p844016427156">Description. The value can contain a maximum of 256 characters.</p>
</td>
</tr>
<tr id="dli_02_0326__row1443604213158"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0326__p1944144291520">cidr_in_vpc</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0326__p944114271519">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0326__p644174215151">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0326__p1144216429158">VPC CIDR associated with the virtual cluster. If it is not specified, the default value <strong id="dli_02_0326__b583710174451">172.16.0.0/12</strong> is used.</p>
</td>
</tr>
<tr id="dli_02_0326__row164361642131513"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0326__p1644211426156">max_cu</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0326__p11442124214150">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0326__p144436425159">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0326__p544304271510">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 <strong id="dli_02_0326__b849774015456">min_cu</strong>. The minimum value is <strong id="dli_02_0326__b1587104812452">64</strong>.</p>
</td>
</tr>
<tr id="dli_02_0326__row843674281518"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0326__p74440421152">min_cu</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0326__p94443423150">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0326__p04446428158">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0326__p1244516426156">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 <strong id="dli_02_0326__b7535105017111">64</strong>.</p>
</td>
</tr>
<tr id="dli_02_0326__row02987116158"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0326__p829831113154">charging_mode</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0326__p2298191151511">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0326__p12298171131510">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0326__p936084073019">Billing mode. The default value is <strong id="dli_02_0326__b1228152862615">1</strong>, which indicates the pay-per-use billing mode.</p>
</td>
</tr>
<tr id="dli_02_0326__row77691358111616"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0326__p167691958191619">enterprise_project_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0326__p87690584169">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0326__p9769115819160">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0326__p1376925810168">Enterprise ID. If this parameter is left blank, the default value <strong id="dli_02_0326__b1010317315132">0</strong> is used.</p>
</td>
</tr>
<tr id="dli_02_0326__row1768422292013"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0326__p135102615814">tags</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0326__p251011605810">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0326__p451066135816">Array of objects</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0326__p55101469587">Queue tags for identifying cloud resources. A tag consists of a key and a value. For details, see <a href="#dli_02_0326__table9391124139">Table 3</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="dli_02_0326__table9391124139"></a><a name="table9391124139"></a><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0326__table9391124139" frame="border" border="1" rules="all"><caption><b>Table 3 </b>tags parameters</caption><thead align="left"><tr id="dli_02_0326__row1440020130"><th align="left" class="cellrowborder" valign="top" width="14.899999999999999%" id="mcps1.3.3.3.2.5.1.1"><p id="dli_02_0326__p194012219139">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="10.83%" id="mcps1.3.3.3.2.5.1.2"><p id="dli_02_0326__p540724136">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="16.470000000000002%" id="mcps1.3.3.3.2.5.1.3"><p id="dli_02_0326__p840162161315">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="57.8%" id="mcps1.3.3.3.2.5.1.4"><p id="dli_02_0326__p16401271318">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dli_02_0326__row194013231317"><td class="cellrowborder" valign="top" width="14.899999999999999%" headers="mcps1.3.3.3.2.5.1.1 "><p id="dli_02_0326__p13401329138">key</p>
</td>
<td class="cellrowborder" valign="top" width="10.83%" headers="mcps1.3.3.3.2.5.1.2 "><p id="dli_02_0326__p940102141313">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="16.470000000000002%" headers="mcps1.3.3.3.2.5.1.3 "><p id="dli_02_0326__p64019231317">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.8%" headers="mcps1.3.3.3.2.5.1.4 "><p id="dli_02_0326__p5401021139">Tag key</p>
<div class="note" id="dli_02_0326__note18297733501"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="dli_02_0326__p1448010306508">A tag key can contain a maximum of 128 characters. Only letters, digits, spaces, and special characters (_.:=+-@) are allowed, but the key cannot start or end with a space or start with <strong id="dli_02_0326__b5450813161519">_sys_</strong>.</p>
<p id="dli_02_0326__p229753310016"></p>
</div></div>
</td>
</tr>
<tr id="dli_02_0326__row1141142181320"><td class="cellrowborder" valign="top" width="14.899999999999999%" headers="mcps1.3.3.3.2.5.1.1 "><p id="dli_02_0326__p164118215134">value</p>
</td>
<td class="cellrowborder" valign="top" width="10.83%" headers="mcps1.3.3.3.2.5.1.2 "><p id="dli_02_0326__p1141112181317">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="16.470000000000002%" headers="mcps1.3.3.3.2.5.1.3 "><p id="dli_02_0326__p174114281318">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.8%" headers="mcps1.3.3.3.2.5.1.4 "><p id="dli_02_0326__p16411125137">Tag value</p>
<div class="note" id="dli_02_0326__note13888185617019"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="dli_02_0326__p388865616014">A tag value can contain a maximum of 255 characters. Only letters, digits, spaces, and special characters (_.:=+-@) are allowed. The value cannot start or end with a space.</p>
</div></div>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="dli_02_0326__section2445184212152"><h4 class="sectiontitle">Response</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0326__response_CREATE_ELASTIC_RESOURCE_POOLResp" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Response parameters</caption><thead align="left"><tr id="dli_02_0326__row4446134271517"><th align="left" class="cellrowborder" valign="top" width="18.4981501849815%" id="mcps1.3.4.2.2.5.1.1"><p id="dli_02_0326__p1447742201520">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="7.519248075192481%" id="mcps1.3.4.2.2.5.1.2"><p id="dli_02_0326__p246453513241">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="18.4981501849815%" id="mcps1.3.4.2.2.5.1.3"><p id="dli_02_0326__p744744251511">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="55.48445155484452%" id="mcps1.3.4.2.2.5.1.4"><p id="dli_02_0326__p9447342141515">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dli_02_0326__row17446174218156"><td class="cellrowborder" valign="top" width="18.4981501849815%" headers="mcps1.3.4.2.2.5.1.1 "><p id="dli_02_0326__p144481942171518">is_success</p>
</td>
<td class="cellrowborder" valign="top" width="7.519248075192481%" headers="mcps1.3.4.2.2.5.1.2 "><p id="dli_02_0326__p11464163592413">No</p>
</td>
<td class="cellrowborder" valign="top" width="18.4981501849815%" headers="mcps1.3.4.2.2.5.1.3 "><p id="dli_02_0326__p8448124281512">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="55.48445155484452%" headers="mcps1.3.4.2.2.5.1.4 "><p id="dli_02_0326__p109711817125720">Whether the request is successfully executed. Value <span class="parmvalue" id="dli_02_0326__parmvalue955623913419"><b>true</b></span> indicates that the request is successfully executed.</p>
</td>
</tr>
<tr id="dli_02_0326__row944624212157"><td class="cellrowborder" valign="top" width="18.4981501849815%" headers="mcps1.3.4.2.2.5.1.1 "><p id="dli_02_0326__p144491842111510">message</p>
</td>
<td class="cellrowborder" valign="top" width="7.519248075192481%" headers="mcps1.3.4.2.2.5.1.2 "><p id="dli_02_0326__p1646433542413">No</p>
</td>
<td class="cellrowborder" valign="top" width="18.4981501849815%" headers="mcps1.3.4.2.2.5.1.3 "><p id="dli_02_0326__p1544984281513">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.48445155484452%" headers="mcps1.3.4.2.2.5.1.4 "><p id="dli_02_0326__p1162144612211">Message content, for example, <strong id="dli_02_0326__b2403143715351">Success to get tsdb list</strong>.</p>
</td>
</tr>
<tr id="dli_02_0326__row14466421156"><td class="cellrowborder" valign="top" width="18.4981501849815%" headers="mcps1.3.4.2.2.5.1.1 "><p id="dli_02_0326__p5450742191516">elastic_resource_pool_name</p>
</td>
<td class="cellrowborder" valign="top" width="7.519248075192481%" headers="mcps1.3.4.2.2.5.1.2 "><p id="dli_02_0326__p546418356249">No</p>
</td>
<td class="cellrowborder" valign="top" width="18.4981501849815%" headers="mcps1.3.4.2.2.5.1.3 "><p id="dli_02_0326__p44501842121512">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.48445155484452%" headers="mcps1.3.4.2.2.5.1.4 "><p id="dli_02_0326__p124511042141513">Elastic resource pool name, for example, <strong id="dli_02_0326__b44105613711">elastic_pool_0623_02"</strong>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="dli_02_0326__section14769144211244"><h4 class="sectiontitle">Example Request</h4><p id="dli_02_0326__p59201671507">Create an elastic resource pool with maximum CUs of 684 and minimum CUs of 684.</p>
<pre class="screen" id="dli_02_0326__screen12372049928">{
"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
}</pre>
</div>
<div class="section" id="dli_02_0326__section8528115415245"><h4 class="sectiontitle">Example Response</h4><pre class="screen" id="dli_02_0326__screen11988113111615">{
"is_success" : true,
"message" : "Success to get tsdb list",
"elastic_resource_pool_name" : "elastic_pool_0623_02"
}</pre>
</div>
<div class="section" id="dli_02_0326__section1455114211515"><h4 class="sectiontitle">Status Codes</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0326__status_code" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_02_0326__row18455442171518"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.7.2.1.3.1.1"><p id="dli_02_0326__p17456942201517">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="85%" id="mcps1.3.7.2.1.3.1.2"><p id="dli_02_0326__p1145616427159">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dli_02_0326__row1145544261516"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="dli_02_0326__p1745717426159">200</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="dli_02_0326__p34571427159">OK</p>
</td>
</tr>
<tr id="dli_02_0326__row124551942161512"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="dli_02_0326__p4457542131512">400</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="dli_02_0326__p8458142171517">Incorrect parameters. For example, creating an existing elastic resource pool.</p>
</td>
</tr>
<tr id="dli_02_0326__row545515424158"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="dli_02_0326__p17458204210158">403</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="dli_02_0326__p1145824216159">Forbidden</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="dli_02_0326__section84596424159"><h4 class="sectiontitle">Error Codes</h4><p id="dli_02_0326__p645914241511">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 <a href="dli_02_0056.html">Error Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dli_02_0325.html">APIs Related to Elastic Resource Pools</a></div>
</div>
</div>
View Git Blame Copy Permalink