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>
113 lines
10 KiB
HTML
113 lines
10 KiB
HTML
<a name="rds_05_0024"></a><a name="rds_05_0024"></a>
|
|
|
|
<h1 class="topictitle1">Upgrading a Minor Version</h1>
|
|
<div id="body0000001575992781"><div class="section" id="rds_05_0024__section4850156117316"><h4 class="sectiontitle">Function</h4><p id="rds_05_0024__p5753583532">This API is used to upgrade minor versions of RDS for MySQL or RDS for PostgreSQL instances.</p>
|
|
<ul id="rds_05_0024__en-us_topic_0238844975_ul12259155218373"><li id="rds_05_0024__en-us_topic_0238844975_en-us_topic_0110967248_li836513175363">Before calling an API, you need to understand the API in <a href="rds_03_0001.html">Authentication</a>.</li><li id="rds_05_0024__en-us_topic_0238844975_en-us_topic_0110967248_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_05_0024__section13341536702"><h4 class="sectiontitle">Constraints</h4><p id="rds_05_0024__p92581269597">This API is supported for MySQL and PostgreSQL DB engines.</p>
|
|
<div class="p" id="rds_05_0024__p1277829172518">The constraints on minor version upgrades for RDS for PostgreSQL are as follows:<ul id="rds_05_0024__ul17272155919264"><li id="rds_05_0024__li132726593268">The minor version cannot be upgraded for instances with abnormal nodes.</li><li id="rds_05_0024__li8272165915262">The following minor versions cannot be upgraded:<p id="rds_05_0024__p11453179182712"><a name="rds_05_0024__li8272165915262"></a><a name="li8272165915262"></a>- Versions earlier than 11.2 for RDS for PostgreSQL 11</p>
|
|
<p id="rds_05_0024__p143797619315">- The upgrade will be performed immediately upon the submission of your request. Delayed upgrade of minor versions is not supported.</p>
|
|
</li></ul>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="rds_05_0024__section28961517113719"><h4 class="sectiontitle">URI</h4><ul id="rds_05_0024__ul53354139141429"><li id="rds_05_0024__li1270098217262">URI format<p id="rds_05_0024__p66079617141421"><a name="rds_05_0024__li1270098217262"></a><a name="li1270098217262"></a>POST /v3/{project_id}/instances/{instance_id}/action/db-upgrade</p>
|
|
</li></ul>
|
|
<ul id="rds_05_0024__ul49831254144655"><li id="rds_05_0024__li15430535">Parameter description
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="rds_05_0024__table4657088" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="rds_05_0024__row60083059"><th align="left" class="cellrowborder" valign="top" width="20.979999999999997%" id="mcps1.3.3.3.1.1.2.4.1.1"><p id="rds_05_0024__p34889605"><strong id="rds_05_0024__b1490842412421">Name</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="16.55%" id="mcps1.3.3.3.1.1.2.4.1.2"><p id="rds_05_0024__p7485743"><strong id="rds_05_0024__b15250404424">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="62.470000000000006%" id="mcps1.3.3.3.1.1.2.4.1.3"><p id="rds_05_0024__p2365466"><strong id="rds_05_0024__b037315419428">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="rds_05_0024__row57385070"><td class="cellrowborder" valign="top" width="20.979999999999997%" headers="mcps1.3.3.3.1.1.2.4.1.1 "><p id="rds_05_0024__p17679057">project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.55%" headers="mcps1.3.3.3.1.1.2.4.1.2 "><p id="rds_05_0024__p22717550">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.470000000000006%" headers="mcps1.3.3.3.1.1.2.4.1.3 "><p id="rds_05_0024__p28182251">Project ID of a tenant in a region.</p>
|
|
<p id="rds_05_0024__p181691757183820">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_05_0024__row2864326155157"><td class="cellrowborder" valign="top" width="20.979999999999997%" headers="mcps1.3.3.3.1.1.2.4.1.1 "><p id="rds_05_0024__p41557789155220">instance_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.55%" headers="mcps1.3.3.3.1.1.2.4.1.2 "><p id="rds_05_0024__p10737742155220">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.470000000000006%" headers="mcps1.3.3.3.1.1.2.4.1.3 "><p id="rds_05_0024__p981962520456">Instance ID.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="rds_05_0024__section3074340117316"><h4 class="sectiontitle">Request</h4><ul id="rds_05_0024__ul5099287616954"><li id="rds_05_0024__li5628270116954">Parameter description
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="rds_05_0024__table11236435" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Parameter description</caption><thead align="left"><tr id="rds_05_0024__row61525259"><th align="left" class="cellrowborder" valign="top" width="18.110000000000003%" id="mcps1.3.4.2.1.1.2.5.1.1"><p id="rds_05_0024__p17490046"><strong id="rds_05_0024__b4921202911446">Name</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18.500000000000004%" id="mcps1.3.4.2.1.1.2.5.1.2"><p id="rds_05_0024__p7407659"><strong id="rds_05_0024__b12338531154414">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18.71%" id="mcps1.3.4.2.1.1.2.5.1.3"><p id="rds_05_0024__p63149496"><strong id="rds_05_0024__b758193317446">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="44.68%" id="mcps1.3.4.2.1.1.2.5.1.4"><p id="rds_05_0024__p14835533"><strong id="rds_05_0024__b78551434174420">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="rds_05_0024__row1585717246378"><td class="cellrowborder" valign="top" width="18.110000000000003%" headers="mcps1.3.4.2.1.1.2.5.1.1 "><p id="rds_05_0024__p12858162418378">delay</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.500000000000004%" headers="mcps1.3.4.2.1.1.2.5.1.2 "><p id="rds_05_0024__p17858524163720">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.71%" headers="mcps1.3.4.2.1.1.2.5.1.3 "><p id="rds_05_0024__p3858172417371">Boolean</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="44.68%" headers="mcps1.3.4.2.1.1.2.5.1.4 "><p id="rds_05_0024__p118580246371">Whether to delay the upgrade until the maintenance window.</p>
|
|
<ul id="rds_05_0024__ul3486102803813"><li id="rds_05_0024__li3467518124616"><strong id="rds_05_0024__b174301726202810">true</strong>: Delay the upgrade. This value is only available to RDS for MySQL. The instance will be upgraded during the specified maintenance window.</li><li id="rds_05_0024__li1185193243819"><strong id="rds_05_0024__b142013365247">false</strong>: Upgrade the instance immediately (default value).</li></ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="rds_05_0024__li4411135064210">Example<p id="rds_05_0024__p1454414211213"><a name="rds_05_0024__li4411135064210"></a><a name="li4411135064210"></a>POST https://rds.eu-de.otc.t-systems.com/v3/054ea741f700d4a32f1bc00f5c80dd4c/instances/5b409baece064984a1b3eef6addae50cin01/action/db-upgrade</p>
|
|
</li></ul>
|
|
<ul id="rds_05_0024__ul18318676175816"><li id="rds_05_0024__li30650356175816">Request example<pre class="codeblock" id="rds_05_0024__codeblock18571332142318">{
|
|
"delay":false
|
|
}</pre>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="rds_05_0024__section28521534113742"><h4 class="sectiontitle">Response</h4><ul id="rds_05_0024__ul12573920"><li id="rds_05_0024__li16881840172715">Normal response
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="rds_05_0024__table668693854710" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Parameter description</caption><thead align="left"><tr id="rds_05_0024__row579917386473"><th align="left" class="cellrowborder" valign="top" width="33.68%" id="mcps1.3.5.2.1.1.2.4.1.1"><p id="rds_05_0024__p11799738114718"><strong id="rds_05_0024__b3958554122612">Name</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="33.47%" id="mcps1.3.5.2.1.1.2.4.1.2"><p id="rds_05_0024__p879983818477"><strong id="rds_05_0024__b74571713279">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="32.85%" id="mcps1.3.5.2.1.1.2.4.1.3"><p id="rds_05_0024__p1799538174710"><strong id="rds_05_0024__b187831780274">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="rds_05_0024__row1379923812473"><td class="cellrowborder" valign="top" width="33.68%" headers="mcps1.3.5.2.1.1.2.4.1.1 "><p id="rds_05_0024__p5799103874712">job_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.47%" headers="mcps1.3.5.2.1.1.2.4.1.2 "><p id="rds_05_0024__p879983854715">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="32.85%" headers="mcps1.3.5.2.1.1.2.4.1.3 "><p id="rds_05_0024__p177991438194711">Job ID.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="rds_05_0024__li14589114972719">Example normal response<pre class="codeblock" id="rds_05_0024__codeblock15124144002718">{
|
|
"job_id": "2b414788a6004883a02390e2eb0ea227"
|
|
}</pre>
|
|
</li><li id="rds_05_0024__li68218279114">Abnormal response<p id="rds_05_0024__p28475059"><a name="rds_05_0024__li68218279114"></a><a name="li68218279114"></a>For details, see <a href="en-us_topic_0032488197.html">Abnormal Request Results</a>.</p>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="rds_05_0024__section4778540915440"><h4 class="sectiontitle">Status Code</h4><ul id="rds_05_0024__rds_01_0002_en-us_topic_0032347778_ul7858132212142"><li id="rds_05_0024__rds_01_0002_en-us_topic_0032347778_li58581622171411">Normal<p id="rds_05_0024__rds_01_0002_en-us_topic_0032347778_p1040982941020"><a name="rds_05_0024__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_05_0024__rds_01_0002_en-us_topic_0032347778_li11583183218149">Abnormal<p id="rds_05_0024__rds_01_0002_en-us_topic_0032347778_p0723374409"><a name="rds_05_0024__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_05_0024__section1183074220016"><h4 class="sectiontitle">Error Code</h4><p id="rds_05_0024__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>
|
|
|