vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/bms/api-ref/en-us_topic_0053158682.html
guoyanyan c311ecafe3 bms_api_0510 
Reviewed-by: Pristromskaia, Margarita <margarita.pristromskaia@t-systems.com>
Co-authored-by: guoyanyan <guoyanyan3@huawei.com>
Co-committed-by: guoyanyan <guoyanyan3@huawei.com>
2023-10-11 08:28:11 +00:00

479 lines
45 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0053158682"></a><a name="EN-US_TOPIC_0053158682"></a>
<h1 class="topictitle1">Creating a BMS (Native OpenStack API)</h1>
<div id="body1456128284941"><div class="section" id="EN-US_TOPIC_0053158682__section1345647716824"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0053158682__p1623284216824">This interface is used to create a BMS.</p>
</div>
<div class="section" id="EN-US_TOPIC_0053158682__section621290195310"><h4 class="sectiontitle">Constraints</h4><ul id="EN-US_TOPIC_0053158682__ul50589984195333"><li id="EN-US_TOPIC_0053158682__li5214957195416">This interface cannot be used to create BMSs in batches.</li><li id="EN-US_TOPIC_0053158682__li209781543171917">When you create a BMS using an image that supports Cloud-Init or Cloudbase-Init, only parameter <strong id="EN-US_TOPIC_0053158682__b135788818316217">key_name</strong> can be configured. (Parameter <strong id="EN-US_TOPIC_0053158682__b187550468116217">adminPass</strong> is invalid.) The password of a Linux BMS can be injected only using parameter <strong id="EN-US_TOPIC_0053158682__b842352706161528">user_data</strong>. The password of a Windows BMS can be injected only using metadata <strong id="EN-US_TOPIC_0053158682__b842352706155131">admin_pass</strong>.</li><li id="EN-US_TOPIC_0053158682__li820592412113">When you create a BMS using an image that does not support Cloud-Init or Cloudbase-Init, both parameters <strong id="EN-US_TOPIC_0053158682__b20688701637">adminPass</strong> and <strong id="EN-US_TOPIC_0053158682__b18684632491637">key_name</strong> are invalid. You need to use the password or certificate of the image to log in to the BMS.</li><li id="EN-US_TOPIC_0053158682__li6358471612912">File injection is not supported.</li><li id="EN-US_TOPIC_0053158682__li6639923416132">BMS creation from a system volume is not supported.</li><li id="EN-US_TOPIC_0053158682__li3994157195333">Parameter <strong id="EN-US_TOPIC_0053158682__b842352706184252">port</strong> in the three network parameters (<strong id="EN-US_TOPIC_0053158682__b84235270618439">port</strong>, <strong id="EN-US_TOPIC_0053158682__b842352706184317">uuid</strong>, and <strong id="EN-US_TOPIC_0053158682__b842352706184325">fixed_ip</strong>) has the highest priority. If parameter <strong id="EN-US_TOPIC_0053158682__b842352706184351">fixed_ip</strong> is set, you must specify the UUID.</li><li id="EN-US_TOPIC_0053158682__li55091339195333">After a BMS is created, it is recommended that you attach the <strong id="EN-US_TOPIC_0053158682__b842352706161846">__type_baremetal</strong> tag to the BMS. This tag specifies that the created server is a BMS. Otherwise, the BMS may not be displayed in the BMS list on the management console.</li><li id="EN-US_TOPIC_0053158682__li28137966213620">A BMS can have a maximum of two VPCs, in which case the first VPC will be used by the primary NIC.</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0053158682__section1187785216824"><h4 class="sectiontitle">URI</h4><p id="EN-US_TOPIC_0053158682__p1719854616824">POST /v2.1/{project_id}/servers</p>
<p id="EN-US_TOPIC_0053158682__p113172013183514"><a href="#EN-US_TOPIC_0053158682__table193302233354">Table 1</a> lists the parameters.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0053158682__table193302233354"></a><a name="table193302233354"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0053158682__table193302233354" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="EN-US_TOPIC_0053158682__row1331182318359"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.3.4.2.4.1.1"><p id="EN-US_TOPIC_0053158682__p6708685516824">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.3.4.2.4.1.2"><p id="EN-US_TOPIC_0053158682__p152354631985">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.3.4.2.4.1.3"><p id="EN-US_TOPIC_0053158682__p5692883616824">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0053158682__row1633142311354"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.4.2.4.1.1 "><p id="EN-US_TOPIC_0053158682__p4926689916824">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.4.2.4.1.2 "><p id="EN-US_TOPIC_0053158682__p3119585316824">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.4.2.4.1.3 "><p id="EN-US_TOPIC_0053158682__p4383614716824">Specifies the project ID.</p>
<p id="EN-US_TOPIC_0053158682__p13397185821014">For how to obtain the project ID, see <a href="https://docs.otc.t-systems.com/en-us/api/apiug/apig-en-api-180328009.html" target="_blank" rel="noopener noreferrer">Obtaining Required Information</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0053158682__section5898101116824"><h4 class="sectiontitle">Request</h4><ul id="EN-US_TOPIC_0053158682__ul1273258316824"><li id="EN-US_TOPIC_0053158682__li4748439016824">Request parameters
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0053158682__table63027372115233" frame="border" border="1" rules="all"><thead align="left"><tr id="EN-US_TOPIC_0053158682__row53764762115233"><th align="left" class="cellrowborder" valign="top" width="18.418158184181582%" id="mcps1.3.4.2.1.1.1.5.1.1"><p id="EN-US_TOPIC_0053158682__p59978491115233">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="15.22847715228477%" id="mcps1.3.4.2.1.1.1.5.1.2"><p id="EN-US_TOPIC_0053158682__p523875318499">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="21.617838216178384%" id="mcps1.3.4.2.1.1.1.5.1.3"><p id="EN-US_TOPIC_0053158682__p26419641115233">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="44.73552644735527%" id="mcps1.3.4.2.1.1.1.5.1.4"><p id="EN-US_TOPIC_0053158682__p64181866115233">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0053158682__row31348653115233"><td class="cellrowborder" valign="top" width="18.418158184181582%" headers="mcps1.3.4.2.1.1.1.5.1.1 "><p id="EN-US_TOPIC_0053158682__p56212973115233">server</p>
</td>
<td class="cellrowborder" valign="top" width="15.22847715228477%" headers="mcps1.3.4.2.1.1.1.5.1.2 "><p id="EN-US_TOPIC_0053158682__p17214453174914">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="21.617838216178384%" headers="mcps1.3.4.2.1.1.1.5.1.3 "><p id="EN-US_TOPIC_0053158682__p56956945115233">Object</p>
</td>
<td class="cellrowborder" valign="top" width="44.73552644735527%" headers="mcps1.3.4.2.1.1.1.5.1.4 "><p id="EN-US_TOPIC_0053158682__p207899819655">Specifies the BMS information, see <a href="#EN-US_TOPIC_0053158682__table3034272816824">Table 2</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="EN-US_TOPIC_0053158682__table3034272816824"></a><a name="table3034272816824"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0053158682__table3034272816824" frame="border" border="1" rules="all"><caption><b>Table 2 </b><strong id="EN-US_TOPIC_0053158682__b79712741918">server</strong> field data structure description</caption><thead align="left"><tr id="EN-US_TOPIC_0053158682__row4067332316824"><th align="left" class="cellrowborder" valign="top" width="25.05%" id="mcps1.3.4.2.1.2.2.5.1.1"><p id="EN-US_TOPIC_0053158682__p1645824224414">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="17.9%" id="mcps1.3.4.2.1.2.2.5.1.2"><p id="EN-US_TOPIC_0053158682__p846014425445">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="22.61%" id="mcps1.3.4.2.1.2.2.5.1.3"><p id="EN-US_TOPIC_0053158682__p24652042124419">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="34.44%" id="mcps1.3.4.2.1.2.2.5.1.4"><p id="EN-US_TOPIC_0053158682__p15467342154412">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0053158682__row3747029116824"><td class="cellrowborder" valign="top" width="25.05%" headers="mcps1.3.4.2.1.2.2.5.1.1 "><p id="EN-US_TOPIC_0053158682__p1519475416824">imageRef</p>
</td>
<td class="cellrowborder" valign="top" width="17.9%" headers="mcps1.3.4.2.1.2.2.5.1.2 "><p id="EN-US_TOPIC_0053158682__p3612083716824">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="22.61%" headers="mcps1.3.4.2.1.2.2.5.1.3 "><p id="EN-US_TOPIC_0053158682__p47173149172743">String</p>
</td>
<td class="cellrowborder" valign="top" width="34.44%" headers="mcps1.3.4.2.1.2.2.5.1.4 "><p id="EN-US_TOPIC_0053158682__p5488522316258">Specifies the ID of the image used by the BMS or the image resource uniform resource locator (URL).</p>
<ul id="EN-US_TOPIC_0053158682__en-us_topic_0057972661_ul25957356102658"><li id="EN-US_TOPIC_0053158682__en-us_topic_0057972661_li32289615102658">Example image ID: 3b8d6fef-af77-42ab-b8b7-5a7f0f0af8f2</li><li id="EN-US_TOPIC_0053158682__en-us_topic_0057972661_li22171082102658">Example image URL: http://glance.openstack.example.com/images/3b8d6fef-af77-42ab-b8b7-5a7f0f0af8f2</li></ul>
<div class="note" id="EN-US_TOPIC_0053158682__note137413351178"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="EN-US_TOPIC_0053158682__ul185629592115"><li id="EN-US_TOPIC_0053158682__li155622595111">BMSs using certain flavors do not support all public images provided by the cloud service platform. To obtain the images supported by a BMS flavor, log in to the management console, view the images displayed on the <strong id="EN-US_TOPIC_0053158682__en-us_topic_0068473331_b842352706185454">Create ECS</strong> page, and obtain the image IDs on the <strong id="EN-US_TOPIC_0053158682__en-us_topic_0068473331_b842352706185522">Image Management Service</strong> page.</li><li id="EN-US_TOPIC_0053158682__li16562859217">If the creation fails, modify the parameter settings.</li></ul>
</div></div>
</td>
</tr>
<tr id="EN-US_TOPIC_0053158682__row2541566816824"><td class="cellrowborder" valign="top" width="25.05%" headers="mcps1.3.4.2.1.2.2.5.1.1 "><p id="EN-US_TOPIC_0053158682__p4540324216824">flavorRef</p>
</td>
<td class="cellrowborder" valign="top" width="17.9%" headers="mcps1.3.4.2.1.2.2.5.1.2 "><p id="EN-US_TOPIC_0053158682__p6153613516824">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="22.61%" headers="mcps1.3.4.2.1.2.2.5.1.3 "><p id="EN-US_TOPIC_0053158682__p29487937172743">String</p>
</td>
<td class="cellrowborder" valign="top" width="34.44%" headers="mcps1.3.4.2.1.2.2.5.1.4 "><p id="EN-US_TOPIC_0053158682__p1837107116824">Specifies the ID or URL of the flavor used by the BMS.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0053158682__row3112191316824"><td class="cellrowborder" valign="top" width="25.05%" headers="mcps1.3.4.2.1.2.2.5.1.1 "><p id="EN-US_TOPIC_0053158682__p3784704016824">name</p>
</td>
<td class="cellrowborder" valign="top" width="17.9%" headers="mcps1.3.4.2.1.2.2.5.1.2 "><p id="EN-US_TOPIC_0053158682__p1163818816824">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="22.61%" headers="mcps1.3.4.2.1.2.2.5.1.3 "><p id="EN-US_TOPIC_0053158682__p21870220172743">String</p>
</td>
<td class="cellrowborder" valign="top" width="34.44%" headers="mcps1.3.4.2.1.2.2.5.1.4 "><p id="EN-US_TOPIC_0053158682__p316918516824">Specifies the BMS name. It contains a maximum of 255 characters and cannot be left blank.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0053158682__row66460276162716"><td class="cellrowborder" valign="top" width="25.05%" headers="mcps1.3.4.2.1.2.2.5.1.1 "><p id="EN-US_TOPIC_0053158682__p14573312162716">metadata</p>
</td>
<td class="cellrowborder" valign="top" width="17.9%" headers="mcps1.3.4.2.1.2.2.5.1.2 "><p id="EN-US_TOPIC_0053158682__p5448288619840">No</p>
</td>
<td class="cellrowborder" valign="top" width="22.61%" headers="mcps1.3.4.2.1.2.2.5.1.3 "><p id="EN-US_TOPIC_0053158682__p38590274172743">Object</p>
</td>
<td class="cellrowborder" valign="top" width="34.44%" headers="mcps1.3.4.2.1.2.2.5.1.4 "><p id="EN-US_TOPIC_0053158682__p22885804162716">Specifies the BMS metadata. The maximum size for both the metadata <strong id="EN-US_TOPIC_0053158682__b247814510246">key</strong> and <strong id="EN-US_TOPIC_0053158682__b124781859246">value</strong> is 255 characters. For details, see <a href="#EN-US_TOPIC_0053158682__table2549048917552">Table 3</a>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0053158682__row3208149162756"><td class="cellrowborder" valign="top" width="25.05%" headers="mcps1.3.4.2.1.2.2.5.1.1 "><p id="EN-US_TOPIC_0053158682__p15946101162759">user_data</p>
</td>
<td class="cellrowborder" valign="top" width="17.9%" headers="mcps1.3.4.2.1.2.2.5.1.2 "><p id="EN-US_TOPIC_0053158682__p34065362162759">No</p>
</td>
<td class="cellrowborder" valign="top" width="22.61%" headers="mcps1.3.4.2.1.2.2.5.1.3 "><p id="EN-US_TOPIC_0053158682__p13695788172743">String</p>
</td>
<td class="cellrowborder" valign="top" width="34.44%" headers="mcps1.3.4.2.1.2.2.5.1.4 "><p id="EN-US_TOPIC_0053158682__p34042936162759">Specifies the user data to be injected during the BMS creation.</p>
<p id="EN-US_TOPIC_0053158682__p7968474162759">Text, text files, and .gzip files can be injected. The content to be injected cannot be greater than 32 KB in size. The content to be injected must be encoded with base64.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0053158682__row50298416824"><td class="cellrowborder" valign="top" width="25.05%" headers="mcps1.3.4.2.1.2.2.5.1.1 "><p id="EN-US_TOPIC_0053158682__p4074174916824">adminPass</p>
</td>
<td class="cellrowborder" valign="top" width="17.9%" headers="mcps1.3.4.2.1.2.2.5.1.2 "><p id="EN-US_TOPIC_0053158682__p1201460516824">No</p>
</td>
<td class="cellrowborder" valign="top" width="22.61%" headers="mcps1.3.4.2.1.2.2.5.1.3 "><p id="EN-US_TOPIC_0053158682__p52117854172743">String</p>
</td>
<td class="cellrowborder" valign="top" width="34.44%" headers="mcps1.3.4.2.1.2.2.5.1.4 "><p id="EN-US_TOPIC_0053158682__p3365895216824">Specifies the initial login password of the BMS administrator account. This parameter is invalid for a Linux BMS. The administrator account of a Windows BMS is <strong id="EN-US_TOPIC_0053158682__b84235270617157">Administrator</strong>.</p>
<p id="EN-US_TOPIC_0053158682__p3449511316824">Password complexity requirements:</p>
<ul id="EN-US_TOPIC_0053158682__ul4202056716824"><li id="EN-US_TOPIC_0053158682__li4264078616824">The password contains 8 to 26 characters.</li><li id="EN-US_TOPIC_0053158682__li4822275516824">The password must contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters (!@$%^-_=+[{}]:,./?).</li><li id="EN-US_TOPIC_0053158682__li3135161116824">The password cannot contain the username or the username in reverse.</li><li id="EN-US_TOPIC_0053158682__li1372904316824">The Windows BMS password cannot contain the username, the username in reverse order, or more than two consecutive characters in the username.</li></ul>
<p id="EN-US_TOPIC_0053158682__p23106383195337">Note: If this parameter is not specified, a random password will be generated.</p>
<p id="EN-US_TOPIC_0053158682__p13457623114921">Special characters: !@$%^-_=+[{}]:,./?</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0053158682__row46738163204556"><td class="cellrowborder" valign="top" width="25.05%" headers="mcps1.3.4.2.1.2.2.5.1.1 "><p id="EN-US_TOPIC_0053158682__p17990285204556">security_groups</p>
</td>
<td class="cellrowborder" valign="top" width="17.9%" headers="mcps1.3.4.2.1.2.2.5.1.2 "><p id="EN-US_TOPIC_0053158682__p471257501996">No</p>
</td>
<td class="cellrowborder" valign="top" width="22.61%" headers="mcps1.3.4.2.1.2.2.5.1.3 "><p id="EN-US_TOPIC_0053158682__p58977744172743">Array of objects</p>
</td>
<td class="cellrowborder" valign="top" width="34.44%" headers="mcps1.3.4.2.1.2.2.5.1.4 "><p id="EN-US_TOPIC_0053158682__p43848996204556">Specifies the security group of a BMS. The default value is <strong id="EN-US_TOPIC_0053158682__b84235270617200">default</strong>. This parameter is valid when you specify parameter <strong id="EN-US_TOPIC_0053158682__b842352706172025">network</strong>. You are not allowed to specify multiple security groups. For details, see <a href="#EN-US_TOPIC_0053158682__table42731625205411">Table 4</a>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0053158682__row13145434164550"><td class="cellrowborder" valign="top" width="25.05%" headers="mcps1.3.4.2.1.2.2.5.1.1 "><p id="EN-US_TOPIC_0053158682__p58147228164550">networks</p>
</td>
<td class="cellrowborder" valign="top" width="17.9%" headers="mcps1.3.4.2.1.2.2.5.1.2 "><p id="EN-US_TOPIC_0053158682__p5087468419915">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="22.61%" headers="mcps1.3.4.2.1.2.2.5.1.3 "><p id="EN-US_TOPIC_0053158682__p45102428172743">Array of objects</p>
</td>
<td class="cellrowborder" valign="top" width="34.44%" headers="mcps1.3.4.2.1.2.2.5.1.4 "><p id="EN-US_TOPIC_0053158682__p10421164510143">Specifies the BMS NICs. For details, see <a href="#EN-US_TOPIC_0053158682__table36009093171737">Table 5</a>.</p>
<p id="EN-US_TOPIC_0053158682__p1238293164550">You can specify a maximum of four networks for a BMS, including two VXLAN networks and two GENEVE networks. The first network in the parameter must be a VXLAN network. The network is used as by the primary NIC of the BMS. If multiple groups of network parameters are specified, ensure that the parameters of each group belong to the same VPC.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0053158682__row5645252416824"><td class="cellrowborder" valign="top" width="25.05%" headers="mcps1.3.4.2.1.2.2.5.1.1 "><p id="EN-US_TOPIC_0053158682__p925172616824">key_name</p>
</td>
<td class="cellrowborder" valign="top" width="17.9%" headers="mcps1.3.4.2.1.2.2.5.1.2 "><p id="EN-US_TOPIC_0053158682__p3416339516824">No</p>
</td>
<td class="cellrowborder" valign="top" width="22.61%" headers="mcps1.3.4.2.1.2.2.5.1.3 "><p id="EN-US_TOPIC_0053158682__p63436109172743">String</p>
</td>
<td class="cellrowborder" valign="top" width="34.44%" headers="mcps1.3.4.2.1.2.2.5.1.4 "><p id="EN-US_TOPIC_0053158682__p1577162316824">Specifies the name of a key pair. This is an extended attribute.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0053158682__row3144662616824"><td class="cellrowborder" valign="top" width="25.05%" headers="mcps1.3.4.2.1.2.2.5.1.1 "><p id="EN-US_TOPIC_0053158682__p6414881716824">availability_zone</p>
</td>
<td class="cellrowborder" valign="top" width="17.9%" headers="mcps1.3.4.2.1.2.2.5.1.2 "><p id="EN-US_TOPIC_0053158682__p4070804916824">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="22.61%" headers="mcps1.3.4.2.1.2.2.5.1.3 "><p id="EN-US_TOPIC_0053158682__p6916701172743">String</p>
</td>
<td class="cellrowborder" valign="top" width="34.44%" headers="mcps1.3.4.2.1.2.2.5.1.4 "><p id="EN-US_TOPIC_0053158682__p1015603112849">Specifies information about the AZ to which the BMS belongs. You are not allowed to specify host information.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="EN-US_TOPIC_0053158682__table2549048917552"></a><a name="table2549048917552"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0053158682__table2549048917552" frame="border" border="1" rules="all"><caption><b>Table 3 </b><strong id="EN-US_TOPIC_0053158682__b54131153102111">metadata</strong> field data structure description</caption><thead align="left"><tr id="EN-US_TOPIC_0053158682__row5894027817552"><th align="left" class="cellrowborder" valign="top" width="18.42%" id="mcps1.3.4.2.1.3.2.5.1.1"><p id="EN-US_TOPIC_0053158682__p11219135318446">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="17.11%" id="mcps1.3.4.2.1.3.2.5.1.2"><p id="EN-US_TOPIC_0053158682__p522225319444">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="19.74%" id="mcps1.3.4.2.1.3.2.5.1.3"><p id="EN-US_TOPIC_0053158682__p1822675317442">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="44.73%" id="mcps1.3.4.2.1.3.2.5.1.4"><p id="EN-US_TOPIC_0053158682__p202271853144411">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0053158682__row2346131617552"><td class="cellrowborder" valign="top" width="18.42%" headers="mcps1.3.4.2.1.3.2.5.1.1 "><p id="EN-US_TOPIC_0053158682__p2131841817552">User-defined field key and value pair</p>
</td>
<td class="cellrowborder" valign="top" width="17.11%" headers="mcps1.3.4.2.1.3.2.5.1.2 "><p id="EN-US_TOPIC_0053158682__p4907026417552">No</p>
</td>
<td class="cellrowborder" valign="top" width="19.74%" headers="mcps1.3.4.2.1.3.2.5.1.3 "><p id="EN-US_TOPIC_0053158682__p47081973172826">String</p>
</td>
<td class="cellrowborder" valign="top" width="44.73%" headers="mcps1.3.4.2.1.3.2.5.1.4 "><p id="EN-US_TOPIC_0053158682__p5719410617654">Specifies the key and value pair of the metadata.</p>
<p id="EN-US_TOPIC_0053158682__p4498490617654">Each key or value contains a maximum of 255 characters.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="EN-US_TOPIC_0053158682__table42731625205411"></a><a name="table42731625205411"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0053158682__table42731625205411" frame="border" border="1" rules="all"><caption><b>Table 4 </b><strong id="EN-US_TOPIC_0053158682__b4438135818217">security_groups</strong> field data structure description</caption><thead align="left"><tr id="EN-US_TOPIC_0053158682__row34164732205411"><th align="left" class="cellrowborder" valign="top" width="18.36816318368163%" id="mcps1.3.4.2.1.4.2.5.1.1"><p id="EN-US_TOPIC_0053158682__p255117254512">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="16.328367163283673%" id="mcps1.3.4.2.1.4.2.5.1.2"><p id="EN-US_TOPIC_0053158682__p055313224510">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="17.348265173482652%" id="mcps1.3.4.2.1.4.2.5.1.3"><p id="EN-US_TOPIC_0053158682__p2556142104512">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="47.95520447955205%" id="mcps1.3.4.2.1.4.2.5.1.4"><p id="EN-US_TOPIC_0053158682__p1556115294517">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0053158682__row6461164205411"><td class="cellrowborder" valign="top" width="18.36816318368163%" headers="mcps1.3.4.2.1.4.2.5.1.1 "><p id="EN-US_TOPIC_0053158682__p53592277205411">name</p>
</td>
<td class="cellrowborder" valign="top" width="16.328367163283673%" headers="mcps1.3.4.2.1.4.2.5.1.2 "><p id="EN-US_TOPIC_0053158682__p46007215205411">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="17.348265173482652%" headers="mcps1.3.4.2.1.4.2.5.1.3 "><p id="EN-US_TOPIC_0053158682__p35596962205411">String</p>
</td>
<td class="cellrowborder" valign="top" width="47.95520447955205%" headers="mcps1.3.4.2.1.4.2.5.1.4 "><p id="EN-US_TOPIC_0053158682__p64781653205411">Specifies the name of the security group to which the BMS belongs.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="EN-US_TOPIC_0053158682__table36009093171737"></a><a name="table36009093171737"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0053158682__table36009093171737" frame="border" border="1" rules="all"><caption><b>Table 5 </b><strong id="EN-US_TOPIC_0053158682__b2453348094725">networks</strong> field data structure description</caption><thead align="left"><tr id="EN-US_TOPIC_0053158682__row42632034171737"><th align="left" class="cellrowborder" valign="top" width="18.42%" id="mcps1.3.4.2.1.5.2.5.1.1"><p id="EN-US_TOPIC_0053158682__p133405190458">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="17.11%" id="mcps1.3.4.2.1.5.2.5.1.2"><p id="EN-US_TOPIC_0053158682__p16342141912455">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="19.74%" id="mcps1.3.4.2.1.5.2.5.1.3"><p id="EN-US_TOPIC_0053158682__p1134521916458">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="44.73%" id="mcps1.3.4.2.1.5.2.5.1.4"><p id="EN-US_TOPIC_0053158682__p19349141944517">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0053158682__row18447984171737"><td class="cellrowborder" valign="top" width="18.42%" headers="mcps1.3.4.2.1.5.2.5.1.1 "><p id="EN-US_TOPIC_0053158682__p1742148417187">port</p>
</td>
<td class="cellrowborder" valign="top" width="17.11%" headers="mcps1.3.4.2.1.5.2.5.1.2 "><p id="EN-US_TOPIC_0053158682__p39942372171737">No</p>
</td>
<td class="cellrowborder" valign="top" width="19.74%" headers="mcps1.3.4.2.1.5.2.5.1.3 "><p id="EN-US_TOPIC_0053158682__p51432231171829">String</p>
</td>
<td class="cellrowborder" valign="top" width="44.73%" headers="mcps1.3.4.2.1.5.2.5.1.4 "><p id="EN-US_TOPIC_0053158682__p48960383171839">Specifies the UUID of the network port.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0053158682__row16127665171737"><td class="cellrowborder" valign="top" width="18.42%" headers="mcps1.3.4.2.1.5.2.5.1.1 "><p id="EN-US_TOPIC_0053158682__p1668674617187">uuid</p>
</td>
<td class="cellrowborder" valign="top" width="17.11%" headers="mcps1.3.4.2.1.5.2.5.1.2 "><p id="EN-US_TOPIC_0053158682__p50041644171737">No</p>
</td>
<td class="cellrowborder" valign="top" width="19.74%" headers="mcps1.3.4.2.1.5.2.5.1.3 "><p id="EN-US_TOPIC_0053158682__p47350914171829">String</p>
</td>
<td class="cellrowborder" valign="top" width="44.73%" headers="mcps1.3.4.2.1.5.2.5.1.4 "><p id="EN-US_TOPIC_0053158682__p57312447171839">Specifies the network UUID.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0053158682__row38645887171737"><td class="cellrowborder" valign="top" width="18.42%" headers="mcps1.3.4.2.1.5.2.5.1.1 "><p id="EN-US_TOPIC_0053158682__p1793378117187">fixed_ip</p>
</td>
<td class="cellrowborder" valign="top" width="17.11%" headers="mcps1.3.4.2.1.5.2.5.1.2 "><p id="EN-US_TOPIC_0053158682__p18378580171737">No</p>
</td>
<td class="cellrowborder" valign="top" width="19.74%" headers="mcps1.3.4.2.1.5.2.5.1.3 "><p id="EN-US_TOPIC_0053158682__p24860872171829">String</p>
</td>
<td class="cellrowborder" valign="top" width="44.73%" headers="mcps1.3.4.2.1.5.2.5.1.4 "><p id="EN-US_TOPIC_0053158682__p39060604171839">Specifies the fixed IP address.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
<ul id="EN-US_TOPIC_0053158682__ul3791889116824"><li id="EN-US_TOPIC_0053158682__li572570216824">Example request<div class="codecoloring" codetype="Java" id="EN-US_TOPIC_0053158682__screen27548391225"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><span class="n">POST</span><span class="w"> </span><span class="n">https</span><span class="p">:</span><span class="c1">//{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/servers</span>
</pre></div></td></tr></table></div>
</div>
<div class="codecoloring" codetype="Java" id="EN-US_TOPIC_0053158682__screen3151504114168"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
<span class="normal"> 4</span>
<span class="normal"> 5</span>
<span class="normal"> 6</span>
<span class="normal"> 7</span>
<span class="normal"> 8</span>
<span class="normal"> 9</span>
<span class="normal">10</span>
<span class="normal">11</span>
<span class="normal">12</span>
<span class="normal">13</span></pre></div></td><td class="code"><div><pre><span></span><span class="p">{</span>
<span class="w"> </span><span class="s">&quot;server&quot;</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="s">&quot;imageRef&quot;</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;1a6635d8-afea-4f2b-abb6-27a202bad319&quot;</span><span class="p">,</span>
<span class="w"> </span><span class="s">&quot;flavorRef&quot;</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;physical.o2.medium&quot;</span><span class="p">,</span>
<span class="w"> </span><span class="s">&quot;name&quot;</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;bms_name01&quot;</span><span class="p">,</span>
<span class="w"> </span><span class="s">&quot;availability_zone&quot;</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;az-dc-1&quot;</span><span class="p">,</span>
<span class="w"> </span><span class="s">&quot;networks&quot;</span><span class="p">:</span><span class="w"> </span><span class="o">[</span>
<span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="s">&quot;uuid&quot;</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;8470310b-bfa2-4edf-8f64-d15196b2b2c9&quot;</span>
<span class="w"> </span><span class="p">}</span>
<span class="w"> </span><span class="o">]</span>
<span class="w"> </span><span class="p">}</span>
<span class="p">}</span>
</pre></div></td></tr></table></div>
</div>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0053158682__section1328768116824"><h4 class="sectiontitle">Response</h4><ul id="EN-US_TOPIC_0053158682__ul31541675173128"><li id="EN-US_TOPIC_0053158682__li15439627173128">Response parameters
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0053158682__table4738922173128" frame="border" border="1" rules="all"><thead align="left"><tr id="EN-US_TOPIC_0053158682__row63581626173128"><th align="left" class="cellrowborder" valign="top" width="23.169999999999998%" id="mcps1.3.5.2.1.1.1.4.1.1"><p id="EN-US_TOPIC_0053158682__p11743123884519">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="26.240000000000002%" id="mcps1.3.5.2.1.1.1.4.1.2"><p id="EN-US_TOPIC_0053158682__p574616386455">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50.59%" id="mcps1.3.5.2.1.1.1.4.1.3"><p id="EN-US_TOPIC_0053158682__p1775253812450">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0053158682__row15621585173128"><td class="cellrowborder" valign="top" width="23.169999999999998%" headers="mcps1.3.5.2.1.1.1.4.1.1 "><p id="EN-US_TOPIC_0053158682__p57388852173128">server</p>
</td>
<td class="cellrowborder" valign="top" width="26.240000000000002%" headers="mcps1.3.5.2.1.1.1.4.1.2 "><p id="EN-US_TOPIC_0053158682__p31166714191051">Object</p>
</td>
<td class="cellrowborder" valign="top" width="50.59%" headers="mcps1.3.5.2.1.1.1.4.1.3 "><p id="EN-US_TOPIC_0053158682__p25133623173128">Specifies the BMS information. For details, see <a href="#EN-US_TOPIC_0053158682__table25637149173128">Table 6</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="EN-US_TOPIC_0053158682__table25637149173128"></a><a name="table25637149173128"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0053158682__table25637149173128" frame="border" border="1" rules="all"><caption><b>Table 6 </b><strong id="EN-US_TOPIC_0053158682__b1016451318222">server</strong> field data structure description</caption><thead align="left"><tr id="EN-US_TOPIC_0053158682__row56523333173128"><th align="left" class="cellrowborder" valign="top" width="23.47%" id="mcps1.3.5.2.1.2.2.4.1.1"><p id="EN-US_TOPIC_0053158682__p4470165411451">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25.900000000000002%" id="mcps1.3.5.2.1.2.2.4.1.2"><p id="EN-US_TOPIC_0053158682__p947114542454">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50.629999999999995%" id="mcps1.3.5.2.1.2.2.4.1.3"><p id="EN-US_TOPIC_0053158682__p144807542455">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0053158682__row12983931173128"><td class="cellrowborder" valign="top" width="23.47%" headers="mcps1.3.5.2.1.2.2.4.1.1 "><p id="EN-US_TOPIC_0053158682__p45065510173128">security_groups</p>
</td>
<td class="cellrowborder" valign="top" width="25.900000000000002%" headers="mcps1.3.5.2.1.2.2.4.1.2 "><p id="EN-US_TOPIC_0053158682__p52236047191059">Array of objects</p>
</td>
<td class="cellrowborder" valign="top" width="50.629999999999995%" headers="mcps1.3.5.2.1.2.2.4.1.3 "><p id="EN-US_TOPIC_0053158682__p60269405173128">Specifies information about the BMS security group. For details, see <a href="#EN-US_TOPIC_0053158682__table1647050183630">Table 7</a>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0053158682__row19129447174652"><td class="cellrowborder" valign="top" width="23.47%" headers="mcps1.3.5.2.1.2.2.4.1.1 "><p id="EN-US_TOPIC_0053158682__p5981336174652">OS-DCF:diskConfig</p>
</td>
<td class="cellrowborder" valign="top" width="25.900000000000002%" headers="mcps1.3.5.2.1.2.2.4.1.2 "><p id="EN-US_TOPIC_0053158682__p14726202174652">String</p>
</td>
<td class="cellrowborder" valign="top" width="50.629999999999995%" headers="mcps1.3.5.2.1.2.2.4.1.3 "><p id="EN-US_TOPIC_0053158682__p29459773174827">Specifies the disk configuration. The value can be:</p>
<ul id="EN-US_TOPIC_0053158682__ul63811370174827"><li id="EN-US_TOPIC_0053158682__en-us_topic_0113746489_en-us_topic_0057972887_li47255404"><strong id="EN-US_TOPIC_0053158682__en-us_topic_0113746489_b842352706201852">MANUAL</strong>: The API uses the partitioning scheme in the image and the file system to create a <span id="EN-US_TOPIC_0053158682__en-us_topic_0113746489_text5742455133714">BMS</span><span id="EN-US_TOPIC_0053158682__en-us_topic_0113746489_text674310553373"></span>. If the target flavor has a large disk, the API does not partition the remaining disk space.</li><li id="EN-US_TOPIC_0053158682__en-us_topic_0113746489_en-us_topic_0057972887_li22645457"><strong id="EN-US_TOPIC_0053158682__en-us_topic_0113746489_b11108728193415">AUTO</strong>: The API uses a single partition with the same size as the disk of the target flavor to create a <span id="EN-US_TOPIC_0053158682__en-us_topic_0113746489_text1759675920373">BMS</span><span id="EN-US_TOPIC_0053158682__en-us_topic_0113746489_text1159611597371"></span>. The API automatically adjusts the file system to adapt to the entire partition.</li></ul>
</td>
</tr>
<tr id="EN-US_TOPIC_0053158682__row44983361174653"><td class="cellrowborder" valign="top" width="23.47%" headers="mcps1.3.5.2.1.2.2.4.1.1 "><p id="EN-US_TOPIC_0053158682__p19773625174653">id</p>
</td>
<td class="cellrowborder" valign="top" width="25.900000000000002%" headers="mcps1.3.5.2.1.2.2.4.1.2 "><p id="EN-US_TOPIC_0053158682__p58159806174653">String</p>
</td>
<td class="cellrowborder" valign="top" width="50.629999999999995%" headers="mcps1.3.5.2.1.2.2.4.1.3 "><p id="EN-US_TOPIC_0053158682__p13323831174653">Specifies the BMS ID.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0053158682__row50254960174653"><td class="cellrowborder" valign="top" width="23.47%" headers="mcps1.3.5.2.1.2.2.4.1.1 "><p id="EN-US_TOPIC_0053158682__p44119923174653">links</p>
</td>
<td class="cellrowborder" valign="top" width="25.900000000000002%" headers="mcps1.3.5.2.1.2.2.4.1.2 "><p id="EN-US_TOPIC_0053158682__p64107320191132">Array of objects</p>
</td>
<td class="cellrowborder" valign="top" width="50.629999999999995%" headers="mcps1.3.5.2.1.2.2.4.1.3 "><p id="EN-US_TOPIC_0053158682__p21662468183429">Specifies the shortcut links of the BMS. For details, see <a href="#EN-US_TOPIC_0053158682__table3029270918355">Table 8</a>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0053158682__row46057069174654"><td class="cellrowborder" valign="top" width="23.47%" headers="mcps1.3.5.2.1.2.2.4.1.1 "><p id="EN-US_TOPIC_0053158682__p39635070174654">adminPass</p>
</td>
<td class="cellrowborder" valign="top" width="25.900000000000002%" headers="mcps1.3.5.2.1.2.2.4.1.2 "><p id="EN-US_TOPIC_0053158682__p56324096174654">String</p>
</td>
<td class="cellrowborder" valign="top" width="50.629999999999995%" headers="mcps1.3.5.2.1.2.2.4.1.3 "><p id="EN-US_TOPIC_0053158682__p65957914174654">Specifies the initial login password of the BMS administrator account.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="EN-US_TOPIC_0053158682__table1647050183630"></a><a name="table1647050183630"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0053158682__table1647050183630" frame="border" border="1" rules="all"><caption><b>Table 7 </b><strong id="EN-US_TOPIC_0053158682__b13479153912210">security_groups</strong> field data structure description</caption><thead align="left"><tr id="EN-US_TOPIC_0053158682__row15268237183630"><th align="left" class="cellrowborder" valign="top" width="22.99%" id="mcps1.3.5.2.1.3.2.4.1.1"><p id="EN-US_TOPIC_0053158682__p209000120462">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="26.479999999999997%" id="mcps1.3.5.2.1.3.2.4.1.2"><p id="EN-US_TOPIC_0053158682__p59031412184610">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50.529999999999994%" id="mcps1.3.5.2.1.3.2.4.1.3"><p id="EN-US_TOPIC_0053158682__p12910131213460">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0053158682__row1777918183630"><td class="cellrowborder" valign="top" width="22.99%" headers="mcps1.3.5.2.1.3.2.4.1.1 "><p id="EN-US_TOPIC_0053158682__p9793636183630">name</p>
</td>
<td class="cellrowborder" valign="top" width="26.479999999999997%" headers="mcps1.3.5.2.1.3.2.4.1.2 "><p id="EN-US_TOPIC_0053158682__p55087051183630">String</p>
</td>
<td class="cellrowborder" valign="top" width="50.529999999999994%" headers="mcps1.3.5.2.1.3.2.4.1.3 "><p id="EN-US_TOPIC_0053158682__p44911546183630">Specifies the name of the security group to which the BMS belongs.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="EN-US_TOPIC_0053158682__table3029270918355"></a><a name="table3029270918355"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0053158682__table3029270918355" frame="border" border="1" rules="all"><caption><b>Table 8 </b><strong id="EN-US_TOPIC_0053158682__b15508141192215">links</strong> field data structure description</caption><thead align="left"><tr id="EN-US_TOPIC_0053158682__row4237903718355"><th align="left" class="cellrowborder" valign="top" width="23.630000000000003%" id="mcps1.3.5.2.1.4.2.4.1.1"><p id="EN-US_TOPIC_0053158682__p467412584614">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="26.36%" id="mcps1.3.5.2.1.4.2.4.1.2"><p id="EN-US_TOPIC_0053158682__p66760255468">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50.01%" id="mcps1.3.5.2.1.4.2.4.1.3"><p id="EN-US_TOPIC_0053158682__p10682192534612">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0053158682__row2915424618355"><td class="cellrowborder" valign="top" width="23.630000000000003%" headers="mcps1.3.5.2.1.4.2.4.1.1 "><p id="EN-US_TOPIC_0053158682__p1268376418355">rel</p>
</td>
<td class="cellrowborder" valign="top" width="26.36%" headers="mcps1.3.5.2.1.4.2.4.1.2 "><p id="EN-US_TOPIC_0053158682__p2075197418355">String</p>
</td>
<td class="cellrowborder" valign="top" width="50.01%" headers="mcps1.3.5.2.1.4.2.4.1.3 "><p id="EN-US_TOPIC_0053158682__p318835718355">Specifies the shortcut link marker name. The value can be:</p>
<ul id="EN-US_TOPIC_0053158682__ul207311644172510"><li id="EN-US_TOPIC_0053158682__en-us_topic_0131326852_li1013032685313"><strong id="EN-US_TOPIC_0053158682__en-us_topic_0131326852_b320113110516">self</strong>: resource link that contains the version number. It is used when immediate tracing is required.</li><li id="EN-US_TOPIC_0053158682__en-us_topic_0131326852_li14448163219533"><strong id="EN-US_TOPIC_0053158682__en-us_topic_0131326852_b84171947711">bookmark</strong>: resource link that can be stored for a long time.</li></ul>
</td>
</tr>
<tr id="EN-US_TOPIC_0053158682__row2869521618355"><td class="cellrowborder" valign="top" width="23.630000000000003%" headers="mcps1.3.5.2.1.4.2.4.1.1 "><p id="EN-US_TOPIC_0053158682__p4261119718355">href</p>
</td>
<td class="cellrowborder" valign="top" width="26.36%" headers="mcps1.3.5.2.1.4.2.4.1.2 "><p id="EN-US_TOPIC_0053158682__p2895492218355">String</p>
</td>
<td class="cellrowborder" valign="top" width="50.01%" headers="mcps1.3.5.2.1.4.2.4.1.3 "><p id="EN-US_TOPIC_0053158682__p6364732718355">Specifies the corresponding shortcut link.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
<ul id="EN-US_TOPIC_0053158682__ul45394811173935"><li id="EN-US_TOPIC_0053158682__li5900119173935">Example response<div class="codecoloring" codetype="Java" id="EN-US_TOPIC_0053158682__screen35105865141831"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
<span class="normal"> 4</span>
<span class="normal"> 5</span>
<span class="normal"> 6</span>
<span class="normal"> 7</span>
<span class="normal"> 8</span>
<span class="normal"> 9</span>
<span class="normal">10</span>
<span class="normal">11</span>
<span class="normal">12</span>
<span class="normal">13</span>
<span class="normal">14</span>
<span class="normal">15</span>
<span class="normal">16</span>
<span class="normal">17</span>
<span class="normal">18</span>
<span class="normal">19</span>
<span class="normal">20</span>
<span class="normal">21</span>
<span class="normal">22</span></pre></div></td><td class="code"><div><pre><span></span><span class="p">{</span>
<span class="w"> </span><span class="s">&quot;server&quot;</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="s">&quot;security_groups&quot;</span><span class="p">:</span><span class="w"> </span><span class="o">[</span>
<span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="s">&quot;name&quot;</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;default&quot;</span>
<span class="w"> </span><span class="p">}</span>
<span class="w"> </span><span class="o">]</span><span class="p">,</span>
<span class="w"> </span><span class="s">&quot;OS-DCF:diskConfig&quot;</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;MANUAL&quot;</span><span class="p">,</span>
<span class="w"> </span><span class="s">&quot;links&quot;</span><span class="p">:</span><span class="w"> </span><span class="o">[</span>
<span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="s">&quot;rel&quot;</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;self&quot;</span><span class="p">,</span>
<span class="w"> </span><span class="s">&quot;href&quot;</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;https://openstack.example.com/v2/c685484a8cc2416b97260938705deb65/servers/9ab74d89-61e7-4259-8546-465fdebe4944&quot;</span>
<span class="w"> </span><span class="p">},</span>
<span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="s">&quot;rel&quot;</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;bookmark&quot;</span><span class="p">,</span>
<span class="w"> </span><span class="s">&quot;href&quot;</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;https://openstack.example.com/c685484a8cc2416b97260938705deb65/servers/9ab74d89-61e7-4259-8546-465fdebe4944&quot;</span>
<span class="w"> </span><span class="p">}</span>
<span class="w"> </span><span class="o">]</span><span class="p">,</span>
<span class="w"> </span><span class="s">&quot;id&quot;</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;9ab74d89-61e7-4259-8546-465fdebe4944&quot;</span><span class="p">,</span>
<span class="w"> </span><span class="s">&quot;adminPass&quot;</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;RjdD3h8U2DBe&quot;</span>
<span class="w"> </span><span class="p">}</span>
<span class="p">}</span>
</pre></div></td></tr></table></div>
</div>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0053158682__section7610951"><h4 class="sectiontitle">Returned Values</h4><div class="p" id="EN-US_TOPIC_0053158682__en-us_topic_0106040941_p193201622141412">Normal values
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0053158682__en-us_topic_0106040941_table753804619176" frame="border" border="1" rules="all"><thead align="left"><tr id="EN-US_TOPIC_0053158682__en-us_topic_0106040941_row10735134615172"><th align="left" class="cellrowborder" valign="top" width="42.42%" id="mcps1.3.6.2.1.1.3.1.1"><p id="EN-US_TOPIC_0053158682__en-us_topic_0106040941_p19735204616177">Returned Values</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="57.58%" id="mcps1.3.6.2.1.1.3.1.2"><p id="EN-US_TOPIC_0053158682__en-us_topic_0106040941_p207355465176">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0053158682__en-us_topic_0106040941_row1473514621713"><td class="cellrowborder" valign="top" width="42.42%" headers="mcps1.3.6.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0053158682__en-us_topic_0106040941_p13735144611178">200</p>
</td>
<td class="cellrowborder" valign="top" width="57.58%" headers="mcps1.3.6.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0053158682__en-us_topic_0106040941_p207351246161711">The request has been successfully processed.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<p id="EN-US_TOPIC_0053158682__en-us_topic_0106040941_p47633965">For details about other returned values, see <a href="en-us_topic_0053158690.html">Status Codes</a>.</p>
</div>
<div class="section" id="EN-US_TOPIC_0053158682__section14752650154917"><h4 class="sectiontitle">Error Codes</h4><p id="EN-US_TOPIC_0053158682__en-us_topic_0106040941_p10243161417491">See <a href="en-us_topic_0107541808.html">Error Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0053158680.html">BMS Lifecycle Management</a></div>
</div>
</div>
View Git Blame Copy Permalink