doc-exports/docs/rds/api-ref/en-us_topic_0032347784.html
Ru, Li Yi 9457035d64 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>
2024-07-03 08:42:51 +00:00

120 lines
9.8 KiB
HTML

<a name="en-us_topic_0032347784"></a><a name="en-us_topic_0032347784"></a>
<h1 class="topictitle1">Obtaining Specified DB Instance Specifications</h1>
<div id="body32010697"><div class="section" id="en-us_topic_0032347784__section36902586"><h4 class="sectiontitle">Function</h4><p id="en-us_topic_0032347784__p42729680">This API is used to obtain DB instance specifications of a specified specification ID.</p>
</div>
<div class="section" id="en-us_topic_0032347784__section63687823"><h4 class="sectiontitle">URI</h4><ul id="en-us_topic_0032347784__ul38552084"><li id="en-us_topic_0032347784__li11424440">URI format<p id="en-us_topic_0032347784__p35711100"><a name="en-us_topic_0032347784__li11424440"></a><a name="li11424440"></a>PATH: /rds/v1/{project_id}/flavors/{flavorId}</p>
<p id="en-us_topic_0032347784__p27600572154519">Method: GET</p>
</li><li id="en-us_topic_0032347784__li52964449">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0032347784__table6918001" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="en-us_topic_0032347784__row17531178"><th align="left" class="cellrowborder" valign="top" width="22.05%" id="mcps1.3.2.2.2.1.2.4.1.1"><p id="en-us_topic_0032347784__p10739296"><strong id="en-us_topic_0032347784__b842352706102328_1">Name</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="27.700000000000003%" id="mcps1.3.2.2.2.1.2.4.1.2"><p id="en-us_topic_0032347784__p64576684"><strong id="en-us_topic_0032347784__b842352706102346_1">Mandatory</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50.24999999999999%" id="mcps1.3.2.2.2.1.2.4.1.3"><p id="en-us_topic_0032347784__p63328883"><strong id="en-us_topic_0032347784__b842352706163417_1">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="en-us_topic_0032347784__row29365919"><td class="cellrowborder" valign="top" width="22.05%" headers="mcps1.3.2.2.2.1.2.4.1.1 "><p id="en-us_topic_0032347784__p29829272">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="27.700000000000003%" headers="mcps1.3.2.2.2.1.2.4.1.2 "><p id="en-us_topic_0032347784__p251973">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="50.24999999999999%" headers="mcps1.3.2.2.2.1.2.4.1.3 "><p id="en-us_topic_0032347784__p20409871">Specifies the project ID of a tenant in a region.</p>
</td>
</tr>
<tr id="en-us_topic_0032347784__row49471114"><td class="cellrowborder" valign="top" width="22.05%" headers="mcps1.3.2.2.2.1.2.4.1.1 "><p id="en-us_topic_0032347784__p47737289">flavorId</p>
</td>
<td class="cellrowborder" valign="top" width="27.700000000000003%" headers="mcps1.3.2.2.2.1.2.4.1.2 "><p id="en-us_topic_0032347784__p41515225">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="50.24999999999999%" headers="mcps1.3.2.2.2.1.2.4.1.3 "><p id="en-us_topic_0032347784__p7290082">Specifies the specification ID compliant with the UUID format.</p>
<p id="en-us_topic_0032347784__p51126387153724">For details about how to obtain this parameter value, see <strong id="en-us_topic_0032347784__b842352706195521">flavors.id</strong> in the response message in <a href="en-us_topic_0032347783.html">Obtaining All DB Instance Specifications</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
<div class="section" id="en-us_topic_0032347784__section36319496"><h4 class="sectiontitle">Request</h4><p id="en-us_topic_0032347784__p10263773">None</p>
</div>
<div class="section" id="en-us_topic_0032347784__section58440016"><h4 class="sectiontitle">Normal Response</h4><ul id="en-us_topic_0032347784__ul26059286"><li id="en-us_topic_0032347784__li33206990">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0032347784__table30427456" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Parameter description</caption><thead align="left"><tr id="en-us_topic_0032347784__row47542385"><th align="left" class="cellrowborder" valign="top" width="21.68%" id="mcps1.3.4.2.1.1.2.4.1.1"><p id="en-us_topic_0032347784__p25727981"><strong id="en-us_topic_0032347784__b842352706102328_5">Name</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="27.689999999999998%" id="mcps1.3.4.2.1.1.2.4.1.2"><p id="en-us_topic_0032347784__p3591713"><strong id="en-us_topic_0032347784__b842352706164541_1">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50.629999999999995%" id="mcps1.3.4.2.1.1.2.4.1.3"><p id="en-us_topic_0032347784__p22493366"><strong id="en-us_topic_0032347784__b842352706163417_5">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="en-us_topic_0032347784__row10023380"><td class="cellrowborder" valign="top" width="21.68%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="en-us_topic_0032347784__p6587426">flavor</p>
</td>
<td class="cellrowborder" valign="top" width="27.689999999999998%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="en-us_topic_0032347784__p63819464">List data structure. For details, see <a href="#en-us_topic_0032347784__table64140254">Table 3</a>.</p>
</td>
<td class="cellrowborder" valign="top" width="50.629999999999995%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="en-us_topic_0032347784__p17946858">Indicates the DB instance specifications information list.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="en-us_topic_0032347784__table64140254"></a><a name="table64140254"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0032347784__table64140254" frame="border" border="1" rules="all"><caption><b>Table 3 </b>flavor field data structure description</caption><thead align="left"><tr id="en-us_topic_0032347784__row21591473"><th align="left" class="cellrowborder" valign="top" width="21.87%" id="mcps1.3.4.2.1.2.2.4.1.1"><p id="en-us_topic_0032347784__p4078883"><strong id="en-us_topic_0032347784__b842352706102328_7">Name</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="27.700000000000003%" id="mcps1.3.4.2.1.2.2.4.1.2"><p id="en-us_topic_0032347784__p61954093"><strong id="en-us_topic_0032347784__b842352706164541_3">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50.43%" id="mcps1.3.4.2.1.2.2.4.1.3"><p id="en-us_topic_0032347784__p52225656"><strong id="en-us_topic_0032347784__b842352706163417_7">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="en-us_topic_0032347784__row2419756"><td class="cellrowborder" valign="top" width="21.87%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="en-us_topic_0032347784__p61782511">id</p>
</td>
<td class="cellrowborder" valign="top" width="27.700000000000003%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="en-us_topic_0032347784__p38327532">String</p>
</td>
<td class="cellrowborder" valign="top" width="50.43%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="en-us_topic_0032347784__p17522377">Indicates the specification ID. Its value is unique.</p>
</td>
</tr>
<tr id="en-us_topic_0032347784__row23483667"><td class="cellrowborder" valign="top" width="21.87%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="en-us_topic_0032347784__p23128868">name</p>
</td>
<td class="cellrowborder" valign="top" width="27.700000000000003%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="en-us_topic_0032347784__p61498985">String</p>
</td>
<td class="cellrowborder" valign="top" width="50.43%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="en-us_topic_0032347784__p15361866">Indicates the specification item name.</p>
</td>
</tr>
<tr id="en-us_topic_0032347784__row4039073"><td class="cellrowborder" valign="top" width="21.87%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="en-us_topic_0032347784__p58729529">ram</p>
</td>
<td class="cellrowborder" valign="top" width="27.700000000000003%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="en-us_topic_0032347784__p59471393">Int</p>
</td>
<td class="cellrowborder" valign="top" width="50.43%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="en-us_topic_0032347784__p52453505">Indicates the memory size in megabytes (MB).</p>
</td>
</tr>
<tr id="en-us_topic_0032347784__row51398059195617"><td class="cellrowborder" valign="top" width="21.87%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="en-us_topic_0032347784__p6098035195618">specCode</p>
</td>
<td class="cellrowborder" valign="top" width="27.700000000000003%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="en-us_topic_0032347784__p24178835195618">String</p>
</td>
<td class="cellrowborder" valign="top" width="50.43%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="en-us_topic_0032347784__p12328599195618">Indicates the resource specifications code.</p>
<p id="en-us_topic_0032347784__p39382216112854">Use <strong id="en-us_topic_0032347784__b842352706171033">rds.mysql.n1.xlarge</strong> as an example.</p>
<p id="en-us_topic_0032347784__p43848530195618"><strong id="en-us_topic_0032347784__b842352706163930">rds</strong> indicates RDS, <strong id="en-us_topic_0032347784__b842352706163952">mysql</strong> indicates the DB engine, and <strong id="en-us_topic_0032347784__b84235270616408">n1.xlarge</strong> indicates the performance specification (large-memory). </p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
<ul id="en-us_topic_0032347784__ul20875522"><li id="en-us_topic_0032347784__li53661974">Response example<pre class="codeblock" id="en-us_topic_0032347784__codeblock1332144917839">{
"flavor": {
"id": "f7f51f85-cfcd-4409-ae91-b3eae186d0ea",
"name": "OTC_MYLM_XLARGE",
"ram": 32768,
"specCode": "rds.mysql.n1.xlarge"
}
}</pre>
</li></ul>
</div>
<div class="section" id="en-us_topic_0032347784__section56198103"><h4 class="sectiontitle">Abnormal Response</h4><p id="en-us_topic_0032347784__p1579110">For details, see <a href="en-us_topic_0032488197.html">Abnormal Request Results</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rds_06_0016.html">DB Instance Management</a></div>
</div>
</div>