Workspaces - Get Inbound External Data Shares Policy

Serviço:: Core

Versão da API:: v1

Devolve a política de bypass de Partilhas Externas de Dados de entrada para um espaço de trabalho. Esta API foi concebida para ajudar os administradores de espaços de trabalho a verificar se o tráfego de Partilhas de Dados Externas pode contornar as restrições de rede de entrada.

Permissions

O chamador deve ter visualizador ou superior função de espaço de trabalho.

Escopos delegados necessários

Workspace.Read.All ou Workspace.ReadWrite.All

Identidades suportadas pelo Entra da Microsoft

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

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

Interface

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/networking/communicationPolicy/inbound/externalDataShares

Parâmetros do URI

Name	Em	Obrigatório	Tipo	Descrição
workspaceId	path	True	string (uuid)	O ID do espaço de trabalho.

Respostas

Name Tipo Descrição

200 OK

Name	Tipo	Descrição
200 OK	WorkspaceInboundExternalDataSharesPolicy	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.

WorkspaceInboundExternalDataSharesPolicy

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

Get workspace inbound External Data Shares policy example

Pedido de amostra

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/networking/communicationPolicy/inbound/externalDataShares

Resposta da amostra

Código de estado:: 200

ETag: "a1b2c3d4"

{
  "defaultAction": "Deny"
}

Definições

Name	Descrição
ErrorRelatedResource	Os detalhes do objeto de recurso relacionado ao erro.
ErrorResponse	A resposta de erro.
ErrorResponseDetails	Os detalhes do erro na resposta.
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.
WorkspaceInboundExternalDataSharesPolicy	A política de exceção de rede de entrada para Partilhas de Dados Externas num espaço de trabalho.

ErrorRelatedResource

Object

Os detalhes do objeto de recurso relacionado ao erro.

Name	Tipo	Descrição
resourceId	string	O ID do recurso envolvido no erro.
resourceType	string	O tipo de recurso envolvido no erro.

ErrorResponse

Object

A resposta de erro.

Name	Tipo	Descrição
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	Detalhes do recurso relacionado ao erro.
requestId	string (uuid)	ID da solicitação associada ao erro.

ErrorResponseDetails

Object

Os detalhes do erro na resposta.

Name	Tipo	Descrição
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	Detalhes do recurso relacionado 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	Descrição
Allow	Permitir todas as conexões.
Deny	Negar todas as conexões.

WorkspaceInboundExternalDataSharesPolicy

Object

A política de exceção de rede de entrada para Partilhas de Dados Externas num espaço de trabalho.

Name	Tipo	Descrição
defaultAction	NetworkAccessRule	Define se o tráfego de Partilhas de Dados Externas pode contornar as restrições de rede de entrada.