vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity

ecs_api_0406

Browse Source 
Reviewed-by: Pristromskaia, Margarita <margarita.pristromskaia@t-systems.com>
Co-authored-by: guoyanyan <guoyanyan3@huawei.com>
Co-committed-by: guoyanyan <guoyanyan3@huawei.com>
This commit is contained in:
guoyanyan 2023-04-12 12:07:31 +00:00 committed by zuul
parent bf0cbd66f9
commit 3afe914820
13 changed files with 283 additions and 229 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

164
docs/ecs/api-ref/ALL_META.TXT.json
View File

File diff suppressed because it is too large Load Diff

271
docs/ecs/api-ref/CLASS.TXT.json
View File

File diff suppressed because it is too large Load Diff

5
docs/ecs/api-ref/en-us_topic_0020212656.html
View File

@ -312,7 +312,7 @@
</td>
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.5.2.5.2.4.1.2 "><p id="EN-US_TOPIC_0020212656__p533628131113">String</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.5.2.5.2.4.1.3 "><p id="EN-US_TOPIC_0020212656__p5109464911323">Indicates whether the GPU is passthrough.</p>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.5.2.5.2.4.1.3 "><p id="EN-US_TOPIC_0020212656__p5109464911323">Specifies whether the GPU is passthrough.</p>
<p id="EN-US_TOPIC_0020212656__p13931631112531">If the value is <strong id="EN-US_TOPIC_0020212656__b842352706204429">true</strong>, the GPU is passthrough.</p>
</td>
</tr>
@ -320,7 +320,8 @@
</td>
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.5.2.5.2.4.1.2 "><p id="EN-US_TOPIC_0020212656__p5875823928">String</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.5.2.5.2.4.1.3 "><p id="EN-US_TOPIC_0020212656__p1487514231826">Indicates the model and quantity of passthrough-enabled GPUs on P1 <span id="EN-US_TOPIC_0020212656__text1028171219513">ECS</span>s. The parameter value can be set to <strong id="EN-US_TOPIC_0020212656__b842352706163914">nvidia-p100:1</strong>, indicating that the <span id="EN-US_TOPIC_0020212656__text209911325670">ECS</span> using this specification will occupy one NVIDIA P100 GPU.</p>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.5.2.5.2.4.1.3 "><p id="EN-US_TOPIC_0020212656__p556115017155">Specifies the PCI passthrough device information in the "PCI device name:Quantity" format. Use commas (,) to separate multiple device information records.</p>
<p id="EN-US_TOPIC_0020212656__p109302278482">For example, nvidia-a30:1 indicates that the ECS has an A30 GPU attached.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0020212656__row169423685915"><td class="cellrowborder" valign="top" width="17%" headers="mcps1.3.5.2.5.2.4.1.1 "><p id="EN-US_TOPIC_0020212656__p395203616590">cond:operation:status</p>

8
docs/ecs/api-ref/en-us_topic_0020212668.html
View File

@ -65,7 +65,7 @@
</td>
<td class="cellrowborder" valign="top" width="12.910891089108908%" headers="mcps1.3.6.4.2.5.1.3 "><p id="EN-US_TOPIC_0020212668__p5317111619420">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="59.96039603960396%" headers="mcps1.3.6.4.2.5.1.4 "><p id="EN-US_TOPIC_0020212668__p935233824220">Specifies whether to check the request and create the ECS.</p>
<td class="cellrowborder" valign="top" width="59.96039603960396%" headers="mcps1.3.6.4.2.5.1.4 "><p id="EN-US_TOPIC_0020212668__p935233824220">Specifies whether to check the request and create the ECS. The default value is <strong id="EN-US_TOPIC_0020212668__b63425200195">false</strong>.</p>
<ul id="EN-US_TOPIC_0020212668__ul7754184810426"><li id="EN-US_TOPIC_0020212668__li686813556427"><strong id="EN-US_TOPIC_0020212668__b498744917315">true</strong>: indicates that only the request is sent, but the ECS will not be created. Check items include mandatory parameters and request format.<ul id="EN-US_TOPIC_0020212668__ul11514160124320"><li id="EN-US_TOPIC_0020212668__li975404864216">If the check fails, the system returns an error.</li><li id="EN-US_TOPIC_0020212668__li6754648124219">If the check is successful, the system returns status code 202.</li></ul>
</li><li id="EN-US_TOPIC_0020212668__li1535135815425"><strong id="EN-US_TOPIC_0020212668__b15743212414">false</strong>: indicates that the request is sent and the ECS will be created if the check result is as expected.</li></ul>
</td>
@ -318,7 +318,7 @@ echo 111 &gt; c:\aaa.txt</pre>
<td class="cellrowborder" valign="top" width="12%" headers="mcps1.3.6.6.2.5.1.3 "><p id="EN-US_TOPIC_0020212668__p65644149">String</p>
</td>
<td class="cellrowborder" valign="top" width="56.00000000000001%" headers="mcps1.3.6.6.2.5.1.4 "><p id="EN-US_TOPIC_0020212668__p52170790174229">Specifies the subnet of the <span id="EN-US_TOPIC_0020212668__text1290819290226">ECS</span>.</p>
<p id="EN-US_TOPIC_0020212668__p43287089174217">The value must be the ID of the subnet created in the VPC specified by <strong id="EN-US_TOPIC_0020212668__b769042597">vpcid</strong> and in the format of the UUID.</p>
<p id="EN-US_TOPIC_0020212668__p43287089174217">The value must be the ID of the subnet created in the VPC specified by <strong id="EN-US_TOPIC_0020212668__b175744485">vpcid</strong> and in the format of the UUID.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0020212668__row11285618104313"><td class="cellrowborder" valign="top" width="17%" headers="mcps1.3.6.6.2.5.1.1 "><p id="EN-US_TOPIC_0020212668__p34461706104313">ip_address</p>
@ -517,7 +517,7 @@ echo 111 &gt; c:\aaa.txt</pre>
</td>
<td class="cellrowborder" valign="top" width="12.121212121212121%" headers="mcps1.3.6.8.2.5.1.3 "><p id="EN-US_TOPIC_0020212668__p296112276588">Object</p>
</td>
<td class="cellrowborder" valign="top" width="55.55555555555556%" headers="mcps1.3.6.8.2.5.1.4 "><p id="EN-US_TOPIC_0020212668__p544756135816">Specifies the EVS disk metadata. Ensure that <strong id="EN-US_TOPIC_0020212668__b1202189677">key</strong> and <strong id="EN-US_TOPIC_0020212668__b1018579946">value</strong> in the metadata contain at most 255 bytes.</p>
<td class="cellrowborder" valign="top" width="55.55555555555556%" headers="mcps1.3.6.8.2.5.1.4 "><p id="EN-US_TOPIC_0020212668__p544756135816">Specifies the EVS disk metadata. Ensure that <strong id="EN-US_TOPIC_0020212668__b1364214413">key</strong> and <strong id="EN-US_TOPIC_0020212668__b866949263">value</strong> in the metadata contain at most 255 bytes.</p>
<p id="EN-US_TOPIC_0020212668__p5568103611379">This field is used only when an encrypted disk is created.</p>
<p id="EN-US_TOPIC_0020212668__p1815264144920">If data disks are created using a data disk image, this field cannot be used.</p>
<p id="EN-US_TOPIC_0020212668__p16970151531615">For details, see <a href="en-us_topic_0167957246.html#EN-US_TOPIC_0167957246__section1228814491353">metadata Field Description for Creating Disks</a>.</p>
@ -553,7 +553,7 @@ echo 111 &gt; c:\aaa.txt</pre>
<ul id="EN-US_TOPIC_0020212668__ul15938190403"><li id="EN-US_TOPIC_0020212668__li1693810910400">Example URL request<pre class="screen" id="EN-US_TOPIC_0020212668__screen27636168409">POST https://<em id="EN-US_TOPIC_0020212668__i5452131772714">{endpoint}</em>/v1/{project_id}/cloudservers</pre>
</li></ul>
</div>
<ul id="EN-US_TOPIC_0020212668__ul6110122211309"><li id="EN-US_TOPIC_0020212668__li191181837123013">An <span id="EN-US_TOPIC_0020212668__text1553017528228">ECS</span> with flavor ID <strong id="EN-US_TOPIC_0020212668__b1901566777">m3.larger</strong> is to be created, where the image ID is <strong id="EN-US_TOPIC_0020212668__b1066191719">imageid_123</strong>, disk type is <strong id="EN-US_TOPIC_0020212668__b1130423472">SSD</strong>, and VPC ID is <strong id="EN-US_TOPIC_0020212668__b1998640124">0dae26c9-9a70-4392-93f3-87d53115d171</strong>. An example request is as follows:<pre class="screen" id="EN-US_TOPIC_0020212668__screen0770128355">{
<ul id="EN-US_TOPIC_0020212668__ul6110122211309"><li id="EN-US_TOPIC_0020212668__li191181837123013">An <span id="EN-US_TOPIC_0020212668__text1553017528228">ECS</span> with flavor ID <strong id="EN-US_TOPIC_0020212668__b1880955693">m3.larger</strong> is to be created, where the image ID is <strong id="EN-US_TOPIC_0020212668__b539982407">imageid_123</strong>, disk type is <strong id="EN-US_TOPIC_0020212668__b2065869657">SSD</strong>, and VPC ID is <strong id="EN-US_TOPIC_0020212668__b1265253176">0dae26c9-9a70-4392-93f3-87d53115d171</strong>. An example request is as follows:<pre class="screen" id="EN-US_TOPIC_0020212668__screen0770128355">{
"server": {
"availability_zone":"az1-dc1",
"name": "newserver",

12
docs/ecs/api-ref/en-us_topic_0024734483.html
View File

@ -8,7 +8,13 @@
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0024734483__row153869324438"><td class="cellrowborder" valign="top" width="18.9%" headers="mcps1.3.1.1.3.1.1 "><p id="EN-US_TOPIC_0024734483__p183863321438">2022-12-20</p>
<tbody><tr id="EN-US_TOPIC_0024734483__row1471120387476"><td class="cellrowborder" valign="top" width="18.9%" headers="mcps1.3.1.1.3.1.1 "><p id="EN-US_TOPIC_0024734483__p9712173814715">2023-02-28</p>
</td>
<td class="cellrowborder" valign="top" width="81.10000000000001%" headers="mcps1.3.1.1.3.1.2 "><p id="EN-US_TOPIC_0024734483__p137125382472">Added the following content:</p>
<ul id="EN-US_TOPIC_0024734483__ul18678164819474"><li id="EN-US_TOPIC_0024734483__li1067920486472"><a href="en-us_topic_0170316409.html">Introduction</a></li></ul>
</td>
</tr>
<tr id="EN-US_TOPIC_0024734483__row153869324438"><td class="cellrowborder" valign="top" width="18.9%" headers="mcps1.3.1.1.3.1.1 "><p id="EN-US_TOPIC_0024734483__p183863321438">2022-12-20</p>
</td>
<td class="cellrowborder" valign="top" width="81.10000000000001%" headers="mcps1.3.1.1.3.1.2 "><p id="EN-US_TOPIC_0024734483__p138712326437">Modified the following content:</p>
<p id="EN-US_TOPIC_0024734483__p181891454431">Modified the value range of <strong id="EN-US_TOPIC_0024734483__b836112423546">volumetype</strong> and added ESSD in <a href="en-us_topic_0020212668.html">Creating an ECS</a>.</p>
@ -222,13 +228,13 @@
<tr id="EN-US_TOPIC_0024734483__row15365131818399"><td class="cellrowborder" valign="top" width="18.9%" headers="mcps1.3.1.1.3.1.1 "><p id="EN-US_TOPIC_0024734483__p10365181817392">2018-05-31</p>
</td>
<td class="cellrowborder" valign="top" width="81.10000000000001%" headers="mcps1.3.1.1.3.1.2 "><p id="EN-US_TOPIC_0024734483__p152081149144513">Modified the following content:</p>
<ul id="EN-US_TOPIC_0024734483__ul632513415408"><li id="EN-US_TOPIC_0024734483__li1432544174017">Fixed 59 UAT issues in <em id="EN-US_TOPIC_0024734483__i1048009854">Elastic Cloud Server API Reference 27</em>.</li></ul>
<ul id="EN-US_TOPIC_0024734483__ul632513415408"><li id="EN-US_TOPIC_0024734483__li1432544174017">Fixed 59 UAT issues in <em id="EN-US_TOPIC_0024734483__i1489944403">Elastic Cloud Server API Reference 27</em>.</li></ul>
</td>
</tr>
<tr id="EN-US_TOPIC_0024734483__row1227442101212"><td class="cellrowborder" valign="top" width="18.9%" headers="mcps1.3.1.1.3.1.1 "><p id="EN-US_TOPIC_0024734483__p18227242141218">2018-05-21</p>
</td>
<td class="cellrowborder" valign="top" width="81.10000000000001%" headers="mcps1.3.1.1.3.1.2 "><p id="EN-US_TOPIC_0024734483__p898917214465">Modified the following content:</p>
<ul id="EN-US_TOPIC_0024734483__ul164131486138"><li id="EN-US_TOPIC_0024734483__li54121683139">Added <a href="en-us_topic_0065962596.html">FPGA Logical File Management</a>.</li><li id="EN-US_TOPIC_0024734483__li116601232131318">Fixed 110 UAT issues in <em id="EN-US_TOPIC_0024734483__i1070439581">Elastic Cloud Server API Reference 26</em>.</li></ul>
<ul id="EN-US_TOPIC_0024734483__ul164131486138"><li id="EN-US_TOPIC_0024734483__li54121683139">Added <a href="en-us_topic_0065962596.html">FPGA Logical File Management</a>.</li><li id="EN-US_TOPIC_0024734483__li116601232131318">Fixed 110 UAT issues in <em id="EN-US_TOPIC_0024734483__i192412435">Elastic Cloud Server API Reference 26</em>.</li></ul>
</td>
</tr>
<tr id="EN-US_TOPIC_0024734483__row159145300559"><td class="cellrowborder" valign="top" width="18.9%" headers="mcps1.3.1.1.3.1.1 "><p id="EN-US_TOPIC_0024734483__p1914203075519">2018-03-30</p>

2
docs/ecs/api-ref/en-us_topic_0065817692.html
View File

@ -104,7 +104,7 @@
</td>
<td class="cellrowborder" valign="top" width="54.17999999999999%" headers="mcps1.3.5.4.2.5.1.4 "><p id="EN-US_TOPIC_0065817692__en-us_topic_0057973177_p25404503">Specifies the action.</p>
<p id="EN-US_TOPIC_0065817692__en-us_topic_0057973177_p490215356174">Options:</p>
<p id="EN-US_TOPIC_0065817692__en-us_topic_0057973177_p127002371171"><strong id="EN-US_TOPIC_0065817692__b842352706173827">create</strong>, <strong id="EN-US_TOPIC_0065817692__b842352706173830">delete</strong>, <strong id="EN-US_TOPIC_0065817692__b842352706173834">evacuate</strong>, <strong id="EN-US_TOPIC_0065817692__b842352706173837">restore</strong>, <strong id="EN-US_TOPIC_0065817692__b842352706173842">stop</strong>, <strong id="EN-US_TOPIC_0065817692__b842352706173846">start</strong>, <strong id="EN-US_TOPIC_0065817692__b842352706173849">reboot</strong>, <strong id="EN-US_TOPIC_0065817692__b842352706173854">rebuild</strong>, <strong id="EN-US_TOPIC_0065817692__b842352706173857">revertResize</strong>, <strong id="EN-US_TOPIC_0065817692__b84235270617392">confirmResize</strong>, <strong id="EN-US_TOPIC_0065817692__b84235270617397">detach_volume</strong>, <strong id="EN-US_TOPIC_0065817692__b842352706173910">attach_volume</strong>, <strong id="EN-US_TOPIC_0065817692__b842352706173914">attach_interface</strong>, <strong id="EN-US_TOPIC_0065817692__b842352706173917">detach_interface</strong>, <strong id="EN-US_TOPIC_0065817692__b842352706173920">lock</strong>, <strong id="EN-US_TOPIC_0065817692__b842352706173924">unlock</strong>, <strong id="EN-US_TOPIC_0065817692__b842352706173928">resize</strong>, <strong id="EN-US_TOPIC_0065817692__b842352706173932">migrate</strong>, <strong id="EN-US_TOPIC_0065817692__b842352706173937">pause</strong>, <strong id="EN-US_TOPIC_0065817692__b842352706173941">unpause</strong>, <strong id="EN-US_TOPIC_0065817692__b842352706173945">suspend</strong>, <strong id="EN-US_TOPIC_0065817692__b842352706173948">resume</strong>, <strong id="EN-US_TOPIC_0065817692__b842352706173952">rescue</strong>, <strong id="EN-US_TOPIC_0065817692__b842352706173956">unrescue</strong>, <strong id="EN-US_TOPIC_0065817692__b84235270617400">changePassword</strong>, <strong id="EN-US_TOPIC_0065817692__b84235270617404">shelve</strong>, <strong id="EN-US_TOPIC_0065817692__b84235270617407">unshelve</strong>, <strong id="EN-US_TOPIC_0065817692__b842352706174010">live-migration</strong>, <strong id="EN-US_TOPIC_0065817692__b842352706174015">live_migration_cancel</strong>, <strong id="EN-US_TOPIC_0065817692__b842352706174018">live_migration_force_complete</strong>, <strong id="EN-US_TOPIC_0065817692__b842352706174023">trigger_crash_dump</strong>, and <strong id="EN-US_TOPIC_0065817692__b842352706174025">extend_volume</strong></p>
<p id="EN-US_TOPIC_0065817692__en-us_topic_0057973177_p127002371171">create , delete , evacuate , restore , stop , start , reboot , rebuild , revertResize , confirmResize , detach_volume , attach_volume , attach_interface , detach_interface , lock , unlock , resize , migrate , pause , unpause , rescue , unrescue , changePassword , shelve ,unshelve , live-migration , live_migration_cancel , live_migration_force_complete , trigger_crash_dump, extend_volume</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0065817692__en-us_topic_0057973177_row27313937"><td class="cellrowborder" valign="top" width="13.79%" headers="mcps1.3.5.4.2.5.1.1 "><p id="EN-US_TOPIC_0065817692__en-us_topic_0057973177_p64945259">instance_uuid</p>

4
docs/ecs/api-ref/en-us_topic_0067876349.html
View File

@ -176,7 +176,7 @@ echo 111 &gt; c:\aaa.txt</pre>
<div class="section" id="EN-US_TOPIC_0067876349__section4722162513312"><h4 class="sectiontitle">Example Request</h4><ul id="EN-US_TOPIC_0067876349__ul95463984313"><li id="EN-US_TOPIC_0067876349__li1984203213915">Example URL request<pre class="screen" id="EN-US_TOPIC_0067876349__screen1667162394">POST https://{endpoint}/v2/{project_id}/cloudservers/{server_id}/reinstallos</pre>
</li><li id="EN-US_TOPIC_0067876349__li105413912437">Example request 1 (using a password to remotely log in to an ECS with OS reinstalled)<pre class="screen" id="EN-US_TOPIC_0067876349__screen65463934318">{
"os-reinstall": {
"adminpass": "!QAZxsw2",
"userid": "7e25b1da389f4697a79df3a0e5bd494e",
"mode": "withStopServer"
}
@ -192,7 +192,7 @@ echo 111 &gt; c:\aaa.txt</pre>
</div>
<ul id="EN-US_TOPIC_0067876349__ul0419725171619"><li id="EN-US_TOPIC_0067876349__li15419102513161">Example request 3 (using a password to remotely log in a full-ECS-image-created <span id="EN-US_TOPIC_0067876349__text1214811652412">ECS</span> with OS reinstalled and system disk encrypted)<pre class="screen" id="EN-US_TOPIC_0067876349__screen1450485212165">{
"os-reinstall": {
"adminpass": "!QAZxsw2",
"userid": "7e25b1da389f4697a79df3a0e5bd494e",
"metadata": {
"__system__encrypted": "1",

4
docs/ecs/api-ref/en-us_topic_0067876971.html
View File

@ -187,7 +187,7 @@ echo 111 &gt; c:\aaa.txt</pre>
</li></ul>
<ul id="EN-US_TOPIC_0067876971__ul15101195714167"><li id="EN-US_TOPIC_0067876971__li610110573169">Example request 1 (using a password to remotely log in to an ECS with OS changed)<pre class="screen" id="EN-US_TOPIC_0067876971__screen11102115716161">{
"os-change": {
"adminpass": "1qazXSW@",
"userid": "7e25b1da389f4697a79df3a0e5bd494e",
"imageid": "e215580f-73ad-429d-b6f2-5433947433b0"
}
@ -203,7 +203,7 @@ echo 111 &gt; c:\aaa.txt</pre>
</li></ul>
<ul id="EN-US_TOPIC_0067876971__ul64373262102922"><li id="EN-US_TOPIC_0067876971__li42488453102922">Example request 3 (using a password to remotely log in a full-ECS-image-created <span id="EN-US_TOPIC_0067876971__text188601028162412">ECS</span> with OS changed and system disk encrypted)<pre class="screen" id="EN-US_TOPIC_0067876971__screen40301619143023">{
"os-change": {
"adminpass": "1qazXSW@",
"userid": "7e25b1da389f4697a79df3a0e5bd494e",
"imageid": "e215580f-73ad-429d-b6f2-5433947433b0",
"metadata": {

3
docs/ecs/api-ref/en-us_topic_0094148850.html
View File

@ -45,7 +45,8 @@
</td>
<td class="cellrowborder" valign="top" width="52%" headers="mcps1.3.3.2.5.1.4 "><p id="EN-US_TOPIC_0094148850__p193574196363">Specifies a page number. </p>
<p id="EN-US_TOPIC_0094148850__p273217563714">The value must be greater than or equal to <strong id="EN-US_TOPIC_0094148850__b64961322204618">0</strong> and the default value is <strong id="EN-US_TOPIC_0094148850__b192973156465">1</strong>.</p>
<p id="EN-US_TOPIC_0094148850__p20184253142913">If the value is <strong id="EN-US_TOPIC_0094148850__b1767273615477">0</strong>, the first page is displayed, which is the same as the value <strong id="EN-US_TOPIC_0094148850__b193189305488">1</strong>.</p>
<p id="EN-US_TOPIC_0094148850__p054716207248">If the value is <strong id="EN-US_TOPIC_0094148850__b537019118223">0</strong>, the first page is displayed, which is the same as the value <strong id="EN-US_TOPIC_0094148850__b12371311112215">1</strong>.</p>
<p id="EN-US_TOPIC_0094148850__p20184253142913">You are advised to set this parameter to a value greater than or equal to 1.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0094148850__row25743851"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.3.2.5.1.1 "><p id="EN-US_TOPIC_0094148850__p4877220">flavor</p>

2
docs/ecs/api-ref/en-us_topic_0103071509.html
View File

@ -5,6 +5,8 @@
</div>
<div>
<ul class="ullinks">
<li class="ulchildlink"><strong><a href="en-us_topic_0170316409.html">Introduction</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0103071510.html">Lifecycle Management</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0103071511.html">ECS Status Management</a></strong><br>

8
docs/ecs/api-ref/en-us_topic_0167957246.html
View File

@ -168,7 +168,7 @@
<div class="section" id="EN-US_TOPIC_0167957246__section1361484104817"><a name="EN-US_TOPIC_0167957246__section1361484104817"></a><a name="section1361484104817"></a><h4 class="sectiontitle"><strong id="EN-US_TOPIC_0167957246__b842352706201741">extendparam</strong> Field Description for Creating Disks</h4><p id="EN-US_TOPIC_0167957246__p139721455174812">This field is used by the following APIs:</p>
<ul id="EN-US_TOPIC_0167957246__ul38671635191711"><li id="EN-US_TOPIC_0167957246__li138671635131720">Creating <span id="EN-US_TOPIC_0167957246__text98263317572">ECS</span>s /v1/{project_id}/cloudservers</li></ul>
<div class="p" id="EN-US_TOPIC_0167957246__p18592141931719">
<div class="tablenoborder"><a name="EN-US_TOPIC_0167957246__table7562101331712"></a><a name="table7562101331712"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0167957246__table7562101331712" frame="border" border="1" rules="all"><caption><b>Table 5 </b><strong id="EN-US_TOPIC_0167957246__b1519122706">extendparam</strong> field description for creating disks</caption><thead align="left"><tr id="EN-US_TOPIC_0167957246__en-us_topic_0020212668_row4999061312178"><th align="left" class="cellrowborder" valign="top" width="18.988101189881014%" id="mcps1.3.6.4.1.2.5.1.1"><p id="EN-US_TOPIC_0167957246__en-us_topic_0020212668_p159171369431">Parameter</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0167957246__table7562101331712"></a><a name="table7562101331712"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0167957246__table7562101331712" frame="border" border="1" rules="all"><caption><b>Table 5 </b><strong id="EN-US_TOPIC_0167957246__b2049292315">extendparam</strong> field description for creating disks</caption><thead align="left"><tr id="EN-US_TOPIC_0167957246__en-us_topic_0020212668_row4999061312178"><th align="left" class="cellrowborder" valign="top" width="18.988101189881014%" id="mcps1.3.6.4.1.2.5.1.1"><p id="EN-US_TOPIC_0167957246__en-us_topic_0020212668_p159171369431">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="15.978402159784022%" id="mcps1.3.6.4.1.2.5.1.2"><p id="EN-US_TOPIC_0167957246__en-us_topic_0020212668_p19933936124315">Mandatory</p>
</th>
@ -401,7 +401,7 @@
<td class="cellrowborder" valign="top" width="17.64705882352941%" headers="mcps1.3.10.3.1.2.4.1.2 "><p id="EN-US_TOPIC_0167957246__p1875525203412">Array of strings</p>
</td>
<td class="cellrowborder" valign="top" width="64.70588235294117%" headers="mcps1.3.10.3.1.2.4.1.3 "><p id="EN-US_TOPIC_0167957246__p2075515233412">Creates <span id="EN-US_TOPIC_0167957246__text47531458105820">ECS</span>s on a dedicated or shared host.</p>
<p id="EN-US_TOPIC_0167957246__p475545223418">The value of this parameter can be <strong id="EN-US_TOPIC_0167957246__b1366471362">dedicated</strong> or <strong id="EN-US_TOPIC_0167957246__b1332171243">shared</strong>.</p>
<p id="EN-US_TOPIC_0167957246__p475545223418">The value of this parameter can be <strong id="EN-US_TOPIC_0167957246__b754278422">dedicated</strong> or <strong id="EN-US_TOPIC_0167957246__b1620334412">shared</strong>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0167957246__row19755145243414"><td class="cellrowborder" valign="top" width="17.64705882352941%" headers="mcps1.3.10.3.1.2.4.1.1 "><p id="EN-US_TOPIC_0167957246__p127551852113411">dedicated_host_id</p>
@ -409,7 +409,7 @@
<td class="cellrowborder" valign="top" width="17.64705882352941%" headers="mcps1.3.10.3.1.2.4.1.2 "><p id="EN-US_TOPIC_0167957246__p775595210342">Array of strings</p>
</td>
<td class="cellrowborder" valign="top" width="64.70588235294117%" headers="mcps1.3.10.3.1.2.4.1.3 "><p id="EN-US_TOPIC_0167957246__p15755145218349">Specifies the dedicated host ID.</p>
<div class="note" id="EN-US_TOPIC_0167957246__note197550525344"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="EN-US_TOPIC_0167957246__p1755952203411">A DeH ID takes effect only when <strong id="EN-US_TOPIC_0167957246__b1403417977">tenancy</strong> is set to <strong id="EN-US_TOPIC_0167957246__b498086753">dedicated</strong>.</p>
<div class="note" id="EN-US_TOPIC_0167957246__note197550525344"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="EN-US_TOPIC_0167957246__p1755952203411">A DeH ID takes effect only when <strong id="EN-US_TOPIC_0167957246__b548982492">tenancy</strong> is set to <strong id="EN-US_TOPIC_0167957246__b2133514751">dedicated</strong>.</p>
</div></div>
</td>
</tr>
@ -449,7 +449,7 @@
<div class="section" id="EN-US_TOPIC_0167957246__section12781010134512"><a name="EN-US_TOPIC_0167957246__section12781010134512"></a><a name="section12781010134512"></a><h4 class="sectiontitle"><strong id="EN-US_TOPIC_0167957246__b84235270691152">extra_dhcp_opts</strong> Field Description</h4><div class="p" id="EN-US_TOPIC_0167957246__p15751323144515">This field is used by the following APIs:<ul id="EN-US_TOPIC_0167957246__ul1975152311451"><li id="EN-US_TOPIC_0167957246__li1075323144510">Creating ECSs: /v1/{project_id}/cloudservers</li></ul>
</div>
<div class="tablenoborder"><a name="EN-US_TOPIC_0167957246__table93959401279"></a><a name="table93959401279"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0167957246__table93959401279" frame="border" border="1" rules="all"><caption><b>Table 12 </b><strong id="EN-US_TOPIC_0167957246__b721858341">extra_dhcp_opts</strong> field description</caption><thead align="left"><tr id="EN-US_TOPIC_0167957246__en-us_topic_0020212668_row1142718406718"><th align="left" class="cellrowborder" valign="top" width="22.747725227477254%" id="mcps1.3.12.3.2.5.1.1"><p id="EN-US_TOPIC_0167957246__en-us_topic_0020212668_p83691007441">Parameter</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0167957246__table93959401279"></a><a name="table93959401279"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0167957246__table93959401279" frame="border" border="1" rules="all"><caption><b>Table 12 </b><strong id="EN-US_TOPIC_0167957246__b1354666859">extra_dhcp_opts</strong> field description</caption><thead align="left"><tr id="EN-US_TOPIC_0167957246__en-us_topic_0020212668_row1142718406718"><th align="left" class="cellrowborder" valign="top" width="22.747725227477254%" id="mcps1.3.12.3.2.5.1.1"><p id="EN-US_TOPIC_0167957246__en-us_topic_0020212668_p83691007441">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="14.84851514848515%" id="mcps1.3.12.3.2.5.1.2"><p id="EN-US_TOPIC_0167957246__en-us_topic_0020212668_p136919015446">Mandatory</p>
</th>

24
docs/ecs/api-ref/en-us_topic_0170316409.html Normal file
View File

@ -0,0 +1,24 @@
<a name="EN-US_TOPIC_0170316409"></a><a name="EN-US_TOPIC_0170316409"></a>
<h1 class="topictitle1">Introduction</h1>
<div id="body1558076859038"><p id="EN-US_TOPIC_0170316409__p18526461975">This section describes fine-grained permissions management for your ECSs. If your account does not need individual IAM users, then you may skip over this section.</p>
<p id="EN-US_TOPIC_0170316409__p19531646576">A policy is a set of permissions defined in JSON format. By default, new IAM users do not have permissions assigned. You need to add a user to one or more groups, and attach permissions policies or roles to these groups. Users inherit permissions from the groups to which they are added and can perform specified operations on cloud services based on the permissions.</p>
<p id="EN-US_TOPIC_0170316409__p15535461971">You can grant users permissions by using roles and policies. Roles are provided by IAM to define service-based permissions depending on user's job responsibilities. Policies define API-based permissions for operations on specific resources under certain conditions, allowing for more fine-grained, secure access control of cloud resources.</p>
<p id="EN-US_TOPIC_0170316409__p92274279292">For more information about system policies supported by ECS, see "ECS Permissions Management" in <em id="EN-US_TOPIC_0170316409__i570839141817">Elastic Cloud Server User Guide</em>.</p>
<div class="note" id="EN-US_TOPIC_0170316409__note69644451277"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0170316409__p15539182014114">Policy-based authorization is useful if you want to allow or deny the access to an API.</p>
</div></div>
<p id="EN-US_TOPIC_0170316409__p125444616717">An account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions. The permissions required for calling an API are determined by the actions supported by the API. Only users who have been granted permissions allowing the actions can call the API successfully. For example, if an IAM user wants to query ECSs using an API, the user must have been granted permissions that allow the <strong id="EN-US_TOPIC_0170316409__b1174615443151">ecs:servers:list</strong> action.</p>
<div class="section" id="EN-US_TOPIC_0170316409__section794711451173"><h4 class="sectiontitle">Supported Actions</h4><p id="EN-US_TOPIC_0170316409__p185434612715">Operations supported by policies are specific to APIs. The following are common concepts related to policies:</p>
<ul id="EN-US_TOPIC_0170316409__ul15546466714"><li id="EN-US_TOPIC_0170316409__li1354164610714">Permission: A statement in a policy that allows or denies certain operations.</li><li id="EN-US_TOPIC_0170316409__li193151213144">API: REST APIs that can be called by a user who has been granted specific permissions.</li><li id="EN-US_TOPIC_0170316409__li2545463711">Action: Specific operations that are allowed or denied.</li><li id="EN-US_TOPIC_0170316409__li530819363144">Dependent actions: When assigning an action to users, you also need to assign dependent permissions for that action to take effect.</li><li id="EN-US_TOPIC_0170316409__li2059118134571">IAM projects or enterprise project: Scope of users a permission is granted to. Policies that contain actions for both IAM and enterprise projects can be used and take effect for both IAM and Enterprise Management. Policies that only contain actions for IAM projects can be used and only take effect for IAM.</li></ul>
<div class="note" id="EN-US_TOPIC_0170316409__note1880171618159"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0170316409__p12801816111510">√: supported; x: not supported</p>
</div></div>
<p id="EN-US_TOPIC_0170316409__p3544461578">ECS supports the following actions that can be defined in custom policies:</p>
<ul id="EN-US_TOPIC_0170316409__ul99595565149"><li id="EN-US_TOPIC_0170316409__li89591956151411"><a href="en-us_topic_0103071510.html">Lifecycle Management</a></li><li id="EN-US_TOPIC_0170316409__li579992611512"><a href="en-us_topic_0103071511.html">ECS Status Management</a></li><li id="EN-US_TOPIC_0170316409__li564213635517"><a href="en-us_topic_0184167662.html">Batch Operations</a></li><li id="EN-US_TOPIC_0170316409__li53559172162"><a href="en-us_topic_0103072350.html">Network Management</a></li><li id="EN-US_TOPIC_0170316409__li18736203010169"><a href="en-us_topic_0103072348.html">Image Management</a></li><li id="EN-US_TOPIC_0170316409__li19562149101610"><a href="en-us_topic_0103072347.html">Security Group Management</a></li><li id="EN-US_TOPIC_0170316409__li168954542112"><a href="en-us_topic_0103071522.html">Specifications Query</a></li><li id="EN-US_TOPIC_0170316409__li209582146173"><a href="en-us_topic_0103071513.html">NIC Management</a></li><li id="EN-US_TOPIC_0170316409__li15529178226"><a href="en-us_topic_0103071514.html">Disk Management</a></li><li id="EN-US_TOPIC_0170316409__li734019422221"><a href="en-us_topic_0103071516.html">Metadata Management</a></li><li id="EN-US_TOPIC_0170316409__li16738152152314"><a href="en-us_topic_0103071517.html">Tenant Quota Management</a></li><li id="EN-US_TOPIC_0170316409__li6652182213234"><a href="en-us_topic_0103071515.html">SSH Key Management</a></li><li id="EN-US_TOPIC_0170316409__li248413407237"><a href="en-us_topic_0103072349.html">Floating IP Address Management</a></li><li id="EN-US_TOPIC_0170316409__li6604156182311"><a href="en-us_topic_0103071520.html">ECS Group Management</a></li><li id="EN-US_TOPIC_0170316409__li1158521816567"><a href="en-us_topic_0184192952.html">ECS Management Through Console</a></li><li id="EN-US_TOPIC_0170316409__li13100132922416"><a href="en-us_topic_0103071519.html">AZ Management</a></li><li id="EN-US_TOPIC_0170316409__li51971411162417"><a href="en-us_topic_0103071521.html">Tag Management</a></li></ul>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0103071509.html">Permissions Policies and Supported Actions</a></div>
</div>
</div>

5
docs/ecs/api-ref/en-us_topic_0170710254.html
View File

@ -94,7 +94,7 @@
</td>
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.1.3.2.4.1.2 "><p id="EN-US_TOPIC_0170710254__en-us_topic_0020212656_p533628131113">String</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.1.3.2.4.1.3 "><p id="EN-US_TOPIC_0170710254__en-us_topic_0020212656_p5109464911323">Indicates whether the GPU is passthrough.</p>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.1.3.2.4.1.3 "><p id="EN-US_TOPIC_0170710254__en-us_topic_0020212656_p5109464911323">Specifies whether the GPU is passthrough.</p>
<p id="EN-US_TOPIC_0170710254__en-us_topic_0020212656_p13931631112531">If the value is <strong id="EN-US_TOPIC_0170710254__en-us_topic_0020212656_b842352706204429">true</strong>, the GPU is passthrough.</p>
</td>
</tr>
@ -102,7 +102,8 @@
</td>
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.1.3.2.4.1.2 "><p id="EN-US_TOPIC_0170710254__en-us_topic_0020212656_p5875823928">String</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.1.3.2.4.1.3 "><p id="EN-US_TOPIC_0170710254__en-us_topic_0020212656_p1487514231826">Indicates the model and quantity of passthrough-enabled GPUs on P1 <span id="EN-US_TOPIC_0170710254__en-us_topic_0020212656_text1028171219513">ECS</span>s. The parameter value can be set to <strong id="EN-US_TOPIC_0170710254__en-us_topic_0020212656_b842352706163914">nvidia-p100:1</strong>, indicating that the <span id="EN-US_TOPIC_0170710254__en-us_topic_0020212656_text209911325670">ECS</span> using this specification will occupy one NVIDIA P100 GPU.</p>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.1.3.2.4.1.3 "><p id="EN-US_TOPIC_0170710254__en-us_topic_0020212656_p556115017155">Specifies the PCI passthrough device information in the "PCI device name:Quantity" format. Use commas (,) to separate multiple device information records.</p>
<p id="EN-US_TOPIC_0170710254__en-us_topic_0020212656_p109302278482">For example, nvidia-a30:1 indicates that the ECS has an A30 GPU attached.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0170710254__en-us_topic_0020212656_row169423685915"><td class="cellrowborder" valign="top" width="17%" headers="mcps1.3.1.3.2.4.1.1 "><p id="EN-US_TOPIC_0170710254__en-us_topic_0020212656_p395203616590">cond:operation:status</p>