Workspaces - Get Inbound External Data Shares Policy

Servizio:
Core
Versione API:
v1

Restituisce i criteri di bypass delle condivisioni dati esterne in ingresso per un'area di lavoro. Questa API è progettata per aiutare gli amministratori dell'area di lavoro a visualizzare se il traffico condivisioni dati esterne può ignorare le restrizioni di rete in ingresso.

Permissions

Il chiamante deve avere ruolo visualizzatore o superiore.

Ambiti delegati obbligatori

Workspace.Read.All o Workspace.ReadWrite.All

Identità supportate da Microsoft Entra

Questa API supporta le identità di Microsoft elencate in questa sezione.

Identity Support
User Sì
Principale del servizio e Identità gestite Sì

Interfaccia

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
workspaceId
 path True

string (uuid)

L’ID dell’area di lavoro.

Risposte

Nome Tipo Descrizione
200 OK

WorkspaceInboundExternalDataSharesPolicy

Richiesta completata correttamente.

Intestazioni

ETag: string
429 Too Many Requests

ErrorResponse

È stato superato il limite di velocità del servizio. Il server restituisce un'intestazione Retry-After che indica, in secondi, per quanto tempo il client deve attendere prima di inviare richieste aggiuntive.

Intestazioni

Retry-After: integer
Other Status Codes

ErrorResponse

Codici di errore comuni:

  • UnknownError: si è verificato un errore.

Esempio

Get workspace inbound External Data Shares policy example

Esempio di richiesta

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

Risposta di esempio

Codice di stato:
200 
ETag: "a1b2c3d4"
{
  "defaultAction": "Deny"
}

Definizioni

Nome Descrizione
ErrorRelatedResource

Oggetto dei dettagli della risorsa relativo all'errore.
ErrorResponse

Risposta di errore.
ErrorResponseDetails

Dettagli della risposta di errore.
NetworkAccessRule

Criterio predefinito per l'accesso all'area di lavoro dalle reti pubbliche. Se omesso da un corpo della richiesta PUT, per impostazione predefinita questo campo è Allow, che potrebbe aprire involontariamente l'accesso alla rete. Specificare sempre in modo esplicito questo campo in ogni corpo della richiesta PUT.
WorkspaceInboundExternalDataSharesPolicy

Criteri di eccezione di rete in ingresso per condivisioni dati esterne in un'area di lavoro.

ErrorRelatedResource

Oggetto

Oggetto dei dettagli della risorsa relativo all'errore.

Nome Tipo Descrizione
resourceId

string

ID risorsa coinvolto nell'errore.
resourceType

string

Tipo della risorsa coinvolta nell'errore.

ErrorResponse

Oggetto

Risposta di errore.

Nome Tipo Descrizione
errorCode

string

Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
isRetriable

boolean

Se true, la richiesta può essere ritentata. Usare l'intestazione della Retry-After risposta per determinare il ritardo, se disponibile.
message

string

Rappresentazione leggibile dell'errore.
moreDetails

ErrorResponseDetails[]

Elenco di dettagli aggiuntivi sull'errore.
relatedResource

ErrorRelatedResource

Dettagli della risorsa correlati all'errore.
requestId

string (uuid)

ID della richiesta associata all'errore.

ErrorResponseDetails

Oggetto

Dettagli della risposta di errore.

Nome Tipo Descrizione
errorCode

string

Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
message

string

Rappresentazione leggibile dell'errore.
relatedResource

ErrorRelatedResource

Dettagli della risorsa correlati all'errore.

NetworkAccessRule

Enumerazione

Criterio predefinito per l'accesso all'area di lavoro dalle reti pubbliche. Se omesso da un corpo della richiesta PUT, per impostazione predefinita questo campo è Allow, che potrebbe aprire involontariamente l'accesso alla rete. Specificare sempre in modo esplicito questo campo in ogni corpo della richiesta PUT.

Valore Descrizione
Allow

Consenti tutte le connessioni.
Deny

Nega tutte le connessioni.

WorkspaceInboundExternalDataSharesPolicy

Oggetto

Criteri di eccezione di rete in ingresso per condivisioni dati esterne in un'area di lavoro.

Nome Tipo Descrizione
defaultAction

NetworkAccessRule

Definisce se il traffico condivisioni dati esterne può ignorare le restrizioni di rete in ingresso.