Files
doc-exports/docs/eps/api-ref/en-us_topic_0121230884.html
weihongmin1 89457a7fa8 EPS API First Version
Reviewed-by: Gladkov, Maksim <mgladkov@noreply.gitea.eco.tsi-dev.otc-service.com>
Reviewed-by: Belejkanic, Lukas <lukas.belejkanic@t-systems.com>
Co-authored-by: weihongmin1 <weihongmin1@huawei.com>
Co-committed-by: weihongmin1 <weihongmin1@huawei.com>
2025-11-13 12:55:55 +00:00

238 lines
20 KiB
HTML

<a name="en-us_topic_0121230884"></a><a name="en-us_topic_0121230884"></a>
<h1 class="topictitle1">Modifying an Enterprise Project</h1>
<div id="body11410545"><div class="section" id="en-us_topic_0121230884__section18900705"><h4 class="sectiontitle">Function</h4><p class="msonormal" id="en-us_topic_0121230884__p12824185773118">This API is used to modify an enterprise project.</p>
<p class="msonormal" id="en-us_topic_0121230884__p149517446310">Only the enterprise project name and description can be modified.</p>
<p id="en-us_topic_0121230884__p76957453213">The enterprise project type can be only changed from <strong id="en-us_topic_0121230884__b862812406200">poc</strong> to <strong id="en-us_topic_0121230884__b18611043152017">prod</strong>.</p>
<div class="note" id="en-us_topic_0121230884__note82901928131917"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="en-us_topic_0121230884__p329022861919">You can modify the enterprise project information only after the Enterprise Project function is enabled.</p>
</div></div>
</div>
<div class="section" id="en-us_topic_0121230884__section35888623"><h4 class="sectiontitle">URI</h4><p id="en-us_topic_0121230884__p7643895">PUT /v1.0/enterprise-projects/{enterprise_project_id}</p>
<div class="p" id="en-us_topic_0121230884__p134378115582">
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0121230884__table44251220" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter in the URI</caption><thead align="left"><tr id="en-us_topic_0121230884__row54749189"><th align="left" class="cellrowborder" valign="top" width="25.537446255374462%" id="mcps1.3.2.3.1.2.5.1.1"><p id="en-us_topic_0121230884__p5499307">Name</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="19.11808819118088%" id="mcps1.3.2.3.1.2.5.1.2"><p id="en-us_topic_0121230884__p43499422">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="24.82751724827517%" id="mcps1.3.2.3.1.2.5.1.3"><p id="en-us_topic_0121230884__p42790759">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="30.516948305169482%" id="mcps1.3.2.3.1.2.5.1.4"><p id="en-us_topic_0121230884__p33792314">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="en-us_topic_0121230884__row52822947"><td class="cellrowborder" valign="top" width="25.537446255374462%" headers="mcps1.3.2.3.1.2.5.1.1 "><p id="en-us_topic_0121230884__p50800320">enterprise_project_id</p>
</td>
<td class="cellrowborder" valign="top" width="19.11808819118088%" headers="mcps1.3.2.3.1.2.5.1.2 "><p id="en-us_topic_0121230884__p38285624">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="24.82751724827517%" headers="mcps1.3.2.3.1.2.5.1.3 "><p id="en-us_topic_0121230884__p21185274">String</p>
</td>
<td class="cellrowborder" valign="top" width="30.516948305169482%" headers="mcps1.3.2.3.1.2.5.1.4 "><p id="en-us_topic_0121230884__p14127843">Specifies the enterprise project ID. The enterprise project whose ID is <strong id="en-us_topic_0121230884__b135931150941">0</strong> cannot be modified.</p>
<p id="en-us_topic_0121230884__p898217121144">You can obtain the ID by using API <a href="en-us_topic_0121230880.html">Querying the Enterprise Project List</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div class="section" id="en-us_topic_0121230884__section54562157"><h4 class="sectiontitle">Request</h4><ul id="en-us_topic_0121230884__ul31541493"><li id="en-us_topic_0121230884__li15437982">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0121230884__HeaderParameter" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Parameters in the request header</caption><thead align="left"><tr id="en-us_topic_0121230884__row1729773413112"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.1.1.2.5.1.1"><p id="en-us_topic_0121230884__p12298183491112">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.1.1.2.5.1.2"><p id="en-us_topic_0121230884__p129814344113">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.1.1.2.5.1.3"><p id="en-us_topic_0121230884__p102981834181119">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.2.1.1.2.5.1.4"><p id="en-us_topic_0121230884__p429812349112">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="en-us_topic_0121230884__row1229711348116"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="en-us_topic_0121230884__p1929943419116">X-Auth-Token</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="en-us_topic_0121230884__p18299634121110">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="en-us_topic_0121230884__p10299134111112">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="en-us_topic_0121230884__p6299123421112">Specifies the user token. EPS is a global service. When calling the IAM API to obtain a user token, set <strong id="en-us_topic_0121230884__b103201610103419">scope</strong> to <strong id="en-us_topic_0121230884__b83204102348">domain</strong>. The value of <strong id="en-us_topic_0121230884__b16681161173411">X-Subject-Token</strong> in the response header is the user token.</p>
</td>
</tr>
<tr id="en-us_topic_0121230884__row14297103416119"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="en-us_topic_0121230884__p163831551165418">Content-Type</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="en-us_topic_0121230884__p938318511546">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="en-us_topic_0121230884__p8362219105513">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="en-us_topic_0121230884__p203831251205414">Default value: <strong id="en-us_topic_0121230884__b19869913323">application/json; charset=UTF-8</strong></p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="p" id="en-us_topic_0121230884__p16608747134715">
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0121230884__table4724110" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Parameters in the request body</caption><thead align="left"><tr id="en-us_topic_0121230884__row52802185"><th align="left" class="cellrowborder" valign="top" width="17.28172817281728%" id="mcps1.3.3.2.1.2.1.2.5.1.1"><p id="en-us_topic_0121230884__p49118603">Name</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="22.672267226722674%" id="mcps1.3.3.2.1.2.1.2.5.1.2"><p id="en-us_topic_0121230884__p19183930">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="22.762276227622763%" id="mcps1.3.3.2.1.2.1.2.5.1.3"><p id="en-us_topic_0121230884__p10394493">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="37.28372837283728%" id="mcps1.3.3.2.1.2.1.2.5.1.4"><p id="en-us_topic_0121230884__p36647613">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="en-us_topic_0121230884__row15666657"><td class="cellrowborder" valign="top" width="17.28172817281728%" headers="mcps1.3.3.2.1.2.1.2.5.1.1 "><p id="en-us_topic_0121230884__p61039698">name</p>
</td>
<td class="cellrowborder" valign="top" width="22.672267226722674%" headers="mcps1.3.3.2.1.2.1.2.5.1.2 "><p id="en-us_topic_0121230884__p45268471">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="22.762276227622763%" headers="mcps1.3.3.2.1.2.1.2.5.1.3 "><p id="en-us_topic_0121230884__p42867512">String</p>
</td>
<td class="cellrowborder" valign="top" width="37.28372837283728%" headers="mcps1.3.3.2.1.2.1.2.5.1.4 "><p id="en-us_topic_0121230884__p49716479">A name can contain 1 to 255 characters. Only letters, digits, underscores (_), and hyphens (-) are allowed. The name must be unique in the domain and cannot include any form of the word "default".</p>
</td>
</tr>
<tr id="en-us_topic_0121230884__row44795127"><td class="cellrowborder" valign="top" width="17.28172817281728%" headers="mcps1.3.3.2.1.2.1.2.5.1.1 "><p id="en-us_topic_0121230884__p4526655">description</p>
</td>
<td class="cellrowborder" valign="top" width="22.672267226722674%" headers="mcps1.3.3.2.1.2.1.2.5.1.2 "><p id="en-us_topic_0121230884__p31114751">No</p>
</td>
<td class="cellrowborder" valign="top" width="22.762276227622763%" headers="mcps1.3.3.2.1.2.1.2.5.1.3 "><p id="en-us_topic_0121230884__p37266912">String</p>
</td>
<td class="cellrowborder" valign="top" width="37.28372837283728%" headers="mcps1.3.3.2.1.2.1.2.5.1.4 "><p id="en-us_topic_0121230884__p65829897">A description can contain a maximum of 512 characters.</p>
</td>
</tr>
<tr id="en-us_topic_0121230884__row198304486378"><td class="cellrowborder" valign="top" width="17.28172817281728%" headers="mcps1.3.3.2.1.2.1.2.5.1.1 "><p id="en-us_topic_0121230884__p98319485373">type</p>
</td>
<td class="cellrowborder" valign="top" width="22.672267226722674%" headers="mcps1.3.3.2.1.2.1.2.5.1.2 "><p id="en-us_topic_0121230884__p16831154863715">No</p>
</td>
<td class="cellrowborder" valign="top" width="22.762276227622763%" headers="mcps1.3.3.2.1.2.1.2.5.1.3 "><p id="en-us_topic_0121230884__p4831104853714">String</p>
</td>
<td class="cellrowborder" valign="top" width="37.28372837283728%" headers="mcps1.3.3.2.1.2.1.2.5.1.4 "><p id="en-us_topic_0121230884__p383112487375">Specifies the enterprise project type. The enterprise project type can be only changed from <strong id="en-us_topic_0121230884__b33669115329">poc</strong> to <strong id="en-us_topic_0121230884__b0366121113325">prod</strong>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</li></ul>
<ul id="en-us_topic_0121230884__ul30621475"><li id="en-us_topic_0121230884__li42913032">Example request<pre class="codeblock" id="en-us_topic_0121230884__codeblock759316914185">PUT https://{EPS endpoint}/v1.0/enterprise-projects/{enterprise_project_id}</pre>
<pre class="screen" id="en-us_topic_0121230884__screen1125175213171">{
"name":"enterprise_project1",
"description": "description"
}</pre>
</li></ul>
</div>
<div class="section" id="en-us_topic_0121230884__section21297373"><h4 class="sectiontitle">Response</h4><p id="en-us_topic_0121230884__p165182016166"><strong id="en-us_topic_0121230884__b76431693212">Status code: 200</strong></p>
<ul id="en-us_topic_0121230884__ul5235732"><li id="en-us_topic_0121230884__li47121588">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0121230884__table21441115" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Parameters in the response body</caption><thead align="left"><tr id="en-us_topic_0121230884__row49880859"><th align="left" class="cellrowborder" valign="top" width="26.51%" id="mcps1.3.4.3.1.1.2.4.1.1"><p id="en-us_topic_0121230884__p13817778">Name</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="30.12%" id="mcps1.3.4.3.1.1.2.4.1.2"><p id="en-us_topic_0121230884__p45498225">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="43.37%" id="mcps1.3.4.3.1.1.2.4.1.3"><p id="en-us_topic_0121230884__p13632394">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="en-us_topic_0121230884__row30482099"><td class="cellrowborder" valign="top" width="26.51%" headers="mcps1.3.4.3.1.1.2.4.1.1 "><p id="en-us_topic_0121230884__p53130916">enterprise_project</p>
</td>
<td class="cellrowborder" valign="top" width="30.12%" headers="mcps1.3.4.3.1.1.2.4.1.2 "><p id="en-us_topic_0121230884__p1281913311956">Dict&lt;enterprise_project&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="43.37%" headers="mcps1.3.4.3.1.1.2.4.1.3 "><p id="en-us_topic_0121230884__p27044923">Specifies the enterprise project.</p>
<p id="en-us_topic_0121230884__p1713220201166">For details, see <a href="#en-us_topic_0121230884__table5907602">Table 5</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
<ul id="en-us_topic_0121230884__ul43155167"><li id="en-us_topic_0121230884__li52852183"><strong id="en-us_topic_0121230884__b6699296094725">enterprise_project</strong> data structure
<div class="tablenoborder"><a name="en-us_topic_0121230884__table5907602"></a><a name="table5907602"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0121230884__table5907602" frame="border" border="1" rules="all"><caption><b>Table 5 </b><strong id="en-us_topic_0121230884__b1743317184127">enterprise_project</strong> data structure description</caption><thead align="left"><tr id="en-us_topic_0121230884__row30155567"><th align="left" class="cellrowborder" valign="top" width="26.51%" id="mcps1.3.4.4.1.2.2.4.1.1"><p id="en-us_topic_0121230884__p26681828">Name</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="30.12%" id="mcps1.3.4.4.1.2.2.4.1.2"><p id="en-us_topic_0121230884__p13744437">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="43.37%" id="mcps1.3.4.4.1.2.2.4.1.3"><p id="en-us_topic_0121230884__p50052558">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="en-us_topic_0121230884__row27725413"><td class="cellrowborder" valign="top" width="26.51%" headers="mcps1.3.4.4.1.2.2.4.1.1 "><p id="en-us_topic_0121230884__p31166009">id</p>
</td>
<td class="cellrowborder" valign="top" width="30.12%" headers="mcps1.3.4.4.1.2.2.4.1.2 "><p id="en-us_topic_0121230884__p41418801">String</p>
</td>
<td class="cellrowborder" valign="top" width="43.37%" headers="mcps1.3.4.4.1.2.2.4.1.3 "><p id="en-us_topic_0121230884__p24967343">Specifies the enterprise project ID.</p>
</td>
</tr>
<tr id="en-us_topic_0121230884__row23379499"><td class="cellrowborder" valign="top" width="26.51%" headers="mcps1.3.4.4.1.2.2.4.1.1 "><p id="en-us_topic_0121230884__p14691246">name</p>
</td>
<td class="cellrowborder" valign="top" width="30.12%" headers="mcps1.3.4.4.1.2.2.4.1.2 "><p id="en-us_topic_0121230884__p49140249">String</p>
</td>
<td class="cellrowborder" valign="top" width="43.37%" headers="mcps1.3.4.4.1.2.2.4.1.3 "><p id="en-us_topic_0121230884__p18194633">Specifies the enterprise project name.</p>
</td>
</tr>
<tr id="en-us_topic_0121230884__row29533976"><td class="cellrowborder" valign="top" width="26.51%" headers="mcps1.3.4.4.1.2.2.4.1.1 "><p id="en-us_topic_0121230884__p43441876">description</p>
</td>
<td class="cellrowborder" valign="top" width="30.12%" headers="mcps1.3.4.4.1.2.2.4.1.2 "><p id="en-us_topic_0121230884__p29131101">String</p>
</td>
<td class="cellrowborder" valign="top" width="43.37%" headers="mcps1.3.4.4.1.2.2.4.1.3 "><p id="en-us_topic_0121230884__p3112692">Provides supplementary information about the enterprise project.</p>
</td>
</tr>
<tr id="en-us_topic_0121230884__row28014231"><td class="cellrowborder" valign="top" width="26.51%" headers="mcps1.3.4.4.1.2.2.4.1.1 "><p id="en-us_topic_0121230884__p54560230">status</p>
</td>
<td class="cellrowborder" valign="top" width="30.12%" headers="mcps1.3.4.4.1.2.2.4.1.2 "><p id="en-us_topic_0121230884__p57302534">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="43.37%" headers="mcps1.3.4.4.1.2.2.4.1.3 "><p id="en-us_topic_0121230884__p18074072"><strong id="en-us_topic_0121230884__b84235270616119">1</strong> indicates <strong id="en-us_topic_0121230884__b84235270616912">Enabled</strong>. <strong id="en-us_topic_0121230884__b842352706161113">2</strong> indicates <strong id="en-us_topic_0121230884__b84235270616918">Disabled</strong>.</p>
</td>
</tr>
<tr id="en-us_topic_0121230884__row28448920"><td class="cellrowborder" valign="top" width="26.51%" headers="mcps1.3.4.4.1.2.2.4.1.1 "><p id="en-us_topic_0121230884__p22661156">created_at</p>
</td>
<td class="cellrowborder" valign="top" width="30.12%" headers="mcps1.3.4.4.1.2.2.4.1.2 "><p id="en-us_topic_0121230884__p23614373">String</p>
</td>
<td class="cellrowborder" valign="top" width="43.37%" headers="mcps1.3.4.4.1.2.2.4.1.3 "><p id="en-us_topic_0121230884__p46649509">Specifies the time (UTC) when the enterprise project was created.</p>
<p id="en-us_topic_0121230884__p2041174216715">Example: 2018-05-18T06:49:06Z</p>
</td>
</tr>
<tr id="en-us_topic_0121230884__row17192404"><td class="cellrowborder" valign="top" width="26.51%" headers="mcps1.3.4.4.1.2.2.4.1.1 "><p id="en-us_topic_0121230884__p50407447">updated_at</p>
</td>
<td class="cellrowborder" valign="top" width="30.12%" headers="mcps1.3.4.4.1.2.2.4.1.2 "><p id="en-us_topic_0121230884__p56471444">String</p>
</td>
<td class="cellrowborder" valign="top" width="43.37%" headers="mcps1.3.4.4.1.2.2.4.1.3 "><p id="en-us_topic_0121230884__p1108310">Specifies the time (UTC) when the enterprise project was modified.</p>
<p id="en-us_topic_0121230884__p937054611716">Example: 2018-05-18T06:49:06Z</p>
</td>
</tr>
<tr id="en-us_topic_0121230884__row11833631553"><td class="cellrowborder" valign="top" width="26.51%" headers="mcps1.3.4.4.1.2.2.4.1.1 "><p id="en-us_topic_0121230884__p3667961143">type</p>
</td>
<td class="cellrowborder" valign="top" width="30.12%" headers="mcps1.3.4.4.1.2.2.4.1.2 "><p id="en-us_topic_0121230884__p1966746146">String</p>
</td>
<td class="cellrowborder" valign="top" width="43.37%" headers="mcps1.3.4.4.1.2.2.4.1.3 "><p id="en-us_topic_0121230884__p186671615414">Project type. <strong id="en-us_topic_0121230884__b10916240327">prod</strong>: commercial project; <strong id="en-us_topic_0121230884__b9919242326">poc</strong>: test project</p>
</td>
</tr>
<tr id="en-us_topic_0121230884__row1464193412511"><td class="cellrowborder" valign="top" width="26.51%" headers="mcps1.3.4.4.1.2.2.4.1.1 "><p id="en-us_topic_0121230884__p66671861147">delete_flag</p>
</td>
<td class="cellrowborder" valign="top" width="30.12%" headers="mcps1.3.4.4.1.2.2.4.1.2 "><p id="en-us_topic_0121230884__p1866876147">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="43.37%" headers="mcps1.3.4.4.1.2.2.4.1.3 "><p id="en-us_topic_0121230884__p156681618413">Deletion flag. The value <strong id="en-us_topic_0121230884__b17249102611327">false</strong> means that the information is not deleted and the value <strong id="en-us_topic_0121230884__b1249182693211">true</strong> means that the information is deleted.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
<ul id="en-us_topic_0121230884__ul22664300"><li id="en-us_topic_0121230884__li2652113">Example response<div class="p" id="en-us_topic_0121230884__p12974154931817"><a name="en-us_topic_0121230884__li2652113"></a><a name="li2652113"></a><strong id="en-us_topic_0121230884__b3781028123212">Status code: 200</strong><pre class="screen" id="en-us_topic_0121230884__screen423913574013">{
"enterprise_project": {
"id": "5aa119a8-d25b-45a7-8d1b-88e127885635",
"name": "enterprise_project1",
"description": "description",
"type":"prod",
"status": 1,
"delete_flag": false,
"created_at": "2016-03-28T00:00:00Z",
"updated_at": "2016-03-28T00:00:00Z"
}
}</pre>
</div>
</li></ul>
</div>
<div class="section" id="en-us_topic_0121230884__section17789101582315"><h4 class="sectiontitle">Status Codes</h4><p id="en-us_topic_0121230884__p145228330242">For details, see <a href="en-us_topic_0171146972.html">Status Code</a>.</p>
</div>
<div class="section" id="en-us_topic_0121230884__section18604165622519"><h4 class="sectiontitle">Error Codes</h4><p id="en-us_topic_0121230884__p177044331253">For details, see <a href="en-us_topic_0121230887.html">Error Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0133321992.html">Enterprise Project Management</a></div>
</div>
</div>