yexinru/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
Files
0b3a43371a4bcc99577594de0a685249d676a567
doc-exports/docs/sfs/api-ref/sfs_03_0005.html
lizaoxu 3bac3b88e8 sfs_api_251009 
Reviewed-by: Muller, Martin <martin.muller@t-systems.com>
Co-authored-by: lizaoxu <lizaoxu@huawei.com>
Co-committed-by: lizaoxu <lizaoxu@huawei.com>
2025-12-03 13:51:09 +00:00

411 lines
39 KiB
HTML
Raw Blame History

<a name="sfs_03_0005"></a><a name="sfs_03_0005"></a>
<h1 class="topictitle1">Querying Resources by Tag</h1>
<div id="body8662426"><div class="section" id="sfs_03_0005__en-us_topic_0000001840191462_en-us_topic_0000001311071305_en-us_topic_0000001263239606_section45644251387"><h4 class="sectiontitle">Function</h4><p id="sfs_03_0005__en-us_topic_0000001840191462_en-us_topic_0000001311071305_en-us_topic_0000001263239606_p456422517384">This API is used to list resources by tag. Resources are sorted by the time when they are created, in descending order.</p>
</div>
<div class="section" id="sfs_03_0005__en-us_topic_0000001840191462_en-us_topic_0000001311071305_en-us_topic_0000001263239606_section25643251387"><h4 class="sectiontitle">URI</h4><ul id="sfs_03_0005__en-us_topic_0000001840191462_ul14450165512518"><li id="sfs_03_0005__en-us_topic_0000001840191462_l0b44fa9cf5ac4d5ebf049e4fffe1a9ea">POST /v3/sfs/tms/{project_id}/file-systems/resource-instances/filter</li></ul>
<ul id="sfs_03_0005__en-us_topic_0000001840191462_ub4aa0077165a4a2aaa86e70b7267710a"><li id="sfs_03_0005__en-us_topic_0000001840191462_l46cf58ab60f44ee1aa0706ecc81ea921">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="sfs_03_0005__en-us_topic_0000001840191462_t5f48f75db9b14c6cbfd2879dd1e7c8d1" frame="border" border="1" rules="all"><thead align="left"><tr id="sfs_03_0005__en-us_topic_0000001840191462_ree8732a49c9f4cbfa3cbd26bda2eb442"><th align="left" class="cellrowborder" valign="top" width="14.29%" id="mcps1.3.2.3.1.1.1.5.1.1"><p id="sfs_03_0005__en-us_topic_0000001840191462_p17124101410431">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="14.85%" id="mcps1.3.2.3.1.1.1.5.1.2"><p id="sfs_03_0005__en-us_topic_0000001840191462_p1612415146430">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="19.55%" id="mcps1.3.2.3.1.1.1.5.1.3"><p id="sfs_03_0005__en-us_topic_0000001840191462_p312416148432">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="51.31%" id="mcps1.3.2.3.1.1.1.5.1.4"><p id="sfs_03_0005__en-us_topic_0000001840191462_p3124181464318">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="sfs_03_0005__en-us_topic_0000001840191462_r7dc74f4a31004f8eb4e868a93369c8a0"><td class="cellrowborder" valign="top" width="14.29%" headers="mcps1.3.2.3.1.1.1.5.1.1 "><p id="sfs_03_0005__en-us_topic_0000001840191462_adf798e5d942b4301b652796bdf092f4a">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="14.85%" headers="mcps1.3.2.3.1.1.1.5.1.2 "><p id="sfs_03_0005__en-us_topic_0000001840191462_a2326f73739854b4fa1892e0648821849">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="19.55%" headers="mcps1.3.2.3.1.1.1.5.1.3 "><p id="sfs_03_0005__en-us_topic_0000001840191462_ac77b318c2668498189dbee0fbb5fdb09">String</p>
</td>
<td class="cellrowborder" valign="top" width="51.31%" headers="mcps1.3.2.3.1.1.1.5.1.4 "><p id="sfs_03_0005__en-us_topic_0000001840191462_a7f191d8fed27458ba04d994b7c934b80">The project ID.</p>
</td>
</tr>
<tr id="sfs_03_0005__en-us_topic_0000001840191462_row148671328164413"><td class="cellrowborder" valign="top" width="14.29%" headers="mcps1.3.2.3.1.1.1.5.1.1 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p14521642164411">limit</p>
</td>
<td class="cellrowborder" valign="top" width="14.85%" headers="mcps1.3.2.3.1.1.1.5.1.2 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p1452119425449">No</p>
</td>
<td class="cellrowborder" valign="top" width="19.55%" headers="mcps1.3.2.3.1.1.1.5.1.3 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p12521144220449">Int</p>
</td>
<td class="cellrowborder" valign="top" width="51.31%" headers="mcps1.3.2.3.1.1.1.5.1.4 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p15521942194419">The number of records to be queried. The value ranges from <strong id="sfs_03_0005__en-us_topic_0000001840191462_b161510582045">1</strong> to <strong id="sfs_03_0005__en-us_topic_0000001840191462_b8903170153">1000</strong>, and the default value is <strong id="sfs_03_0005__en-us_topic_0000001840191462_b83799414515">1000</strong>.</p>
</td>
</tr>
<tr id="sfs_03_0005__en-us_topic_0000001840191462_row187591431144410"><td class="cellrowborder" valign="top" width="14.29%" headers="mcps1.3.2.3.1.1.1.5.1.1 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p11977135184418">offset</p>
</td>
<td class="cellrowborder" valign="top" width="14.85%" headers="mcps1.3.2.3.1.1.1.5.1.2 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p11977451164412">No</p>
</td>
<td class="cellrowborder" valign="top" width="19.55%" headers="mcps1.3.2.3.1.1.1.5.1.3 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p6977105154417">Int</p>
</td>
<td class="cellrowborder" valign="top" width="51.31%" headers="mcps1.3.2.3.1.1.1.5.1.4 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p2565102710277">The index location. The query starts from the next data record indexed by this parameter. The default value is <strong id="sfs_03_0005__en-us_topic_0000001840191462_b3405258355">0</strong>, indicating that the query starts from the first data record. The value cannot be a negative number.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
<div class="section" id="sfs_03_0005__en-us_topic_0000001840191462_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_0005__en-us_topic_0000001840191462_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_0005__en-us_topic_0000001840191462_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_0005__en-us_topic_0000001840191462_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_0005__en-us_topic_0000001840191462_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_0005__en-us_topic_0000001840191462_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_0005__en-us_topic_0000001840191462_en-us_topic_0000001311071305_en-us_topic_0000001263239606_p75711025133813">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="sfs_03_0005__en-us_topic_0000001840191462_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_0005__en-us_topic_0000001840191462_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_0005__en-us_topic_0000001840191462_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_0005__en-us_topic_0000001840191462_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_0005__en-us_topic_0000001840191462_en-us_topic_0000001311071305_en-us_topic_0000001263239606_p19571172519388">The MIME type of the request body.</p>
<p id="sfs_03_0005__en-us_topic_0000001840191462_p288693716167">Example: application/json</p>
</td>
</tr>
<tr id="sfs_03_0005__en-us_topic_0000001840191462_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_0005__en-us_topic_0000001840191462_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_0005__en-us_topic_0000001840191462_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_0005__en-us_topic_0000001840191462_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_0005__en-us_topic_0000001840191462_en-us_topic_0000001311071305_en-us_topic_0000001263239606_p17572112515388">The user token.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="sfs_03_0005__en-us_topic_0000001840191462_en-us_topic_0000001311071305_en-us_topic_0000001263239606_request_CreateFileSystemConfiguration" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request body parameters</caption><thead align="left"><tr id="sfs_03_0005__en-us_topic_0000001840191462_en-us_topic_0000001311071305_en-us_topic_0000001263239606_row557492511381"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.1"><p id="sfs_03_0005__en-us_topic_0000001840191462_en-us_topic_0000001311071305_en-us_topic_0000001263239606_p05741325143817">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.2"><p id="sfs_03_0005__en-us_topic_0000001840191462_en-us_topic_0000001311071305_en-us_topic_0000001263239606_p357462514386">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.3"><p id="sfs_03_0005__en-us_topic_0000001840191462_en-us_topic_0000001311071305_en-us_topic_0000001263239606_p2574102514381">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.3.2.5.1.4"><p id="sfs_03_0005__en-us_topic_0000001840191462_en-us_topic_0000001311071305_en-us_topic_0000001263239606_p135754259384">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="sfs_03_0005__en-us_topic_0000001840191462_en-us_topic_0000001311071305_en-us_topic_0000001263239606_row14574142533813"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p18127124211462">without_any_tag</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p11127842204610">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p1712744210467">boolean</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p512714424469">Excludes any of the specified tags. If this parameter is set to <strong id="sfs_03_0005__en-us_topic_0000001840191462_b113991179213">true</strong>, all resources without tags are queried. In this case, the <strong id="sfs_03_0005__en-us_topic_0000001840191462_b1991918016226">tags</strong> field is ignored. If this parameter is set to <strong id="sfs_03_0005__en-us_topic_0000001840191462_b587319114222">false</strong> or not specified, it does not take effect, which means that all resources are returned or resources are filtered by <strong id="sfs_03_0005__en-us_topic_0000001840191462_b1278442182213">tags</strong> or <strong id="sfs_03_0005__en-us_topic_0000001840191462_b422334414225">matches</strong>.</p>
</td>
</tr>
<tr id="sfs_03_0005__en-us_topic_0000001840191462_row14860721162711"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p411758174611">tags</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p0125819462">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p1145814619">List&lt;<a href="#sfs_03_0005__en-us_topic_0000001840191462_table138157172456">tag</a>&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p8257131015210">Includes specified tags. A maximum of 20 tags can be specified. Tag keys must be unique. Each tag key can have a maximum of 20 tag values. A tag value can be empty but the structure cannot be missing. Tag values of the same key must be unique.</p>
<p id="sfs_03_0005__en-us_topic_0000001840191462_p101155874618">The response returns resources containing all tags in this list. Keys in this list are in an AND relationship while values in each key-value structure is in an OR relationship. If this parameter is not specified, all resources will be returned.</p>
<p id="sfs_03_0005__en-us_topic_0000001840191462_p1372785110182">For details, see <a href="#sfs_03_0005__en-us_topic_0000001840191462_table138157172456">Table 3</a>.</p>
</td>
</tr>
<tr id="sfs_03_0005__en-us_topic_0000001840191462_row181183124720"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p13630141234718">sys_tags</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p1863011123475">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p106301712204715">List&lt;<a href="#sfs_03_0005__en-us_topic_0000001840191462_table138157172456">tag</a>&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p2063019129474">Contains system tags. This parameter is only available to users with the <strong id="sfs_03_0005__en-us_topic_0000001840191462_b6307491290">op_service</strong> permission.</p>
<p id="sfs_03_0005__en-us_topic_0000001840191462_p463081234718">This parameter cannot be used with filtering criteria <strong id="sfs_03_0005__en-us_topic_0000001840191462_b8111155513305">without_any_tag</strong> and <strong id="sfs_03_0005__en-us_topic_0000001840191462_b9127557133020">tags</strong> at the same time.</p>
<p id="sfs_03_0005__en-us_topic_0000001840191462_p46304125476">This field contains only one <strong id="sfs_03_0005__en-us_topic_0000001840191462_b1197816458315">tag</strong> structure currently.</p>
<p id="sfs_03_0005__en-us_topic_0000001840191462_p1363091284714">The key is fixed at <strong id="sfs_03_0005__en-us_topic_0000001840191462_b1618933615813">_sys_enterprise_project_id</strong>.</p>
<p id="sfs_03_0005__en-us_topic_0000001840191462_p176301212104713">The value is the ID of an enterprise project.</p>
<p id="sfs_03_0005__en-us_topic_0000001840191462_p26302120470">The key contains only one value. Value <strong id="sfs_03_0005__en-us_topic_0000001840191462_b141491225324">0</strong> indicates the default enterprise project.</p>
<p id="sfs_03_0005__en-us_topic_0000001840191462_p208777415128">For details, see <a href="#sfs_03_0005__en-us_topic_0000001840191462_table138157172456">Table 3</a>.</p>
</td>
</tr>
<tr id="sfs_03_0005__en-us_topic_0000001840191462_row205988515471"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p68421721204718">matches</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p19842102134710">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p4842152110478">List&lt;<a href="#sfs_03_0005__en-us_topic_0000001840191462_table1225513315466">match</a>&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p19107748152014">The fields to be matched. The key in <strong id="sfs_03_0005__en-us_topic_0000001840191462_b13699930192213">match</strong> is a dictionary value fixed at <strong id="sfs_03_0005__en-us_topic_0000001840191462_b2700143019227">resource_name</strong>, meaning that the prefix search is performed based on the value of the key. It will be extended later.</p>
<p id="sfs_03_0005__en-us_topic_0000001840191462_p284212218475">For details, see <a href="#sfs_03_0005__en-us_topic_0000001840191462_table1225513315466">Table 4</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="sfs_03_0005__en-us_topic_0000001840191462_table138157172456"></a><a name="en-us_topic_0000001840191462_table138157172456"></a><table cellpadding="4" cellspacing="0" summary="" id="sfs_03_0005__en-us_topic_0000001840191462_table138157172456" frame="border" border="1" rules="all"><caption><b>Table 3 </b>tag</caption><thead align="left"><tr id="sfs_03_0005__en-us_topic_0000001840191462_row12815217134512"><th align="left" class="cellrowborder" valign="top" width="20.02%" id="mcps1.3.3.4.2.5.1.1"><p id="sfs_03_0005__en-us_topic_0000001840191462_p075752884520">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20.119999999999997%" id="mcps1.3.3.4.2.5.1.2"><p id="sfs_03_0005__en-us_topic_0000001840191462_p1975782834515">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="19.72%" id="mcps1.3.3.4.2.5.1.3"><p id="sfs_03_0005__en-us_topic_0000001840191462_p5757142824519">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40.14%" id="mcps1.3.3.4.2.5.1.4"><p id="sfs_03_0005__en-us_topic_0000001840191462_p5757142812453">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="sfs_03_0005__en-us_topic_0000001840191462_row1581531715458"><td class="cellrowborder" valign="top" width="20.02%" headers="mcps1.3.3.4.2.5.1.1 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p1875732874520">key</p>
</td>
<td class="cellrowborder" valign="top" width="20.119999999999997%" headers="mcps1.3.3.4.2.5.1.2 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p10757182818455">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="19.72%" headers="mcps1.3.3.4.2.5.1.3 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p175716288451">String</p>
</td>
<td class="cellrowborder" valign="top" width="40.14%" headers="mcps1.3.3.4.2.5.1.4 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p127571528134510">The tag key. A tag key can contain a maximum of 128 characters. It can contain letters, digits, and spaces representable in UTF-8 and special characters (_.:=+-@). It cannot start or end with a space and cannot be left empty. Tag keys starting with <strong id="sfs_03_0005__en-us_topic_0000001840191462_b168453231218">_sys_</strong> are system tags, and you cannot start a tag key with <strong id="sfs_03_0005__en-us_topic_0000001840191462_b88519325125">_sys_</strong>.</p>
</td>
</tr>
<tr id="sfs_03_0005__en-us_topic_0000001840191462_row4815131713450"><td class="cellrowborder" valign="top" width="20.02%" headers="mcps1.3.3.4.2.5.1.1 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p97571228134514">values</p>
</td>
<td class="cellrowborder" valign="top" width="20.119999999999997%" headers="mcps1.3.3.4.2.5.1.2 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p675715281456">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="19.72%" headers="mcps1.3.3.4.2.5.1.3 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p6757142819459">List&lt;String&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="40.14%" headers="mcps1.3.3.4.2.5.1.4 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p575752810458">The tag value list. A value can be an empty array but cannot be left blank. If the list specified by <strong id="sfs_03_0005__en-us_topic_0000001840191462_b17876175710175">values</strong> is empty arrays, any tag value can be queried. The values are in the OR relationship.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="sfs_03_0005__en-us_topic_0000001840191462_table1225513315466"></a><a name="en-us_topic_0000001840191462_table1225513315466"></a><table cellpadding="4" cellspacing="0" summary="" id="sfs_03_0005__en-us_topic_0000001840191462_table1225513315466" frame="border" border="1" rules="all"><caption><b>Table 4 </b>match</caption><thead align="left"><tr id="sfs_03_0005__en-us_topic_0000001840191462_row725514316464"><th align="left" class="cellrowborder" valign="top" width="19.86%" id="mcps1.3.3.5.2.5.1.1"><p id="sfs_03_0005__en-us_topic_0000001840191462_p642451364618">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20.369999999999997%" id="mcps1.3.3.5.2.5.1.2"><p id="sfs_03_0005__en-us_topic_0000001840191462_p042411334618">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="19.63%" id="mcps1.3.3.5.2.5.1.3"><p id="sfs_03_0005__en-us_topic_0000001840191462_p74243136469">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40.14%" id="mcps1.3.3.5.2.5.1.4"><p id="sfs_03_0005__en-us_topic_0000001840191462_p7424121313463">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="sfs_03_0005__en-us_topic_0000001840191462_row11255533468"><td class="cellrowborder" valign="top" width="19.86%" headers="mcps1.3.3.5.2.5.1.1 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p242411313462">key</p>
</td>
<td class="cellrowborder" valign="top" width="20.369999999999997%" headers="mcps1.3.3.5.2.5.1.2 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p942461394613">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="19.63%" headers="mcps1.3.3.5.2.5.1.3 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p1424181384610">String</p>
</td>
<td class="cellrowborder" valign="top" width="40.14%" headers="mcps1.3.3.5.2.5.1.4 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p54241113134613">The key. The key is fixed at <strong id="sfs_03_0005__en-us_topic_0000001840191462_b15677225229">resource_name</strong> currently. Other <strong id="sfs_03_0005__en-us_topic_0000001840191462_b1167819211229">key</strong> values will be available later.</p>
</td>
</tr>
<tr id="sfs_03_0005__en-us_topic_0000001840191462_row72551439467"><td class="cellrowborder" valign="top" width="19.86%" headers="mcps1.3.3.5.2.5.1.1 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p184246132461">value</p>
</td>
<td class="cellrowborder" valign="top" width="20.369999999999997%" headers="mcps1.3.3.5.2.5.1.2 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p17424413194612">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="19.63%" headers="mcps1.3.3.5.2.5.1.3 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p1842441316460">String</p>
</td>
<td class="cellrowborder" valign="top" width="40.14%" headers="mcps1.3.3.5.2.5.1.4 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p1342421364614">The value. Each tag value can contain a maximum of 255 Unicode characters. The character set is not verified.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="sfs_03_0005__en-us_topic_0000001840191462_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_0005__en-us_topic_0000001840191462_table580313427466" frame="border" border="1" rules="all"><caption><b>Table 5 </b>Response body parameters</caption><thead align="left"><tr id="sfs_03_0005__en-us_topic_0000001840191462_row188038421467"><th align="left" class="cellrowborder" valign="top" width="20.19%" id="mcps1.3.4.2.2.5.1.1"><p id="sfs_03_0005__en-us_topic_0000001840191462_p33239334473">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20.26%" id="mcps1.3.4.2.2.5.1.2"><p id="sfs_03_0005__en-us_topic_0000001840191462_p1032323344712">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="19.49%" id="mcps1.3.4.2.2.5.1.3"><p id="sfs_03_0005__en-us_topic_0000001840191462_p432363318472">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40.06%" id="mcps1.3.4.2.2.5.1.4"><p id="sfs_03_0005__en-us_topic_0000001840191462_p5323103324714">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="sfs_03_0005__en-us_topic_0000001840191462_row28031242174619"><td class="cellrowborder" valign="top" width="20.19%" headers="mcps1.3.4.2.2.5.1.1 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p133231336478">resources</p>
</td>
<td class="cellrowborder" valign="top" width="20.26%" headers="mcps1.3.4.2.2.5.1.2 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p1532363354712">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="19.49%" headers="mcps1.3.4.2.2.5.1.3 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p13323733184714">List&lt;<a href="#sfs_03_0005__en-us_topic_0000001840191462_table464017234815">resource</a>&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="40.06%" headers="mcps1.3.4.2.2.5.1.4 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p183239331477">The resource list. For details, see <a href="#sfs_03_0005__en-us_topic_0000001840191462_table464017234815">Table 6</a>.</p>
</td>
</tr>
<tr id="sfs_03_0005__en-us_topic_0000001840191462_row580311428464"><td class="cellrowborder" valign="top" width="20.19%" headers="mcps1.3.4.2.2.5.1.1 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p1232313331474">total_count</p>
</td>
<td class="cellrowborder" valign="top" width="20.26%" headers="mcps1.3.4.2.2.5.1.2 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p732316335472">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="19.49%" headers="mcps1.3.4.2.2.5.1.3 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p14323103319476">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="40.06%" headers="mcps1.3.4.2.2.5.1.4 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p2323133374714">The total number of records.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="sfs_03_0005__en-us_topic_0000001840191462_table464017234815"></a><a name="en-us_topic_0000001840191462_table464017234815"></a><table cellpadding="4" cellspacing="0" summary="" id="sfs_03_0005__en-us_topic_0000001840191462_table464017234815" frame="border" border="1" rules="all"><caption><b>Table 6 </b>resource</caption><thead align="left"><tr id="sfs_03_0005__en-us_topic_0000001840191462_row56401722487"><th align="left" class="cellrowborder" valign="top" width="19.86%" id="mcps1.3.4.3.2.5.1.1"><p id="sfs_03_0005__en-us_topic_0000001840191462_p926871613488">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20.69%" id="mcps1.3.4.3.2.5.1.2"><p id="sfs_03_0005__en-us_topic_0000001840191462_p1926801618487">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="19.470000000000002%" id="mcps1.3.4.3.2.5.1.3"><p id="sfs_03_0005__en-us_topic_0000001840191462_p182681516154819">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="39.98%" id="mcps1.3.4.3.2.5.1.4"><p id="sfs_03_0005__en-us_topic_0000001840191462_p0268116164819">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="sfs_03_0005__en-us_topic_0000001840191462_row206401922486"><td class="cellrowborder" valign="top" width="19.86%" headers="mcps1.3.4.3.2.5.1.1 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p7268716114813">resource_id</p>
</td>
<td class="cellrowborder" valign="top" width="20.69%" headers="mcps1.3.4.3.2.5.1.2 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p1026861610486">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="19.470000000000002%" headers="mcps1.3.4.3.2.5.1.3 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p1626851684814">String</p>
</td>
<td class="cellrowborder" valign="top" width="39.98%" headers="mcps1.3.4.3.2.5.1.4 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p7268151614818">The resource ID.</p>
</td>
</tr>
<tr id="sfs_03_0005__en-us_topic_0000001840191462_row2640182184813"><td class="cellrowborder" valign="top" width="19.86%" headers="mcps1.3.4.3.2.5.1.1 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p7268201634818">resource_detail</p>
</td>
<td class="cellrowborder" valign="top" width="20.69%" headers="mcps1.3.4.3.2.5.1.2 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p726851611487">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="19.470000000000002%" headers="mcps1.3.4.3.2.5.1.3 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p1226813161480">Object</p>
</td>
<td class="cellrowborder" valign="top" width="39.98%" headers="mcps1.3.4.3.2.5.1.4 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p72681316204812">The resource details. This value is left empty by default. The value is a resource object used for extension.</p>
</td>
</tr>
<tr id="sfs_03_0005__en-us_topic_0000001840191462_row11640202114818"><td class="cellrowborder" valign="top" width="19.86%" headers="mcps1.3.4.3.2.5.1.1 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p11268161618488">tags</p>
</td>
<td class="cellrowborder" valign="top" width="20.69%" headers="mcps1.3.4.3.2.5.1.2 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p326971614483">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="19.470000000000002%" headers="mcps1.3.4.3.2.5.1.3 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p17269111674810">List&lt;<a href="sfs_03_0002.html#sfs_03_0002__en-us_topic_0000001886392461_table667613216170">resource_tag</a>&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="39.98%" headers="mcps1.3.4.3.2.5.1.4 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p577917184509">The tag list. If there is no tag, an empty array is used by default.</p>
<p id="sfs_03_0005__en-us_topic_0000001840191462_p10269141610483">For details, see <a href="sfs_03_0002.html#sfs_03_0002__en-us_topic_0000001886392461_table667613216170">Table 3</a>.</p>
</td>
</tr>
<tr id="sfs_03_0005__en-us_topic_0000001840191462_row166402216482"><td class="cellrowborder" valign="top" width="19.86%" headers="mcps1.3.4.3.2.5.1.1 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p192695169481">sys_tags</p>
</td>
<td class="cellrowborder" valign="top" width="20.69%" headers="mcps1.3.4.3.2.5.1.2 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p17269201664810">No</p>
</td>
<td class="cellrowborder" valign="top" width="19.470000000000002%" headers="mcps1.3.4.3.2.5.1.3 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p7269716104819">List&lt;<a href="sfs_03_0002.html#sfs_03_0002__en-us_topic_0000001886392461_table667613216170">resource_tag</a>&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="39.98%" headers="mcps1.3.4.3.2.5.1.4 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p8269416114813">This parameter is only available to users with the <strong id="sfs_03_0005__en-us_topic_0000001840191462_b566614320277">op_service</strong> permission.</p>
<p id="sfs_03_0005__en-us_topic_0000001840191462_p132691316144813">This field contains only one <strong id="sfs_03_0005__en-us_topic_0000001840191462_b3375036202717">resource_tag</strong> structure currently.</p>
<p id="sfs_03_0005__en-us_topic_0000001840191462_p52691316184814">The key is fixed at <strong id="sfs_03_0005__en-us_topic_0000001840191462_b13248544132719">_sys_enterprise_project_id</strong>.</p>
<p id="sfs_03_0005__en-us_topic_0000001840191462_p14269181624812">The value is the ID of the enterprise project. Value <strong id="sfs_03_0005__en-us_topic_0000001840191462_b15707121612818">0</strong> indicates the default enterprise project.</p>
<p id="sfs_03_0005__en-us_topic_0000001840191462_p467115752516">For details, see <a href="sfs_03_0002.html#sfs_03_0002__en-us_topic_0000001886392461_table667613216170">Table 3</a>.</p>
</td>
</tr>
<tr id="sfs_03_0005__en-us_topic_0000001840191462_row483072914414"><td class="cellrowborder" valign="top" width="19.86%" headers="mcps1.3.4.3.2.5.1.1 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p1326911615486">resource_name</p>
</td>
<td class="cellrowborder" valign="top" width="20.69%" headers="mcps1.3.4.3.2.5.1.2 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p1983092918417">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="19.470000000000002%" headers="mcps1.3.4.3.2.5.1.3 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p38304295415">String</p>
</td>
<td class="cellrowborder" valign="top" width="39.98%" headers="mcps1.3.4.3.2.5.1.4 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p1326931684817">The resource name. This parameter is an empty string if there is no resource name.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="sfs_03_0005__en-us_topic_0000001840191462_en-us_topic_0000001311071305_en-us_topic_0000001263239606_section45751825203817"><h4 class="sectiontitle">Example Request</h4><p id="sfs_03_0005__en-us_topic_0000001840191462_p4983152214167">Listing resources (with the project ID set to **c80a2157ba1d46c0825265947342077c**, offset to **0**, and limit to **10**):</p>
<pre class="screen" id="sfs_03_0005__en-us_topic_0000001840191462_screen1181631412359">POST https://{endpoint}/v3/sfs/tms/c80a2157ba1d46c0825265947342077c/file-systems/resource-instances/filter?limit=10&amp;offset=0</pre>
<p id="sfs_03_0005__en-us_topic_0000001840191462_p2041152310166">Request body example:</p>
<pre class="screen" id="sfs_03_0005__en-us_topic_0000001840191462_screen158591581338">{
"tags":[
{
"key":"key1",
"values":[
"value1",
"value2"
]
},
{
"key":"key2",
"values":[
"value1",
"value2"
]
}
],
"matches":[
{
"key":"resource_name",
"value":"resource1"
}
],
"without_any_tag":"false"
}</pre>
</div>
<div class="section" id="sfs_03_0005__en-us_topic_0000001840191462_en-us_topic_0000001311071305_en-us_topic_0000001263239606_section1057692523814"><h4 class="sectiontitle">Example Response</h4><pre class="screen" id="sfs_03_0005__en-us_topic_0000001840191462_screen1425511017250">{
"resources":[
{
"resource_detail":"",
"resource_id":"resource1",
"resource_name":"resource1",
"tags":[
{
"key":"key1",
"value":"value1"
}
],
"sys_tags":[]
}
],
"total_count":1
}</pre>
</div>
<div class="section" id="sfs_03_0005__en-us_topic_0000001840191462_en-us_topic_0000001311071305_en-us_topic_0000001263239606_section9576122583811"><h4 class="sectiontitle">Status Codes</h4><ul id="sfs_03_0005__en-us_topic_0000001840191462_ul3162613183218"><li id="sfs_03_0005__en-us_topic_0000001840191462_li17162131319327">Normal</li></ul>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="sfs_03_0005__en-us_topic_0000001840191462_table368724141513" frame="border" border="1" rules="all"><thead align="left"><tr id="sfs_03_0005__en-us_topic_0000001840191462_row8682024181510"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.7.3.1.3.1.1"><p id="sfs_03_0005__en-us_topic_0000001840191462_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_0005__en-us_topic_0000001840191462_p26822418151">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="sfs_03_0005__en-us_topic_0000001840191462_row168024161516"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.3.1.3.1.1 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p1168424141515">200</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.3.1.3.1.2 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p16817240155">Resources listed.</p>
</td>
</tr>
</tbody>
</table>
</div>
<ul id="sfs_03_0005__en-us_topic_0000001840191462_ul0640161683218"><li id="sfs_03_0005__en-us_topic_0000001840191462_li17640141673214">Abnormal</li></ul>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="sfs_03_0005__en-us_topic_0000001840191462_en-us_topic_0000001311071305_en-us_topic_0000001263239606_status_code" frame="border" border="1" rules="all"><thead align="left"><tr id="sfs_03_0005__en-us_topic_0000001840191462_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_0005__en-us_topic_0000001840191462_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_0005__en-us_topic_0000001840191462_en-us_topic_0000001311071305_en-us_topic_0000001263239606_p12576112573812">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="sfs_03_0005__en-us_topic_0000001840191462_row20215812131416"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.5.1.3.1.1 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p141019302141">400</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.5.1.3.1.2 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p410630191412">Invalid tag parameter.</p>
</td>
</tr>
<tr id="sfs_03_0005__en-us_topic_0000001840191462_row1922211518149"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.5.1.3.1.1 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p610133041416">401</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.5.1.3.1.2 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p1510113071415">Certification failed.</p>
</td>
</tr>
<tr id="sfs_03_0005__en-us_topic_0000001840191462_row17969131741415"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.5.1.3.1.1 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p10102309145">403</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.5.1.3.1.2 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p710103010141">Authentication failed.</p>
</td>
</tr>
<tr id="sfs_03_0005__en-us_topic_0000001840191462_row7978112011418"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.5.1.3.1.1 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p1410183031417">404</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.5.1.3.1.2 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p910133017145">Resource not found.</p>
</td>
</tr>
<tr id="sfs_03_0005__en-us_topic_0000001840191462_row9668162716146"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.5.1.3.1.1 "><p id="sfs_03_0005__en-us_topic_0000001840191462_p1610430181412">500</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.5.1.3.1.2 "><p id="sfs_03_0005__en-us_topic_0000001840191462_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>
View Git Blame Copy Permalink