# 查询OBS桶文件标签信息 - SearchObsMetadataDetail
#### 功能介绍
此API用于查询OBS桶文件的标签信息。通过提供项目ID、实例ID以及其他可选参数，可以获取OBS桶文件的详细标签信息。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-dsc/dsc_02_0008.html)。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dsc/dsc_02_0031.html)。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
 
#### URI
GET /v1/{project_id}/metadata/detail/obs
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述   |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目ID |
   
表2Query参数 
| 参数               | 是否必选 | 参数类型    | 描述             |
|:---|:---|:---|:---|
| 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元数据信息的总数。        |
   
 表4ObsMetadataInfo 
| 参数               | 参数类型                                                                             | 描述                   |
|:---|:---|:---|
| 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                                                                             | 更新时间，资产的最后更新时间戳。     |
   
 表5Classification 
| 参数          | 参数类型                                                                             | 描述                 |
|:---|:---|:---|
| children    | Array of [ObsPatchInfo] objects | 子分类信息列表，包含多个子分类信息。 |
| lock        | Boolean                                                                          | 锁定状态，表示分类是否被锁定。    |
| template_id | String                                                                           | 模板ID，用于唯一标识模板。     |
   
 表6LevelInfo 
| 参数           | 参数类型    | 描述                  |
|:---|:---|:---|
| color_number | Integer | 颜色编号，表示级别的颜色标识。     |
| id           | String  | ID，用于唯一标识级别。        |
| lock         | Boolean | 锁定状态，表示级别是否被锁定。     |
| name         | String  | 名称，级别的名称。           |
| tag_gen_type | String  | 标签生成类型，表示级别的标签生成方式。 |
   
 表7ObsPatchInfo 
| 参数           | 参数类型   | 描述                |
|:---|:---|:---|
| id           | String | ID，用于唯一标识。        |
| name         | String | 名称，标签或分类的名称。      |
| tag_gen_type | String | 标签生成类型，表示标签的生成方式。 |
   
#### 请求示例
查询OBS桶文件标签信息
```
GET /v1/{project_id}/metadata/detail/obs?ins_id=XXXX&bucket_name=XXX
```
#### 响应示例
无
#### 状态码
| 状态码 | 描述           |
|:---|:---|
| 200 | OK           |
| 401 | 未授权，需要进行身份验证 |
| 403 | 无权限，禁止访问     |
| 404 | 未找到资源        |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-dsc/ErrorCode.html)。