vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/dli/api-ref/dli_02_0194.html
Su, Xiaomeng 57a0d535be dli_api_0910_version_api 
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>
2023-10-16 22:01:57 +00:00

272 lines
23 KiB
HTML
Raw Blame History

<a name="dli_02_0194"></a><a name="dli_02_0194"></a>
<h1 class="topictitle1">Creating a Queue</h1>
<div id="body1566551543143"><div class="section" id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_section44513484"><h4 class="sectiontitle">Function</h4><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_p18738462">This API is used to create a queue. The queue will be bound to specified compute resources.</p>
<div class="note" id="dli_02_0194__note1293204515206"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="dli_02_0194__p39474552017">It takes 5 to 15 minutes to start a job using a new queue for the first time.</p>
</div></div>
</div>
<div class="section" id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_section65077040"><h4 class="sectiontitle">URI</h4><ul id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_ul37239475"><li id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_li66719825">URI format<p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_p63607521"><a name="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_li66719825"></a><a name="en-us_topic_0069078607_en-us_topic_0069077926_li66719825"></a>POST /v1.0/{project_id}/queues</p>
</li><li id="dli_02_0194__en-us_topic_0069078607_li1725612218454">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077803_table60779388" frame="border" border="1" rules="all"><caption><b>Table 1 </b>URI parameter</caption><thead align="left"><tr id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077803_row61411666"><th align="left" class="cellrowborder" valign="top" width="12.02%" id="mcps1.3.2.2.2.1.2.5.1.1"><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077803_p17730125817424">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="12.950000000000001%" id="mcps1.3.2.2.2.1.2.5.1.2"><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077803_p873025824211">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="11.52%" id="mcps1.3.2.2.2.1.2.5.1.3"><p id="dli_02_0194__p201348299181">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="63.51%" id="mcps1.3.2.2.2.1.2.5.1.4"><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077803_p12730358114211">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077803_row48589216"><td class="cellrowborder" valign="top" width="12.02%" headers="mcps1.3.2.2.2.1.2.5.1.1 "><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077803_p43412436">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="12.950000000000001%" headers="mcps1.3.2.2.2.1.2.5.1.2 "><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077803_p26746391">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="11.52%" headers="mcps1.3.2.2.2.1.2.5.1.3 "><p id="dli_02_0194__p14134132911818">String</p>
</td>
<td class="cellrowborder" valign="top" width="63.51%" headers="mcps1.3.2.2.2.1.2.5.1.4 "><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077803_p18974100">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_0194__en-us_topic_0069078607_en-us_topic_0069077926_section48822450"><h4 class="sectiontitle">Request</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_table52036772" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request parameters</caption><thead align="left"><tr id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_row6711263"><th align="left" class="cellrowborder" valign="top" width="16.88%" id="mcps1.3.3.2.2.5.1.1"><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_p1641446825">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="12.07%" id="mcps1.3.3.2.2.5.1.2"><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_p20413469220">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="13.19%" id="mcps1.3.3.2.2.5.1.3"><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_p124174619213">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="57.86%" id="mcps1.3.3.2.2.5.1.4"><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_p0413461523">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_row48422011"><td class="cellrowborder" valign="top" width="16.88%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_p29868832">queue_name</p>
</td>
<td class="cellrowborder" valign="top" width="12.07%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_p3456313">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="13.19%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_p11525935">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.86%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_p61185513">Name of a newly created resource queue. The name can contain only digits, letters, and underscores (_), but cannot contain only digits or start with an underscore (_). Length range: 1 to 128 characters.</p>
<div class="note" id="dli_02_0194__note14431426201920"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="dli_02_0194__p6288122915199">The queue name is case-insensitive. The uppercase letters will be automatically converted to lowercase letters.</p>
</div></div>
</td>
</tr>
<tr id="dli_02_0194__row2860739104812"><td class="cellrowborder" valign="top" width="16.88%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0194__p37621320164910">queue_type</p>
</td>
<td class="cellrowborder" valign="top" width="12.07%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0194__p1076222024913">No</p>
</td>
<td class="cellrowborder" valign="top" width="13.19%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0194__p9762152013494">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.86%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0194__p05114365019">Queue type. The options are as follows:</p>
<ul id="dli_02_0194__ul970089145020"><li id="dli_02_0194__li118471712175013"><strong id="dli_02_0194__b1903192210177">sql</strong>: Queues used to run SQL jobs</li><li id="dli_02_0194__li37152061233"><strong id="dli_02_0194__b912347191719">general</strong>: Queues used to run Flink and Spark Jar jobs.</li></ul>
<div class="note" id="dli_02_0194__note8282217155210"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="dli_02_0194__p580812257336">If the type is not specified, the default value <span class="parmvalue" id="dli_02_0194__parmvalue1395994417317"><b>sql</b></span> is used.</p>
</div></div>
</td>
</tr>
<tr id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_row13798707"><td class="cellrowborder" valign="top" width="16.88%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_p43953487">description</p>
</td>
<td class="cellrowborder" valign="top" width="12.07%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_p3462691">No</p>
</td>
<td class="cellrowborder" valign="top" width="13.19%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_p12042584">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.86%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_p35925270">Description of a queue.</p>
</td>
</tr>
<tr id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_row54891975"><td class="cellrowborder" valign="top" width="16.88%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_p17064996">cu_count</p>
</td>
<td class="cellrowborder" valign="top" width="12.07%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_p40087454">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="13.19%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_p25858332">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="57.86%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_p14150151">Minimum number of CUs that are bound to a queue. Currently, the value can only be <strong id="dli_02_0194__b19552122123418">16</strong>, <strong id="dli_02_0194__b26911849344">64</strong>, or <strong id="dli_02_0194__b199873618344">256</strong>.</p>
</td>
</tr>
<tr id="dli_02_0194__row1026873354315"><td class="cellrowborder" valign="top" width="16.88%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0194__p6269533134318">enterprise_project_id</p>
</td>
<td class="cellrowborder" valign="top" width="12.07%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0194__p15269183364318">No</p>
</td>
<td class="cellrowborder" valign="top" width="13.19%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0194__p5269103315439">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.86%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0194__p1326917339437">Enterprise project ID. The value <strong id="dli_02_0194__b1351951833412">0</strong> indicates the default enterprise project. </p>
<div class="note" id="dli_02_0194__note1358194815815"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="dli_02_0194__p16581348175819">Users who have enabled Enterprise Management can set this parameter to bind a specified project.</p>
</div></div>
</td>
</tr>
<tr id="dli_02_0194__row13872293310"><td class="cellrowborder" valign="top" width="16.88%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0194__p139241713324">platform</p>
</td>
<td class="cellrowborder" valign="top" width="12.07%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0194__p492414135218">No</p>
</td>
<td class="cellrowborder" valign="top" width="13.19%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0194__p49247136219">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.86%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0194__p12644181241714">CPU architecture of compute resources.</p>
<ul id="dli_02_0194__ul176516183177"><li id="dli_02_0194__li135648223177">x86_64</li></ul>
</td>
</tr>
<tr id="dli_02_0194__row87501583517"><td class="cellrowborder" valign="top" width="16.88%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0194__p18751138459">resource_mode</p>
</td>
<td class="cellrowborder" valign="top" width="12.07%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0194__p7751128658">No</p>
</td>
<td class="cellrowborder" valign="top" width="13.19%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0194__p8751589519">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="57.86%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0194__p875148059">Queue resource mode. The options are as follows:</p>
<p id="dli_02_0194__p14679022565"><strong id="dli_02_0194__b668514522179">0</strong>: shared resource mode</p>
<p id="dli_02_0194__p349816321568"><strong id="dli_02_0194__b5975504189">1</strong>: dedicated resource mode</p>
</td>
</tr>
<tr id="dli_02_0194__row79932173117"><td class="cellrowborder" valign="top" width="16.88%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0194__p8443183513115">labels</p>
</td>
<td class="cellrowborder" valign="top" width="12.07%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0194__p94436359317">No</p>
</td>
<td class="cellrowborder" valign="top" width="13.19%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0194__p1844313353315">Array of Strings</p>
</td>
<td class="cellrowborder" valign="top" width="57.86%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0194__p444343518314">Tag information of the queue to be created. Currently, the tag information includes whether the queue is cross-AZ (JSON string). The value can only be <span class="parmvalue" id="dli_02_0194__parmvalue54491615113816"><b>2</b></span>, that is, a dual-AZ queue whose compute resources are distributed in two AZs is created.</p>
</td>
</tr>
<tr id="dli_02_0194__row3662610185610"><td class="cellrowborder" valign="top" width="16.88%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0194__p135102615814">tags</p>
</td>
<td class="cellrowborder" valign="top" width="12.07%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0194__p251011605810">No</p>
</td>
<td class="cellrowborder" valign="top" width="13.19%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0194__p451066135816">Array of Objects</p>
</td>
<td class="cellrowborder" valign="top" width="57.86%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0194__p55101469587">Queue tags for identifying cloud resources. A tag consists of a key and tag value. For details, see <a href="#dli_02_0194__table9391124139">Table 3</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="dli_02_0194__table9391124139"></a><a name="table9391124139"></a><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0194__table9391124139" frame="border" border="1" rules="all"><caption><b>Table 3 </b>tags parameters</caption><thead align="left"><tr id="dli_02_0194__row1440020130"><th align="left" class="cellrowborder" valign="top" width="14.899999999999999%" id="mcps1.3.3.3.2.5.1.1"><p id="dli_02_0194__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_0194__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_0194__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_0194__p16401271318">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dli_02_0194__row194013231317"><td class="cellrowborder" valign="top" width="14.899999999999999%" headers="mcps1.3.3.3.2.5.1.1 "><p id="dli_02_0194__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_0194__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_0194__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_0194__p5401021139">Tag key.</p>
<div class="note" id="dli_02_0194__note0301141034716"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="dli_02_0194__p103021210124719">A tag key can contain a maximum of 36 characters. Special characters (=*&lt;&gt;\|) are not allowed, and the key cannot start with a space.</p>
</div></div>
</td>
</tr>
<tr id="dli_02_0194__row1141142181320"><td class="cellrowborder" valign="top" width="14.899999999999999%" headers="mcps1.3.3.3.2.5.1.1 "><p id="dli_02_0194__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_0194__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_0194__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_0194__p16411125137">Tag value.</p>
<div class="note" id="dli_02_0194__note1889312310474"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="dli_02_0194__p1789316312479">A tag value can contain a maximum of 43 characters. Special characters (=*&lt;&gt;\|) are not allowed, and the value cannot start with a space.</p>
</div></div>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_section36748867"><h4 class="sectiontitle">Response</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_table19633890" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Response parameters</caption><thead align="left"><tr id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_row55641967"><th align="left" class="cellrowborder" valign="top" width="14.899999999999999%" id="mcps1.3.4.2.2.5.1.1"><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_p0246103641513">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="10.81%" id="mcps1.3.4.2.2.5.1.2"><p id="dli_02_0194__p1078924313357">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="16.49%" id="mcps1.3.4.2.2.5.1.3"><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_p7246143612153">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="57.8%" id="mcps1.3.4.2.2.5.1.4"><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_p42461036161519">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_row6261366"><td class="cellrowborder" valign="top" width="14.899999999999999%" headers="mcps1.3.4.2.2.5.1.1 "><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_p37408603">is_success</p>
</td>
<td class="cellrowborder" valign="top" width="10.81%" headers="mcps1.3.4.2.2.5.1.2 "><p id="dli_02_0194__p17903437355">No</p>
</td>
<td class="cellrowborder" valign="top" width="16.49%" headers="mcps1.3.4.2.2.5.1.3 "><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_p20730083">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="57.8%" headers="mcps1.3.4.2.2.5.1.4 "><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_p1415125">Indicates whether the request is successfully executed. Value <span class="parmvalue" id="dli_02_0194__parmvalue4993877595041"><b>true</b></span> indicates that the request is successfully executed.</p>
</td>
</tr>
<tr id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_row12736131"><td class="cellrowborder" valign="top" width="14.899999999999999%" headers="mcps1.3.4.2.2.5.1.1 "><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_p24993667">message</p>
</td>
<td class="cellrowborder" valign="top" width="10.81%" headers="mcps1.3.4.2.2.5.1.2 "><p id="dli_02_0194__p2790184312357">No</p>
</td>
<td class="cellrowborder" valign="top" width="16.49%" headers="mcps1.3.4.2.2.5.1.3 "><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_p36498445">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.8%" headers="mcps1.3.4.2.2.5.1.4 "><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_p3584103">System prompt. If execution succeeds, the parameter setting may be left blank.</p>
</td>
</tr>
<tr id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_row32256934"><td class="cellrowborder" valign="top" width="14.899999999999999%" headers="mcps1.3.4.2.2.5.1.1 "><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_p62674860">queue_name</p>
</td>
<td class="cellrowborder" valign="top" width="10.81%" headers="mcps1.3.4.2.2.5.1.2 "><p id="dli_02_0194__p127904431353">No</p>
</td>
<td class="cellrowborder" valign="top" width="16.49%" headers="mcps1.3.4.2.2.5.1.3 "><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_p33747564">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.8%" headers="mcps1.3.4.2.2.5.1.4 "><p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_p49198200">Name of the created queue.</p>
<div class="note" id="dli_02_0194__note476117532239"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="dli_02_0194__p4761115352312">The queue name is case-insensitive. The uppercase letters will be automatically converted to lowercase letters.</p>
</div></div>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="dli_02_0194__section15772143623410"><h4 class="sectiontitle">Example Request</h4><p id="dli_02_0194__p1593313305711">Create a dedicated general-purpose queue named <strong id="dli_02_0194__b71093695910">queue1</strong>, with specifications of 16 CUs and compute resources distributed in two AZs.</p>
<pre class="screen" id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_screen26326068">{
"queue_name": "queue1",
"description": "test",
"cu_count": 16,
"resource_mode": 1,
"queue_type": "general",
"labels": ["multi_az=2"]
}</pre>
</div>
<div class="section" id="dli_02_0194__section59635464345"><h4 class="sectiontitle">Example Response</h4><pre class="screen" id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_screen27583042">{
"is_success": true,
"message": "",
"queue_name": "queue1"
}</pre>
</div>
<div class="section" id="dli_02_0194__sf39cfd445ad24e9e82754fcb0027179d"><h4 class="sectiontitle">Status Codes</h4><p id="dli_02_0194__a04144ca3a08e4576b386c6a98f43a2ae"><a href="#dli_02_0194__tb12870f1c5f24b27abd55ca24264af36">Table 5</a> describes the status code.</p>
<div class="tablenoborder"><a name="dli_02_0194__tb12870f1c5f24b27abd55ca24264af36"></a><a name="tb12870f1c5f24b27abd55ca24264af36"></a><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0194__tb12870f1c5f24b27abd55ca24264af36" frame="border" border="1" rules="all"><caption><b>Table 5 </b>Status codes</caption><thead align="left"><tr id="dli_02_0194__r8d54231f95b14c01a5e55e95f3b2e838"><th align="left" class="cellrowborder" valign="top" width="30%" id="mcps1.3.7.3.2.3.1.1"><p id="dli_02_0194__ab49d21f312644072a331f43e92baf853">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="70%" id="mcps1.3.7.3.2.3.1.2"><p id="dli_02_0194__aea1d3bd107bb4c499da79a88832d256c">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dli_02_0194__r211ad4eb571d4d938e5579998723174e"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.7.3.2.3.1.1 "><p id="dli_02_0194__a3153e07b3a9749adba92599fe6628fbf">200</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.7.3.2.3.1.2 "><p id="dli_02_0194__p104431642124811">The job is created successfully.</p>
</td>
</tr>
<tr id="dli_02_0194__row44937531727"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.7.3.2.3.1.1 "><p id="dli_02_0194__p184941532219">400</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.7.3.2.3.1.2 "><p id="dli_02_0194__p2049413539219">Request error.</p>
</td>
</tr>
<tr id="dli_02_0194__row65331212142411"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.7.3.2.3.1.1 "><p id="dli_02_0194__p5537171216249">500</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.7.3.2.3.1.2 "><p id="dli_02_0194__p953813124249">Internal service error.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="dli_02_0194__section13596141025715"><h4 class="sectiontitle">Error Codes</h4><p id="dli_02_0194__p420584425712">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_0193.html">Queue-related APIs (Recommended)</a></div>
</div>
</div>
View Git Blame Copy Permalink