forked from docs/doc-exports
Ru, Li Yi
9d8047332b
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>
254 lines
30 KiB
HTML
254 lines
30 KiB
HTML
<a name="rds_19_0006"></a><a name="rds_19_0006"></a>
|
|
|
|
<h1 class="topictitle1">Querying the Major Version Upgrade History of a DB Instance (RDS for PostgreSQL)</h1>
|
|
<div id="body0000001954633948"><div class="section" id="rds_19_0006__en-us_topic_0000001718121990_section6702162782318"><h4 class="sectiontitle">Function</h4><p id="rds_19_0006__en-us_topic_0000001718121990_p78481927202311">This API is used to query the major version upgrade history.</p>
|
|
<ul id="rds_19_0006__ul16405173211918"><li id="rds_19_0006__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_0006__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_0006__en-us_topic_0000001718121990_section187026272232"><h4 class="sectiontitle">Constraints</h4><ul id="rds_19_0006__en-us_topic_0000001718121990_ul3848162710237"><li id="rds_19_0006__en-us_topic_0000001718121990_li684822792311">This API is available to RDS for PostgreSQL only.</li><li id="rds_19_0006__en-us_topic_0000001718121990_li78481627112312">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_0006__li1347961715304">Major version upgrades are available to the following versions:<ul id="rds_19_0006__ul14404121863013"><li id="rds_19_0006__li14269152120307">RDS for PostgreSQL 12: 12.7 or later</li><li id="rds_19_0006__li07831119142918">RDS for PostgreSQL 13: 13.3 or later</li><li id="rds_19_0006__li121051520124511">RDS for PostgreSQL 14: 14.4 or later</li><li id="rds_19_0006__li733653516126">Major version upgrades are unavailable to RDS for PostgreSQL 11.</li></ul>
|
|
</li><li id="rds_19_0006__li46261533173219">Due to OS restrictions, some instances do not support major version upgrades. To learn which versions your instance can be upgraded to, see the list of available versions on the <a href="rds_19_0001.html">Querying the Target Version to Which a DB Instance Can Be Upgraded (RDS for PostgreSQL)</a>.</li><li id="rds_19_0006__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_0006__en-us_topic_0000001718121990_section137041727202318"><h4 class="sectiontitle">URI</h4><ul id="rds_19_0006__en-us_topic_0000001718121990_ul5849112717237"><li id="rds_19_0006__en-us_topic_0000001718121990_li12849427142318">URI format<p id="rds_19_0006__en-us_topic_0000001718121990_p38497274238"><a name="rds_19_0006__en-us_topic_0000001718121990_li12849427142318"></a><a name="en-us_topic_0000001718121990_li12849427142318"></a>GET /v3/{project_id}/instances/{instance_id}/major-version/upgrade-histories?offset={offset}&limit={limit}&order={order}&sort_field={sort_field}</p>
|
|
</li><li id="rds_19_0006__en-us_topic_0000001718121990_li0849627162312">Parameter description
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="rds_19_0006__en-us_topic_0000001718121990_table1705112714230" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="rds_19_0006__en-us_topic_0000001718121990_row4849122715233"><th align="left" class="cellrowborder" valign="top" width="12.241224122412241%" id="mcps1.3.3.2.2.1.2.5.1.1"><p id="rds_19_0006__en-us_topic_0000001718121990_p1784982716233"><strong id="rds_19_0006__b842352706102328_3">Name</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="12.241224122412241%" id="mcps1.3.3.2.2.1.2.5.1.2"><p id="rds_19_0006__en-us_topic_0000001718121990_p16849132718237"><strong id="rds_19_0006__b842352706164541_1">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="11.221122112211221%" id="mcps1.3.3.2.2.1.2.5.1.3"><p id="rds_19_0006__en-us_topic_0000001718121990_p128491527152315"><strong id="rds_19_0006__b5222105013294">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="64.2964296429643%" id="mcps1.3.3.2.2.1.2.5.1.4"><p id="rds_19_0006__en-us_topic_0000001718121990_p88491227152315"><strong id="rds_19_0006__b842352706163417_3">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="rds_19_0006__en-us_topic_0000001718121990_row884910273238"><td class="cellrowborder" valign="top" width="12.241224122412241%" headers="mcps1.3.3.2.2.1.2.5.1.1 "><p id="rds_19_0006__en-us_topic_0000001718121990_p9849132722313">project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12.241224122412241%" headers="mcps1.3.3.2.2.1.2.5.1.2 "><p id="rds_19_0006__en-us_topic_0000001718121990_p1884919278233">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.221122112211221%" headers="mcps1.3.3.2.2.1.2.5.1.3 "><p id="rds_19_0006__en-us_topic_0000001718121990_p188491227172318">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.2964296429643%" headers="mcps1.3.3.2.2.1.2.5.1.4 "><p id="rds_19_0006__p1434580163733">Project ID of a tenant in a region.</p>
|
|
<p id="rds_19_0006__en-us_topic_0000001718121990_p12849927152318">To obtain it, refer to <a href="rds_03_0002.html">Obtaining a Project ID</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="rds_19_0006__en-us_topic_0000001718121990_row1884982711239"><td class="cellrowborder" valign="top" width="12.241224122412241%" headers="mcps1.3.3.2.2.1.2.5.1.1 "><p id="rds_19_0006__en-us_topic_0000001718121990_p158496272236">instance_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12.241224122412241%" headers="mcps1.3.3.2.2.1.2.5.1.2 "><p id="rds_19_0006__en-us_topic_0000001718121990_p118491727192315">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.221122112211221%" headers="mcps1.3.3.2.2.1.2.5.1.3 "><p id="rds_19_0006__en-us_topic_0000001718121990_p168490273236">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.2964296429643%" headers="mcps1.3.3.2.2.1.2.5.1.4 "><p id="rds_19_0006__en-us_topic_0000001718121990_p13849927102311">Instance ID.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="rds_19_0006__en-us_topic_0000001718121990_row78491227172312"><td class="cellrowborder" valign="top" width="12.241224122412241%" headers="mcps1.3.3.2.2.1.2.5.1.1 "><p id="rds_19_0006__en-us_topic_0000001718121990_p10849112722312">offset</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12.241224122412241%" headers="mcps1.3.3.2.2.1.2.5.1.2 "><p id="rds_19_0006__en-us_topic_0000001718121990_p17850102702318">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.221122112211221%" headers="mcps1.3.3.2.2.1.2.5.1.3 "><p id="rds_19_0006__en-us_topic_0000001718121990_p485019279235">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.2964296429643%" headers="mcps1.3.3.2.2.1.2.5.1.4 "><p id="rds_19_0006__en-us_topic_0000001718121990_p1685014271234">Index offset. If <strong id="rds_19_0006__b157515371307">offset</strong> is set to <em id="rds_19_0006__i12575937133018">N</em>, the resource query starts from the <em id="rds_19_0006__i12575237103017">N</em>+1 piece of data. The value is <strong id="rds_19_0006__b13576737133019">0</strong> by default, indicating that the query starts from the first piece of data. The value must be a number but cannot be a negative number.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="rds_19_0006__en-us_topic_0000001718121990_row11850192732310"><td class="cellrowborder" valign="top" width="12.241224122412241%" headers="mcps1.3.3.2.2.1.2.5.1.1 "><p id="rds_19_0006__en-us_topic_0000001718121990_p385042710238">limit</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12.241224122412241%" headers="mcps1.3.3.2.2.1.2.5.1.2 "><p id="rds_19_0006__en-us_topic_0000001718121990_p14850132742318">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.221122112211221%" headers="mcps1.3.3.2.2.1.2.5.1.3 "><p id="rds_19_0006__en-us_topic_0000001718121990_p1285022742320">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.2964296429643%" headers="mcps1.3.3.2.2.1.2.5.1.4 "><p id="rds_19_0006__en-us_topic_0000001718121990_p5850162742316">Number of query records. The default value is <strong id="rds_19_0006__b132331742193015">10</strong>. The value must be a positive integer. The minimum value is <strong id="rds_19_0006__b132331742163017">1</strong> and the maximum value is <strong id="rds_19_0006__b1023314420309">100</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="rds_19_0006__en-us_topic_0000001718121990_row108505276239"><td class="cellrowborder" valign="top" width="12.241224122412241%" headers="mcps1.3.3.2.2.1.2.5.1.1 "><p id="rds_19_0006__en-us_topic_0000001718121990_p1785042712236">order</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12.241224122412241%" headers="mcps1.3.3.2.2.1.2.5.1.2 "><p id="rds_19_0006__en-us_topic_0000001718121990_p6850182715239">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.221122112211221%" headers="mcps1.3.3.2.2.1.2.5.1.3 "><p id="rds_19_0006__en-us_topic_0000001718121990_p58501927162314">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.2964296429643%" headers="mcps1.3.3.2.2.1.2.5.1.4 "><p id="rds_19_0006__en-us_topic_0000001718121990_p58501827192317">Sorting order.</p>
|
|
<ul id="rds_19_0006__en-us_topic_0000001718121990_ul1928613125342"><li id="rds_19_0006__en-us_topic_0000001718121990_li17286181283419"><strong id="rds_19_0006__b18167134753015">DESC</strong>: descending order</li><li id="rds_19_0006__en-us_topic_0000001718121990_li1428614125345"><strong id="rds_19_0006__b15550102753114">ASC</strong>: ascending order</li><li id="rds_19_0006__en-us_topic_0000001718121990_li1728821233411">Default value: <strong id="rds_19_0006__b0160182914311">desc</strong></li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="rds_19_0006__en-us_topic_0000001718121990_row18850192715232"><td class="cellrowborder" valign="top" width="12.241224122412241%" headers="mcps1.3.3.2.2.1.2.5.1.1 "><p id="rds_19_0006__en-us_topic_0000001718121990_p1385042711234">sort_field</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12.241224122412241%" headers="mcps1.3.3.2.2.1.2.5.1.2 "><p id="rds_19_0006__en-us_topic_0000001718121990_p3850142711233">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.221122112211221%" headers="mcps1.3.3.2.2.1.2.5.1.3 "><p id="rds_19_0006__en-us_topic_0000001718121990_p2850527102311">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.2964296429643%" headers="mcps1.3.3.2.2.1.2.5.1.4 "><p id="rds_19_0006__en-us_topic_0000001718121990_p185022715236">Sorting field.</p>
|
|
<ul id="rds_19_0006__en-us_topic_0000001718121990_ul14724103520340"><li id="rds_19_0006__en-us_topic_0000001718121990_li19724143510345"><strong id="rds_19_0006__b84235270694817">start_time</strong>: specifies the start time.</li><li id="rds_19_0006__en-us_topic_0000001718121990_li5724535123410"><strong id="rds_19_0006__b84235270694837">end_time</strong>: specifies the end time.</li><li id="rds_19_0006__li15618185364116">Default value: <strong id="rds_19_0006__b182671219154119">start_time</strong></li></ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="rds_19_0006__en-us_topic_0000001718121990_section2071962732315"><h4 class="sectiontitle">Request</h4><ul id="rds_19_0006__en-us_topic_0000001718121990_ul17850152752310"><li id="rds_19_0006__en-us_topic_0000001718121990_li168507270237">Request parameters<p id="rds_19_0006__en-us_topic_0000001718121990_p1850112752310"><a name="rds_19_0006__en-us_topic_0000001718121990_li168507270237"></a><a name="en-us_topic_0000001718121990_li168507270237"></a>None</p>
|
|
</li><li id="rds_19_0006__en-us_topic_0000001718121990_li3850152762318">URI example<pre class="screen" id="rds_19_0006__en-us_topic_0000001718121990_screen10327114712348">https://<em id="rds_19_0006__en-us_topic_0000001718121990_i45697545346">{Endpoint}</em>/v3/0483b6b16e954cb88930a360d2c4e663/instances/3aa441c4c98a4b36b100a7e3e87d17cein03/major-version/upgrade-histories?offset=0&limit=10</pre>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="rds_19_0006__en-us_topic_0000001718121990_section20720927172315"><h4 class="sectiontitle">Response</h4><ul id="rds_19_0006__en-us_topic_0000001718121990_ul18508274238"><li id="rds_19_0006__en-us_topic_0000001718121990_li11851152713230">Normal response
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="rds_19_0006__en-us_topic_0000001718121990_table1672362732315" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Parameter description</caption><thead align="left"><tr id="rds_19_0006__en-us_topic_0000001718121990_row685142782311"><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_0006__en-us_topic_0000001718121990_p98511227112312"><strong id="rds_19_0006__b1672176642">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_0006__en-us_topic_0000001718121990_p198511627102310"><strong id="rds_19_0006__b1905246654">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_0006__en-us_topic_0000001718121990_p3851152712235"><strong id="rds_19_0006__b1607981957">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="rds_19_0006__en-us_topic_0000001718121990_row1085162715234"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.1.1.2.4.1.1 "><p id="rds_19_0006__en-us_topic_0000001718121990_p158511827112314">total_count</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_0006__en-us_topic_0000001718121990_p4851102713239">Integer</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_0006__en-us_topic_0000001718121990_p178511227192311">Total number of records.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="rds_19_0006__en-us_topic_0000001718121990_row38511527152317"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.1.1.2.4.1.1 "><p id="rds_19_0006__en-us_topic_0000001718121990_p11851627132317">upgrade_reports</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_0006__en-us_topic_0000001718121990_p58511276234">Array of objects</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_0006__en-us_topic_0000001718121990_p1785110273234">Upgrade report details.</p>
|
|
<p id="rds_19_0006__en-us_topic_0000001718121990_p1285112712320">For details, see <a href="#rds_19_0006__en-us_topic_0000001718121990_table972752710237">Table 3</a>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="rds_19_0006__en-us_topic_0000001718121990_table972752710237"></a><a name="en-us_topic_0000001718121990_table972752710237"></a><table cellpadding="4" cellspacing="0" summary="" id="rds_19_0006__en-us_topic_0000001718121990_table972752710237" frame="border" border="1" rules="all"><caption><b>Table 3 </b>upgrade_report field data structure description</caption><thead align="left"><tr id="rds_19_0006__en-us_topic_0000001718121990_row2085118274233"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.5.2.1.2.2.4.1.1"><p id="rds_19_0006__en-us_topic_0000001718121990_p1085116272238"><strong id="rds_19_0006__b614871650">Name</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="27.27272727272727%" id="mcps1.3.5.2.1.2.2.4.1.2"><p id="rds_19_0006__en-us_topic_0000001718121990_p28511277231"><strong id="rds_19_0006__b2139743034">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="39.39393939393939%" id="mcps1.3.5.2.1.2.2.4.1.3"><p id="rds_19_0006__en-us_topic_0000001718121990_p885182772311"><strong id="rds_19_0006__b842352706163417_5">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="rds_19_0006__en-us_topic_0000001718121990_row4851152713234"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.1.2.2.4.1.1 "><p id="rds_19_0006__en-us_topic_0000001718121990_p385110277237">id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.27272727272727%" headers="mcps1.3.5.2.1.2.2.4.1.2 "><p id="rds_19_0006__en-us_topic_0000001718121990_p18851102712235">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.39393939393939%" headers="mcps1.3.5.2.1.2.2.4.1.3 "><p id="rds_19_0006__en-us_topic_0000001718121990_p19852192710230">Upgrade report ID.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="rds_19_0006__en-us_topic_0000001718121990_row7852827162314"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.1.2.2.4.1.1 "><p id="rds_19_0006__en-us_topic_0000001718121990_p285292772312">start_time</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.27272727272727%" headers="mcps1.3.5.2.1.2.2.4.1.2 "><p id="rds_19_0006__en-us_topic_0000001718121990_p15852112752314">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.39393939393939%" headers="mcps1.3.5.2.1.2.2.4.1.3 "><p id="rds_19_0006__en-us_topic_0000001718121990_p12852152714230">Upgrade start time in the "yyyy-mm-ddThh:mm:ssZ" format.</p>
|
|
<p id="rds_19_0006__en-us_topic_0000001718121990_p14852172713231"><strong id="rds_19_0006__b1566144203215">T</strong> is the separator between the calendar and the hourly notation of time. <strong id="rds_19_0006__b3566114253214">Z</strong> indicates the time zone offset. For example, if the time zone offset is one hour, the value of <strong id="rds_19_0006__b956624293211">Z</strong> is <strong id="rds_19_0006__b12567204203216">+0100</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="rds_19_0006__en-us_topic_0000001718121990_row6852192702310"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.1.2.2.4.1.1 "><p id="rds_19_0006__en-us_topic_0000001718121990_p158522277236">end_time</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.27272727272727%" headers="mcps1.3.5.2.1.2.2.4.1.2 "><p id="rds_19_0006__en-us_topic_0000001718121990_p1985202792312">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.39393939393939%" headers="mcps1.3.5.2.1.2.2.4.1.3 "><p id="rds_19_0006__en-us_topic_0000001718121990_p13852227162319">Upgrade end time in the "yyyy-mm-ddThh:mm:ssZ" format.</p>
|
|
<p id="rds_19_0006__en-us_topic_0000001718121990_p58521277234"><strong id="rds_19_0006__b24751568326">T</strong> is the separator between the calendar and the hourly notation of time. <strong id="rds_19_0006__b347595633213">Z</strong> indicates the time zone offset. For example, if the time zone offset is one hour, the value of <strong id="rds_19_0006__b134751562329">Z</strong> is <strong id="rds_19_0006__b947505613322">+0100</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="rds_19_0006__en-us_topic_0000001718121990_row10852192710235"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.1.2.2.4.1.1 "><p id="rds_19_0006__en-us_topic_0000001718121990_p185202702313">src_instance_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.27272727272727%" headers="mcps1.3.5.2.1.2.2.4.1.2 "><p id="rds_19_0006__en-us_topic_0000001718121990_p138521727192313">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.39393939393939%" headers="mcps1.3.5.2.1.2.2.4.1.3 "><p id="rds_19_0006__en-us_topic_0000001718121990_p148523279231">Source instance ID.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="rds_19_0006__en-us_topic_0000001718121990_row108521827152318"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.1.2.2.4.1.1 "><p id="rds_19_0006__en-us_topic_0000001718121990_p18852102732312">src_database_version</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.27272727272727%" headers="mcps1.3.5.2.1.2.2.4.1.2 "><p id="rds_19_0006__en-us_topic_0000001718121990_p11852127162313">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.39393939393939%" headers="mcps1.3.5.2.1.2.2.4.1.3 "><p id="rds_19_0006__en-us_topic_0000001718121990_p178522272230">Source instance version.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="rds_19_0006__en-us_topic_0000001718121990_row6852122712234"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.1.2.2.4.1.1 "><p id="rds_19_0006__en-us_topic_0000001718121990_p88521827182313">dst_instance_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.27272727272727%" headers="mcps1.3.5.2.1.2.2.4.1.2 "><p id="rds_19_0006__en-us_topic_0000001718121990_p108528279237">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.39393939393939%" headers="mcps1.3.5.2.1.2.2.4.1.3 "><p id="rds_19_0006__en-us_topic_0000001718121990_p9852122732319">Target instance ID.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="rds_19_0006__en-us_topic_0000001718121990_row8852427162314"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.1.2.2.4.1.1 "><p id="rds_19_0006__en-us_topic_0000001718121990_p385222710238">dst_database_version</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.27272727272727%" headers="mcps1.3.5.2.1.2.2.4.1.2 "><p id="rds_19_0006__en-us_topic_0000001718121990_p6852172712310">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.39393939393939%" headers="mcps1.3.5.2.1.2.2.4.1.3 "><p id="rds_19_0006__en-us_topic_0000001718121990_p178532027132311">Target instance version.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="rds_19_0006__en-us_topic_0000001718121990_row16853192719235"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.1.2.2.4.1.1 "><p id="rds_19_0006__en-us_topic_0000001718121990_p4853122762316">result</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.27272727272727%" headers="mcps1.3.5.2.1.2.2.4.1.2 "><p id="rds_19_0006__en-us_topic_0000001718121990_p1485372762310">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.39393939393939%" headers="mcps1.3.5.2.1.2.2.4.1.3 "><p id="rds_19_0006__en-us_topic_0000001718121990_p68531127142312">Upgrade result.</p>
|
|
<ul id="rds_19_0006__en-us_topic_0000001718121990_ul14224548143519"><li id="rds_19_0006__en-us_topic_0000001718121990_li622454812351"><strong id="rds_19_0006__b412313349335">success</strong>: The upgrade is successful.</li><li id="rds_19_0006__en-us_topic_0000001718121990_li17224148183518"><strong id="rds_19_0006__b9416538103315">failed</strong>: The upgrade fails.</li><li id="rds_19_0006__en-us_topic_0000001718121990_li922416485356"><strong id="rds_19_0006__b264304273317">running</strong>: The upgrade is in progress.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="rds_19_0006__en-us_topic_0000001718121990_row88531272231"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.1.2.2.4.1.1 "><p id="rds_19_0006__en-us_topic_0000001718121990_p1285311275238">is_private_ip_changed</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.27272727272727%" headers="mcps1.3.5.2.1.2.2.4.1.2 "><p id="rds_19_0006__en-us_topic_0000001718121990_p4853027122310">Boolean</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.39393939393939%" headers="mcps1.3.5.2.1.2.2.4.1.3 "><p id="rds_19_0006__en-us_topic_0000001718121990_p2853182719239">Whether to switch the floating IP address of the source instance to the target instance.</p>
|
|
<ul id="rds_19_0006__en-us_topic_0000001718121990_ul166435823514"><li id="rds_19_0006__en-us_topic_0000001718121990_li176495815356"><strong id="rds_19_0006__b157411748163317">true</strong>: indicates that the floating IP address of the source instance will be switched to the target instance.</li><li id="rds_19_0006__en-us_topic_0000001718121990_li18642585353"><strong id="rds_19_0006__b63681115113418">false</strong>: indicates that the floating IP address of the source instance will not be switched to the target instance.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="rds_19_0006__en-us_topic_0000001718121990_row108532027162315"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.1.2.2.4.1.1 "><p id="rds_19_0006__en-us_topic_0000001718121990_p158531527122311">private_ip_change_time</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.27272727272727%" headers="mcps1.3.5.2.1.2.2.4.1.2 "><p id="rds_19_0006__en-us_topic_0000001718121990_p1385316273233">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.39393939393939%" headers="mcps1.3.5.2.1.2.2.4.1.3 "><p id="rds_19_0006__en-us_topic_0000001718121990_p1185332717234">Time when the floating IP address is changed. The format is yyyy-mm-ddThh:mm:ssZ.</p>
|
|
<p id="rds_19_0006__en-us_topic_0000001718121990_p198531227112316"><strong id="rds_19_0006__b175152223512">T</strong> is the separator between the calendar and the hourly notation of time. <strong id="rds_19_0006__b115159283513">Z</strong> indicates the time zone offset. For example, if the time zone offset is one hour, the value of <strong id="rds_19_0006__b35154215359">Z</strong> is <strong id="rds_19_0006__b1151514223511">+0100</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="rds_19_0006__en-us_topic_0000001718121990_row185312274233"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.1.2.2.4.1.1 "><p id="rds_19_0006__en-us_topic_0000001718121990_p17853827112316">statistics_collection_mode</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.27272727272727%" headers="mcps1.3.5.2.1.2.2.4.1.2 "><p id="rds_19_0006__en-us_topic_0000001718121990_p985332792310">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.39393939393939%" headers="mcps1.3.5.2.1.2.2.4.1.3 "><p id="rds_19_0006__en-us_topic_0000001718121990_p208536273233">When to collect statistics.</p>
|
|
<ul id="rds_19_0006__en-us_topic_0000001718121990_ul85331311103612"><li id="rds_19_0006__en-us_topic_0000001718121990_li10534101116364"><strong id="rds_19_0006__b138921229173510">before_change_private_ip</strong>: Statistics are collected before the floating IP address is changed.</li><li id="rds_19_0006__en-us_topic_0000001718121990_li6534201110360"><strong id="rds_19_0006__b11288195818352">after_change_private_ip</strong>: Statistics are collected after the floating IP address is changed.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="rds_19_0006__en-us_topic_0000001718121990_row19853102712313"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.1.2.2.4.1.1 "><p id="rds_19_0006__en-us_topic_0000001718121990_p12853112742316">detail</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.27272727272727%" headers="mcps1.3.5.2.1.2.2.4.1.2 "><p id="rds_19_0006__en-us_topic_0000001718121990_p178535278233">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.39393939393939%" headers="mcps1.3.5.2.1.2.2.4.1.3 "><p id="rds_19_0006__en-us_topic_0000001718121990_p485362702311">Upgrade report details.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
<ul id="rds_19_0006__en-us_topic_0000001718121990_ul88549274231"><li id="rds_19_0006__en-us_topic_0000001718121990_li1685482712239">Example normal response<pre class="screen" id="rds_19_0006__en-us_topic_0000001718121990_screen13922036173616">{
|
|
"total_count": 1,
|
|
"upgrade_reports": [
|
|
{
|
|
"id": "1a8fda5a-17a6-ebc4-bf1f-97ae837f432b",
|
|
"start_time": "2023-03-06T02:45:49+0800",
|
|
"end_time": "2023-03-06T02:50:49+0800",
|
|
"src_instance_id": "dccacebb7b884ee18bc5c02c918ef2b0in03",
|
|
"src_database_version": "13.9",
|
|
"dst_instance_id": "6b5750504be1403191c4f00e4ffaee5ein03",
|
|
"dst_database_version": "14.6",
|
|
"result": "success",
|
|
"is_private_ip_changed": true,
|
|
"private_ip_change_time": "2023-03-06T03:10:49+0800",
|
|
"statistics_collection_mode": "before_change_private_ip",
|
|
"detail": "2023-03-06 18:33:26 --- pg_upgrade upgrade task begin"
|
|
}
|
|
]
|
|
}</pre>
|
|
</li></ul>
|
|
<ul id="rds_19_0006__en-us_topic_0000001718121990_ul1385415275239"><li id="rds_19_0006__en-us_topic_0000001718121990_li585414279230">Abnormal response<p id="rds_19_0006__en-us_topic_0000001718121990_p28544273233"><a name="rds_19_0006__en-us_topic_0000001718121990_li585414279230"></a><a name="en-us_topic_0000001718121990_li585414279230"></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_0006__section4778540915440"><h4 class="sectiontitle">Status Code</h4><ul id="rds_19_0006__en-us_topic_0032347778_ul7858132212142"><li id="rds_19_0006__en-us_topic_0032347778_li58581622171411">Normal<p id="rds_19_0006__en-us_topic_0032347778_p1040982941020"><a name="rds_19_0006__en-us_topic_0032347778_li58581622171411"></a><a name="en-us_topic_0032347778_li58581622171411"></a>200</p>
|
|
</li><li id="rds_19_0006__en-us_topic_0032347778_li11583183218149">Abnormal<p id="rds_19_0006__en-us_topic_0032347778_p0723374409"><a name="rds_19_0006__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_0006__section1183074220016"><h4 class="sectiontitle">Error Code</h4><p id="rds_19_0006__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>
|
|
|