通过

Workspaces - Set Git Outbound Policy

服务:
Core
API 版本:
v1

将出站策略设置为“拒绝”时，为指定的工作区设置 Git 出站策略。
此 API 使用 PUT 方法，并将覆盖所有设置。 如果工作区限制出站策略，工作区管理员需要允许在指定的工作区上使用 Git 集成。 当工作区没有出站限制时，更改此属性将失败，并且不会影响 Git 集成设置。 始终先运行 Get Git 出站策略，并在请求正文中提供完整策略。

Permissions

调用方必须具有 管理员 工作区角色。

所需的委派范围

Workspace.ReadWrite.All

Microsoft Entra 支持的标识

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

身份 Support
用户 是的
服务主体和托管标识 是的

接口

PUT https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/networking/communicationPolicy/outbound/git

URI 参数

名称 在 必需 类型 说明
workspaceId
 path True

string (uuid)

工作区 ID。

请求头

名称 必需 类型 说明
If-Match

string

ETag 值。 必须在引号中指定 ETag。 如果提供，则仅当资源的 ETag 与提供的 ETag 匹配时，调用才会成功。

请求正文

名称 类型 说明
defaultAction

NetworkAccessRule

从公用网络访问工作区的默认策略。

响应

名称 类型 说明
200 OK

请求成功完成。

标头

ETag: string
Other Status Codes

ErrorResponse

常见错误代码：

  • UnknownError - 发生错误。

示例

Set workspace networking communication policy example

示例请求

PUT https://api.fabric.microsoft.com/v1/workspaces/47482db6-4583-4672-86dd-999d0f8f4d7a/networking/communicationPolicy/outbound/git

{
  "defaultAction": "Allow"
}

示例响应

状态代码:
200 
ETag: 0f8fad5b-d9cb-469f-a165-70867728950e

定义

名称 说明
ErrorRelatedResource

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

错误响应。
ErrorResponseDetails

错误响应详细信息。
NetworkAccessRule

从公用网络访问工作区的默认策略。
NetworkRules

定义访问/从工作区访问/从公用网络访问的策略。

ErrorRelatedResource

Object

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

名称 类型 说明
resourceId

string

错误中涉及的资源 ID。
resourceType

string

错误中涉及的资源的类型。

ErrorResponse

Object

错误响应。

名称 类型 说明
errorCode

string

提供有关错误条件的信息的特定标识符，允许服务与其用户之间的标准化通信。
message

string

错误的人工可读表示形式。
moreDetails

ErrorResponseDetails[]

其他错误详细信息的列表。
relatedResource

ErrorRelatedResource

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

string

与错误关联的请求的 ID。

ErrorResponseDetails

Object

错误响应详细信息。

名称 类型 说明
errorCode

string

提供有关错误条件的信息的特定标识符，允许服务与其用户之间的标准化通信。
message

string

错误的人工可读表示形式。
relatedResource

ErrorRelatedResource

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

NetworkAccessRule

枚举

从公用网络访问工作区的默认策略。

值 说明
Allow

允许所有连接。
Deny

拒绝所有连接。

NetworkRules

Object

定义访问/从工作区访问/从公用网络访问的策略。

名称 类型 说明
defaultAction

NetworkAccessRule

从公用网络访问工作区的默认策略。