调用ListWorkItemAllFields获取工作项字段列表_云效(Apsara Devops)-阿里云帮助中心

获取工作项字段列表。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求语法

GET /organization/{organizationId}/workitems/fields/listAll

请求参数

名称	类型	必填	描述	示例值
organizationId	string	是	企业标识，也称企业 id，字符串形式，可在云效访问链接中获取，如 https://devops.aliyun.com/organization/【OrganizationId】	5ebbc0228123212b59xxxxx
spaceType	string	是	资源类型	Project
spaceIdentifier	string	是	项目唯一标识 id，同 projectId，项目唯一标识	e8bxxxxxxxxxxxxxxxx23
workitemTypeIdentifier	string	是	工作项类型 id，工作项类型的列表和 ID 可以从 ListProjectWorkitemTypes 中获取	dfexxxxxf4fee18xxxxx36

返回参数

名称	类型	描述	示例值
	object
requestId	string	请求 id，每次请求都是唯一值，便于后续排查问题	ASSDS-ASSASX-XSAXSA-XSAXSAXS
errorMsg	string	错误信息	error
errorCode	string	错误码	Openapi.RequestError
success	boolean	true 或者 false	true
fields	object []	字段信息
creator	string	创建人阿里云 accountId	19xx7043xxxxxxx914
description	string	描述信息	字段的具体信息
gmtCreate	long	创建时间的时间戳，单位毫秒	1623916393000
gmtModified	long	修改时间的时间戳，单位毫秒	1623916393000
type	string	区分不同的类型，如系统字段：NativeField，用户自定义字段：CustomField	NativeField
identifier	string	字段唯一标识符	e8bxxxxxxxxxxxxxxxx23
modifier	string	修改人阿里云 accountId	19xx7043xxxxxxx914
name	string	字段名称	负责人
format	string	字段格式	list
className	string	字段类型	例：date
resourceType	string	区分不同的适用对象	例：Workitem
defaultValue	string	默认值	123
isRequired	boolean	是否必填	false
isSystemRequired	boolean	是否是系统必须字段，比如：负责人、状态等。	false
linkWithService	string	联动的服务，比如迭代，迭代服务开启/关闭，这个字段加进/剔除出对应的模板；字段模板里，这类字段不能手动添加或删除	null
isShowWhenCreate	boolean	创建时是否展示	false
options	object []	待选值
identifier	string	待选值的唯一标识	重复的缺陷
fieldIdentifier	string	字段唯一标识	e8bxxxxxxxxxxxxxxxx23
value	string	待选值中文名称	重复的缺陷
valueEn	string	待选值英文名称	null
displayValue	string	根据语言环境获取当前展示的值	重复的缺陷
position	long	待选值顺序	1
level	long	展示级别，数字范围 1~9，数字越大，颜色越浅。	1

示例

正常返回示例

JSON格式

{
  "requestId": "ASSDS-ASSASX-XSAXSA-XSAXSAXS",
  "errorMsg": "error",
  "errorCode": "Openapi.RequestError",
  "success": true,
  "fields": [
    {
      "creator": "19xx7043xxxxxxx914",
      "description": "字段的具体信息",
      "gmtCreate": 1623916393000,
      "gmtModified": 1623916393000,
      "type": "NativeField",
      "identifier": "e8bxxxxxxxxxxxxxxxx23",
      "modifier": "19xx7043xxxxxxx914",
      "name": "负责人",
      "format": "list",
      "className": "例：date",
      "resourceType": "例：Workitem",
      "defaultValue": "123",
      "isRequired": false,
      "isSystemRequired": false,
      "linkWithService": "null",
      "isShowWhenCreate": false,
      "options": [
        {
          "identifier": "重复的缺陷",
          "fieldIdentifier": "e8bxxxxxxxxxxxxxxxx23",
          "value": "重复的缺陷",
          "valueEn": "null",
          "displayValue": "重复的缺陷",
          "position": 1,
          "level": 1
        }
      ]
    }
  ]
}

错误码

HTTP status code	错误码	错误信息	描述
400	Openapi.RequestError	request error	OpenAPI请求数据错误
403	Operate.NoPermission	NoPermission	没有权限

访问错误中心查看更多错误码。