CreateWorkitemAttachment - 上传工作项附件-云效(Alibaba Cloud DevOps)-阿里云帮助中心

服务接入点与授权信息

获取服务接入点：替换 API 请求语法中的 {domain} 。
获取个人访问令牌。
获取organizationId：仅中心版需要。请前往组织管理后台的基本信息页面获取组织 ID 。

产品	资源	所需权限
项目协作	工作项附件	读写

请求语法

中心版

POST https://{domain}/oapi/v1/projex/organizations/{organizationId}/workitems/{id}/attachments

Region版

POST https://{domain}/oapi/v1/projex/workitems/{id}/attachments

请求头

参数	类型	是否必填	描述	示例值
x-yunxiao-token	string	是	个人访问令牌。	pt-0fh3**0fbG_35af**0484

请求参数

参数	类型	位置	是否必填	描述	示例值
id	string	path	是	工作项唯一标识。
organizationId	string	path	是：中心版否：Region版	工作项唯一标识。
operatorId	string	query	否	操作者的 id；个人 token 时该参数无效；应用 token（如 AK-ADMIN）场景为必填逻辑由服务端校验。
-	multipart/form-data	body	否
file	File	body	是	待上传文件（表单字段名 file，与 @RequestPart("file") 一致）。

请求示例

中心版

curl -X 'POST' \
  'https://{domain}/oapi/v1/projex/organizations/{organizationId}/workitems/{id}/attachments?operatorId={operatorId}' \
  -H 'Content-Type: application/json' \
  -H 'x-yunxiao-token: pt-0fh3****0fbG_35af****0484' \
  --form 'file=@""'

Region版

curl -X 'POST' \
  'https://{domain}/oapi/v1/projex/workitems/{id}/attachments?operatorId={operatorId}' \
  -H 'Content-Type: application/json' \
  -H 'x-yunxiao-token: pt-0fh3****0fbG_35af****0484' \
  --form 'file=@""'

返回参数

参数	类型	描述	示例值
-	object	文件 id。
id	string	上传后的标识。

返回示例

{
    "id": ""
}

错误码

访问错误码中心查看 API 相关错误码。