doc-exports/docs/ecs/api-ref/en-us_topic_0065817716.html
Zaoxu, Li 4edaa4a4cc ECS API 20231016 version
Reviewed-by: Pristromskaia, Margarita <margarita.pristromskaia@t-systems.com>
Co-authored-by: Zaoxu, Li <lizaoxu@huawei.com>
Co-committed-by: Zaoxu, Li <lizaoxu@huawei.com>
2024-04-29 11:04:13 +00:00

209 lines
18 KiB
HTML

<a name="EN-US_TOPIC_0065817716"></a><a name="EN-US_TOPIC_0065817716"></a>
<h1 class="topictitle1">Querying Default Quotas</h1>
<div id="body1499652824862"><div class="section" id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_section4302370"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p23244830">This API is used to query default quotas.</p>
</div>
<div class="section" id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_section38721337"><h4 class="sectiontitle">URI</h4><p id="EN-US_TOPIC_0065817716__p9873181410416">GET /v2.1/{project_id}/os-quota-sets/{project_id}/defaults</p>
<p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p8665112023416">GET /v2/{project_id}/os-quota-sets/{project_id}/defaults</p>
<div class="p" id="EN-US_TOPIC_0065817716__p1961180123915"><a href="#EN-US_TOPIC_0065817716__en-us_topic_0057973201_table258804192629">Table 1</a> describes the parameters in the URI.
<div class="tablenoborder"><a name="EN-US_TOPIC_0065817716__en-us_topic_0057973201_table258804192629"></a><a name="en-us_topic_0057973201_table258804192629"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_table258804192629" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_row33277594192629"><th align="left" class="cellrowborder" valign="top" width="20.69%" id="mcps1.3.2.4.2.2.4.1.1"><p id="EN-US_TOPIC_0065817716__p5187119">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="13.79%" id="mcps1.3.2.4.2.2.4.1.2"><p id="EN-US_TOPIC_0065817716__p17503500">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="65.52%" id="mcps1.3.2.4.2.2.4.1.3"><p id="EN-US_TOPIC_0065817716__p8497414">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_row56232837192629"><td class="cellrowborder" valign="top" width="20.69%" headers="mcps1.3.2.4.2.2.4.1.1 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p58565959192629">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="13.79%" headers="mcps1.3.2.4.2.2.4.1.2 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p46222262192629">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="65.52%" headers="mcps1.3.2.4.2.2.4.1.3 "><p id="EN-US_TOPIC_0065817716__p37593705">Specifies the project ID.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_section42132238"><h4 class="sectiontitle">Request</h4><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p31019962">None</p>
</div>
<div class="section" id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_section43645827"><h4 class="sectiontitle">Response</h4><p id="EN-US_TOPIC_0065817716__p2816103217396"><a href="#EN-US_TOPIC_0065817716__en-us_topic_0057973201_en-us_topic_0057973197_table62068690">Table 2</a> describes the response parameters.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0065817716__en-us_topic_0057973201_en-us_topic_0057973197_table62068690"></a><a name="en-us_topic_0057973201_en-us_topic_0057973197_table62068690"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_en-us_topic_0057973197_table62068690" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Response parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_en-us_topic_0057973197_row56098908"><th align="left" class="cellrowborder" valign="top" width="30.643064306430645%" id="mcps1.3.4.3.2.4.1.1"><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973197_p47717737">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="30.643064306430645%" id="mcps1.3.4.3.2.4.1.2"><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973197_p39931478">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="38.71387138713872%" id="mcps1.3.4.3.2.4.1.3"><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973197_p64532721">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_en-us_topic_0057973197_row59767919"><td class="cellrowborder" valign="top" width="30.643064306430645%" headers="mcps1.3.4.3.2.4.1.1 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_en-us_topic_0057973197_p9363310">quota_set</p>
</td>
<td class="cellrowborder" valign="top" width="30.643064306430645%" headers="mcps1.3.4.3.2.4.1.2 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_en-us_topic_0057973197_p20230678">Object</p>
</td>
<td class="cellrowborder" valign="top" width="38.71387138713872%" headers="mcps1.3.4.3.2.4.1.3 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_en-us_topic_0057973197_p59256190">Specifies the <strong id="EN-US_TOPIC_0065817716__b01577448512">quota_set</strong> object. For details, see <a href="#EN-US_TOPIC_0065817716__en-us_topic_0057973201_table29589013">Table 3</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="tablenoborder"><a name="EN-US_TOPIC_0065817716__en-us_topic_0057973201_table29589013"></a><a name="en-us_topic_0057973201_table29589013"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_table29589013" frame="border" border="1" rules="all"><caption><b>Table 3 </b><strong id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_b842352706145746">quota_set</strong> parameter description</caption><thead align="left"><tr id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_row16562342"><th align="left" class="cellrowborder" valign="top" width="34.44344434443444%" id="mcps1.3.5.2.4.1.1"><p id="EN-US_TOPIC_0065817716__p6588045163210">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="21.112111211121114%" id="mcps1.3.5.2.4.1.2"><p id="EN-US_TOPIC_0065817716__p15588245163210">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="44.44444444444445%" id="mcps1.3.5.2.4.1.3"><p id="EN-US_TOPIC_0065817716__p5588145183211">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_row28465510"><td class="cellrowborder" valign="top" width="34.44344434443444%" headers="mcps1.3.5.2.4.1.1 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p24004958">cores</p>
</td>
<td class="cellrowborder" valign="top" width="21.112111211121114%" headers="mcps1.3.5.2.4.1.2 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p72501227151510">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="44.44444444444445%" headers="mcps1.3.5.2.4.1.3 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973199_p47666411392">Specifies the quantity quota of vCPUs.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_row26136320"><td class="cellrowborder" valign="top" width="34.44344434443444%" headers="mcps1.3.5.2.4.1.1 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p36667161">fixed_ips</p>
</td>
<td class="cellrowborder" valign="top" width="21.112111211121114%" headers="mcps1.3.5.2.4.1.2 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p186841317111619">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="44.44444444444445%" headers="mcps1.3.5.2.4.1.3 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973199_p7766144103912">Specifies the quantity quota of fixed IP addresses. This parameter is not supported.</p>
<p id="EN-US_TOPIC_0065817716__p864017413393">This parameter is not supported in microversion 2.36 and later.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_row20639791"><td class="cellrowborder" valign="top" width="34.44344434443444%" headers="mcps1.3.5.2.4.1.1 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p61210371">floating_ips</p>
</td>
<td class="cellrowborder" valign="top" width="21.112111211121114%" headers="mcps1.3.5.2.4.1.2 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p3913118111613">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="44.44444444444445%" headers="mcps1.3.5.2.4.1.3 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973199_p16766740399">Specifies the quantity quota of floating IP addresses. This parameter is not supported.</p>
<p id="EN-US_TOPIC_0065817716__p7399125517139">This parameter is not supported in microversion 2.36 and later.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_row60052996"><td class="cellrowborder" valign="top" width="34.44344434443444%" headers="mcps1.3.5.2.4.1.1 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p32454526">id</p>
</td>
<td class="cellrowborder" valign="top" width="21.112111211121114%" headers="mcps1.3.5.2.4.1.2 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p11570940">String</p>
</td>
<td class="cellrowborder" valign="top" width="44.44444444444445%" headers="mcps1.3.5.2.4.1.3 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973199_p107671041392">Specifies the project UUID.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_row17123161"><td class="cellrowborder" valign="top" width="34.44344434443444%" headers="mcps1.3.5.2.4.1.1 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p44798770">injected_file_content_bytes</p>
</td>
<td class="cellrowborder" valign="top" width="21.112111211121114%" headers="mcps1.3.5.2.4.1.2 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p158711821181614">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="44.44444444444445%" headers="mcps1.3.5.2.4.1.3 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973199_p19767154163911">Specifies the size quota (bytes) of the files to be injected.</p>
<p id="EN-US_TOPIC_0065817716__p145744641219">This parameter is not supported in microversion 2.57 and later.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_row41672973"><td class="cellrowborder" valign="top" width="34.44344434443444%" headers="mcps1.3.5.2.4.1.1 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p20067663">injected_file_path_bytes</p>
</td>
<td class="cellrowborder" valign="top" width="21.112111211121114%" headers="mcps1.3.5.2.4.1.2 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p619932461614">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="44.44444444444445%" headers="mcps1.3.5.2.4.1.3 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973199_p1176715413396">Specifies the size quota (bytes) of the path for the files to be injected.</p>
<p id="EN-US_TOPIC_0065817716__p85781638204113">This parameter is not supported in microversion 2.57 and later.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_row24170571"><td class="cellrowborder" valign="top" width="34.44344434443444%" headers="mcps1.3.5.2.4.1.1 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p11659216">injected_files</p>
</td>
<td class="cellrowborder" valign="top" width="21.112111211121114%" headers="mcps1.3.5.2.4.1.2 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p967412256162">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="44.44444444444445%" headers="mcps1.3.5.2.4.1.3 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973199_p9767246391">Specifies the quantity quota of the files to be injected.</p>
<p id="EN-US_TOPIC_0065817716__p810984210419">This parameter is not supported in microversion 2.57 and later.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_row17870531"><td class="cellrowborder" valign="top" width="34.44344434443444%" headers="mcps1.3.5.2.4.1.1 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p38226869">instances</p>
</td>
<td class="cellrowborder" valign="top" width="21.112111211121114%" headers="mcps1.3.5.2.4.1.2 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p1375472610167">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="44.44444444444445%" headers="mcps1.3.5.2.4.1.3 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973199_p1876714183917">Specifies the quantity quota of <span id="EN-US_TOPIC_0065817716__text117356119527">ECS</span>s.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_row34050285"><td class="cellrowborder" valign="top" width="34.44344434443444%" headers="mcps1.3.5.2.4.1.1 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p6609735">key_pairs</p>
</td>
<td class="cellrowborder" valign="top" width="21.112111211121114%" headers="mcps1.3.5.2.4.1.2 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p18933527131610">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="44.44444444444445%" headers="mcps1.3.5.2.4.1.3 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973199_p1876716493911">Specifies the quota of key pairs. This parameter is not supported.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_row48158284"><td class="cellrowborder" valign="top" width="34.44344434443444%" headers="mcps1.3.5.2.4.1.1 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p8506968">metadata_items</p>
</td>
<td class="cellrowborder" valign="top" width="21.112111211121114%" headers="mcps1.3.5.2.4.1.2 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p616716297166">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="44.44444444444445%" headers="mcps1.3.5.2.4.1.3 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973199_p187671742393">Specifies the metadata quantity quota.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_row57789353"><td class="cellrowborder" valign="top" width="34.44344434443444%" headers="mcps1.3.5.2.4.1.1 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p50425983">ram</p>
</td>
<td class="cellrowborder" valign="top" width="21.112111211121114%" headers="mcps1.3.5.2.4.1.2 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p45674313166">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="44.44444444444445%" headers="mcps1.3.5.2.4.1.3 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973199_p17670483911">Specifies the memory quota (MB).</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_row14036819"><td class="cellrowborder" valign="top" width="34.44344434443444%" headers="mcps1.3.5.2.4.1.1 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p63240543">security_group_rules</p>
</td>
<td class="cellrowborder" valign="top" width="21.112111211121114%" headers="mcps1.3.5.2.4.1.2 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p996283313164">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="44.44444444444445%" headers="mcps1.3.5.2.4.1.3 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973199_p97671453913">Specifies the quota of security group rules. This parameter is not supported.</p>
<p id="EN-US_TOPIC_0065817716__p17933151191416">This parameter is not supported in microversion 2.36 and later.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_row55715684"><td class="cellrowborder" valign="top" width="34.44344434443444%" headers="mcps1.3.5.2.4.1.1 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p16676575">security_groups</p>
</td>
<td class="cellrowborder" valign="top" width="21.112111211121114%" headers="mcps1.3.5.2.4.1.2 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p897113510165">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="44.44444444444445%" headers="mcps1.3.5.2.4.1.3 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973199_p10769114153919">Specifies the quota of security groups. This parameter is not supported.</p>
<p id="EN-US_TOPIC_0065817716__p114411611140">This parameter is not supported in microversion 2.36 and later.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_row28948990"><td class="cellrowborder" valign="top" width="34.44344434443444%" headers="mcps1.3.5.2.4.1.1 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p63166834">server_groups</p>
</td>
<td class="cellrowborder" valign="top" width="21.112111211121114%" headers="mcps1.3.5.2.4.1.2 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p8691183631616">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="44.44444444444445%" headers="mcps1.3.5.2.4.1.3 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973199_p7769944391">Specifies the quantity quota of <span id="EN-US_TOPIC_0065817716__text312527185211">ECS</span> groups.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_row32659336"><td class="cellrowborder" valign="top" width="34.44344434443444%" headers="mcps1.3.5.2.4.1.1 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p28160592">server_group_members</p>
</td>
<td class="cellrowborder" valign="top" width="21.112111211121114%" headers="mcps1.3.5.2.4.1.2 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_p1186383713163">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="44.44444444444445%" headers="mcps1.3.5.2.4.1.3 "><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973199_p5769134203914">Specifies the ECS quota in an ECS group.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="section" id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_section57268131"><h4 class="sectiontitle">Example Request</h4><p id="EN-US_TOPIC_0065817716__p82027414271">Query default quotas of resources.</p>
<pre class="screen" id="EN-US_TOPIC_0065817716__screen20247152819417">GET https://{endpoint}/v2/d9ebe43510414ef590a4aa158605329e/os-quota-sets/d9ebe43510414ef590a4aa158605329e/defaults
GET https://{endpoint}/v2.1/d9ebe43510414ef590a4aa158605329e/os-quota-sets/d9ebe43510414ef590a4aa158605329e/defaults</pre>
</div>
<div class="section" id="EN-US_TOPIC_0065817716__section18547143234913"><h4 class="sectiontitle">Example Response</h4><pre class="screen" id="EN-US_TOPIC_0065817716__screen143944742515">{
"quota_set":{
"injected_file_content_bytes":10240,
"metadata_items":128,
"server_group_members":10,
"server_groups":10,
"ram":51200,
"floating_ips":10,
"key_pairs":100,
"injected_file_path_bytes":255,
"instances":10,
"security_group_rules":20,
"injected_files":5,
"cores":20,
"fixed_ips":-1,
"id":"474eff20eee84b2e87b5717cc7f34dd8",
"security_groups":10
}
}</pre>
</div>
<div class="section" id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_en-us_topic_0020212692_section22960139"><h4 class="sectiontitle">Returned Values</h4><p id="EN-US_TOPIC_0065817716__en-us_topic_0057973201_en-us_topic_0020212692_p23670760">See <a href="en-us_topic_0022067716.html">Returned Values for General Requests</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0111860833.html">Tenant Quota Management</a></div>
</div>
</div>