Workspaces - Set Inbound External Data Shares Policy
Imposta i criteri di bypass delle condivisioni dati esterne in ingresso per un'area di lavoro. Questa API consente agli amministratori dell'area di lavoro di consentire o negare il traffico delle condivisioni dati esterne per ignorare le restrizioni di rete in ingresso. Questa funzionalità è attualmente disponibile solo in anteprima.
Note
Questa API fa parte di una versione di anteprima e viene fornita solo a scopo di valutazione e sviluppo. Può cambiare in base al feedback e non è consigliato per l'uso in produzione.
Permissions
Il chiamante deve avere ruolo amministratore'area di lavoro.
Ambiti delegati obbligatori
SpazioDiLavoro.LetturaScrittura.Tutti
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
PUT https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/networking/communicationPolicy/inbound/externalDataShares
Parametri dell'URI
| Nome | In | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
workspace
|
path | True |
string (uuid) |
L’ID dell’area di lavoro. |
Intestazione di richiesta
| Nome | Necessario | Tipo | Descrizione |
|---|---|---|---|
| If-Match |
string |
Un valore ETag. L'ETag deve essere specificato tra virgolette. Se specificato, la chiamata avrà esito positivo solo se l'ETag della risorsa corrisponde all'ETag specificato. |
Corpo della richiesta
| Nome | Tipo | Descrizione |
|---|---|---|
| defaultAction |
Definisce se il traffico condivisioni dati esterne può ignorare le restrizioni di rete in ingresso. |
Risposte
| Nome | Tipo | Descrizione |
|---|---|---|
| 200 OK |
Richiesta completata correttamente. Intestazioni ETag: string |
|
| 429 Too Many Requests |
È stato superato il limite di velocità del servizio. Il server restituisce un'intestazione Intestazioni Retry-After: integer |
|
| Other Status Codes |
Codici di errore comuni:
|
Esempio
Set workspace inbound External Data Shares policy example
Esempio di richiesta
PUT https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/networking/communicationPolicy/inbound/externalDataShares
{
"defaultAction": "Allow"
}
Risposta di esempio
ETag: "e5f6g7h8"
Definizioni
| Nome | Descrizione |
|---|---|
|
Error |
Parametro strutturato che fornisce un contesto aggiuntivo leggibile dal computer relativo a un errore. |
|
Error |
Oggetto dei dettagli della risorsa relativo all'errore. |
|
Error |
Risposta di errore. |
|
Error |
Dettagli della risposta di errore. |
|
Network |
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 è |
|
Workspace |
Criteri di eccezione di rete in ingresso per condivisioni dati esterne in un'area di lavoro. |
ErrorParameter
Parametro strutturato che fornisce un contesto aggiuntivo leggibile dal computer relativo a un errore.
| Nome | Tipo | Descrizione |
|---|---|---|
| message |
string |
Descrizione leggibile del significato del parametro. |
| name |
string |
L'identificatore dei parametri. |
| value |
string |
Valore del parametro. |
ErrorRelatedResource
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
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 |
| message |
string |
Rappresentazione leggibile dell'errore. |
| moreDetails |
Elenco di dettagli aggiuntivi sull'errore. |
|
| parameters |
Parametri strutturati che forniscono un contesto aggiuntivo leggibile dal computer sull'errore. |
|
| relatedResource |
Dettagli della risorsa correlati all'errore. |
|
| requestId |
string (uuid) |
ID della richiesta associata all'errore. |
ErrorResponseDetails
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. |
| parameters |
Parametri strutturati che forniscono un contesto aggiuntivo leggibile dal computer sull'errore. |
|
| relatedResource |
Dettagli della risorsa correlati all'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.
| Valore | Descrizione |
|---|---|
| Allow |
Consenti tutte le connessioni. |
| Deny |
Nega tutte le connessioni. |
WorkspaceInboundExternalDataSharesPolicy
Criteri di eccezione di rete in ingresso per condivisioni dati esterne in un'area di lavoro.
| Nome | Tipo | Descrizione |
|---|---|---|
| defaultAction |
Definisce se il traffico condivisioni dati esterne può ignorare le restrizioni di rete in ingresso. |