文档首页/ 需求管理 CodeArts Req/ API参考/ API/ IPD字段管理/ 查询指定租户级字段使用情况
更新时间:2025-09-11 GMT+08:00
分享

查询指定租户级字段使用情况

功能介绍

查询指定租户级字段使用情况,返回使用该字段的项目信息和工作项类型。

调用方法

请参见如何调用API

URI

GET /v1/ipdprojectservice/tenant/fields/{field_id}/used

表1 路径参数

参数

是否必选

参数类型

描述

field_id

String

参数解释:

工作项字段id,可通过 查询IPD项目租户字段列表接口获取,响应消息体中的field_id字段的值就是工作项字段field_id。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

[数组元素]

Array of FieldUsage objects

字段的使用情况,返回使用的项目id和工作项类型。

表3 FieldUsage

参数

参数类型

描述

domain_id

String

参数解释:

使用该字段的domain_id。

约束限制:

不涉及。

project_name

String

参数解释:

使用该字段的项目名称。

约束限制:

不涉及。

project_id

String

参数解释:

使用该字段的项目Id。

取值范围:

不涉及。

model_id

String

参数解释:

使用该字段的项目模型id。

取值范围:

10001(系统设备类)

10002(独立软件类)

10003(自运营软件/云服务类)。

create_by

String

参数解释:

使用该字段的项目创建者Id。

取值范围:

不涉及。

category_codes

String

参数解释:

使用该字段的工作项类型,多个工作项类型使用英文逗号分隔。

取值范围:

系统设备类项目可选值为:RR/SF/IR/SR/AR/Task/Bug。

独立软件类项目可选值为:RR/SF/IR/US/Task/Bug。

云服务类项目可选值为:RR/Epic/FE/US/Task/Bug。

请求示例

查询指定租户字段使用情况

https://{endpoint}/v1/ipdprojectservice/tenant/fields/1162422376023437316/used

响应示例

状态码:200

ok

[ {
  "domain_id" : "1162174826943066113",
  "project_name" : "IPD-系统设备类11111111111111111",
  "project_id" : "056b156fc4a647a78d92a464afe58de6",
  "model_id" : "10001",
  "create_by" : "c2d89e38a64a466f8f945f595df4402d",
  "category_codes" : "IR,SF"
} ]

状态码

状态码

描述

200

ok

错误码

请参见错误码

相关文档