forked from docs/doc-exports
Reviewed-by: gtema <artem.goncharov@gmail.com> Co-authored-by: Yang, Tong <yangtong2@huawei.com> Co-committed-by: Yang, Tong <yangtong2@huawei.com>
124 lines
9.2 KiB
HTML
124 lines
9.2 KiB
HTML
<a name="mrs_02_0073"></a><a name="mrs_02_0073"></a>
|
|
|
|
<h1 class="topictitle1">Querying Tags of a Specified Cluster</h1>
|
|
<div id="body8662426"><div class="section" id="mrs_02_0073__s2dea9a4d93f74e39ba20cbedd4b7e8be"><h4 class="sectiontitle">Function</h4><p id="mrs_02_0073__acf635a95e8404a9ca5371510c8415fdb">This API is used to query tags of a specified cluster.</p>
|
|
</div>
|
|
<div class="section" id="mrs_02_0073__s61128a85a7bf43eea9d5e251476421e3"><h4 class="sectiontitle">URI</h4><ul id="mrs_02_0073__ul3299804811311"><li id="mrs_02_0073__li3701617811311">Format<p id="mrs_02_0073__p92471313155614"><a name="mrs_02_0073__li3701617811311"></a><a name="li3701617811311"></a>GET /v1.1/{project_id}/clusters/{cluster_id}/tags</p>
|
|
</li><li id="mrs_02_0073__li29511803172648">Parameter description
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="mrs_02_0073__t10d6a27e439748119bac5dba8ff725ee" frame="border" border="1" rules="all"><caption><b>Table 1 </b>URI parameter description</caption><thead align="left"><tr id="mrs_02_0073__rc00b1d4d619d49578b746b159f6b14ef"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.2.2.2.1.2.4.1.1"><p id="mrs_02_0073__aba577efd88e64045a07aecffdf6aa549"><strong id="mrs_02_0073__b0460104191416">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.2.2.2.1.2.4.1.2"><p id="mrs_02_0073__en-us_topic_0110707083_p388412816227"><strong id="mrs_02_0073__b390913091411">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.2.2.2.1.2.4.1.3"><p id="mrs_02_0073__acb15181715474e73ac583c8ce5d0781e"><strong id="mrs_02_0073__b1806105611137">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="mrs_02_0073__r46543c343acf45a5838026f8b399eb51"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.2.2.1.2.4.1.1 "><p id="mrs_02_0073__a0b1454912a70443c8c7e81db3de6e78a">project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.2.2.1.2.4.1.2 "><p id="mrs_02_0073__a216bc5b881df408a8c8ae8bf39ba85a0">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.2.2.2.1.2.4.1.3 "><p id="mrs_02_0073__a748e1bc3a75c4d91a7fc3722e0b9e6a8">Project ID. For details on how to obtain the project ID, see <a href="mrs_02_0011.html">Obtaining a Project ID</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="mrs_02_0073__rbc810e17a79b41bd8c797bf23c58abcb"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.2.2.1.2.4.1.1 "><p id="mrs_02_0073__en-us_topic_0110707083_p288462815221">cluster_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.2.2.1.2.4.1.2 "><p id="mrs_02_0073__ae2a3892ba1744cbaad8fe0694bec9afa">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.2.2.2.1.2.4.1.3 "><p id="mrs_02_0073__en-us_topic_0110707083_p78845285227">Cluster ID</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="mrs_02_0073__s7d33ebe92ff14e34987ea021c259c478"><h4 class="sectiontitle">Request</h4><p id="mrs_02_0073__ad2d3d33707d446deb1ae9cc9ba411da6"><strong id="mrs_02_0073__en-us_topic_0110707083_b178296333234">Request parameters</strong></p>
|
|
<p id="mrs_02_0073__a2db3905341404374ae5590431ecfcc8f">None.</p>
|
|
</div>
|
|
<div class="section" id="mrs_02_0073__s7761860ece7c49d0b77a9177c2ccbc06"><h4 class="sectiontitle">Response</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="mrs_02_0073__table95690185369" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Response parameter description</caption><thead align="left"><tr id="mrs_02_0073__row8575818193612"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.2.2.4.1.1"><p id="mrs_02_0073__p4575181853612">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.2.2.4.1.2"><p id="mrs_02_0073__p145751818123617">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.4.2.2.4.1.3"><p id="mrs_02_0073__p25761518193614">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="mrs_02_0073__row1057791893611"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.2.2.4.1.1 "><p id="mrs_02_0073__p1414612262381">tags</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.2.2.4.1.2 "><p id="mrs_02_0073__p16204192543610">Array of objects</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.2.2.4.1.3 "><p id="mrs_02_0073__p1620522520368">Tag list. For details, see <a href="#mrs_02_0073__table16429741613">Table 3</a>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="mrs_02_0073__table16429741613"></a><a name="table16429741613"></a><table cellpadding="4" cellspacing="0" summary="" id="mrs_02_0073__table16429741613" frame="border" border="1" rules="all"><caption><b>Table 3 </b><strong id="mrs_02_0073__b1679174364212">tags</strong> parameter description</caption><thead align="left"><tr id="mrs_02_0073__row6447741616"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.3.2.4.1.1"><p id="mrs_02_0073__p144437171619"><strong id="mrs_02_0073__b13466107133">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.3.2.4.1.2"><p id="mrs_02_0073__p847075161"><strong id="mrs_02_0073__b169551111151315">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.4.3.2.4.1.3"><p id="mrs_02_0073__p1548378165"><strong id="mrs_02_0073__b611215481975">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="mrs_02_0073__row124947121617"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0073__p18491073163">key</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0073__p0492712166">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0073__p164907111612">Key. A tag key can contain only uppercase letters, lowercase letters, digits, hyphens (-), and underscores (_).</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="mrs_02_0073__row17501761611"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="mrs_02_0073__p115087181618">value</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="mrs_02_0073__p35027201610">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="mrs_02_0073__p35027151611">Tag value. A tag value can contain only uppercase letters, lowercase letters, digits, hyphens (-), and underscores (_).</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="mrs_02_0073__s936b4472ffcd469cabb7f86045e4a8d9"><h4 class="sectiontitle">Example</h4><ul id="mrs_02_0073__u608bb4133b8141a484d3d088725cee57"><li id="mrs_02_0073__l8ad2e7e805434e77932dd0c6a78bf7e5">Example request<p id="mrs_02_0073__en-us_topic_0110707083_p655555753811"><a name="mrs_02_0073__l8ad2e7e805434e77932dd0c6a78bf7e5"></a><a name="l8ad2e7e805434e77932dd0c6a78bf7e5"></a>None.</p>
|
|
</li><li id="mrs_02_0073__l1f5563b41f6c446b8e599ea433eabc10">Example response<pre class="screen" id="mrs_02_0073__sbf7abd900a7441428dc892e1dc29964d">{
|
|
"tags": [
|
|
{
|
|
"key": "key1",
|
|
"value": "value1"
|
|
},
|
|
{
|
|
"key": "key2",
|
|
"value": "value3"
|
|
}
|
|
]
|
|
} </pre>
|
|
</li></ul>
|
|
<p id="mrs_02_0073__a210f9e02afa24913900cc98f11ff0e8f"></p>
|
|
</div>
|
|
<div class="section" id="mrs_02_0073__s90bcfddb775445708aada537153df78f"><h4 class="sectiontitle">Status Code</h4><p id="mrs_02_0073__afeb7950298f94b7293619dffadac35c0"><a href="#mrs_02_0073__t8879ab801c3841179c9f683931ddb28e">Table 4</a> describes the status code of this API.</p>
|
|
|
|
<div class="tablenoborder"><a name="mrs_02_0073__t8879ab801c3841179c9f683931ddb28e"></a><a name="t8879ab801c3841179c9f683931ddb28e"></a><table cellpadding="4" cellspacing="0" summary="" id="mrs_02_0073__t8879ab801c3841179c9f683931ddb28e" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Status code</caption><thead align="left"><tr id="mrs_02_0073__r36d47cc57e1642c4b85707586a41e0eb"><th align="left" class="cellrowborder" valign="top" width="30%" id="mcps1.3.6.3.2.3.1.1"><p id="mrs_02_0073__a75d57993e25f418f98e400b75d8c69f0"><strong id="mrs_02_0073__b136541145578">Status Code</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="70%" id="mcps1.3.6.3.2.3.1.2"><p id="mrs_02_0073__adb28f2a54c104798b44f849c0c35cc7c"><strong id="mrs_02_0073__b1037189607">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="mrs_02_0073__reded02762a3e4e20bdb2ff58a490425b"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.6.3.2.3.1.1 "><p id="mrs_02_0073__af56600e03d6442c2801caf1ce7308bb9">200</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.6.3.2.3.1.2 "><p id="mrs_02_0073__en-us_topic_0110707083_p39771881331">The operation is successful.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="mrs_02_0070.html">Tag Management APIs</a></div>
|
|
</div>
|
|
</div>
|
|
|