rds_api

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>

docs/rds/api-ref/en-us_topic_0032347785.html

@@ -282,7 +282,7 @@
 <td class="cellrowborder" valign="top" width="27.07%" headers="mcps1.3.3.2.1.4.2.5.1.3 "><p id="en-us_topic_0032347785__p25105132">String</p>
 </td>
 <td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.3.2.1.4.2.5.1.4 "><p id="en-us_topic_0032347785__p20249826">Specifies the database version.</p>
-<ul id="en-us_topic_0032347785__ul2128855618558"><li id="en-us_topic_0032347785__li532251018558">MySQL databases support 5.6, 5.7 and 8.0. Example value: 5.7</li><li id="en-us_topic_0032347785__li926104115396">PostgreSQL databases support 9.5, 9.6, 10, 11, 12, 13, 14 and 15. Example value: 9.6</li><li id="en-us_topic_0032347785__li10113118558">Microsoft SQL Server databases support 2017_SE, 2017_EE, 2019_SE, 2019_EE, 2022_SE and 2022_EE. Example value: 2017_SE</li></ul>
+<ul id="en-us_topic_0032347785__ul2128855618558"><li id="en-us_topic_0032347785__li532251018558">MySQL databases support 5.6, 5.7 and 8.0. Example value: 5.7</li><li id="en-us_topic_0032347785__li926104115396">PostgreSQL databases support 11, 12, 13, 14, 15  and 16. Example value: 11</li><li id="en-us_topic_0032347785__li10113118558">Microsoft SQL Server databases support 2017_SE, 2017_EE, 2019_SE, 2019_EE, 2022_SE and 2022_EE. Example value: 2017_SE</li></ul>
 <p id="en-us_topic_0032347785__p2139751518103">For details about supported database versions, see section <a href="en-us_topic_0032347782.html">Database Version Queries</a>.</p>
 </td>
 </tr>

docs/rds/api-ref/en-us_topic_0032488244.html

@@ -8,7 +8,13 @@
 </th>
 </tr>
 </thead>
-<tbody><tr id="en-us_topic_0032488244__row995316521348"><td class="cellrowborder" valign="top" width="17.669999999999998%" headers="mcps1.3.1.1.3.1.1 "><p id="en-us_topic_0032488244__p3900162656">2024-03-22</p>
+<tbody><tr id="en-us_topic_0032488244__row2020548172919"><td class="cellrowborder" valign="top" width="17.669999999999998%" headers="mcps1.3.1.1.3.1.1 "><p id="en-us_topic_0032488244__p204644125297">2024-08-15</p>
+</td>
+<td class="cellrowborder" valign="top" width="82.33%" headers="mcps1.3.1.1.3.1.2 "><p id="en-us_topic_0032488244__p12171161320311">Modified the following content:</p>
+<p id="en-us_topic_0032488244__p9824164093218">Modified the dimension descriptions in <a href="en-us_topic_0041314720.html">RDS Monitoring Metrics Description</a>.</p>
+</td>
+</tr>
+<tr id="en-us_topic_0032488244__row995316521348"><td class="cellrowborder" valign="top" width="17.669999999999998%" headers="mcps1.3.1.1.3.1.1 "><p id="en-us_topic_0032488244__p3900162656">2024-03-22</p>
 </td>
 <td class="cellrowborder" valign="top" width="82.33%" headers="mcps1.3.1.1.3.1.2 "><p id="en-us_topic_0032488244__p138688283519">Modified the following content:</p>
 <p id="en-us_topic_0032488244__p109551252441">Supported Extreme SSD.</p>

docs/rds/api-ref/en-us_topic_0043898356.html

@@ -25,9 +25,9 @@
 </tr>
 <tr id="en-us_topic_0043898356__en-us_topic_0000001191211307_row1223994413545"><td class="cellrowborder" valign="top" width="18.76%" headers="mcps1.3.3.2.5.1.1 "><p id="en-us_topic_0043898356__en-us_topic_0000001191211307_p12391244145410">PostgreSQL</p>
 </td>
-<td class="cellrowborder" valign="top" width="30.810000000000002%" headers="mcps1.3.3.2.5.1.2 "><ul id="en-us_topic_0043898356__en-us_topic_0000001191211307_ul153957284"><li id="en-us_topic_0043898356__en-us_topic_0000001191211307_li859374122512">15</li><li id="en-us_topic_0043898356__en-us_topic_0000001191211307_li999014355212">14</li><li id="en-us_topic_0043898356__en-us_topic_0000001191211307_li578915812569">13</li><li id="en-us_topic_0043898356__en-us_topic_0000001191211307_li99033116571">12</li><li id="en-us_topic_0043898356__en-us_topic_0000001191211307_li14391771586">11</li><li id="en-us_topic_0043898356__en-us_topic_0000001191211307_li9396717818">10</li><li id="en-us_topic_0043898356__en-us_topic_0000001191211307_li8401277813">9.6</li><li id="en-us_topic_0043898356__en-us_topic_0000001191211307_li1940672814">9.5</li></ul>
+<td class="cellrowborder" valign="top" width="30.810000000000002%" headers="mcps1.3.3.2.5.1.2 "><ul id="en-us_topic_0043898356__en-us_topic_0000001191211307_ul153957284"><li id="en-us_topic_0043898356__en-us_topic_0000001191211307_li931795312120">16</li><li id="en-us_topic_0043898356__en-us_topic_0000001191211307_li859374122512">15</li><li id="en-us_topic_0043898356__en-us_topic_0000001191211307_li999014355212">14</li><li id="en-us_topic_0043898356__en-us_topic_0000001191211307_li578915812569">13</li><li id="en-us_topic_0043898356__en-us_topic_0000001191211307_li99033116571">12</li><li id="en-us_topic_0043898356__en-us_topic_0000001191211307_li14391771586">11</li></ul>
 </td>
-<td class="cellrowborder" valign="top" width="30.740000000000006%" headers="mcps1.3.3.2.5.1.3 "><ul id="en-us_topic_0043898356__en-us_topic_0000001191211307_ul679911214816"><li id="en-us_topic_0043898356__en-us_topic_0000001191211307_li323388192520">15</li><li id="en-us_topic_0043898356__en-us_topic_0000001191211307_li6873739102110">14</li><li id="en-us_topic_0043898356__en-us_topic_0000001191211307_li11561141825619">13</li><li id="en-us_topic_0043898356__en-us_topic_0000001191211307_li877983015583">12</li><li id="en-us_topic_0043898356__en-us_topic_0000001191211307_li77990126815">11</li><li id="en-us_topic_0043898356__en-us_topic_0000001191211307_li177994120814">10</li><li id="en-us_topic_0043898356__en-us_topic_0000001191211307_li127990121483">9.6</li><li id="en-us_topic_0043898356__en-us_topic_0000001191211307_li127998121489">9.5</li></ul>
+<td class="cellrowborder" valign="top" width="30.740000000000006%" headers="mcps1.3.3.2.5.1.3 "><ul id="en-us_topic_0043898356__en-us_topic_0000001191211307_ul679911214816"><li id="en-us_topic_0043898356__en-us_topic_0000001191211307_li095315710217">16</li><li id="en-us_topic_0043898356__en-us_topic_0000001191211307_li323388192520">15</li><li id="en-us_topic_0043898356__en-us_topic_0000001191211307_li6873739102110">14</li><li id="en-us_topic_0043898356__en-us_topic_0000001191211307_li11561141825619">13</li><li id="en-us_topic_0043898356__en-us_topic_0000001191211307_li877983015583">12</li><li id="en-us_topic_0043898356__en-us_topic_0000001191211307_li77990126815">11</li></ul>
 </td>
 <td class="cellrowborder" valign="top" width="19.69%" headers="mcps1.3.3.2.5.1.4 "><p id="en-us_topic_0043898356__en-us_topic_0000001191211307_p92311432122413">Not supported</p>
 </td>

docs/rds/api-ref/en-us_topic_0056889804.html

@@ -307,7 +307,7 @@
 <td class="cellrowborder" valign="top" width="33.14331433143314%" headers="mcps1.3.3.2.1.4.2.5.1.3 "><p id="en-us_topic_0056889804__p3402226218295">String</p>
 </td>
 <td class="cellrowborder" valign="top" width="25.002500250025%" headers="mcps1.3.3.2.1.4.2.5.1.4 "><p id="en-us_topic_0056889804__p433981518295">Specifies the database version.</p>
-<ul id="en-us_topic_0056889804__ul2128855618558"><li id="en-us_topic_0056889804__li532251018558">MySQL databases support 5.6, 5.7 and 8.0. Example value: 5.7</li><li id="en-us_topic_0056889804__li926104115396">PostgreSQL databases support 9.5, 9.6, 10, 11, 12, 13, 14 and 15. Example value: 9.6</li></ul>
+<ul id="en-us_topic_0056889804__ul2128855618558"><li id="en-us_topic_0056889804__li532251018558">MySQL databases support 5.6, 5.7 and 8.0. Example value: 5.7</li><li id="en-us_topic_0056889804__li926104115396">PostgreSQL databases support 11, 12, 13, 14, 15  and 16. Example value: 11</li></ul>
 <p id="en-us_topic_0056889804__p2139751518103">For details about supported database versions, see section <a href="en-us_topic_0032347782.html">Database Version Queries</a>.</p>
 </td>
 </tr>

docs/rds/api-ref/en-us_topic_0056890053.html

@@ -327,7 +327,7 @@
         },
         "datastore": {
           "type": "PostgreSQL",
-          "version": "PostgreSQL-9.5.5"
+          "version": "PostgreSQL-11"
         },
         
         "region": "eu-de",

docs/rds/api-ref/en-us_topic_0056890263.html

@@ -160,7 +160,7 @@
 <td class="cellrowborder" valign="top" width="21.80781921807819%" headers="mcps1.3.3.2.1.4.2.5.1.3 "><p id="en-us_topic_0056890263__p3577604415054">String</p>
 </td>
 <td class="cellrowborder" valign="top" width="28.577142285771423%" headers="mcps1.3.3.2.1.4.2.5.1.4 "><p id="en-us_topic_0056890263__p58374830113022">Specifies the database version.</p>
-<ul id="en-us_topic_0056890263__ul4208889514478"><li id="en-us_topic_0056890263__li6070366414478">For MySQL, the value can be <strong id="en-us_topic_0056890263__b842352706173747">5.6</strong> and <strong id="en-us_topic_0056890263__b842352706173755">5.7</strong>. The value <strong id="en-us_topic_0056890263__b842352706173759">5.6</strong> is supported by default.</li><li id="en-us_topic_0056890263__li5274166814478">For PostgreSQL, the value can be 9.5, 9.6, 10, and 11. The default value is <strong id="en-us_topic_0056890263__b165162275173835">9.5</strong>.</li></ul>
+<ul id="en-us_topic_0056890263__ul4208889514478"><li id="en-us_topic_0056890263__li6070366414478">For MySQL, the value can be <strong id="en-us_topic_0056890263__b842352706173747">5.6</strong> and <strong id="en-us_topic_0056890263__b842352706173755">5.7</strong>. The value <strong id="en-us_topic_0056890263__b842352706173759">5.6</strong> is supported by default.</li><li id="en-us_topic_0056890263__li5274166814478">For PostgreSQL, the value can be <strong id="en-us_topic_0056890263__b1565174122610">11</strong> and <strong id="en-us_topic_0056890263__b13781194519268">16</strong>. The default value is <strong id="en-us_topic_0056890263__b8167121014239">11</strong>.</li></ul>
 </td>
 </tr>
 </tbody>

docs/rds/api-ref/rds_01_0002.html

@@ -359,7 +359,7 @@
 <td class="cellrowborder" valign="top" width="21.25%" headers="mcps1.3.3.4.2.5.1.3 "><p id="rds_01_0002__p25105132">String</p>
 </td>
 <td class="cellrowborder" valign="top" width="30.049999999999997%" headers="mcps1.3.3.4.2.5.1.4 "><p id="rds_01_0002__p20249826">Specifies the database version.</p>
-<ul id="rds_01_0002__ul2128855618558"><li id="rds_01_0002__li532251018558">MySQL databases support 5.6, 5.7, and 8.0. Example value: 5.7 </li><li id="rds_01_0002__li134407134561">PostgreSQL databases support 9.5, 9.6, 10, 11, 12, 13, 14 and 15. Example value: 9.6</li><li id="rds_01_0002__li7303143151411">Microsoft SQL Server databases only support 2017_SE, 2017_EE, 2019_SE, 2019_EE, 2022_SE and 2022_EE. Example value: 2017_SE</li></ul>
+<ul id="rds_01_0002__ul2128855618558"><li id="rds_01_0002__li532251018558">MySQL databases support 5.6, 5.7, and 8.0. Example value: 5.7 </li><li id="rds_01_0002__li134407134561">PostgreSQL databases support 11, 12, 13, 14, 15 and 16. Example value: 11</li><li id="rds_01_0002__li7303143151411">Microsoft SQL Server databases only support 2017_SE, 2017_EE, 2019_SE, 2019_EE, 2022_SE and 2022_EE. Example value: 2017_SE</li></ul>
 <p id="rds_01_0002__p2139751518103">For details about supported database versions, see section <a href="rds_06_0001.html">Querying Version Information About a DB Engine</a>.</p>
 </td>
 </tr>

docs/rds/api-ref/rds_01_0004.html

@@ -173,6 +173,7 @@
 <td class="cellrowborder" valign="top" width="51.519999999999996%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="rds_01_0004__p121231486267">Indicates the DB instance status.</p>
 <p id="rds_01_0004__p14123381266">Value:</p>
 <p id="rds_01_0004__p121235818262">If the value is <strong id="rds_01_0004__b84235270616547_1">BUILD</strong>, the instance is being created.</p>
+<p id="rds_01_0004__p10668111041810">If the value is<strong id="rds_01_0004__b840113151811"> CREATE FAIL</strong>, the instance failed to be created.</p>
 <p id="rds_01_0004__p1712312817262">If the value is <strong id="rds_01_0004__b842352706165415">ACTIVE</strong>, the instance is normal.</p>
 <p id="rds_01_0004__p101231892614">If the value is <strong id="rds_01_0004__b842352706165427">FAILED</strong>, the instance is abnormal.</p>
 <p id="rds_01_0004__p16123485263">If the value is <strong id="rds_01_0004__b84235270616547_3">MODIFYING</strong>, the instance is being scaled up.</p>

docs/rds/api-ref/rds_03_0001.html

@@ -12,7 +12,6 @@
 <span class="normal">2</span></pre></div></td><td class="code"><div><pre><span></span><span class="n">Content</span><span class="o">-</span><span class="n">Type</span><span class="p">:</span><span class="w"> </span><span class="n">application</span><span class="o">/</span><span class="n">json</span>
 <span class="n">X</span><span class="o">-</span><span class="n">Auth</span><span class="o">-</span><span class="n">Token</span><span class="p">:</span><span class="w"> </span><span class="n">ABCDEFJ</span><span class="p">....</span>
 </pre></div></td></tr></table></div>
-
 </div>
 </div>
 </div>

docs/rds/api-ref/rds_04_0002.html

@@ -36,7 +36,7 @@
 <td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.2.3.1.1.2.4.1.2 "><p id="rds_04_0002__p116114111716">Yes</p>
 </td>
 <td class="cellrowborder" valign="top" width="57.99999999999999%" headers="mcps1.3.2.3.1.1.2.4.1.3 "><p id="rds_04_0002__p31610414179">Specifies the database version. For details about how to obtain the database version, see section <a href="rds_06_0001.html">Querying Version Information About a DB Engine</a>.</p>
-<ul id="rds_04_0002__ul2128855618558"><li id="rds_04_0002__li532251018558">MySQL databases support 5.6, 5.7, and 8.0.</li><li id="rds_04_0002__li134407134561">PostgreSQL databases support 9.5, 9.6, 10, 11, 12, 13, 14 and 15.</li><li id="rds_04_0002__li7303143151411">Microsoft SQL Server databases only support 2017_SE, 2017_EE, 2019_SE, 2019_EE, 2022_SE and 2022_EE.</li></ul>
+<ul id="rds_04_0002__ul2128855618558"><li id="rds_04_0002__li532251018558">MySQL databases support 5.6, 5.7, and 8.0.</li><li id="rds_04_0002__li134407134561">PostgreSQL databases support 10, 11, 12, 13, 14, 15 and 16.</li><li id="rds_04_0002__li7303143151411">Microsoft SQL Server databases only support 2017_SE, 2017_EE, 2019_SE, 2019_EE, 2022_SE and 2022_EE.</li></ul>
 </td>
 </tr>
 </tbody>

docs/rds/api-ref/rds_05_0027.html

@@ -4,7 +4,7 @@
 <div id="body0000001521216833"><div class="section" id="rds_05_0027__section10502114133410"><h4 class="sectiontitle">Function</h4><p id="rds_05_0027__p1730163110553">This API is used to query the storage autoscaling policy of a DB instance.</p>
 <ul id="rds_05_0027__en-us_topic_0293125646_ul12259155218373"><li id="rds_05_0027__en-us_topic_0293125646_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_0027__en-us_topic_0293125646_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_0027__section9207631102915"><h4 class="sectiontitle">Constraints</h4><ul id="rds_05_0027__ul1396256192117"><li id="rds_05_0027__li77948231138">This API is only available to RDS for MySQL instances whose storage type is cloud SSDs or extreme SSDs and storage space is at least 40 GB.</li></ul>
+<div class="section" id="rds_05_0027__section9207631102915"><h4 class="sectiontitle">Constraints</h4><ul id="rds_05_0027__ul1396256192117"><li id="rds_05_0027__li77948231138">This API is only available to RDS for MySQL, Microsoft SQL Server and RDS for PostgreSQL instances whose storage type is cloud SSDs or extreme SSDs and storage space is at least 40 GB.</li></ul>
 </div>
 <div class="section" id="rds_05_0027__section28961517113719"><h4 class="sectiontitle">URI</h4><ul id="rds_05_0027__ul53354139141429"><li id="rds_05_0027__li1270098217262">URI format<p id="rds_05_0027__p30251930154721"><a name="rds_05_0027__li1270098217262"></a><a name="li1270098217262"></a>GET /v3/{<em id="rds_05_0027__i148911057155316">project_id</em>}/instances/{<em id="rds_05_0027__i923712547">instance_id</em>}/disk-auto-expansion</p>
 </li></ul>

docs/rds/api-ref/rds_05_0028.html

@@ -6,7 +6,7 @@
 <p id="rds_05_0028__p195962011012">Autoscaling up the storage of a read replica does not affect that of the primary instance. The new storage space of the read replica after autoscaling must be no less than that of the primary instance.</p>
 <ul id="rds_05_0028__en-us_topic_0293125646_ul12259155218373"><li id="rds_05_0028__en-us_topic_0293125646_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_0028__en-us_topic_0293125646_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_0028__section9207631102915"><h4 class="sectiontitle">Constraints</h4><ul id="rds_05_0028__ul1396256192117"><li id="rds_05_0028__li77948231138">This API is only available to RDS for MySQL instances whose storage type is cloud SSDs or extreme SSDs and storage space is at least 40 GB.</li><li id="rds_05_0028__li12129185162212">Storage autoscaling is unavailable when the instance is in any of the following statuses: changing instance class, upgrading a minor version, migrating the standby instance, and rebooting.</li><li id="rds_05_0028__li2582183212019">The storage space can be autoscaled up only when your instance status is <strong id="rds_05_0028__b1375116434920">Available</strong> or <strong id="rds_05_0028__b47521349495">Storage full</strong>. The maximum allowed storage is 4,000 GB.</li></ul>
+<div class="section" id="rds_05_0028__section9207631102915"><h4 class="sectiontitle">Constraints</h4><ul id="rds_05_0028__ul1396256192117"><li id="rds_05_0028__li77948231138">This API is only available to RDS for MySQL, Microsoft SQL Server and RDS for PostgreSQL instances whose storage type is cloud SSDs or extreme SSDs and storage space is at least 40 GB.</li><li id="rds_05_0028__li12129185162212">Storage autoscaling is unavailable when the instance is in any of the following statuses: changing instance class, upgrading a minor version, migrating the standby instance, and rebooting.</li><li id="rds_05_0028__li2582183212019">The storage space can be autoscaled up only when your instance status is <strong id="rds_05_0028__b1375116434920">Available</strong> or <strong id="rds_05_0028__b47521349495">Storage full</strong>. The maximum allowed storage is 4,000 GB.</li></ul>
 </div>
 <div class="section" id="rds_05_0028__section28961517113719"><h4 class="sectiontitle">URI</h4><ul id="rds_05_0028__ul53354139141429"><li id="rds_05_0028__li1270098217262">URI format<p id="rds_05_0028__p30251930154721"><a name="rds_05_0028__li1270098217262"></a><a name="li1270098217262"></a>PUT /v3/{<em id="rds_05_0028__i148911057155316">project_id</em>}/instances/{<em id="rds_05_0028__i923712547">instance_id</em>}/disk-auto-expansion</p>
 </li></ul>

docs/rds/api-ref/rds_06_0002.html

@@ -124,7 +124,7 @@
 <td class="cellrowborder" valign="top" width="13.34%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="rds_06_0002__p536875112917">Array</p>
 </td>
 <td class="cellrowborder" valign="top" width="69.24%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="rds_06_0002__p1136845114915">Indicates the database version.</p>
-<ul id="rds_06_0002__ul183911316327"><li id="rds_06_0002__li1883921320322">MySQL databases support 5.6, 5.7, and 8.0.</li><li id="rds_06_0002__li12840413143219">PostgreSQL databases support 9.5, 9.6, 10, 11, 12, 13, 14 and 15.</li><li id="rds_06_0002__li68401913153220">Microsoft SQL Server databases only support 2017_SE, 2017_EE, 2019_SE, 2019_EE, 2022_SE and 2022_EE.</li></ul>
+<ul id="rds_06_0002__ul183911316327"><li id="rds_06_0002__li1883921320322">MySQL databases support 5.6, 5.7, and 8.0.</li><li id="rds_06_0002__li12840413143219">PostgreSQL databases support 11, 12, 13, 14, 15 and 16.</li><li id="rds_06_0002__li68401913153220">Microsoft SQL Server databases only support 2017_SE, 2017_EE, 2019_SE, 2019_EE, 2022_SE and 2022_EE.</li></ul>
 <p id="rds_06_0002__p2126612175014">Example value for MySQL: ["5.6","5.7","8.0"]</p>
 </td>
 </tr>

docs/rds/api-ref/rds_09_0000.html

@@ -18,6 +18,8 @@
 </li>
 <li class="ulchildlink"><strong><a href="en-us_topic_0032347777.html">Backup and Restoration</a></strong><br>
 </li>
+<li class="ulchildlink"><strong><a href="rds_19_0000.html">Upgrading a Major Version</a></strong><br>
+</li>
 <li class="ulchildlink"><strong><a href="en-us_topic_0056887472.html">Log Information Queries</a></strong><br>
 </li>
 <li class="ulchildlink"><strong><a href="rds_14_0000.html">Recycling a DB Instance</a></strong><br>

docs/rds/api-ref/rds_19_0000.html

@@ -0,0 +1,26 @@
+<a name="rds_19_0000"></a><a name="rds_19_0000"></a>
+
+<h1 class="topictitle1">Upgrading a Major Version</h1>
+<div id="body0000001954633936"><p id="rds_19_0000__en-us_topic_0000001766001225_p8060118"></p>
+</div>
+<div>
+<ul class="ullinks">
+<li class="ulchildlink"><strong><a href="rds_19_0001.html">Querying the Target Version to Which a DB Instance Can Be Upgraded (RDS for PostgreSQL)</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="rds_19_0002.html">Performing a Major Version Upgrade Pre-Check for a DB Instance (RDS for PostgreSQL)</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="rds_19_0003.html">Querying the Major Version Check Status or Upgrade Status of a DB Instance (RDS for PostgreSQL)</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="rds_19_0004.html">Querying the Major Version Upgrade Check History of a DB Instance (RDS for PostgreSQL)</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="rds_19_0005.html">Upgrading a Major Version of a DB Instance (RDS for PostgreSQL)</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="rds_19_0006.html">Querying the Major Version Upgrade History of a DB Instance (RDS for PostgreSQL)</a></strong><br>
+</li>
+</ul>
+
+<div class="familylinks">
+<div class="parentlink"><strong>Parent topic:</strong> <a href="rds_09_0000.html">API v3 (Recommended)</a></div>
+</div>
+</div>
+

docs/rds/api-ref/rds_19_0001.html

@@ -0,0 +1,89 @@
+<a name="rds_19_0001"></a><a name="rds_19_0001"></a>
+
+<h1 class="topictitle1">Querying the Target Version to Which a DB Instance Can Be Upgraded (RDS for PostgreSQL)</h1>
+<div id="body0000001989993297"><div class="section" id="rds_19_0001__en-us_topic_0000001766001233_section101471329163720"><h4 class="sectiontitle">Function</h4><p id="rds_19_0001__en-us_topic_0000001766001233_p1021482973717">This API is used to query the target version to which an RDS for PostgreSQL DB instance can be upgraded.</p>
+<ul id="rds_19_0001__ul16405173211918"><li id="rds_19_0001__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_19_0001__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_19_0001__en-us_topic_0000001766001233_section1814882993710"><h4 class="sectiontitle">Constraints</h4><ul id="rds_19_0001__en-us_topic_0000001766001233_ul192141329173714"><li id="rds_19_0001__en-us_topic_0000001766001233_li42141429173719">This API is available to RDS for PostgreSQL only.</li><li id="rds_19_0001__en-us_topic_0000001766001233_li16214112910371">This operation cannot be performed when the DB instance is in any of the following statuses: creating, changing instance specifications, changing port, frozen, or abnormal.</li><li id="rds_19_0001__li1347961715304">Major version upgrades are available to the following versions:<ul id="rds_19_0001__ul14404121863013"><li id="rds_19_0001__li14269152120307">RDS for PostgreSQL 12: 12.7 or later</li><li id="rds_19_0001__li07831119142918">RDS for PostgreSQL 13: 13.3 or later</li><li id="rds_19_0001__li121051520124511">RDS for PostgreSQL 14: 14.4 or later</li><li id="rds_19_0001__li733653516126">Major version upgrades are unavailable to RDS for PostgreSQL 11.</li></ul>
+</li><li id="rds_19_0001__en-us_topic_0000001551538538_li778431917297">Before a major version upgrade, perform an upgrade check. If there is no successful upgrade check in the validity period, a major version upgrade is not allowed.</li></ul>
+</div>
+<div class="section" id="rds_19_0001__en-us_topic_0000001766001233_section181492029183712"><h4 class="sectiontitle">URI</h4><ul id="rds_19_0001__en-us_topic_0000001766001233_ul42141729113719"><li id="rds_19_0001__en-us_topic_0000001766001233_li13214929203710">URI format<p id="rds_19_0001__en-us_topic_0000001766001233_p1221412293370"><a name="rds_19_0001__en-us_topic_0000001766001233_li13214929203710"></a><a name="en-us_topic_0000001766001233_li13214929203710"></a>GET /v3/{project_id}/instances/{instance_id}/major-version/available-version</p>
+</li><li id="rds_19_0001__en-us_topic_0000001766001233_li13214192911378">Parameter description
+<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="rds_19_0001__en-us_topic_0000001766001233_table19150102913371" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="rds_19_0001__en-us_topic_0000001766001233_row72141429153718"><th align="left" class="cellrowborder" valign="top" width="18.56185618561856%" id="mcps1.3.3.2.2.1.2.5.1.1"><p id="rds_19_0001__en-us_topic_0000001766001233_p621442913373"><strong id="rds_19_0001__b1544145641918">Name</strong></p>
+</th>
+<th align="left" class="cellrowborder" valign="top" width="16.491649164916492%" id="mcps1.3.3.2.2.1.2.5.1.2"><p id="rds_19_0001__en-us_topic_0000001766001233_p421452916379"><strong id="rds_19_0001__b89082037102316">Type</strong></p>
+</th>
+<th align="left" class="cellrowborder" valign="top" width="16.491649164916492%" id="mcps1.3.3.2.2.1.2.5.1.3"><p id="rds_19_0001__en-us_topic_0000001766001233_p0214929113714"><strong id="rds_19_0001__b1881155721914">Mandatory</strong></p>
+</th>
+<th align="left" class="cellrowborder" valign="top" width="48.45484548454845%" id="mcps1.3.3.2.2.1.2.5.1.4"><p id="rds_19_0001__en-us_topic_0000001766001233_p321482918375"><strong id="rds_19_0001__b459275712195">Description</strong></p>
+</th>
+</tr>
+</thead>
+<tbody><tr id="rds_19_0001__en-us_topic_0000001766001233_row1321410293370"><td class="cellrowborder" valign="top" width="18.56185618561856%" headers="mcps1.3.3.2.2.1.2.5.1.1 "><p id="rds_19_0001__en-us_topic_0000001766001233_p17214129103714">project_id</p>
+</td>
+<td class="cellrowborder" valign="top" width="16.491649164916492%" headers="mcps1.3.3.2.2.1.2.5.1.2 "><p id="rds_19_0001__en-us_topic_0000001766001233_p19214152973718">String</p>
+</td>
+<td class="cellrowborder" valign="top" width="16.491649164916492%" headers="mcps1.3.3.2.2.1.2.5.1.3 "><p id="rds_19_0001__en-us_topic_0000001766001233_p2214192923712">Yes</p>
+</td>
+<td class="cellrowborder" valign="top" width="48.45484548454845%" headers="mcps1.3.3.2.2.1.2.5.1.4 "><p id="rds_19_0001__p1434580163733">Project ID of a tenant in a region.</p>
+<p id="rds_19_0001__en-us_topic_0000001766001233_p2021516295378">To obtain it, refer to <a href="rds_03_0002.html">Obtaining a Project ID</a>.</p>
+</td>
+</tr>
+<tr id="rds_19_0001__en-us_topic_0000001766001233_row14215629183717"><td class="cellrowborder" valign="top" width="18.56185618561856%" headers="mcps1.3.3.2.2.1.2.5.1.1 "><p id="rds_19_0001__en-us_topic_0000001766001233_p4215182910372">instance_id</p>
+</td>
+<td class="cellrowborder" valign="top" width="16.491649164916492%" headers="mcps1.3.3.2.2.1.2.5.1.2 "><p id="rds_19_0001__en-us_topic_0000001766001233_p122158293371">String</p>
+</td>
+<td class="cellrowborder" valign="top" width="16.491649164916492%" headers="mcps1.3.3.2.2.1.2.5.1.3 "><p id="rds_19_0001__en-us_topic_0000001766001233_p1021522918376">Yes</p>
+</td>
+<td class="cellrowborder" valign="top" width="48.45484548454845%" headers="mcps1.3.3.2.2.1.2.5.1.4 "><p id="rds_19_0001__en-us_topic_0000001766001233_p1021512933713">Instance ID.</p>
+</td>
+</tr>
+</tbody>
+</table>
+</div>
+</li></ul>
+</div>
+<div class="section" id="rds_19_0001__en-us_topic_0000001766001233_section1815992953715"><h4 class="sectiontitle">Request</h4><ul id="rds_19_0001__en-us_topic_0000001766001233_ul12215829163714"><li id="rds_19_0001__en-us_topic_0000001766001233_li16215132973717">Request parameters<p id="rds_19_0001__en-us_topic_0000001766001233_p8215142916372"><a name="rds_19_0001__en-us_topic_0000001766001233_li16215132973717"></a><a name="en-us_topic_0000001766001233_li16215132973717"></a>None</p>
+</li><li id="rds_19_0001__en-us_topic_0000001766001233_li1421522916371">Example<pre class="screen" id="rds_19_0001__en-us_topic_0000001766001233_screen13327154113400">https://<em id="rds_19_0001__en-us_topic_0000001766001233_i31171851184010">{Endpoint}</em>/v3/0483b6b16e954cb88930a360d2c4e663/instances/3aa441c4c98a4b36b100a7e3e87d17cein03/major-version/available-version</pre>
+</li></ul>
+</div>
+<div class="section" id="rds_19_0001__en-us_topic_0000001766001233_section1716122983711"><h4 class="sectiontitle">Response</h4><ul id="rds_19_0001__en-us_topic_0000001766001233_ul421552923714"><li id="rds_19_0001__en-us_topic_0000001766001233_li18215829133711">Normal response
+<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="rds_19_0001__en-us_topic_0000001766001233_table1716332943710" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Parameter description</caption><thead align="left"><tr id="rds_19_0001__en-us_topic_0000001766001233_row122154299371"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.5.2.1.1.2.4.1.1"><p id="rds_19_0001__en-us_topic_0000001766001233_p021532983718"><strong id="rds_19_0001__b26043094">Name</strong></p>
+</th>
+<th align="left" class="cellrowborder" valign="top" width="27.27272727272727%" id="mcps1.3.5.2.1.1.2.4.1.2"><p id="rds_19_0001__en-us_topic_0000001766001233_p1921562943717"><strong id="rds_19_0001__b182219552">Type</strong></p>
+</th>
+<th align="left" class="cellrowborder" valign="top" width="39.39393939393939%" id="mcps1.3.5.2.1.1.2.4.1.3"><p id="rds_19_0001__en-us_topic_0000001766001233_p19215152914377"><strong id="rds_19_0001__b1842119108">Description</strong></p>
+</th>
+</tr>
+</thead>
+<tbody><tr id="rds_19_0001__en-us_topic_0000001766001233_row14215182953711"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.1.1.2.4.1.1 "><p id="rds_19_0001__en-us_topic_0000001766001233_p92151229143713">available_versions</p>
+</td>
+<td class="cellrowborder" valign="top" width="27.27272727272727%" headers="mcps1.3.5.2.1.1.2.4.1.2 "><p id="rds_19_0001__en-us_topic_0000001766001233_p521562993719">Array of Strings</p>
+</td>
+<td class="cellrowborder" valign="top" width="39.39393939393939%" headers="mcps1.3.5.2.1.1.2.4.1.3 "><p id="rds_19_0001__en-us_topic_0000001766001233_p1821516299374">Available versions.</p>
+</td>
+</tr>
+</tbody>
+</table>
+</div>
+</li></ul>
+<ul id="rds_19_0001__en-us_topic_0000001766001233_ul62151291374"><li id="rds_19_0001__en-us_topic_0000001766001233_li15215142919371">Example normal response<pre class="screen" id="rds_19_0001__en-us_topic_0000001766001233_screen35476317416">{
+         "available_versions": ["13.9", "14.4"] 
+}</pre>
+</li></ul>
+<ul id="rds_19_0001__en-us_topic_0000001766001233_ul16216929103718"><li id="rds_19_0001__en-us_topic_0000001766001233_li321632923716">Abnormal response<p id="rds_19_0001__en-us_topic_0000001766001233_p112161129143714"><a name="rds_19_0001__en-us_topic_0000001766001233_li321632923716"></a><a name="en-us_topic_0000001766001233_li321632923716"></a>For details, see <a href="en-us_topic_0032488197.html">Abnormal Request Results</a>.</p>
+</li></ul>
+</div>
+<div class="section" id="rds_19_0001__section4778540915440"><h4 class="sectiontitle">Status Code</h4><ul id="rds_19_0001__en-us_topic_0032347778_ul7858132212142"><li id="rds_19_0001__en-us_topic_0032347778_li58581622171411">Normal<p id="rds_19_0001__en-us_topic_0032347778_p1040982941020"><a name="rds_19_0001__en-us_topic_0032347778_li58581622171411"></a><a name="en-us_topic_0032347778_li58581622171411"></a>200</p>
+</li><li id="rds_19_0001__en-us_topic_0032347778_li11583183218149">Abnormal<p id="rds_19_0001__en-us_topic_0032347778_p0723374409"><a name="rds_19_0001__en-us_topic_0032347778_li11583183218149"></a><a name="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_19_0001__section1183074220016"><h4 class="sectiontitle">Error Code</h4><p id="rds_19_0001__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="rds_19_0000.html">Upgrading a Major Version</a></div>
+</div>
+</div>
+