- 最新动态
- 功能总览
- 服务公告
- 产品介绍
- 计费说明
- 快速入门
- 用户指南
- 最佳实践
- API参考
- SDK参考
- 场景代码示例
-
常见问题
- 概念类
- 规格类
- 限制类
- 网络类
- 计费类
-
其他类
- 如何从云服务器访问文件系统?
- 如何确认Linux云服务器上的文件系统处于可用状态?
- 弹性文件服务会占用用户的哪些资源?
- SFS容量型文件系统挂载后为什么容量显示为10P?
- 通用文件系统挂载后为什么会显示250TB?
- 如何在弹性文件服务SFS和对象存储服务OBS之间进行数据迁移?
- 弹性文件服务支持多可用区吗?
- 可以将SFS容量型文件系统升级为SFS Turbo文件系统吗?
- 可以将SFS Turbo标准型升级为SFS Turbo标准型-增强版吗?
- 如何在弹性文件服务SFS和云硬盘EVS之间进行数据迁移?
- 可以直接从云下访问弹性文件服务吗?
- 如何删除.nfs类型的文件?
- 将数据从SFS容量型迁移至SFS Turbo后,容量为什么变大了?
- 如何提高SFS Turbo文件系统拷贝和删除操作的效率?
- SFS Turbo二级及三级目录权限如何继承?
- 如何将SFS Turbo部署至CCE?
- 如何发挥SFS Turbo文件系统的最大性能?
- Linux内核5.4版本之后客户端的NFSv3文件系统顺序读业务场景性能不符合预期,如何处理?
- 故障排除
- 视频帮助
- 文档下载
- 通用参考
链接复制成功!
查询资源实例列表
功能介绍
使用标签过滤资源实例。优先按照资源创建时间倒序排序。
URI
- POST /v3/sfs/tms/{project_id}/file-systems/resource-instances/filter
- 参数说明
参数
是否必选
参数类型
描述
project_id
是
String
操作用户的项目ID,获取方法请参见获取项目ID。
limit
否
Int
查询记录数。默认为1000,limit最大为1000,最小值为1,不能为负数。
offset
否
Int
索引位置。 从第一条数据偏移offset条数据后开始查询。默认为0(偏移0条数据,表示从第一条数据开始查询),必须为数字,不能为负数。
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
Content-type |
是 |
String |
发送的实体的MIME类型。 示例:application/json。 |
X-Auth-Token |
否 |
String |
用户Token。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
without_any_tag |
否 |
boolean |
不包含任意一个标签。该字段为true时查询所有不带标签的资源,此时忽略 “tags”字段。该字段为false或者未提供该参数时,该条件不生效,即返回所有资源或按"tags","matches"条件过滤的资源。 |
tags |
否 |
List<tag> |
包含标签。最多包含20个tag。tag之间Key不能重复,每个key下面的value最多20个,每个key对应的value可以为空数组但结构体不能缺失,且同一个key中values不能重复。 结果返回包含所有标签的资源列表,key之间是与的关系,key-value结构中value是或的关系。无tag过滤条件时返回全量数据。 详细说明参见表3。 |
sys_tags |
否 |
List<tag> |
包含系统标签。仅op_service权限可以使用此字段。 sys_tags和过滤条件without_any_tag 、tags不能同时使用。 目前此字段只包含一个tag结构体: key:_sys_enterprise_project_id value:企业项目id列表 目前key下面只包含一个value。0表示默认企业项目。 详细说明参见表3。 |
matches |
否 |
List<match> |
搜索字段。match中key为固定字典值,当前key固定为resource_name,表示根据key对应的value值实现前缀搜索,后续再扩展。 详细说明参见表4。 |
响应参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
resource_id |
是 |
String |
资源ID。 |
resource_detail |
是 |
Object |
资源详情。默认为空。 资源对象,用于扩展。 |
tags |
是 |
List<resource_tag> |
标签列表。没有标签默认为空数组。 详情说明参见表3。 |
sys_tags |
否 |
List<resource_tag> |
仅op_service权限才可以获取此字段。 目前只包含一个resource_tag 结构体: key:_sys_enterprise_project_id value:企业项目id,0表示默认企业项目。 详情说明参见表3。 |
resource_name |
是 |
String |
资源名称,资源没有名称时默认为空字符串。 |
请求示例
projectId为“c80a2157ba1d46c0825265947342077c”,offset为0,limit为10,查询资源实例示例:
POST https://{endpoint}/v3/sfs/tms/c80a2157ba1d46c0825265947342077c/file-systems/resource-instances/filter?limit=10&offset=0
请求体示例:
{ "tags":[ { "key":"key1", "values":[ "value1", "value2" ] }, { "key":"key2", "values":[ "value1", "value2" ] } ], "matches":[ { "key":"resource_name", "value":"resource1" } ], "without_any_tag":"false" }
响应示例
{ "resources":[ { "resource_detail":"", "resource_id":"resouece1", "resource_name":"resouece1", "tags":[ { "key":"key1", "value":"value1" } ], "sys_tags":[] } ], "total_count":1 }
状态码
- 正常
状态码 |
描述 |
---|---|
200 |
查询资源实例列表成功。 |
- 异常
状态码 |
描述 |
---|---|
400 |
标签等参数非法。 |
401 |
认证失败。 |
403 |
鉴权失败。 |
404 |
资源未找到。 |
500 |
系统异常。 |