请求支持:通过Collibra API获取资产描述的实现方案
获取Collibra资产描述的API方案
核心逻辑
资产描述在Collibra里是作为资产属性存在的,你得先定位到目标资产,再提取对应属性的值——别找错地方,它不是资产本身的基础字段,是挂在资产上的属性条目。
具体操作步骤
1. 先搞定API认证
Collibra API必须先认证,用API密钥最方便,请求头里带上:
Authorization: Bearer 你的API密钥
2. 已知资产ID时直接获取
如果已经知道目标资产的ID,直接调用GET /api/v2/assets/{资产ID}接口。返回的JSON里有个attributes数组,找到type.name是“Description”(或者你租户里自定义的描述属性名称)的那条,value字段就是你要的资产描述。
举个响应片段的例子:
{ "id": "abc123-def456-ghi789-jkl012", "attributes": [ { "type": { "name": "Description" }, "value": "这是某客户数据资产的详细描述内容" } ] }
3. 不知道资产ID?用搜索接口批量捞
如果只知道资产名称或其他特征,用POST /api/v2/assets/search接口过滤,还能指定只返回描述属性,减少冗余数据:
POST /api/v2/assets/search Authorization: Bearer 你的API密钥 Content-Type: application/json { "filter": { "name": { "contains": "客户数据" } }, "attributes": ["Description"] // 只返回描述属性,省流量 }
踩坑提醒
- 确认属性名称/ID:不同租户可能自定义描述属性的名称,要是找不到,先调用
GET /api/v2/attributeTypes查所有属性类型,找到对应描述属性的标识。 - 权限要够:你的API账号必须有目标资产的读取权限,不然会返回403错误,得找管理员调权限。
内容的提问来源于stack exchange,提问作者user24445137
相关产品推荐
相关产品推荐

