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

ecs_dev_1109

Browse Source 
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-authored-by: guoyanyan <guoyanyan3@huawei.com>
Co-committed-by: guoyanyan <guoyanyan3@huawei.com>
This commit is contained in:
guoyanyan 2022-11-09 22:26:29 +00:00 committed by zuul
parent 0f168cd32e
commit bd7aa2df1d
13 changed files with 35 additions and 29 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
docs/ecs/dev/ALL_META.TXT.json
View File

@ -13,7 +13,7 @@
"uri":"en-us_topic_0134327704.html",
"product_code":"ecs",
"code":"2",
"des":"Before using ECS through APIs, learn how to call ECS APIs. For details about how to call REST APIs, see section API Usage Guidelines.",
"des":"Before using ECS through APIs, learn how to call ECS APIs. For details about how to call REST APIs, see API Usage Guidelines.",
"doc_type":"devg",
"kw":"Notes,Developer Guide",
"title":"Notes",

2
docs/ecs/dev/CLASS.TXT.json
View File

@ -9,7 +9,7 @@
"code":"1"
},
{
"desc":"Before using ECS through APIs, learn how to call ECS APIs. For details about how to call REST APIs, see section API Usage Guidelines.",
"desc":"Before using ECS through APIs, learn how to call ECS APIs. For details about how to call REST APIs, see API Usage Guidelines.",
"product_code":"ecs",
"title":"Notes",
"uri":"en-us_topic_0134327704.html",

12
docs/ecs/dev/en-us_topic_0134192987.html
View File

@ -40,7 +40,7 @@
</li></ul>
</li><li id="EN-US_TOPIC_0134192987__li4521173045311">Select a flavor based on site requirements and record the flavor ID.</li></ol>
</p></li><li id="EN-US_TOPIC_0134192987__li1285212380536"><span>Determine the image.</span><p><ol type="a" id="EN-US_TOPIC_0134192987__ol136811076547"><li id="EN-US_TOPIC_0134192987__li132965391517">View images.<ul id="EN-US_TOPIC_0134192987__ul129614391515"><li id="EN-US_TOPIC_0134192987__li22968396511">API<p id="EN-US_TOPIC_0134192987__p52963398516"><a name="EN-US_TOPIC_0134192987__li22968396511"></a><a name="li22968396511"></a>URI format: GET /v2/{tenant_id}/images/detail</p>
<p id="EN-US_TOPIC_0134192987__p4118175164211">For details, see section "Querying Image Details" in <em id="EN-US_TOPIC_0134192987__i8423526979148">Elastic Cloud Server API Reference</em>.</p>
<p id="EN-US_TOPIC_0134192987__p4118175164211">For details, see section "Querying Image Details" in <em id="EN-US_TOPIC_0134192987__i8423526979148_1">Elastic Cloud Server API Reference</em>.</p>
</li><li id="EN-US_TOPIC_0134192987__li529613985118">Request example<p class="subitemlist" id="EN-US_TOPIC_0134192987__p19352547174211"><a name="EN-US_TOPIC_0134192987__li529613985118"></a><a name="li529613985118"></a>GET: https://<em id="EN-US_TOPIC_0134192987__i44541427144719">{endpoint</em><em id="EN-US_TOPIC_0134192987__i12454162716477">}</em>/v2/74610f3a5ad941998e91f076297ecf27/images/detail</p>
<p id="EN-US_TOPIC_0134192987__p141307585424">Obtain the endpoint from <a href="https://docs.otc.t-systems.com/en-us/endpoint/index.html" target="_blank" rel="noopener noreferrer">Regions and Endpoints</a>.</p>
</li><li id="EN-US_TOPIC_0134192987__li18296103910512">Response example<pre class="screen" id="EN-US_TOPIC_0134192987__screen1296739185117">{
@ -90,7 +90,7 @@
</li></ul>
</li><li id="EN-US_TOPIC_0134192987__li155834285542">Select an image based on site requirements and record the image ID.</li></ol>
</p></li><li id="EN-US_TOPIC_0134192987__li123521935105519"><span>Determine the network configuration.</span><p><ol type="a" id="EN-US_TOPIC_0134192987__ol20358135111556"><li id="EN-US_TOPIC_0134192987__li13296123985112">View networks.<ul id="EN-US_TOPIC_0134192987__ul1129616399514"><li id="EN-US_TOPIC_0134192987__li629614398518">API<p id="EN-US_TOPIC_0134192987__p529673910511"><a name="EN-US_TOPIC_0134192987__li629614398518"></a><a name="li629614398518"></a>URI format: GET /v2/{tenant_id}/os-networks</p>
<p id="EN-US_TOPIC_0134192987__p188988141445">For details, see section "Querying Networks" in <em id="EN-US_TOPIC_0134192987__i8423526979148_1">Elastic Cloud Server API Reference</em>.</p>
<p id="EN-US_TOPIC_0134192987__p188988141445">For details, see section "Querying Networks" in <em id="EN-US_TOPIC_0134192987__i8423526979148_3">Elastic Cloud Server API Reference</em>.</p>
</li><li id="EN-US_TOPIC_0134192987__li10296439155119">Request example<p class="subitemlist" id="EN-US_TOPIC_0134192987__p126942401505"><a name="EN-US_TOPIC_0134192987__li10296439155119"></a><a name="li10296439155119"></a>GET: https://<em id="EN-US_TOPIC_0134192987__i154288514474">{endpoint</em><em id="EN-US_TOPIC_0134192987__i15428175114716">}</em>/v2/74610f3a5ad941998e91f076297ecf27/os-networks</p>
<p id="EN-US_TOPIC_0134192987__p1667331012439">Obtain the endpoint from <a href="https://docs.otc.t-systems.com/en-us/endpoint/index.html" target="_blank" rel="noopener noreferrer">Regions and Endpoints</a>.</p>
</li><li id="EN-US_TOPIC_0134192987__li152961393519">Response example<pre class="screen" id="EN-US_TOPIC_0134192987__screen629693919516">{
@ -113,7 +113,7 @@
</li></ul>
</li><li id="EN-US_TOPIC_0134192987__li44115576555">Select a network based on site requirements and record the network ID.</li></ol>
</p></li><li id="EN-US_TOPIC_0134192987__li1829613914513"><span>Set the login mode to key pair.</span><p><ol type="a" id="EN-US_TOPIC_0134192987__ol9498131115614"><li id="EN-US_TOPIC_0134192987__li9498161185616">Create a key pair.<ul id="EN-US_TOPIC_0134192987__ul122965398515"><li id="EN-US_TOPIC_0134192987__li16296113912513">API<p id="EN-US_TOPIC_0134192987__p52961439125117"><a name="EN-US_TOPIC_0134192987__li16296113912513"></a><a name="li16296113912513"></a>URI format: POST /v2/{tenant_id}/os-keypairs</p>
<p id="EN-US_TOPIC_0134192987__p123392216459">For details, see section "Creating and Importing an SSH Key Pair" in <em id="EN-US_TOPIC_0134192987__i84235269792538">Elastic Cloud Server API Reference</em>.</p>
<p id="EN-US_TOPIC_0134192987__p123392216459">For details, see section "Creating and Importing an SSH Key Pair" in <em id="EN-US_TOPIC_0134192987__i84235269792538_1">Elastic Cloud Server API Reference</em>.</p>
</li><li id="EN-US_TOPIC_0134192987__li12296639135116">Request example<p id="EN-US_TOPIC_0134192987__p1652071115588"><a name="EN-US_TOPIC_0134192987__li12296639135116"></a><a name="li12296639135116"></a>POST: https://<em id="EN-US_TOPIC_0134192987__i47001837125619">{endpoint}</em>/v2/74610f3a5ad941998e91f076297ecf27/os-keypairs</p>
<p id="EN-US_TOPIC_0134192987__p1974121710436">Obtain the endpoint from <a href="https://docs.otc.t-systems.com/en-us/endpoint/index.html" target="_blank" rel="noopener noreferrer">Regions and Endpoints</a>.</p>
<p id="EN-US_TOPIC_0134192987__p14379174925814">Body</p>
@ -135,7 +135,7 @@
}</pre>
</li></ul>
</li><li id="EN-US_TOPIC_0134192987__li5819429016">Import the key pair.<ul id="EN-US_TOPIC_0134192987__ul391220341813"><li id="EN-US_TOPIC_0134192987__li1991283141812">API<p id="EN-US_TOPIC_0134192987__p169121636182"><a name="EN-US_TOPIC_0134192987__li1991283141812"></a><a name="li1991283141812"></a>URI format: POST /v2/{tenant_id}/os-keypairs</p>
<p id="EN-US_TOPIC_0134192987__p563193120461">For details, see section "Creating and Importing an SSH Key Pair" in <em id="EN-US_TOPIC_0134192987__i84235269792538_1">Elastic Cloud Server API Reference</em>.</p>
<p id="EN-US_TOPIC_0134192987__p563193120461">For details, see section "Creating and Importing an SSH Key Pair" in <em id="EN-US_TOPIC_0134192987__i84235269792538_3">Elastic Cloud Server API Reference</em>.</p>
</li><li id="EN-US_TOPIC_0134192987__li199124331811">Request example<p class="subitemlist" id="EN-US_TOPIC_0134192987__p189288312186"><a name="EN-US_TOPIC_0134192987__li199124331811"></a><a name="li199124331811"></a>POST: https://<em id="EN-US_TOPIC_0134192987__i17707145005710">{endpoint}</em>/v2/74610f3a5ad941998e91f076297ecf27/os-keypairs</p>
<p id="EN-US_TOPIC_0134192987__p1701022164315">Obtain the endpoint from <a href="https://docs.otc.t-systems.com/en-us/endpoint/index.html" target="_blank" rel="noopener noreferrer">Regions and Endpoints</a>.</p>
<p id="EN-US_TOPIC_0134192987__p395920301817">Body</p>
@ -160,7 +160,7 @@
</p></li><li id="EN-US_TOPIC_0134192987__li1320313439275"><span>Create an ECS authenticated using the key pair.</span><p><ul id="EN-US_TOPIC_0134192987__ul6203843192719"><li id="EN-US_TOPIC_0134192987__li92192043102712">API<p id="EN-US_TOPIC_0134192987__p521904315270"><a name="EN-US_TOPIC_0134192987__li92192043102712"></a><a name="li92192043102712"></a>URI format: POST /v2/{tenant_id}/servers</p>
<p id="EN-US_TOPIC_0134192987__p1599312494710">For details about API constraints and request parameters, see section "Creating an ECS" in <em id="EN-US_TOPIC_0134192987__i84235269792742">Elastic Cloud Server API Reference</em>.</p>
<div class="note" id="EN-US_TOPIC_0134192987__note6402193519816"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0134192987__p10418635582">In this example, the ECS is created using a specified image. Therefore,</p>
<ul id="EN-US_TOPIC_0134192987__ul04189350820"><li class="subitemlist" id="EN-US_TOPIC_0134192987__li341863518814">In <strong id="EN-US_TOPIC_0134192987__b842352706145839">block_device_mapping_v2</strong>, set <strong id="EN-US_TOPIC_0134192987__b842352706145845">source_type</strong> to <strong id="EN-US_TOPIC_0134192987__b842352706145850">image</strong>, <strong id="EN-US_TOPIC_0134192987__b842352706145854">uuid</strong> to the image ID, <strong id="EN-US_TOPIC_0134192987__b84235270614591">destination_type</strong> to <strong id="EN-US_TOPIC_0134192987__b84235270614596">volume</strong>, and <strong id="EN-US_TOPIC_0134192987__b842352706145911">boot_index</strong> to <strong id="EN-US_TOPIC_0134192987__b842352706145913">0</strong>.</li><li id="EN-US_TOPIC_0134192987__li20434635786">The <strong id="EN-US_TOPIC_0134192987__b842352706145930">volume_size</strong> must be greater than or equal to the minimum value specified in the image metadata.</li></ul>
<ul id="EN-US_TOPIC_0134192987__ul04189350820"><li class="subitemlist" id="EN-US_TOPIC_0134192987__li341863518814">In <strong id="EN-US_TOPIC_0134192987__b842352706145839_1">block_device_mapping_v2</strong>, set <strong id="EN-US_TOPIC_0134192987__b842352706145845_1">source_type</strong> to <strong id="EN-US_TOPIC_0134192987__b842352706145850_1">image</strong>, <strong id="EN-US_TOPIC_0134192987__b842352706145854_1">uuid</strong> to the image ID, <strong id="EN-US_TOPIC_0134192987__b84235270614591_1">destination_type</strong> to <strong id="EN-US_TOPIC_0134192987__b84235270614596_1">volume</strong>, and <strong id="EN-US_TOPIC_0134192987__b842352706145911_1">boot_index</strong> to <strong id="EN-US_TOPIC_0134192987__b842352706145913_1">0</strong>.</li><li id="EN-US_TOPIC_0134192987__li20434635786">The <strong id="EN-US_TOPIC_0134192987__b842352706145930_1">volume_size</strong> must be greater than or equal to the minimum value specified in the image metadata.</li></ul>
</div></div>
</li><li id="EN-US_TOPIC_0134192987__li1621914312273">Request example<p class="subitemlist" id="EN-US_TOPIC_0134192987__p13234643102715"><a name="EN-US_TOPIC_0134192987__li1621914312273"></a><a name="li1621914312273"></a>POST: https://<em id="EN-US_TOPIC_0134192987__i7340131906">{endpoint}</em>/v2/74610f3a5ad941998e91f076297ecf27/servers</p>
<p id="EN-US_TOPIC_0134192987__p86872814431">Obtain the endpoint from <a href="https://docs.otc.t-systems.com/en-us/endpoint/index.html" target="_blank" rel="noopener noreferrer">Regions and Endpoints</a>.</p>
@ -209,7 +209,7 @@
}</pre>
</li></ul>
</p></li><li id="EN-US_TOPIC_0134192987__li44614293347"><span>Verify the ECS creation.</span><p><ul id="EN-US_TOPIC_0134192987__ul1778911313454"><li id="EN-US_TOPIC_0134192987__li1178917319459">API<p id="EN-US_TOPIC_0134192987__p98051031459"><a name="EN-US_TOPIC_0134192987__li1178917319459"></a><a name="li1178917319459"></a>URI format: GET /v2/{tenant_id}/servers/{server_id}</p>
<p id="EN-US_TOPIC_0134192987__p19574143615485">For details, see section "Querying Details About an ECS" in <em id="EN-US_TOPIC_0134192987__i8423526979148_2">Elastic Cloud Server API Reference</em>.</p>
<p id="EN-US_TOPIC_0134192987__p19574143615485">For details, see section "Querying Details About an ECS" in <em id="EN-US_TOPIC_0134192987__i8423526979148_5">Elastic Cloud Server API Reference</em>.</p>
</li><li id="EN-US_TOPIC_0134192987__li1080517313459">Request example<p class="subitemlist" id="EN-US_TOPIC_0134192987__p08212310451"><a name="EN-US_TOPIC_0134192987__li1080517313459"></a><a name="li1080517313459"></a>GET: https://<em id="EN-US_TOPIC_0134192987__i1727172419518">{endpoint}</em>/v2/74610f3a5ad941998e91f076297ecf27/servers/0c71c0da-8852-4c56-a1d1-3a9b9bcb6da6</p>
<p id="EN-US_TOPIC_0134192987__p667518282512">Where,</p>
<p id="EN-US_TOPIC_0134192987__p14179325223"><strong id="EN-US_TOPIC_0134192987__b84235270615848">0c71c0da-8852-4c56-a1d1-3a9b9bcb6da6</strong> is the UUID of the created ECS.</p>

6
docs/ecs/dev/en-us_topic_0134192993.html
View File

@ -9,7 +9,7 @@
<ul id="EN-US_TOPIC_0134192993__ul15633112133212"><li id="EN-US_TOPIC_0134192993__li156331021123214">API for modifying the specifications of an ECS</li><li id="EN-US_TOPIC_0134192993__li18633721113211">API for confirming ECS specifications modification</li><li id="EN-US_TOPIC_0134192993__li5633172113321">API for rolling back ECS specifications modification</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0134192993__section193094162712"><h4 class="sectiontitle">Procedure</h4><ol id="EN-US_TOPIC_0134192993__ol1774421418331"><li id="EN-US_TOPIC_0134192993__li20744151453314"><span>Modify the ECS specifications.</span><p><ul id="EN-US_TOPIC_0134192993__ul143321827133518"><li id="EN-US_TOPIC_0134192993__li1532554016381">API<p id="EN-US_TOPIC_0134192993__p1034054083812"><a name="EN-US_TOPIC_0134192993__li1532554016381"></a><a name="li1532554016381"></a>URI format: POST /v2/{tenant_id}/servers/{server_id}/action</p>
<p id="EN-US_TOPIC_0134192993__p1464317514508">For details, see section "Modifying the Specifications of an ECS" in <em id="EN-US_TOPIC_0134192993__i8423526979148">Elastic Cloud Server API Reference</em>.</p>
<p id="EN-US_TOPIC_0134192993__p1464317514508">For details, see section "Modifying the Specifications of an ECS" in <em id="EN-US_TOPIC_0134192993__i8423526979148_1">Elastic Cloud Server API Reference</em>.</p>
</li><li id="EN-US_TOPIC_0134192993__li1234016404388">Request example<pre class="screen" id="EN-US_TOPIC_0134192993__screen534094063813">{
"resize": {
"flavorRef": "4"
@ -18,7 +18,7 @@
</li><li id="EN-US_TOPIC_0134192993__li83401040153810">Response example<p id="EN-US_TOPIC_0134192993__p73403402387"><a name="EN-US_TOPIC_0134192993__li83401040153810"></a><a name="li83401040153810"></a>N/A</p>
</li></ul>
</p></li><li id="EN-US_TOPIC_0134192993__li188259221331"><span>Confirm the specifications modification.</span><p><div class="p" id="EN-US_TOPIC_0134192993__p11580182118396">The ECS must be in <span class="parmvalue" id="EN-US_TOPIC_0134192993__parmvalue210728689615396"><b>resized</b></span> state. That is, the <span class="parmvalue" id="EN-US_TOPIC_0134192993__parmvalue799918360153936"><b>OS-EXT-STS:vm_state</b></span> value of the ECS must be <span class="parmvalue" id="EN-US_TOPIC_0134192993__parmvalue162622219153950"><b>resized</b></span>.<ul id="EN-US_TOPIC_0134192993__ul8574215163917"><li id="EN-US_TOPIC_0134192993__li3574015183912">API<p id="EN-US_TOPIC_0134192993__p95741815143913"><a name="EN-US_TOPIC_0134192993__li3574015183912"></a><a name="li3574015183912"></a>URI format: POST /v2/{tenant_id}/servers/{server_id}/action</p>
<p id="EN-US_TOPIC_0134192993__p1857442165013">For details, see section "Confirming ECS Specifications Modification" in <em id="EN-US_TOPIC_0134192993__i8423526979148_1">Elastic Cloud Server API Reference</em>.</p>
<p id="EN-US_TOPIC_0134192993__p1857442165013">For details, see section "Confirming ECS Specifications Modification" in <em id="EN-US_TOPIC_0134192993__i8423526979148_3">Elastic Cloud Server API Reference</em>.</p>
</li><li id="EN-US_TOPIC_0134192993__li1257411513392">Request example<pre class="screen" id="EN-US_TOPIC_0134192993__screen1057491593911">{
"confirmResize": null
}</pre>
@ -29,7 +29,7 @@
<p id="EN-US_TOPIC_0134192993__p0100165494115">The ECS must be in <span class="parmvalue" id="EN-US_TOPIC_0134192993__parmvalue405896410154116"><b>resized</b></span> state. That is, the <span class="parmvalue" id="EN-US_TOPIC_0134192993__parmvalue1238507323154122"><b>OS-EXT-STS:vm_state</b></span> value of the ECS must be <span class="parmvalue" id="EN-US_TOPIC_0134192993__parmvalue523641083154134"><b>resized</b></span>.</p>
<p id="EN-US_TOPIC_0134192993__p15141427124218">The data modified during specifications modification will be lost after the rollback.</p>
<ul id="EN-US_TOPIC_0134192993__ul49511542114112"><li id="EN-US_TOPIC_0134192993__li1095124215412">API<p id="EN-US_TOPIC_0134192993__p795104204115"><a name="EN-US_TOPIC_0134192993__li1095124215412"></a><a name="li1095124215412"></a>URI format: POST /v2/{tenant_id}/servers/{server_id}/action</p>
<p id="EN-US_TOPIC_0134192993__p10262193820519">For details, see section "Rolling Back ECS Specifications Modification" in <em id="EN-US_TOPIC_0134192993__i8423526979148_2">Elastic Cloud Server API Reference</em>.</p>
<p id="EN-US_TOPIC_0134192993__p10262193820519">For details, see section "Rolling Back ECS Specifications Modification" in <em id="EN-US_TOPIC_0134192993__i8423526979148_5">Elastic Cloud Server API Reference</em>.</p>
</li><li id="EN-US_TOPIC_0134192993__li1795113425410">Request example<pre class="screen" id="EN-US_TOPIC_0134192993__screen1735819262440">{
"revertResize": null
}</pre>

30
docs/ecs/dev/en-us_topic_0134193006.html
View File

@ -1,15 +1,15 @@
<a name="EN-US_TOPIC_0134193006"></a><a name="EN-US_TOPIC_0134193006"></a>
<h1 class="topictitle1">Microversions</h1>
<div id="body14894508"><p id="EN-US_TOPIC_0134193006__p38261652131610">v2.1 APIs support microversions for small/medium API changes or document changes.</p>
<p id="EN-US_TOPIC_0134193006__p37764268">Users can use a microversion to obtain the latest API microversion supported by a cloud service. A cloud service that has been upgraded to the latest microversion is compatible with the original microversions. Users can also use a microversion to obtain new cloud service properties.</p>
<p id="EN-US_TOPIC_0134193006__p4334098">The version API returns the minimum and maximum microversions. The client uses the two values to specify the microversion range supported by an API.</p>
<div id="body14894508"><p class="msonormal" id="EN-US_TOPIC_0134193006__p38261652131610">v2.1 APIs support microversions for small/medium API changes or document changes.</p>
<p class="msonormal" id="EN-US_TOPIC_0134193006__p37764268">Users can use a microversion to obtain the latest API microversion supported by a cloud service. A cloud service that has been upgraded to the latest microversion is compatible with the original microversions. Users can also use a microversion to obtain new cloud service properties.</p>
<p class="msonormal" id="EN-US_TOPIC_0134193006__p4334098">The version API returns the minimum and maximum microversions. The client uses the two values to specify the microversion range supported by an API.</p>
<div class="section" id="EN-US_TOPIC_0134193006__section190304191812"><h4 class="sectiontitle">Microversion Response Example</h4><p id="EN-US_TOPIC_0134193006__p18212163710199">If the values of <strong id="EN-US_TOPIC_0134193006__b842352706111911">version</strong> and <strong id="EN-US_TOPIC_0134193006__b842352706111916">min_version</strong> are null, the endpoint does not support microversions.</p>
<ul id="EN-US_TOPIC_0134193006__ul6547192315193"><li id="EN-US_TOPIC_0134193006__li1054792371917"><strong id="EN-US_TOPIC_0134193006__b1860923657112112">version</strong>: indicates the maximum microversion.</li><li id="EN-US_TOPIC_0134193006__li1547172391915"><strong id="EN-US_TOPIC_0134193006__b1327822864112128">min_version</strong>: indicates the minimum microversion.</li></ul>
<p id="EN-US_TOPIC_0134193006__p25637925">A microversion on the client must be within the range specified by <strong id="EN-US_TOPIC_0134193006__b1494616183112254">version</strong> and <strong id="EN-US_TOPIC_0134193006__b1270155551112254">min_version</strong> to access the endpoint. The client uses the following HTTP header to specify a microversion:</p>
<p id="EN-US_TOPIC_0134193006__p63406026">X-OpenStack-Nova-API-Version: 2.4</p>
<p id="EN-US_TOPIC_0134193006__p33783328">Since microversion 2.27, the client can also use the following header to specify a microversion:</p>
<p id="EN-US_TOPIC_0134193006__p57218521189">Openstack-API-Version: compute 2.27</p>
<ul id="EN-US_TOPIC_0134193006__ul6547192315193"><li class="msonormal" id="EN-US_TOPIC_0134193006__li1054792371917"><strong id="EN-US_TOPIC_0134193006__b1860923657112112">version</strong>: indicates the maximum microversion.</li><li class="msonormal" id="EN-US_TOPIC_0134193006__li1547172391915"><strong id="EN-US_TOPIC_0134193006__b1327822864112128">min_version</strong>: indicates the minimum microversion.</li></ul>
<p class="msonormal" id="EN-US_TOPIC_0134193006__p25637925">A microversion on the client must be within the range specified by <strong id="EN-US_TOPIC_0134193006__b1494616183112254">version</strong> and <strong id="EN-US_TOPIC_0134193006__b1270155551112254">min_version</strong> to access the endpoint. The client uses the following HTTP header to specify a microversion:</p>
<p class="msonormal" id="EN-US_TOPIC_0134193006__p63406026">X-OpenStack-Nova-API-Version: 2.4</p>
<p class="msonormal" id="EN-US_TOPIC_0134193006__p33783328">Since microversion 2.27, the client can also use the following header to specify a microversion:</p>
<p class="msonormal" id="EN-US_TOPIC_0134193006__p57218521189">Openstack-API-Version: compute 2.27</p>
<p id="EN-US_TOPIC_0134193006__p7977191872116">In the following response example, the maximum microversion is 2.14 and the minimum one is 2.1:</p>
<pre class="screen" id="EN-US_TOPIC_0134193006__screen1119132681610">{
"versions": [
@ -42,9 +42,8 @@
]
}</pre>
</div>
<div class="section" id="EN-US_TOPIC_0134193006__section953273282314"><h4 class="sectiontitle">Microversion Request Example</h4><p id="EN-US_TOPIC_0134193006__p58946502">For example, you are required to use the API for details about an ECS to view the <strong id="EN-US_TOPIC_0134193006__b842352706141941">OS-EXT-SRV-ATTR:hostname</strong> field.</p>
</div>
<ul class="subitemlist" id="EN-US_TOPIC_0134193006__ul9937389"><li id="EN-US_TOPIC_0134193006__li1335175318246"><strong id="EN-US_TOPIC_0134193006__b842352706142032">Using a v2 API without a microversion</strong><ul id="EN-US_TOPIC_0134193006__ul54974372156"><li id="EN-US_TOPIC_0134193006__li39179065">GET: https://<em id="EN-US_TOPIC_0134193006__i497403485019">{endpoint}</em>/v2/74610f3a5ad941998e91f076297ecf27/servers/detail<p id="EN-US_TOPIC_0134193006__p143171815116">Obtain the endpoint from <a href="https://docs.otc.t-systems.com/en-us/endpoint/index.html" target="_blank" rel="noopener noreferrer">Regions and Endpoints</a>.</p>
<div class="section" id="EN-US_TOPIC_0134193006__section953273282314"><h4 class="sectiontitle">Microversion Request Example</h4><p class="msonormal" id="EN-US_TOPIC_0134193006__p58946502">For example, you are required to use the API for details about an ECS to view the <strong id="EN-US_TOPIC_0134193006__b842352706141941">OS-EXT-SRV-ATTR:hostname</strong> field.</p>
<ul class="subitemlist" id="EN-US_TOPIC_0134193006__ul9937389"><li class="msonormal" id="EN-US_TOPIC_0134193006__li1335175318246"><strong id="EN-US_TOPIC_0134193006__b842352706142032_1">Using a v2 API without a microversion</strong><ul id="EN-US_TOPIC_0134193006__ul54974372156"><li id="EN-US_TOPIC_0134193006__li39179065">GET: https://<em id="EN-US_TOPIC_0134193006__i497403485019">{endpoint}</em>/v2/74610f3a5ad941998e91f076297ecf27/servers/detail<p id="EN-US_TOPIC_0134193006__p143171815116">Obtain the endpoint from <a href="https://docs.otc.t-systems.com/en-us/endpoint/index.html" target="_blank" rel="noopener noreferrer">Regions and Endpoints</a>.</p>
</li><li id="EN-US_TOPIC_0134193006__li17067270">Headers
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0134193006__table19387710" frame="border" border="1" rules="all"><tbody><tr id="EN-US_TOPIC_0134193006__row14795382"><td class="cellrowborder" valign="top" width="50%"><p id="EN-US_TOPIC_0134193006__p57575265">Content-Type</p>
</td>
@ -83,7 +82,7 @@
"metadata": {},
"OS-EXT-STS:task_state": null,
"OS-DCF:diskConfig": "MANUAL",
"OS-EXT-AZ:availability_zone": "eu-de-01",
"OS-EXT-AZ:availability_zone":"az1-dc1",
"links": [
{
"rel": "self",
@ -144,9 +143,9 @@
}
]
}</pre>
</li><li id="EN-US_TOPIC_0134193006__li13681172611223">Conclusion: The response body does not contain the <strong id="EN-US_TOPIC_0134193006__b842352706142323">OS-EXT-SRV-ATTR:hostname</strong> field.</li></ul>
</li><li class="msonormal" id="EN-US_TOPIC_0134193006__li13681172611223">Conclusion: The response body does not contain the <strong id="EN-US_TOPIC_0134193006__b842352706142323_1">OS-EXT-SRV-ATTR:hostname</strong> field.</li></ul>
</li></ul>
<ul class="subitemlist" id="EN-US_TOPIC_0134193006__ul20810330"><li id="EN-US_TOPIC_0134193006__li184119416268"><strong id="EN-US_TOPIC_0134193006__b842352706142032_1">Using a v2.1 API with a microversion</strong><ul id="EN-US_TOPIC_0134193006__ul5317649152213"><li id="EN-US_TOPIC_0134193006__li41111342">GET: https://<em id="EN-US_TOPIC_0134193006__i893614539539">{endpoint}</em>/v2.1/74610f3a5ad941998e91f076297ecf27/servers/detail<p id="EN-US_TOPIC_0134193006__p711810406537">Obtain the endpoint from <a href="https://docs.otc.t-systems.com/en-us/endpoint/index.html" target="_blank" rel="noopener noreferrer">Regions and Endpoints</a>.</p>
<ul class="subitemlist" id="EN-US_TOPIC_0134193006__ul20810330"><li class="msonormal" id="EN-US_TOPIC_0134193006__li184119416268"><strong id="EN-US_TOPIC_0134193006__b842352706142032_3">Using a v2.1 API with a microversion</strong><ul id="EN-US_TOPIC_0134193006__ul5317649152213"><li id="EN-US_TOPIC_0134193006__li41111342">GET: https://<em id="EN-US_TOPIC_0134193006__i893614539539">{endpoint}</em>/v2.1/74610f3a5ad941998e91f076297ecf27/servers/detail<p id="EN-US_TOPIC_0134193006__p711810406537">Obtain the endpoint from <a href="https://docs.otc.t-systems.com/en-us/endpoint/index.html" target="_blank" rel="noopener noreferrer">Regions and Endpoints</a>.</p>
</li><li id="EN-US_TOPIC_0134193006__li34457765">Headers
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0134193006__table41684430" frame="border" border="1" rules="all"><tbody><tr id="EN-US_TOPIC_0134193006__row5034912"><td class="cellrowborder" valign="top" width="50%"><p id="EN-US_TOPIC_0134193006__p5174700">Content-Type</p>
</td>
@ -263,9 +262,10 @@
}
]
}</pre>
</li><li id="EN-US_TOPIC_0134193006__li9256123413243">Conclusion: The response body contains the <strong id="EN-US_TOPIC_0134193006__b842352706142323_1">OS-EXT-SRV-ATTR:hostname</strong> field.</li></ul>
</li><li class="msonormal" id="EN-US_TOPIC_0134193006__li9256123413243">Conclusion: The response body contains the <strong id="EN-US_TOPIC_0134193006__b842352706142323_3">OS-EXT-SRV-ATTR:hostname</strong> field.</li></ul>
</li></ul>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0134193004.html">Request Format</a></div>

2
docs/ecs/dev/en-us_topic_0134327704.html
View File

@ -1,7 +1,7 @@
<a name="EN-US_TOPIC_0134327704"></a><a name="EN-US_TOPIC_0134327704"></a>
<h1 class="topictitle1">Notes</h1>
<div id="body1539161194487"><p id="EN-US_TOPIC_0134327704__p8060118">Before using ECS through APIs, learn how to call ECS APIs. For details about how to call REST APIs, see section <a href="https://docs.otc.t-systems.com/en-us/api/apiug/apig-en-api-180328001.html" target="_blank" rel="noopener noreferrer">API Usage Guidelines</a>.</p>
<div id="body1539161194487"><p id="EN-US_TOPIC_0134327704__p8060118">Before using ECS through APIs, learn how to call ECS APIs. For details about how to call REST APIs, see <a href="https://docs.otc.t-systems.com/en-us/api/apiug/apig-en-api-180328001.html" target="_blank" rel="noopener noreferrer">API Usage Guidelines</a>.</p>
</div>
<div></div>

8
docs/ecs/dev/en-us_topic_0134883593.html
View File

@ -8,7 +8,13 @@
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0134883593__row174316081917"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.1.1.3.1.1 "><p id="EN-US_TOPIC_0134883593__p5743170191918">2021-10-20</p>
<tbody><tr id="EN-US_TOPIC_0134883593__row19753204111410"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.1.1.3.1.1 "><p id="EN-US_TOPIC_0134883593__p175415417148">2022-10-30</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.1.1.3.1.2 "><p id="EN-US_TOPIC_0134883593__p47541842147">This issue is the third official release.</p>
<ul id="EN-US_TOPIC_0134883593__ul184471451165911"><li id="EN-US_TOPIC_0134883593__li1330911112017">Optimized descriptions in <a href="en-us_topic_0134192984.html">Request Example</a>.</li><li id="EN-US_TOPIC_0134883593__li3447175111593">Changed the title to "Creating an ECS" in <a href="en-us_topic_0134192987.html">Creating an ECS</a>.</li></ul>
</td>
</tr>
<tr id="EN-US_TOPIC_0134883593__row174316081917"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.1.1.3.1.1 "><p id="EN-US_TOPIC_0134883593__p5743170191918">2021-10-20</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.1.1.3.1.2 "><p id="EN-US_TOPIC_0134883593__p127435011910">This issue is the second official release.</p>
<p id="EN-US_TOPIC_0134883593__p9659162310193">Optimized descriptions in <a href="en-us_topic_0134192990.html">Overview</a>.</p>

2
docs/ecs/dev/public_sys-resources/commonrtl.css
View File

@ -1,2 +1,2 @@
.msgph{font-family:Courier New}.unresolved{background-color:#87ceeb}.noTemplate{background-color:#ff0}.base{background-color:#fff}/*! Add space for top level topics */.nested0,.p{margin-top:1em}/*! div with class=p is used for paragraphs that contain blocks, to keep the XHTML valid *//*! Default of italics to set apart figure captions */.figcap,.italic,.var{font-style:italic}.figdesc{font-style:normal}/*! Use @frame to create frames on figures */.figborder{padding-left:3px;padding-right:3px;margin-top:1em;border:2px solid Silver}.figsides{margin-top:1em;padding-left:3px;padding-right:3px;border-left:2px solid Silver;border-right:2px solid Silver}.figtop{border-top:2px solid Silver;margin-top:1em}.figbottom{border-bottom:2px solid Silver}.figtopbot{border-top:2px solid Silver;border-bottom:2px solid Silver;margin-top:1em}/*! Most link groups are created with <div>. Ensure they have space before and after. */.ullinks,ul.simple{list-style-type:none}.attention,.danger,.ddexpand,.dlexpand,.example,.fastpath,.important,.liexpand,.linklist,.note,.notice,.olchildlink,.relconcepts,.relinfo,.relref,.reltasks,.remember,.restriction,.section,.sliexpand,.stepexpand,.substepexpand,.tip,.ulchildlink,.warning{margin-top:1em;margin-bottom:1em}.linklistwithchild,.sublinklist{margin-top:1em;margin-right:1.5em;margin-bottom:1em}.breadcrumb{font-size:smaller;margin-bottom:1em}.prereq{margin-right:20px}/*! Set heading sizes, getting smaller for deeper nesting */.topictitle1{font-size:1.34em;margin-top:0;margin-bottom:.1em}.topictitle2,.topictitle3,.topictitle4,.topictitle5,.topictitle6,.sectiontitle{font-size:1.17em}.topictitle2{margin-top:1pc;margin-bottom:.45em}.topictitle3{margin-top:1pc;margin-bottom:.17em;font-weight:700}.topictitle4{margin-top:.83em;font-weight:700}.topictitle5{font-weight:700}.topictitle6{font-style:italic}.sectiontitle{margin-top:1em;margin-bottom:0;color:#000;font-weight:700}/*! All note formats have the same default presentation */.attentiontitle,.bold,.cautiontitle,.dangertitle,.dlterm,.fastpathtitle,.firstcol,.importanttitle,.notelisttitle,.notetitle,.noticetitle,.parmname,.remembertitle,.restrictiontitle,.tiptitle,.uicontrol,.warningtitle{font-weight:700}.caution{font-weight:700;margin-bottom:1em}/*! Simple lists do not get a bullet *//*! Used on the first column of a table, when rowheader="firstcol" is used *//*! Various basic phrase styles */.boldItalic{font-weight:700;font-style:italic}.shortcut,.underlined{text-decoration:underline}/*! 2008-10-27 keyword采用跟随上下文的样式
/*! Copyright (c) Huawei Technologies Co., Ltd. 2020-2022. All rights reserved. */.msgph{font-family:Courier New}.unresolved{background-color:#87ceeb}.noTemplate{background-color:#ff0}.base{background-color:#fff}/*! Add space for top level topics */.nested0,.p{margin-top:1em}/*! div with class=p is used for paragraphs that contain blocks, to keep the XHTML valid *//*! Default of italics to set apart figure captions */.figcap,.italic,.var{font-style:italic}.figdesc{font-style:normal}/*! Use @frame to create frames on figures */.figborder{padding-left:3px;padding-right:3px;margin-top:1em;border:2px solid Silver}.figsides{margin-top:1em;padding-left:3px;padding-right:3px;border-left:2px solid Silver;border-right:2px solid Silver}.figtop{border-top:2px solid Silver;margin-top:1em}.figbottom{border-bottom:2px solid Silver}.figtopbot{border-top:2px solid Silver;border-bottom:2px solid Silver;margin-top:1em}/*! Most link groups are created with <div>. Ensure they have space before and after. */.ullinks,ul.simple{list-style-type:none}.attention,.danger,.ddexpand,.dlexpand,.example,.fastpath,.important,.liexpand,.linklist,.note,.notice,.olchildlink,.relconcepts,.relinfo,.relref,.reltasks,.remember,.restriction,.section,.sliexpand,.stepexpand,.substepexpand,.tip,.ulchildlink,.warning{margin-top:1em;margin-bottom:1em}.linklistwithchild,.sublinklist{margin-top:1em;margin-right:1.5em;margin-bottom:1em}.breadcrumb{font-size:smaller;margin-bottom:1em}.prereq{margin-right:20px}/*! Set heading sizes, getting smaller for deeper nesting */.topictitle1{font-size:1.34em;margin-top:0;margin-bottom:.1em}.topictitle2,.topictitle3,.topictitle4,.topictitle5,.topictitle6,.sectiontitle{font-size:1.17em}.topictitle2{margin-top:1pc;margin-bottom:.45em}.topictitle3{margin-top:1pc;margin-bottom:.17em;font-weight:700}.topictitle4{margin-top:.83em;font-weight:700}.topictitle5{font-weight:700}.topictitle6{font-style:italic}.sectiontitle{margin-top:1em;margin-bottom:0;color:#000;font-weight:700}/*! All note formats have the same default presentation */.attentiontitle,.bold,.cautiontitle,.dangertitle,.dlterm,.fastpathtitle,.firstcol,.importanttitle,.notelisttitle,.notetitle,.noticetitle,.parmname,.remembertitle,.restrictiontitle,.tiptitle,.uicontrol,.warningtitle{font-weight:700}.caution{font-weight:700;margin-bottom:1em}/*! Simple lists do not get a bullet *//*! Used on the first column of a table, when rowheader="firstcol" is used *//*! Various basic phrase styles */.boldItalic{font-weight:700;font-style:italic}.shortcut,.underlined{text-decoration:underline}/*! 2008-10-27 keyword采用跟随上下文的样式
*//*! Default of bold for definition list terms *//*! Use CSS to expand lists with @compact="no" */.dltermexpand{font-weight:700;margin-top:1em}[compact="yes"]>li{margin-top:0}[compact="no"]>li{margin-top:.53em}/*! Align images based on @align on topic/image */div.imageleft,.text-align-left{text-align:left}div.imagecenter,.text-align-center{text-align:center}div.imageright,.text-align-right{text-align:right}div.imagejustify,.text-align-justify{text-align:justify}.cellrowborder{border-right:0;border-top:0;border-left:1px solid;border-bottom:1px solid}.row-nocellborder{border-left:hidden;border-right:0;border-top:0;border-bottom:1px solid}.cell-norowborder{border-top:0;border-bottom:hidden;border-right:0;border-left:1px solid}.nocellnorowborder{border:0;border-left:hidden;border-bottom:hidden}pre.codeblock,pre.screen{padding:5px;border:outset;background-color:#ccc;margin-top:2px;margin-bottom:2px;white-space:pre}

BIN
docs/ecs/dev/public_sys-resources/imageclose.gif
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 155 B

After

Width:  |  Height:  |  Size: 1.2 KiB

BIN
docs/ecs/dev/public_sys-resources/imageclosehover.gif
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 179 B

After

Width:  |  Height:  |  Size: 1.1 KiB

BIN
docs/ecs/dev/public_sys-resources/imagemax.gif
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 181 B

After

Width:  |  Height:  |  Size: 1.2 KiB

BIN
docs/ecs/dev/public_sys-resources/imagemaxhover.gif
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 185 B

After

Width:  |  Height:  |  Size: 1.2 KiB

BIN
docs/ecs/dev/public_sys-resources/macFFBgHack.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 207 B

After

Width:  |  Height:  |  Size: 1014 B