forked from docs/doc-exports
Ru, Li Yi
9457035d64
Reviewed-by: Boka, Ladislav <ladislav.boka@t-systems.com> Co-authored-by: Ru, Li Yi <liyiru7@huawei.com> Co-committed-by: Ru, Li Yi <liyiru7@huawei.com>
136 lines
12 KiB
HTML
136 lines
12 KiB
HTML
<a name="rds_01_0102"></a><a name="rds_01_0102"></a>
|
|
|
|
<h1 class="topictitle1">Scaling Up Storage Space of a DB Instance</h1>
|
|
<div id="body1548399097866"><div class="section" id="rds_01_0102__section150205102514"><h4 class="sectiontitle">Function</h4><p id="rds_01_0102__p58741223125210">This API is used to scale up storage space of a DB instance.</p>
|
|
<ul id="rds_01_0102__ul12259155218373"><li id="rds_01_0102__en-us_topic_0240111818_li836513175363">Before calling an API, you need to understand the API in <a href="rds_03_0001.html">Authentication</a>.</li><li id="rds_01_0102__en-us_topic_0240111818_li1991981933613">Before calling this API, obtain the required <a href="https://docs.otc.t-systems.com/en-us/endpoint/index.html" target="_blank" rel="noopener noreferrer">region and endpoint</a>.</li></ul>
|
|
</div>
|
|
<div class="section" id="rds_01_0102__section1213231413285"><h4 class="sectiontitle">Constraints</h4><ul id="rds_01_0102__ul116721736162812"><li id="rds_01_0102__li8672153662819">The sizes of the primary and standby DB instances are the same. When you scale the primary DB instance, its standby DB instance is also scaled.</li><li id="rds_01_0102__li06727368284">The DB instances can be scaled when they are in the <strong id="rds_01_0102__b1538213319427">Available</strong> state.</li></ul>
|
|
</div>
|
|
<div class="section" id="rds_01_0102__section106755832618"><h4 class="sectiontitle">URI</h4><ul id="rds_01_0102__ul1487413230526"><li id="rds_01_0102__li14874623115217">URI format<p id="rds_01_0102__p9874142312522"><a name="rds_01_0102__li14874623115217"></a><a name="li14874623115217"></a>POST https://{<em id="rds_01_0102__i12574184115153">Endpoint</em>}/v3/{project_id}/instances/{instance_id}/action</p>
|
|
</li><li id="rds_01_0102__li187472315526">Parameter description
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="rds_01_0102__table1576811235520" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="rds_01_0102__row18751223155212"><th align="left" class="cellrowborder" valign="top" width="23.69%" id="mcps1.3.3.2.2.1.2.4.1.1"><p id="rds_01_0102__p187572313527"><strong id="rds_01_0102__b35402365325">Name</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="21.8%" id="mcps1.3.3.2.2.1.2.4.1.2"><p id="rds_01_0102__p10875132325219"><strong id="rds_01_0102__b6413113714325">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="54.510000000000005%" id="mcps1.3.3.2.2.1.2.4.1.3"><p id="rds_01_0102__p12875122313523"><strong id="rds_01_0102__b12444133803216">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="rds_01_0102__row178751238528"><td class="cellrowborder" valign="top" width="23.69%" headers="mcps1.3.3.2.2.1.2.4.1.1 "><p id="rds_01_0102__p128751523105218">project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.8%" headers="mcps1.3.3.2.2.1.2.4.1.2 "><p id="rds_01_0102__p108751223195218">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="54.510000000000005%" headers="mcps1.3.3.2.2.1.2.4.1.3 "><p id="rds_01_0102__p887592312524">Specifies the project ID of a tenant in a region.</p>
|
|
<p id="rds_01_0102__p384015618414">For details about how to obtain the project ID, see <a href="rds_03_0002.html">Obtaining a Project ID</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="rds_01_0102__row387582335220"><td class="cellrowborder" valign="top" width="23.69%" headers="mcps1.3.3.2.2.1.2.4.1.1 "><p id="rds_01_0102__p20875102318523">instance_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.8%" headers="mcps1.3.3.2.2.1.2.4.1.2 "><p id="rds_01_0102__p15875723185214">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="54.510000000000005%" headers="mcps1.3.3.2.2.1.2.4.1.3 "><p id="rds_01_0102__p287552395211">Specifies the DB instance ID.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="rds_01_0102__section1265133172714"><h4 class="sectiontitle">Request</h4><ul id="rds_01_0102__ul1387512325219"><li id="rds_01_0102__li387592375220">Parameter description
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="rds_01_0102__table477719232522" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Parameter description</caption><thead align="left"><tr id="rds_01_0102__row118759235520"><th align="left" class="cellrowborder" valign="top" width="28.000000000000004%" id="mcps1.3.4.2.1.1.2.5.1.1"><p id="rds_01_0102__p1587542375213"><strong id="rds_01_0102__b361919271133">Name</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.1.2.5.1.2"><p id="rds_01_0102__p287512375212"><strong id="rds_01_0102__b19379132816317">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.4.2.1.1.2.5.1.3"><p id="rds_01_0102__p8875152313526"><strong id="rds_01_0102__b11458122914311">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="37%" id="mcps1.3.4.2.1.1.2.5.1.4"><p id="rds_01_0102__p198753239523"><strong id="rds_01_0102__b1992683115317">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="rds_01_0102__row1387582319526"><td class="cellrowborder" valign="top" width="28.000000000000004%" headers="mcps1.3.4.2.1.1.2.5.1.1 "><p id="rds_01_0102__p9875523185210">enlarge_volume</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.1.1.2.5.1.2 "><p id="rds_01_0102__p168751823115220">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.4.2.1.1.2.5.1.3 "><p id="rds_01_0102__a9a9492e05cb648e885d1e747a339d04d">Object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="37%" headers="mcps1.3.4.2.1.1.2.5.1.4 "><p id="rds_01_0102__p846065413298">Specifies the target storage space after scaling up.</p>
|
|
<p id="rds_01_0102__p18912221165218">For details, see <a href="#rds_01_0102__table17521151123114">Table 3</a>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="rds_01_0102__table17521151123114"></a><a name="table17521151123114"></a><table cellpadding="4" cellspacing="0" summary="" id="rds_01_0102__table17521151123114" frame="border" border="1" rules="all"><caption><b>Table 3 </b>enlarge_volume field data structure description</caption><thead align="left"><tr id="rds_01_0102__row185241211173113"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.2.1.2.2.5.1.1"><p id="rds_01_0102__p76528217317"><strong id="rds_01_0102__b01241813358">Name</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18.17%" id="mcps1.3.4.2.1.2.2.5.1.2"><p id="rds_01_0102__p465452163114"><strong id="rds_01_0102__b129569148515">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20.41%" id="mcps1.3.4.2.1.2.2.5.1.3"><p id="rds_01_0102__p1965410210319"><strong id="rds_01_0102__b789431511516">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="36.42%" id="mcps1.3.4.2.1.2.2.5.1.4"><p id="rds_01_0102__p56571521103120"><strong id="rds_01_0102__b480591613520">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="rds_01_0102__row852415112319"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.2.1.2.2.5.1.1 "><p id="rds_01_0102__p11659182173118">size</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.17%" headers="mcps1.3.4.2.1.2.2.5.1.2 "><p id="rds_01_0102__p06611021153118">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.41%" headers="mcps1.3.4.2.1.2.2.5.1.3 "><p id="rds_01_0102__p18661192153116">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="36.42%" headers="mcps1.3.4.2.1.2.2.5.1.4 "><p id="rds_01_0102__p1066392103115">The minimum start value of each scaling is 10 GB. A DB instance can be scaled up only by a multiple of 10 GB. Value range: 10 GB to 4000 GB</p>
|
|
<p id="rds_01_0102__p09681243155413"></p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</div>
|
|
<ul id="rds_01_0102__ul109711434142611"><li id="rds_01_0102__li4411135064210">Example<p id="rds_01_0102__p1454414211213"><a name="rds_01_0102__li4411135064210"></a><a name="li4411135064210"></a>POST https://rds.eu-de.otc.t-systems.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/action</p>
|
|
</li></ul>
|
|
<ul id="rds_01_0102__ul3875152311524"><li id="rds_01_0102__li18875142335210">Request example<pre class="codeblock" id="rds_01_0102__codeblock15594173112344">{
|
|
"enlarge_volume": {
|
|
"size": 400
|
|
}
|
|
}</pre>
|
|
</li></ul>
|
|
<div class="section" id="rds_01_0102__section159912464345"><h4 class="sectiontitle">Response</h4><ul id="rds_01_0102__ul28758235521"><li id="rds_01_0102__li158771723155214">Normal response
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="rds_01_0102__table137871523165214" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Parameter description</caption><thead align="left"><tr id="rds_01_0102__row38777235523"><th align="left" class="cellrowborder" valign="top" width="33.68%" id="mcps1.3.7.2.1.1.2.4.1.1"><p id="rds_01_0102__p128770232529"><strong id="rds_01_0102__b13872423519">Name</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="33.47%" id="mcps1.3.7.2.1.1.2.4.1.2"><p id="rds_01_0102__p78771723175214"><strong id="rds_01_0102__b157010441657">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="32.85%" id="mcps1.3.7.2.1.1.2.4.1.3"><p id="rds_01_0102__p78775237527"><strong id="rds_01_0102__b1698715451955">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="rds_01_0102__row6877523135212"><td class="cellrowborder" valign="top" width="33.68%" headers="mcps1.3.7.2.1.1.2.4.1.1 "><p id="rds_01_0102__p48771723115210">job_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.47%" headers="mcps1.3.7.2.1.1.2.4.1.2 "><p id="rds_01_0102__p4877182318524">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="32.85%" headers="mcps1.3.7.2.1.1.2.4.1.3 "><p id="rds_01_0102__p887719239520">Indicates the task ID.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</div>
|
|
<ul id="rds_01_0102__ul42421820113517"><li id="rds_01_0102__li5242142010359">Example normal response<pre class="codeblock" id="rds_01_0102__codeblock1214473263512">{
|
|
"job_id": "2b414788a6004883a02390e2eb0ea227"
|
|
}</pre>
|
|
</li><li id="rds_01_0102__li4328453192">Abnormal Response<p id="rds_01_0102__p58771023185211"><a name="rds_01_0102__li4328453192"></a><a name="li4328453192"></a>For details, see <a href="en-us_topic_0032488197.html">Abnormal Request Results</a>.</p>
|
|
</li></ul>
|
|
<div class="section" id="rds_01_0102__section4778540915440"><h4 class="sectiontitle">Status Code</h4><ul id="rds_01_0102__rds_01_0002_en-us_topic_0032347778_ul7858132212142"><li id="rds_01_0102__rds_01_0002_en-us_topic_0032347778_li58581622171411">Normal<p id="rds_01_0102__rds_01_0002_en-us_topic_0032347778_p1040982941020"><a name="rds_01_0102__rds_01_0002_en-us_topic_0032347778_li58581622171411"></a><a name="rds_01_0002_en-us_topic_0032347778_li58581622171411"></a>202</p>
|
|
</li><li id="rds_01_0102__rds_01_0002_en-us_topic_0032347778_li11583183218149">Abnormal<p id="rds_01_0102__rds_01_0002_en-us_topic_0032347778_p0723374409"><a name="rds_01_0102__rds_01_0002_en-us_topic_0032347778_li11583183218149"></a><a name="rds_01_0002_en-us_topic_0032347778_li11583183218149"></a>For details, see <a href="en-us_topic_0032488240.html">Status Codes</a>.</p>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="rds_01_0102__section1183074220016"><h4 class="sectiontitle">Error Code</h4><p id="rds_01_0102__en-us_topic_0032347778_p19357163913406">For details, see <a href="en-us_topic_0032488241.html">Error Codes</a>.</p>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0056887470.html">DB Instance Management</a></div>
|
|
</div>
|
|
</div>
|
|
|