Workspaces - Set Git Outbound Policy

Servicio:

Core

Versión de la API:

v1

Establece la directiva de salida de Git para el área de trabajo especificada, cuando la directiva de salida está establecida en "Denegar".
Esta API usa el método PUT y sobrescribirá toda la configuración. En los casos en que el área de trabajo restrinja la directiva de salida, un administrador del área de trabajo debe permitir el uso de la integración de Git en el área de trabajo especificada. Cuando no haya ninguna restricción de salida en el área de trabajo, se producirá un error al cambiar esta propiedad y no afectará a la configuración de integración de Git. Ejecute siempre la directiva de salida de Git primero y proporcione la directiva completa en el cuerpo de la solicitud.

Permissions

El autor de la llamada debe tener el rol de área de trabajo de administrador .

Ámbitos delegados necesarios

Workspace.ReadWrite.All

Identidades admitidas de Microsoft Entra

Esta API admite las identidades de Microsoft enumeradas en esta sección.

identidad	Support
Usuario	Sí
Entidad de servicio e Identidades administradas	Sí

Interfaz

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
workspaceId	path	True	string (uuid)	El identificador del área de trabajo.

Encabezado de la solicitud

Nombre	Requerido	Tipo	Description
If-Match		string	Un valor ETag. El ETag debe especificarse entre comillas. Si se proporciona, la llamada solo se realizará correctamente si la ETag del recurso coincide con la ETag proporcionada.

Cuerpo de la solicitud

Nombre	Tipo	Description
defaultAction	NetworkAccessRule	Directiva predeterminada para el acceso al área de trabajo desde redes públicas.

Respuestas

Nombre	Tipo	Description
200 OK		Solicitud completada correctamente. Encabezados ETag: string
Other Status Codes	ErrorResponse	Códigos de error comunes: UnknownError: se produjo un error.

Ejemplos

Set workspace networking communication policy example

Solicitud de ejemplo

HTTP

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

{
  "defaultAction": "Allow"
}

Respuesta de muestra

status code:

200

ETag: 0f8fad5b-d9cb-469f-a165-70867728950e

Definiciones

Nombre	Description
ErrorRelatedResource	Objeto de detalles del recurso relacionado con el error.
ErrorResponse	Respuesta de error.
ErrorResponseDetails	Detalles de la respuesta de error.
NetworkAccessRule	Directiva predeterminada para el acceso al área de trabajo desde redes públicas.
NetworkRules	Directiva que define el acceso a una área de trabajo hacia o desde redes públicas.

ErrorRelatedResource

Object

Objeto de detalles del recurso relacionado con el error.

Nombre	Tipo	Description
resourceId	string	Identificador de recurso implicado en el error.
resourceType	string	Tipo del recurso implicado en el error.

ErrorResponse

Object

Respuesta de error.

Nombre	Tipo	Description
errorCode	string	Identificador específico que proporciona información sobre una condición de error, lo que permite una comunicación estandarizada entre nuestro servicio y sus usuarios.
message	string	Representación legible del error.
moreDetails	ErrorResponseDetails[]	Lista de detalles de error adicionales.
relatedResource	ErrorRelatedResource	Detalles del recurso relacionado con el error.
requestId	string	Identificador de la solicitud asociada al error.

ErrorResponseDetails

Object

Detalles de la respuesta de error.

Nombre	Tipo	Description
errorCode	string	Identificador específico que proporciona información sobre una condición de error, lo que permite una comunicación estandarizada entre nuestro servicio y sus usuarios.
message	string	Representación legible del error.
relatedResource	ErrorRelatedResource	Detalles del recurso relacionado con el error.

NetworkAccessRule

Enumeración

Directiva predeterminada para el acceso al área de trabajo desde redes públicas.

Valor	Description
Allow	Permitir todas las conexiones.
Deny	Denegar todas las conexiones.

NetworkRules

Object

Directiva que define el acceso a una área de trabajo hacia o desde redes públicas.

Nombre	Tipo	Description
defaultAction	NetworkAccessRule	Directiva predeterminada para el acceso al área de trabajo desde redes públicas.