forked from docs/doc-exports
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>
140 lines
9.5 KiB
HTML
140 lines
9.5 KiB
HTML
<a name="dcs-api-0312041"></a><a name="dcs-api-0312041"></a>
|
|
|
|
<h1 class="topictitle1">Querying Maintenance Time Window</h1>
|
|
<div id="body1500977331238"><div class="section" id="dcs-api-0312041__en-us_topic_0166889588_section51971645131316"><h4 class="sectiontitle">Function</h4><p id="dcs-api-0312041__en-us_topic_0166889588_p7202629141518">The API is used to query the start time and end time of the maintenance time window.</p>
|
|
</div>
|
|
<div class="section" id="dcs-api-0312041__en-us_topic_0166889588_section64622449235"><h4 class="sectiontitle">URI</h4><p id="dcs-api-0312041__en-us_topic_0166889588_p152611543234">GET /v1.0/instances/maintain-windows</p>
|
|
</div>
|
|
<div class="section" id="dcs-api-0312041__en-us_topic_0166889588_section240851911242"><h4 class="sectiontitle">Request</h4><p id="dcs-api-0312041__en-us_topic_0166889588_p19977113213118"><strong id="dcs-api-0312041__en-us_topic_0166889588_b1478312171918">Request parameters</strong></p>
|
|
<p id="dcs-api-0312041__en-us_topic_0166889588_p2977132153115">None</p>
|
|
<p id="dcs-api-0312041__en-us_topic_0166889588_p1497703210316"><strong id="dcs-api-0312041__en-us_topic_0166889588_b1158110418195">Example request</strong></p>
|
|
<p id="dcs-api-0312041__en-us_topic_0166889588_p097723273112">None</p>
|
|
</div>
|
|
<div class="section" id="dcs-api-0312041__en-us_topic_0166889588_section17914193911241"><h4 class="sectiontitle">Response</h4><p class="msonormal" id="dcs-api-0312041__en-us_topic_0166889588_p518895813455"><strong id="dcs-api-0312041__en-us_topic_0166889588_b147314719197">Response parameters</strong></p>
|
|
<div class="msonormal" id="dcs-api-0312041__en-us_topic_0166889588_p113341445183919"><a href="#dcs-api-0312041__en-us_topic_0166889588_table615617458391">Table 1</a> describes the response parameters.
|
|
<div class="tablenoborder"><a name="dcs-api-0312041__en-us_topic_0166889588_table615617458391"></a><a name="en-us_topic_0166889588_table615617458391"></a><table cellpadding="4" cellspacing="0" summary="" id="dcs-api-0312041__en-us_topic_0166889588_table615617458391" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="dcs-api-0312041__en-us_topic_0166889588_row1215694553917"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.4.3.2.2.4.1.1"><p id="dcs-api-0312041__en-us_topic_0166889588_p1115617457395">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="28.999999999999996%" id="mcps1.3.4.3.2.2.4.1.2"><p id="dcs-api-0312041__en-us_topic_0166889588_p11561345123918">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="56.00000000000001%" id="mcps1.3.4.3.2.2.4.1.3"><p id="dcs-api-0312041__en-us_topic_0166889588_p6156194512396">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dcs-api-0312041__en-us_topic_0166889588_row415615459392"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.4.3.2.2.4.1.1 "><p id="dcs-api-0312041__en-us_topic_0166889588_p471315247">maintain_windows</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="28.999999999999996%" headers="mcps1.3.4.3.2.2.4.1.2 "><p id="dcs-api-0312041__en-us_topic_0166889588_p172015145">Array</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.00000000000001%" headers="mcps1.3.4.3.2.2.4.1.3 "><p id="dcs-api-0312041__en-us_topic_0166889588_p171115441">List of supported maintenance time windows.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dcs-api-0312041__en-us_topic_0166889588_table910362216139" frame="border" border="1" rules="all"><caption><b>Table 2 </b>maintain_windows parameter description</caption><thead align="left"><tr id="dcs-api-0312041__en-us_topic_0166889588_row16103322121317"><th align="left" class="cellrowborder" valign="top" width="32%" id="mcps1.3.4.4.2.4.1.1"><p id="dcs-api-0312041__en-us_topic_0166889588_p10104022111310">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.4.4.2.4.1.2"><p id="dcs-api-0312041__en-us_topic_0166889588_p161041122171313">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="53%" id="mcps1.3.4.4.2.4.1.3"><p id="dcs-api-0312041__en-us_topic_0166889588_p4104722171313">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dcs-api-0312041__en-us_topic_0166889588_row151043224130"><td class="cellrowborder" valign="top" width="32%" headers="mcps1.3.4.4.2.4.1.1 "><p id="dcs-api-0312041__en-us_topic_0166889588_p1259242341">seq</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.4.4.2.4.1.2 "><p id="dcs-api-0312041__en-us_topic_0166889588_p159042743">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53%" headers="mcps1.3.4.4.2.4.1.3 "><p id="dcs-api-0312041__en-us_topic_0166889588_p659194219418">Sequence number of the maintenance time window.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312041__en-us_topic_0166889588_row81044225134"><td class="cellrowborder" valign="top" width="32%" headers="mcps1.3.4.4.2.4.1.1 "><p id="dcs-api-0312041__en-us_topic_0166889588_p8599427416">begin</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.4.4.2.4.1.2 "><p id="dcs-api-0312041__en-us_topic_0166889588_p165974212414">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53%" headers="mcps1.3.4.4.2.4.1.3 "><p id="dcs-api-0312041__en-us_topic_0166889588_p15917421341">Start time of the maintenance time window.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312041__en-us_topic_0166889588_row81049226139"><td class="cellrowborder" valign="top" width="32%" headers="mcps1.3.4.4.2.4.1.1 "><p id="dcs-api-0312041__en-us_topic_0166889588_p45917421844">end</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.4.4.2.4.1.2 "><p id="dcs-api-0312041__en-us_topic_0166889588_p659042541">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53%" headers="mcps1.3.4.4.2.4.1.3 "><p id="dcs-api-0312041__en-us_topic_0166889588_p175919421044">End time of the maintenance time window.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312041__en-us_topic_0166889588_row7105132241314"><td class="cellrowborder" valign="top" width="32%" headers="mcps1.3.4.4.2.4.1.1 "><p id="dcs-api-0312041__en-us_topic_0166889588_p959842643">default</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.4.4.2.4.1.2 "><p id="dcs-api-0312041__en-us_topic_0166889588_p85984210414">Boolean</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53%" headers="mcps1.3.4.4.2.4.1.3 "><p id="dcs-api-0312041__en-us_topic_0166889588_p65910421645">An indicator of whether the maintenance time window is set to the default time segment.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<div class="p" id="dcs-api-0312041__en-us_topic_0166889588_p9126512164618"><strong id="dcs-api-0312041__en-us_topic_0166889588_b1970665901915">Example response</strong><pre class="screen" id="dcs-api-0312041__en-us_topic_0166889588_screen117211519164620">{
|
|
"maintain_windows": [
|
|
{
|
|
"seq": 1,
|
|
"begin": "22",
|
|
"end": "02",
|
|
"default": false
|
|
},
|
|
{
|
|
"seq": 2,
|
|
"begin": "02",
|
|
"end": "06",
|
|
"default": true
|
|
},
|
|
{
|
|
"seq": 3,
|
|
"begin": "06",
|
|
"end": "10",
|
|
"default": false
|
|
},
|
|
{
|
|
"seq": 4,
|
|
"begin": "10",
|
|
"end": "14",
|
|
"default": false
|
|
},
|
|
{
|
|
"seq": 5,
|
|
"begin": "14",
|
|
"end": "18",
|
|
"default": false
|
|
},
|
|
{
|
|
"seq": 6,
|
|
"begin": "18",
|
|
"end": "22",
|
|
"default": false
|
|
}
|
|
]
|
|
}</pre>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="dcs-api-0312041__en-us_topic_0166889588_section15118192111410"><h4 class="sectiontitle">Status Code</h4><p id="dcs-api-0312041__en-us_topic_0166889588_p1011872101415"><a href="#dcs-api-0312041__en-us_topic_0166889588_table611872191420">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-0312041__en-us_topic_0166889588_table611872191420"></a><a name="en-us_topic_0166889588_table611872191420"></a><table cellpadding="4" cellspacing="0" summary="" id="dcs-api-0312041__en-us_topic_0166889588_table611872191420" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Status code</caption><thead align="left"><tr id="dcs-api-0312041__en-us_topic_0166889588_row1411932101418"><th align="left" class="cellrowborder" valign="top" width="15.98%" id="mcps1.3.5.3.2.3.1.1"><p id="dcs-api-0312041__en-us_topic_0166889588_p81194271410">Status Code</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="84.02%" id="mcps1.3.5.3.2.3.1.2"><p id="dcs-api-0312041__en-us_topic_0166889588_p91199217144">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dcs-api-0312041__en-us_topic_0166889588_row1011932151411"><td class="cellrowborder" valign="top" width="15.98%" headers="mcps1.3.5.3.2.3.1.1 "><p id="dcs-api-0312041__en-us_topic_0166889588_p21194210147">200</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="84.02%" headers="mcps1.3.5.3.2.3.1.2 "><p id="dcs-api-0312041__en-us_topic_0166889588_p10119626142">Successfully queried the maintenance time window.</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>
|
|
|