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>
183 lines
18 KiB
HTML
183 lines
18 KiB
HTML
<a name="dcs-api-0312007"></a><a name="dcs-api-0312007"></a>
|
|
|
|
<h1 class="topictitle1">Modifying Information About a DCS Instance</h1>
|
|
<div id="body59271898"><div class="section" id="dcs-api-0312007__en-us_topic_0166889612_section1160237530"><h4 class="sectiontitle">Function</h4><p id="dcs-api-0312007__en-us_topic_0166889612_p78721842259">This API is used to modify the information about a DCS instance, including the instance name, description, backup policy, start and end time of the maintenance window, and security group.</p>
|
|
</div>
|
|
<div class="section" id="dcs-api-0312007__en-us_topic_0166889612_section1280994914394"><h4 class="sectiontitle">URI</h4><p class="msonormal" id="dcs-api-0312007__en-us_topic_0166889612_p12700155514318">PUT /v1.0/{project_id}/instances/{instance_id}</p>
|
|
<div class="p" id="dcs-api-0312007__en-us_topic_0166889612_p8911185533420"><a href="#dcs-api-0312007__en-us_topic_0166889612_table938420556341">Table 1</a> describes the parameters.
|
|
<div class="tablenoborder"><a name="dcs-api-0312007__en-us_topic_0166889612_table938420556341"></a><a name="en-us_topic_0166889612_table938420556341"></a><table cellpadding="4" cellspacing="0" summary="" id="dcs-api-0312007__en-us_topic_0166889612_table938420556341" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="dcs-api-0312007__en-us_topic_0166889612_row173849558349"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.2.3.2.2.5.1.1"><p id="dcs-api-0312007__en-us_topic_0166889612_p33841155103412">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.2.3.2.2.5.1.2"><p id="dcs-api-0312007__en-us_topic_0166889612_p193842555348">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.2.3.2.2.5.1.3"><p id="dcs-api-0312007__en-us_topic_0166889612_p63841255173414">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.2.3.2.2.5.1.4"><p id="dcs-api-0312007__en-us_topic_0166889612_p63841255193412">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dcs-api-0312007__en-us_topic_0166889612_row1038418553349"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.3.2.2.5.1.1 "><p id="dcs-api-0312007__en-us_topic_0166889612_p93841755143410">project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.3.2.2.5.1.2 "><p id="dcs-api-0312007__en-us_topic_0166889612_p93841855183415">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.3.2.2.5.1.3 "><p id="dcs-api-0312007__en-us_topic_0166889612_p3384155518344">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.3.2.2.5.1.4 "><p id="dcs-api-0312007__en-us_topic_0166889612_p173841855123420">Project ID. For details on how to obtain the value of this parameter, see <a href="dcs-api-0312045.html">Obtaining a Project ID</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312007__en-us_topic_0166889612_row163841755113413"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.3.2.2.5.1.1 "><p id="dcs-api-0312007__en-us_topic_0166889612_p53841255193410">instance_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.3.2.2.5.1.2 "><p id="dcs-api-0312007__en-us_topic_0166889612_p538414550343">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.3.2.2.5.1.3 "><p id="dcs-api-0312007__en-us_topic_0166889612_p1384165517346">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.3.2.2.5.1.4 "><p id="dcs-api-0312007__en-us_topic_0166889612_p0384455123420">DCS instance ID.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="dcs-api-0312007__en-us_topic_0166889612_section143751710194016"><h4 class="sectiontitle">Request</h4><p id="dcs-api-0312007__en-us_topic_0166889612_p5654105481017"><strong id="dcs-api-0312007__en-us_topic_0166889612_b619316506172">Request parameters</strong></p>
|
|
<div class="p" id="dcs-api-0312007__en-us_topic_0166889612_p1046523193511"><a href="#dcs-api-0312007__en-us_topic_0166889612_table785213273513">Table 2</a> describes the request parameters.
|
|
<div class="tablenoborder"><a name="dcs-api-0312007__en-us_topic_0166889612_table785213273513"></a><a name="en-us_topic_0166889612_table785213273513"></a><table cellpadding="4" cellspacing="0" summary="" id="dcs-api-0312007__en-us_topic_0166889612_table785213273513" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Parameter description</caption><thead align="left"><tr id="dcs-api-0312007__en-us_topic_0166889612_row1585116223517"><th align="left" class="cellrowborder" valign="top" width="23%" id="mcps1.3.3.3.2.2.5.1.1"><p id="dcs-api-0312007__en-us_topic_0166889612_p88511827356">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.3.3.2.2.5.1.2"><p id="dcs-api-0312007__en-us_topic_0166889612_p58515253512">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="9%" id="mcps1.3.3.3.2.2.5.1.3"><p id="dcs-api-0312007__en-us_topic_0166889612_p1485112193510">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="53%" id="mcps1.3.3.3.2.2.5.1.4"><p id="dcs-api-0312007__en-us_topic_0166889612_p10851925356">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dcs-api-0312007__en-us_topic_0166889612_row1085112273514"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.3.2.2.5.1.1 "><p id="dcs-api-0312007__en-us_topic_0166889612_p1885119243518">name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.3.2.2.5.1.2 "><p id="dcs-api-0312007__en-us_topic_0166889612_p10851112143519">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="9%" headers="mcps1.3.3.3.2.2.5.1.3 "><p id="dcs-api-0312007__en-us_topic_0166889612_p385117263516">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53%" headers="mcps1.3.3.3.2.2.5.1.4 "><p id="dcs-api-0312007__en-us_topic_0166889612_p15851172133513">DCS instance name.</p>
|
|
<p id="dcs-api-0312007__en-us_topic_0166889612_p5676152019920">An instance name can contain 4 to 64 characters, including letters, digits, underscores (_), and hyphens (-), and must start with a letter.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312007__en-us_topic_0166889612_row198523215355"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.3.2.2.5.1.1 "><p id="dcs-api-0312007__en-us_topic_0166889612_p1685115211359">description</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.3.2.2.5.1.2 "><p id="dcs-api-0312007__en-us_topic_0166889612_p1585216293512">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="9%" headers="mcps1.3.3.3.2.2.5.1.3 "><p id="dcs-api-0312007__en-us_topic_0166889612_p148521528356">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53%" headers="mcps1.3.3.3.2.2.5.1.4 "><p id="dcs-api-0312007__en-us_topic_0166889612_p1852124352">Brief description of the DCS instance.</p>
|
|
<p id="dcs-api-0312007__en-us_topic_0166889612_p1782063116014">A brief description supports up to 1024 characters.</p>
|
|
<div class="note" id="dcs-api-0312007__en-us_topic_0166889612_note450874595312"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="dcs-api-0312007__en-us_topic_0166889612_p155091445135316">"\" is defined as an escape character in the queue description. If you need to enter a backward slash (\) or a double quotation mark (") in the queue description, enter <strong id="dcs-api-0312007__en-us_topic_0166889612_b12224005144110">\\</strong> or <strong id="dcs-api-0312007__en-us_topic_0166889612_b5675418144110">\"</strong>.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312007__en-us_topic_0166889612_row27821175915"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.3.2.2.5.1.1 "><p id="dcs-api-0312007__en-us_topic_0166889612_p14303144614">instance_backup_policy</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.3.2.2.5.1.2 "><p id="dcs-api-0312007__en-us_topic_0166889612_p183031446120">Object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="9%" headers="mcps1.3.3.3.2.2.5.1.3 "><p id="dcs-api-0312007__en-us_topic_0166889612_p93031141411">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53%" headers="mcps1.3.3.3.2.2.5.1.4 "><p id="dcs-api-0312007__en-us_topic_0166889612_p10047281144121">Backup policy.</p>
|
|
<p id="dcs-api-0312007__en-us_topic_0166889612_p355912469149">This parameter is available for master/standby and cluster DCS instances. For details, see <a href="dcs-api-0312004.html#dcs-api-0312004__en-us_topic_0166889598_table12803218151513">Table 3</a> and <a href="dcs-api-0312004.html#dcs-api-0312004__en-us_topic_0166889598_table187492037201518">Table 4</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312007__en-us_topic_0166889612_row10563194525819"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.3.2.2.5.1.1 "><p id="dcs-api-0312007__en-us_topic_0166889612_p1339311593585">maintain_begin</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.3.2.2.5.1.2 "><p id="dcs-api-0312007__en-us_topic_0166889612_p1839355913585">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="9%" headers="mcps1.3.3.3.2.2.5.1.3 "><p id="dcs-api-0312007__en-us_topic_0166889612_p13393115916580">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53%" headers="mcps1.3.3.3.2.2.5.1.4 "><p id="dcs-api-0312007__en-us_topic_0166889612_p1058769144129">Time at which the maintenance time window starts.</p>
|
|
<p id="dcs-api-0312007__en-us_topic_0166889612_p19394125913588">Format: hh:mm:ss.</p>
|
|
<ul id="dcs-api-0312007__en-us_topic_0166889612_ul1039485925815"><li id="dcs-api-0312007__en-us_topic_0166889612_li0394125917583">The start time and end time of the maintenance time window must indicate the time segment of a supported maintenance time window. For details on how to query the time segments of supported maintenance time windows, see <a href="dcs-api-0312041.html#dcs-api-0312041">Querying Maintenance Time Window</a>.</li><li id="dcs-api-0312007__en-us_topic_0166889612_li961613298283">The start time must be set to 22:00:00, 02:00:00, 06:00:00, 10:00:00, 14:00:00, or 18:00: 00.</li><li id="dcs-api-0312007__en-us_topic_0166889612_li1529203802813">Parameters <strong id="dcs-api-0312007__en-us_topic_0166889612_b56748219194258">maintain_begin</strong> and <strong id="dcs-api-0312007__en-us_topic_0166889612_b40971925194258">maintain_end</strong> must be set in pairs. If parameter <strong id="dcs-api-0312007__en-us_topic_0166889612_b587561699143218">maintain_begin</strong> is left blank, parameter <strong id="dcs-api-0312007__en-us_topic_0166889612_b786701452143218">maintain_end</strong> is also blank.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312007__en-us_topic_0166889612_row311274695815"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.3.2.2.5.1.1 "><p id="dcs-api-0312007__en-us_topic_0166889612_p139425905813">maintain_end</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.3.2.2.5.1.2 "><p id="dcs-api-0312007__en-us_topic_0166889612_p12394195917585">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="9%" headers="mcps1.3.3.3.2.2.5.1.3 "><p id="dcs-api-0312007__en-us_topic_0166889612_p123941059105813">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53%" headers="mcps1.3.3.3.2.2.5.1.4 "><p id="dcs-api-0312007__en-us_topic_0166889612_p58934172144144">Time at which the maintenance time window ends.</p>
|
|
<p id="dcs-api-0312007__en-us_topic_0166889612_p10394205975819">Format: hh:mm:ss.</p>
|
|
<ul id="dcs-api-0312007__en-us_topic_0166889612_ul93951259155810"><li id="dcs-api-0312007__en-us_topic_0166889612_li83951959155810">The start time and end time of the maintenance time window must indicate the time segment of a supported maintenance time window. For details on how to query the time segments of supported maintenance time windows, see <a href="dcs-api-0312041.html#dcs-api-0312041">Querying Maintenance Time Window</a>.</li></ul>
|
|
<ul id="dcs-api-0312007__en-us_topic_0166889612_ul183951559135818"><li id="dcs-api-0312007__en-us_topic_0166889612_li32324820288">The end time is four hours later than the start time. For example, if the start time is 22:00:00, the end time is 02:00:00.</li><li id="dcs-api-0312007__en-us_topic_0166889612_li712320528287">Parameters <strong id="dcs-api-0312007__en-us_topic_0166889612_b52982079194536">maintain_begin</strong> and <strong id="dcs-api-0312007__en-us_topic_0166889612_b24090421194540">maintain_end</strong> must be set in pairs. If parameter <strong id="dcs-api-0312007__en-us_topic_0166889612_b1274439765143241">maintain_end</strong> is left blank, parameter <strong id="dcs-api-0312007__en-us_topic_0166889612_b2016295787143241">maintain_start</strong> is also blank.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312007__en-us_topic_0166889612_row1281151472916"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.3.2.2.5.1.1 "><p id="dcs-api-0312007__en-us_topic_0166889612_p5971325112912">security_group_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.3.2.2.5.1.2 "><p id="dcs-api-0312007__en-us_topic_0166889612_p49711125112910">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="9%" headers="mcps1.3.3.3.2.2.5.1.3 "><p id="dcs-api-0312007__en-us_topic_0166889612_p19710250295">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53%" headers="mcps1.3.3.3.2.2.5.1.4 "><p id="dcs-api-0312007__en-us_topic_0166889612_p797132511297">Security group ID.</p>
|
|
<p id="dcs-api-0312007__en-us_topic_0166889612_p7952614184115">The value can be obtained from the VPC console or the API.</p>
|
|
<p id="dcs-api-0312007__en-us_topic_0166889612_p16561144364118">This parameter is supported only by DCS Redis 3.0 instances.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<p id="dcs-api-0312007__en-us_topic_0166889612_p1773752020114"><strong id="dcs-api-0312007__en-us_topic_0166889612_b969112612184">Example request</strong></p>
|
|
<p id="dcs-api-0312007__en-us_topic_0166889612_p155721268514">Request URL:</p>
|
|
<pre class="screen" id="dcs-api-0312007__en-us_topic_0166889612_screen777212214167">PUT https://{dcs_endpoint}/v1.0/{project_id}/instances/{instance_id}</pre>
|
|
<ul id="dcs-api-0312007__en-us_topic_0166889612_ul541717808"><li id="dcs-api-0312007__en-us_topic_0166889612_li16451713010">Example 1<pre class="screen" id="dcs-api-0312007__en-us_topic_0166889612_screen1455014391019">{
|
|
"description": "instance description"
|
|
}</pre>
|
|
</li><li id="dcs-api-0312007__en-us_topic_0166889612_li165941420300">Example 2<pre class="screen" id="dcs-api-0312007__en-us_topic_0166889612_screen159414201403">{
|
|
"name": "dcs002",
|
|
"description": "instance description",
|
|
"instance_backup_policy": {
|
|
"backup_type": "auto",
|
|
"save_days": 1,
|
|
"periodical_backup_plan": {
|
|
"begin_at": "00:00-01:00",
|
|
"period_type": "weekly",
|
|
"backup_at": [
|
|
"1",
|
|
"2",
|
|
"3",
|
|
"4",
|
|
"6",
|
|
"7"
|
|
]
|
|
}
|
|
},
|
|
"security_group_id": "18e9309f-f81a-4749-bb21-f74576292162",
|
|
"maintain_begin": "02:00:00",
|
|
"maintain_end": "06:00:00"
|
|
}</pre>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dcs-api-0312007__en-us_topic_0166889612_section1971312572428"><h4 class="sectiontitle">Response</h4><p class="msonormal" id="dcs-api-0312007__en-us_topic_0166889612_p11892839181412"><strong id="dcs-api-0312007__en-us_topic_0166889612_b15912745171813">Response parameters</strong></p>
|
|
<p id="dcs-api-0312007__en-us_topic_0166889612_p189001324041">None</p>
|
|
<p id="dcs-api-0312007__en-us_topic_0166889612_p8592144131417"><strong id="dcs-api-0312007__en-us_topic_0166889612_b09483219331">Example response</strong></p>
|
|
<p id="dcs-api-0312007__en-us_topic_0166889612_p790019241847">None</p>
|
|
</div>
|
|
<div class="section" id="dcs-api-0312007__en-us_topic_0166889612_section1375913561211"><h4 class="sectiontitle">Status Code</h4><p id="dcs-api-0312007__en-us_topic_0166889612_p147591511122"><a href="#dcs-api-0312007__en-us_topic_0166889612_table1475915181216">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-0312007__en-us_topic_0166889612_table1475915181216"></a><a name="en-us_topic_0166889612_table1475915181216"></a><table cellpadding="4" cellspacing="0" summary="" id="dcs-api-0312007__en-us_topic_0166889612_table1475915181216" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Status code</caption><thead align="left"><tr id="dcs-api-0312007__en-us_topic_0166889612_row97607581218"><th align="left" class="cellrowborder" valign="top" width="15.98%" id="mcps1.3.5.3.2.3.1.1"><p id="dcs-api-0312007__en-us_topic_0166889612_p1676020511123">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-0312007__en-us_topic_0166889612_p18760351121">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dcs-api-0312007__en-us_topic_0166889612_row177611155124"><td class="cellrowborder" valign="top" width="15.98%" headers="mcps1.3.5.3.2.3.1.1 "><p id="dcs-api-0312007__en-us_topic_0166889612_p37612517124">204</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="84.02%" headers="mcps1.3.5.3.2.3.1.2 "><p id="dcs-api-0312007__en-us_topic_0166889612_p776112513121">DCS instance modified successfully.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="dcs-api-0312003.html">Lifecycle Management APIs</a></div>
|
|
</div>
|
|
</div>
|
|
|