Workspaces - Set Git Outbound Policy

Serviço:

Core

Versão da API:

v1

Define a política de saída do Git para o espaço de trabalho especificado, quando a política de saída é definida como 'Negar'.
Essa API usa o método PUT e substituirá todas as configurações. Nos casos em que o espaço de trabalho restringe a política de saída, um administrador de espaço de trabalho precisa permitir o uso da integração do Git no espaço de trabalho especificado. Quando não houver nenhuma restrição de saída no espaço de trabalho, a alteração dessa propriedade falhará e não afetará a configuração de integração do Git. Sempre execute Get Git outbound Policy primeiro e forneça a política completa no corpo da solicitação.

Permissions

O chamador deve ter a função de espaço de trabalho de administrador .

Escopos delegados necessários

Workspace.ReadWrite.All

Identidades suportadas pelo Entra da Microsoft

Esta API suporta as identidades do Microsoft listadas nesta secção.

Identidade	Support
User	Yes
Entidade de serviço e identidades geridas	Yes

Interfaz

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
workspaceId	path	True	string (uuid)	O ID do espaço de trabalho.

Cabeçalho do Pedido

Name	Necessário	Tipo	Description
If-Match		string	Um valor ETag. O ETag deve ser especificado entre aspas. Se fornecida, a chamada só terá êxito se a ETag do recurso corresponder à ETag fornecida.

Corpo do Pedido

Name	Tipo	Description
defaultAction	NetworkAccessRule	Política padrão para acesso ao espaço de trabalho a partir de redes públicas.

Respostas

Name	Tipo	Description
200 OK		Pedido concluído com sucesso. Cabeçalhos ETag: string
Other Status Codes	ErrorResponse	Códigos de erro comuns: UnknownError - Ocorreu um erro.

Exemplos

Set workspace networking communication policy example

Pedido de amostra

HTTP

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

{
  "defaultAction": "Allow"
}

Resposta da amostra

Código de estado:

200

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

Definições

Name	Description
ErrorRelatedResource	O objeto de detalhes do recurso relacionado ao erro.
ErrorResponse	A resposta de erro.
ErrorResponseDetails	Os detalhes da resposta de erro.
NetworkAccessRule	Política padrão para acesso ao espaço de trabalho a partir de redes públicas.
NetworkRules	A política que define o acesso a/de um espaço de trabalho de/para redes públicas.

ErrorRelatedResource

Object

O objeto de detalhes do recurso relacionado ao erro.

Name	Tipo	Description
resourceId	string	A ID do recurso envolvida no erro.
resourceType	string	O tipo de recurso envolvido no erro.

ErrorResponse

Object

A resposta de erro.

Name	Tipo	Description
errorCode	string	Um identificador específico que fornece informações sobre uma condição de erro, permitindo uma comunicação padronizada entre nosso serviço e seus usuários.
message	string	Uma representação legível por humanos do erro.
moreDetails	ErrorResponseDetails[]	Lista de detalhes de erro adicionais.
relatedResource	ErrorRelatedResource	Os detalhes do recurso relacionados ao erro.
requestId	string	ID da solicitação associada ao erro.

ErrorResponseDetails

Object

Os detalhes da resposta de erro.

Name	Tipo	Description
errorCode	string	Um identificador específico que fornece informações sobre uma condição de erro, permitindo uma comunicação padronizada entre nosso serviço e seus usuários.
message	string	Uma representação legível por humanos do erro.
relatedResource	ErrorRelatedResource	Os detalhes do recurso relacionados ao erro.

NetworkAccessRule

Enumeração

Política padrão para acesso ao espaço de trabalho a partir de redes públicas.

Valor	Description
Allow	Permitir todas as conexões.
Deny	Negar todas as conexões.

NetworkRules

Object

A política que define o acesso a/de um espaço de trabalho de/para redes públicas.

Name	Tipo	Description
defaultAction	NetworkAccessRule	Política padrão para acesso ao espaço de trabalho a partir de redes públicas.