doc-exports/docs/dataartsstudio/api-ref/dataartsstudio_02_0065.html
Xiong, Chen Xiao 14a6d65e8c DataArts API 20240130 version
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com>
Co-authored-by: Xiong, Chen Xiao <chenxiaoxiong@huawei.com>
Co-committed-by: Xiong, Chen Xiao <chenxiaoxiong@huawei.com>
2024-03-01 11:46:15 +00:00

146 lines
13 KiB
HTML

<a name="dataartsstudio_02_0065"></a><a name="dataartsstudio_02_0065"></a>
<h1 class="topictitle1">Deleting a Job</h1>
<div id="body0000001104334890"><div class="section" id="dataartsstudio_02_0065__en-us_topic_0181281358_section1738101810182"><h4 class="sectiontitle">Function</h4><p id="dataartsstudio_02_0065__en-us_topic_0181281358_p1912913467404">This API is used to delete a job.</p>
</div>
<div class="section" id="dataartsstudio_02_0065__en-us_topic_0181281358_section102234449285"><h4 class="sectiontitle">URI</h4><ul id="dataartsstudio_02_0065__en-us_topic_0181281358_ul145591424184717"><li id="dataartsstudio_02_0065__en-us_topic_0181281358_li356152404715">URI format<p id="dataartsstudio_02_0065__en-us_topic_0181281358_p076674419427"><a name="dataartsstudio_02_0065__en-us_topic_0181281358_li356152404715"></a><a name="en-us_topic_0181281358_li356152404715"></a>DELETE /v1/{project_id}/jobs/{job_name}</p>
</li></ul>
<ul id="dataartsstudio_02_0065__en-us_topic_0181281358_ul1370917277482"><li id="dataartsstudio_02_0065__en-us_topic_0181281358_li170972720484">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dataartsstudio_02_0065__en-us_topic_0181281358_en-us_topic_0093082049_table46023801181358" frame="border" border="1" rules="all"><caption><b>Table 1 </b>URI parameters</caption><thead align="left"><tr id="dataartsstudio_02_0065__en-us_topic_0181281358_en-us_topic_0093082049_row26974916181358"><th align="left" class="cellrowborder" valign="top" width="20.39%" id="mcps1.3.2.3.1.1.2.5.1.1"><p id="dataartsstudio_02_0065__en-us_topic_0181281358_en-us_topic_0093082049_p37484572181358">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="10.530000000000001%" id="mcps1.3.2.3.1.1.2.5.1.2"><p id="dataartsstudio_02_0065__en-us_topic_0181281358_en-us_topic_0093082049_p16351468181358">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="15.61%" id="mcps1.3.2.3.1.1.2.5.1.3"><p id="dataartsstudio_02_0065__en-us_topic_0181281358_en-us_topic_0093082049_p49400541181358">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="53.47%" id="mcps1.3.2.3.1.1.2.5.1.4"><p id="dataartsstudio_02_0065__en-us_topic_0181281358_en-us_topic_0093082049_p42020886181358">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dataartsstudio_02_0065__en-us_topic_0181281358_en-us_topic_0093082049_row48248640181358"><td class="cellrowborder" valign="top" width="20.39%" headers="mcps1.3.2.3.1.1.2.5.1.1 "><p id="dataartsstudio_02_0065__en-us_topic_0181281358_en-us_topic_0093082049_p15825795181358">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="10.530000000000001%" headers="mcps1.3.2.3.1.1.2.5.1.2 "><p id="dataartsstudio_02_0065__en-us_topic_0181281358_en-us_topic_0093082049_p6820998181358">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="15.61%" headers="mcps1.3.2.3.1.1.2.5.1.3 "><p id="dataartsstudio_02_0065__en-us_topic_0181281358_en-us_topic_0093082049_p15629937181358">String</p>
</td>
<td class="cellrowborder" valign="top" width="53.47%" headers="mcps1.3.2.3.1.1.2.5.1.4 "><p id="dataartsstudio_02_0065__en-us_topic_0181281358_p8672138175612">Project ID. For details about how to obtain a project ID, see <a href="projectid_accountid.html">Project ID and Account ID</a>.</p>
</td>
</tr>
<tr id="dataartsstudio_02_0065__en-us_topic_0181281358_row1571719661414"><td class="cellrowborder" valign="top" width="20.39%" headers="mcps1.3.2.3.1.1.2.5.1.1 "><p id="dataartsstudio_02_0065__en-us_topic_0181281358_p471876151414">job_name</p>
</td>
<td class="cellrowborder" valign="top" width="10.530000000000001%" headers="mcps1.3.2.3.1.1.2.5.1.2 "><p id="dataartsstudio_02_0065__en-us_topic_0181281358_p19718146161420">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="15.61%" headers="mcps1.3.2.3.1.1.2.5.1.3 "><p id="dataartsstudio_02_0065__en-us_topic_0181281358_p9718196161417">String</p>
</td>
<td class="cellrowborder" valign="top" width="53.47%" headers="mcps1.3.2.3.1.1.2.5.1.4 "><p id="dataartsstudio_02_0065__en-us_topic_0181281358_p2571117161416">Job name.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
<div class="section" id="dataartsstudio_02_0065__en-us_topic_0181281358_section10789431145710"><h4 class="sectiontitle">Request Parameters</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dataartsstudio_02_0065__en-us_topic_0181281358_table25071810112414" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request header parameter</caption><thead align="left"><tr id="dataartsstudio_02_0065__en-us_topic_0181281358_en-us_topic_0181281363_row3746915131710"><th align="left" class="cellrowborder" valign="top" width="15.010000000000002%" id="mcps1.3.3.2.2.5.1.1"><p id="dataartsstudio_02_0065__en-us_topic_0181281358_en-us_topic_0181281363_p131491731112013">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="16.93%" id="mcps1.3.3.2.2.5.1.2"><p id="dataartsstudio_02_0065__en-us_topic_0181281358_en-us_topic_0181281363_p3149113112204">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="18.73%" id="mcps1.3.3.2.2.5.1.3"><p id="dataartsstudio_02_0065__en-us_topic_0181281358_en-us_topic_0181281363_p13149173119204">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="49.33%" id="mcps1.3.3.2.2.5.1.4"><p id="dataartsstudio_02_0065__en-us_topic_0181281358_en-us_topic_0181281363_p11149331122017">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dataartsstudio_02_0065__en-us_topic_0181281358_en-us_topic_0181281363_row174620159179"><td class="cellrowborder" valign="top" width="15.010000000000002%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dataartsstudio_02_0065__en-us_topic_0181281358_en-us_topic_0181281363_p1150183116205">workspace</p>
</td>
<td class="cellrowborder" valign="top" width="16.93%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dataartsstudio_02_0065__en-us_topic_0181281358_en-us_topic_0181281363_p4150531152016">No</p>
</td>
<td class="cellrowborder" valign="top" width="18.73%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dataartsstudio_02_0065__en-us_topic_0181281358_en-us_topic_0181281363_p181505317209">String</p>
</td>
<td class="cellrowborder" valign="top" width="49.33%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dataartsstudio_02_0065__en-us_topic_0181281358_en-us_topic_0181281363_p169341251122511">Workspace ID.</p>
<ul id="dataartsstudio_02_0065__en-us_topic_0181281358_en-us_topic_0181281363_ul776685742514"><li id="dataartsstudio_02_0065__en-us_topic_0181281358_en-us_topic_0181281363_li076655782516">If this parameter is not set, data in the <strong id="dataartsstudio_02_0065__b1263783814306">default</strong> workspace is queried by default.</li><li id="dataartsstudio_02_0065__en-us_topic_0181281358_en-us_topic_0181281363_li788605918251">To query data in other workspaces, this header must be carried.</li></ul>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dataartsstudio_02_0065__en-us_topic_0181281374_table544435255017" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Parameters</caption><thead align="left"><tr id="dataartsstudio_02_0065__en-us_topic_0181281374_row444510523506"><th align="left" class="cellrowborder" valign="top" width="21.39%" id="mcps1.3.3.3.2.5.1.1"><p id="dataartsstudio_02_0065__en-us_topic_0181281374_p114461752155014">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="10.45%" id="mcps1.3.3.3.2.5.1.2"><p id="dataartsstudio_02_0065__en-us_topic_0181281374_p344615216509">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20.24%" id="mcps1.3.3.3.2.5.1.3"><p id="dataartsstudio_02_0065__en-us_topic_0181281374_p14446165285019">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="47.92%" id="mcps1.3.3.3.2.5.1.4"><p id="dataartsstudio_02_0065__en-us_topic_0181281374_p17446105245018">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dataartsstudio_02_0065__row7274194512367"><td class="cellrowborder" valign="top" width="21.39%" headers="mcps1.3.3.3.2.5.1.1 "><p id="dataartsstudio_02_0065__p175867202012">approvers</p>
</td>
<td class="cellrowborder" valign="top" width="10.45%" headers="mcps1.3.3.3.2.5.1.2 "><p id="dataartsstudio_02_0065__p97581676203">No</p>
</td>
<td class="cellrowborder" valign="top" width="20.24%" headers="mcps1.3.3.3.2.5.1.3 "><p id="dataartsstudio_02_0065__p77589714204">List&lt;JobApprover&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="47.92%" headers="mcps1.3.3.3.2.5.1.4 "><p id="dataartsstudio_02_0065__p1829214412218">Job approver. This parameter is required if the review function is enabled. For details, see <a href="#dataartsstudio_02_0065__table943565132314">Table 4</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="dataartsstudio_02_0065__table943565132314"></a><a name="table943565132314"></a><table cellpadding="4" cellspacing="0" summary="" id="dataartsstudio_02_0065__table943565132314" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Approver attributes</caption><thead align="left"><tr id="dataartsstudio_02_0065__row3436125112238"><th align="left" class="cellrowborder" valign="top" width="24.95750424957504%" id="mcps1.3.3.4.2.5.1.1"><p id="dataartsstudio_02_0065__p13603158182519">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="24.987501249875013%" id="mcps1.3.3.4.2.5.1.2"><p id="dataartsstudio_02_0065__p060313892519">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="24.84751524847515%" id="mcps1.3.3.4.2.5.1.3"><p id="dataartsstudio_02_0065__p186034820259">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25.207479252074794%" id="mcps1.3.3.4.2.5.1.4"><p id="dataartsstudio_02_0065__p16603158192520">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dataartsstudio_02_0065__row7436175110233"><td class="cellrowborder" valign="top" width="24.95750424957504%" headers="mcps1.3.3.4.2.5.1.1 "><p id="dataartsstudio_02_0065__p1713118288253">approverName</p>
</td>
<td class="cellrowborder" valign="top" width="24.987501249875013%" headers="mcps1.3.3.4.2.5.1.2 "><p id="dataartsstudio_02_0065__p41311328132516">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="24.84751524847515%" headers="mcps1.3.3.4.2.5.1.3 "><p id="dataartsstudio_02_0065__p61311286252">String</p>
</td>
<td class="cellrowborder" valign="top" width="25.207479252074794%" headers="mcps1.3.3.4.2.5.1.4 "><p id="dataartsstudio_02_0065__p413162811253">Approver name</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="dataartsstudio_02_0065__en-us_topic_0181281358_section17656611145018"><h4 class="sectiontitle">Response Parameters</h4><p id="dataartsstudio_02_0065__en-us_topic_0181281358_p748624416207">None.</p>
</div>
<div class="section" id="dataartsstudio_02_0065__en-us_topic_0181281358_section358155716277"><h4 class="sectiontitle">Example Request</h4><pre class="screen" id="dataartsstudio_02_0065__en-us_topic_0181281358_screen1692944218514">DELETE /v1/b384b9e9ab9b4ee8994c8633aabc9505/jobs/joba</pre>
</div>
<p id="dataartsstudio_02_0065__p454155219416">Delete a job when the review function is enabled.</p>
<pre class="screen" id="dataartsstudio_02_0065__screen68276414517">DELETE /v1/b384b9e9ab9b4ee8994c8633aabc9505/jobs/joba
{
"approvers": [
{
"approverName": "userName1"
},
{
"approverName": "userName2"
}
]
}</pre>
<div class="section" id="dataartsstudio_02_0065__section982155210419"><h4 class="sectiontitle">Example Response</h4><ul id="dataartsstudio_02_0065__en-us_topic_0181281358_ul1593065043218"><li id="dataartsstudio_02_0065__en-us_topic_0181281358_li9359512386">Response<p id="dataartsstudio_02_0065__en-us_topic_0181281358_p2186131670"><a name="dataartsstudio_02_0065__en-us_topic_0181281358_li9359512386"></a><a name="en-us_topic_0181281358_li9359512386"></a>HTTP status code 204</p>
</li><li id="dataartsstudio_02_0065__en-us_topic_0181281358_li313082312504">Failure response<p id="dataartsstudio_02_0065__en-us_topic_0181281358_p17868101111567"><a name="dataartsstudio_02_0065__en-us_topic_0181281358_li313082312504"></a><a name="en-us_topic_0181281358_li313082312504"></a>HTTP status code 400</p>
<pre class="screen" id="dataartsstudio_02_0065__en-us_topic_0181281358_screen2818105917308">{
"error_code":"DLF.0100",
"error_msg":"The job does not exists."
}</pre>
</li></ul>
</div>
<div class="section" id="dataartsstudio_02_0065__en-us_topic_0181281358_section5775105811538"><h4 class="sectiontitle">Status Codes</h4><p id="dataartsstudio_02_0065__en-us_topic_0181281358_p62591780542">See <a href="dataartsstudio_02_0310.html">Status Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dataartsstudio_02_0062.html">Job Development APIs</a></div>
</div>
</div>