查询OBS桶文件标签信息 - SearchObsMetadataDetail
功能介绍
此API用于查询OBS桶文件的标签信息。通过提供项目ID、实例ID以及其他可选参数，可以获取OBS桶文件的详细标签信息。
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
URI
GET /v1/{project_id}/metadata/detail/obs
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 项目ID |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
bucket_name | 否 | String | OBS桶名称 |
ins_id | 是 | String | 实例ID |
marker | 否 | String | 分页标记，用于获取下一页结果 |
object_full_path | 否 | String | 对象完整路径 |
prefix | 否 | String | 过滤前缀，用于过滤结果 |
limit | 否 | Integer | 每页结果数量限制 |
请求参数
无
响应参数
状态码：200
参数 | 参数类型 | 描述 |
|---|---|---|
marker | String | 标记，用于分页或标识的字符串。 |
obs_infos | Array of ObsMetadataInfo objects | OBS元数据信息列表，包含多个OBS元数据信息。 |
total | Integer | 总数，表示OBS元数据信息的总数。 |
参数 | 参数类型 | 描述 |
|---|---|---|
classification | Classification object | 分类信息，包含资产的分类详情。 |
description | String | 描述，对资产的描述信息。 |
ins_id | String | 实例ID，用于唯一标识实例。 |
is_folder | Boolean | 是否为文件夹，表示资产是否为文件夹类型。 |
levels | LevelInfo object | 级别信息，包含资产的级别详情。 |
name | String | 名称，资产的名称。 |
object_full_path | String | 完整路径，资产的完整路径信息。 |
project_id | String | 项目ID，用于唯一标识项目。 |
tags | Array of ObsPatchInfo objects | 标签信息列表，包含多个标签信息。 |
update_time | Long | 更新时间，资产的最后更新时间戳。 |
参数 | 参数类型 | 描述 |
|---|---|---|
children | Array of ObsPatchInfo objects | 子分类信息列表，包含多个子分类信息。 |
lock | Boolean | 锁定状态，表示分类是否被锁定。 |
template_id | String | 模板ID，用于唯一标识模板。 |
请求示例
查询OBS桶文件标签信息
GET /v1/{project_id}/metadata/detail/obs?ins_id=XXXX&bucket_name=XXX 响应示例
无
状态码
状态码 | 描述 |
|---|---|
200 | OK |
401 | 未授权，需要进行身份验证 |
403 | 无权限，禁止访问 |
404 | 未找到资源 |
错误码
请参见错误码。
