更新时间:2025-09-12 GMT+08:00
分享

查询Obs桶文件标签信息

功能介绍

此API用于查询Obs桶文件的标签信息。通过提供项目ID、实例ID以及其他可选参数,可以获取Obs桶文件的详细标签信息。

调用方法

请参见如何调用API

URI

GET /v1/{project_id}/metadata/detail/obs

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID

表2 Query参数

参数

是否必选

参数类型

描述

bucket_name

String

Obs桶名称

ins_id

String

实例ID

marker

String

分页标记,用于获取下一页结果

object_full_path

String

对象完整路径

prefix

String

过滤前缀,用于过滤结果

limit

Integer

每页结果数量限制

请求参数

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

marker

String

标记,用于分页或标识的字符串。

obs_infos

Array of ObsMetadataInfo objects

OBS元数据信息列表,包含多个OBS元数据信息。

total

Integer

总数,表示OBS元数据信息的总数。

表4 ObsMetadataInfo

参数

参数类型

描述

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

更新时间,资产的最后更新时间戳。

表5 Classification

参数

参数类型

描述

children

Array of ObsPatchInfo objects

子分类信息列表,包含多个子分类信息。

lock

Boolean

锁定状态,表示分类是否被锁定。

template_id

String

模板ID,用于唯一标识模板。

表6 LevelInfo

参数

参数类型

描述

color_number

Integer

颜色编号,表示级别的颜色标识。

id

String

ID,用于唯一标识级别。

lock

Boolean

锁定状态,表示级别是否被锁定。

name

String

名称,级别的名称。

tag_gen_type

String

标签生成类型,表示级别的标签生成方式。

表7 ObsPatchInfo

参数

参数类型

描述

id

String

ID,用于唯一标识。

name

String

名称,标签或分类的名称。

tag_gen_type

String

标签生成类型,表示标签的生成方式。

请求示例

响应示例

状态码

状态码

描述

200

OK

401

未授权,需要进行身份验证

403

无权限,禁止访问

404

未找到资源

错误码

请参见错误码

相关文档