Forks - Get Fork Sync Requests

服务:

Git

API 版本:

7.1

检索此存储库上所有请求的分叉同步操作。

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

具有可选参数:

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

URI 参数

名称	在	必需	类型	说明
organization	path	True	string	Azure DevOps 组织的名称。
repositoryNameOrId	path	True	string	存储库的名称或 ID。
project	path		string	项目 ID 或项目名称
api-version	query	True	string	要使用的 API 版本。 这应设置为“7.1”才能使用此版本的 API。
includeAbandoned	query		boolean	如果包含已放弃的请求，则为 True。
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

枚举

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

GitForkOperationStatusDetail

Object

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

名称	类型	说明
allSteps	string[]	分叉过程的所有有效步骤
currentStep	integer (int32)	为当前步骤编制索引到 AllSteps
errorMessage	string	如果操作失败，则显示错误消息。

GitForkSyncRequest

Object

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

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

GlobalGitRepositoryKey

Object

存储库的全局唯一密钥。

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

ReferenceLinks

Object

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

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

SourceToTargetRef

Object

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