doc-exports/docs/modelarts/api-ref/en-us_topic_0000001147936839.html
Artem Goncharov 3196b64bfc
move doc sources to other location (#3)
move doc sources to other location

Reviewed-by: OpenTelekomCloud Bot <None>
2022-04-27 16:24:25 +00:00

301 lines
29 KiB
HTML

<a name="EN-US_TOPIC_0000001147936839"></a><a name="EN-US_TOPIC_0000001147936839"></a>
<h1 class="topictitle1">Querying the Statuses and GPU Quantity of All Job Versions</h1>
<div id="body8662426"><div class="section" id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_section528664"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p29722048">You can use this API to query the overview information about all job versions created by a user based on specified conditions, including the statuses and GPU quantity of all job versions.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_section4757982"><h4 class="sectiontitle">URI</h4><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p0218181715712">GET /v1/{project_id}/training-jobs/versions</p>
<div class="p" id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p10971184713425">Table 1 Parameter description describes the required parameters.
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_table16518993181628" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_row41524868181628"><th align="left" class="cellrowborder" valign="top" width="19%" id="mcps1.3.2.3.1.2.5.1.1"><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p30350749181639">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="14.000000000000002%" id="mcps1.3.2.3.1.2.5.1.2"><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p42491604181639">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="11%" id="mcps1.3.2.3.1.2.5.1.3"><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p19267891181639">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="56.00000000000001%" id="mcps1.3.2.3.1.2.5.1.4"><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p17195363181639">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_row6770181628"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.2.3.1.2.5.1.1 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p8780885181639">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.2.3.1.2.5.1.2 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p40163046181639">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="11%" headers="mcps1.3.2.3.1.2.5.1.3 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p31981288181639">String</p>
</td>
<td class="cellrowborder" valign="top" width="56.00000000000001%" headers="mcps1.3.2.3.1.2.5.1.4 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p40347522181639">Project ID.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_section17382173235414"><h4 class="sectiontitle">Request Body</h4><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p11333135175510"><a href="#EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_table125324323545">Table 2</a> describes the request parameters.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_table125324323545"></a><a name="en-us_topic_0195926038_table125324323545"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_table125324323545" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Parameter description</caption><thead align="left"><tr id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_row1752983213545"><th align="left" class="cellrowborder" valign="top" width="19.191919191919194%" id="mcps1.3.3.3.2.5.1.1"><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p185291932155413">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="14.141414141414144%" id="mcps1.3.3.3.2.5.1.2"><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p1052923217540">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="11.111111111111112%" id="mcps1.3.3.3.2.5.1.3"><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p19529332125413">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="55.55555555555556%" id="mcps1.3.3.3.2.5.1.4"><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p05295327545">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_row14474161810015"><td class="cellrowborder" valign="top" width="19.191919191919194%" headers="mcps1.3.3.3.2.5.1.1 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p84742189016">offset</p>
</td>
<td class="cellrowborder" valign="top" width="14.141414141414144%" headers="mcps1.3.3.3.2.5.1.2 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p15474151815011">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.111111111111112%" headers="mcps1.3.3.3.2.5.1.3 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p6475121812020">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.55555555555556%" headers="mcps1.3.3.3.2.5.1.4 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p659635214296">Offset.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_row116794231004"><td class="cellrowborder" valign="top" width="19.191919191919194%" headers="mcps1.3.3.3.2.5.1.1 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p867913236013">limit</p>
</td>
<td class="cellrowborder" valign="top" width="14.141414141414144%" headers="mcps1.3.3.3.2.5.1.2 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p9679192310017">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.111111111111112%" headers="mcps1.3.3.3.2.5.1.3 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p13679123904">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.55555555555556%" headers="mcps1.3.3.3.2.5.1.4 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p267913237013">Number of displayed records. The default value is <strong id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_b389643917342">20</strong>. The value <strong id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_b10278184183419">0</strong> indicates that all records are displayed.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_row1852933245412"><td class="cellrowborder" valign="top" width="19.191919191919194%" headers="mcps1.3.3.3.2.5.1.1 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p2052918328549">status</p>
</td>
<td class="cellrowborder" valign="top" width="14.141414141414144%" headers="mcps1.3.3.3.2.5.1.2 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p9529932135412">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.111111111111112%" headers="mcps1.3.3.3.2.5.1.3 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p1952923205416">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.55555555555556%" headers="mcps1.3.3.3.2.5.1.4 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p75291232145415">Job status. By default, all job statuses are returned. For example, to query failed jobs, set the value of <strong id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_b918394814378">status</strong> to <strong id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_b20644134883414">3</strong>, <strong id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_b070785019343">5</strong>, <strong id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_b1524685293418">6</strong>, or <strong id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_b1447675443415">13</strong>. For details about the job statuses, see <a href="modelarts_03_0074.html#modelarts_03_0074">Job Statuses</a>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_row185301232125418"><td class="cellrowborder" valign="top" width="19.191919191919194%" headers="mcps1.3.3.3.2.5.1.1 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p1952917325548">sort_by</p>
</td>
<td class="cellrowborder" valign="top" width="14.141414141414144%" headers="mcps1.3.3.3.2.5.1.2 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p125293324548">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.111111111111112%" headers="mcps1.3.3.3.2.5.1.3 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p1253053211546">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.55555555555556%" headers="mcps1.3.3.3.2.5.1.4 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p17530232175418">Sorting mode of the query. By default, the records are sorted by <strong id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_b723141543117">create_time</strong>. The records can be sorted by <strong id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_b10247152316">job_desc</strong>, <span class="parmname" id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_parmname152471553116"><b>status</b></span>, <span class="parmname" id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_parmname1924115143117"><b>duration</b></span>, or <span class="parmname" id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_parmname12411512315"><b>job_name</b></span>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_row3530232155414"><td class="cellrowborder" valign="top" width="19.191919191919194%" headers="mcps1.3.3.3.2.5.1.1 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p135301732195416">order</p>
</td>
<td class="cellrowborder" valign="top" width="14.141414141414144%" headers="mcps1.3.3.3.2.5.1.2 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p125301632165413">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.111111111111112%" headers="mcps1.3.3.3.2.5.1.3 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p175301432115419">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.55555555555556%" headers="mcps1.3.3.3.2.5.1.4 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p18530203255417">Sorting order. Options:</p>
<ul id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_ul45306327543"><li id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_li353003215418"><span class="parmvalue" id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_parmvalue228311359313"><b>asc</b></span>: ascending order</li><li id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_li14530032135417"><span class="parmvalue" id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_parmvalue171115386312"><b>desc</b></span>: descending order. The default value is <span class="parmvalue" id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_parmvalue11716123873119"><b>desc</b></span>.</li></ul>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_row9532123245417"><td class="cellrowborder" valign="top" width="19.191919191919194%" headers="mcps1.3.3.3.2.5.1.1 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p11530143285414">pool_id</p>
</td>
<td class="cellrowborder" valign="top" width="14.141414141414144%" headers="mcps1.3.3.3.2.5.1.2 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p1553093235410">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.111111111111112%" headers="mcps1.3.3.3.2.5.1.3 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p65321332125415">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.55555555555556%" headers="mcps1.3.3.3.2.5.1.4 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p135321832125412">ID of the resource pool to be queried.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_row1822917142228"><td class="cellrowborder" valign="top" width="19.191919191919194%" headers="mcps1.3.3.3.2.5.1.1 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p19230181472212">workspace_id</p>
</td>
<td class="cellrowborder" valign="top" width="14.141414141414144%" headers="mcps1.3.3.3.2.5.1.2 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p18230171442210">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.111111111111112%" headers="mcps1.3.3.3.2.5.1.3 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p122301914142219">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.55555555555556%" headers="mcps1.3.3.3.2.5.1.4 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p14230214142213">Workspace where a job resides. Default value: <strong id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_b196314433517">0</strong></p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_section46017476"><h4 class="sectiontitle">Response Body</h4><div class="p" id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p15979103725811"><a href="#EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_table31621671103510">Table 3</a> describes the response parameters.
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_table31621671103510"></a><a name="en-us_topic_0195926038_table31621671103510"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_table31621671103510" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Parameter description</caption><thead align="left"><tr id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_row43014294103510"><th align="left" class="cellrowborder" valign="top" width="19%" id="mcps1.3.4.2.2.2.4.1.1"><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p27237124103529">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="14.000000000000002%" id="mcps1.3.4.2.2.2.4.1.2"><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p58976351103529">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="67%" id="mcps1.3.4.2.2.2.4.1.3"><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p12355133103529">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_row6154121019310"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.2.2.4.1.1 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p2530905217407">is_success</p>
</td>
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.4.2.2.2.4.1.2 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p2536505617407">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="67%" headers="mcps1.3.4.2.2.2.4.1.3 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p4130369517407">Whether the request is successful</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_row197335051410"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.2.2.4.1.1 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p16741250101412">error_message</p>
</td>
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.4.2.2.2.4.1.2 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p167419502147">String</p>
</td>
<td class="cellrowborder" valign="top" width="67%" headers="mcps1.3.4.2.2.2.4.1.3 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p06401316154">Error message of a failed API call.</p>
<p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p5642163131513">This parameter is not included when the API call succeeds.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_row16193448103510"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.2.2.4.1.1 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p21522350103529">error_code</p>
</td>
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.4.2.2.2.4.1.2 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p11090557103529">String</p>
</td>
<td class="cellrowborder" valign="top" width="67%" headers="mcps1.3.4.2.2.2.4.1.3 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p1251312531679">Error code of a failed API call. For details, see <a href="modelarts_03_0095.html">Error Codes</a>.</p>
<p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p25919895103529">This parameter is not included when the API call succeeds.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_row45611722103510"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.2.2.4.1.1 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p11027791103529">total_count</p>
</td>
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.4.2.2.2.4.1.2 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p9983934103529">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="67%" headers="mcps1.3.4.2.2.2.4.1.3 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p3392343103529">Total number of created job versions.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_row49183900103510"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.2.2.4.1.1 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p59075084103529">versions</p>
</td>
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.4.2.2.2.4.1.2 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p37936844103529">JSON Array</p>
</td>
<td class="cellrowborder" valign="top" width="67%" headers="mcps1.3.4.2.2.2.4.1.3 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p52985513103529">Attributes of a training job. For details, see <a href="#EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_table3971109103614">Table 4</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_table3971109103614"></a><a name="en-us_topic_0195926038_table3971109103614"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_table3971109103614" frame="border" border="1" rules="all"><caption><b>Table 4 </b><strong id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_b13456201671315">jobs</strong> parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_row7802134103614"><th align="left" class="cellrowborder" valign="top" width="19%" id="mcps1.3.4.2.3.2.4.1.1"><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p3311592314323">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.4.2.3.2.4.1.2"><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p6514409514323">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="66%" id="mcps1.3.4.2.3.2.4.1.3"><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p4218030314323">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_row5535123419151"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p15535183415158">version_id</p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.4.2.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p11536103420154">Long</p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.4.2.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p135361334151513">ID of a training job</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_row7417784103614"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p5512274814323">version_name</p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.4.2.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p3575764214323">String</p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.4.2.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p1068790014323">Name of a training job</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_row36417840103614"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p6057598714323">status</p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.4.2.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p770788014323">Byte</p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.4.2.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p2035852114323">Status of a training job. For details about the job statuses, see <a href="modelarts_03_0074.html#modelarts_03_0074">Job Statuses</a>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_row50389554103614"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p2562267414323">create_time</p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.4.2.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p152021491810">Long</p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.4.2.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p266431714323">Timestamp when a training job is created</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_row1710103183410"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p4711334347">start_time</p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.4.2.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p1371113313345">Long</p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.4.2.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p3711832342">Timestamp when a training job starts.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_row209381243133417"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p179384432345">end_time</p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.4.2.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p4938154393413">Long</p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.4.2.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p193884303413">Timestamp when a training job ends.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_row57875733103614"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p6323926614323">duration</p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.4.2.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p2210695614323">Long</p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.4.2.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p4583303914323">Running duration of a training job.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_row14074438103614"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p5918019514323">version_desc</p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.4.2.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p2886647314323">String</p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.4.2.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p5648301314323">Description of a training job</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_row30554942103614"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p3838291414323">pool_id</p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.4.2.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p2200835214323">String</p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.4.2.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p1391412663518">ID of the resource pool to which a training job belongs.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_row10574134111357"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p557464103515">flavor_code</p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.4.2.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p95741141133519">String</p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.4.2.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p20574341203518">Resource specifications selected for a training job</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_row168231647103519"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p11823154712358">npu_num</p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.4.2.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p582319475354">integer</p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.4.2.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p7823194716353">Number of NPUs used by a training job.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_row10766165116350"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p14766145153514">gpu_num</p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.4.2.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p6766251183514">integer</p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.4.2.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p676613518358">Number of GPUs used by a training job.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_section2044281275719"><h4 class="sectiontitle">Samples</h4><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p934031685719">Query training jobs in batches.</p>
<ul id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_ul197155411577"><li id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_li487543577">Sample request<pre class="screen" id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_screen9976835111716">GET https://endpoint/v1/{project_id}/training-jobs/versions</pre>
</li></ul>
</div>
<ul id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_ul19174109"><li id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_li38349257">Sample response of a successful query<pre class="screen" id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_screen33261644151716">{
versions:[
{
"version_id": 1485,
"version_name": "trainjob-3f47",
"status": 12,
"create_time": 1557473030000,
"start_time": 1557473040000,
"end_time": 1557473093000,
"duration": 53000,
"version_desc": null,
"pool_id": "pool9928813f",
"flavor_code": "modelarts.p1.2xlarge",
"npu_num": 0,
"gpu_num": 1
}
],
"offset": 20,
"limit": 20,
"total_count": 1,
"is_success": true
}</pre>
</li><li id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_li697916221660">Sample response of a failed query<pre class="screen" id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_screen74436528170">{
"is_success": false,
"error_message": "Error string",
"error_code": "ModelArts.0105"
}</pre>
</li></ul>
<div class="section" id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_section1245611572597"><h4 class="sectiontitle">Status Code</h4><p id="EN-US_TOPIC_0000001147936839__en-us_topic_0195926038_p1731954913014">For details about the status code, see <a href="modelarts_03_0094.html#modelarts_03_0094">Status Code</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="modelarts_03_0044.html">Training Jobs</a></div>
</div>
</div>