云服务器内容精选

  • 响应示例 状态码: 200 OK { "total" : 1, "issue_statuses" : [ { "id" : "123cefde62004de2b62b5e8dd2c2b3af", "status_id" : 1, "name" : "新建", "tracker_ids" : [ 0 ], "status_attribute" : { "id" : 1, "name" : "string" } } ] }
  • URI GET /v4/projects/{project_id}/statuses 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String devcloud项目的32位id 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 查询偏移量 缺省值:0 limit 否 Integer 一次返回的数据,最小1,最大100 最小值:1 最大值:100 缺省值:10 tracker_id 否 Integer 自定义字段支持的工作项类型 2任务/Task,3缺陷/Bug,5Epic,6Feature,7Story
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 total Integer 状态总数 issue_statuses Array of IssueStatus objects 状态列表 表5 IssueStatus 参数 参数类型 描述 id String 状态uuid status_id Integer 状态数字id name String 状态名称 tracker_ids Array of integers 关联的工作项类型列表 status_attribute StatusAttribute object 状态属性类型 开始态,进行态,结束态 表6 StatusAttribute 参数 参数类型 描述 id Integer 状态属性id name String 状态属性名称 状态码: 400 表7 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码: 401 表8 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码
  • 响应示例 状态码: 200 OK { "description" : "module demo", "module_name" : "demo", "module_id" : 46691, "owner" : { "user_id" : "09d75cde5180d4481f91c018e89cb8e2", "user_num_id" : 4091, "user_name" : "demo_user_name_06", "nick_name" : "模块demo" } }
  • 响应参数 状态码: 200 表5 响应Body参数 参数 参数类型 描述 description String 模块描述 module_name String 模块名称 module_id Integer 模块id owner ModuleOwner object 模块责任人 表6 ModuleOwner 参数 参数类型 描述 user_id String 用户32位字符串id user_num_id Integer 用户数字id user_name String 用户名称 nick_name String 用户昵称 状态码: 400 表7 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码: 401 表8 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码
  • 请求示例 Post https://{endpoint}/v4/projects/0792b7d26cb74bd799cbae80063dc74a/modules { "description" : "module demo", "module_name" : "demo", "parent_module_id" : 1, "owner" : { "user_id" : "09d75cde5180d4481f91c018e89cb8e2" } }
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 表3 请求Body参数 参数 是否必选 参数类型 描述 description 否 String 模块描述 module_name 是 String 模块名称 parent_module_id 否 Integer 父模块id owner 是 UserRequest object 模块责任人 表4 UserRequest 参数 是否必选 参数类型 描述 user_id 是 String 用户32位字符串id
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 domain_name String 领 域名 称 domain_id String 领域id 状态码: 400 表5 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码: 401 表6 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 最小长度:10 最大长度:32768 表3 请求Body参数 参数 是否必选 参数类型 描述 iteration_ids 是 Array of integers 迭代的id 数组长度:1 - 10
  • 响应示例 状态码: 200 ok { "added_work_hours" : [ { "work_hours_id" : "7da14cf9f3c111eda5a5fa163ec9f6c1", "issue_id" : 123456, "user_name" : "user_name", "user_nick_name" : "O_O", "work_date" : "2023-05-15", "work_hours" : "2.0", "work_hours_type_name" : "研发设计" } ] }
  • 请求示例 Post https://{endpoint}/v4/projects/e2da96a5d2c845e284f0ad47f8ca8cb2/issues/123456/work-hours { "start_date" : "2023-05-15", "due_date" : "2023-05-15", "work_hours" : 2.0, "work_hours_type_id" : 21 }
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 参数解释:用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制:不涉及 取值范围:最小长度:10,最大长度:32768 默认取值:不涉及 表3 请求Body参数 参数 是否必选 参数类型 描述 start_date 是 String 参数解释:工时开始日期,年-月-日 约束限制:正则表达式, ^\d{4}-\d{2}-\d{2}$ 取值范围:匹配格式为 YYYY-MM-DD 的日期字符串,MM 是两位数的月份限制取值01-12,DD是两位数的日期限制取值01-31 默认取值:不涉及 due_date 是 String 参数解释:工时结束日期,年-月-日 约束限制:正则表达式, ^\d{4}-\d{2}-\d{2}$ 取值范围:匹配格式为 YYYY-MM-DD 的日期字符串,MM 是两位数的月份限制取值01-12,DD是两位数的日期限制取值01-31 默认取值:不涉及 work_hours 是 Double 参数解释:工时总数(若工时日期范围包含多天,单日工时将设为“工时总数/天数”) 约束限制:不涉及 取值范围:最小值:0.0,最大值:100000000 默认取值:不涉及 work_hours_type_id 否 Integer 参数解释:工时类型id (项目预设工时类型id及名称对照:21:研发设计,22:后端开发,23:前端开发(Web),24:前端开发(小程序),25:前端开发(App), 26:测试验证,27:缺陷修复,28:UI设计,29:会议,30:公共事务,31:培训,32:研究,33:其它,34:调休请假) 约束限制:不涉及 取值范围:最小值:21,最大值:34 默认取值:不涉及
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 added_work_hours Array of added_work_hours objects 已添加的工时列表 表5 added_work_hours 参数 参数类型 描述 work_hours_id String 工时id issue_id Integer 添加工时对应的工作项id user_name String 工时添加用户的用户名 user_nick_name String 工时添加用户的用户昵称 work_date String 工时日期 年-月-日 work_hours Double 工时数 work_hours_type_name String 工时类型名称 (项目预设工时类型id及名称对照:21:研发设计,22:后端开发,23:前端开发(Web),24:前端开发(小程序),25:前端开发(App), 26:测试验证,27:缺陷修复,28:UI设计,29:会议,30:公共事务,31:培训,32:研究,33:其它,34:调休请假) 状态码: 400 表6 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码: 401 表7 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码
  • URI POST /v4/projects/{project_id}/issues/{issue_id}/work-hours 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释:项目的32位uuid,项目唯一标识,可以通过ListProjectsV4接口查询项目列表 约束限制:正则表达式, ^[A-Za-z0-9]{32}$ 取值范围:字符串,最小长度:32,最大长度:32 默认取值:不涉及 issue_id 是 Integer 参数解释:工作项id,可通过ListIssuesV4接口高级查询工作项 约束限制:正则表达式,[0-9]{1,10}$ 取值范围:最小长度:1,最大长度:10 默认取值:不涉及
  • 后续操作 完成新建自定义报表或通过系统预置报表模板新建报表后,拥有报表的“编辑报表”、“删除报表”、“移动报表”“导出报表”权限的成员,可以执行以下操作: 对于新创建的报表,可以进行如下的操作。 表3 报表基本操作 操作项 说明 报表的图形和表格显示切换 单击报表卡片右上角的,可以切换报表的显示形式。 全屏查看报表 单击报表卡片右上角,可以全屏查看报表。 保存图表 单击报表卡片右上角下的“保存图表”,可以将当前报表保存为png图片。 导出表格 单击报表卡片右上角下的“导出表格”,可以将当前报表数据导出为Excel文件。 编辑报表 单击报表卡片右上角下的“编辑报表”,可以进入报表详情页进行编辑。 移动报表 单击报表卡片右上角下的“移动报表”,可以将当前报表移动至其他报表分类中。 删除报表 单击报表卡片右上角下的“删除报表”,可以将当前报表进行删除。 说明: 报表的删除为彻底删除,一旦删除后,不可恢复。