forked from docs/doc-exports
Su, Xiaomeng
2374069890
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>
52 lines
4.6 KiB
HTML
52 lines
4.6 KiB
HTML
<a name="dli_02_0307"></a><a name="dli_02_0307"></a>
|
|
|
|
<h1 class="topictitle1">Creating a Queue</h1>
|
|
<div id="body1602473883610"><div class="section" id="dli_02_0307__section851316282599"><h4 class="sectiontitle">Scenario Description</h4><p id="dli_02_0307__p175765551329">This section describes how to create and query a queue using APIs.</p>
|
|
</div>
|
|
<div class="section" id="dli_02_0307__section155144213214"><h4 class="sectiontitle">Constraints</h4><ul id="dli_02_0307__ul759612191669"><li id="dli_02_0307__li45963199610">Queues created using this API will be bound to specified compute resources.</li><li id="dli_02_0307__li12597141912618">It takes 6 to 10 minutes to start a job using a new queue for the first time.</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_02_0307__section13856162971"><h4 class="sectiontitle">Involved APIs</h4><ul id="dli_02_0307__ul1862251633812"><li id="dli_02_0307__li462221673818"><a href="dli_02_0194.html">Creating a Queue</a>: Create a queue.</li><li id="dli_02_0307__li46223161388"><a href="dli_02_0016.html">Viewing Details of a Queue</a>: Ensure that the queue is successfully created.</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_02_0307__section2742155213719"><h4 class="sectiontitle">Procedure</h4><ol id="dli_02_0307__ol454620011213"><li id="dli_02_0307__li135461061218">Create a queue.<ul id="dli_02_0307__ul137032024121215"><li id="dli_02_0307__li1770411244125">API<p id="dli_02_0307__p13852153516123"><a name="dli_02_0307__li1770411244125"></a><a name="li1770411244125"></a>URI format: POST /v1.0/{project_id}/queues</p>
|
|
<ul id="dli_02_0307__ul124089529220"><li id="dli_02_0307__li132805002217">Obtain the value of {project_id} from <a href="dli_02_0183.html">Obtaining a Project ID</a>.</li><li id="dli_02_0307__li162995013229">For details about the request parameters, see <a href="dli_02_0194.html">Creating a Queue</a>.</li></ul>
|
|
</li><li id="dli_02_0307__li8824323145">Request example<ul id="dli_02_0307__ul13290386151"><li id="dli_02_0307__li483819347159">Description: Create an SQL queue named <strong id="dli_02_0307__b822124518517">queue1</strong> in the project whose ID is <strong id="dli_02_0307__b9175164985116">48cc2c48765f481480c7db940d6409d1</strong>.</li><li id="dli_02_0307__li29121139165">Example URL: POST https://{<em id="dli_02_0307__i101561469524">endpoint</em>}/v1.0/48cc2c48765f481480c7db940d6409d1/queues</li><li id="dli_02_0307__li126039382162">Body:<pre class="screen" id="dli_02_0307__screen19421163301714">{
|
|
"queue_name": "queue1",
|
|
"description": "test",
|
|
"cu_count": 16,
|
|
"resource_mode": 1,
|
|
"queue_type": "sql"
|
|
}</pre>
|
|
</li></ul>
|
|
</li><li id="dli_02_0307__li1636591417239">Example response<pre class="screen" id="dli_02_0307__screen1492583018236">{
|
|
"is_success": true,
|
|
"message": "",
|
|
"queue_name": "queue1"
|
|
}</pre>
|
|
</li></ul>
|
|
</li><li id="dli_02_0307__li18904826102815">Verify that the queue is created successfully.<ul id="dli_02_0307__ul178791154132816"><li id="dli_02_0307__li1187919544287">API<p id="dli_02_0307__p198791154192815"><a name="dli_02_0307__li1187919544287"></a><a name="li1187919544287"></a>URI format: GET /v1.0/{<em id="dli_02_0307__i350710735311">project_id</em>}/queues/{<em id="dli_02_0307__i849481295311">queue_name</em>}</p>
|
|
<ul id="dli_02_0307__ul158791254132815"><li id="dli_02_0307__li7879854172815">Obtain the value of {<em id="dli_02_0307__i1857513185319">project_id</em>} from <a href="dli_02_0183.html">Obtaining a Project ID</a>.</li><li id="dli_02_0307__li13879115411285">For details about the query parameters, see <a href="dli_02_0016.html">Viewing Details of a Queue</a>.</li></ul>
|
|
</li><li id="dli_02_0307__li7879185418289">Request example<ul id="dli_02_0307__ul1287995452812"><li id="dli_02_0307__li118791554122819">Description: Query details about queue1 in the project whose ID is 48cc2c48765f481480c7db940d6409d1.</li><li id="dli_02_0307__li6879145416284">Example URL: GET https://{<em id="dli_02_0307__i20312162317559">endpoint</em>}/v1.0/48cc2c48765f481480c7db940d6409d1/queues/queue1</li><li id="dli_02_0307__li16880154182814">Body:<pre class="screen" id="dli_02_0307__screen488075411287">{}</pre>
|
|
</li></ul>
|
|
</li><li id="dli_02_0307__li198801754192819">Example response<pre class="screen" id="dli_02_0307__screen78801654182815">{
|
|
"is_success": true,
|
|
"message": "",
|
|
"owner": "testuser",
|
|
"description": "",
|
|
"queue_name": "queue1",
|
|
"create_time": 1587613028851,
|
|
"queue_type": "sql",
|
|
"cu_count": 16,
|
|
"resource_id": "03d51b88-db63-4611-b779-9a72ba0cf58b",
|
|
"resource_mode": 0
|
|
}</pre>
|
|
</li></ul>
|
|
</li></ol>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="dli_02_0306.html">Getting Started</a></div>
|
|
</div>
|
|
</div>
|
|
|