forked from docs/doc-exports
lizaoxu
3bac3b88e8
Reviewed-by: Muller, Martin <martin.muller@t-systems.com> Co-authored-by: lizaoxu <lizaoxu@huawei.com> Co-committed-by: lizaoxu <lizaoxu@huawei.com>
171 lines
14 KiB
HTML
171 lines
14 KiB
HTML
<a name="sfs_03_0007"></a><a name="sfs_03_0007"></a>
|
|
|
|
<h1 class="topictitle1">Querying Tags in a Project</h1>
|
|
<div id="body8662426"><div class="section" id="sfs_03_0007__en-us_topic_0000001886312013_en-us_topic_0000001311071305_en-us_topic_0000001263239606_section45644251387"><h4 class="sectiontitle">Function</h4><p id="sfs_03_0007__en-us_topic_0000001886312013_p113276360571">This API is used to query tags of all resources owned by a tenant in a specified project.</p>
|
|
</div>
|
|
<div class="section" id="sfs_03_0007__en-us_topic_0000001886312013_en-us_topic_0000001311071305_en-us_topic_0000001263239606_section25643251387"><h4 class="sectiontitle">URI</h4><ul id="sfs_03_0007__en-us_topic_0000001886312013_ul14450165512518"><li id="sfs_03_0007__en-us_topic_0000001886312013_li29071918193919">GET /v3/sfs/tms/{project_id}/file-systems/tags</li><li id="sfs_03_0007__en-us_topic_0000001886312013_l0b44fa9cf5ac4d5ebf049e4fffe1a9ea">Parameter description
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="sfs_03_0007__en-us_topic_0000001886312013_t5f48f75db9b14c6cbfd2879dd1e7c8d1" frame="border" border="1" rules="all"><thead align="left"><tr id="sfs_03_0007__en-us_topic_0000001886312013_ree8732a49c9f4cbfa3cbd26bda2eb442"><th align="left" class="cellrowborder" valign="top" width="14.29%" id="mcps1.3.2.2.2.1.1.5.1.1"><p id="sfs_03_0007__en-us_topic_0000001886312013_p17124101410431">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="14.85%" id="mcps1.3.2.2.2.1.1.5.1.2"><p id="sfs_03_0007__en-us_topic_0000001886312013_p1612415146430">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="19.55%" id="mcps1.3.2.2.2.1.1.5.1.3"><p id="sfs_03_0007__en-us_topic_0000001886312013_p312416148432">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="51.31%" id="mcps1.3.2.2.2.1.1.5.1.4"><p id="sfs_03_0007__en-us_topic_0000001886312013_p3124181464318">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="sfs_03_0007__en-us_topic_0000001886312013_r7dc74f4a31004f8eb4e868a93369c8a0"><td class="cellrowborder" valign="top" width="14.29%" headers="mcps1.3.2.2.2.1.1.5.1.1 "><p id="sfs_03_0007__en-us_topic_0000001886312013_adf798e5d942b4301b652796bdf092f4a">project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="14.85%" headers="mcps1.3.2.2.2.1.1.5.1.2 "><p id="sfs_03_0007__en-us_topic_0000001886312013_a2326f73739854b4fa1892e0648821849">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.55%" headers="mcps1.3.2.2.2.1.1.5.1.3 "><p id="sfs_03_0007__en-us_topic_0000001886312013_ac77b318c2668498189dbee0fbb5fdb09">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="51.31%" headers="mcps1.3.2.2.2.1.1.5.1.4 "><p id="sfs_03_0007__en-us_topic_0000001886312013_a7f191d8fed27458ba04d994b7c934b80">The project ID.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="sfs_03_0007__en-us_topic_0000001886312013_en-us_topic_0000001311071305_en-us_topic_0000001263239606_section15569122523811"><h4 class="sectiontitle">Request Parameters</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="sfs_03_0007__en-us_topic_0000001886312013_en-us_topic_0000001311071305_en-us_topic_0000001263239606_HeaderParameter" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request header parameters</caption><thead align="left"><tr id="sfs_03_0007__en-us_topic_0000001886312013_en-us_topic_0000001311071305_en-us_topic_0000001263239606_row1256922515381"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.1"><p id="sfs_03_0007__en-us_topic_0000001886312013_en-us_topic_0000001311071305_en-us_topic_0000001263239606_p18570025113819">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.2"><p id="sfs_03_0007__en-us_topic_0000001886312013_en-us_topic_0000001311071305_en-us_topic_0000001263239606_p5570202573816">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.3"><p id="sfs_03_0007__en-us_topic_0000001886312013_en-us_topic_0000001311071305_en-us_topic_0000001263239606_p1357014252386">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.2.2.5.1.4"><p id="sfs_03_0007__en-us_topic_0000001886312013_en-us_topic_0000001311071305_en-us_topic_0000001263239606_p75711025133813">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="sfs_03_0007__en-us_topic_0000001886312013_en-us_topic_0000001311071305_en-us_topic_0000001263239606_row256972512383"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="sfs_03_0007__en-us_topic_0000001886312013_en-us_topic_0000001311071305_en-us_topic_0000001263239606_p65711252389">Content-type</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="sfs_03_0007__en-us_topic_0000001886312013_en-us_topic_0000001311071305_en-us_topic_0000001263239606_p12571325143810">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="sfs_03_0007__en-us_topic_0000001886312013_en-us_topic_0000001311071305_en-us_topic_0000001263239606_p157122513816">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="sfs_03_0007__en-us_topic_0000001886312013_en-us_topic_0000001311071305_en-us_topic_0000001263239606_p19571172519388">The MIME type of the request body.</p>
|
|
<p id="sfs_03_0007__en-us_topic_0000001886312013_p288693716167">Example: application/json</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="sfs_03_0007__en-us_topic_0000001886312013_en-us_topic_0000001311071305_en-us_topic_0000001263239606_row256918253384"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="sfs_03_0007__en-us_topic_0000001886312013_en-us_topic_0000001311071305_en-us_topic_0000001263239606_p20571112510387">X-Auth-Token</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="sfs_03_0007__en-us_topic_0000001886312013_en-us_topic_0000001311071305_en-us_topic_0000001263239606_p1571172510389">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="sfs_03_0007__en-us_topic_0000001886312013_en-us_topic_0000001311071305_en-us_topic_0000001263239606_p1557262573812">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="sfs_03_0007__en-us_topic_0000001886312013_en-us_topic_0000001311071305_en-us_topic_0000001263239606_p17572112515388">The user token.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="sfs_03_0007__en-us_topic_0000001886312013_en-us_topic_0000001311071305_en-us_topic_0000001263239606_section1957532520382"><h4 class="sectiontitle">Response Parameters</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="sfs_03_0007__en-us_topic_0000001886312013_table174716289336" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Response body parameter</caption><thead align="left"><tr id="sfs_03_0007__en-us_topic_0000001886312013_row187471228163316"><th align="left" class="cellrowborder" valign="top" width="20.43%" id="mcps1.3.4.2.2.5.1.1"><p id="sfs_03_0007__en-us_topic_0000001886312013_p446017418333">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="19.8%" id="mcps1.3.4.2.2.5.1.2"><p id="sfs_03_0007__en-us_topic_0000001886312013_p54601841193316">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20.36%" id="mcps1.3.4.2.2.5.1.3"><p id="sfs_03_0007__en-us_topic_0000001886312013_p0460841133315">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="39.410000000000004%" id="mcps1.3.4.2.2.5.1.4"><p id="sfs_03_0007__en-us_topic_0000001886312013_p10460144119339">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="sfs_03_0007__en-us_topic_0000001886312013_row4747728203315"><td class="cellrowborder" valign="top" width="20.43%" headers="mcps1.3.4.2.2.5.1.1 "><p id="sfs_03_0007__en-us_topic_0000001886312013_p124605418336">tags</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.8%" headers="mcps1.3.4.2.2.5.1.2 "><p id="sfs_03_0007__en-us_topic_0000001886312013_p14605419338">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.36%" headers="mcps1.3.4.2.2.5.1.3 "><p id="sfs_03_0007__en-us_topic_0000001886312013_p646044143313">List<<a href="sfs_03_0005.html#sfs_03_0005__en-us_topic_0000001840191462_table138157172456">tag</a>></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.410000000000004%" headers="mcps1.3.4.2.2.5.1.4 "><p id="sfs_03_0007__en-us_topic_0000001886312013_p11460134113315">The tag list. For details, see <a href="sfs_03_0005.html#sfs_03_0005__en-us_topic_0000001840191462_table138157172456">Table 3</a>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="sfs_03_0007__en-us_topic_0000001886312013_en-us_topic_0000001311071305_en-us_topic_0000001263239606_section45751825203817"><h4 class="sectiontitle">Example Request</h4><p id="sfs_03_0007__en-us_topic_0000001886312013_p4983152214167">Querying tags using project ID **c80a2157ba1d46c0825265947342077c**:</p>
|
|
<pre class="screen" id="sfs_03_0007__en-us_topic_0000001886312013_screen1181631412359">GET https://{endpoint}/v3/sfs/tms/c80a2157ba1d46c0825265947342077c/file-systems/tags</pre>
|
|
</div>
|
|
<div class="section" id="sfs_03_0007__en-us_topic_0000001886312013_en-us_topic_0000001311071305_en-us_topic_0000001263239606_section1057692523814"><h4 class="sectiontitle">Example Response</h4><pre class="screen" id="sfs_03_0007__en-us_topic_0000001886312013_screen155009132486">{
|
|
"tags":[
|
|
{
|
|
"key":"key1",
|
|
"values":[
|
|
"value1",
|
|
"value2"
|
|
]
|
|
},
|
|
{
|
|
"key":"key2",
|
|
"values":[
|
|
"value1",
|
|
"value2"
|
|
]
|
|
}
|
|
]
|
|
}</pre>
|
|
</div>
|
|
<div class="section" id="sfs_03_0007__en-us_topic_0000001886312013_en-us_topic_0000001311071305_en-us_topic_0000001263239606_section9576122583811"><h4 class="sectiontitle">Status Codes</h4><ul id="sfs_03_0007__en-us_topic_0000001886312013_ul3162613183218"><li id="sfs_03_0007__en-us_topic_0000001886312013_li17162131319327">Normal</li></ul>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="sfs_03_0007__en-us_topic_0000001886312013_table368724141513" frame="border" border="1" rules="all"><thead align="left"><tr id="sfs_03_0007__en-us_topic_0000001886312013_row8682024181510"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.7.3.1.3.1.1"><p id="sfs_03_0007__en-us_topic_0000001886312013_p12688246153">Status Code</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="85%" id="mcps1.3.7.3.1.3.1.2"><p id="sfs_03_0007__en-us_topic_0000001886312013_p26822418151">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="sfs_03_0007__en-us_topic_0000001886312013_row168024161516"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.3.1.3.1.1 "><p id="sfs_03_0007__en-us_topic_0000001886312013_p1168424141515">200</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.3.1.3.1.2 "><p id="sfs_03_0007__en-us_topic_0000001886312013_p16817240155">Resource tags queried by project.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<ul id="sfs_03_0007__en-us_topic_0000001886312013_ul0640161683218"><li id="sfs_03_0007__en-us_topic_0000001886312013_li17640141673214">Abnormal</li></ul>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="sfs_03_0007__en-us_topic_0000001886312013_en-us_topic_0000001311071305_en-us_topic_0000001263239606_status_code" frame="border" border="1" rules="all"><thead align="left"><tr id="sfs_03_0007__en-us_topic_0000001886312013_en-us_topic_0000001311071305_en-us_topic_0000001263239606_row45761425133810"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.7.5.1.3.1.1"><p id="sfs_03_0007__en-us_topic_0000001886312013_en-us_topic_0000001311071305_en-us_topic_0000001263239606_p105761225173813">Status Code</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="85%" id="mcps1.3.7.5.1.3.1.2"><p id="sfs_03_0007__en-us_topic_0000001886312013_en-us_topic_0000001311071305_en-us_topic_0000001263239606_p12576112573812">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="sfs_03_0007__en-us_topic_0000001886312013_row20215812131416"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.5.1.3.1.1 "><p id="sfs_03_0007__en-us_topic_0000001886312013_p141019302141">400</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.5.1.3.1.2 "><p id="sfs_03_0007__en-us_topic_0000001886312013_p410630191412">Invalid tag parameter.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="sfs_03_0007__en-us_topic_0000001886312013_row1922211518149"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.5.1.3.1.1 "><p id="sfs_03_0007__en-us_topic_0000001886312013_p610133041416">401</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.5.1.3.1.2 "><p id="sfs_03_0007__en-us_topic_0000001886312013_p1510113071415">Certification failed.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="sfs_03_0007__en-us_topic_0000001886312013_row17969131741415"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.5.1.3.1.1 "><p id="sfs_03_0007__en-us_topic_0000001886312013_p10102309145">403</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.5.1.3.1.2 "><p id="sfs_03_0007__en-us_topic_0000001886312013_p710103010141">Authentication failed.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="sfs_03_0007__en-us_topic_0000001886312013_row7978112011418"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.5.1.3.1.1 "><p id="sfs_03_0007__en-us_topic_0000001886312013_p1410183031417">404</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.5.1.3.1.2 "><p id="sfs_03_0007__en-us_topic_0000001886312013_p910133017145">Resource not found.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="sfs_03_0007__en-us_topic_0000001886312013_row9668162716146"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.5.1.3.1.1 "><p id="sfs_03_0007__en-us_topic_0000001886312013_p1610430181412">500</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.5.1.3.1.2 "><p id="sfs_03_0007__en-us_topic_0000001886312013_p41033016149">System error.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="sfs_03_0001.html">Tags</a></div>
|
|
</div>
|
|
</div>
|
|
|