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'.
Esta API utiliza o método PUT e sobrescreve todas as definições. Quando o espaço de trabalho restringe a política de saída, um administrador do espaço de trabalho precisa de permitir a utilização da integração do Git no espaço de trabalho especificado. Quando não há restrição de saída no espaço de trabalho, alterar esta propriedade falha e não afeta a definição de integração do Git. Ligue sempre primeiro para a operação de Política de Saída do Get Git e forneça a política completa no corpo do pedido.

Note

Se defaultAction for omitido do corpo do pedido, passa a Allowser , o que pode permitir involuntariamente a integração do Git quando o acesso de saída deve ser restringido. Especifique defaultAction sempre explicitamente em cada corpo de pedido PUT.

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

A política padrão para o acesso ao espaço de trabalho a partir de redes públicas. Se for omitido do corpo do pedido PUT, este campo passa por defeito para Allow, o que pode involuntariamente abrir o acesso à rede. Especifique sempre explicitamente este campo em cada corpo de pedido PUT.

Respostas

Name Tipo Description
200 OK

Pedido concluído com sucesso.

Cabeçalhos

ETag: string
429 Too Many Requests

ErrorResponse

O limite de tarifa de serviço foi ultrapassado. O servidor devolve um Retry-After cabeçalho que indica, em segundos, quanto tempo o cliente deve esperar antes de enviar pedidos adicionais.

Cabeçalhos

Retry-After: integer
Other Status Codes

ErrorResponse

Códigos de erro comuns:

  • UnknownError - Ocorreu um erro.

Exemplos

Set workspace networking communication policy example

Pedido de amostra

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

A política padrão para o acesso ao espaço de trabalho a partir de redes públicas. Se for omitido do corpo do pedido PUT, este campo passa por defeito para Allow, o que pode involuntariamente abrir o acesso à rede. Especifique sempre explicitamente este campo em cada corpo de pedido PUT.
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.
isRetriable

boolean

Quando confirmado, o pedido pode ser retentado. Use o Retry-After cabeçalho de resposta para determinar o atraso, se disponível.
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 (uuid)

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

A política padrão para o acesso ao espaço de trabalho a partir de redes públicas. Se for omitido do corpo do pedido PUT, este campo passa por defeito para Allow, o que pode involuntariamente abrir o acesso à rede. Especifique sempre explicitamente este campo em cada corpo de pedido PUT.

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

A política padrão para o acesso ao espaço de trabalho a partir de redes públicas. Se for omitido do corpo do pedido PUT, este campo passa por defeito para Allow, o que pode involuntariamente abrir o acesso à rede. Especifique sempre explicitamente este campo em cada corpo de pedido PUT.