Partilhar via

Workspaces - Set Network Communication Policy

Serviço:
Core
Versão da API:
v1

Define a política de comunicação de rede para o espaço de trabalho especificado. Essa API usa o método PUT e substituirá todas as configurações. A política restante será definida como valor padrão se apenas a política parcial for fornecida no corpo da solicitação. Execute sempre Obter Política de Comunicação de Rede primeiro e forneça a política completa no corpo da solicitação. Esta funcionalidade está atualmente em pré-visualização.

Observação

Esta API faz parte de uma versão de pré-visualização e é fornecida apenas para fins de avaliação e desenvolvimento. Ele pode mudar com base no feedback e não é recomendado para uso em produçã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 Microsoft Entra

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

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

Interface

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

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
inbound

InboundRules

As propriedades de comunicações de rede de entrada para um espaço de trabalho.
outbound

OutboundRules

As propriedades de comunicações de rede de saída para um espaço de trabalho.

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

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

{
  "inbound": {
    "publicAccessRules": {
      "defaultAction": "Allow"
    }
  },
  "outbound": {
    "publicAccessRules": {
      "defaultAction": "Deny"
    }
  }
}

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.
InboundRules

A política para todas as comunicações de entrada para um espaço de trabalho.
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.
OutboundRules

A política para todas as comunicações de saída de um espaço de trabalho.
WorkspaceNetworkingCommunicationPolicy

A política de comunicação de rede para um espaço de trabalho.

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.

InboundRules

Object

A política para todas as comunicações de entrada para um espaço de trabalho.

Name Tipo Description
publicAccessRules

NetworkRules

A política para comunicações de entrada para um espaço de trabalho a partir de redes públicas.

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.

OutboundRules

Object

A política para todas as comunicações de saída de um espaço de trabalho.

Name Tipo Description
publicAccessRules

NetworkRules

A política para comunicações de saída para redes públicas a partir de um espaço de trabalho.

WorkspaceNetworkingCommunicationPolicy

Object

A política de comunicação de rede para um espaço de trabalho.

Name Tipo Description
inbound

InboundRules

As propriedades de comunicações de rede de entrada para um espaço de trabalho.
outbound

OutboundRules

As propriedades de comunicações de rede de saída para um espaço de trabalho.