Files
doc-exports/docs/cce/api-ref/ListJobs.html
qiujiandong1 affc0093ff CCE API 20251107 version
Reviewed-by: Gergo-Bence Lorincz <a200452876@noreply.gitea.eco.tsi-dev.otc-service.com>
Co-authored-by: qiujiandong1 <qiujiandong1@huawei.com>
Co-committed-by: qiujiandong1 <qiujiandong1@huawei.com>
2026-02-17 10:09:34 +00:00

470 lines
32 KiB
HTML

<a name="ListJobs"></a><a name="ListJobs"></a>
<h1 class="topictitle1">Obtaining the Job List</h1>
<div id="body32001227"><div class="section" id="ListJobs__section16511171814505"><h4 class="sectiontitle">Function</h4><p id="ListJobs__p19511161816501">This API is used to obtain all jobs in a specified project.</p>
</div>
<div class="section" id="ListJobs__section951141885013"><h4 class="sectiontitle">URI</h4><p id="ListJobs__p18511918155019">GET /api/v2/projects/{project_id}/jobs</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="ListJobs__table12512191814502" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Path Parameters</caption><thead align="left"><tr id="ListJobs__row16511111825018"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.1"><p id="ListJobs__p115121118135019">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.2"><p id="ListJobs__p1751210183508">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.3"><p id="ListJobs__p17512111885011">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.2.3.2.5.1.4"><p id="ListJobs__p16512181810507">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="ListJobs__row151161875013"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.1 "><p id="ListJobs__p95123187507">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.2 "><p id="ListJobs__p175125182501">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.3 "><p id="ListJobs__p105126188507">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.3.2.5.1.4 "><p id="ListJobs__p17512151825014"><strong id="ListJobs__b1512151865013">Details</strong>:</p>
<p id="ListJobs__p751261825014">Project ID. For details about how to obtain the value, see <a href="cce_02_0271.html">How to Obtain Parameters in the API URI</a>.</p>
<p id="ListJobs__p15512718105010"><strong id="ListJobs__b251211825012">Constraints</strong>:</p>
<p id="ListJobs__p25122018125012">None</p>
<p id="ListJobs__p551313185506"><strong id="ListJobs__b1751341810507">Options</strong>:</p>
<p id="ListJobs__p951341815012">Project IDs of the account</p>
<p id="ListJobs__p151361815013"><strong id="ListJobs__b12513718105014">Default value</strong>:</p>
<p id="ListJobs__p751351825015">N/A</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="ListJobs__section551381875010"><h4 class="sectiontitle">Request Parameters</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="ListJobs__en-us_topic_0000002517023859_HeaderParameter" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request header parameters</caption><thead align="left"><tr id="ListJobs__row10513618135017"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.1"><p id="ListJobs__p10513118115018">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.2"><p id="ListJobs__p751431812501">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.3"><p id="ListJobs__p14514131875015">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.2.2.5.1.4"><p id="ListJobs__p155141418195017">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="ListJobs__row95134181506"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="ListJobs__p17514918185011">Content-Type</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="ListJobs__p45141818125018">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="ListJobs__p5514318105017">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="ListJobs__p1151481865013"><strong id="ListJobs__b15141018195019">Details</strong>:</p>
<p id="ListJobs__p95146181506">The request body type or format</p>
<p id="ListJobs__p551417184505"><strong id="ListJobs__b1051421885017">Constraints</strong>:</p>
<p id="ListJobs__p6514141816505">The GET method is not verified.</p>
<p id="ListJobs__p951421812502"><strong id="ListJobs__b1851471819508">Options</strong>:</p>
<ul id="ListJobs__ul10514418195019"><li id="ListJobs__li7514111855015"><p id="ListJobs__p15514201885016"><a name="ListJobs__li7514111855015"></a><a name="li7514111855015"></a>application/json</p>
</li><li id="ListJobs__li20514218185015"><p id="ListJobs__p75141318135014"><a name="ListJobs__li20514218185015"></a><a name="li20514218185015"></a>application/json;charset=utf-8</p>
</li><li id="ListJobs__li4514118165019"><p id="ListJobs__p205151918135017"><a name="ListJobs__li4514118165019"></a><a name="li4514118165019"></a>application/x-pem-file</p>
</li><li id="ListJobs__li19515151845019"><p id="ListJobs__p1051519188501"><a name="ListJobs__li19515151845019"></a><a name="li19515151845019"></a>multipart/form-data (used when the <strong id="ListJobs__b195150183505">FormData</strong> parameter is present)</p>
</li></ul>
<p id="ListJobs__p551551875011"><strong id="ListJobs__b351581885016">Default value</strong>:</p>
<p id="ListJobs__p2515161818507">N/A</p>
</td>
</tr>
<tr id="ListJobs__row55131518185011"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="ListJobs__p18515131814507">X-Auth-Token</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="ListJobs__p1451521875016">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="ListJobs__p1515111814507">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="ListJobs__p155151818165012"><strong id="ListJobs__b125151418135011">Details</strong>:</p>
<p id="ListJobs__p15515141815013">Requests for calling an API can be authenticated using either a token or AK/SK. If token-based authentication is used, this parameter is mandatory and must be set to a user token. For details, see <a href="cce_02_0004.html">Obtaining a User Token</a>.</p>
<p id="ListJobs__p1951591814502"><strong id="ListJobs__b17515151818504">Constraints</strong>:</p>
<p id="ListJobs__p15153181505">None</p>
<p id="ListJobs__p451551865017"><strong id="ListJobs__b55151618115010">Options</strong>:</p>
<p id="ListJobs__p10515121820503">N/A</p>
<p id="ListJobs__p2515121814506"><strong id="ListJobs__b10515121845017">Default value</strong>:</p>
<p id="ListJobs__p75152188506">N/A</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="ListJobs__section10516201814504"><h4 class="sectiontitle">Response Parameters</h4><p id="ListJobs__p135164186505"><strong id="ListJobs__b0516171811505">Status code: 200</strong></p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="ListJobs__en-us_topic_0000002517023859_response_V2ListJobsRespBody" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Response body parameters</caption><thead align="left"><tr id="ListJobs__row16516161819502"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.3.2.4.1.1"><p id="ListJobs__p1051601815011">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.3.2.4.1.2"><p id="ListJobs__p18516121815018">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.4.3.2.4.1.3"><p id="ListJobs__p8516141816505">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="ListJobs__row11516118145016"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="ListJobs__p451621818506">[items]</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="ListJobs__p17516918205015">Array of <a href="#ListJobs__en-us_topic_0000002517023859_response_V2Job">V2Job</a> objects</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="ListJobs__p5517151817509"><strong id="ListJobs__b1951714188505">Definition</strong></p>
<p id="ListJobs__p18517121805020">Job details list.</p>
<p id="ListJobs__p125171618145019"><strong id="ListJobs__b155179182507">Constraints</strong></p>
<p id="ListJobs__p18517818155013">N/A</p>
<p id="ListJobs__p1651714189501"><strong id="ListJobs__b45179180506">Range</strong></p>
<p id="ListJobs__p17517018185017">N/A</p>
<p id="ListJobs__p1951710188508"><strong id="ListJobs__b95176183507">Default Value</strong></p>
<p id="ListJobs__p15517518115018">N/A</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="ListJobs__en-us_topic_0000002517023859_response_V2Job"></a><a name="en-us_topic_0000002517023859_response_V2Job"></a><table cellpadding="4" cellspacing="0" summary="" id="ListJobs__en-us_topic_0000002517023859_response_V2Job" frame="border" border="1" rules="all"><caption><b>Table 4 </b>V2Job</caption><thead align="left"><tr id="ListJobs__row9517618165015"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.4.2.4.1.1"><p id="ListJobs__p2051831835012">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.4.2.4.1.2"><p id="ListJobs__p251814181501">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.4.4.2.4.1.3"><p id="ListJobs__p1518121835013">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="ListJobs__row1251751895018"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.1 "><p id="ListJobs__p205181918105020">kind</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.2 "><p id="ListJobs__p135187187501">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.4.2.4.1.3 "><p id="ListJobs__p351831895010"><strong id="ListJobs__b145183180504">Definition</strong></p>
<p id="ListJobs__p8518818135015">API type.</p>
<p id="ListJobs__p3518618165011"><strong id="ListJobs__b1851821819509">Constraints</strong></p>
<p id="ListJobs__p10518618105020">N/A</p>
<p id="ListJobs__p8518191835017"><strong id="ListJobs__b165185187502">Range</strong></p>
<p id="ListJobs__p12518318105011">N/A</p>
<p id="ListJobs__p651891812503"><strong id="ListJobs__b17518191825011">Default Value</strong></p>
<p id="ListJobs__p551871812508">Job</p>
</td>
</tr>
<tr id="ListJobs__row4517118155017"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.1 "><p id="ListJobs__p051851816506">apiVersion</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.2 "><p id="ListJobs__p18518121819507">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.4.2.4.1.3 "><p id="ListJobs__p451891825016"><strong id="ListJobs__b1551914187507">Definition</strong></p>
<p id="ListJobs__p1651919184502">API version.</p>
<p id="ListJobs__p1651911825010"><strong id="ListJobs__b11519161875020">Constraints</strong></p>
<p id="ListJobs__p7519151875013">N/A</p>
<p id="ListJobs__p175191518135011"><strong id="ListJobs__b45191218175017">Range</strong></p>
<p id="ListJobs__p1351921885013">N/A</p>
<p id="ListJobs__p145191418185011"><strong id="ListJobs__b17519161813508">Default Value</strong></p>
<p id="ListJobs__p135191418195020">v2</p>
</td>
</tr>
<tr id="ListJobs__row14517418125013"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.1 "><p id="ListJobs__p5519018175017">metadata</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.2 "><p id="ListJobs__p10519121818501"><a href="#ListJobs__en-us_topic_0000002517023859_response_V2JobTypeObject">V2JobTypeObject</a> object</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.4.2.4.1.3 "><p id="ListJobs__p2519318115012"><strong id="ListJobs__b205199180506">Definition</strong></p>
<p id="ListJobs__p6519131810504">Job metadata.</p>
<p id="ListJobs__p13519718205015"><strong id="ListJobs__b2519151835013">Constraints</strong></p>
<p id="ListJobs__p1351916186507">N/A</p>
<p id="ListJobs__p10519118115013"><strong id="ListJobs__b7519171814505">Range</strong></p>
<p id="ListJobs__p1051901875013">N/A</p>
<p id="ListJobs__p18519718185020"><strong id="ListJobs__b55191118145011">Default Value</strong></p>
<p id="ListJobs__p14519201820501">N/A</p>
</td>
</tr>
<tr id="ListJobs__row451751865018"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.1 "><p id="ListJobs__p851971835018">spec</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.2 "><p id="ListJobs__p185201818135019"><a href="#ListJobs__en-us_topic_0000002517023859_response_V2JobSpec">V2JobSpec</a> object</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.4.2.4.1.3 "><p id="ListJobs__p152017185502"><strong id="ListJobs__b16520121815507">Definition</strong></p>
<p id="ListJobs__p1852041815010">Job details.</p>
<p id="ListJobs__p952091814501"><strong id="ListJobs__b3520201835012">Constraints</strong></p>
<p id="ListJobs__p1852013180509">N/A</p>
<p id="ListJobs__p752071811506"><strong id="ListJobs__b3520101825011">Range</strong></p>
<p id="ListJobs__p10520111865019">N/A</p>
<p id="ListJobs__p125201318175017"><strong id="ListJobs__b18520171845013">Default Value</strong></p>
<p id="ListJobs__p10520121885018">N/A</p>
</td>
</tr>
<tr id="ListJobs__row15171918175016"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.1 "><p id="ListJobs__p4520171815014">status</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.2 "><p id="ListJobs__p1152011182502"><a href="#ListJobs__en-us_topic_0000002517023859_response_V2JobStatus">V2JobStatus</a> object</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.4.2.4.1.3 "><p id="ListJobs__p105208183500"><strong id="ListJobs__b14520131845016">Definition</strong></p>
<p id="ListJobs__p1952091811501">Job status.</p>
<p id="ListJobs__p11520618185018"><strong id="ListJobs__b6520101825010">Constraints</strong></p>
<p id="ListJobs__p185204183508">N/A</p>
<p id="ListJobs__p65202189507"><strong id="ListJobs__b18520918145019">Range</strong></p>
<p id="ListJobs__p85201618145010">N/A</p>
<p id="ListJobs__p19520618155020"><strong id="ListJobs__b13520201875017">Default Value</strong></p>
<p id="ListJobs__p1252012189506">N/A</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="ListJobs__en-us_topic_0000002517023859_response_V2JobTypeObject"></a><a name="en-us_topic_0000002517023859_response_V2JobTypeObject"></a><table cellpadding="4" cellspacing="0" summary="" id="ListJobs__en-us_topic_0000002517023859_response_V2JobTypeObject" frame="border" border="1" rules="all"><caption><b>Table 5 </b>V2JobTypeObject</caption><thead align="left"><tr id="ListJobs__row14521131835011"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.5.2.4.1.1"><p id="ListJobs__p752161875019">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.5.2.4.1.2"><p id="ListJobs__p1521818155011">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.4.5.2.4.1.3"><p id="ListJobs__p1652171845019">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="ListJobs__row1052101805018"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.5.2.4.1.1 "><p id="ListJobs__p05211518125015">uid</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.5.2.4.1.2 "><p id="ListJobs__p1052151805011">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.5.2.4.1.3 "><p id="ListJobs__p252117182507"><strong id="ListJobs__b1452119188502">Definition</strong></p>
<p id="ListJobs__p195211418105010">Job UUID.</p>
<p id="ListJobs__p252291825013"><strong id="ListJobs__b17522718155012">Constraints</strong></p>
<p id="ListJobs__p1152215182506">N/A</p>
<p id="ListJobs__p352215185500"><strong id="ListJobs__b11522151817509">Range</strong></p>
<p id="ListJobs__p652281815504">N/A</p>
<p id="ListJobs__p55221918195018"><strong id="ListJobs__b952216185503">Default Value</strong></p>
<p id="ListJobs__p952214181508">N/A</p>
</td>
</tr>
<tr id="ListJobs__row1452141817506"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.5.2.4.1.1 "><p id="ListJobs__p105221118175010">creationTimestamp</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.5.2.4.1.2 "><p id="ListJobs__p19522181875011">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.5.2.4.1.3 "><p id="ListJobs__p11522121810502"><strong id="ListJobs__b1252221814509">Definition</strong></p>
<p id="ListJobs__p11522101814507">Job creation time.</p>
<p id="ListJobs__p2522818125013"><strong id="ListJobs__b152212187506">Constraints</strong></p>
<p id="ListJobs__p1452251865011">N/A</p>
<p id="ListJobs__p152261816509"><strong id="ListJobs__b14522161865018">Range</strong></p>
<p id="ListJobs__p952281885015">N/A</p>
<p id="ListJobs__p19522218145015"><strong id="ListJobs__b552261895015">Default Value</strong></p>
<p id="ListJobs__p352241817505">N/A</p>
</td>
</tr>
<tr id="ListJobs__row1752141875013"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.5.2.4.1.1 "><p id="ListJobs__p105229188503">updateTimestamp</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.5.2.4.1.2 "><p id="ListJobs__p2522111825011">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.5.2.4.1.3 "><p id="ListJobs__p15523161813502"><strong id="ListJobs__b2052301805013">Definition</strong></p>
<p id="ListJobs__p05234183505">Last update time of a job.</p>
<p id="ListJobs__p352351815503"><strong id="ListJobs__b1952314188501">Constraints</strong></p>
<p id="ListJobs__p95239187500">N/A</p>
<p id="ListJobs__p9523181813505"><strong id="ListJobs__b25237183500">Range</strong></p>
<p id="ListJobs__p12523718135017">N/A</p>
<p id="ListJobs__p12523181813505"><strong id="ListJobs__b12523318195011">Default Value</strong></p>
<p id="ListJobs__p17523151815507">N/A</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="ListJobs__en-us_topic_0000002517023859_response_V2JobSpec"></a><a name="en-us_topic_0000002517023859_response_V2JobSpec"></a><table cellpadding="4" cellspacing="0" summary="" id="ListJobs__en-us_topic_0000002517023859_response_V2JobSpec" frame="border" border="1" rules="all"><caption><b>Table 6 </b>V2JobSpec</caption><thead align="left"><tr id="ListJobs__row1552351811509"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.6.2.4.1.1"><p id="ListJobs__p552481895019">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.6.2.4.1.2"><p id="ListJobs__p165242189504">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.4.6.2.4.1.3"><p id="ListJobs__p12524118155010">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="ListJobs__row1052351819501"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.6.2.4.1.1 "><p id="ListJobs__p2524111895018">type</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.6.2.4.1.2 "><p id="ListJobs__p115241318185011">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.6.2.4.1.3 "><p id="ListJobs__p2524121845019"><strong id="ListJobs__b13524418205017">Definition</strong></p>
<p id="ListJobs__p95241318125019">Job type.</p>
<p id="ListJobs__p1524181815014"><strong id="ListJobs__b45241518175014">Constraints</strong></p>
<p id="ListJobs__p952431817509">N/A</p>
<p id="ListJobs__p35244181506"><strong id="ListJobs__b2524181885013">Range</strong></p>
<p id="ListJobs__p452413188507">N/A</p>
<p id="ListJobs__p55245182503"><strong id="ListJobs__b452441817507">Default Value</strong></p>
<p id="ListJobs__p1452491820508">N/A</p>
</td>
</tr>
<tr id="ListJobs__row6523101816506"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.6.2.4.1.1 "><p id="ListJobs__p12524818185018">clusteruid</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.6.2.4.1.2 "><p id="ListJobs__p752512186501">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.6.2.4.1.3 "><p id="ListJobs__p952591845014"><strong id="ListJobs__b1352561814501">Definition</strong></p>
<p id="ListJobs__p15251018135012">Cluster ID.</p>
<p id="ListJobs__p195251018125010"><strong id="ListJobs__b952511186505">Constraints</strong></p>
<p id="ListJobs__p16525141820507">N/A</p>
<p id="ListJobs__p95251218115018"><strong id="ListJobs__b13525181835018">Range</strong></p>
<p id="ListJobs__p852501885012">N/A</p>
<p id="ListJobs__p1152541812509"><strong id="ListJobs__b17525718205013">Default Value</strong></p>
<p id="ListJobs__p15525181817505">N/A</p>
</td>
</tr>
<tr id="ListJobs__row16523131825010"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.6.2.4.1.1 "><p id="ListJobs__p1452520187502">resourceid</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.6.2.4.1.2 "><p id="ListJobs__p9525121818504">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.6.2.4.1.3 "><p id="ListJobs__p13525191819509"><strong id="ListJobs__b352517189505">Definition</strong></p>
<p id="ListJobs__p19525218125014">Resource ID.</p>
<p id="ListJobs__p25251218195010"><strong id="ListJobs__b7525111818507">Constraints</strong></p>
<p id="ListJobs__p7525418145018">N/A</p>
<p id="ListJobs__p1052514184501"><strong id="ListJobs__b55253182506">Range</strong></p>
<p id="ListJobs__p252510181508">N/A</p>
<p id="ListJobs__p05251718165013"><strong id="ListJobs__b0525181835011">Default Value</strong></p>
<p id="ListJobs__p1752681825017">N/A</p>
</td>
</tr>
<tr id="ListJobs__row145232181505"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.6.2.4.1.1 "><p id="ListJobs__p252661819509">resourcename</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.6.2.4.1.2 "><p id="ListJobs__p4526218205013">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.6.2.4.1.3 "><p id="ListJobs__p106401618125013"><strong id="ListJobs__b0640418125011">Definition</strong></p>
<p id="ListJobs__p8640171885019">Resource name.</p>
<p id="ListJobs__p3640101835011"><strong id="ListJobs__b164021865011">Constraints</strong></p>
<p id="ListJobs__p56401418145016">N/A</p>
<p id="ListJobs__p17640111816501"><strong id="ListJobs__b116401018165014">Range</strong></p>
<p id="ListJobs__p1564021835020">N/A</p>
<p id="ListJobs__p86407183500"><strong id="ListJobs__b136401718145019">Default Value</strong></p>
<p id="ListJobs__p1864051855011">N/A</p>
</td>
</tr>
<tr id="ListJobs__row16523118195017"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.6.2.4.1.1 "><p id="ListJobs__p15640518175017">extendparam</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.6.2.4.1.2 "><p id="ListJobs__p1964061825013">Map&lt;String,String&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.6.2.4.1.3 "><p id="ListJobs__p464019187507"><strong id="ListJobs__b126401518115016">Definition</strong></p>
<p id="ListJobs__p26401018145012">Job scale-out parameters.</p>
<p id="ListJobs__p1764051855016"><strong id="ListJobs__b86401518195011">Constraints</strong></p>
<p id="ListJobs__p1864041812508">N/A</p>
<p id="ListJobs__p206401518185010"><strong id="ListJobs__b96407185501">Range</strong></p>
<p id="ListJobs__p186401218135013">N/A</p>
<p id="ListJobs__p3640818165018"><strong id="ListJobs__b196401718135014">Default Value</strong></p>
<p id="ListJobs__p10640618175019">N/A</p>
</td>
</tr>
<tr id="ListJobs__row7523818115011"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.6.2.4.1.1 "><p id="ListJobs__p46401518125012">subjobs</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.6.2.4.1.2 "><p id="ListJobs__p664011865014">Array of <a href="#ListJobs__en-us_topic_0000002517023859_response_V2Job">V2Job</a> objects</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.6.2.4.1.3 "><p id="ListJobs__p4640518145010"><strong id="ListJobs__b1164001817501">Definition</strong></p>
<p id="ListJobs__p10640191855019">Subjob details list.</p>
<p id="ListJobs__p146401718155014"><strong id="ListJobs__b1764031810507">Constraints</strong></p>
<p id="ListJobs__p76409184507">N/A</p>
<p id="ListJobs__p18640181819506"><strong id="ListJobs__b1640101865012">Range</strong></p>
<p id="ListJobs__p864091825019">N/A</p>
<p id="ListJobs__p1064181815020"><strong id="ListJobs__b764161811509">Default Value</strong></p>
<p id="ListJobs__p1764115183506">N/A</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="ListJobs__en-us_topic_0000002517023859_response_V2JobStatus"></a><a name="en-us_topic_0000002517023859_response_V2JobStatus"></a><table cellpadding="4" cellspacing="0" summary="" id="ListJobs__en-us_topic_0000002517023859_response_V2JobStatus" frame="border" border="1" rules="all"><caption><b>Table 7 </b>V2JobStatus</caption><thead align="left"><tr id="ListJobs__row7527818155017"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.7.2.4.1.1"><p id="ListJobs__p26411518195012">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.7.2.4.1.2"><p id="ListJobs__p1964111816508">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.4.7.2.4.1.3"><p id="ListJobs__p764111865013">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="ListJobs__row105271418115010"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.7.2.4.1.1 "><p id="ListJobs__p564191845012">status</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.7.2.4.1.2 "><p id="ListJobs__p76411818145012">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.7.2.4.1.3 "><p id="ListJobs__p564111885012"><strong id="ListJobs__b166411518135016">Definition</strong></p>
<p id="ListJobs__p06411118115018">Job status.</p>
<p id="ListJobs__p364191811506"><strong id="ListJobs__b17641111845013">Constraints</strong></p>
<p id="ListJobs__p1064115185507">N/A</p>
<p id="ListJobs__p364141810501"><strong id="ListJobs__b764117182503">Range</strong></p>
<ul id="ListJobs__ul2064121819504"><li id="ListJobs__li664111895016"><p id="ListJobs__p1864141813503"><a name="ListJobs__li664111895016"></a><a name="li664111895016"></a><strong id="ListJobs__b46414188501">Initializing</strong>: The job is not executed.</p>
</li><li id="ListJobs__li16641201812502"><p id="ListJobs__p46411418115016"><a name="ListJobs__li16641201812502"></a><a name="li16641201812502"></a><strong id="ListJobs__b7641101813503">Running</strong>: The job is being executed.</p>
</li><li id="ListJobs__li564112189508"><p id="ListJobs__p11641118135011"><a name="ListJobs__li564112189508"></a><a name="li564112189508"></a><strong id="ListJobs__b9641121865019">Failed</strong>: The job fails to be executed.</p>
</li><li id="ListJobs__li6641151815016"><p id="ListJobs__p13641131812503"><a name="ListJobs__li6641151815016"></a><a name="li6641151815016"></a><strong id="ListJobs__b2641181815502">Success</strong>: The job has been executed.</p>
</li></ul>
<p id="ListJobs__p18641101855014"><strong id="ListJobs__b1764181855011">Default Value</strong></p>
<p id="ListJobs__p17641131814509">N/A</p>
</td>
</tr>
<tr id="ListJobs__row155271118175015"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.7.2.4.1.1 "><p id="ListJobs__p364101895014">reason</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.7.2.4.1.2 "><p id="ListJobs__p1464119186507">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.7.2.4.1.3 "><p id="ListJobs__p96414183502"><strong id="ListJobs__b46411618105016">Definition</strong></p>
<p id="ListJobs__p9641618195015">Cause of a job execution failure.</p>
<p id="ListJobs__p116417186500"><strong id="ListJobs__b264121814505">Constraints</strong></p>
<p id="ListJobs__p3641181875017">N/A</p>
<p id="ListJobs__p16641181865013"><strong id="ListJobs__b1564181817505">Range</strong></p>
<p id="ListJobs__p17641171875015">N/A</p>
<p id="ListJobs__p106414185503"><strong id="ListJobs__b1564161815013">Default Value</strong></p>
<p id="ListJobs__p7641111819503">N/A</p>
</td>
</tr>
<tr id="ListJobs__row1052716181506"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.7.2.4.1.1 "><p id="ListJobs__p11641181895014">completionTime</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.7.2.4.1.2 "><p id="ListJobs__p17641131818509">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.7.2.4.1.3 "><p id="ListJobs__p964151815014"><strong id="ListJobs__b3641118135015">Definition</strong></p>
<p id="ListJobs__p36411518125012">Job completion time.</p>
<p id="ListJobs__p3641101845015"><strong id="ListJobs__b664151835014">Constraints</strong></p>
<p id="ListJobs__p5641418115019">N/A</p>
<p id="ListJobs__p1164191816504"><strong id="ListJobs__b4641218175013">Range</strong></p>
<p id="ListJobs__p1364181835010">N/A</p>
<p id="ListJobs__p7641191825013"><strong id="ListJobs__b1564110184502">Default Value</strong></p>
<p id="ListJobs__p8641171815016">N/A</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="ListJobs__section364141815018"><h4 class="sectiontitle">Example Requests</h4><p id="ListJobs__p4641131895017">None</p>
</div>
<div class="section" id="ListJobs__section1164151875011"><h4 class="sectiontitle">Example Responses</h4><p id="ListJobs__p96411618205015"><strong id="ListJobs__b156417187508">Status code: 200</strong></p>
<pre class="screen" id="ListJobs__screen1664117183506">[ {
"kind" : "Job",
"apiVersion" : "v2",
"metadata" : {
"uid" : "e43c6f3b-87e6-11f0-be88-0255ac10003f",
"creationTimestamp" : "2025-09-02 10:23:38.987955 +0000 UTC",
"updateTimestamp" : "2025-09-02 11:26:03.218087 +0000 UTC"
},
"spec" : {
"type" : "ScaleupCluster",
"clusteruid" : "7ec8b73d-83db-11f0-8baa-0255ac10003e",
"resourceid" : "3b4410fa-87e6-11f0-be88-0255ac10003f",
"resourcename" : "node-iv28j9",
"extendparam" : {
"claimrollback" : "true",
"node.zone" : <strong id="ListJobs__b846819355450"><em id="ListJobs__i87071568347">""</em></strong>,
"nodepooluid" : "",
"orderID" : "CS25090218238EI5V",
"v3-scaleup" : "true"
}
},
"status" : {
"status" : "Failed",
"reason" : "Something bad happened at server, recycle resource",
"completionTime" : "2025-09-02 11:26:03.218087 +0000 UTC"
}
} ]</pre>
</div>
<div class="section" id="ListJobs__section126425185509"><h4 class="sectiontitle">Status Codes</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="ListJobs__en-us_topic_0000002517023859_status_code" frame="border" border="1" rules="all"><thead align="left"><tr id="ListJobs__row353081813504"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.7.2.1.3.1.1"><p id="ListJobs__p1164211188503">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="85%" id="mcps1.3.7.2.1.3.1.2"><p id="ListJobs__p56421718205014">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="ListJobs__row75301818115016"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="ListJobs__p1764251810505">200</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="ListJobs__p664261885019"><strong id="ListJobs__b156421618105019">Definition</strong></p>
<p id="ListJobs__p664215185509">Job details list.</p>
<p id="ListJobs__p864221812503"><strong id="ListJobs__b96423184505">Constraints</strong></p>
<p id="ListJobs__p1564291816507">N/A</p>
<p id="ListJobs__p76421818125015"><strong id="ListJobs__b1064291817505">Range</strong></p>
<p id="ListJobs__p106421318115016">N/A</p>
<p id="ListJobs__p1464212186504"><strong id="ListJobs__b264220183507">Default Value</strong></p>
<p id="ListJobs__p16421818145011">N/A</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="ListJobs__section36421518195010"><h4 class="sectiontitle">Error Codes</h4><p id="ListJobs__p1164241812506">See <a href="cce_02_0250.html">Error Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="job_lifecycle_management.html">Job Management</a></div>
</div>
</div>