Git - List Workspace Relations

服务:: Core

API 版本:: v1

返回指定工作区的工作区关系列表。

注释

此 API 是预览版的一部分，仅用于评估和开发目的。它可能会根据反馈进行更改，不建议将其用于生产。

此 API 支持分页。

权限

调用方必须具有 查看器 或更高工作区角色。

所需的委派范围

Workspace.Read.All 或 Workspace.ReadWrite.All

Microsoft Entra 支持的标识

此 API 支持本节中列出的Microsoft 标识。

Identity	支持
User	是的
服务主体和托管标识	是的

Interface

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/git/workspaceRelations

具有可选参数:

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/git/workspaceRelations?continuationToken={continuationToken}

URI 参数

名称	在	必需	类型	说明
workspaceId	path	True	string (uuid)	工作区 ID。
continuationToken	query		string	用于检索下一页结果的令牌。

响应

名称类型说明

200 OK

名称	类型	说明
200 OK	WorkspaceRelations	请求成功完成。
429 Too Many Requests	ErrorResponse	超出服务速率限制。服务器返回一个 `Retry-After` 标头，指示客户端在发送其他请求之前必须等待的时间（以秒为单位）。标头 Retry-After: integer
Other Status Codes	ErrorResponse	常见错误代码： InsufficientPrivileges - 调用方没有足够的工作区权限。 WorkspaceNotFound - 找不到指定的工作区。

WorkspaceRelations

请求成功完成。

429 Too Many Requests

ErrorResponse

超出服务速率限制。服务器返回一个 Retry-After 标头，指示客户端在发送其他请求之前必须等待的时间（以秒为单位）。

标头

Retry-After: integer

Other Status Codes

ErrorResponse

常见错误代码：

InsufficientPrivileges - 调用方没有足够的工作区权限。
WorkspaceNotFound - 找不到指定的工作区。

示例

List workspace relations example

示例请求

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/66666666-6666-6666-6666-666666666666/git/workspaceRelations

示例响应

状态代码:: 200

{
  "value": [
    {
      "id": "ffffffff-ffff-ffff-ffff-ffffffffffff",
      "workspaceId": "66666666-6666-6666-6666-666666666666",
      "relatedWorkspaceId": "88888888-8888-8888-8888-888888888888",
      "relationType": "Base"
    },
    {
      "id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
      "workspaceId": "66666666-6666-6666-6666-666666666666",
      "relatedWorkspaceId": "22222222-2222-2222-2222-222222222222",
      "relationType": "RelatedWorkspace"
    },
    {
      "id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
      "workspaceId": "66666666-6666-6666-6666-666666666666",
      "relatedWorkspaceId": "44444444-4444-4444-4444-444444444444",
      "relationType": "RelatedWorkspace"
    }
  ]
}

定义

名称	说明
ErrorParameter	一个结构化参数，提供有关错误的附加计算机可读上下文。
ErrorRelatedResource	与错误相关的资源详细信息对象。
ErrorResponse	错误响应。
ErrorResponseDetails	错误响应详细信息。
WorkspaceRelation	工作区关系对象。
WorkspaceRelations	工作区关系列表。
WorkspaceRelationType	关系中相关工作区的类型。可能会随着时间的推移添加其他相关的工作区类型。

ErrorParameter

对象

一个结构化参数，提供有关错误的附加计算机可读上下文。

名称	类型	说明
message	string	参数含义的可读说明。
name	string	参数标识符。
value	string	参数值。

ErrorRelatedResource

对象

与错误相关的资源详细信息对象。

名称	类型	说明
resourceId	string	错误中涉及的资源 ID。
resourceType	string	错误中涉及的资源的类型。

ErrorResponse

对象

错误响应。

名称	类型	说明
errorCode	string	提供有关错误条件的信息的特定标识符，允许服务与其用户之间的标准化通信。
isRetriable	boolean	如果为 true，可以重试请求。 `Retry-After`使用响应标头确定延迟（如果可用）。
message	string	错误的人工可读表示形式。
moreDetails	ErrorResponseDetails[]	其他错误详细信息的列表。
parameters	ErrorParameter[]	提供有关错误的其他计算机可读上下文的结构化参数。
relatedResource	ErrorRelatedResource	与错误相关的资源详细信息。
requestId	string (uuid)	与错误关联的请求的 ID。

ErrorResponseDetails

对象

错误响应详细信息。

名称	类型	说明
errorCode	string	提供有关错误条件的信息的特定标识符，允许服务与其用户之间的标准化通信。
message	string	错误的人工可读表示形式。
parameters	ErrorParameter[]	提供有关错误的其他计算机可读上下文的结构化参数。
relatedResource	ErrorRelatedResource	与错误相关的资源详细信息。

WorkspaceRelation

对象

工作区关系对象。

名称	类型	说明
id	string (uuid)	工作区关系 ID。
relatedWorkspaceId	string (uuid)	相关的工作区 ID。
relationType	WorkspaceRelationType	关系中相关工作区的类型。
workspaceId	string (uuid)	工作区 ID。

WorkspaceRelations

对象

工作区关系列表。

名称	类型	说明
continuationToken	string	下一个结果集批处理的令牌。如果没有更多记录，则会从响应中删除该记录。
continuationUri	string	下一个结果集批处理的 URI。如果没有更多记录，则会从响应中删除该记录。
value	WorkspaceRelation[]	工作区关系列表。

WorkspaceRelationType

枚举

关系中相关工作区的类型。可能会随着时间的推移添加其他相关的工作区类型。

值	说明
Base	相关工作区是基本工作区（源）工作区。
Branch	相关工作区是分支工作区。
RelatedWorkspace	相关工作区具有一般关系。