forked from docs/doc-exports
Chen, Junjie
a03981f7be
Reviewed-by: Bobkova, Natalia <natalia.bobkova@t-systems.com> Co-authored-by: Chen, Junjie <chenjunjie@huawei.com> Co-committed-by: Chen, Junjie <chenjunjie@huawei.com>
141 lines
11 KiB
HTML
141 lines
11 KiB
HTML
<a name="dcs-api-0312039"></a><a name="dcs-api-0312039"></a>
|
|
|
|
<h1 class="topictitle1">Querying AZ Information</h1>
|
|
<div id="body32903664"><div class="section" id="dcs-api-0312039__en-us_topic_0166889630_section164151825713"><h4 class="sectiontitle">Function</h4><p id="dcs-api-0312039__en-us_topic_0166889630_p1650115456387">This API is used to query the ID of the AZ where a DCS instance resides. </p>
|
|
</div>
|
|
<div class="section" id="dcs-api-0312039__en-us_topic_0166889630_section11589173274"><h4 class="sectiontitle">URI</h4><p id="dcs-api-0312039__en-us_topic_0166889630_p84991845164614">GET /v1.0/availableZones</p>
|
|
</div>
|
|
<div class="section" id="dcs-api-0312039__en-us_topic_0166889630_section1271822314281"><h4 class="sectiontitle">Request</h4><p id="dcs-api-0312039__en-us_topic_0166889630_p1427094363120"><strong id="dcs-api-0312039__en-us_topic_0166889630_b362193885513">Request parameters</strong></p>
|
|
<p id="dcs-api-0312039__en-us_topic_0166889630_p162708434311">None</p>
|
|
<p id="dcs-api-0312039__en-us_topic_0166889630_p1427094312316"><strong id="dcs-api-0312039__en-us_topic_0166889630_b2022574118554">Example request</strong></p>
|
|
<p id="dcs-api-0312039__en-us_topic_0166889630_p4270104310312">None</p>
|
|
</div>
|
|
<div class="section" id="dcs-api-0312039__en-us_topic_0166889630_section1745154162813"><h4 class="sectiontitle">Response</h4><p class="msonormal" id="dcs-api-0312039__en-us_topic_0166889630_p62811757144610"><strong id="dcs-api-0312039__en-us_topic_0166889630_b18111174675518">Response parameters</strong></p>
|
|
<div class="msonormal" id="dcs-api-0312039__en-us_topic_0166889630_p12163175373917"><a href="#dcs-api-0312039__en-us_topic_0166889630_table5725353918">Table 1</a> describes the response parameters.
|
|
<div class="tablenoborder"><a name="dcs-api-0312039__en-us_topic_0166889630_table5725353918"></a><a name="en-us_topic_0166889630_table5725353918"></a><table cellpadding="4" cellspacing="0" summary="" id="dcs-api-0312039__en-us_topic_0166889630_table5725353918" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="dcs-api-0312039__en-us_topic_0166889630_row1862534399"><th align="left" class="cellrowborder" valign="top" width="20.41%" id="mcps1.3.4.3.2.2.4.1.1"><p id="dcs-api-0312039__en-us_topic_0166889630_p2615536391">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="24.490000000000002%" id="mcps1.3.4.3.2.2.4.1.2"><p id="dcs-api-0312039__en-us_topic_0166889630_p86453163917">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="55.1%" id="mcps1.3.4.3.2.2.4.1.3"><p id="dcs-api-0312039__en-us_topic_0166889630_p196135383919">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dcs-api-0312039__en-us_topic_0166889630_row137195353920"><td class="cellrowborder" valign="top" width="20.41%" headers="mcps1.3.4.3.2.2.4.1.1 "><p id="dcs-api-0312039__en-us_topic_0166889630_p126953173914">region_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="24.490000000000002%" headers="mcps1.3.4.3.2.2.4.1.2 "><p id="dcs-api-0312039__en-us_topic_0166889630_p197135314392">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.1%" headers="mcps1.3.4.3.2.2.4.1.3 "><p id="dcs-api-0312039__en-us_topic_0166889630_p18755363917">Region ID.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312039__en-us_topic_0166889630_row075534392"><td class="cellrowborder" valign="top" width="20.41%" headers="mcps1.3.4.3.2.2.4.1.1 "><p id="dcs-api-0312039__en-us_topic_0166889630_p6715311397">available_zones</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="24.490000000000002%" headers="mcps1.3.4.3.2.2.4.1.2 "><p id="dcs-api-0312039__en-us_topic_0166889630_p7755373913">Array</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.1%" headers="mcps1.3.4.3.2.2.4.1.3 "><p id="dcs-api-0312039__en-us_topic_0166889630_p3775313395">Array of AZs. For details, see <a href="#dcs-api-0312039__en-us_topic_0166889630_table20901104905614">Table 2</a>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="dcs-api-0312039__en-us_topic_0166889630_table20901104905614"></a><a name="en-us_topic_0166889630_table20901104905614"></a><table cellpadding="4" cellspacing="0" summary="" id="dcs-api-0312039__en-us_topic_0166889630_table20901104905614" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Parameter description of the available_zones array</caption><thead align="left"><tr id="dcs-api-0312039__en-us_topic_0166889630_row12901249155618"><th align="left" class="cellrowborder" valign="top" width="21.21212121212121%" id="mcps1.3.4.4.2.4.1.1"><p id="dcs-api-0312039__en-us_topic_0166889630_p6686654192615">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20.202020202020204%" id="mcps1.3.4.4.2.4.1.2"><p id="dcs-api-0312039__en-us_topic_0166889630_p129029492566">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="58.58585858585859%" id="mcps1.3.4.4.2.4.1.3"><p id="dcs-api-0312039__en-us_topic_0166889630_p690217494561">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dcs-api-0312039__en-us_topic_0166889630_row139022491568"><td class="cellrowborder" valign="top" width="21.21212121212121%" headers="mcps1.3.4.4.2.4.1.1 "><p id="dcs-api-0312039__en-us_topic_0166889630_p1290214497560">id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.4.4.2.4.1.2 "><p id="dcs-api-0312039__en-us_topic_0166889630_p29021492564">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.4.4.2.4.1.3 "><p id="dcs-api-0312039__en-us_topic_0166889630_p1990217498567">AZ ID.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312039__en-us_topic_0166889630_row490216496566"><td class="cellrowborder" valign="top" width="21.21212121212121%" headers="mcps1.3.4.4.2.4.1.1 "><p id="dcs-api-0312039__en-us_topic_0166889630_p2902164995619">code</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.4.4.2.4.1.2 "><p id="dcs-api-0312039__en-us_topic_0166889630_p1902124917569">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.4.4.2.4.1.3 "><p id="dcs-api-0312039__en-us_topic_0166889630_p1490212498563">AZ code.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312039__en-us_topic_0166889630_row119023498565"><td class="cellrowborder" valign="top" width="21.21212121212121%" headers="mcps1.3.4.4.2.4.1.1 "><p id="dcs-api-0312039__en-us_topic_0166889630_p15902649165614">name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.4.4.2.4.1.2 "><p id="dcs-api-0312039__en-us_topic_0166889630_p119022492561">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.4.4.2.4.1.3 "><p id="dcs-api-0312039__en-us_topic_0166889630_p2902204935616">AZ name.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312039__en-us_topic_0166889630_row890204912564"><td class="cellrowborder" valign="top" width="21.21212121212121%" headers="mcps1.3.4.4.2.4.1.1 "><p id="dcs-api-0312039__en-us_topic_0166889630_p79021549175610">port</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.4.4.2.4.1.2 "><p id="dcs-api-0312039__en-us_topic_0166889630_p10902949165614">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.4.4.2.4.1.3 "><p id="dcs-api-0312039__en-us_topic_0166889630_p17902154925615">Port number of the AZ.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312039__en-us_topic_0166889630_row1285718223542"><td class="cellrowborder" valign="top" width="21.21212121212121%" headers="mcps1.3.4.4.2.4.1.1 "><p id="dcs-api-0312039__en-us_topic_0166889630_p28591422145411">resource_availability</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.4.4.2.4.1.2 "><p id="dcs-api-0312039__en-us_topic_0166889630_p11859172215541">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.4.4.2.4.1.3 "><p id="dcs-api-0312039__en-us_topic_0166889630_p1219863831719">An indicator of whether there are available resources in the AZ.</p>
|
|
<ul id="dcs-api-0312039__en-us_topic_0166889630_ul17198113812171"><li id="dcs-api-0312039__en-us_topic_0166889630_li1199038191712"><strong id="dcs-api-0312039__en-us_topic_0166889630_b137424216583">true</strong>: There are available resources in the AZ.</li><li id="dcs-api-0312039__en-us_topic_0166889630_li1419973811712"><strong id="dcs-api-0312039__en-us_topic_0166889630_b87404251917">false</strong>: There are no available resources in the AZ.</li></ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p class="msonormal" id="dcs-api-0312039__en-us_topic_0166889630_p1580971064719"><strong id="dcs-api-0312039__en-us_topic_0166889630_b1590619335612">Example response</strong></p>
|
|
</div>
|
|
<pre class="screen" id="dcs-api-0312039__en-us_topic_0166889630_screen029758144218">{
|
|
"regionId": "XXXXXX",
|
|
"available_zones": [
|
|
{
|
|
"id": "f84448fd537f46078dd8bd776747f573",
|
|
"code": "XXXXXX",
|
|
"name": "XXXXXX",
|
|
"port": "8003",
|
|
"resource_availability": "true"
|
|
},
|
|
{
|
|
"id": "12c47a78666b4e438cd0c692b9860387",
|
|
"code": "XXXXXX",
|
|
"name": "XXXXXX",
|
|
"port": "8002",
|
|
"resource_availability": "true"
|
|
},
|
|
{
|
|
"id": "0725858e0d26434f9aa3dc5fc40d5697",
|
|
"code": "XXXXXX",
|
|
"name": "XXXXXX",
|
|
"port": "8009",
|
|
"resource_availability": "true"
|
|
}
|
|
]
|
|
} </pre>
|
|
<div class="section" id="dcs-api-0312039__en-us_topic_0166889630_section9114171291417"><h4 class="sectiontitle">Status Code</h4><p id="dcs-api-0312039__en-us_topic_0166889630_p611571212145"><a href="#dcs-api-0312039__en-us_topic_0166889630_table201151124142">Table 3</a> describes the status code of successful operations. For details about other status codes, see <a href="dcs-api-0312043.html#dcs-api-0312043__table5210141351517">Table 1</a>.</p>
|
|
|
|
<div class="tablenoborder"><a name="dcs-api-0312039__en-us_topic_0166889630_table201151124142"></a><a name="en-us_topic_0166889630_table201151124142"></a><table cellpadding="4" cellspacing="0" summary="" id="dcs-api-0312039__en-us_topic_0166889630_table201151124142" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Status code</caption><thead align="left"><tr id="dcs-api-0312039__en-us_topic_0166889630_row61151912141410"><th align="left" class="cellrowborder" valign="top" width="15.98%" id="mcps1.3.6.3.2.3.1.1"><p id="dcs-api-0312039__en-us_topic_0166889630_p18115512151411">Status Code</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="84.02%" id="mcps1.3.6.3.2.3.1.2"><p id="dcs-api-0312039__en-us_topic_0166889630_p41151712151419">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dcs-api-0312039__en-us_topic_0166889630_row811551251417"><td class="cellrowborder" valign="top" width="15.98%" headers="mcps1.3.6.3.2.3.1.1 "><p id="dcs-api-0312039__en-us_topic_0166889630_p17115201211417">200</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="84.02%" headers="mcps1.3.6.3.2.3.1.2 "><p id="dcs-api-0312039__en-us_topic_0166889630_p16116151214148">AZ information queried successfully.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="dcs-api-0312038.html">Other APIs</a></div>
|
|
</div>
|
|
</div>
|
|
|