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

396 lines
31 KiB
HTML

<a name="dli_02_0296"></a><a name="dli_02_0296"></a>
<h1 class="topictitle1">Querying the Job Execution Progress</h1>
<div id="body1596419455447"><div class="section" id="dli_02_0296__s8f3c49e4c1b64c1e9847f0382f5ebe00"><h4 class="sectiontitle">Function</h4><p id="dli_02_0296__en-us_topic_0069077814_p21784659">This API is used to obtain the job execution progress. If a job is being executed, information about its subjobs can be obtained. If a job has just started or has ended, information about its subjobs cannot be obtained.</p>
</div>
<div class="section" id="dli_02_0296__see6cb792336246b389c06fba699c6a19"><h4 class="sectiontitle">URI</h4><ul id="dli_02_0296__en-us_topic_0069077814_ul19726930"><li id="dli_02_0296__en-us_topic_0069077814_li43324645">URI format<p id="dli_02_0296__en-us_topic_0069077814_p54377486"><a name="dli_02_0296__en-us_topic_0069077814_li43324645"></a><a name="en-us_topic_0069077814_li43324645"></a>GET /v1/{project_id}/jobs/{job_id}/progress</p>
</li><li id="dli_02_0296__li4328106416">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0296__en-us_topic_0069077814_table19635326" frame="border" border="1" rules="all"><caption><b>Table 1 </b>URI parameters</caption><thead align="left"><tr id="dli_02_0296__en-us_topic_0069077814_row58575353"><th align="left" class="cellrowborder" valign="top" width="16.92169216921692%" id="mcps1.3.2.2.2.1.2.5.1.1"><p id="dli_02_0296__en-us_topic_0069077814_p24211849733">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="13.96139613961396%" id="mcps1.3.2.2.2.1.2.5.1.2"><p id="dli_02_0296__en-us_topic_0069077814_p154212494314">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="15.391539153915392%" id="mcps1.3.2.2.2.1.2.5.1.3"><p id="dli_02_0296__p72491338181716">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="53.725372537253726%" id="mcps1.3.2.2.2.1.2.5.1.4"><p id="dli_02_0296__en-us_topic_0069077814_p142115491331">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dli_02_0296__row1613317314419"><td class="cellrowborder" valign="top" width="16.92169216921692%" headers="mcps1.3.2.2.2.1.2.5.1.1 "><p id="dli_02_0296__en-us_topic_0069077803_p43412436">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="13.96139613961396%" headers="mcps1.3.2.2.2.1.2.5.1.2 "><p id="dli_02_0296__en-us_topic_0069077803_p26746391">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="15.391539153915392%" headers="mcps1.3.2.2.2.1.2.5.1.3 "><p id="dli_02_0296__p1925073831716">String</p>
</td>
<td class="cellrowborder" valign="top" width="53.725372537253726%" headers="mcps1.3.2.2.2.1.2.5.1.4 "><p id="dli_02_0296__p1310472724012">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>
<tr id="dli_02_0296__en-us_topic_0069077814_row21896608"><td class="cellrowborder" valign="top" width="16.92169216921692%" headers="mcps1.3.2.2.2.1.2.5.1.1 "><p id="dli_02_0296__en-us_topic_0069077814_p28794863">job_id</p>
</td>
<td class="cellrowborder" valign="top" width="13.96139613961396%" headers="mcps1.3.2.2.2.1.2.5.1.2 "><p id="dli_02_0296__en-us_topic_0069077814_p50682599">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="15.391539153915392%" headers="mcps1.3.2.2.2.1.2.5.1.3 "><p id="dli_02_0296__p32508389172">String</p>
</td>
<td class="cellrowborder" valign="top" width="53.725372537253726%" headers="mcps1.3.2.2.2.1.2.5.1.4 "><p id="dli_02_0296__p19301152611105">Job ID</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
<div class="section" id="dli_02_0296__s8dda6ccfbea24c868af158e0aa7822c5"><h4 class="sectiontitle">Request</h4><p id="dli_02_0296__p330181916568">None</p>
</div>
<div class="section" id="dli_02_0296__s0d7de5aeff99479eb3a72f311e1ad3c7"><h4 class="sectiontitle">Response</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0296__en-us_topic_0069077814_table60129687" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Response parameters</caption><thead align="left"><tr id="dli_02_0296__en-us_topic_0069077814_row20495668"><th align="left" class="cellrowborder" valign="top" width="12.46%" id="mcps1.3.4.2.2.5.1.1"><p id="dli_02_0296__en-us_topic_0069077814_p139112501548">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="11.37%" id="mcps1.3.4.2.2.5.1.2"><p id="dli_02_0296__a60fbcb1d1e7b4615a098895b0f426132">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="11.64%" id="mcps1.3.4.2.2.5.1.3"><p id="dli_02_0296__en-us_topic_0069077814_p239111505415">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="64.53%" id="mcps1.3.4.2.2.5.1.4"><p id="dli_02_0296__en-us_topic_0069077814_p339165019415">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dli_02_0296__en-us_topic_0069077814_row46573083"><td class="cellrowborder" valign="top" width="12.46%" headers="mcps1.3.4.2.2.5.1.1 "><p id="dli_02_0296__en-us_topic_0069077814_p14323358">is_success</p>
</td>
<td class="cellrowborder" valign="top" width="11.37%" headers="mcps1.3.4.2.2.5.1.2 "><p id="dli_02_0296__en-us_topic_0069077814_p19341321">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="11.64%" headers="mcps1.3.4.2.2.5.1.3 "><p id="dli_02_0296__en-us_topic_0069077814_p23143173">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="64.53%" headers="mcps1.3.4.2.2.5.1.4 "><p id="dli_02_0296__p899244313414">Indicates whether the request is successfully sent. Value <span class="parmvalue" id="dli_02_0296__parmvalue1128913724518"><b>true</b></span> indicates that the request is successfully sent.</p>
</td>
</tr>
<tr id="dli_02_0296__en-us_topic_0069077814_row27048584"><td class="cellrowborder" valign="top" width="12.46%" headers="mcps1.3.4.2.2.5.1.1 "><p id="dli_02_0296__en-us_topic_0069077814_p43451716">message</p>
</td>
<td class="cellrowborder" valign="top" width="11.37%" headers="mcps1.3.4.2.2.5.1.2 "><p id="dli_02_0296__en-us_topic_0069077814_p29928141">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="11.64%" headers="mcps1.3.4.2.2.5.1.3 "><p id="dli_02_0296__en-us_topic_0069077814_p8260362">String</p>
</td>
<td class="cellrowborder" valign="top" width="64.53%" headers="mcps1.3.4.2.2.5.1.4 "><p id="dli_02_0296__p19992204319342">System prompt. If execution succeeds, the parameter setting may be left blank.</p>
</td>
</tr>
<tr id="dli_02_0296__row1191916151310"><td class="cellrowborder" valign="top" width="12.46%" headers="mcps1.3.4.2.2.5.1.1 "><p id="dli_02_0296__p152031611311">job_id</p>
</td>
<td class="cellrowborder" valign="top" width="11.37%" headers="mcps1.3.4.2.2.5.1.2 "><p id="dli_02_0296__p192021631319">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.64%" headers="mcps1.3.4.2.2.5.1.3 "><p id="dli_02_0296__p92019164131">String</p>
</td>
<td class="cellrowborder" valign="top" width="64.53%" headers="mcps1.3.4.2.2.5.1.4 "><p id="dli_02_0296__en-us_topic_0069077807_p52058427">ID of a job returned after a job is generated and submitted by using SQL statements. The job ID can be used to query the job status and results.</p>
</td>
</tr>
<tr id="dli_02_0296__row38145234172"><td class="cellrowborder" valign="top" width="12.46%" headers="mcps1.3.4.2.2.5.1.1 "><p id="dli_02_0296__p67957422164">status</p>
</td>
<td class="cellrowborder" valign="top" width="11.37%" headers="mcps1.3.4.2.2.5.1.2 "><p id="dli_02_0296__p1679544241614">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="11.64%" headers="mcps1.3.4.2.2.5.1.3 "><p id="dli_02_0296__p177951142121616">String</p>
</td>
<td class="cellrowborder" valign="top" width="64.53%" headers="mcps1.3.4.2.2.5.1.4 "><p id="dli_02_0296__p1219918315331">Job status. The status can be <strong id="dli_02_0296__b174313151975">RUNNING</strong>, <strong id="dli_02_0296__b194873161877">SCALING</strong>, <strong id="dli_02_0296__b158011317879">LAUNCHING</strong>, <strong id="dli_02_0296__b1531219191079">FINISHED</strong>, <strong id="dli_02_0296__b185632017715">FAILED</strong>, or <strong id="dli_02_0296__b75015221074">CANCELLED</strong>.</p>
</td>
</tr>
<tr id="dli_02_0296__row66577259166"><td class="cellrowborder" valign="top" width="12.46%" headers="mcps1.3.4.2.2.5.1.1 "><p id="dli_02_0296__p2043455191618">sub_job_id</p>
</td>
<td class="cellrowborder" valign="top" width="11.37%" headers="mcps1.3.4.2.2.5.1.2 "><p id="dli_02_0296__p184311555161">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.64%" headers="mcps1.3.4.2.2.5.1.3 "><p id="dli_02_0296__p4431455161618">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="64.53%" headers="mcps1.3.4.2.2.5.1.4 "><p id="dli_02_0296__p1356315379339">ID of a subjob that is running. If the subjob is not running or it is already finished, the subjob ID may be empty.</p>
</td>
</tr>
<tr id="dli_02_0296__row15659425191617"><td class="cellrowborder" valign="top" width="12.46%" headers="mcps1.3.4.2.2.5.1.1 "><p id="dli_02_0296__p209032231190">progress</p>
</td>
<td class="cellrowborder" valign="top" width="11.37%" headers="mcps1.3.4.2.2.5.1.2 "><p id="dli_02_0296__p1990302317192">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.64%" headers="mcps1.3.4.2.2.5.1.3 "><p id="dli_02_0296__p590372313191">Double</p>
</td>
<td class="cellrowborder" valign="top" width="64.53%" headers="mcps1.3.4.2.2.5.1.4 "><p id="dli_02_0296__p2281161213360">Progress of a running subjob or the entire job. The value can only be a rough estimate of the subjob progress and does not indicate the detailed job progress.</p>
<ul id="dli_02_0296__ul834516235367"><li id="dli_02_0296__li394353463615">If the job is just started or being submitted, the progress is displayed as <strong id="dli_02_0296__b799833484715">0</strong>. If the job execution is complete, the progress is displayed as <strong id="dli_02_0296__b12232485470">1</strong>. In this case, progress indicates the running progress of the entire job. Because no subjob is running, <strong id="dli_02_0296__b1137321114813">sub_job_id</strong> is not displayed.</li><li id="dli_02_0296__li10346132353614">If a subjob is running, the running progress of the subjob is displayed. The calculation method of progress is as follows: Number of completed tasks of the subjob/Total number of tasks of the subjob. In this case, progress indicates the running progress of the subjob, and <strong id="dli_02_0296__b324634920491">sub_job_id</strong> indicates the subjob ID.</li></ul>
</td>
</tr>
<tr id="dli_02_0296__row106591725191613"><td class="cellrowborder" valign="top" width="12.46%" headers="mcps1.3.4.2.2.5.1.1 "><p id="dli_02_0296__p12571134510195">sub_jobs</p>
</td>
<td class="cellrowborder" valign="top" width="11.37%" headers="mcps1.3.4.2.2.5.1.2 "><p id="dli_02_0296__p3571245201914">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.64%" headers="mcps1.3.4.2.2.5.1.3 "><p id="dli_02_0296__p1957114511911">Array of Object</p>
</td>
<td class="cellrowborder" valign="top" width="64.53%" headers="mcps1.3.4.2.2.5.1.4 "><p id="dli_02_0296__p181484933317">Details about a subjob of a running job. A job may contain multiple subjobs. For details, see <a href="#dli_02_0296__table2091820139203">Table 3</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="dli_02_0296__table2091820139203"></a><a name="table2091820139203"></a><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0296__table2091820139203" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Parameters in the <strong id="dli_02_0296__b85681447258">sub_jobs</strong> field</caption><thead align="left"><tr id="dli_02_0296__row1591871319206"><th align="left" class="cellrowborder" valign="top" width="18.86%" id="mcps1.3.4.3.2.5.1.1"><p id="dli_02_0296__p1191813138208">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="10.39%" id="mcps1.3.4.3.2.5.1.2"><p id="dli_02_0296__p1591919137204">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="15.4%" id="mcps1.3.4.3.2.5.1.3"><p id="dli_02_0296__p4919713202019">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="55.35%" id="mcps1.3.4.3.2.5.1.4"><p id="dli_02_0296__p1891914137206">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dli_02_0296__row1091931372013"><td class="cellrowborder" valign="top" width="18.86%" headers="mcps1.3.4.3.2.5.1.1 "><p id="dli_02_0296__p569663513243">id</p>
</td>
<td class="cellrowborder" valign="top" width="10.39%" headers="mcps1.3.4.3.2.5.1.2 "><p id="dli_02_0296__p669663519243">No</p>
</td>
<td class="cellrowborder" valign="top" width="15.4%" headers="mcps1.3.4.3.2.5.1.3 "><p id="dli_02_0296__p469620359241">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.35%" headers="mcps1.3.4.3.2.5.1.4 "><p id="dli_02_0296__p21341628172511">Subjob ID, corresponding to <strong id="dli_02_0296__b1180211916539">jobId</strong> of the open-source spark JobData.</p>
</td>
</tr>
<tr id="dli_02_0296__row11919111342017"><td class="cellrowborder" valign="top" width="18.86%" headers="mcps1.3.4.3.2.5.1.1 "><p id="dli_02_0296__p17696203542419">name</p>
</td>
<td class="cellrowborder" valign="top" width="10.39%" headers="mcps1.3.4.3.2.5.1.2 "><p id="dli_02_0296__p1769683542416">No</p>
</td>
<td class="cellrowborder" valign="top" width="15.4%" headers="mcps1.3.4.3.2.5.1.3 "><p id="dli_02_0296__p15697935112418">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.35%" headers="mcps1.3.4.3.2.5.1.4 "><p id="dli_02_0296__p16835163882520">Subjob name, corresponding to the <strong id="dli_02_0296__b587598205320">name</strong> of the open-source spark JobData.</p>
</td>
</tr>
<tr id="dli_02_0296__row59201013162019"><td class="cellrowborder" valign="top" width="18.86%" headers="mcps1.3.4.3.2.5.1.1 "><p id="dli_02_0296__p1169763562412">description</p>
</td>
<td class="cellrowborder" valign="top" width="10.39%" headers="mcps1.3.4.3.2.5.1.2 "><p id="dli_02_0296__p66971835132411">No</p>
</td>
<td class="cellrowborder" valign="top" width="15.4%" headers="mcps1.3.4.3.2.5.1.3 "><p id="dli_02_0296__p1369783502414">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.35%" headers="mcps1.3.4.3.2.5.1.4 "><p id="dli_02_0296__p464464422510">Description of a subjob, corresponding to the <strong id="dli_02_0296__b5458190155313">description</strong> of the open-source spark JobData.</p>
</td>
</tr>
<tr id="dli_02_0296__row19920513162013"><td class="cellrowborder" valign="top" width="18.86%" headers="mcps1.3.4.3.2.5.1.1 "><p id="dli_02_0296__p15697435152411">submission_time</p>
</td>
<td class="cellrowborder" valign="top" width="10.39%" headers="mcps1.3.4.3.2.5.1.2 "><p id="dli_02_0296__p2697133532417">No</p>
</td>
<td class="cellrowborder" valign="top" width="15.4%" headers="mcps1.3.4.3.2.5.1.3 "><p id="dli_02_0296__p9697183522415">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.35%" headers="mcps1.3.4.3.2.5.1.4 "><p id="dli_02_0296__p14130145342510">Submission time of a subjob, corresponding to the <strong id="dli_02_0296__b11930193165310">submissionTime</strong> of open-source Spark JobData.</p>
</td>
</tr>
<tr id="dli_02_0296__row17920913182010"><td class="cellrowborder" valign="top" width="18.86%" headers="mcps1.3.4.3.2.5.1.1 "><p id="dli_02_0296__p1669717351241">completion_time</p>
</td>
<td class="cellrowborder" valign="top" width="10.39%" headers="mcps1.3.4.3.2.5.1.2 "><p id="dli_02_0296__p1669714353249">No</p>
</td>
<td class="cellrowborder" valign="top" width="15.4%" headers="mcps1.3.4.3.2.5.1.3 "><p id="dli_02_0296__p136972354248">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.35%" headers="mcps1.3.4.3.2.5.1.4 "><p id="dli_02_0296__p62467272618">Completion time of a subjob, corresponding to the <strong id="dli_02_0296__b3922144485312">completionTime</strong> of the open-source Spark JobData.</p>
</td>
</tr>
<tr id="dli_02_0296__row3921313202012"><td class="cellrowborder" valign="top" width="18.86%" headers="mcps1.3.4.3.2.5.1.1 "><p id="dli_02_0296__p1169783518244">stage_ids</p>
</td>
<td class="cellrowborder" valign="top" width="10.39%" headers="mcps1.3.4.3.2.5.1.2 "><p id="dli_02_0296__p17697935132410">No</p>
</td>
<td class="cellrowborder" valign="top" width="15.4%" headers="mcps1.3.4.3.2.5.1.3 "><p id="dli_02_0296__p11697035112417">Array of Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.35%" headers="mcps1.3.4.3.2.5.1.4 "><p id="dli_02_0296__p1675351218266">Stage ID of the subjob, corresponding to the <strong id="dli_02_0296__b1555412210546">stageIds</strong> of the open-source spark JobData.</p>
</td>
</tr>
<tr id="dli_02_0296__row159211131207"><td class="cellrowborder" valign="top" width="18.86%" headers="mcps1.3.4.3.2.5.1.1 "><p id="dli_02_0296__p4698193572410">job_group</p>
</td>
<td class="cellrowborder" valign="top" width="10.39%" headers="mcps1.3.4.3.2.5.1.2 "><p id="dli_02_0296__p2069818356249">No</p>
</td>
<td class="cellrowborder" valign="top" width="15.4%" headers="mcps1.3.4.3.2.5.1.3 "><p id="dli_02_0296__p13698635192411">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.35%" headers="mcps1.3.4.3.2.5.1.4 "><p id="dli_02_0296__p6908141912610">ID of a DLI job, corresponding to the <strong id="dli_02_0296__b11554185313540">jobGroup</strong> of open-source Spark JobData.</p>
</td>
</tr>
<tr id="dli_02_0296__row1921151312201"><td class="cellrowborder" valign="top" width="18.86%" headers="mcps1.3.4.3.2.5.1.1 "><p id="dli_02_0296__p1569823582414">status</p>
</td>
<td class="cellrowborder" valign="top" width="10.39%" headers="mcps1.3.4.3.2.5.1.2 "><p id="dli_02_0296__p10698335152417">No</p>
</td>
<td class="cellrowborder" valign="top" width="15.4%" headers="mcps1.3.4.3.2.5.1.3 "><p id="dli_02_0296__p6698143516249">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.35%" headers="mcps1.3.4.3.2.5.1.4 "><p id="dli_02_0296__p17636285267">Subjob status, corresponding to the <strong id="dli_02_0296__b129941713175515">status</strong> of open-source spark JobData.</p>
</td>
</tr>
<tr id="dli_02_0296__row014703822312"><td class="cellrowborder" valign="top" width="18.86%" headers="mcps1.3.4.3.2.5.1.1 "><p id="dli_02_0296__p769823511246">num_tasks</p>
</td>
<td class="cellrowborder" valign="top" width="10.39%" headers="mcps1.3.4.3.2.5.1.2 "><p id="dli_02_0296__p169814353247">No</p>
</td>
<td class="cellrowborder" valign="top" width="15.4%" headers="mcps1.3.4.3.2.5.1.3 "><p id="dli_02_0296__p769833520245">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.35%" headers="mcps1.3.4.3.2.5.1.4 "><p id="dli_02_0296__p757483411263">Number of subjobs, corresponding to <strong id="dli_02_0296__b17322159185515">numTasks</strong> of the open-source Spark JobData.</p>
</td>
</tr>
<tr id="dli_02_0296__row114703812233"><td class="cellrowborder" valign="top" width="18.86%" headers="mcps1.3.4.3.2.5.1.1 "><p id="dli_02_0296__p11698735102412">num_active_tasks</p>
</td>
<td class="cellrowborder" valign="top" width="10.39%" headers="mcps1.3.4.3.2.5.1.2 "><p id="dli_02_0296__p13698203512244">No</p>
</td>
<td class="cellrowborder" valign="top" width="15.4%" headers="mcps1.3.4.3.2.5.1.3 "><p id="dli_02_0296__p1269883518245">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.35%" headers="mcps1.3.4.3.2.5.1.4 "><p id="dli_02_0296__p1411616429269">Number of running tasks in a subjob, corresponding to <strong id="dli_02_0296__b335492112564">numActiveTasks</strong> of the open-source Spark JobData.</p>
</td>
</tr>
<tr id="dli_02_0296__row114823815233"><td class="cellrowborder" valign="top" width="18.86%" headers="mcps1.3.4.3.2.5.1.1 "><p id="dli_02_0296__p1769943517245">num_completed_tasks</p>
</td>
<td class="cellrowborder" valign="top" width="10.39%" headers="mcps1.3.4.3.2.5.1.2 "><p id="dli_02_0296__p16745185593219">No</p>
</td>
<td class="cellrowborder" valign="top" width="15.4%" headers="mcps1.3.4.3.2.5.1.3 "><p id="dli_02_0296__p136998356247">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.35%" headers="mcps1.3.4.3.2.5.1.4 "><p id="dli_02_0296__p5910653122615">Number of tasks that have been completed in a subjob, corresponding to <strong id="dli_02_0296__b7211548135619">numCompletedTasks</strong> of open-source Spark JobData.</p>
</td>
</tr>
<tr id="dli_02_0296__row141481838112318"><td class="cellrowborder" valign="top" width="18.86%" headers="mcps1.3.4.3.2.5.1.1 "><p id="dli_02_0296__p166991354248">num_skipped_tasks</p>
</td>
<td class="cellrowborder" valign="top" width="10.39%" headers="mcps1.3.4.3.2.5.1.2 "><p id="dli_02_0296__p97459556324">No</p>
</td>
<td class="cellrowborder" valign="top" width="15.4%" headers="mcps1.3.4.3.2.5.1.3 "><p id="dli_02_0296__p76994353246">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.35%" headers="mcps1.3.4.3.2.5.1.4 "><p id="dli_02_0296__p152493052810">Number of tasks skipped in a subjob, corresponding to <strong id="dli_02_0296__b85266616577">numSkippedTasks</strong> of open-source Spark JobData.</p>
</td>
</tr>
<tr id="dli_02_0296__row2014933810231"><td class="cellrowborder" valign="top" width="18.86%" headers="mcps1.3.4.3.2.5.1.1 "><p id="dli_02_0296__p2699113542413">num_failed_tasks</p>
</td>
<td class="cellrowborder" valign="top" width="10.39%" headers="mcps1.3.4.3.2.5.1.2 "><p id="dli_02_0296__p674515555325">No</p>
</td>
<td class="cellrowborder" valign="top" width="15.4%" headers="mcps1.3.4.3.2.5.1.3 "><p id="dli_02_0296__p3699113532417">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.35%" headers="mcps1.3.4.3.2.5.1.4 "><p id="dli_02_0296__p2055943522819">Number of subtasks that fail to be skipped, corresponding to <strong id="dli_02_0296__b3559112925710">numFailedTasks</strong> of open-source Spark JobData.</p>
</td>
</tr>
<tr id="dli_02_0296__row1014916388236"><td class="cellrowborder" valign="top" width="18.86%" headers="mcps1.3.4.3.2.5.1.1 "><p id="dli_02_0296__p07001135122418">num_killed_tasks</p>
</td>
<td class="cellrowborder" valign="top" width="10.39%" headers="mcps1.3.4.3.2.5.1.2 "><p id="dli_02_0296__p17745755173212">No</p>
</td>
<td class="cellrowborder" valign="top" width="15.4%" headers="mcps1.3.4.3.2.5.1.3 "><p id="dli_02_0296__p370010352242">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.35%" headers="mcps1.3.4.3.2.5.1.4 "><p id="dli_02_0296__p53971240172815">Number of tasks killed in the subjob, corresponding to <strong id="dli_02_0296__b17743846105711">numKilledTasks</strong> of the open-source Spark JobData.</p>
</td>
</tr>
<tr id="dli_02_0296__row11491938112311"><td class="cellrowborder" valign="top" width="18.86%" headers="mcps1.3.4.3.2.5.1.1 "><p id="dli_02_0296__p147001735152419">num_completed_indices</p>
</td>
<td class="cellrowborder" valign="top" width="10.39%" headers="mcps1.3.4.3.2.5.1.2 "><p id="dli_02_0296__p1745555173220">No</p>
</td>
<td class="cellrowborder" valign="top" width="15.4%" headers="mcps1.3.4.3.2.5.1.3 "><p id="dli_02_0296__p4700133592411">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.35%" headers="mcps1.3.4.3.2.5.1.4 "><p id="dli_02_0296__p2797154642811">Subjob completion index, corresponding to the <strong id="dli_02_0296__b72129301589">numCompletedIndices</strong> of the open-source Spark JobData.</p>
</td>
</tr>
<tr id="dli_02_0296__row8150153811234"><td class="cellrowborder" valign="top" width="18.86%" headers="mcps1.3.4.3.2.5.1.1 "><p id="dli_02_0296__p7700103515249">num_active_stages</p>
</td>
<td class="cellrowborder" valign="top" width="10.39%" headers="mcps1.3.4.3.2.5.1.2 "><p id="dli_02_0296__p1674585543212">No</p>
</td>
<td class="cellrowborder" valign="top" width="15.4%" headers="mcps1.3.4.3.2.5.1.3 "><p id="dli_02_0296__p97005355249">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.35%" headers="mcps1.3.4.3.2.5.1.4 "><p id="dli_02_0296__p382075312810">Number of stages that are running in the subjob, corresponding to <strong id="dli_02_0296__b1221535625818">numActiveStages</strong> of the open-source Spark JobData.</p>
</td>
</tr>
<tr id="dli_02_0296__row1490520567232"><td class="cellrowborder" valign="top" width="18.86%" headers="mcps1.3.4.3.2.5.1.1 "><p id="dli_02_0296__p187001435172414">num_completed_stages</p>
</td>
<td class="cellrowborder" valign="top" width="10.39%" headers="mcps1.3.4.3.2.5.1.2 "><p id="dli_02_0296__p97468550326">No</p>
</td>
<td class="cellrowborder" valign="top" width="15.4%" headers="mcps1.3.4.3.2.5.1.3 "><p id="dli_02_0296__p10701173519242">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.35%" headers="mcps1.3.4.3.2.5.1.4 "><p id="dli_02_0296__p15317100142916">Number of stages that have been completed in the subjob, corresponding to <strong id="dli_02_0296__b14855191011598">numCompletedStages</strong> of the open-source Spark JobData.</p>
</td>
</tr>
<tr id="dli_02_0296__row16905115611239"><td class="cellrowborder" valign="top" width="18.86%" headers="mcps1.3.4.3.2.5.1.1 "><p id="dli_02_0296__p9701173522414">num_skipped_stages</p>
</td>
<td class="cellrowborder" valign="top" width="10.39%" headers="mcps1.3.4.3.2.5.1.2 "><p id="dli_02_0296__p107461455153215">No</p>
</td>
<td class="cellrowborder" valign="top" width="15.4%" headers="mcps1.3.4.3.2.5.1.3 "><p id="dli_02_0296__p10701103516241">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.35%" headers="mcps1.3.4.3.2.5.1.4 "><p id="dli_02_0296__p38224517296">Number of stages skipped in the subjob, corresponding to <strong id="dli_02_0296__b145363280596">numSkippedStages</strong> of the open-source Spark JobData.</p>
</td>
</tr>
<tr id="dli_02_0296__row49061656162312"><td class="cellrowborder" valign="top" width="18.86%" headers="mcps1.3.4.3.2.5.1.1 "><p id="dli_02_0296__p770114352247">num_failed_stages</p>
</td>
<td class="cellrowborder" valign="top" width="10.39%" headers="mcps1.3.4.3.2.5.1.2 "><p id="dli_02_0296__p7746855173216">No</p>
</td>
<td class="cellrowborder" valign="top" width="15.4%" headers="mcps1.3.4.3.2.5.1.3 "><p id="dli_02_0296__p1770113510249">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.35%" headers="mcps1.3.4.3.2.5.1.4 "><p id="dli_02_0296__p17222121192919">Number of failed stages in a subjob, corresponding to <strong id="dli_02_0296__b13995134325912">numFailedStages</strong> of the open-source Spark JobData.</p>
</td>
</tr>
<tr id="dli_02_0296__row1090618569234"><td class="cellrowborder" valign="top" width="18.86%" headers="mcps1.3.4.3.2.5.1.1 "><p id="dli_02_0296__p187018359247">killed_tasks_summary</p>
</td>
<td class="cellrowborder" valign="top" width="10.39%" headers="mcps1.3.4.3.2.5.1.2 "><p id="dli_02_0296__p77465555321">No</p>
</td>
<td class="cellrowborder" valign="top" width="15.4%" headers="mcps1.3.4.3.2.5.1.3 "><p id="dli_02_0296__p117011235202418">Map&lt;string,integer&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="55.35%" headers="mcps1.3.4.3.2.5.1.4 "><p id="dli_02_0296__p642717189290">Summary of the killed tasks in the subjob, corresponding to <strong id="dli_02_0296__b1636126401">killedTasksSummary</strong> of open-source spark JobData.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="dli_02_0296__section119541416192"><h4 class="sectiontitle">Example Request</h4><p id="dli_02_0296__p18378451191">None</p>
</div>
<div class="section" id="dli_02_0296__section2952393915123"><h4 class="sectiontitle">Example Response</h4><pre class="screen" id="dli_02_0296__screen424765991535">{
"is_success": true,
"message": "",
"job_id": "85798b38-ae44-48eb-bb90-7cf0dcdafe7b",
"status": "RUNNING",
"sub_job_id": 0,
"progress": 0,
"sub_jobs": [
{
"id": 0,
"name": "runJob at FileFormatWriter.scala:266",
"submission_time": "Mon Jul 27 17:24:03 CST 2020",
"stage_ids": [
0
],
"job_group": "85798b38-ae44-48eb-bb90-7cf0dcdafe7b",
"status": "RUNNING",
"num_tasks": 1,
"num_active_tasks": 1,
"num_completed_tasks": 0,
"num_skipped_tasks": 0,
"num_failed_tasks": 0,
"num_killed_tasks": 0,
"num_completed_indices": 0,
"num_active_stages": 1,
"num_completed_stages": 0,
"num_skipped_stages": 0,
"num_failed_stages": 0
}
]
}</pre>
</div>
<div class="section" id="dli_02_0296__sf39cfd445ad24e9e82754fcb0027179d"><h4 class="sectiontitle">Status Codes</h4><p id="dli_02_0296__a04144ca3a08e4576b386c6a98f43a2ae"><a href="#dli_02_0296__tb12870f1c5f24b27abd55ca24264af36">Table 4</a> describes the status code.</p>
<div class="tablenoborder"><a name="dli_02_0296__tb12870f1c5f24b27abd55ca24264af36"></a><a name="tb12870f1c5f24b27abd55ca24264af36"></a><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0296__tb12870f1c5f24b27abd55ca24264af36" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Status codes</caption><thead align="left"><tr id="dli_02_0296__r8d54231f95b14c01a5e55e95f3b2e838"><th align="left" class="cellrowborder" valign="top" width="30%" id="mcps1.3.7.3.2.3.1.1"><p id="dli_02_0296__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_0296__aea1d3bd107bb4c499da79a88832d256c">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dli_02_0296__r211ad4eb571d4d938e5579998723174e"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.7.3.2.3.1.1 "><p id="dli_02_0296__a3153e07b3a9749adba92599fe6628fbf">200</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.7.3.2.3.1.2 "><p id="dli_02_0296__p104431642124811">The query is successful.</p>
</td>
</tr>
<tr id="dli_02_0296__row44937531727"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.7.3.2.3.1.1 "><p id="dli_02_0296__p184941532219">400</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.7.3.2.3.1.2 "><p id="dli_02_0296__p2049413539219">Request error.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="dli_02_0296__section13596141025715"><h4 class="sectiontitle">Error Codes</h4><p id="dli_02_0296__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 class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0296__table847819307387" frame="border" border="1" rules="all"><caption><b>Table 5 </b>Error codes</caption><thead align="left"><tr id="dli_02_0296__row2479163016383"><th align="left" class="cellrowborder" valign="top" width="30%" id="mcps1.3.8.3.2.3.1.1"><p id="dli_02_0296__p114796309389">Error Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="70%" id="mcps1.3.8.3.2.3.1.2"><p id="dli_02_0296__p1647973053817">Error Message</p>
</th>
</tr>
</thead>
<tbody><tr id="dli_02_0296__row1047920308387"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.8.3.2.3.1.1 "><p id="dli_02_0296__p598615916423">DLI.0999</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.8.3.2.3.1.2 "><p id="dli_02_0296__p8978156124220">The queue backend version is too old or the queue is busy.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dli_02_0158.html">SQL Job-related APIs</a></div>
</div>
</div>