Files
doc-exports/docs/ces/api-ref/ces_03_0068.html
qiujiandong1 e9265fb6b0 CES API Update -20250521 version
Reviewed-by: Ziuzko, Alevtina <alevtina.ziuzko@t-systems.com>
Co-authored-by: qiujiandong1 <qiujiandong1@huawei.com>
Co-committed-by: qiujiandong1 <qiujiandong1@huawei.com>
2025-12-05 10:48:24 +00:00

343 lines
26 KiB
HTML

<a name="ces_03_0068"></a><a name="ces_03_0068"></a>
<h1 class="topictitle1">Querying Resources in a Resource Group</h1>
<div id="body1604373162219"><div class="section" id="ces_03_0068__section66578044"><h4 class="sectiontitle">Function</h4><p id="ces_03_0068__p16876399496">This API is used to query resources in a resource group based on the resource group ID.</p>
</div>
<div class="section" id="ces_03_0068__section62331491"><h4 class="sectiontitle">URI</h4><p id="ces_03_0068__p565541016124">GET /V1.0/{project_id}/resource-groups/{group_id}</p>
<ul id="ces_03_0068__ul8883693"><li id="ces_03_0068__li33761356">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="ces_03_0068__table31681753175455" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="ces_03_0068__row39882175175455"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.1.1.2.4.1.1"><p id="ces_03_0068__p9230722175455">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="19%" id="mcps1.3.2.3.1.1.2.4.1.2"><p id="ces_03_0068__p9490989175455">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="61%" id="mcps1.3.2.3.1.1.2.4.1.3"><p id="ces_03_0068__p30572649175455">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="ces_03_0068__row60465501175455"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.1.1.2.4.1.1 "><p id="ces_03_0068__p65867442175455">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.2.3.1.1.2.4.1.2 "><p id="ces_03_0068__p33662608175455">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="61%" headers="mcps1.3.2.3.1.1.2.4.1.3 "><p id="ces_03_0068__p42316702175455">Specifies the project ID.</p>
<p id="ces_03_0068__p191415137612">For details about how to obtain the project ID, see <a href="ces_03_0057.html">Obtaining a Project ID</a>.</p>
<p id="ces_03_0068__en-us_topic_0000001646899046_p18100524114814">Minimum: <strong id="ces_03_0068__b4041182943830">1</strong></p>
<p id="ces_03_0068__en-us_topic_0000001646899046_p81001524104817">Maximum: <strong id="ces_03_0068__b159740207783238">64</strong></p>
<p id="ces_03_0068__p4697184133915"><strong id="ces_03_0068__b125582306025034">Regular expression matching</strong>: ^[a-zA-Z0-9-]{1,64}$</p>
</td>
</tr>
<tr id="ces_03_0068__row1124612531976"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.1.1.2.4.1.1 "><p id="ces_03_0068__p137225391081">group_id</p>
</td>
<td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.2.3.1.1.2.4.1.2 "><p id="ces_03_0068__p172219391688">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="61%" headers="mcps1.3.2.3.1.1.2.4.1.3 "><p id="ces_03_0068__p1672220398813">Specifies the resource group ID.</p>
</td>
</tr>
<tr id="ces_03_0068__row186581855073"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.1.1.2.4.1.1 "><p id="ces_03_0068__p672220395817">status</p>
</td>
<td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.2.3.1.1.2.4.1.2 "><p id="ces_03_0068__p5722839889">No</p>
</td>
<td class="cellrowborder" valign="top" width="61%" headers="mcps1.3.2.3.1.1.2.4.1.3 "><p id="ces_03_0068__p07172056163212">Specifies the resource health status. The value can be:</p>
<ul id="ces_03_0068__ul15545617163310"><li id="ces_03_0068__li95453170334"><strong id="ces_03_0068__b1351443692119">health</strong>: No alarms have been generated for the resource group.</li><li id="ces_03_0068__li1029316197337"><strong id="ces_03_0068__b37929434210">unhealth</strong>: An alarm or alarms have been generated for a resource or resources in the resource group.</li><li id="ces_03_0068__li285592063311"><strong id="ces_03_0068__b1071355372117">no_alarm_rule</strong>: No alarm rules have been set for the resource group.</li></ul>
</td>
</tr>
<tr id="ces_03_0068__row53381181480"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.1.1.2.4.1.1 "><p id="ces_03_0068__p1372233915815">namespace</p>
</td>
<td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.2.3.1.1.2.4.1.2 "><p id="ces_03_0068__p17722153913815">No</p>
</td>
<td class="cellrowborder" valign="top" width="61%" headers="mcps1.3.2.3.1.1.2.4.1.3 "><p id="ces_03_0068__p0722183910814">Specifies the resource namespace. For example, the ECS namespace is <strong id="ces_03_0068__b1755065715514">SYS.ECS</strong>. To view the namespace of each service, see <a href="ces_03_0059.html">Services Interconnected with Cloud Eye</a>.</p>
</td>
</tr>
<tr id="ces_03_0068__row4191511783"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.1.1.2.4.1.1 "><p id="ces_03_0068__p972243913818">dname</p>
</td>
<td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.2.3.1.1.2.4.1.2 "><p id="ces_03_0068__p57229392815">No</p>
</td>
<td class="cellrowborder" valign="top" width="61%" headers="mcps1.3.2.3.1.1.2.4.1.3 "><p id="ces_03_0068__p107222039883">Specifies the resource dimension. For example, the ECS dimension is <strong id="ces_03_0068__b47701716614">instance_id</strong>. To view the dimension of each resource, see <a href="ces_03_0059.html">Services Interconnected with Cloud Eye</a>.</p>
<p id="ces_03_0068__p28531641191410">This parameter must be used together with the <strong id="ces_03_0068__b182214280917">namespace</strong> parameter.</p>
</td>
</tr>
<tr id="ces_03_0068__row455919133815"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.1.1.2.4.1.1 "><p id="ces_03_0068__p97221139386">start</p>
</td>
<td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.2.3.1.1.2.4.1.2 "><p id="ces_03_0068__p772211391281">No</p>
</td>
<td class="cellrowborder" valign="top" width="61%" headers="mcps1.3.2.3.1.1.2.4.1.3 "><p id="ces_03_0068__p127222396818">Specifies the start value of pagination. The value is an integer. The default value is <strong id="ces_03_0068__b1310425191020">0</strong>.</p>
</td>
</tr>
<tr id="ces_03_0068__row4882141517820"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.1.1.2.4.1.1 "><p id="ces_03_0068__p572215391383">limit</p>
</td>
<td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.2.3.1.1.2.4.1.2 "><p id="ces_03_0068__p772219391987">No</p>
</td>
<td class="cellrowborder" valign="top" width="61%" headers="mcps1.3.2.3.1.1.2.4.1.3 "><p id="ces_03_0068__p14722539485">Specifies the maximum number of records that can be queried at a time. The value range is (0,100] and the default value is <strong id="ces_03_0068__b145958296523">100</strong>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
<ul id="ces_03_0068__ul52541973175457"><li id="ces_03_0068__li41462866">Example: Query resources in a resource group.<pre class="screen" id="ces_03_0068__screen19889056194625">GET https://{Cloud Eye endpoint}/V1.0/{project_id}/resource-groups/{group_id}</pre>
</li></ul>
</div>
<div class="section" id="ces_03_0068__section24112512"><h4 class="sectiontitle">Request</h4><p id="ces_03_0068__p45638969">None</p>
</div>
<div class="section" id="ces_03_0068__section15686020"><h4 class="sectiontitle">Response</h4><ul id="ces_03_0068__ul5769005"><li id="ces_03_0068__li27068104152742">Response parameters
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="ces_03_0068__table42286344152742" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Response parameters</caption><thead align="left"><tr id="ces_03_0068__row38095364152742"><th align="left" class="cellrowborder" valign="top" width="22.86%" id="mcps1.3.4.2.1.1.2.4.1.1"><p id="ces_03_0068__p65825661152742">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="16.520000000000003%" id="mcps1.3.4.2.1.1.2.4.1.2"><p id="ces_03_0068__p36622711152742">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="60.62%" id="mcps1.3.4.2.1.1.2.4.1.3"><p id="ces_03_0068__p13649609152742">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="ces_03_0068__row48913836152742"><td class="cellrowborder" valign="top" width="22.86%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="ces_03_0068__p1356895611519">group_name</p>
</td>
<td class="cellrowborder" valign="top" width="16.520000000000003%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="ces_03_0068__p9568756161517">String</p>
</td>
<td class="cellrowborder" valign="top" width="60.62%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="ces_03_0068__p165682560153">Specifies the resource group, for example, <strong id="ces_03_0068__b1710583181016">Resource-Group-ECS-01</strong>.</p>
</td>
</tr>
<tr id="ces_03_0068__row185671917132310"><td class="cellrowborder" valign="top" width="22.86%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="ces_03_0068__p856818563156">group_id</p>
</td>
<td class="cellrowborder" valign="top" width="16.520000000000003%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="ces_03_0068__p19568356121515">String</p>
</td>
<td class="cellrowborder" valign="top" width="60.62%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="ces_03_0068__p2568356161512">Specifies the resource group ID, for example, <strong id="ces_03_0068__b811050141015">rg1603786526428bWbVmk4rP</strong>.</p>
</td>
</tr>
<tr id="ces_03_0068__row13649191311516"><td class="cellrowborder" valign="top" width="22.86%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="ces_03_0068__p15568185611516">resources</p>
</td>
<td class="cellrowborder" valign="top" width="16.520000000000003%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="ces_03_0068__p1856885681520">Array of objects</p>
</td>
<td class="cellrowborder" valign="top" width="60.62%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="ces_03_0068__p185684569155">Specifies information about one or more resource groups.</p>
<p id="ces_03_0068__p1538145803814">For details, see <a href="#ces_03_0068__table10571837131516">Table 3</a>.</p>
</td>
</tr>
<tr id="ces_03_0068__row1912733316150"><td class="cellrowborder" valign="top" width="22.86%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="ces_03_0068__p2568145621510">status</p>
</td>
<td class="cellrowborder" valign="top" width="16.520000000000003%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="ces_03_0068__p1756895651514">String</p>
</td>
<td class="cellrowborder" valign="top" width="60.62%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="ces_03_0068__p11982161863818">Specifies the resource group status, which can be <strong id="ces_03_0068__b29823184384">health</strong>, <strong id="ces_03_0068__b598210188384">unhealth</strong>, or <strong id="ces_03_0068__b17982111893814">no_alarm_rule</strong>.</p>
<ul id="ces_03_0068__ul82856354389"><li id="ces_03_0068__li6284153517383"><strong id="ces_03_0068__b8284183593811">health</strong>: No alarms have been generated for the resource group.</li><li id="ces_03_0068__li1128473512382"><strong id="ces_03_0068__b16284935113811">unhealth</strong>: An alarm or alarms have been generated for a resource or resources in the resource group.</li><li id="ces_03_0068__li10285203543815"><strong id="ces_03_0068__b13284143510383">no_alarm_rule</strong>: No alarm rules have been set for the resource group.</li></ul>
</td>
</tr>
<tr id="ces_03_0068__row755111309154"><td class="cellrowborder" valign="top" width="22.86%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="ces_03_0068__p1256835621519">create_time</p>
</td>
<td class="cellrowborder" valign="top" width="16.520000000000003%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="ces_03_0068__p1356865619153">Long</p>
</td>
<td class="cellrowborder" valign="top" width="60.62%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="ces_03_0068__p12568195617159">Specifies the time when the resource group was created. The value is a UNIX timestamp, in milliseconds. Example: <strong id="ces_03_0068__b1857757174310">1603819753000</strong></p>
</td>
</tr>
<tr id="ces_03_0068__row191552711512"><td class="cellrowborder" valign="top" width="22.86%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="ces_03_0068__p2056815631519">meta_data</p>
</td>
<td class="cellrowborder" valign="top" width="16.520000000000003%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="ces_03_0068__p18568556151515">MetaData object</p>
</td>
<td class="cellrowborder" valign="top" width="60.62%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="ces_03_0068__p4568456131517">Specifies the metadata of query results, including the pagination information.</p>
<p id="ces_03_0068__p152711158393">For details, see <a href="#ces_03_0068__table7554143164419">Table 5</a>.</p>
</td>
</tr>
<tr id="ces_03_0068__row9296112391514"><td class="cellrowborder" valign="top" width="22.86%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="ces_03_0068__p9568165618158">enterprise_project_id</p>
</td>
<td class="cellrowborder" valign="top" width="16.520000000000003%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="ces_03_0068__p8568135691518">String</p>
</td>
<td class="cellrowborder" valign="top" width="60.62%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="ces_03_0068__p15568165614156">Specifies the enterprise project associated with the resource group. The default value <strong id="ces_03_0068__b921154944417">0</strong> indicates enterprise project <strong id="ces_03_0068__b16603313457">default.</strong></p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="ces_03_0068__table10571837131516"></a><a name="table10571837131516"></a><table cellpadding="4" cellspacing="0" summary="" id="ces_03_0068__table10571837131516" frame="border" border="1" rules="all"><caption><b>Table 3 </b><strong id="ces_03_0068__b95183419455">resources</strong> data structure description</caption><thead align="left"><tr id="ces_03_0068__row134453716156"><th align="left" class="cellrowborder" valign="top" width="22.86%" id="mcps1.3.4.2.1.2.2.4.1.1"><p id="ces_03_0068__p124463713153">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="16.580000000000002%" id="mcps1.3.4.2.1.2.2.4.1.2"><p id="ces_03_0068__p104453761519">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="60.56%" id="mcps1.3.4.2.1.2.2.4.1.3"><p id="ces_03_0068__p74433718157">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="ces_03_0068__row248153712151"><td class="cellrowborder" valign="top" width="22.86%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="ces_03_0068__p18985411184">namespace</p>
</td>
<td class="cellrowborder" valign="top" width="16.580000000000002%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="ces_03_0068__p88920545187">String</p>
</td>
<td class="cellrowborder" valign="top" width="60.56%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="ces_03_0068__p16840175202">Specifies the resource namespace. For example, the ECS namespace is <strong id="ces_03_0068__b146473469610">SYS.ECS</strong>. To view the namespace of each service, see <a href="ces_03_0059.html">Services Interconnected with Cloud Eye</a>.</p>
</td>
</tr>
<tr id="ces_03_0068__row1748203712158"><td class="cellrowborder" valign="top" width="22.86%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="ces_03_0068__p5891546188">dimensions</p>
</td>
<td class="cellrowborder" valign="top" width="16.580000000000002%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="ces_03_0068__p1189195410187">Array of objects</p>
</td>
<td class="cellrowborder" valign="top" width="60.56%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="ces_03_0068__p38935471815">Specifies one or more resource dimensions.</p>
<p id="ces_03_0068__p99318254393">For details, see <a href="#ces_03_0068__table19174559133918">Table 4</a>.</p>
</td>
</tr>
<tr id="ces_03_0068__row19488375152"><td class="cellrowborder" valign="top" width="22.86%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="ces_03_0068__p1989195461812">status</p>
</td>
<td class="cellrowborder" valign="top" width="16.580000000000002%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="ces_03_0068__p1689125441818">String</p>
</td>
<td class="cellrowborder" valign="top" width="60.56%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="ces_03_0068__p7645162812505">Specifies the resource group status, which can be <strong id="ces_03_0068__b15806123302916">health</strong>, <strong id="ces_03_0068__b7103153715290">unhealth</strong>, or <strong id="ces_03_0068__b16750540162912">no_alarm_rule</strong>.</p>
<p id="ces_03_0068__p087717356501"><strong id="ces_03_0068__b6877123510504">health</strong>: No alarms have been generated for the resource group. </p>
<p id="ces_03_0068__p19322140155019"><strong id="ces_03_0068__b163229409508">unhealth</strong>: An alarm or alarms have been generated for a resource or resources in the resource group. </p>
<p id="ces_03_0068__p5790340192011"><strong id="ces_03_0068__b09801220194910">no_alarm_rule</strong>: No alarm rules have been set for the resource group.</p>
</td>
</tr>
<tr id="ces_03_0068__row14878194153410"><td class="cellrowborder" valign="top" width="22.86%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="ces_03_0068__p18159173011579">event_type</p>
</td>
<td class="cellrowborder" valign="top" width="16.580000000000002%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="ces_03_0068__p10159130195710">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="60.56%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="ces_03_0068__p326317496579">Specifies the event type. The default value is <strong id="ces_03_0068__b54061442191010">0</strong>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="ces_03_0068__table19174559133918"></a><a name="table19174559133918"></a><table cellpadding="4" cellspacing="0" summary="" id="ces_03_0068__table19174559133918" frame="border" border="1" rules="all"><caption><b>Table 4 </b><strong id="ces_03_0068__b1184310313458">dimensions</strong> data structure description</caption><thead align="left"><tr id="ces_03_0068__row10174145923910"><th align="left" class="cellrowborder" valign="top" width="20.53%" id="mcps1.3.4.2.1.3.2.4.1.1"><p id="ces_03_0068__p117455973917">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="15.770000000000001%" id="mcps1.3.4.2.1.3.2.4.1.2"><p id="ces_03_0068__p21751659193910">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="63.7%" id="mcps1.3.4.2.1.3.2.4.1.3"><p id="ces_03_0068__p317575993911">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="ces_03_0068__row1017713594391"><td class="cellrowborder" valign="top" width="20.53%" headers="mcps1.3.4.2.1.3.2.4.1.1 "><p id="ces_03_0068__p1332017842210">name</p>
</td>
<td class="cellrowborder" valign="top" width="15.770000000000001%" headers="mcps1.3.4.2.1.3.2.4.1.2 "><p id="ces_03_0068__p232011813226">String</p>
</td>
<td class="cellrowborder" valign="top" width="63.7%" headers="mcps1.3.4.2.1.3.2.4.1.3 "><p id="ces_03_0068__p43207814227">Specifies the resource dimension. For example, the ECS dimension is <strong id="ces_03_0068__b93686541061">instance_id</strong>. To view the dimension of each resource, see <a href="ces_03_0059.html">Services Interconnected with Cloud Eye</a>.</p>
</td>
</tr>
<tr id="ces_03_0068__row717815917396"><td class="cellrowborder" valign="top" width="20.53%" headers="mcps1.3.4.2.1.3.2.4.1.1 "><p id="ces_03_0068__p032016815226">value</p>
</td>
<td class="cellrowborder" valign="top" width="15.770000000000001%" headers="mcps1.3.4.2.1.3.2.4.1.2 "><p id="ces_03_0068__p14320208132212">String</p>
</td>
<td class="cellrowborder" valign="top" width="63.7%" headers="mcps1.3.4.2.1.3.2.4.1.3 "><p id="ces_03_0068__p1432078182217">Specifies the resource dimension value, which is the instance ID. Example: <strong id="ces_03_0068__b1155194712219">4270ff17-aba3-4138-89fa-820594c39755</strong></p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="ces_03_0068__table7554143164419"></a><a name="table7554143164419"></a><table cellpadding="4" cellspacing="0" summary="" id="ces_03_0068__table7554143164419" frame="border" border="1" rules="all"><caption><b>Table 5 </b><strong id="ces_03_0068__b92191011113517">meta_data</strong> data structure description</caption><thead align="left"><tr id="ces_03_0068__row1555516374419"><th align="left" class="cellrowborder" valign="top" width="20.54%" id="mcps1.3.4.2.1.4.2.4.1.1"><p id="ces_03_0068__p6555193144417">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="15.76%" id="mcps1.3.4.2.1.4.2.4.1.2"><p id="ces_03_0068__p125551734448">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="63.7%" id="mcps1.3.4.2.1.4.2.4.1.3"><p id="ces_03_0068__p1755533204413">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="ces_03_0068__row9558183144414"><td class="cellrowborder" valign="top" width="20.54%" headers="mcps1.3.4.2.1.4.2.4.1.1 "><p id="ces_03_0068__p114621118142313">count</p>
</td>
<td class="cellrowborder" valign="top" width="15.76%" headers="mcps1.3.4.2.1.4.2.4.1.2 "><p id="ces_03_0068__p1746261817238">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="63.7%" headers="mcps1.3.4.2.1.4.2.4.1.3 "><p id="ces_03_0068__p44621182235">Specifies the number of returned results.</p>
</td>
</tr>
<tr id="ces_03_0068__row19559235443"><td class="cellrowborder" valign="top" width="20.54%" headers="mcps1.3.4.2.1.4.2.4.1.1 "><p id="ces_03_0068__p546391862312">total</p>
</td>
<td class="cellrowborder" valign="top" width="15.76%" headers="mcps1.3.4.2.1.4.2.4.1.2 "><p id="ces_03_0068__p144631718152312">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="63.7%" headers="mcps1.3.4.2.1.4.2.4.1.3 "><p id="ces_03_0068__p19463718162319">Specifies the total number of query results.</p>
</td>
</tr>
<tr id="ces_03_0068__row17181198152320"><td class="cellrowborder" valign="top" width="20.54%" headers="mcps1.3.4.2.1.4.2.4.1.1 "><p id="ces_03_0068__p17463171819234">marker</p>
</td>
<td class="cellrowborder" valign="top" width="15.76%" headers="mcps1.3.4.2.1.4.2.4.1.2 "><p id="ces_03_0068__p13463101802311">String</p>
</td>
<td class="cellrowborder" valign="top" width="63.7%" headers="mcps1.3.4.2.1.4.2.4.1.3 "><p id="ces_03_0068__p19183163212419">Specifies the pagination marker.</p>
</td>
</tr>
</tbody>
</table>
</div>
<ul id="ces_03_0068__ul34750592184830"><li id="ces_03_0068__li44319877184830">Example response<pre class="screen" id="ces_03_0068__screen4738031718551">{
"group_name": "ResourceGroup-Test-01",
"resources": [
{
"namespace": "SYS.ECS",
"dimensions": [
{
"name": "instance_id",
"value": "6cffb0bd-fd37-400f-ae6f-8f4be021ff7e"
}
],
"status": "health",
"event_type": 0
},
{
"namespace": "SYS.ECS",
"dimensions": [
{
"name": "instance_id",
"value": "e37d6238-9dd3-4720-abcc-eb9f8fb08ca0"
}
],
"status": "health",
"event_type": 0
}
],
"create_time": 1604476378000,
"group_id": "rg16044763786104XvXvl00a",
"status": "health",
"meta_data": {
"count": 0,
"marker": "",
"total": 2
},
"enterprise_project_id": "0"
}</pre>
</li></ul>
</li></ul>
</div>
<div class="section" id="ces_03_0068__section6956456"><h4 class="sectiontitle">Returned Values</h4><ul id="ces_03_0068__ul20226985"><li id="ces_03_0068__li47825138">Normal<p id="ces_03_0068__p27773061"><a name="ces_03_0068__li47825138"></a><a name="li47825138"></a>200</p>
</li><li id="ces_03_0068__li48630964">Abnormal
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="ces_03_0068__table9852173623812" frame="border" border="1" rules="all"><thead align="left"><tr id="ces_03_0068__row985213612382"><th align="left" class="cellrowborder" valign="top" width="32.1%" id="mcps1.3.5.2.2.1.1.3.1.1"><p id="ces_03_0068__p1849030182924">Returned Values</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="67.9%" id="mcps1.3.5.2.2.1.1.3.1.2"><p id="ces_03_0068__p15553712182924">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="ces_03_0068__row4852193611387"><td class="cellrowborder" valign="top" width="32.1%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="ces_03_0068__p581987519168">400 Bad Request</p>
</td>
<td class="cellrowborder" valign="top" width="67.9%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="ces_03_0068__p164784039168">Request error.</p>
</td>
</tr>
<tr id="ces_03_0068__row188531636193819"><td class="cellrowborder" valign="top" width="32.1%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="ces_03_0068__p2691669168">401 Unauthorized</p>
</td>
<td class="cellrowborder" valign="top" width="67.9%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="ces_03_0068__p218024949168">The authentication information is not provided or is incorrect.</p>
</td>
</tr>
<tr id="ces_03_0068__row118531636123816"><td class="cellrowborder" valign="top" width="32.1%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="ces_03_0068__p563264059168">403 Forbidden</p>
</td>
<td class="cellrowborder" valign="top" width="67.9%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="ces_03_0068__p661449719168">Access to the requested page is forbidden.</p>
</td>
</tr>
<tr id="ces_03_0068__row4853436123812"><td class="cellrowborder" valign="top" width="32.1%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="ces_03_0068__p355199299168">408 Request Timeout</p>
</td>
<td class="cellrowborder" valign="top" width="67.9%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="ces_03_0068__p585420329168">The request timed out.</p>
</td>
</tr>
<tr id="ces_03_0068__row1285303673812"><td class="cellrowborder" valign="top" width="32.1%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="ces_03_0068__p630127129168">429 Too Many Requests</p>
</td>
<td class="cellrowborder" valign="top" width="67.9%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="ces_03_0068__p37560249168">Concurrent requests are excessive.</p>
</td>
</tr>
<tr id="ces_03_0068__row1853336203811"><td class="cellrowborder" valign="top" width="32.1%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="ces_03_0068__p537873819168">500 Internal Server Error</p>
</td>
<td class="cellrowborder" valign="top" width="67.9%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="ces_03_0068__p618106189168">Failed to complete the request because of an internal service error.</p>
</td>
</tr>
<tr id="ces_03_0068__row38537365385"><td class="cellrowborder" valign="top" width="32.1%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="ces_03_0068__p298930079168">503 Service Unavailable</p>
</td>
<td class="cellrowborder" valign="top" width="67.9%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="ces_03_0068__p54144829168">The service is currently unavailable.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
<div class="section" id="ces_03_0068__section121612204463"><h4 class="sectiontitle">Error Codes</h4><p id="ces_03_0068__en-us_topic_0171212585_p91851023153416">See <a href="ErrorCode.html">Error Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="ces_03_0067.html">Resource Groups</a></div>
</div>
</div>