vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/modelarts/api-ref/modelarts_03_0050.html
Wuwan, Qi f81ead2467 ModelArts API 24.3.0 20241128 version 
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com>
Co-authored-by: Wuwan, Qi <wuwanqi1@noreply.gitea.eco.tsi-dev.otc-service.com>
Co-committed-by: Wuwan, Qi <wuwanqi1@noreply.gitea.eco.tsi-dev.otc-service.com>
2024-11-29 09:04:54 +00:00

458 lines
43 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0000001943866677"></a><a name="EN-US_TOPIC_0000001943866677"></a>
<h1 class="topictitle1">Creating a Version of a Training Job</h1>
<div id="body1536908999972"><div class="section" id="EN-US_TOPIC_0000001943866677__section39434663"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0000001943866677__p1661435471414">This API is used to create a version of a training job.</p>
<p id="EN-US_TOPIC_0000001943866677__p98522361359">Calling this API is an asynchronous operation. The job status can be obtained by calling the APIs described in <a href="modelarts_03_0046.html">Querying a Training Job List</a> and <a href="modelarts_03_0047.html">Querying the Details About a Training Job Version</a>.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001943866677__section19367652"><h4 class="sectiontitle">URI</h4><p id="EN-US_TOPIC_0000001943866677__p113801427162513">POST /v1/{project_id}/training-jobs/{job_id}/versions</p>
<div class="p" id="EN-US_TOPIC_0000001943866677__p17806111363016"><a href="#EN-US_TOPIC_0000001943866677__table126693715562">Table 1</a> describes the required parameters.
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001943866677__table126693715562"></a><a name="table126693715562"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001943866677__table126693715562" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001943866677__row372035415562"><th align="left" class="cellrowborder" valign="top" width="16.05839416058394%" id="mcps1.3.2.3.2.2.5.1.1"><p id="EN-US_TOPIC_0000001943866677__p17103387155619">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="14.8985101489851%" id="mcps1.3.2.3.2.2.5.1.2"><p id="EN-US_TOPIC_0000001943866677__p43197097155619">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="12.298770122987701%" id="mcps1.3.2.3.2.2.5.1.3"><p id="EN-US_TOPIC_0000001943866677__p9303972155619">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="56.744325567443255%" id="mcps1.3.2.3.2.2.5.1.4"><p id="EN-US_TOPIC_0000001943866677__p15424243155619">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001943866677__row4678310815562"><td class="cellrowborder" valign="top" width="16.05839416058394%" headers="mcps1.3.2.3.2.2.5.1.1 "><p id="EN-US_TOPIC_0000001943866677__p65402543155619">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="14.8985101489851%" headers="mcps1.3.2.3.2.2.5.1.2 "><p id="EN-US_TOPIC_0000001943866677__p63114603155619">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="12.298770122987701%" headers="mcps1.3.2.3.2.2.5.1.3 "><p id="EN-US_TOPIC_0000001943866677__p12009244155619">String</p>
</td>
<td class="cellrowborder" valign="top" width="56.744325567443255%" headers="mcps1.3.2.3.2.2.5.1.4 "><p id="EN-US_TOPIC_0000001943866677__p33224746155619">Project ID. For details about how to obtain a project ID, see <a href="modelarts_03_0147.html">Obtaining a Project ID and Name</a>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001943866677__row9926215562"><td class="cellrowborder" valign="top" width="16.05839416058394%" headers="mcps1.3.2.3.2.2.5.1.1 "><p id="EN-US_TOPIC_0000001943866677__p17972347155619">job_id</p>
</td>
<td class="cellrowborder" valign="top" width="14.8985101489851%" headers="mcps1.3.2.3.2.2.5.1.2 "><p id="EN-US_TOPIC_0000001943866677__p46473998155619">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="12.298770122987701%" headers="mcps1.3.2.3.2.2.5.1.3 "><p id="EN-US_TOPIC_0000001943866677__p6297502155619">Long</p>
</td>
<td class="cellrowborder" valign="top" width="56.744325567443255%" headers="mcps1.3.2.3.2.2.5.1.4 "><p id="EN-US_TOPIC_0000001943866677__p40335634155619">ID of a training job</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001943866677__section40091140"><h4 class="sectiontitle">Request Body</h4><div class="p" id="EN-US_TOPIC_0000001943866677__p42763116315"><a href="#EN-US_TOPIC_0000001943866677__table6270801111211">Table 2</a> describes the request parameters.
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001943866677__table6270801111211"></a><a name="table6270801111211"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001943866677__table6270801111211" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001943866677__row29941823111211"><th align="left" class="cellrowborder" valign="top" width="15.870000000000001%" id="mcps1.3.3.2.2.2.5.1.1"><p id="EN-US_TOPIC_0000001943866677__p40715701111242">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="15.49%" id="mcps1.3.3.2.2.2.5.1.2"><p id="EN-US_TOPIC_0000001943866677__p9637448111242">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="11.51%" id="mcps1.3.3.2.2.2.5.1.3"><p id="EN-US_TOPIC_0000001943866677__p42435861111242">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="57.13%" id="mcps1.3.3.2.2.2.5.1.4"><p id="EN-US_TOPIC_0000001943866677__p14752706111242">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001943866677__row47335462111211"><td class="cellrowborder" valign="top" width="15.870000000000001%" headers="mcps1.3.3.2.2.2.5.1.1 "><p id="EN-US_TOPIC_0000001943866677__p52538571111242">job_desc</p>
</td>
<td class="cellrowborder" valign="top" width="15.49%" headers="mcps1.3.3.2.2.2.5.1.2 "><p id="EN-US_TOPIC_0000001943866677__p27765887111242">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.51%" headers="mcps1.3.3.2.2.2.5.1.3 "><p id="EN-US_TOPIC_0000001943866677__p34444375111242">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.13%" headers="mcps1.3.3.2.2.2.5.1.4 "><p id="EN-US_TOPIC_0000001943866677__p38531004111242">Description of a training job. The value must contain 0 to 256 characters. By default, this parameter is left blank.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001943866677__row42350277111211"><td class="cellrowborder" valign="top" width="15.870000000000001%" headers="mcps1.3.3.2.2.2.5.1.1 "><p id="EN-US_TOPIC_0000001943866677__p37596993111242">config</p>
</td>
<td class="cellrowborder" valign="top" width="15.49%" headers="mcps1.3.3.2.2.2.5.1.2 "><p id="EN-US_TOPIC_0000001943866677__p25457572111242">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="11.51%" headers="mcps1.3.3.2.2.2.5.1.3 "><p id="EN-US_TOPIC_0000001943866677__p48797423111242">Object</p>
</td>
<td class="cellrowborder" valign="top" width="57.13%" headers="mcps1.3.3.2.2.2.5.1.4 "><p id="EN-US_TOPIC_0000001943866677__p60277195111242">Parameters for creating a training job For details, see <a href="#EN-US_TOPIC_0000001943866677__table24411850104213">Table 3</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001943866677__table24411850104213"></a><a name="table24411850104213"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001943866677__table24411850104213" width="100%" frame="border" border="1" rules="all"><caption><b>Table 3 </b><strong id="EN-US_TOPIC_0000001943866677__b952504412549">config</strong> parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001943866677__row24621050184211"><th align="left" class="cellrowborder" valign="top" width="15.88888888888889%" id="mcps1.3.4.2.5.1.1"><p id="EN-US_TOPIC_0000001943866677__p846695014420">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="15.585858585858587%" id="mcps1.3.4.2.5.1.2"><p id="EN-US_TOPIC_0000001943866677__p2472250174216">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="15.686868686868685%" id="mcps1.3.4.2.5.1.3"><p id="EN-US_TOPIC_0000001943866677__p4475105094212">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="52.83838383838384%" id="mcps1.3.4.2.5.1.4"><p id="EN-US_TOPIC_0000001943866677__p347885011427">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001943866677__row11479165020428"><td class="cellrowborder" valign="top" width="15.88888888888889%" headers="mcps1.3.4.2.5.1.1 "><p id="EN-US_TOPIC_0000001943866677__p548345016424">worker_server_num</p>
</td>
<td class="cellrowborder" valign="top" width="15.585858585858587%" headers="mcps1.3.4.2.5.1.2 "><p id="EN-US_TOPIC_0000001943866677__p1648616503421">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="15.686868686868685%" headers="mcps1.3.4.2.5.1.3 "><p id="EN-US_TOPIC_0000001943866677__p8489350124215">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="52.83838383838384%" headers="mcps1.3.4.2.5.1.4 "><p id="EN-US_TOPIC_0000001943866677__p7493195034215">Number of workers in a training job. Obtain the maximum value from <a href="modelarts_03_0072.html">Querying Job Resource Specifications</a>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001943866677__row24971850184213"><td class="cellrowborder" valign="top" width="15.88888888888889%" headers="mcps1.3.4.2.5.1.1 "><p id="EN-US_TOPIC_0000001943866677__p115007506428">app_url</p>
</td>
<td class="cellrowborder" valign="top" width="15.585858585858587%" headers="mcps1.3.4.2.5.1.2 "><p id="EN-US_TOPIC_0000001943866677__p950317501429">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="15.686868686868685%" headers="mcps1.3.4.2.5.1.3 "><p id="EN-US_TOPIC_0000001943866677__p1750655034220">String</p>
</td>
<td class="cellrowborder" valign="top" width="52.83838383838384%" headers="mcps1.3.4.2.5.1.4 "><p id="EN-US_TOPIC_0000001943866677__p750985094216">Code directory of a training job, for example, <span class="filepath" id="EN-US_TOPIC_0000001943866677__filepath15741631105912"><b>/usr/app/</b></span>. This parameter must be used together with <strong id="EN-US_TOPIC_0000001943866677__b939371815531">boot_file_url</strong>. After setting <strong id="EN-US_TOPIC_0000001943866677__b03931918205316">model_id</strong>, you do not need to set <strong id="EN-US_TOPIC_0000001943866677__b1639411865315">app_url</strong> or <strong id="EN-US_TOPIC_0000001943866677__b8395418145319">boot_file_url</strong>, and <strong id="EN-US_TOPIC_0000001943866677__b83951618135317">engine_id</strong>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001943866677__row165164501428"><td class="cellrowborder" valign="top" width="15.88888888888889%" headers="mcps1.3.4.2.5.1.1 "><p id="EN-US_TOPIC_0000001943866677__p35209501423">boot_file_url</p>
</td>
<td class="cellrowborder" valign="top" width="15.585858585858587%" headers="mcps1.3.4.2.5.1.2 "><p id="EN-US_TOPIC_0000001943866677__p552245012421">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="15.686868686868685%" headers="mcps1.3.4.2.5.1.3 "><p id="EN-US_TOPIC_0000001943866677__p1352695094216">String</p>
</td>
<td class="cellrowborder" valign="top" width="52.83838383838384%" headers="mcps1.3.4.2.5.1.4 "><p id="EN-US_TOPIC_0000001943866677__p1052817508427">Boot file of a training job, which needs to be stored in the code directory. Example value: <span class="filepath" id="EN-US_TOPIC_0000001943866677__filepath396935165611"><b>/usr/app/boot.py</b></span> This parameter must be used together with <strong id="EN-US_TOPIC_0000001943866677__b3589619185313">app_url</strong>. After setting <strong id="EN-US_TOPIC_0000001943866677__b2590101915534">model_id</strong>, you do not need to set <strong id="EN-US_TOPIC_0000001943866677__b14590171925313">app_url</strong> or <strong id="EN-US_TOPIC_0000001943866677__b145911197532">boot_file_url</strong>, and <strong id="EN-US_TOPIC_0000001943866677__b7591171965315">engine_id</strong>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001943866677__row195333503423"><td class="cellrowborder" valign="top" width="15.88888888888889%" headers="mcps1.3.4.2.5.1.1 "><p id="EN-US_TOPIC_0000001943866677__p953625011422">parameter</p>
</td>
<td class="cellrowborder" valign="top" width="15.585858585858587%" headers="mcps1.3.4.2.5.1.2 "><p id="EN-US_TOPIC_0000001943866677__p264164011111">No</p>
</td>
<td class="cellrowborder" valign="top" width="15.686868686868685%" headers="mcps1.3.4.2.5.1.3 "><p id="EN-US_TOPIC_0000001943866677__p1254318503423">Array&lt;Object&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="52.83838383838384%" headers="mcps1.3.4.2.5.1.4 "><p id="EN-US_TOPIC_0000001943866677__p054735020422">Running parameters of a training job. It is a collection of label-value pairs. For details, see the sample request. This parameter is a container environment variable when a training job uses a custom image. For details, see <a href="#EN-US_TOPIC_0000001943866677__table1267642234716">Table 5</a>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001943866677__row6549145024219"><td class="cellrowborder" valign="top" width="15.88888888888889%" headers="mcps1.3.4.2.5.1.1 "><p id="EN-US_TOPIC_0000001943866677__p95545506421">data_url</p>
</td>
<td class="cellrowborder" valign="top" width="15.585858585858587%" headers="mcps1.3.4.2.5.1.2 "><p id="EN-US_TOPIC_0000001943866677__p655755054219">No</p>
</td>
<td class="cellrowborder" valign="top" width="15.686868686868685%" headers="mcps1.3.4.2.5.1.3 "><p id="EN-US_TOPIC_0000001943866677__p1156015505422">String</p>
</td>
<td class="cellrowborder" valign="top" width="52.83838383838384%" headers="mcps1.3.4.2.5.1.4 "><p id="EN-US_TOPIC_0000001943866677__p124797452224">OBS URL of the dataset required by a training job. By default, this parameter is left blank. For example, <span class="parmvalue" id="EN-US_TOPIC_0000001943866677__parmvalue94141222112612"><b>/usr/data/</b></span>. This parameter cannot be used together with <strong id="EN-US_TOPIC_0000001943866677__b16174102153617">data_source</strong> or <strong id="EN-US_TOPIC_0000001943866677__b121759211365">dataset_id</strong> and <strong id="EN-US_TOPIC_0000001943866677__b717516214364">dataset_version_id</strong>. However, one of the parameters must exist.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001943866677__row1557018505421"><td class="cellrowborder" valign="top" width="15.88888888888889%" headers="mcps1.3.4.2.5.1.1 "><p id="EN-US_TOPIC_0000001943866677__p1857315014211">dataset_id</p>
</td>
<td class="cellrowborder" valign="top" width="15.585858585858587%" headers="mcps1.3.4.2.5.1.2 "><p id="EN-US_TOPIC_0000001943866677__p6578165015427">No</p>
</td>
<td class="cellrowborder" valign="top" width="15.686868686868685%" headers="mcps1.3.4.2.5.1.3 "><p id="EN-US_TOPIC_0000001943866677__p185801150184211">String</p>
</td>
<td class="cellrowborder" valign="top" width="52.83838383838384%" headers="mcps1.3.4.2.5.1.4 "><p id="EN-US_TOPIC_0000001943866677__p8319175510226">Dataset ID of a training job. This parameter must be used together with <strong id="EN-US_TOPIC_0000001943866677__b1561202915246">dataset_version_id</strong>, but cannot be used together with <strong id="EN-US_TOPIC_0000001943866677__b10561112912241">data_url</strong> or <strong id="EN-US_TOPIC_0000001943866677__b7561202913241">data_source</strong>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001943866677__row758516502428"><td class="cellrowborder" valign="top" width="15.88888888888889%" headers="mcps1.3.4.2.5.1.1 "><p id="EN-US_TOPIC_0000001943866677__p18589165044211">dataset_version_id</p>
</td>
<td class="cellrowborder" valign="top" width="15.585858585858587%" headers="mcps1.3.4.2.5.1.2 "><p id="EN-US_TOPIC_0000001943866677__p16592155011420">No</p>
</td>
<td class="cellrowborder" valign="top" width="15.686868686868685%" headers="mcps1.3.4.2.5.1.3 "><p id="EN-US_TOPIC_0000001943866677__p45954508425">String</p>
</td>
<td class="cellrowborder" valign="top" width="52.83838383838384%" headers="mcps1.3.4.2.5.1.4 "><p id="EN-US_TOPIC_0000001943866677__p7926708231">Dataset version ID of a training job. This parameter must be used together with <strong id="EN-US_TOPIC_0000001943866677__b0460231202418">dataset_id</strong>, but cannot be used together with <strong id="EN-US_TOPIC_0000001943866677__b194602318241">data_url</strong> or <strong id="EN-US_TOPIC_0000001943866677__b12461153115248">data_source</strong>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001943866677__row54426516577"><td class="cellrowborder" valign="top" width="15.88888888888889%" headers="mcps1.3.4.2.5.1.1 "><p id="EN-US_TOPIC_0000001943866677__p1084415185810">data_source</p>
</td>
<td class="cellrowborder" valign="top" width="15.585858585858587%" headers="mcps1.3.4.2.5.1.2 "><p id="EN-US_TOPIC_0000001943866677__p9844121105816">No</p>
</td>
<td class="cellrowborder" valign="top" width="15.686868686868685%" headers="mcps1.3.4.2.5.1.3 "><p id="EN-US_TOPIC_0000001943866677__p18441318589">JSON Array</p>
</td>
<td class="cellrowborder" valign="top" width="52.83838383838384%" headers="mcps1.3.4.2.5.1.4 "><p id="EN-US_TOPIC_0000001943866677__p884414112581">Dataset of a training job. This parameter cannot be used with <strong id="EN-US_TOPIC_0000001943866677__b14941173811479">data_url</strong>, <strong id="EN-US_TOPIC_0000001943866677__b1494113389471">dataset_id</strong>, or <strong id="EN-US_TOPIC_0000001943866677__b11941143884718">dataset_version_id</strong>. For details, see <a href="#EN-US_TOPIC_0000001943866677__table8406183645819">Table 4</a>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001943866677__row861516503426"><td class="cellrowborder" valign="top" width="15.88888888888889%" headers="mcps1.3.4.2.5.1.1 "><p id="EN-US_TOPIC_0000001943866677__p1561955014420">spec_id</p>
</td>
<td class="cellrowborder" valign="top" width="15.585858585858587%" headers="mcps1.3.4.2.5.1.2 "><p id="EN-US_TOPIC_0000001943866677__p7623250164211">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="15.686868686868685%" headers="mcps1.3.4.2.5.1.3 "><p id="EN-US_TOPIC_0000001943866677__p8627175017420">Long</p>
</td>
<td class="cellrowborder" valign="top" width="52.83838383838384%" headers="mcps1.3.4.2.5.1.4 "><p id="EN-US_TOPIC_0000001943866677__p7631195024211">ID of the resource specifications selected for a training job. Obtain the ID by calling the API described in <a href="modelarts_03_0072.html">Querying Job Resource Specifications</a>. When creating a public pool job, ensure that <strong id="EN-US_TOPIC_0000001943866677__b710415513217">spec_id</strong> is mandatory and cannot be used with <strong id="EN-US_TOPIC_0000001943866677__b3104753326">pool_id</strong>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001943866677__row15165202514587"><td class="cellrowborder" valign="top" width="15.88888888888889%" headers="mcps1.3.4.2.5.1.1 "><p id="EN-US_TOPIC_0000001943866677__p14730173517491">pool_id</p>
</td>
<td class="cellrowborder" valign="top" width="15.585858585858587%" headers="mcps1.3.4.2.5.1.2 "><p id="EN-US_TOPIC_0000001943866677__p373016357494">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="15.686868686868685%" headers="mcps1.3.4.2.5.1.3 "><p id="EN-US_TOPIC_0000001943866677__p1473016359496">String</p>
</td>
<td class="cellrowborder" valign="top" width="52.83838383838384%" headers="mcps1.3.4.2.5.1.4 "><p id="EN-US_TOPIC_0000001943866677__p1873018356494">ID of a dedicated resource pool. To obtain the ID, do as follows: Log in to the ModelArts management console, choose <strong id="EN-US_TOPIC_0000001943866677__b187065175329">Dedicated Resource Pools</strong> in the navigation pane on the left, and view the resource pool ID in the dedicated resource pool list. When creating a dedicated pool job, ensure that <strong id="EN-US_TOPIC_0000001943866677__b9628122483214">pool_id</strong> is mandatory and cannot be used with <strong id="EN-US_TOPIC_0000001943866677__b1662815242324">spec_id</strong>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001943866677__row1463518500426"><td class="cellrowborder" valign="top" width="15.88888888888889%" headers="mcps1.3.4.2.5.1.1 "><p id="EN-US_TOPIC_0000001943866677__p863845013426">engine_id</p>
</td>
<td class="cellrowborder" valign="top" width="15.585858585858587%" headers="mcps1.3.4.2.5.1.2 "><p id="EN-US_TOPIC_0000001943866677__p1364385014215">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="15.686868686868685%" headers="mcps1.3.4.2.5.1.3 "><p id="EN-US_TOPIC_0000001943866677__p36461950144210">Long</p>
</td>
<td class="cellrowborder" valign="top" width="52.83838383838384%" headers="mcps1.3.4.2.5.1.4 "><p id="EN-US_TOPIC_0000001943866677__p565095012422">ID of the engine selected for a training job. The default value is <strong id="EN-US_TOPIC_0000001943866677__b159289151343">1</strong>. After setting <strong id="EN-US_TOPIC_0000001943866677__b712524945319">model_id</strong>, you do not need to set <strong id="EN-US_TOPIC_0000001943866677__b15126194965320">app_url</strong> or <strong id="EN-US_TOPIC_0000001943866677__b19126174920530">boot_file_url</strong>, and <strong id="EN-US_TOPIC_0000001943866677__b1312794945316">engine_id</strong>. Obtain the ID by calling the API described in <a href="modelarts_03_0073.html">Querying Job Engine Specifications</a>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001943866677__row106552050104214"><td class="cellrowborder" valign="top" width="15.88888888888889%" headers="mcps1.3.4.2.5.1.1 "><p id="EN-US_TOPIC_0000001943866677__p156581250164216">model_id</p>
</td>
<td class="cellrowborder" valign="top" width="15.585858585858587%" headers="mcps1.3.4.2.5.1.2 "><p id="EN-US_TOPIC_0000001943866677__p13663150124212">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="15.686868686868685%" headers="mcps1.3.4.2.5.1.3 "><p id="EN-US_TOPIC_0000001943866677__p7666205074220">Long</p>
</td>
<td class="cellrowborder" valign="top" width="52.83838383838384%" headers="mcps1.3.4.2.5.1.4 "><p id="EN-US_TOPIC_0000001943866677__p7670350184219">ID of the built-in model of a training job. After setting <strong id="EN-US_TOPIC_0000001943866677__b7397434122719">model_id</strong>, you do not need to set <strong id="EN-US_TOPIC_0000001943866677__b186775062814">app_url</strong> or <strong id="EN-US_TOPIC_0000001943866677__b374717316283">boot_file_url</strong>, and <strong id="EN-US_TOPIC_0000001943866677__b871266142810">engine_id</strong>. </p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001943866677__row146729508427"><td class="cellrowborder" valign="top" width="15.88888888888889%" headers="mcps1.3.4.2.5.1.1 "><p id="EN-US_TOPIC_0000001943866677__p20674175024219">train_url</p>
</td>
<td class="cellrowborder" valign="top" width="15.585858585858587%" headers="mcps1.3.4.2.5.1.2 "><p id="EN-US_TOPIC_0000001943866677__p1467711509420">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="15.686868686868685%" headers="mcps1.3.4.2.5.1.3 "><p id="EN-US_TOPIC_0000001943866677__p9679185016423">String</p>
</td>
<td class="cellrowborder" valign="top" width="52.83838383838384%" headers="mcps1.3.4.2.5.1.4 "><p id="EN-US_TOPIC_0000001943866677__p76822506429">OBS URL of the output file of a training job. By default, this parameter is left blank. Example value: <span class="filepath" id="EN-US_TOPIC_0000001943866677__filepath079401748"><b>/bucket/trainUrl/</b></span></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001943866677__row17687185064211"><td class="cellrowborder" valign="top" width="15.88888888888889%" headers="mcps1.3.4.2.5.1.1 "><p id="EN-US_TOPIC_0000001943866677__p106881050154220">log_url</p>
</td>
<td class="cellrowborder" valign="top" width="15.585858585858587%" headers="mcps1.3.4.2.5.1.2 "><p id="EN-US_TOPIC_0000001943866677__p069365094212">No</p>
</td>
<td class="cellrowborder" valign="top" width="15.686868686868685%" headers="mcps1.3.4.2.5.1.3 "><p id="EN-US_TOPIC_0000001943866677__p1369555013425">String</p>
</td>
<td class="cellrowborder" valign="top" width="52.83838383838384%" headers="mcps1.3.4.2.5.1.4 "><p id="EN-US_TOPIC_0000001943866677__p9699950194211">OBS URL of the logs of a training job. By default, this parameter is left blank. Example value: <span class="filepath" id="EN-US_TOPIC_0000001943866677__filepath770045019429"><b>/usr/train/</b></span></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001943866677__row107031350174220"><td class="cellrowborder" valign="top" width="15.88888888888889%" headers="mcps1.3.4.2.5.1.1 "><p id="EN-US_TOPIC_0000001943866677__p1970615018424">pre_version_id</p>
</td>
<td class="cellrowborder" valign="top" width="15.585858585858587%" headers="mcps1.3.4.2.5.1.2 "><p id="EN-US_TOPIC_0000001943866677__p134651441175419">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="15.686868686868685%" headers="mcps1.3.4.2.5.1.3 "><p id="EN-US_TOPIC_0000001943866677__p167121150204214">Long</p>
</td>
<td class="cellrowborder" valign="top" width="52.83838383838384%" headers="mcps1.3.4.2.5.1.4 "><p id="EN-US_TOPIC_0000001943866677__p1871410504425">ID of the previous version of a training job. You can obtain the value of <span class="parmname" id="EN-US_TOPIC_0000001943866677__parmname89116206271"><b>version_id</b></span> by calling the API described in <a href="modelarts_03_0049.html">Obtaining Training Job Versions</a>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001943866677__row1481031715130"><td class="cellrowborder" valign="top" width="15.88888888888889%" headers="mcps1.3.4.2.5.1.1 "><p id="EN-US_TOPIC_0000001943866677__p255514164311">user_image_url</p>
</td>
<td class="cellrowborder" valign="top" width="15.585858585858587%" headers="mcps1.3.4.2.5.1.2 "><p id="EN-US_TOPIC_0000001943866677__p5555144113435">No</p>
</td>
<td class="cellrowborder" valign="top" width="15.686868686868685%" headers="mcps1.3.4.2.5.1.3 "><p id="EN-US_TOPIC_0000001943866677__p5555841114318">String</p>
</td>
<td class="cellrowborder" valign="top" width="52.83838383838384%" headers="mcps1.3.4.2.5.1.4 "><p id="EN-US_TOPIC_0000001943866677__p755554118434">SWR URL of a custom image used by a training job. Example value: <span class="filepath" id="EN-US_TOPIC_0000001943866677__filepath19338458112612"><b>100.125.5.235:20202/jobmng/custom-cpu-base:1.0</b></span></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001943866677__row11159023151316"><td class="cellrowborder" valign="top" width="15.88888888888889%" headers="mcps1.3.4.2.5.1.1 "><p id="EN-US_TOPIC_0000001943866677__p46411034174620">user_command</p>
</td>
<td class="cellrowborder" valign="top" width="15.585858585858587%" headers="mcps1.3.4.2.5.1.2 "><p id="EN-US_TOPIC_0000001943866677__p11641434154610">No</p>
</td>
<td class="cellrowborder" valign="top" width="15.686868686868685%" headers="mcps1.3.4.2.5.1.3 "><p id="EN-US_TOPIC_0000001943866677__p1364113434619">String</p>
</td>
<td class="cellrowborder" valign="top" width="52.83838383838384%" headers="mcps1.3.4.2.5.1.4 "><p id="EN-US_TOPIC_0000001943866677__p17641113410465">Boot command used to start the container of a custom image of a training job. The format is <span class="filepath" id="EN-US_TOPIC_0000001943866677__filepath769451672714"><b>bash /home/work/run_train.sh python /home/work/user-job-dir/app/train.py {python_file_parameter}</b></span>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001943866677__table8406183645819"></a><a name="table8406183645819"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001943866677__table8406183645819" frame="border" border="1" rules="all"><caption><b>Table 4 </b><strong id="EN-US_TOPIC_0000001943866677__b64871469573">data_source</strong> parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001943866677__row4406143610583"><th align="left" class="cellrowborder" valign="top" width="15.959999999999999%" id="mcps1.3.5.2.5.1.1"><p id="EN-US_TOPIC_0000001943866677__p1527511378117">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="15.5%" id="mcps1.3.5.2.5.1.2"><p id="EN-US_TOPIC_0000001943866677__p1628153716110">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="11.78%" id="mcps1.3.5.2.5.1.3"><p id="EN-US_TOPIC_0000001943866677__p22831437411">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="56.76%" id="mcps1.3.5.2.5.1.4"><p id="EN-US_TOPIC_0000001943866677__p328510371619">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001943866677__row11406143675818"><td class="cellrowborder" valign="top" width="15.959999999999999%" headers="mcps1.3.5.2.5.1.1 "><p id="EN-US_TOPIC_0000001943866677__p1680105517118">dataset_id</p>
</td>
<td class="cellrowborder" valign="top" width="15.5%" headers="mcps1.3.5.2.5.1.2 "><p id="EN-US_TOPIC_0000001943866677__p2804555115">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.78%" headers="mcps1.3.5.2.5.1.3 "><p id="EN-US_TOPIC_0000001943866677__p1180619554119">String</p>
</td>
<td class="cellrowborder" valign="top" width="56.76%" headers="mcps1.3.5.2.5.1.4 "><p id="EN-US_TOPIC_0000001943866677__p18097554112">Dataset ID of a training job. This parameter must be used together with <strong id="EN-US_TOPIC_0000001943866677__b78101781135">dataset_version_id</strong>, but cannot be used together with <strong id="EN-US_TOPIC_0000001943866677__b19810108133">data_url</strong>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001943866677__row1840643645816"><td class="cellrowborder" valign="top" width="15.959999999999999%" headers="mcps1.3.5.2.5.1.1 "><p id="EN-US_TOPIC_0000001943866677__p118131955110">dataset_version</p>
</td>
<td class="cellrowborder" valign="top" width="15.5%" headers="mcps1.3.5.2.5.1.2 "><p id="EN-US_TOPIC_0000001943866677__p148201755118">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.78%" headers="mcps1.3.5.2.5.1.3 "><p id="EN-US_TOPIC_0000001943866677__p1282320551611">String</p>
</td>
<td class="cellrowborder" valign="top" width="56.76%" headers="mcps1.3.5.2.5.1.4 "><p id="EN-US_TOPIC_0000001943866677__p0823205511117">Dataset version ID of a training job. This parameter must be used together with <strong id="EN-US_TOPIC_0000001943866677__b137067141738">dataset_id</strong>, but cannot be used together with <strong id="EN-US_TOPIC_0000001943866677__b6707111415315">data_url</strong>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001943866677__row19408183610587"><td class="cellrowborder" valign="top" width="15.959999999999999%" headers="mcps1.3.5.2.5.1.1 "><p id="EN-US_TOPIC_0000001943866677__p16892761827">type</p>
</td>
<td class="cellrowborder" valign="top" width="15.5%" headers="mcps1.3.5.2.5.1.2 "><p id="EN-US_TOPIC_0000001943866677__p1892116628">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.78%" headers="mcps1.3.5.2.5.1.3 "><p id="EN-US_TOPIC_0000001943866677__p188923615217">String</p>
</td>
<td class="cellrowborder" valign="top" width="56.76%" headers="mcps1.3.5.2.5.1.4 "><p id="EN-US_TOPIC_0000001943866677__p88921866216">Dataset type. The value can be <span class="parmvalue" id="EN-US_TOPIC_0000001943866677__parmvalue146010194583"><b>obs</b></span> or <span class="parmvalue" id="EN-US_TOPIC_0000001943866677__parmvalue1860191985818"><b>dataset</b></span>. <strong id="EN-US_TOPIC_0000001943866677__b162851717136">obs</strong> and <strong id="EN-US_TOPIC_0000001943866677__b328541717315">dataset</strong> cannot be used at the same time.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001943866677__row18404183842111"><td class="cellrowborder" valign="top" width="15.959999999999999%" headers="mcps1.3.5.2.5.1.1 "><p id="EN-US_TOPIC_0000001943866677__p13117227131918">data_url</p>
</td>
<td class="cellrowborder" valign="top" width="15.5%" headers="mcps1.3.5.2.5.1.2 "><p id="EN-US_TOPIC_0000001943866677__p131171127181920">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.78%" headers="mcps1.3.5.2.5.1.3 "><p id="EN-US_TOPIC_0000001943866677__p011752719191">String</p>
</td>
<td class="cellrowborder" valign="top" width="56.76%" headers="mcps1.3.5.2.5.1.4 "><p id="EN-US_TOPIC_0000001943866677__p141171327171918">OBS bucket path. This parameter cannot be used together with <strong id="EN-US_TOPIC_0000001943866677__b26552719442">dataset_id</strong> or <strong id="EN-US_TOPIC_0000001943866677__b166511277444">dataset_version</strong>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001943866677__table1267642234716"></a><a name="table1267642234716"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001943866677__table1267642234716" frame="border" border="1" rules="all"><caption><b>Table 5 </b><strong id="EN-US_TOPIC_0000001943866677__b17669773216">parameter</strong> parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001943866677__row5677422164714"><th align="left" class="cellrowborder" valign="top" width="16.198380161983803%" id="mcps1.3.6.2.5.1.1"><p id="EN-US_TOPIC_0000001943866677__p7296205262817">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="15.14848515148485%" id="mcps1.3.6.2.5.1.2"><p id="EN-US_TOPIC_0000001943866677__p5194191034416">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="12.03879612038796%" id="mcps1.3.6.2.5.1.3"><p id="EN-US_TOPIC_0000001943866677__p196771122154718">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="56.61433856614339%" id="mcps1.3.6.2.5.1.4"><p id="EN-US_TOPIC_0000001943866677__p5677022194719">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001943866677__row2677192224717"><td class="cellrowborder" valign="top" width="16.198380161983803%" headers="mcps1.3.6.2.5.1.1 "><p id="EN-US_TOPIC_0000001943866677__p14677192217478">label</p>
</td>
<td class="cellrowborder" valign="top" width="15.14848515148485%" headers="mcps1.3.6.2.5.1.2 "><p id="EN-US_TOPIC_0000001943866677__p17194710144418">No</p>
</td>
<td class="cellrowborder" valign="top" width="12.03879612038796%" headers="mcps1.3.6.2.5.1.3 "><p id="EN-US_TOPIC_0000001943866677__p16677112218473">String</p>
</td>
<td class="cellrowborder" valign="top" width="56.61433856614339%" headers="mcps1.3.6.2.5.1.4 "><p id="EN-US_TOPIC_0000001943866677__p10677142210478">Parameter name</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001943866677__row5528181488"><td class="cellrowborder" valign="top" width="16.198380161983803%" headers="mcps1.3.6.2.5.1.1 "><p id="EN-US_TOPIC_0000001943866677__p05295804810">value</p>
</td>
<td class="cellrowborder" valign="top" width="15.14848515148485%" headers="mcps1.3.6.2.5.1.2 "><p id="EN-US_TOPIC_0000001943866677__p0194410164417">No</p>
</td>
<td class="cellrowborder" valign="top" width="12.03879612038796%" headers="mcps1.3.6.2.5.1.3 "><p id="EN-US_TOPIC_0000001943866677__p135299824812">String</p>
</td>
<td class="cellrowborder" valign="top" width="56.61433856614339%" headers="mcps1.3.6.2.5.1.4 "><p id="EN-US_TOPIC_0000001943866677__p1652913874819">Parameter value</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="section" id="EN-US_TOPIC_0000001943866677__section25275946"><h4 class="sectiontitle">Response Body</h4><div class="p" id="EN-US_TOPIC_0000001943866677__p97043121344"><a href="#EN-US_TOPIC_0000001943866677__table1221422915578">Table 6</a> describes the response parameters.
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001943866677__table1221422915578"></a><a name="table1221422915578"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001943866677__table1221422915578" frame="border" border="1" rules="all"><caption><b>Table 6 </b>Parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001943866677__row6616560815578"><th align="left" class="cellrowborder" valign="top" width="16.68%" id="mcps1.3.7.2.2.2.4.1.1"><p id="EN-US_TOPIC_0000001943866677__p39128198155725">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="12.36%" id="mcps1.3.7.2.2.2.4.1.2"><p id="EN-US_TOPIC_0000001943866677__p28702598155725">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="70.96000000000001%" id="mcps1.3.7.2.2.2.4.1.3"><p id="EN-US_TOPIC_0000001943866677__p43209091155725">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001943866677__row14462014342"><td class="cellrowborder" valign="top" width="16.68%" headers="mcps1.3.7.2.2.2.4.1.1 "><p id="EN-US_TOPIC_0000001943866677__p2530905217407">is_success</p>
</td>
<td class="cellrowborder" valign="top" width="12.36%" headers="mcps1.3.7.2.2.2.4.1.2 "><p id="EN-US_TOPIC_0000001943866677__p2536505617407">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="70.96000000000001%" headers="mcps1.3.7.2.2.2.4.1.3 "><p id="EN-US_TOPIC_0000001943866677__p4130369517407">Whether the request is successful</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001943866677__row1757872301417"><td class="cellrowborder" valign="top" width="16.68%" headers="mcps1.3.7.2.2.2.4.1.1 "><p id="EN-US_TOPIC_0000001943866677__p1358132391416">error_message</p>
</td>
<td class="cellrowborder" valign="top" width="12.36%" headers="mcps1.3.7.2.2.2.4.1.2 "><p id="EN-US_TOPIC_0000001943866677__p11581182310140">String</p>
</td>
<td class="cellrowborder" valign="top" width="70.96000000000001%" headers="mcps1.3.7.2.2.2.4.1.3 "><p id="EN-US_TOPIC_0000001943866677__p202911533131416">Error message of a failed API call.</p>
<p id="EN-US_TOPIC_0000001943866677__p729215339148">This parameter is not included when the API call succeeds.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001943866677__row4566967315578"><td class="cellrowborder" valign="top" width="16.68%" headers="mcps1.3.7.2.2.2.4.1.1 "><p id="EN-US_TOPIC_0000001943866677__p25254004155725">error_code</p>
</td>
<td class="cellrowborder" valign="top" width="12.36%" headers="mcps1.3.7.2.2.2.4.1.2 "><p id="EN-US_TOPIC_0000001943866677__p66849440155725">String</p>
</td>
<td class="cellrowborder" valign="top" width="70.96000000000001%" headers="mcps1.3.7.2.2.2.4.1.3 "><p id="EN-US_TOPIC_0000001943866677__p46095573155725">Error code of a failed API call. For details, see <a href="modelarts_03_0095.html">Error Codes</a>. This parameter is not included when the API call succeeds.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001943866677__row104915119203"><td class="cellrowborder" valign="top" width="16.68%" headers="mcps1.3.7.2.2.2.4.1.1 "><p id="EN-US_TOPIC_0000001943866677__p18430106192915">job_id</p>
</td>
<td class="cellrowborder" valign="top" width="12.36%" headers="mcps1.3.7.2.2.2.4.1.2 "><p id="EN-US_TOPIC_0000001943866677__p94311965291">Long</p>
</td>
<td class="cellrowborder" valign="top" width="70.96000000000001%" headers="mcps1.3.7.2.2.2.4.1.3 "><p id="EN-US_TOPIC_0000001943866677__p7431126162912">ID of a training job</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001943866677__row219618114201"><td class="cellrowborder" valign="top" width="16.68%" headers="mcps1.3.7.2.2.2.4.1.1 "><p id="EN-US_TOPIC_0000001943866677__p11431465292">job_name</p>
</td>
<td class="cellrowborder" valign="top" width="12.36%" headers="mcps1.3.7.2.2.2.4.1.2 "><p id="EN-US_TOPIC_0000001943866677__p154311563298">String</p>
</td>
<td class="cellrowborder" valign="top" width="70.96000000000001%" headers="mcps1.3.7.2.2.2.4.1.3 "><p id="EN-US_TOPIC_0000001943866677__p64311167292">Name of a training job</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001943866677__row163366114205"><td class="cellrowborder" valign="top" width="16.68%" headers="mcps1.3.7.2.2.2.4.1.1 "><p id="EN-US_TOPIC_0000001943866677__p1743116616294">status</p>
</td>
<td class="cellrowborder" valign="top" width="12.36%" headers="mcps1.3.7.2.2.2.4.1.2 "><p id="EN-US_TOPIC_0000001943866677__p1643126142916">Int</p>
</td>
<td class="cellrowborder" valign="top" width="70.96000000000001%" headers="mcps1.3.7.2.2.2.4.1.3 "><p id="EN-US_TOPIC_0000001943866677__p1243186182915">Status of a training job. For details about the job statuses, see <a href="modelarts_03_0074.html">Job Statuses</a>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001943866677__row124696114209"><td class="cellrowborder" valign="top" width="16.68%" headers="mcps1.3.7.2.2.2.4.1.1 "><p id="EN-US_TOPIC_0000001943866677__p243118619298">create_time</p>
</td>
<td class="cellrowborder" valign="top" width="12.36%" headers="mcps1.3.7.2.2.2.4.1.2 "><p id="EN-US_TOPIC_0000001943866677__p843212615294">Long</p>
</td>
<td class="cellrowborder" valign="top" width="70.96000000000001%" headers="mcps1.3.7.2.2.2.4.1.3 "><p id="EN-US_TOPIC_0000001943866677__p54327616294">Timestamp when a training job is created</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001943866677__row122916168204"><td class="cellrowborder" valign="top" width="16.68%" headers="mcps1.3.7.2.2.2.4.1.1 "><p id="EN-US_TOPIC_0000001943866677__p104326642913">version_id</p>
</td>
<td class="cellrowborder" valign="top" width="12.36%" headers="mcps1.3.7.2.2.2.4.1.2 "><p id="EN-US_TOPIC_0000001943866677__p9432065298">Long</p>
</td>
<td class="cellrowborder" valign="top" width="70.96000000000001%" headers="mcps1.3.7.2.2.2.4.1.3 "><p id="EN-US_TOPIC_0000001943866677__p124323614296">Version ID of a training job</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001943866677__row159299233524"><td class="cellrowborder" valign="top" width="16.68%" headers="mcps1.3.7.2.2.2.4.1.1 "><p id="EN-US_TOPIC_0000001943866677__p17635224195216">version_name</p>
</td>
<td class="cellrowborder" valign="top" width="12.36%" headers="mcps1.3.7.2.2.2.4.1.2 "><p id="EN-US_TOPIC_0000001943866677__p1163542495216">String</p>
</td>
<td class="cellrowborder" valign="top" width="70.96000000000001%" headers="mcps1.3.7.2.2.2.4.1.3 "><p id="EN-US_TOPIC_0000001943866677__p463519242528">Version name of a training job</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001943866677__section16473152018316"><h4 class="sectiontitle">Sample Request</h4><div class="p" id="EN-US_TOPIC_0000001943866677__p31801719283">The following shows how to create a job whose <span class="parmvalue" id="EN-US_TOPIC_0000001943866677__parmvalue1483917215311"><b>job_id</b></span> is <strong id="EN-US_TOPIC_0000001943866677__b7839192535">10</strong> and <span class="parmvalue" id="EN-US_TOPIC_0000001943866677__parmvalue198391526318"><b>pre_version_id</b></span> is <strong id="EN-US_TOPIC_0000001943866677__b138391321538">20</strong>.<pre class="screen" id="EN-US_TOPIC_0000001943866677__screen19911284400">POST https://endpoint/v1/{project_id}/training-jobs/10/versions/
{
"job_desc": "This is a ModelArts job",
"config": {
"worker_server_num": 1,
"app_url": "/usr/app/",
"boot_file_url": "/usr/app/boot.py",
"parameter": [
{
"label": "learning_rate",
"value": "0.01"
},
{
"label": "batch_size",
"value": "32"
}
],
"dataset_id": "38277e62-9e59-48f4-8d89-c8cf41622c24",
"dataset_version_id": "2ff0d6ba-c480-45ae-be41-09a8369bfc90",
"spec_id": 1,
"engine_id": 1,
"train_url": "/usr/train/",
"log_url": "/usr/log/",
"pre_version_id": 20,
"model_id": 1,
"pool_id": "test-pool"
}
}</pre>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001943866677__section14624143162812"><h4 class="sectiontitle">Sample Response</h4><ul id="EN-US_TOPIC_0000001943866677__ul633814466283"><li id="EN-US_TOPIC_0000001943866677__li15339194642811">Successful response<pre class="screen" id="EN-US_TOPIC_0000001943866677__screen103391946192812">{
"is_success": true,
"job_id": 10,
"job_name": "TestModelArtsJob",
"status": 1,
"create_time": 1524189990635,
"version_id": 10,
"version_name":"V0001"
}</pre>
</li><li id="EN-US_TOPIC_0000001943866677__li103392046132813">Failed response<pre class="screen" id="EN-US_TOPIC_0000001943866677__screen333934612281">{
"is_success": false,
"error_message": "Error string",
"error_code": "ModelArts.0105"
}</pre>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001943866677__section53211112201510"><h4 class="sectiontitle">Status Code</h4><p id="EN-US_TOPIC_0000001943866677__p10324101251511">For details about the status code, see <a href="modelarts_03_0094.html">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>
View Git Blame Copy Permalink