doc-exports/docs/dli/api-ref/dli_02_0228.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

490 lines
42 KiB
HTML

<a name="dli_02_0228"></a><a name="dli_02_0228"></a>
<h1 class="topictitle1">Creating a SQL Job</h1>
<div id="body1574749523870"><div class="section" id="dli_02_0228__s89ff8bc59cba4c3b94dc17e85c8fa1ea"><h4 class="sectiontitle">Function</h4><p id="dli_02_0228__a4deaa8ebc392424e869c47835399ab23">This API is used to create a Flink streaming SQL job.</p>
</div>
<div class="section" id="dli_02_0228__sef21e3efc2a44a84a03adad33a1ae006"><h4 class="sectiontitle">URI</h4><ul id="dli_02_0228__uf99c5b2f64a44669a611cae56296b336"><li id="dli_02_0228__l02802a572cd14322a9edb44c392d1063">URI format<p id="dli_02_0228__ab9f59a1049d24cb2a9c51b9ed06e59d4"><a name="dli_02_0228__l02802a572cd14322a9edb44c392d1063"></a><a name="l02802a572cd14322a9edb44c392d1063"></a>POST /v1.0/{project_id}/streaming/sql-jobs</p>
</li><li id="dli_02_0228__lab001edff5ca4cde843db03812f0979d">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0228__t219b031199884ac1bb9e91158ddc9efb" frame="border" border="1" rules="all"><caption><b>Table 1 </b>URI parameter</caption><thead align="left"><tr id="dli_02_0228__r04005eeda24e4db9b06516450d4d56af"><th align="left" class="cellrowborder" valign="top" width="15.690000000000001%" id="mcps1.3.2.2.2.1.2.5.1.1"><p id="dli_02_0228__a80847df5e5dc448caa46a2ff258fa2c4">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="12.97%" id="mcps1.3.2.2.2.1.2.5.1.2"><p id="dli_02_0228__af54fc16087b049c98f748c1a2faace17">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="11.14%" id="mcps1.3.2.2.2.1.2.5.1.3"><p id="dli_02_0228__p468716366114">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="60.199999999999996%" id="mcps1.3.2.2.2.1.2.5.1.4"><p id="dli_02_0228__a484a3e0ce14846799c727ccbd4075d6c">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dli_02_0228__r8022e11be3f54ad290cf8c848a56a550"><td class="cellrowborder" valign="top" width="15.690000000000001%" headers="mcps1.3.2.2.2.1.2.5.1.1 "><p id="dli_02_0228__a2b526eb27eb241248b0586fd54086598">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="12.97%" headers="mcps1.3.2.2.2.1.2.5.1.2 "><p id="dli_02_0228__p1016041415356">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="11.14%" headers="mcps1.3.2.2.2.1.2.5.1.3 "><p id="dli_02_0228__p1268773616112">String</p>
</td>
<td class="cellrowborder" valign="top" width="60.199999999999996%" headers="mcps1.3.2.2.2.1.2.5.1.4 "><p id="dli_02_0228__p1768719515356">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_0228__s3afece1037ea4f62aeffb3db49b97f70"><h4 class="sectiontitle">Request</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0228__tcedd9d5bece544898da42c15fe855a72" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request parameters</caption><thead align="left"><tr id="dli_02_0228__r263212cfc24b4f7ab11ba179dc95f8d5"><th align="left" class="cellrowborder" valign="top" width="20.84%" id="mcps1.3.3.2.2.5.1.1"><p id="dli_02_0228__aa71bb56aa6ba48488d66e68a44744488">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="12.13%" id="mcps1.3.3.2.2.5.1.2"><p id="dli_02_0228__adfb457c202dc4709b315aa6d0a384fdf">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="11.63%" id="mcps1.3.3.2.2.5.1.3"><p id="dli_02_0228__a07ad11538b854ab4997a0c69b2fa1ff5">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="55.400000000000006%" id="mcps1.3.3.2.2.5.1.4"><p id="dli_02_0228__a27603242143846be8ed4173686b0b27b">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dli_02_0228__rab514ea502754f9d88a6ca5cd27e6f9b"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p24236235151446">name</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__a3f01c30693ef41f9ab8913a733a8dcae">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__a4c806296e81547638d0ed294d9a3ca63">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__ace897a9e7d9d47a1895664dd49e10fe5">Name of the job. The value can contain 1 to 57 characters.</p>
</td>
</tr>
<tr id="dli_02_0228__rd59ae95756ea47c28d7aa24b2a057881"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p60911214151446">desc</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__a3db6910eff34455caa5af7c1be07ff39">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__a3b4b1f2ddd81469dbc22dc9de316fc9b">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__a4de8fb2d168546a9adf40df6d59ce095">Job description. Length range: 0 to 512 characters.</p>
</td>
</tr>
<tr id="dli_02_0228__rc32461e6ae584faebd86e6a27d35ad52"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p45216947151446">template_id</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__aa5ebc166527543019d7799ddf643663f">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__ad6a32cc0ba694cea9fe5f132dd482a0b">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__a6311275524c844f4aa133f8f5818d0c0">Template ID.</p>
<p id="dli_02_0228__p1438412141206">If both <strong id="dli_02_0228__b84235270617632">template_id</strong> and <strong id="dli_02_0228__b84235270617635">sql_body</strong> are specified, <strong id="dli_02_0228__b84235270617645">sql_body</strong> is used. If <strong id="dli_02_0228__b7366586515825">template_id</strong> is specified but <strong id="dli_02_0228__b189050023915825">sql_body</strong> is not, fill <strong id="dli_02_0228__b197376495515825">sql_body</strong> with the <strong id="dli_02_0228__b3805696915825">template_id</strong> value.</p>
</td>
</tr>
<tr id="dli_02_0228__row71872872118"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p17928153443914">queue_name</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p89278346396">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p1292519344391">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p18919434113920">Name of a queue. The value can contain 0 to 128 characters.</p>
</td>
</tr>
<tr id="dli_02_0228__r38ed7748501049b3a7f15541cb4bdc4b"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p30775898151446">sql_body</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__a340bf6a8cdce459ebdb06f53dd44204d">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__ab0cf8c891059456883c2149d7b794ba1">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__ac9cd898aa62e4b4c81ae3645e8d767e0">Stream SQL statement, which includes at least the following three parts: source, query, and sink. Length range: 1,024 x 1,024 characters.</p>
</td>
</tr>
<tr id="dli_02_0228__r6d6edee93eb44b018bb642182c0e6228"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p51971590151446">run_mode</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__aba11f8fa96ff477e8af2e81aabc0d8de">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__a1c9f0e6238ad4ce69be9eafbb38d73d9">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p79611213113">Job running mode. The options are as follows:</p>
<ul id="dli_02_0228__ul15289751193715"><li id="dli_02_0228__li109014434020"><strong id="dli_02_0228__b176881152382">shared_cluster</strong>: indicates that the job is running on a shared cluster.</li><li id="dli_02_0228__li10403410212"><strong id="dli_02_0228__b198194161388">exclusive_cluster</strong>: indicates that the job is running on an exclusive cluster.</li><li id="dli_02_0228__li228914518371"><strong id="dli_02_0228__b2098915178386">edge_node</strong>: indicates that the job is running on an edge node.</li></ul>
<p id="dli_02_0228__p19772114195416">The default value is <strong id="dli_02_0228__b182112035112512">shared_cluster</strong>.</p>
</td>
</tr>
<tr id="dli_02_0228__r7661b89ca2e94401ab63183ad079e920"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p19885945151446">cu_number</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__a4b43c1e99deb4082b3f21179c1477b1f">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__adf45245d5ce04f61afc160b115d2412b">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__a37e9360fa1d44cf0b3fafc4bbe29cc2d">Number of CUs selected for a job. The default value is <strong id="dli_02_0228__b1068913171848">2</strong>.</p>
<p id="dli_02_0228__p103554498466">Sum of the number of compute units and job manager CUs of DLI. CU is also the billing unit of DLI. One CU equals one vCPU and 4 GB of memory. The value is the number of CUs required for job running and cannot exceed the number of CUs in the bound queue. For details about how to set the number of CUs of JobManager, see <strong id="dli_02_0228__b177365311593">manager_cu_number</strong>.</p>
</td>
</tr>
<tr id="dli_02_0228__r589617809d1e42868f5a1aa6a3dbf196"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p19578767151446">parallel_number</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__a3081bb162d8a41cda78080611d26e443">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__a714864b01e3b4f948edf105756d06630">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__a5c667b50c56f47dbb9bee32c10d72ba0">Number of parallel jobs set by a user. The default value is <strong id="dli_02_0228__b84235270615612">1</strong>.</p>
<p id="dli_02_0228__p1921120114817">Number of Flink SQL jobs that run at the same time. Properly increasing the number of parallel threads improves the overall computing capability of the job. However, the switchover overhead caused by the increase of threads must be considered. This value cannot be greater than four times the compute units (number of CUs minus the number of JobManager CUs).</p>
<p id="dli_02_0228__p24101740145118">For details about how to set the number of JobManager CUs, see <strong id="dli_02_0228__b2344162814219">manager_cu_number</strong>.</p>
</td>
</tr>
<tr id="dli_02_0228__r4751eede45fe4cb3856249640bbc3c77"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p686005151439">checkpoint_enabled</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__a582fb4ae115d44e79559c249bfcafab6">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__a32e117ff1f8940e79eb14e009be0e7ab">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p4191338101210">Whether to enable the automatic job snapshot function.</p>
<ul id="dli_02_0228__ul960951941319"><li id="dli_02_0228__li1960812195138"><strong id="dli_02_0228__b978532443113958">true</strong>: indicates to enable the automatic job snapshot function.</li><li id="dli_02_0228__li1660811981313"><strong id="dli_02_0228__b211827064711404">false</strong>: indicates to disable the automatic job snapshot function.</li><li id="dli_02_0228__li1460951901319">Default value: <strong id="dli_02_0228__b75463629211402">false</strong></li></ul>
</td>
</tr>
<tr id="dli_02_0228__rbef8b00389c343f1a6acb6261756d967"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p32848831151439">checkpoint_mode</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__ac3897cc29eb1495b9bbee471c304e326">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__af4e810f37b724bb4860e63e51fc32e05">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p228619524239">Snapshot mode. There are two options:</p>
<ul id="dli_02_0228__ul133371056182314"><li id="dli_02_0228__li13961658142316"><strong id="dli_02_0228__b55631957131812">1</strong>: <strong id="dli_02_0228__b856995719181">ExactlyOnce</strong>, indicates that data is processed only once.</li><li id="dli_02_0228__li1433713569235"><strong id="dli_02_0228__b103863119198">2</strong>: <strong id="dli_02_0228__b03861161912">AtLeastOnce</strong>, indicates that data is processed at least once.</li></ul>
<p id="dli_02_0228__p1972956121218">The default value is <strong id="dli_02_0228__b1079595121910">1</strong>.</p>
</td>
</tr>
<tr id="dli_02_0228__row14878123920261"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p13880183918268">checkpoint_interval</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p186384642711">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p1664216614270">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p5880113952617">Snapshot interval. The unit is second. The default value is <span class="parmvalue" id="dli_02_0228__parmvalue12310144416509"><b>10</b></span>.</p>
</td>
</tr>
<tr id="dli_02_0228__rbdbc4a1a7b9d41b0873a21b5c8c515a4"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p32635548151439">obs_bucket</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__af1ba5522fd1e4cb1856c94e5e69a665d">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__a9a24d2aea7e342e2891e5daf0bf14743">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__a1ce1860d24414e2081b94e41c906d4f7">OBS bucket where users are authorized to save the snapshot. This parameter is valid only when <span class="parmname" id="dli_02_0228__parmname98580381216"><b>checkpoint_enabled</b></span> is set to <strong id="dli_02_0228__b34793150017352">true</strong>.</p>
<p id="dli_02_0228__p18511124216591">OBS bucket where users are authorized to save the snapshot. This parameter is valid only when <strong id="dli_02_0228__b440203212813">log_enabled</strong> is set to <strong id="dli_02_0228__b114108325286">true</strong>.</p>
</td>
</tr>
<tr id="dli_02_0228__r7c856f9629304e7bb100c8794d29caf1"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p29331592151433">log_enabled</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__a01071703297a4354bb6cb18ba6572f3f">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__a279c155d38614fc486c897f82f6a3a8f">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__a8819ccc464094137afa687b48d8f62b2">Whether to enable the function of uploading job logs to users' OBS buckets. The default value is <span class="parmvalue" id="dli_02_0228__parmvalue18333947602"><b>false</b></span>.</p>
</td>
</tr>
<tr id="dli_02_0228__row1973917493203"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p27391449182012">smn_topic</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p1773919491205">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p147398499204">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p67391449142016">SMN topic. If a job fails, the system will send a message to users subscribed to the SMN topic.</p>
</td>
</tr>
<tr id="dli_02_0228__row014411362057"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p12884615665">restart_when_exception</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p1414410363514">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p1714403618511">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p314419367515">Whether to enable the function of automatically restarting a job upon job exceptions. The default value is <span class="parmvalue" id="dli_02_0228__parmvalue52961551300"><b>false</b></span>.</p>
</td>
</tr>
<tr id="dli_02_0228__row71935566513"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p1888312819610">idle_state_retention</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p21931256755">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p1119385615510">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p15193856757">Retention time of the idle state. The unit is second. The default value is <span class="parmvalue" id="dli_02_0228__parmvalue2267391352"><b>3600</b></span>.</p>
</td>
</tr>
<tr id="dli_02_0228__row1321714314112"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p1921793115118">job_type</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p192177311117">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p112174313119">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p597173717169">Job type. The options include <strong id="dli_02_0228__b795016397297">flink_sql_job</strong> and <strong id="dli_02_0228__b1399954452917">flink_opensource_sql_job</strong>.</p>
<p id="dli_02_0228__p16340145533917">The default value is <strong id="dli_02_0228__b95208528293">flink_opensource_sql_job</strong>.</p>
<ul id="dli_02_0228__ul14520163841811"><li id="dli_02_0228__li05201338161813">If <strong id="dli_02_0228__b164442214229">run_mode</strong> is set to <strong id="dli_02_0228__b20542192592214">exclusive_cluster</strong>, <strong id="dli_02_0228__b14331154672220">job_type</strong> must be set to <strong id="dli_02_0228__b799518544226">flink_sql_job</strong> or <strong id="dli_02_0228__b82128172314">flink_opensource_sql_job</strong>.</li><li id="dli_02_0228__li11218190104715">If <strong id="dli_02_0228__b204401021132316">run_mode</strong> is set to <strong id="dli_02_0228__b441624152318">shared_cluster</strong>, <strong id="dli_02_0228__b3328438172316">job_type</strong> must be set to <strong id="dli_02_0228__b12432174714234">flink_sql_job</strong>.</li></ul>
</td>
</tr>
<tr id="dli_02_0228__row1977812466369"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p1842823984611">dirty_data_strategy</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p164285395469">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p94281539184614">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p1842883912463">Dirty data policy of a job.</p>
<ul id="dli_02_0228__ul14821163115417"><li id="dli_02_0228__li1182114311541"><strong id="dli_02_0228__b444719122502">2:obsDir</strong>: Save. <strong id="dli_02_0228__b1348914504507">obsDir</strong> specifies the path for storing dirty data.</li><li id="dli_02_0228__li19342046105619"><strong id="dli_02_0228__b035122212519">1</strong>: Trigger a job exception</li><li id="dli_02_0228__li1891112118577"><strong id="dli_02_0228__b3741181916514">0</strong>: Ignore</li></ul>
<p id="dli_02_0228__p17304143102218">The default value is <strong id="dli_02_0228__b161355914564">0</strong>.</p>
</td>
</tr>
<tr id="dli_02_0228__row16141247203911"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p19470241751">udf_jar_url</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p19474241851">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p1894820241519">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p894882416512">Name of the resource package that has been uploaded to the DLI resource management system. The UDF Jar file of the SQL job is specified by this parameter.</p>
</td>
</tr>
<tr id="dli_02_0228__row21601724348"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p3942456173617">manager_cu_number</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p1494215615362">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p3942135673612">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p29421456113614">Number of CUs in the JobManager selected for a job. The default value is <strong id="dli_02_0228__b9275125032620">1</strong>.</p>
</td>
</tr>
<tr id="dli_02_0228__row10739195520211"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p62741531828">tm_cus</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p1827415533218">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p132740531925">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p9274165315217">Number of CUs for each TaskManager. The default value is <strong id="dli_02_0228__b63443117276">1</strong>.</p>
</td>
</tr>
<tr id="dli_02_0228__row773817551425"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p122748531625">tm_slot_num</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p1274125315210">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p1327455313218">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p4275145317210">Number of slots in each TaskManager. The default value is <strong id="dli_02_0228__b74211119182818">(parallel_number*tm_cus)/(cu_number-manager_cu_number)</strong>.</p>
</td>
</tr>
<tr id="dli_02_0228__row1136167132716"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p2335124251810">resume_checkpoint</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p173354422187">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p113357429186">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p233519428187">Whether the abnormal restart is recovered from the checkpoint.</p>
</td>
</tr>
<tr id="dli_02_0228__row1713487162714"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p3543245162311">resume_max_num</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p9541245182312">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p185409459238">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p1549119459232">Maximum number of retry times upon exceptions. The unit is times/hour. Value range: -1 or greater than 0. The default value is <strong id="dli_02_0228__b18729368333">-1</strong>, indicating that the number of times is unlimited.</p>
</td>
</tr>
<tr id="dli_02_0228__row7554171585116"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p1364431775213">tags</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p13644017145212">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p964531775213">Array of objects</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p196451017195219">Label of a Flink SQL job. For details, see <a href="#dli_02_0228__table9391124139">Table 3</a>.</p>
</td>
</tr>
<tr id="dli_02_0228__row746162055613"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p95362034690">runtime_config</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p165376345912">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p25373349919">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p1153712346915">Customizes optimization parameters when a Flink job is running.</p>
</td>
</tr>
<tr id="dli_02_0228__row9956303347"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p151566375316">flink_version</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p11156633539">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p171568315310">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p1815673185311">Flink version. Currently, only 1.10 and 1.12 are supported.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="dli_02_0228__table9391124139"></a><a name="table9391124139"></a><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0228__table9391124139" frame="border" border="1" rules="all"><caption><b>Table 3 </b>tags parameters</caption><thead align="left"><tr id="dli_02_0228__row1440020130"><th align="left" class="cellrowborder" valign="top" width="14.899999999999999%" id="mcps1.3.3.3.2.5.1.1"><p id="dli_02_0228__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_0228__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_0228__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_0228__p16401271318">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dli_02_0228__row194013231317"><td class="cellrowborder" valign="top" width="14.899999999999999%" headers="mcps1.3.3.3.2.5.1.1 "><p id="dli_02_0228__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_0228__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_0228__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_0228__p5401021139">Tag key</p>
<div class="note" id="dli_02_0228__note13334617185913"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="dli_02_0228__p103351817115920">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_0228__b565614107169">_sys_</strong>.</p>
</div></div>
<div class="note" id="dli_02_0228__note642743816531"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="dli_02_0228__p18428738185310">A tag key can contain a maximum of 36 characters. Only letters, digits, hyphens (-), underscores (_), and spaces are allowed. The key cannot start or end with a space.</p>
</div></div>
</td>
</tr>
<tr id="dli_02_0228__row1141142181320"><td class="cellrowborder" valign="top" width="14.899999999999999%" headers="mcps1.3.3.3.2.5.1.1 "><p id="dli_02_0228__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_0228__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_0228__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_0228__p16411125137">Tag value</p>
<div class="note" id="dli_02_0228__note17686539175910"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="dli_02_0228__p368612392599">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>
<div class="note" id="dli_02_0228__note132645919543"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="dli_02_0228__p2265119185419">A tag value can contain a maximum of 43 characters. Only letters, digits, hyphens (-), underscores (_), periods (.), and spaces 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_0228__se2bf80cdb76541308f69f258ea4b1bd6"><h4 class="sectiontitle">Response</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0228__t5995d65f65ba4ebca8606202112b407e" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Response parameters</caption><thead align="left"><tr id="dli_02_0228__ra7acea51e4b4437e917d21fe99f130a3"><th align="left" class="cellrowborder" valign="top" width="19.25%" id="mcps1.3.4.2.2.5.1.1"><p id="dli_02_0228__a5af940f2267747ef871c67c86a0be82e">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="14.44%" id="mcps1.3.4.2.2.5.1.2"><p id="dli_02_0228__abcfbd3a651704d539626f3a41cc744f5">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="16.76%" id="mcps1.3.4.2.2.5.1.3"><p id="dli_02_0228__a2351d8d266444ad3ad1c09540d6d81cc">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="49.55%" id="mcps1.3.4.2.2.5.1.4"><p id="dli_02_0228__af7ea6a3f59844bdf99d51e90d570be4c">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dli_02_0228__row2418154742"><td class="cellrowborder" valign="top" width="19.25%" headers="mcps1.3.4.2.2.5.1.1 "><p id="dli_02_0228__p2827183519">is_success</p>
</td>
<td class="cellrowborder" valign="top" width="14.44%" headers="mcps1.3.4.2.2.5.1.2 "><p id="dli_02_0228__p6362111364911">No</p>
</td>
<td class="cellrowborder" valign="top" width="16.76%" headers="mcps1.3.4.2.2.5.1.3 "><p id="dli_02_0228__p118601817517">String</p>
</td>
<td class="cellrowborder" valign="top" width="49.55%" headers="mcps1.3.4.2.2.5.1.4 "><p id="dli_02_0228__p1487318359">Indicates whether the request is successfully executed. Value <span class="parmvalue" id="dli_02_0228__parmvalue18862182863417"><b>true</b></span> indicates that the request is successfully executed.</p>
</td>
</tr>
<tr id="dli_02_0228__row64180541741"><td class="cellrowborder" valign="top" width="19.25%" headers="mcps1.3.4.2.2.5.1.1 "><p id="dli_02_0228__a4aba020b918e457a8a3d15e7ebaeb20d">message</p>
</td>
<td class="cellrowborder" valign="top" width="14.44%" headers="mcps1.3.4.2.2.5.1.2 "><p id="dli_02_0228__p11374111319494">No</p>
</td>
<td class="cellrowborder" valign="top" width="16.76%" headers="mcps1.3.4.2.2.5.1.3 "><p id="dli_02_0228__ac85edc0a27d044b0ad524a4124e59e4c">String</p>
</td>
<td class="cellrowborder" valign="top" width="49.55%" headers="mcps1.3.4.2.2.5.1.4 "><p id="dli_02_0228__ac087aec9dfcc407ba244ad3e96b23257">Message content.</p>
</td>
</tr>
<tr id="dli_02_0228__row15874961669"><td class="cellrowborder" valign="top" width="19.25%" headers="mcps1.3.4.2.2.5.1.1 "><p id="dli_02_0228__p933863862615">job</p>
</td>
<td class="cellrowborder" valign="top" width="14.44%" headers="mcps1.3.4.2.2.5.1.2 "><p id="dli_02_0228__p9338638122617">No</p>
</td>
<td class="cellrowborder" valign="top" width="16.76%" headers="mcps1.3.4.2.2.5.1.3 "><p id="dli_02_0228__p33383387265">Object</p>
</td>
<td class="cellrowborder" valign="top" width="49.55%" headers="mcps1.3.4.2.2.5.1.4 "><p id="dli_02_0228__p18338103822617">Information about the job status. For details, see <a href="#dli_02_0228__table86492245453">Table 5</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="dli_02_0228__table86492245453"></a><a name="table86492245453"></a><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0228__table86492245453" frame="border" border="1" rules="all"><caption><b>Table 5 </b><strong id="dli_02_0228__b17427163512344">job</strong> parameters</caption><thead align="left"><tr id="dli_02_0228__row176501524184518"><th align="left" class="cellrowborder" valign="top" width="19.25%" id="mcps1.3.4.3.2.5.1.1"><p id="dli_02_0228__p18650152414511">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="14.44%" id="mcps1.3.4.3.2.5.1.2"><p id="dli_02_0228__p10650424204518">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="13.370000000000001%" id="mcps1.3.4.3.2.5.1.3"><p id="dli_02_0228__p865022420455">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="52.94%" id="mcps1.3.4.3.2.5.1.4"><p id="dli_02_0228__p10650192416454">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dli_02_0228__row1965211245455"><td class="cellrowborder" valign="top" width="19.25%" headers="mcps1.3.4.3.2.5.1.1 "><p id="dli_02_0228__p265214241459">job_id</p>
</td>
<td class="cellrowborder" valign="top" width="14.44%" headers="mcps1.3.4.3.2.5.1.2 "><p id="dli_02_0228__p176521824104518">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="13.370000000000001%" headers="mcps1.3.4.3.2.5.1.3 "><p id="dli_02_0228__p965292416455">Long</p>
</td>
<td class="cellrowborder" valign="top" width="52.94%" headers="mcps1.3.4.3.2.5.1.4 "><p id="dli_02_0228__p26525248455">Job ID.</p>
</td>
</tr>
<tr id="dli_02_0228__row1465210242456"><td class="cellrowborder" valign="top" width="19.25%" headers="mcps1.3.4.3.2.5.1.1 "><p id="dli_02_0228__p1465252404513">status_name</p>
</td>
<td class="cellrowborder" valign="top" width="14.44%" headers="mcps1.3.4.3.2.5.1.2 "><p id="dli_02_0228__p8652624134510">No</p>
</td>
<td class="cellrowborder" valign="top" width="13.370000000000001%" headers="mcps1.3.4.3.2.5.1.3 "><p id="dli_02_0228__p665282413457">String</p>
</td>
<td class="cellrowborder" valign="top" width="52.94%" headers="mcps1.3.4.3.2.5.1.4 "><p id="dli_02_0228__p156531124134510">Name of job status. For details, see the description of the <strong id="dli_02_0228__b13389173113514">status</strong> field in <a href="dli_02_0235.html">Querying Job Details</a>.</p>
</td>
</tr>
<tr id="dli_02_0228__row1865352464519"><td class="cellrowborder" valign="top" width="19.25%" headers="mcps1.3.4.3.2.5.1.1 "><p id="dli_02_0228__p1665314248452">status_desc</p>
</td>
<td class="cellrowborder" valign="top" width="14.44%" headers="mcps1.3.4.3.2.5.1.2 "><p id="dli_02_0228__p15653122464517">No</p>
</td>
<td class="cellrowborder" valign="top" width="13.370000000000001%" headers="mcps1.3.4.3.2.5.1.3 "><p id="dli_02_0228__p14653024114510">String</p>
</td>
<td class="cellrowborder" valign="top" width="52.94%" headers="mcps1.3.4.3.2.5.1.4 "><p id="dli_02_0228__p565313246452">Status description. Causes and suggestions for the abnormal status.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="dli_02_0228__section1130754105710"><h4 class="sectiontitle">Example Request</h4><p id="dli_02_0228__p1954203819496">Use the template whose ID is <strong id="dli_02_0228__b1871618245330">100000</strong> to create a Flink SQL job named <strong id="dli_02_0228__b5941193823316">myjob</strong>. The job runs in dedicated mode on the <strong id="dli_02_0228__b1195842117345">testQueue</strong> queue.</p>
<pre class="screen" id="dli_02_0228__screen17915151213913">{
"name": "myjob",
"desc": "This is a job used for counting characters.",
"template_id": 100000,
"queue_name": "testQueue",
"sql_body": "select * from source_table",
"run_mode": "exclusive_cluster",
"cu_number": 2,
"parallel_number": 1,
"checkpoint_enabled": false,
"checkpoint_mode": "exactly_once",
"checkpoint_interval": 0,
"obs_bucket": "my_obs_bucket",
"log_enabled": false,
"restart_when_exception": false,
"idle_state_retention": 3600,
"job_type": "flink_sql_job",
"dirty_data_strategy": "0",
"udf_jar_url": "group/test.jar"
}</pre>
</div>
<div class="section" id="dli_02_0228__section611513417318"><h4 class="sectiontitle">Example Response</h4><pre class="screen" id="dli_02_0228__screen3128586398">{
"is_success": "true",
"message": "A DLI job is created successfully.",
"job": {
"job_id": 148,
"status_name": "job_init",
"status_desc": ""
}
}</pre>
</div>
<div class="section" id="dli_02_0228__s1b495ba11cd9411c9ad2ee50103334a7"><h4 class="sectiontitle">Status Codes</h4><p id="dli_02_0228__acef1445366354016b2ed90921927a555"><a href="#dli_02_0228__t43c1f1c0ba344f4cbcb270953d9cca2a">Table 6</a> describes status codes.</p>
<div class="tablenoborder"><a name="dli_02_0228__t43c1f1c0ba344f4cbcb270953d9cca2a"></a><a name="t43c1f1c0ba344f4cbcb270953d9cca2a"></a><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0228__t43c1f1c0ba344f4cbcb270953d9cca2a" frame="border" border="1" rules="all"><caption><b>Table 6 </b>Status codes</caption><thead align="left"><tr id="dli_02_0228__r2ad0f008ce2248a1800a3e8b77226a56"><th align="left" class="cellrowborder" valign="top" width="30%" id="mcps1.3.7.3.2.3.1.1"><p id="dli_02_0228__afa33b7f5b0ac4d008ebcf6493f629b24">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_0228__af801170b350b4f8ba3b575c7ddb8b13e">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dli_02_0228__r0b449b1d3b8c498ea3e6cce16c80a14c"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.7.3.2.3.1.1 "><p id="dli_02_0228__a8c63a97e3bad402ebaead0bd99cad632">200</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.7.3.2.3.1.2 "><p id="dli_02_0228__p828449123817">The job is created successfully.</p>
</td>
</tr>
<tr id="dli_02_0228__row264510302300"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.7.3.2.3.1.1 "><p id="dli_02_0228__p19646163033015">400</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.7.3.2.3.1.2 "><p id="dli_02_0228__p47552616316">The input parameter is invalid.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="dli_02_0228__section13596141025715"><h4 class="sectiontitle">Error Codes</h4><p id="dli_02_0228__dli_02_0225_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_0223.html">Flink Job-related APIs</a></div>
</div>
</div>