阿里云OpenAPI开发者门户

云效2020 - OpenAPI 概览2021-06-25
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
代码管理
OpenAPI 名称描述操作
文件
CreateFilehot创建代码库文件查看文档去调试
GetFileBlobs查询代码库某个文件的具体内容查看文档去调试
ListRepositoryTree查询代码库的文件树查看文档去调试
UpdateFile修改代码库某个文件查看文档去调试
DeleteFile删除代码库指定文件查看文档去调试
提交
CreateCommitWithMultipleFiles创建一个提交,并能够变更多个文件。一般在日常开发中,一个提交通常会有多个文件变动,当前API就是应用于该情况查看文档去调试
GetFileLastCommit查询指定文件的最近一次Git提交查看文档去调试
GetRepositoryCommit查询代码库的单个提交信息查看文档去调试
ListRepositoryCommits查询代码库的提交历史信息,支持滚动分页查看文档去调试
ListRepositoryCommitDiff根据代码库ID(repositoryId)和SHA值(sha),可选上下文行数参数(contextLine),获取到当前代码库中单个提交的提交内容查看文档去调试
成员
AddRepositoryMember增加代码库成员,以阿里云账号ID(aliyunPk)作为标识,支持以阿里云账号ID批量添加成员(aliyunPks以逗号作为分隔符号)查看文档去调试
AddGroupMember添加代码组的成员查看文档去调试
ListRepositoryMemberWithInherited查询代码库成员列表,无分页查看文档去调试
GetProjectMember根据阿里云账号ID(aliyunPk)查询代码库成员信息查看文档去调试
ListGroupMember查询代码组下的成员列表,无分页,无排序查看文档去调试
UpdateRepositoryMember根据代码库ID(repositoryId)、用户ID(userId)以及更新内容,更改当前代码库下对应成员的权限或角色。 注意:后续会将用户ID统一为阿里云账号ID(aliyunPk),请注意关注查看文档去调试
UpdateGroupMember修改组成员,主要是成员的权限修改查看文档去调试
DeleteRepositoryMember根据阿里云账号ID来移除某个指定的代码库成员查看文档去调试
DeleteGroupMember根据阿里云账号ID来删除指定代码组下的某个成员查看文档去调试
仓库
CreateRepository创建或者导入代码库查看文档去调试
ListRepositorieshot查询代码库列表,支持分页、排序功能,支持关键字搜索,支持归档条件过滤查看文档去调试
GetRepositoryhot查询代码库,支持按代码库ID和代码库路径(Path)查询查看文档去调试
UpdateRepository更新代码库基本信息、常用设置查看文档去调试
TriggerRepositoryMirrorSync从其他平台导入到Codeup的仓库,触发Codeup仓库从远程同步查看文档去调试
TransferRepository转移代码库至指定的代码组,其中groupId和repositoryId均可使用全路径查看文档去调试
DeleteRepository删除代码库。(为了保证规范性,必须填写删除理由)查看文档去调试
分支
CreateBranch创建代码库分支查看文档去调试
CreateProtectdBranch创建代码库保护分支查看文档去调试
GetBranchInfo查询代码库分支的信息查看文档去调试
ListRepositoryBranches查询代码库分支列表查看文档去调试
ListProtectedBranches查询代码库保护分支列表查看文档去调试
UpdateProtectedBranches更改保护分支设置。 支持对于保护分支规则的详细设置,包括分支、推送规则、合并规则、要求合并前通过代码评审以及要求合并前通过自动化状态检查查看文档去调试
DeleteBranch删除代码库分支查看文档去调试
DeleteProtectedBranch删除代码库保护分支查看文档去调试
合并请求
CreateMergeRequest创建合并请求查看文档去调试
CreateComment创建合并请求评论,可创建整体评论和行内评论。创建的评论层级一般不要超过3层查看文档去调试
GetMergeRequest查询单个合并请求详情查看文档去调试
ListMergeRequests查询合并请求列表,支持分页、排序和筛选。 该API能同时查询旧版和新版的合并请求,若没有使用过旧版合并请求,或者已经没有旧版合并请求数据,那么直接忽略返回信息中跟旧版合并请求相关的字段查看文档去调试
ListMergeRequestPatchSets查询合并请求下的所有版本信息,包括合并源的版本和合并目标的版本查看文档去调试
GetMergeRequestChangeTree查询合并请求的Diff统计信息,包括总变更文件树、总新增行、总删减行以及每个文件的新增行与删减行查看文档去调试
ListMergeRequestFilesReads查询合并请求变更文件的已读情况,主要获取变更文件的已读人列表查看文档去调试
ListMergeRequestComments查询合并请求中的评论列表,不分页。其中,评论仅支持三级结构查看文档去调试
UpdateMergeRequest该API仅支持修改合并请求的标题和描述信息查看文档去调试
UpdateMergeRequestPersonnel更新合并请求的干系人,包含评审人、订阅人查看文档去调试
MergeMergeRequest合并当前合并请求查看文档去调试
ReviewMergeRequest评审合并请求,发表评审意见查看文档去调试
CloseMergeRequest关闭指定的合并请求查看文档去调试
ReopenMergeRequest对关闭的合并请求重新打开,其中已合并的合并请求无法执行重新代开操作查看文档去调试
比较
GetCompareDetail比较两个commit(branch和tag本质也是commit),返回两个commit之间的commits列表以及diff内容(可从diff内容中获取到文件变更树)查看文档去调试
提交状态
CreateCommitStatus给指定的Commit添加一条提交状态记录查看文档去调试
ListCommitStatuses查询提交状态列表,支持分页查看文档去调试
检查运行
CreateCheckRun添加检查运行记录,仅创建查看文档去调试
GetCheckRun查询单个check run记录查看文档去调试
ListCheckRuns查询check run列表,支持分页功能查看文档去调试
UpdateCheckRun更新check run记录信息,须当前身份与check run的写入人身份一致,才能进行更新查看文档去调试
标签
CreateTag创建代码库标签(Tag)查看文档去调试
GetRepositoryTag查询代码库的单个标签信息查看文档去调试
ListRepositoryTags查询代码库的标签(Tag)列表查看文档去调试
DeleteTag删除代码库标签(Tag)查看文档去调试
类标
CreateProjectLabel创建代码库类标查看文档去调试
ListProjectLabels查询代码库类标列表,支持分页、字段排序以及关键字搜索查看文档去调试
ListMergeRequestLabels查询指定合并请求下关联的类标列表查看文档去调试
UpdateProjectLabel更新代码库类标信息查看文档去调试
LinkMergeRequestLabel将类标(Label)关联到合并请求中查看文档去调试
DeleteProjectLabel删除代码库类标查看文档去调试
Webhook
AddWebhook创建代码库Webhook查看文档去调试
ListRepositoryWebhook批量查询在代码仓库上配置的webhook记录,支持分页功能查看文档去调试
DeleteRepositoryWebhook删除代码库下的Webhook查看文档去调试
代码组
CreateRepositoryGroup创建代码组查看文档去调试
GetGroupDetail查询指定的某个代码组信息查看文档去调试
GetGroupByPath根据代码组全路径查询代码组信息查看文档去调试
ListRepositoryGroups查询代码组列表,支持分页、按创建时间和更新时间排序以及关键字搜索查看文档去调试
ListGroupRepositories根据代码组ID查询其组下的代码库列表查看文档去调试
UpdateGroup更新单个代码组信息,以pathWithNamespace作为唯一标识查看文档去调试
DeleteRepositoryGroup删除某个指定的代码库查看文档去调试
推送评审
UpdatePushReviewOnOff打开或关闭指定代码库的推送评审设置(需要有管理员权限)查看文档去调试
推送规则
CreatePushRule创建推送规则查看文档去调试
ListPushRules查询指定代码库下的推送规则列表,无分页查看文档去调试
UpdatePushRule更新指定的推送规则,更新方式为覆盖式更新,若是新增规则项,需要确保原有的也存在,否则会被新内容覆盖查看文档去调试
DeletePushRule删除指定的推送规则查看文档去调试
部署密钥
CreateDeployKey在代码库中创建新的部署密钥查看文档去调试
EnableDeployKey启用代码库中已有的部署密钥查看文档去调试
SSH密钥
CreateUserKey创建当前用户的SSH-Key密钥查看文档去调试
ListUserKeys查询当前用户的SSH密钥列表查看文档去调试
DeleteUserKey为当前用户删除指定的SSH密钥查看文档去调试
代码搜索
ListSearchSourceCode根据筛选条件搜索相应的代码片段查看文档去调试
ListSearchRepository根据查询条件搜索代码仓库数据查看文档去调试
ListSearchCommit根据筛选条件搜索提交的相关数据查看文档去调试
GetSearchCodePreview根据文档ID和关键字获取到预览代码片段查看文档去调试
企业信息
GetCodeupOrganization根据企业标识(云效企业ID或者企业路径)获取Codeup侧的企业信息查看文档去调试
ListOrganizations查询当前用户的企业列表查看文档去调试
用户
GetUserInfo该接口用于获取Codeup侧的用户信息查看文档去调试
审计
ListUserResources获取指定用户名下的有权限的代码库和代码组信息,以及角色信息,支持分页,以用户维度进行分页。请注意,仅限企业管理员以上权限的用户可调用查看文档去调试
鉴权
CreateOAuthToken创建OAuthToken(此接口内测中,暂不支持使用)查看文档去调试
流水线
OpenAPI 名称描述操作
服务连接
CreateServiceConnection创建服务连接查看文档去调试
CreateServiceAuth创建服务授权查看文档去调试
CreateServiceCredential创建用户名密码类型的证书查看文档去调试
ListServiceCredentials获取服务证书列表查看文档去调试
ListServiceAuths获取服务授权列表查看文档去调试
ListServiceConnections可以获取服务连接列表查看文档去调试
主机部署
GetVMDeployOrder可以获取部署单详情查看文档去调试
LogVMDeployMachine可以查询机器部署日志查看文档去调试
StopVMDeployOrder可以终止机器部署查看文档去调试
SkipVMDeployMachine可以跳过机器部署查看文档去调试
RetryVMDeployMachine可以重试机器部署查看文档去调试
ResumeVMDeployOrder可以继续部署单运行查看文档去调试
流水线分组
CreatePipelineGroup创建流水线分组查看文档去调试
GetPipelineGroup获取流水线分组查看文档去调试
ListPipelineGroupPipelines获取流水线分组下流水线列表查看文档去调试
ListPipelineGroups获取流水线分组列表查看文档去调试
JoinPipelineGroup将流水线加入流水线分组查看文档去调试
UpdatePipelineGroup更新流水线分组查看文档去调试
DeletePipelineGroup删除流水线分组查看文档去调试
标签
CreateFlowTag创建标签查看文档去调试
CreateFlowTagGroup创建标签分类查看文档去调试
GetFlowTagGroup获取标签分类查看文档去调试
ListFlowTagGroups获取流水线分类列表查看文档去调试
UpdateFlowTag更新标签查看文档去调试
UpdateFlowTagGroup更新标签分类查看文档去调试
DeleteFlowTagGroup删除标签分类查看文档去调试
DeleteFlowTag删除标签查看文档去调试
其它
CreateSshKey可以创建企业公钥查看文档去调试
ResetSshKey可以重置企业公钥查看文档去调试
成员
CreateResourceMember可以插入资源成员查看文档去调试
ListResourceMembers可以获取资源成员列表查看文档去调试
UpdateResourceMember可以更新资源成员查看文档去调试
DeleteResourceMember可以删除资源成员查看文档去调试
主机组
CreateHostGroup可以创建主机组查看文档去调试
GetHostGroup可以获取主机组查看文档去调试
ListHostGroups可以获取主机组列表查看文档去调试
UpdateHostGroup可以更新主机组查看文档去调试
DeleteHostGroup可以删除主机组查看文档去调试
变量组
CreateVariableGroup可以创建变量组查看文档去调试
GetVariableGroup可以获取变量组查看文档去调试
ListVariableGroups可以获取变量组列表查看文档去调试
UpdateVariableGroup可以更新变量组查看文档去调试
DeleteVariableGroup可以删除变量组查看文档去调试
流水线
CreatePipeline创建流水线API,支持创建YAML化流水线查看文档去调试
GetPipeline可以获取流水线信息查看文档去调试
GetPipelineRun可以获取流水线运行实例查看文档去调试
ListPipelineRuns可以获取流水线运行实例列表查看文档去调试
ListPipelines获取流水线列表查看文档去调试
GetPipelineArtifactUrl获取流水线构建产物下载地址查看文档去调试
GetPipelineEmasArtifactUrl获取流水线emas构建产物临时下载地址查看文档去调试
GetPipelineScanReportUrl获取流水线扫描报告临时下载地址查看文档去调试
ListPipelineJobHistorys获取流水线任务的执行历史查看文档去调试
ListPipelineJobs按任务分类获取流水线执行的任务查看文档去调试
LogPipelineJobRun可以查询任务运行日志查看文档去调试
ListPipelineRelations获取流水线关联列表查看文档去调试
UpdatePipeline只支持更新YAML化流水线查看文档去调试
StartPipelineRun可以运行流水线查看文档去调试
StopPipelineJobRun可以终止流水线任务运行查看文档去调试
StopPipelineRun可以终止流水线运行查看文档去调试
UpdatePipelineBaseInfo更新流水线基本信息查看文档去调试
RetryPipelineJobRun可以重试流水线任务运行查看文档去调试
SkipPipelineJobRun可以跳过流水线任务运行查看文档去调试
PassPipelineValidate可以通过人工卡点查看文档去调试
RefusePipelineValidate可以拒绝人工卡点查看文档去调试
AddPipelineRelations添加流水线关联查看文档去调试
DeletePipeline可以删除流水线查看文档去调试
DeletePipelineRelations删除流水线关联查看文档去调试
项目管理(Projex)
OpenAPI 名称描述操作
工作项
WorkitemAttachmentCreate将文件作为工作项的附件,这是工作项上传附件的第三步,前两步可以查看 GetWorkitemAttachmentCreatemeta(获取工作项上传附件的信息) 接口的描述查看文档去调试
CreateWorkitemV2创建工作项,可以用于创建项目下的工作项,包含(需求、缺陷、任务、风险、主题等)查看文档去调试
CreateWorkitemRecord登记实际工时查看文档去调试
CreateWorkitemhot创建工作项查看文档去调试
CreateWorkitemComment创建工作项评论查看文档去调试
CreateWorkitemEstimate创建预计工时接口,登记一个工作项预计花费工时信息查看文档去调试
ListWorkitemAttachments获取工作项附件列表查看文档去调试
GetWorkitemAttachmentCreatemeta获取工作项附件上传的信息接口,这是工作项上传附件中的第一步。整个过程需要完成三步, 第一步,调用该接口获取工作项的上传信息。 第二步,根据该接口的返回信息将文件上传到oss中。 第三步,将文件作为工作项的附件,对应的接口为 WorkitemAttachmentCreate(关联文件为工作项的附件) 第二步上传文件时可以参考oss的文档:https://help.aliyun.com/document_detail/31926.html, 注意请求为POST方法,数据是表单提交的方式查看文档去调试
GetWorkitemTimeTypeList获取工时类型列表查看文档去调试
GetWorkitemRelations获得工作项关联项查看文档去调试
GetWorkitemCommentList获得工作项的评论列表查看文档去调试
GetCustomFieldOption获取字段自定义选项查看文档去调试
GetWorkItemActivity查询工作项动态信息查看文档去调试
GetWorkItemInfohot获取工作项的基本信息查看文档去调试
GetWorkItemWorkFlowInfo获取工作项工作流信息查看文档去调试
ListProjectWorkitemTypes获取项目中的工作项类型查看文档去调试
ListWorkItemAllFieldshot获取工作项字段列表查看文档去调试
ListWorkItemWorkFlowStatus获取工作项工作流状态列表查看文档去调试
ListWorkitemshot获取工作项列表查看文档去调试
ListWorkitemTime获取工作项工时明细列表查看文档去调试
ListWorkitemEstimate获取工作项预计工时登记列表查看文档去调试
GetWorkitemFile获取工作项的文件信息,例如工作项的描述中的图片信息查看文档去调试
UpdateWorkitemComment更新工作项评论查看文档去调试
UpdateWorkItem更新工作项信息查看文档去调试
UpdateWorkitemField更新工作项字段,可以支持批量更新多个字段查看文档去调试
DeleteWorkitemComment删除工作项下单个评论查看文档去调试
DeleteWorkitemAllComment删除当前工作项所有评论查看文档去调试
DeleteWorkitem删除工作项查看文档去调试
项目
CreateProject可以创建项目查看文档去调试
CreateSprint可以创建项目的迭代查看文档去调试
GetProjectInfo根据projectId获取项目基本信息查看文档去调试
ListProjectMembers获取项目成员查看文档去调试
GetSprintInfo获取迭代详情查看文档去调试
ListProjectshot获取项目列表,支持条件搜索查看文档去调试
ListProjectTemplates获取项目模板列表查看文档去调试
ListSprints获取迭代列表查看文档去调试
UpdateProjectMember添加项目成员查看文档去调试
UpdateProjectField更新项目自身属性与自定义字段,以及项目状态查看文档去调试
DeleteProject可以删除项目查看文档去调试
测试管理
OpenAPI 名称描述操作
测试用例库
CreateTestCase用例库中创建测试用例查看文档去调试
UpdateTestCase更新用例库测试用例属性,包括标题,目录,自定义字段信息等,但是不能用来更新测试用例的测试内容相关信息查看文档去调试
ListTestCaseFields获取测试用例字段列表查看文档去调试
GetTestcaseList获取测试用例库中的测试用例列表,支持条件过滤查看文档去调试
测试计划
UpdateTestResult更新测试计划中的用例的执行状态和执行人查看文档去调试
GetTestResultList获取测试计划中测试用例列表,支持使用条件过滤查看文档去调试
效能洞察
OpenAPI 名称描述操作
ExportWorkitemActivity获取效能洞察中指定企业的workitem_activity表数据查看文档去调试
ExportInsightWorkitemVersion获取效能洞察中指定企业的workitem_version表数据查看文档去调试
ExportInsightWorkitemStatusJoinWorkitemDefectExtra获取效能洞察中指定企业的workitem_status表 join worktem_defect_extra表数据查看文档去调试
ExportInsightWorkitemStatus获取效能洞察中指定企业的workitem_status表数据查看文档去调试
ExportInsightWorkTime获取效能洞察中指定企业的workitem_time表数据查看文档去调试
ExportInsightTagRef获取效能洞察中指定企业的tag_ref表数据查看文档去调试
ExportInsightSprint获取效能洞察中指定企业的sprint表数据查看文档去调试
ExportInsightSpaceRef获取效能洞察中指定企业的space_ref表数据查看文档去调试
ExportInsightSpace获取效能洞察中指定企业的space表数据查看文档去调试
ExportInsightField获取效能洞察中指定企业的field表数据查看文档去调试
ExportInsightExpectedWorkTime获取效能洞察中指定企业的expected_work_time表数据查看文档去调试
ExportInsightCustomValue获取效能洞察中指定企业的custom_value表数据查看文档去调试
企业和成员
OpenAPI 名称描述操作
ListOrganizationMembershot根据指定条件获取企业成员信息查看文档去调试
GetOrganizationMemberhot根据指定条件获取企业成员信息查看文档去调试
ListJoinedOrganizations查询当前账号加入的企业列表查看文档去调试
UpdateOrganizationMember更新企业成员信息查看文档去调试
应用交付
OpenAPI 名称描述操作
应用
GetApplication查询应用详情查看文档去调试
ListApplications查询应用列表信息查看文档去调试
UpdateApplication更新应用的拥有者查看文档去调试
应用成员
CreateAppMembers创建应用成员查看文档去调试
ListApplicationMembers查询应用成员列表查看文档去调试
UpdateAppMember更新应用成员查看文档去调试
DeleteAppMember删除应用成员查看文档去调试
应用研发流程
GetReleaseStagePipelineRun可以获取研发阶段流水线运行实例相关信息查看文档去调试
ListAllReleaseWorkflows查找应用下所有的研发流程查看文档去调试
ListAppReleaseStageExecutions批量查询研发阶段执行记录查看文档去调试
ListAppReleaseStageExecutionIntegratedMetadata查询研发阶段执行记录集成变更信息查看文档去调试
ExecuteChangeRequestReleaseStage可以执行研发阶段流水线查看文档去调试
CancelExecutionReleaseStage可以取消执行研发阶段流水线查看文档去调试
RefuseReleaseStagePipelineValidate可以拒绝研发阶段流水线中的人工卡点查看文档去调试
PassReleaseStagePipelineValidate可以通过研发阶段流水线中的人工卡点查看文档去调试
变更
CreateChangeRequest创建应用变更查看文档去调试
ListChangeRequests查询变更列表查看文档去调试
ListChangeRequestWorkflowExecutions查询变更研发流程运行记录查看文档去调试
其他
OpenAPI 名称描述操作
ListUserDrawRecordByPk此API用于云效通义灵码运营相关活动使用查看文档去调试