forked from docs/doc-exports
Su, Xiaomeng
04ae6632a7
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>
381 lines
32 KiB
HTML
381 lines
32 KiB
HTML
<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__p12841111193519"><strong id="dli_02_0194__b54932131641010">Definition</strong></p>
|
|
<p id="dli_02_0194__p18513202722714">Project ID, which is used for resource isolation. For how to obtain a project ID, see <a href="dli_02_0183.html">Obtaining a Project ID</a>.</p>
|
|
<p id="dli_02_0194__p476513559276">Example: <strong id="dli_02_0194__b78877995142743">48cc2c48765f481480c7db940d6409d1</strong></p>
|
|
<p id="dli_02_0194__p1779921913513"><strong id="dli_02_0194__b12297117454040">Constraints</strong></p>
|
|
<p id="dli_02_0194__p16166233143510">None</p>
|
|
<p id="dli_02_0194__p19789423113517"><strong id="dli_02_0194__b5532797614049">Range</strong></p>
|
|
<p id="dli_02_0194__p20527112713361">The value can contain up to 64 characters. Only letters and digits are allowed.</p>
|
|
<p id="dli_02_0194__p1049772653519"><strong id="dli_02_0194__b11541396304733">Default Value</strong></p>
|
|
<p id="dli_02_0194__p6928441113513">None</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 Parameters</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.170000000000002%" 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.879999999999995%" 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.170000000000002%" 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.879999999999995%" 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 the new queue</p>
|
|
<p id="dli_02_0194__p1569744615288"><strong id="dli_02_0194__b80091371141010">Definition</strong></p>
|
|
<p id="dli_02_0194__p1112214192910">Name of the new queue</p>
|
|
<p id="dli_02_0194__p166976465288"><strong id="dli_02_0194__b12442317554040">Constraints</strong></p>
|
|
<ul id="dli_02_0194__ul96441641193211"><li id="dli_02_0194__li1364414119321">The name cannot contain only digits or start with an underscore (_). Only digits, letters, and underscores (_) are allowed.</li><li id="dli_02_0194__li264412417328">The value can contain up to 128 characters.</li><li id="dli_02_0194__li1164464123218">The queue name is case-insensitive. Uppercase letters will be automatically converted to lowercase letters.</li></ul>
|
|
<p id="dli_02_0194__p769714615283"><strong id="dli_02_0194__b1611560304049">Range</strong></p>
|
|
<p id="dli_02_0194__p469715467289">None</p>
|
|
<p id="dli_02_0194__p196971467285"><strong id="dli_02_0194__b13412658804733">Default Value</strong></p>
|
|
<p id="dli_02_0194__p269774662813">None</p>
|
|
</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.170000000000002%" 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.879999999999995%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0194__p1138516221291"><strong id="dli_02_0194__b35232426241010">Definition</strong></p>
|
|
<p id="dli_02_0194__p16021827193316">Queue type</p>
|
|
<p id="dli_02_0194__p73858226294"><strong id="dli_02_0194__b15611542644040">Constraints</strong></p>
|
|
<p id="dli_02_0194__p143851322112919">If not specified, the default value <strong id="dli_02_0194__b2088555713315">sql</strong> is used.</p>
|
|
<p id="dli_02_0194__p8385152282916"><strong id="dli_02_0194__b8436723814049">Range</strong></p>
|
|
<ul id="dli_02_0194__ul460282773314"><li id="dli_02_0194__li8602162718332"><strong id="dli_02_0194__b94994813215">sql</strong>: Queues used to run SQL jobs</li><li id="dli_02_0194__li11602162773316"><strong id="dli_02_0194__b207610491321">general</strong>: Queues used to run Flink and Spark Jar jobs</li></ul>
|
|
<p id="dli_02_0194__p5385122132918"><strong id="dli_02_0194__b149580894733">Default Value</strong></p>
|
|
<p id="dli_02_0194__p113851622142918">None</p>
|
|
</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.170000000000002%" 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.879999999999995%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0194__p19345122420297"><strong id="dli_02_0194__b54500102641010">Definition</strong></p>
|
|
<p id="dli_02_0194__p634519242297">Queue description</p>
|
|
<p id="dli_02_0194__p1034542402915"><strong id="dli_02_0194__b9690730314040">Constraints</strong></p>
|
|
<p id="dli_02_0194__p153451224192916">None</p>
|
|
<p id="dli_02_0194__p234532412920"><strong id="dli_02_0194__b19914565934049">Range</strong></p>
|
|
<p id="dli_02_0194__p153454249293">None</p>
|
|
<p id="dli_02_0194__p1934532418295"><strong id="dli_02_0194__b19927206664733">Default Value</strong></p>
|
|
<p id="dli_02_0194__p19345132420294">None</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.170000000000002%" 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.879999999999995%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0194__p3353112682913"><strong id="dli_02_0194__b44736505641010">Definition</strong></p>
|
|
<p id="dli_02_0194__p1135372682918">Minimum number of CUs bound to a queue</p>
|
|
<p id="dli_02_0194__p9353326112918"><strong id="dli_02_0194__b12379933974040">Constraints</strong></p>
|
|
<p id="dli_02_0194__p1735412616293">None</p>
|
|
<p id="dli_02_0194__p83547261298"><strong id="dli_02_0194__b20840229714049">Range</strong></p>
|
|
<p id="dli_02_0194__p1235492616298">The options are <strong id="dli_02_0194__b14455652143317">16</strong>, <strong id="dli_02_0194__b16455452113318">64</strong>, and <strong id="dli_02_0194__b14455125293318">256</strong>.</p>
|
|
<p id="dli_02_0194__p5354026132920"><strong id="dli_02_0194__b7855336284733">Default Value</strong></p>
|
|
<p id="dli_02_0194__p4354122622919">None</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.170000000000002%" 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.879999999999995%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0194__p6660133515297"><strong id="dli_02_0194__b3272374741010">Definition</strong></p>
|
|
<p id="dli_02_0194__p17828754143511">Enterprise project ID. The value <strong id="dli_02_0194__b1730154063510">0</strong> indicates the default enterprise project.</p>
|
|
<p id="dli_02_0194__p1326917339437"></p>
|
|
<p id="dli_02_0194__p106613353290"><strong id="dli_02_0194__b4727221634040">Constraints</strong></p>
|
|
<p id="dli_02_0194__p16581348175819">Only users who have enabled Enterprise Management can set this parameter to bind a specified project.</p>
|
|
<p id="dli_02_0194__p18661535192917"><strong id="dli_02_0194__b16559693174049">Range</strong></p>
|
|
<p id="dli_02_0194__p186615355299">None</p>
|
|
<p id="dli_02_0194__p8661173592917"><strong id="dli_02_0194__b6003475204733">Default Value</strong></p>
|
|
<p id="dli_02_0194__p4661193516291">None</p>
|
|
</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.170000000000002%" 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.879999999999995%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0194__p17980646132911"><strong id="dli_02_0194__b207733329141010">Definition</strong></p>
|
|
<p id="dli_02_0194__p39802046172917">CPU architecture of queue compute resources</p>
|
|
<p id="dli_02_0194__p6980134616296"><strong id="dli_02_0194__b10660045854040">Constraints</strong></p>
|
|
<p id="dli_02_0194__p69808466293">None</p>
|
|
<p id="dli_02_0194__p99800461293"><strong id="dli_02_0194__b21165445494049">Range</strong></p>
|
|
<ul id="dli_02_0194__ul176516183177"><li id="dli_02_0194__li135648223177">x86_64</li></ul>
|
|
<p id="dli_02_0194__p29801468294"><strong id="dli_02_0194__b9284264154733">Default Value</strong></p>
|
|
<p id="dli_02_0194__p2980204616294">None</p>
|
|
</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.170000000000002%" 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.879999999999995%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0194__p2270114917293"><strong id="dli_02_0194__b84478587941010">Definition</strong></p>
|
|
<p id="dli_02_0194__p1627044982919">Queue resource mode</p>
|
|
<p id="dli_02_0194__p19270144917297"><strong id="dli_02_0194__b13847635104040">Constraints</strong></p>
|
|
<p id="dli_02_0194__p8270134912918">None</p>
|
|
<p id="dli_02_0194__p11270184911292"><strong id="dli_02_0194__b12233376414049">Range</strong></p>
|
|
<p id="dli_02_0194__p14679022565"><strong id="dli_02_0194__b668514522179">0</strong>: shared resource mode</p>
|
|
<p id="dli_02_0194__p17730144315362"><strong id="dli_02_0194__b132501912381">1</strong>: dedicated resource mode</p>
|
|
<p id="dli_02_0194__p112708493297"><strong id="dli_02_0194__b14565303934733">Default Value</strong></p>
|
|
<p id="dli_02_0194__p22701249122911">None</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.170000000000002%" 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.879999999999995%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0194__p1814875117297"><strong id="dli_02_0194__b69353836741010">Definition</strong></p>
|
|
<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>
|
|
<p id="dli_02_0194__p13148651152915"><strong id="dli_02_0194__b1282125854040">Constraints</strong></p>
|
|
<p id="dli_02_0194__p914865112914">None</p>
|
|
<p id="dli_02_0194__p191487519295"><strong id="dli_02_0194__b5079942274049">Range</strong></p>
|
|
<p id="dli_02_0194__p0148351162910">None</p>
|
|
<p id="dli_02_0194__p15148125119296"><strong id="dli_02_0194__b20121084964733">Default Value</strong></p>
|
|
<p id="dli_02_0194__p5148951152915">None</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.170000000000002%" 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.879999999999995%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0194__p6988191113014"><strong id="dli_02_0194__b39100106541010">Definition</strong></p>
|
|
<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>
|
|
<p id="dli_02_0194__p1898811113307"><strong id="dli_02_0194__b1904740114040">Constraints</strong></p>
|
|
<p id="dli_02_0194__p4988171193014">None</p>
|
|
<p id="dli_02_0194__p2988201183014"><strong id="dli_02_0194__b6353801764049">Range</strong></p>
|
|
<p id="dli_02_0194__p10988161173013">None</p>
|
|
<p id="dli_02_0194__p398815111305"><strong id="dli_02_0194__b15186908584733">Default Value</strong></p>
|
|
<p id="dli_02_0194__p398861113016">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_02_0194__row15891727102112"><td class="cellrowborder" valign="top" width="16.88%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0194__p19497173018212">engine</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12.07%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0194__p5590132714219">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.170000000000002%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0194__p55901273213">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.879999999999995%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0194__p141641110163014"><strong id="dli_02_0194__b107723576941010">Definition</strong></p>
|
|
<p id="dli_02_0194__p334284611413">Engine type of the queue</p>
|
|
<p id="dli_02_0194__p1164171003018"><strong id="dli_02_0194__b20639135324040">Constraints</strong></p>
|
|
<p id="dli_02_0194__p816461003012">This parameter is available only when <strong id="dli_02_0194__b57431056104215">queue_type</strong> is set to <strong id="dli_02_0194__b1574325611427">sql</strong>.</p>
|
|
<p id="dli_02_0194__p171641109307"><strong id="dli_02_0194__b16220608364049">Range</strong></p>
|
|
<p id="dli_02_0194__p1898217354214">The options are <strong id="dli_02_0194__b3733151024313">spark</strong> and <strong id="dli_02_0194__b19733111010439">hetuEngine</strong>.</p>
|
|
<ul id="dli_02_0194__ul137867285134"><li id="dli_02_0194__li187861428141316"><strong id="dli_02_0194__b12463820114314">spark</strong>: Spark engine</li></ul>
|
|
<p id="dli_02_0194__p616401053018"><strong id="dli_02_0194__b2129864244733">Default Value</strong></p>
|
|
<p id="dli_02_0194__p1416471033017">The default value is <strong id="dli_02_0194__b191202508445">spark</strong>.</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.650000000000002%" 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.620000000000005%" 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.650000000000002%" 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.620000000000005%" headers="mcps1.3.3.3.2.5.1.4 "><p id="dli_02_0194__p3191102710309"><strong id="dli_02_0194__b199459039341010">Definition</strong></p>
|
|
<p id="dli_02_0194__p1519272783014">Tag key</p>
|
|
<p id="dli_02_0194__p51928275306"><strong id="dli_02_0194__b17242370864040">Constraints</strong></p>
|
|
<p id="dli_02_0194__p1819219272301">None</p>
|
|
<p id="dli_02_0194__p2192827103014"><strong id="dli_02_0194__b16935604474049">Range</strong></p>
|
|
<p id="dli_02_0194__p74267124517">A tag key can contain up to 128 characters, cannot start or end with a space, and cannot start with <strong id="dli_02_0194__b797105724619">_sys_</strong>. Only letters, digits, spaces, and the following special characters are allowed: _.:+-@</p>
|
|
<p id="dli_02_0194__p5192527143011"><strong id="dli_02_0194__b1897509234733">Default Value</strong></p>
|
|
<p id="dli_02_0194__p419222733011">None</p>
|
|
</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.650000000000002%" 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.620000000000005%" headers="mcps1.3.3.3.2.5.1.4 "><p id="dli_02_0194__p11880030133011"><strong id="dli_02_0194__b46453662841010">Definition</strong></p>
|
|
<p id="dli_02_0194__p3880123017301">Tag value</p>
|
|
<p id="dli_02_0194__p6880730173011"><strong id="dli_02_0194__b14301311844040">Constraints</strong></p>
|
|
<p id="dli_02_0194__p08801230113017">None</p>
|
|
<p id="dli_02_0194__p12880153014305"><strong id="dli_02_0194__b20664767554049">Range</strong></p>
|
|
<p id="dli_02_0194__p17199145217452">A tag value can contain up to 255 characters. Only letters, digits, spaces, and the following special characters are allowed: _.:+-@</p>
|
|
<p id="dli_02_0194__p1088011301307"><strong id="dli_02_0194__b10454537744733">Default Value</strong></p>
|
|
<p id="dli_02_0194__p20880113017304">None</p>
|
|
</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 Parameters</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__p124019441302"><strong id="dli_02_0194__b22292763541010">Definition</strong></p>
|
|
<p id="dli_02_0194__p1124112448305">Whether the request is successfully executed. <strong id="dli_02_0194__b143292032218">true</strong> indicates that the request is successfully executed.</p>
|
|
<p id="dli_02_0194__p924115445300"><strong id="dli_02_0194__b3271732704049">Range</strong></p>
|
|
<p id="dli_02_0194__p182413449303">None</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__p492011495564"><strong id="dli_02_0194__b114142140741010">Definition</strong></p>
|
|
<p id="dli_02_0194__p12260115765611">System prompt. If the execution succeeds, this parameter may be left blank.</p>
|
|
<p id="dli_02_0194__p1092044911567"><strong id="dli_02_0194__b16911758074049">Range</strong></p>
|
|
<p id="dli_02_0194__p19920134918566">None</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__p333449115719"><strong id="dli_02_0194__b125831344841010">Definition</strong></p>
|
|
<p id="dli_02_0194__en-us_topic_0069078607_en-us_topic_0069077926_p49198200">Name of the created queue. The queue name is case-insensitive. Uppercase letters will be automatically converted to lowercase letters.</p>
|
|
<p id="dli_02_0194__p53341915574"><strong id="dli_02_0194__b3878712144049">Range</strong></p>
|
|
<p id="dli_02_0194__p1733409185712">None</p>
|
|
</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>
|
|
<p id="dli_02_0194__p13301953144812">Creating a queue in a specified elastic resource pool</p>
|
|
<pre class="screen" id="dli_02_0194__screen1037142615493">{
|
|
"queue_name": "queue2",
|
|
"description": "test_esp",
|
|
"cu_count": 16,
|
|
"resource_mode": 1,
|
|
"enterprise_project_id": "0",
|
|
"queue_type": "general",
|
|
"labels": ["multi_az=2"],
|
|
"elastic_resource_pool_name": "elastic_pool_0622_10"
|
|
}</pre>
|
|
<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 codes.</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.9.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.9.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.9.3.2.3.1.1 "><p id="dli_02_0194__a3153e07b3a9749adba92599fe6628fbf">200</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.9.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.9.3.2.3.1.1 "><p id="dli_02_0194__p184941532219">400</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.9.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.9.3.2.3.1.1 "><p id="dli_02_0194__p5537171216249">500</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.9.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>
|
|
|