doc-exports/docs/mrs/api-ref/mrs_02_0046.html
Yang, Tong bd2b57f749 MRS API 2.0.38.SP20 version
Reviewed-by: gtema <artem.goncharov@gmail.com>
Co-authored-by: Yang, Tong <yangtong2@huawei.com>
Co-committed-by: Yang, Tong <yangtong2@huawei.com>
2022-11-16 15:06:08 +00:00

441 lines
30 KiB
HTML

<a name="mrs_02_0046"></a><a name="mrs_02_0046"></a>
<h1 class="topictitle1">Querying the exe Object List of Jobs</h1>
<div id="body1484210107928"><div class="section" id="mrs_02_0046__section40666287163540"><h4 class="sectiontitle">Function</h4><p id="mrs_02_0046__p39994334163542">This API is used to query the exe object list of all jobs. This API is incompatible with Sahara.</p>
</div>
<div class="section" id="mrs_02_0046__section25682805163556"><h4 class="sectiontitle">URI</h4><ul id="mrs_02_0046__ul2095591163640"><li id="mrs_02_0046__li10997729163640">Format<p id="mrs_02_0046__p53372870163653"><a name="mrs_02_0046__li10997729163640"></a><a name="li10997729163640"></a>GET /v1.1/{project_id}/job-exes</p>
</li><li id="mrs_02_0046__li17220269163646">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="mrs_02_0046__table49499141194754" frame="border" border="1" rules="all"><caption><b>Table 1 </b>URI parameter description</caption><thead align="left"><tr id="mrs_02_0046__row33700024194754"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.2.2.2.1.2.4.1.1"><p id="mrs_02_0046__p16571835194812">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.2.2.2.1.2.4.1.2"><p id="mrs_02_0046__p141410194812">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.2.2.2.1.2.4.1.3"><p id="mrs_02_0046__p11454278194812">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="mrs_02_0046__row12931900144556"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.2.2.1.2.4.1.1 "><p id="mrs_02_0046__p40851019144556">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.2.2.1.2.4.1.2 "><p id="mrs_02_0046__p20598275144556">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.2.2.2.1.2.4.1.3 "><p id="mrs_02_0046__p57847563144556">Project ID. For details on how to obtain the project ID, see <a href="mrs_02_0011.html">Obtaining a Project ID</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
<div class="section" id="mrs_02_0046__section7976792193238"><h4 class="sectiontitle">Request</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="mrs_02_0046__table744681812241" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request parameter description</caption><thead align="left"><tr id="mrs_02_0046__row1646381812415"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.3.2.2.5.1.1"><p id="mrs_02_0046__p9469121862417">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.3.2.2.5.1.2"><p id="mrs_02_0046__p164737189243">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.3.2.2.5.1.3"><p id="mrs_02_0046__p89089312436">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="45%" id="mcps1.3.3.2.2.5.1.4"><p id="mrs_02_0046__p1147781811247">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="mrs_02_0046__row549931872410"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.3.2.2.5.1.1 "><p id="mrs_02_0046__p1350313183249">cluster_id</p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.2.2.5.1.2 "><p id="mrs_02_0046__p9512718122420">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.2.2.5.1.3 "><p id="mrs_02_0046__p11908133204314">String</p>
</td>
<td class="cellrowborder" valign="top" width="45%" headers="mcps1.3.3.2.2.5.1.4 "><p id="mrs_02_0046__p175165184247">Cluster ID</p>
</td>
</tr>
<tr id="mrs_02_0046__row3518111872417"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.3.2.2.5.1.1 "><p id="mrs_02_0046__p175226185244">id</p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.2.2.5.1.2 "><p id="mrs_02_0046__p1052614185249">No</p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.2.2.5.1.3 "><p id="mrs_02_0046__p9908193184311">String</p>
</td>
<td class="cellrowborder" valign="top" width="45%" headers="mcps1.3.3.2.2.5.1.4 "><p id="mrs_02_0046__p1253014182247">Job execution object ID</p>
</td>
</tr>
<tr id="mrs_02_0046__row195321018132411"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.3.2.2.5.1.1 "><p id="mrs_02_0046__p18536718122413">page_size</p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.2.2.5.1.2 "><p id="mrs_02_0046__p1154013189244">No</p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.2.2.5.1.3 "><p id="mrs_02_0046__p2090833154314">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="45%" headers="mcps1.3.3.2.2.5.1.4 "><p id="mrs_02_0046__p8543191819246">Maximum number of jobs displayed on a page</p>
<p id="mrs_02_0046__p20545151819243">Value range: 1 to 100</p>
</td>
</tr>
<tr id="mrs_02_0046__row854641812412"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.3.2.2.5.1.1 "><p id="mrs_02_0046__p6548111802411">current_page</p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.2.2.5.1.2 "><p id="mrs_02_0046__p11552131802411">No</p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.2.2.5.1.3 "><p id="mrs_02_0046__p59081935439">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="45%" headers="mcps1.3.3.2.2.5.1.4 "><p id="mrs_02_0046__p4556518152415">Current page number</p>
</td>
</tr>
<tr id="mrs_02_0046__row16558111818244"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.3.2.2.5.1.1 "><p id="mrs_02_0046__p656351812245">job_name</p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.2.2.5.1.2 "><p id="mrs_02_0046__p17567181816245">No</p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.2.2.5.1.3 "><p id="mrs_02_0046__p8908193174318">String</p>
</td>
<td class="cellrowborder" valign="top" width="45%" headers="mcps1.3.3.2.2.5.1.4 "><p id="mrs_02_0046__p157011187243">Job name</p>
</td>
</tr>
<tr id="mrs_02_0046__row115721118152410"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.3.2.2.5.1.1 "><p id="mrs_02_0046__p1157581872418">state</p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.2.2.5.1.2 "><p id="mrs_02_0046__p10579618192411">No</p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.2.2.5.1.3 "><p id="mrs_02_0046__p59085314317">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="45%" headers="mcps1.3.3.2.2.5.1.4 "><p id="mrs_02_0046__p1158391852414">Job status code</p>
<ul id="mrs_02_0046__ul15591818132418"><li id="mrs_02_0046__li165931718112418">-1: Terminated</li><li id="mrs_02_0046__li196051618112410">2: Running</li><li id="mrs_02_0046__li560941816247">3: Completed</li><li id="mrs_02_0046__li20616121832416">4: Abnormal</li></ul>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="mrs_02_0046__section38599577193858"><h4 class="sectiontitle">Response</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="mrs_02_0046__table5154210817547" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Response parameter description</caption><thead align="left"><tr id="mrs_02_0046__row5182537317547"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.2.2.4.1.1"><p id="mrs_02_0046__p32664405195759">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.2.2.4.1.2"><p id="mrs_02_0046__p28269015195759">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.4.2.2.4.1.3"><p id="mrs_02_0046__p5931773195759">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="mrs_02_0046__row36805501785"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.2.2.4.1.1 "><p id="mrs_02_0046__p3743739718911">totalRecord</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.2.2.4.1.2 "><p id="mrs_02_0046__p6118898618911">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.2.2.4.1.3 "><p id="mrs_02_0046__p3898511218911">Total number of jobs in a list</p>
</td>
</tr>
<tr id="mrs_02_0046__row2282909519515"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.2.2.4.1.1 "><p id="mrs_02_0046__p4404627518911">job_executions</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.2.2.4.1.2 "><p id="mrs_02_0046__p2387674618911">Array</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.2.2.4.1.3 "><p id="mrs_02_0046__p323153675414">Job list parameter</p>
<p id="mrs_02_0046__p5376380218911">For details, see <a href="#mrs_02_0046__table3315199519550">Table 4</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="mrs_02_0046__table3315199519550"></a><a name="table3315199519550"></a><table cellpadding="4" cellspacing="0" summary="" id="mrs_02_0046__table3315199519550" frame="border" border="1" rules="all"><caption><b>Table 4 </b><strong id="mrs_02_0046__b95902417541">job_executions</strong> parameter description</caption><thead align="left"><tr id="mrs_02_0046__row578377519550"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.3.2.4.1.1"><p id="mrs_02_0046__p38420820195833">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.3.2.4.1.2"><p id="mrs_02_0046__p18107258195833">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.4.3.2.4.1.3"><p id="mrs_02_0046__p57401825195833">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="mrs_02_0046__row4877039619550"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0046__p1036349219556">id</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0046__p3507660919556">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0046__p3191186819556">Job ID</p>
</td>
</tr>
<tr id="mrs_02_0046__row5452608519550"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0046__p492591519556">create_at</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0046__p65547675193741">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0046__p46076642191954">Creation time, which is a 13-bit timestamp.</p>
</td>
</tr>
<tr id="mrs_02_0046__row90837019550"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0046__p646916119550">update_at</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0046__p31855594195115">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0046__p9461207191918">Update time, which is a 13-bit timestamp.</p>
</td>
</tr>
<tr id="mrs_02_0046__row5085722819550"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0046__p2579483119550">tenant_id</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0046__p5844159719550">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0046__p1768719515356">Project ID. For details on how to obtain the project ID, see <a href="mrs_02_0011.html">Obtaining a Project ID</a>.</p>
</td>
</tr>
<tr id="mrs_02_0046__row5690483719550"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0046__p4588905219550">job_id</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0046__p44975318193910">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0046__p3001481419550">Job ID of the YARN</p>
</td>
</tr>
<tr id="mrs_02_0046__row169787619550"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0046__p331026719550">job_name</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0046__p42427159193910">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0046__p2005248319550">Job name</p>
</td>
</tr>
<tr id="mrs_02_0046__row4625462019550"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0046__p5563670019550">start_time</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0046__p29918955193921">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0046__p2026254620146">Start time of job execution, which is a 13-bit timestamp.</p>
</td>
</tr>
<tr id="mrs_02_0046__row2176045219550"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0046__p1776620019550">end_time</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0046__p37327910193921">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0046__p5041299620146">End time of job execution, which is a 13-bit timestamp.</p>
</td>
</tr>
<tr id="mrs_02_0046__row6143635119550"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0046__p1028852819550">cluster_id</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0046__p5862431019550">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0046__p2281683220216">Cluster ID of a job</p>
</td>
</tr>
<tr id="mrs_02_0046__row5588512519550"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0046__p3040126119550">group_id</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0046__p1380124819410">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0046__p1891440820216">Group ID of a job</p>
</td>
</tr>
<tr id="mrs_02_0046__row2461506319550"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0046__p4766307219550">jar_path</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0046__p1405183219410">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0046__p34979288192243">Path of the <strong id="mrs_02_0046__b1429071372620">.jar</strong> file or <strong id="mrs_02_0046__b122901213132611">.sql</strong> file for program execution</p>
</td>
</tr>
<tr id="mrs_02_0046__row3958047819550"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0046__p5190214619550">input</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0046__p1627104919410">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0046__p4996084420258">Address for inputting data</p>
</td>
</tr>
<tr id="mrs_02_0046__row1217098519727"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0046__p4632576819727">output</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0046__p989452319410">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0046__p852868320258">Address for outputting data</p>
</td>
</tr>
<tr id="mrs_02_0046__row3799281119842"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0046__p5751881819842">job_log</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0046__p3324274119410">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0046__p4477291020258">Address for storing job logs</p>
</td>
</tr>
<tr id="mrs_02_0046__row399573611990"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0046__p153208431990">job_type</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0046__p580869611990">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0046__p74233721990">Job type code</p>
<ul id="mrs_02_0046__ul52805946192537"><li id="mrs_02_0046__li31653916192537">1: MapReduce</li><li id="mrs_02_0046__li46520133192537">2: Spark</li><li id="mrs_02_0046__li214592192537">3: Hive Script</li><li id="mrs_02_0046__li54977613192537">4: HiveQL (not supported currently)</li><li id="mrs_02_0046__li48940220192537">5: DistCp</li><li id="mrs_02_0046__li29152095192537">6: Spark Script</li><li id="mrs_02_0046__li59710932192537">7: Spark SQL (not supported in this API currently)</li></ul>
</td>
</tr>
<tr id="mrs_02_0046__row4199685319913"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0046__p4630192719913">file_action</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0046__p5222674819913">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0046__p250820819913">Data import and export</p>
</td>
</tr>
<tr id="mrs_02_0046__row4714693819921"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0046__p6080567119921">arguments</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0046__p5092218519921">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0046__p10094543192658">Key parameter for program execution. The parameter is specified by the function of the user's internal program. MRS is only responsible for loading the parameter. This parameter can be empty.</p>
</td>
</tr>
<tr id="mrs_02_0046__row6009214319943"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0046__p3562540819943">hql</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0046__p6523786219943">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0046__p4977550119943">HiveQL statement</p>
</td>
</tr>
<tr id="mrs_02_0046__row1859114019956"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0046__p2948735219956">job_state</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0046__p5877310219956">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0046__p22201137165828">Job status code</p>
<ul id="mrs_02_0046__ul65592507165828"><li id="mrs_02_0046__li53461652165828">-1: Terminated</li><li id="mrs_02_0046__li35426527165828">2: Running</li><li id="mrs_02_0046__li50403291165828">3: Completed</li><li id="mrs_02_0046__li50976443165828">4: Abnormal</li></ul>
</td>
</tr>
<tr id="mrs_02_0046__row51998636191052"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0046__p51139963191052">job_final_status</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0046__p52088375191052">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0046__p25388152145857">Final job status.</p>
<ul id="mrs_02_0046__ul27166780145857"><li id="mrs_02_0046__li43174433145857">0: unfinished</li><li id="mrs_02_0046__li53025585145857">1: terminated due to an execution error</li><li id="mrs_02_0046__li7468219145857">2: executed successfully</li><li id="mrs_02_0046__li105114145857">3: canceled</li></ul>
</td>
</tr>
<tr id="mrs_02_0046__row4584195819116"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0046__p2221115219116">hive_script_path</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0046__p3402997419116">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0046__p496448119116">Address of the Hive script</p>
</td>
</tr>
<tr id="mrs_02_0046__row7998612191113"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0046__p43907848191113">create_by</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0046__p48146760191113">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0046__p7573477191113">User ID for creating jobs</p>
</td>
</tr>
<tr id="mrs_02_0046__row46507344191132"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0046__p8998499191132">finished_step</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0046__p50461418191132">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0046__p60843054191132">Number of completed steps</p>
</td>
</tr>
<tr id="mrs_02_0046__row63007578191145"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0046__p3340165191145">job_main_id</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0046__p4495656219439">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0046__p1759059320856">Main ID of a job</p>
</td>
</tr>
<tr id="mrs_02_0046__row10088168191225"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0046__p11835266191225">job_step_id</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0046__p1667749119439">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0046__p1438564520856">Step ID of a job</p>
</td>
</tr>
<tr id="mrs_02_0046__row54963709191240"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0046__p22875416191240">postpone_at</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0046__p30188072191240">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0046__p4057938120917">Delay time, which is a 13-bit timestamp.</p>
</td>
</tr>
<tr id="mrs_02_0046__row20295505191252"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0046__p33323170191252">step_name</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0046__p59751102191252">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0046__p8001113191252">Step name of a job</p>
</td>
</tr>
<tr id="mrs_02_0046__row31355889191259"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0046__p56799042191259">step_num</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0046__p2995550191259">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0046__p51527704201027">Number of steps</p>
</td>
</tr>
<tr id="mrs_02_0046__row3898483219138"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0046__p365478919138">task_num</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0046__p2120762919138">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0046__p34076263201027">Number of tasks</p>
</td>
</tr>
<tr id="mrs_02_0046__row16929053191331"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0046__p29076056191331">update_by</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0046__p44613171191331">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0046__p56897059191331">User ID for updating jobs</p>
</td>
</tr>
<tr id="mrs_02_0046__row60220269191339"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0046__p46003592191339">spend_time</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0046__p41009304191339">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0046__p33419357191339">Duration of job execution (unit: s)</p>
</td>
</tr>
<tr id="mrs_02_0046__row25391145191345"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0046__p43416868191345">step_seq</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0046__p48053375191345">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0046__p9263191345">Step sequence of a job</p>
</td>
</tr>
<tr id="mrs_02_0046__row12938423191358"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0046__p41379368191358">progress</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0046__p34684936191358">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0046__p58016455191358">Job execution progress</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="mrs_02_0046__section1210015461189"><h4 class="sectiontitle">Example</h4><ul id="mrs_02_0046__ul1958913536182"><li id="mrs_02_0046__li1558945321814">Example request<pre class="screen" id="mrs_02_0046__screen9617448215">GET/v1.1/{project_id}/job-exes?page_size=10&amp;current_page=1&amp;state=3&amp;job_name=myfirstjob&amp;clusterId=20ca8601-72a2-4570-b788-2a20fec81a95</pre>
</li><li id="mrs_02_0046__li543710159193">Example response<pre class="screen" id="mrs_02_0046__screen3738391144450">{
"totalRecord": 14,
"job_executions": [
{
"id": "669476bd-89d2-45aa-8f1a-872d16de377e",
"create_at": 1484641003707,
"update_at": 1484641003707,
"tenant_id": "3f99e3319a8943ceb15c584f3325d064",
"job_id": "",
"job_name": "myfirstjob",
"start_time": 1484641003707,
"end_time": null,
"cluster_id": "2b460e01-3351-4170-b0a7-57b9dd5ffef3",
"group_id": "669476bd-89d2-45aa-8f1a-872d16de377e",
"jar_path": "s3a://jp-test1/program/hadoop-mapreduce-examples-2.4.1.jar",
"input": "s3a://jp-test1/input/",
"output": "s3a://jp-test1/output/",
"job_log": "s3a://jp-test1/joblogs/",
"job_type": 1,
"file_action": "",
"arguments": "wordcount",
"hql": "",
"job_state": 2,
"job_final_status": 1,
"hive_script_path": null,
"create_by": "3f99e3319a8943ceb15c584f3325d064",
"finished_step": 0,
"job_main_id": "",
"job_step_id": "",
"postpone_at": 1484641003174,
"step_name": "",
"step_num": 0,
"task_num": 0,
"update_by": "3f99e3319a8943ceb15c584f3325d064",
"spend_time": null,
"step_seq": 222,
"progress": "first progress"
}
]
}</pre>
</li></ul>
</div>
<div class="section" id="mrs_02_0046__section7365446163631"><h4 class="sectiontitle">Status Code</h4><p id="mrs_02_0046__p5547365016031"><a href="#mrs_02_0046__table1584477916050">Table 5</a> describes the status code of this API.</p>
<div class="tablenoborder"><a name="mrs_02_0046__table1584477916050"></a><a name="table1584477916050"></a><table cellpadding="4" cellspacing="0" summary="" id="mrs_02_0046__table1584477916050" frame="border" border="1" rules="all"><caption><b>Table 5 </b>Status code</caption><thead align="left"><tr id="mrs_02_0046__row1339492016050"><th align="left" class="cellrowborder" valign="top" width="30%" id="mcps1.3.6.3.2.3.1.1"><p id="mrs_02_0046__p3411176516050">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="70%" id="mcps1.3.6.3.2.3.1.2"><p id="mrs_02_0046__p1158961516050">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="mrs_02_0046__row3719767816050"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.6.3.2.3.1.1 "><p id="mrs_02_0046__p6428795219421">200</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.6.3.2.3.1.2 "><p id="mrs_02_0046__p1800220919421">The exe object list of jobs is queried successfully.</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="mrs_02_0046__p107171127175212">For the description about error status codes, see <a href="mrs_02_0015.html">Status Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="mrs_02_0039.html">Job Object APIs (V1, Not Recommended)</a></div>
</div>
</div>