Workspaces - Set Inbound External Data Shares Policy

Servicio:
Core
Versión de la API:
v1

Establece la directiva de omisión de recursos compartidos de datos externos de entrada para un área de trabajo. Esta API permite a los administradores del área de trabajo permitir o denegar el tráfico de recursos compartidos de datos externos para omitir las restricciones de red entrantes. Esta funcionalidad actualmente está en su versión preliminar.

Note

Esta API forma parte de una versión preliminar y solo se proporciona con fines de evaluación y desarrollo. Puede cambiar en función de los comentarios y no se recomienda para su uso en producción.

Permissions

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

Ámbitos delegados necesarios

Workspace.ReadWrite.All

Identidades admitidas de Microsoft Entra

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

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

Interfaz

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

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

Define si el tráfico de recursos compartidos de datos externos puede omitir las restricciones de red entrantes.

Respuestas

Nombre Tipo Description
200 OK

Solicitud completada correctamente.

Encabezados

ETag: string
429 Too Many Requests

ErrorResponse

Se superó el límite de frecuencia de servicio. El servidor devuelve un Retry-After encabezado que indica, en segundos, cuánto tiempo debe esperar el cliente antes de enviar solicitudes adicionales.

Encabezados

Retry-After: integer
Other Status Codes

ErrorResponse

Códigos de error comunes:

  • UnknownError: se produjo un error.

Ejemplos

Set workspace inbound External Data Shares policy example

Solicitud de ejemplo

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


{
  "defaultAction": "Allow"
}

Respuesta de muestra

status code:
200 
ETag: "e5f6g7h8"

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. Si se omite de un cuerpo de solicitud PUT, este campo tiene Allowcomo valor predeterminado , que puede abrir accidentalmente el acceso a la red. Especifique siempre explícitamente este campo en cada cuerpo de solicitud PUT.
WorkspaceInboundExternalDataSharesPolicy

Directiva de excepción de red de entrada para recursos compartidos de datos externos en un área de trabajo.

ErrorRelatedResource

Objeto

Objeto de detalles del recurso relacionado con el error.

Nombre Tipo Description
resourceId

string

ID de recurso que está involucrado en el error.
resourceType

string

Tipo del recurso implicado en el error.

ErrorResponse

Objeto

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

boolean

Cuando es true, se puede reintentar la solicitud. Use el Retry-After encabezado de respuesta para determinar el retraso, si está disponible.
message

string

Representación comprensible para humanos del error.
moreDetails

ErrorResponseDetails[]

Lista de detalles de error adicionales.
relatedResource

ErrorRelatedResource

Detalles del recurso relacionado con el error.
requestId

string (uuid)

Identificador de la solicitud asociada al error.

ErrorResponseDetails

Objeto

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 comprensible para humanos 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. Si se omite de un cuerpo de solicitud PUT, este campo tiene Allowcomo valor predeterminado , que puede abrir accidentalmente el acceso a la red. Especifique siempre explícitamente este campo en cada cuerpo de solicitud PUT.

Valor Description
Allow

Permitir todas las conexiones.
Deny

Denegar todas las conexiones.

WorkspaceInboundExternalDataSharesPolicy

Objeto

Directiva de excepción de red de entrada para recursos compartidos de datos externos en un área de trabajo.

Nombre Tipo Description
defaultAction

NetworkAccessRule

Define si el tráfico de recursos compartidos de datos externos puede omitir las restricciones de red entrantes.