forked from docs/doc-exports
Su, Xiaomeng
483e5cc6cc
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>
79 lines
6.6 KiB
HTML
79 lines
6.6 KiB
HTML
<a name="dli_02_0311"></a><a name="dli_02_0311"></a>
|
|
|
|
<h1 class="topictitle1">Creating and Using a Datasource Connection</h1>
|
|
<div id="body1602473883611"><div class="section" id="dli_02_0311__section851316282599"><h4 class="sectiontitle">Scenario Description</h4><p id="dli_02_0311__p1822151903">This section describes how to create an enhanced datasource connection using an API.</p>
|
|
</div>
|
|
<div class="section" id="dli_02_0311__section155144213214"><h4 class="sectiontitle">Constraints</h4><ul id="dli_02_0311__ul759612191669"><li id="dli_02_0311__li45963199610">It takes 6 to 10 minutes to start a job using a new queue for the first time.</li><li id="dli_02_0311__li12597141912618">Before creating an enhanced datasource connection, you need to obtain the ID of the VPC and the network ID of the subnet where the service is located. </li></ul>
|
|
</div>
|
|
<div class="section" id="dli_02_0311__section13856162971"><h4 class="sectiontitle">Involved APIs</h4><ul id="dli_02_0311__ul1862251633812"><li id="dli_02_0311__li462221673818"><a href="dli_02_0194.html">Creating a Queue</a>: Create a dedicated queue.</li><li id="dli_02_0311__li46223161388"><a href="dli_02_0187.html">Creating an Enhanced Datasource Connection</a>: Create an enhanced datasource connection.</li><li id="dli_02_0311__li1137901761318"><a href="dli_02_0191.html">Binding a Queue</a>: Bind a queue.</li><li id="dli_02_0311__li1484215716133"><a href="dli_02_0189.html">Querying an Enhanced Datasource Connection</a>: Check whether an enhanced datasource connection is successfully created.</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_02_0311__section2742155213719"><h4 class="sectiontitle">Procedure</h4><ol id="dli_02_0311__ol454620011213"><li id="dli_02_0311__li135461061218">Create a queue. For details, see <a href="dli_02_0307.html">Creating a Queue</a>. In the request, set <strong id="dli_02_0311__b9465170639">resource_mode</strong> to <strong id="dli_02_0311__b204661201035">1</strong> to create a dedicated queue.</li><li id="dli_02_0311__li117291344122510">Create an enhanced datasource connection.<ul id="dli_02_0311__ul2729144122513"><li id="dli_02_0311__li57278446258">API<p id="dli_02_0311__p7727134452510"><a name="dli_02_0311__li57278446258"></a><a name="li57278446258"></a>URI format: POST /v2.0/{<em id="dli_02_0311__i17726132518319">project_id</em>}/datasource/enhanced-connections</p>
|
|
<ul id="dli_02_0311__ul14727644162512"><li id="dli_02_0311__li9727134442515">Obtain the value of {<em id="dli_02_0311__i6335127333">project_id</em>} from <a href="dli_02_0183.html">Obtaining a Project ID</a>.</li><li id="dli_02_0311__li1372710448250">For details about the request parameters, see <a href="dli_02_0187.html">Creating an Enhanced Datasource Connection</a>.</li></ul>
|
|
</li><li id="dli_02_0311__li5728744172513">Request example<ul id="dli_02_0311__ul772864412254"><li id="dli_02_0311__li17728194415253">Description: Create an enhanced datasource connection named <strong id="dli_02_0311__b731511474310">test1</strong> in project <strong id="dli_02_0311__b14941155112316">48cc2c48765f481480c7db940d6409d1</strong>.</li><li id="dli_02_0311__li137287448256">Example URL: POST https://{<em id="dli_02_0311__i154195719312">endpoint</em>}/v2.0/48cc2c48765f481480c7db940d6409d1/datasource/enhanced-connections</li><li id="dli_02_0311__li14728144414252">Body:<pre class="screen" id="dli_02_0311__screen672864492517">{
|
|
"name": "test1",
|
|
"dest_vpc_id": "22094d8f-c310-4621-913d-4c4d655d8495",
|
|
"dest_network_id": "78f2562a-36e4-4b39-95b9-f5aab22e1281",
|
|
"queues": ["q1","q2"],
|
|
"hosts": [
|
|
{
|
|
"ip":"192.168.0.1",
|
|
"name":"ecs-97f8-0001"
|
|
},
|
|
{
|
|
"ip":"192.168.0.2",
|
|
"name":"ecs-97f8-0002"
|
|
}
|
|
]
|
|
}</pre>
|
|
</li></ul>
|
|
</li><li id="dli_02_0311__li19729134452514">Example response<pre class="screen" id="dli_02_0311__screen15729114442511">{
|
|
"is_success": true,
|
|
"message": "",
|
|
"connection_id": "2a620c33-5609-40c9-affd-2b6453071b0f"
|
|
}</pre>
|
|
</li></ul>
|
|
</li><li id="dli_02_0311__li566476163912">(Optional) If no queue is bound when you create an enhanced datasource connection, you can use the <a href="dli_02_0191.html">Binding a Queue</a> API to bind a queue.</li><li id="dli_02_0311__li125211016104016">Verify that the enhanced datasource connection is created successfully.<ul id="dli_02_0311__ul26571210114414"><li id="dli_02_0311__li146576102444">API<p id="dli_02_0311__p10657111019442"><a name="dli_02_0311__li146576102444"></a><a name="li146576102444"></a>URI format: GET /v2.0/{<em id="dli_02_0311__i4198836341">project_id</em>}/datasource/enhanced-connections/{<em id="dli_02_0311__i18339124015410">connection_id</em>}</p>
|
|
<ul id="dli_02_0311__ul56581107449"><li id="dli_02_0311__li17658191013442">Obtain the value of {<em id="dli_02_0311__i1254211412417">project_id</em>} from <a href="dli_02_0183.html">Obtaining a Project ID</a>.</li><li id="dli_02_0311__li3658201018442">For details about the query parameters, see <a href="dli_02_0028.html">Creating a Database (Discarded)</a>.</li></ul>
|
|
</li><li id="dli_02_0311__li10658410164410">Request example<ul id="dli_02_0311__ul14658161015442"><li id="dli_02_0311__li865851014449">Description: Query an enhanced datasource connection whose ID is <strong id="dli_02_0311__b16136145912418">2a620c33-5609-40c9-affd-2b6453071b0f</strong> in project <strong id="dli_02_0311__b156471831520">48cc2c48765f481480c7db940d6409d1</strong>.</li><li id="dli_02_0311__li6658171074411">Example URL: GET https://{<em id="dli_02_0311__i342351111511">endpoint</em>}/v2.0/48cc2c48765f481480c7db940d6409d1/datasource/enhanced-connections/2a620c33-5609-40c9-affd-2b6453071b0f</li><li id="dli_02_0311__li165811084419">Body:<pre class="screen" id="dli_02_0311__screen3658131064420">{}</pre>
|
|
</li></ul>
|
|
</li><li id="dli_02_0311__li2065912101446">Example response<pre class="screen" id="dli_02_0311__screen765961024418">{
|
|
"is_success": true,
|
|
"message": "",
|
|
"name": "test1",
|
|
"id": "2a620c33-5609-40c9-affd-2b6453071b0f",
|
|
"available_queue_info": [
|
|
{
|
|
"status": "ACTIVE",
|
|
"name": "queue1",
|
|
"peer_id": "2a620c33-5609-40c9-affd-2b6453071b0f",
|
|
"err_msg": "",
|
|
"update_time": 1566889577861
|
|
}
|
|
],
|
|
"dest_vpc_id": "22094d8f-c310-4621-913d-4c4d655d8495",
|
|
"dest_network_id": "78f2562a-36e4-4b39-95b9-f5aab22e1281",
|
|
"isPrivis": true,
|
|
"create_time": 1566888011125,
|
|
"status": "ACTIVE",
|
|
"hosts": [
|
|
{
|
|
"ip":"192.168.0.1",
|
|
"name":"ecs-97f8-0001"
|
|
},
|
|
{
|
|
"ip":"192.168.0.2",
|
|
"name":"ecs-97f8-0002"
|
|
}
|
|
]
|
|
}</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>
|
|
|