Forks - Get

服务:

Git

API 版本:

5.0-preview.1

获取特定分支同步操作的详细信息。

GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryNameOrId}/forkSyncRequests/{forkSyncOperationId}?api-version=5.0-preview.1

具有可选参数:

GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryNameOrId}/forkSyncRequests/{forkSyncOperationId}?includeLinks={includeLinks}&api-version=5.0-preview.1

URI 参数

名称	在	必需	类型	说明
forkSyncOperationId	path	True	integer int32	同步请求的 OperationId。
organization	path	True	string	Azure DevOps 组织的名称。
repositoryNameOrId	path	True	string	存储库的名称或 ID。
project	path		string	项目 ID 或项目名称
api-version	query	True	string	要使用的 API 版本。 应将其设置为“5.0-preview.1”才能使用此版本的 API。
includeLinks	query		boolean	如果为 True，则包含链接。

响应

名称	类型	说明
200 OK	GitForkSyncRequest	成功的操作

安全性

oauth2

类型: oauth2
流向: accessCode
授权 URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
令牌 URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

作用域

名称	说明
vso.code	授予读取有关提交、更改集、分支和其他版本控制项目的源代码和元数据的能力。 此外，还授予搜索代码的功能，并通过服务挂钩获取有关版本控制事件的通知。

定义

名称	说明
GitAsyncOperationStatus
GitForkOperationStatusDetail	有关请求的分叉操作的状态信息。
GitForkSyncRequest	请求在两个分支之间同步数据。
GlobalGitRepositoryKey	存储库的全局唯一密钥。
ReferenceLinks	表示 REST 引用链接集合的类。
SourceToTargetRef

GitAsyncOperationStatus

Enumeration

值	说明
abandoned	操作已放弃。
completed	操作已完成。
failed	操作失败。 检查是否有错误消息。
inProgress	操作当前正在进行中。
queued	操作正在队列中等待，尚未启动。

GitForkOperationStatusDetail

Object

有关请求的分叉操作的状态信息。

名称	类型	说明
allSteps	string[]	分叉过程的所有有效步骤
currentStep	integer	当前步骤的 AllSteps 索引
errorMessage	string	如果操作失败，则返回错误消息。

GitForkSyncRequest

Object

请求在两个分支之间同步数据。

名称	类型	说明
_links	ReferenceLinks	相关链接的集合
detailedStatus	GitForkOperationStatusDetail	有关请求的分叉操作的状态信息。
operationId	integer	操作的唯一标识符。
source	GlobalGitRepositoryKey	源存储库的完全限定标识符。
sourceToTargetRefs	SourceToTargetRef[]	如果提供，则为在执行“同步”或创建时要使用的引用映射集。 如果缺少，将同步所有引用。
status	GitAsyncOperationStatus

GlobalGitRepositoryKey

Object

存储库的全局唯一密钥。

名称	类型	说明
collectionId	string	存储库集合的团队项目集合 ID。
projectId	string	存储库的项目的团队项目 ID。
repositoryId	string	存储库的 ID。

ReferenceLinks

Object

表示 REST 引用链接集合的类。

名称	类型	说明
links	object	链接的只读视图。 由于引用链接是只读的，因此我们只想将其公开为只读。

SourceToTargetRef

Object

名称	类型	说明
sourceRef	string	要复制的源引用。 例如，refs/heads/master。
targetRef	string	要更新的目标引用。 例如，refs/heads/master。