API概览

更新时间:
复制 MD 格式

API标准及多语言预置SDK

本产品(devops/2021-06-25)的OpenAPI采用ROA签名风格。我们已经为开发者封装了常见编程语言的SDK,开发者可通过下载SDK直接调用本产品OpenAPI而无需关心技术细节。如果现有SDK不能满足使用需求,可通过签名机制进行自签名对接。由于自签名细节非常复杂,需花费 5个工作日左右。因此建议加入我们的服务钉钉群(147535001692),在专家指导下进行签名对接。

在使用API前,您需要准备好身份账号及访问密钥(AccessKey),才能有效通过客户端工具(SDK、CLI等)访问API。细节请参见获取AccessKey

自定义签名场景

若您的业务场景有特殊需求,需通过自签名方式对接 API,建议优先咨询我们的技术支持团队(服务钉钉群:147535001692),获取专业指导以确保高效接入。

账号与安全准备

阿里云账号具备对所有资源的完全管理权限。一旦 AccessKey 泄露,所有相关资源都将面临未经授权访问的风险。为确保安全,建议创建一个仅具备 API 访问权限的RAM用户并配置其 AccessKey,同时基于最小权限原则 (PoLP) 配置 RAM 策略。仅在明确需要阿里云账号权限的特定场景下,才使用阿里云账号。

代码管理

API

标题

API概述

文件 文件
CreateFile 创建文件 创建代码库文件。
DeleteFile 删除文件 删除代码库指定文件。
UpdateFile 修改文件 修改代码库某个文件。
GetFileBlobs 查询文件内容 查询代码库某个文件的具体内容。
ListRepositoryTree 查询文件树 查询代码库的文件树。
提交 提交
GetFileLastCommit 查询文件最近一次提交信息 查询指定文件的最近一次Git提交。
GetRepositoryCommit 查询代码库提交信息 查询代码库的单个提交信息。
ListRepositoryCommits 查询代码库提交列表 查询代码库的提交历史信息,支持滚动分页。
ListRepositoryCommitDiff 查询代码库单个提交的提交内容 根据代码库ID(repositoryId)和SHA值(sha),可选上下文行数参数(contextLine),获取到当前代码库中单个提交的提交内容。
CreateCommitWithMultipleFiles 多文件变更提交 创建一个提交,并能够变更多个文件。一般在日常开发中,一个提交通常会有多个文件变动,当前API就是应用于该情况。
成员 成员
AddRepositoryMember 增加代码库成员 增加代码库成员,以阿里云账号ID(aliyunPk)作为标识,支持以阿里云账号ID批量添加成员(aliyunPks以逗号作为分隔符号)。
AddGroupMember 添加组成员 添加代码组的成员。
DeleteRepositoryMember 删除代码库成员 根据阿里云账号ID来移除某个指定的代码库成员。
DeleteGroupMember 删除组成员 根据阿里云账号ID来删除指定代码组下的某个成员。
UpdateRepositoryMember 更改代码库成员的权限 根据代码库ID(repositoryId)、用户ID(userId)以及更新内容,更改当前代码库下对应成员的权限或角色。 注意:后续会将用户ID统一为阿里云账号ID(aliyunPk),请注意关注。
UpdateGroupMember 修改组成员 修改组成员,主要是成员的权限修改。
ListRepositoryMemberWithInherited 查询代码库成员列表 查询代码库成员列表,无分页。
GetProjectMember 查询代码库成员 根据阿里云账号ID(aliyunPk)查询代码库成员信息。
ListGroupMember 查询组成员列表 查询代码组下的成员列表,无分页,无排序。
仓库 仓库
CreateRepository 创建/导入代码库 创建或者导入代码库。
DeleteRepository 删除代码库 删除代码库。(为了保证规范性,必须填写删除理由)。
UpdateRepository 更新代码库 更新代码库基本信息、常用设置。
TriggerRepositoryMirrorSync 触发仓库同步 从其他平台导入到Codeup的仓库,触发Codeup仓库从远程同步。
TransferRepository 转移代码库 转移代码库至指定的代码组,其中groupIdrepositoryId均可使用全路径。
ListRepositories 查询代码库列表 查询代码库列表,支持分页、排序功能,支持关键字搜索,支持归档条件过滤。
GetRepository 查询代码库 查询代码库,支持按代码库ID和代码库路径(Path)查询。
分支 分支
CreateBranch 创建分支 创建代码库分支。
CreateProtectdBranch 创建保护分支 创建代码库保护分支。
DeleteBranch 删除分支 删除代码库分支。
DeleteProtectedBranch 删除保护分支 删除代码库保护分支。
UpdateProtectedBranches 更改保护分支设置 更改保护分支设置。 支持对于保护分支规则的详细设置,包括分支、推送规则、合并规则、要求合并前通过代码评审以及要求合并前通过自动化状态检查。
GetBranchInfo 查询分支信息 查询代码库分支的信息。
ListRepositoryBranches 查询代码库分支列表 查询代码库分支列表。
ListProtectedBranches 查询保护分支列表 查询代码库保护分支列表。
合并请求 合并请求
GetMergeRequest 查询合并请求 查询单个合并请求详情。
ListMergeRequests 查询合并请求列表 查询合并请求列表,支持分页、排序和筛选。 该API能同时查询旧版和新版的合并请求,若没有使用过旧版合并请求,或者已经没有旧版合并请求数据,那么直接忽略返回信息中跟旧版合并请求相关的字段。
CreateMergeRequest 创建合并请求 创建合并请求。
UpdateMergeRequest 更新合并请求 API仅支持修改合并请求的标题和描述信息。
UpdateMergeRequestPersonnel 更新合并请求的干系人 更新合并请求的干系人,包含评审人、订阅人。
MergeMergeRequest 合并合并请求 合并当前合并请求。
ReviewMergeRequest 评审合并请求 评审合并请求,发表评审意见。
CloseMergeRequest 关闭合并请求 关闭指定的合并请求。
ReopenMergeRequest 重新开启合并请求 对关闭的合并请求重新打开,其中已合并的合并请求无法执行重新代开操作。
ListMergeRequestPatchSets 查询合并请求版本列表 查询合并请求下的所有版本信息,包括合并源的版本和合并目标的版本。
GetMergeRequestChangeTree 查询合并请求Diff统计信息 查询合并请求的Diff统计信息,包括总变更文件树、总新增行、总删减行以及每个文件的新增行与删减行。
ListMergeRequestFilesReads 查询合并请求变更文件已读情况 查询合并请求变更文件的已读情况,主要获取变更文件的已读人列表。
ListMergeRequestComments 查询合并请求评论列表 查询合并请求中的评论列表,不分页。其中,评论仅支持三级结构。
CreateComment 创建合并请求评论 创建合并请求评论,可创建整体评论和行内评论。创建的评论层级一般不要超过3层。
比较 比较
GetCompareDetail Compare接口 比较两个commit(branchtag本质也是commit),返回两个commit之间的commits列表以及diff内容(可从diff内容中获取到文件变更树)。
提交状态 提交状态
CreateCommitStatus 添加提交状态记录 给指定的Commit添加一条提交状态记录。
ListCommitStatuses 查询提交状态列表 查询提交状态列表,支持分页。
检查运行 检查运行
CreateCheckRun 添加检查运行记录 添加检查运行记录,仅创建。
UpdateCheckRun 更新检查运行 更新check run记录信息,须当前身份与check run的写入人身份一致,才能进行更新。
GetCheckRun 查询检查运行 查询单个check run记录。
ListCheckRuns 查询检查运行列表 查询check run列表,支持分页功能。
标签 标签
CreateTag 创建标签Tag 创建代码库标签(Tag)。
DeleteTag 删除标签Tag 删除代码库标签(Tag)。
GetRepositoryTag 查询单个标签信息 查询代码库的单个标签信息。
ListRepositoryTags 查询标签列表 查询代码库的标签(Tag)列表。
类标 类标
CreateProjectLabel 创建类标 创建代码库类标。
UpdateProjectLabel 更新类标 更新代码库类标信息。
DeleteProjectLabel 删除类标 删除代码库类标。
ListProjectLabels 查询类标列表 查询代码库类标列表,支持分页、字段排序以及关键字搜索。
ListMergeRequestLabels 查询合并请求类标列表 查询指定合并请求下关联的类标列表。
LinkMergeRequestLabel 关联合并请求 将类标(Label)关联到合并请求中。
Webhook Webhook
AddWebhook 创建代码库Webhook 创建代码库Webhook。
DeleteRepositoryWebhook 删除代码库Webhook 删除代码库下的Webhook。
ListRepositoryWebhook 查询代码仓库的webhook列表 批量查询在代码仓库上配置的webhook记录,支持分页功能。
代码组 代码组
CreateRepositoryGroup 创建代码组 创建代码组。
DeleteRepositoryGroup 删除代码组 删除某个指定的代码库。
UpdateGroup 更新代码组信息 更新单个代码组信息,以pathWithNamespace作为唯一标识。
GetGroupDetail 查询代码组信息 查询指定的某个代码组信息。
GetGroupByPath 查询代码组信息(Path) 根据代码组全路径查询代码组信息。
ListRepositoryGroups 查询代码组列表 查询代码组列表,支持分页、按创建时间和更新时间排序以及关键字搜索。
ListGroupRepositories 查询代码组下的库列表 根据代码组ID查询其组下的代码库列表。
推送评审 推送评审
UpdatePushReviewOnOff 推送评审模式开关 打开或关闭指定代码库的推送评审设置(需要有管理员权限)。
推送规则 推送规则
CreatePushRule 创建推送规则 创建推送规则。
UpdatePushRule 更新推送规则 更新指定的推送规则,更新方式为覆盖式更新,若是新增规则项,需要确保原有的也存在,否则会被新内容覆盖。
DeletePushRule 删除推送规则 删除指定的推送规则。
ListPushRules 查询推送规则列表 查询指定代码库下的推送规则列表,无分页。
部署密钥 部署密钥
CreateDeployKey 创建部署密钥 在代码库中创建新的部署密钥。
EnableDeployKey 启用部署密钥 启用代码库中已有的部署密钥。
SSH密钥 SSH密钥
CreateUserKey 创建用户SSH密钥 创建当前用户的SSH-Key密钥。
DeleteUserKey 删除指定的SSH密钥 为当前用户删除指定的SSH密钥。
ListUserKeys 查询SSH密钥列表 查询当前用户的SSH密钥列表。
代码搜索 代码搜索
ListSearchSourceCode 搜索代码片段数据 根据筛选条件搜索相应的代码片段。
ListSearchRepository 搜索代码仓库数据 根据查询条件搜索代码仓库数据。
ListSearchCommit 搜索代码提交数据 根据筛选条件搜索提交的相关数据。
GetSearchCodePreview 查询预览代码片段 根据文档ID和关键字获取到预览代码片段。
企业信息 企业信息
GetCodeupOrganization 查询Codeup仓库所属企业信息 根据企业标识(云效企业ID或者企业路径)获取Codeup侧的企业信息。
ListOrganizations 查询用户的企业列表 查询当前用户的企业列表。
用户 用户
GetUserInfo 查询当前用户信息 该接口用于获取Codeup侧的用户信息。
审计 审计
ListUserResources 获取用户有权限的资源 获取指定用户名下的有权限的代码库和代码组信息,以及角色信息,支持分页,以用户维度进行分页。请注意,仅限企业管理员以上权限的用户可调用。
鉴权 鉴权
CreateOAuthToken 创建OAuthToken 创建OAuthToken(此接口内测中,暂不支持使用)。

流水线

API

标题

API概述

服务连接 服务连接
CreateServiceConnection 创建服务连接 创建服务连接。
CreateServiceAuth 创建服务授权 创建服务授权
CreateServiceCredential 创建服务证书 创建用户名密码类型的证书
ListServiceCredentials 获取服务证书列表 获取服务证书列表
ListServiceAuths 获取服务授权列表 获取服务授权列表
ListServiceConnections 获取服务连接列表 可以获取服务连接列表。
主机部署 主机部署
StopVMDeployOrder 终止机器部署 可以终止机器部署。
SkipVMDeployMachine 跳过机器部署 可以跳过机器部署。
RetryVMDeployMachine 重试机器部署 可以重试机器部署。
ResumeVMDeployOrder 继续部署单运行 可以继续部署单运行。
GetVMDeployOrder 获取部署单详情 可以获取部署单详情。
LogVMDeployMachine 查询机器部署日志 可以查询机器部署日志。
流水线分组 流水线分组
CreatePipelineGroup 创建流水线分组 创建流水线分组。
DeletePipelineGroup 删除流水线分组 删除流水线分组。
JoinPipelineGroup 将流水线加入流水线分组 将流水线加入流水线分组。
UpdatePipelineGroup 更新流水线分组 更新流水线分组。
GetPipelineGroup 获取流水线分组 获取流水线分组。
ListPipelineGroupPipelines 获取流水线分组下流水线列表 获取流水线分组下流水线列表。
ListPipelineGroups 获取流水线分组列表 获取流水线分组列表。
标签 标签
CreateFlowTag 创建标签 创建标签。
CreateFlowTagGroup 创建标签分类 创建标签分类。
DeleteFlowTagGroup 删除标签分类 删除标签分类。
DeleteFlowTag 删除标签 删除标签。
UpdateFlowTag 更新标签 更新标签。
UpdateFlowTagGroup 更新标签分类 更新标签分类。
GetFlowTagGroup 获取标签分类 获取标签分类。
ListFlowTagGroups 获取流水线分类列表 获取流水线分类列表。
其它 其它
CreateSshKey 创建企业公钥 可以创建企业公钥。
ResetSshKey 重置企业公钥 可以重置企业公钥。
成员 成员
CreateResourceMember 插入资源成员 可以插入资源成员。
DeleteResourceMember 删除资源成员 可以删除资源成员。
UpdateResourceMember 更新资源成员 可以更新资源成员。
ListResourceMembers 获取资源成员列表 可以获取资源成员列表。
主机组 主机组
CreateHostGroup 创建主机组 可以创建主机组。
DeleteHostGroup 删除主机组 可以删除主机组。
UpdateHostGroup 更新主机组 可以更新主机组。
GetHostGroup 获取主机组 可以获取主机组。
ListHostGroups 获取主机组列表 可以获取主机组列表。
变量组 变量组
CreateVariableGroup 创建变量组 可以创建变量组。
DeleteVariableGroup 删除变量组 可以删除变量组。
UpdateVariableGroup 更新变量组 可以更新变量组。
GetVariableGroup 获取变量组 可以获取变量组。
ListVariableGroups 获取变量组列表 可以获取变量组列表。
流水线 流水线
CreatePipeline 创建流水线 创建流水线API,支持创建YAML化流水线。
DeletePipeline 删除流水线 可以删除流水线。
DeletePipelineRelations 删除流水线关联 删除流水线关联
UpdatePipeline 更新流水线 只支持更新YAML化流水线。
StartPipelineRun 运行流水线 可以运行流水线。
StopPipelineJobRun 终止流水线任务运行 可以终止流水线任务运行。
StopPipelineRun 终止流水线运行 可以终止流水线运行。
UpdatePipelineBaseInfo 更新流水线基本信息 更新流水线基本信息。
RetryPipelineJobRun 重试流水线任务运行 可以重试流水线任务运行。
SkipPipelineJobRun 跳过流水线任务运行 可以跳过流水线任务运行。
PassPipelineValidate 通过人工卡点 可以通过人工卡点。
RefusePipelineValidate 拒绝人工卡点 可以拒绝人工卡点。
AddPipelineRelations 添加流水线关联 添加流水线关联
GetPipeline 获取流水线信息 可以获取流水线信息。
GetPipelineRun 获取流水线运行实例 可以获取流水线运行实例。
ListPipelineRuns 获取流水线运行实例列表 可以获取流水线运行实例列表。
ListPipelines 获取流水线列表 获取流水线列表。
GetPipelineArtifactUrl 获取流水线构建产物下载地址 获取流水线构建产物下载地址。
GetPipelineEmasArtifactUrl 获取流水线emas构建产物临时下载地址 获取流水线emas构建产物临时下载地址。
GetPipelineScanReportUrl 获取流水线扫描报告临时下载地址 获取流水线扫描报告临时下载地址。
ListPipelineJobHistorys 获取流水线任务的执行历史 获取流水线任务的执行历史。
ListPipelineJobs 按任务分类获取流水线执行的任务 按任务分类获取流水线执行的任务。
LogPipelineJobRun 查询任务运行日志 可以查询任务运行日志。
ListPipelineRelations 获取流水线关联列表 获取流水线关联列表

项目管理(Projex)

API

标题

API概述

工作项 工作项
WorkitemAttachmentCreate 关联文件为工作项的附件 将文件作为工作项的附件,这是工作项上传附件的第三步,前两步可以查看 GetWorkitemAttachmentCreatemeta(获取工作项上传附件的信息) 接口的描述。
ListWorkitemAttachments 获取工作项附件列表 获取工作项附件列表。
CreateWorkitemV2 创建工作项(需求/缺陷/任务) 创建工作项,可以用于创建项目下的工作项,包含(需求、缺陷、任务、风险、主题等)。
CreateWorkitemRecord 登记实际工时 登记实际工时。
CreateWorkitem 创建工作项 创建工作项。
CreateWorkitemComment 创建工作项评论 创建工作项评论。
DeleteWorkitemComment 删除当前工作项当前评论 删除工作项下单个评论。
DeleteWorkitemAllComment 删除当前工作项所有评论 删除当前工作项所有评论。
UpdateWorkitemComment 更新工作项评论 更新工作项评论。
UpdateWorkItem 更新工作项信息 更新工作项信息。
GetWorkitemAttachmentCreatemeta 获取工作项上传附件的信息 获取工作项附件上传的信息接口,这是工作项上传附件中的第一步。整个过程需要完成三步, 第一步,调用该接口获取工作项的上传信息。 第二步,根据该接口的返回信息将文件上传到oss中。 第三步,将文件作为工作项的附件,对应的接口为 WorkitemAttachmentCreate(关联文件为工作项的附件) 第二步上传文件时可以参考oss的文档:https://help.aliyun.com/document_detail/31926.html, 注意请求为POST方法,数据是表单提交的方式。
GetWorkitemTimeTypeList 获取工时类型列表 获取工时类型列表。
GetWorkitemRelations 获得工作项关联项 获得工作项关联项。
GetWorkitemCommentList 获得工作项的评论列表 获得工作项的评论列表。
CreateWorkitemEstimate 创建工作项预计工时接口 创建预计工时接口,登记一个工作项预计花费工时信息。
GetCustomFieldOption 获取字段自定义选项 获取字段自定义选项。
GetWorkItemActivity 查询工作项动态 查询工作项动态信息。
GetWorkItemInfo 获取工作项基本信息 获取工作项的基本信息。
GetWorkItemWorkFlowInfo 获取工作项工作流信息 获取工作项工作流信息。
ListProjectWorkitemTypes 获取工作项类型 获取项目中的工作项类型。
ListWorkItemAllFields 获取工作项字段列表 获取工作项字段列表。
ListWorkItemWorkFlowStatus 获取工作项工作流状态列表 获取工作项工作流状态列表。
ListWorkitems 获取工作项列表 获取工作项列表。
ListWorkitemTime 获取工作项工时明细列表 获取工作项工时明细列表。
ListWorkitemEstimate 获取工作项预计工时列表 获取工作项预计工时登记列表
UpdateWorkitemField 更新工作项字段 更新工作项字段,可以支持批量更新多个字段。
DeleteWorkitem 删除工作项 删除工作项。
GetWorkitemFile 获取工作项文件信息 获取工作项的文件信息,例如工作项的描述中的图片信息。
项目 项目
CreateProject 创建项目 可以创建项目。
CreateSprint 创建迭代 可以创建项目的迭代。
DeleteProject 删除项目 可以删除项目。
UpdateProjectMember 添加更新项目成员 添加项目成员。
UpdateProjectField 更新项目属性与字段 更新项目自身属性与自定义字段,以及项目状态
GetProjectInfo 获取项目详情 根据projectId获取项目基本信息。
ListProjectMembers 获取项目成员 获取项目成员。
GetSprintInfo 获取迭代详情 获取迭代详情。
ListProjects 获取项目列表 获取项目列表,支持条件搜索。
ListProjectTemplates 获取项目模板列表 获取项目模板列表。
ListSprints 获取迭代列表 获取迭代列表。

测试管理

API

标题

API概述

测试用例库 测试用例库
CreateTestCase 创建测试用例 用例库中创建测试用例
UpdateTestCase 更新用例库测试用例属性 更新用例库测试用例属性,包括标题,目录,自定义字段信息等,但是不能用来更新测试用例的测试内容相关信息
ListTestCaseFields 获取测试用例字段列表 获取测试用例全部字段
GetTestcaseList 获取用例库测试用例列表 获取测试用例库中的测试用例列表,支持条件过滤
测试计划 测试计划
UpdateTestResult 更新测试计划中测试用例结果 更新测试计划中的用例的执行状态和执行人
GetTestResultList 获取测试计划中测试用例列表 获取测试计划中测试用例列表,支持使用条件过滤

效能洞察

API

标题

API概述

ExportWorkitemActivity 导出WorkitemActivity 获取效能洞察中指定企业的workitem_activity表数据
ExportInsightWorkitemVersion 导出WorkitemVersion 获取效能洞察中指定企业的workitem_version表数据
ExportInsightWorkitemStatusJoinWorkitemDefectExtra 导出WorkitemStatusWorkitemDefectExtra 获取效能洞察中指定企业的workitem_status表 join worktem_defect_extra表数据
ExportInsightWorkitemStatus 导出WorkitemStatus 获取效能洞察中指定企业的workitem_status表数据
ExportInsightWorkTime 导出WorkTime 获取效能洞察中指定企业的workitem_time表数据
ExportInsightTagRef 导出TagRef 获取效能洞察中指定企业的tag_ref表数据
ExportInsightSprint 导出Sprint 获取效能洞察中指定企业的sprint表数据
ExportInsightSpaceRef 导出SpaceRef 获取效能洞察中指定企业的space_ref表数据
ExportInsightSpace 导出Space 获取效能洞察中指定企业的space表数据
ExportInsightField 导出Field 获取效能洞察中指定企业的field表数据
ExportInsightExpectedWorkTime 导出ExpectedWorkTime 获取效能洞察中指定企业的expected_work_time表数据
ExportInsightCustomValue 导出CustomValue 获取效能洞察中指定企业的custom_value表数据

企业和成员

API

标题

API概述

UpdateOrganizationMember 更新企业成员信息 更新企业成员信息。
ListOrganizationMembers 查询企业成员信息列表 根据指定条件获取企业成员信息。
GetOrganizationMember 查询企业成员信息 根据指定条件获取企业成员信息。
ListJoinedOrganizations 查询加入的企业列表 查询当前账号加入的企业列表。

应用交付

API

标题

API概述

应用 应用
GetApplication 查询应用详情 查询应用详情。
UpdateApplication 更新应用 更新应用的拥有者。
ListApplications 查询应用列表 查询应用列表信息。
应用成员 应用成员
ListApplicationMembers 查询应用成员列表 查询应用成员列表。
CreateAppMembers 创建应用成员 创建应用成员。
UpdateAppMember 更新应用成员 更新应用成员。
DeleteAppMember 删除应用成员 删除应用成员。
应用研发流程 应用研发流程
GetReleaseStagePipelineRun 获取研发阶段流水线运行实例 可以获取研发阶段流水线运行实例相关信息。
ExecuteChangeRequestReleaseStage 执行研发阶段流水线 可以执行研发阶段流水线。
CancelExecutionReleaseStage 取消执行研发阶段流水线 可以取消执行研发阶段流水线。
ListAllReleaseWorkflows 查找应用下所有的研发流程 查找应用下所有的研发流程。
ListAppReleaseStageExecutions 批量查询研发阶段执行记录 批量查询研发阶段执行记录。
ListAppReleaseStageExecutionIntegratedMetadata 查询研发阶段执行记录集成变更信息 查询研发阶段执行记录集成变更信息。
RefuseReleaseStagePipelineValidate 拒绝研发阶段流水线人工卡点 可以拒绝研发阶段流水线中的人工卡点。
PassReleaseStagePipelineValidate 通过研发阶段流水线人工卡点 可以通过研发阶段流水线中的人工卡点。
变更 变更
CreateChangeRequest 创建应用变更 创建应用变更。
ListChangeRequests 查询变更列表 查询变更列表。
ListChangeRequestWorkflowExecutions 查询变更研发流程运行记录 查询变更研发流程运行记录。