Workspaces - List Networking Communication Policies

Service:: Admin

Versione API:: v1

Restituisce le impostazioni dei criteri di comunicazione di rete per tutte le aree di lavoro nel tenant.
Restituisce i dettagli dei criteri di comunicazione di rete impaginati per tutte le aree di lavoro. La risposta include le impostazioni di protezione dell'accesso in ingresso (regole di accesso pubblico e regole del firewall IP), le impostazioni di protezione dell'accesso in uscita (regole di accesso pubblico, regole di connessione, regole del gateway, criteri Git e endpoint privati gestiti) e metadati dell'area di lavoro.

Questa API supporta paginazione. Con il token di continuazione fornito nella risposta, è possibile ottenere il set di record successivo.

Permissions

Il chiamante deve essere un amministratore di Fabric o eseguire l'autenticazione usando un'entità servizio.

Ambiti delegati obbligatori

Tenant.Read.All o Tenant.ReadWrite.All

Identità supportate da Microsoft Entra

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

Identità	Support
User	Yes
Principale del servizio e Identità gestite	Yes

Interfaccia

GET https://api.fabric.microsoft.com/v1/admin/workspaces/networking/communicationpolicies

Con parametri facoltativi:

GET https://api.fabric.microsoft.com/v1/admin/workspaces/networking/communicationpolicies?continuationToken={continuationToken}&filter={filter}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
continuationToken	query		string	Token per il recupero della pagina successiva dei risultati.
filter	query		string	Filtra le aree di lavoro in base alla direzione dei criteri. Espressioni di filtro supportate: `inbound/publicAccessRules/defaultAction eq 'deny'`, `outbound/publicAccessRules/defaultAction eq 'deny'`o entrambe combinate con `or`.

Risposte

Nome Tipo Descrizione

200 OK

Nome	Tipo	Descrizione
200 OK	NetworkCommunicationPolicies	Operazione riuscita.
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: InsufficientPrivileges: il chiamante non dispone delle autorizzazioni per chiamare l'API. InvalidFilterExpression: l'espressione di filtro non è valida o contiene proprietà non supportate.

NetworkCommunicationPolicies

Operazione riuscita.

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:

InsufficientPrivileges: il chiamante non dispone delle autorizzazioni per chiamare l'API.
InvalidFilterExpression: l'espressione di filtro non è valida o contiene proprietà non supportate.

Esempio

List network communication policy settings filtered by inbound policy example

List network communication policy settings for all workspaces example

List network communication policy settings filtered by inbound policy example

Esempio di richiesta

HTTP

GET https://api.fabric.microsoft.com/v1/admin/workspaces/networking/communicationpolicies?filter=inbound/publicAccessRules/defaultAction eq 'deny'

Risposta di esempio

Codice di stato:: 200

{
  "value": [
    {
      "workspaceId": "fa9ad228-3e6b-44d4-b5f4-e275f337afa9",
      "workspaceName": "Finance Analytics",
      "workspaceType": "Workspace",
      "inbound": {
        "publicAccessRules": {
          "defaultAction": "Deny"
        },
        "firewall": {
          "rules": [
            {
              "displayName": "CorpNet",
              "value": "10.0.0.0-10.255.255.255"
            }
          ]
        }
      },
      "outbound": {
        "publicAccessRules": {
          "defaultAction": "Allow"
        },
        "connections": {
          "defaultAction": "Allow",
          "rules": []
        },
        "gateways": {
          "defaultAction": "Allow",
          "allowedGateways": []
        },
        "git": {
          "defaultAction": "Allow"
        },
        "managedPrivateEndpoints": []
      }
    }
  ]
}

List network communication policy settings for all workspaces example

Esempio di richiesta

HTTP

GET https://api.fabric.microsoft.com/v1/admin/workspaces/networking/communicationpolicies

Risposta di esempio

Codice di stato:: 200

{
  "value": [
    {
      "workspaceId": "fa9ad228-3e6b-44d4-b5f4-e275f337afa9",
      "workspaceName": "Finance Analytics",
      "workspaceType": "Workspace",
      "inbound": {
        "publicAccessRules": {
          "defaultAction": "Deny"
        },
        "firewall": {
          "rules": [
            {
              "displayName": "CorpNet",
              "value": "10.0.0.0-10.255.255.255"
            },
            {
              "displayName": "VPN",
              "value": "172.16.0.0-172.31.255.255"
            }
          ]
        }
      },
      "outbound": {
        "publicAccessRules": {
          "defaultAction": "Deny"
        },
        "connections": {
          "defaultAction": "Deny",
          "rules": [
            {
              "connectionType": "SQL",
              "defaultAction": "Deny",
              "allowedEndpoints": [
                {
                  "hostnamePattern": "*.microsoft.com"
                }
              ]
            },
            {
              "connectionType": "lakehouse",
              "defaultAction": "Deny",
              "allowedWorkspaces": [
                {
                  "workspaceId": "91c5ae74-e82d-4dd3-bfeb-6b1814030123"
                }
              ]
            }
          ]
        },
        "gateways": {
          "defaultAction": "Deny",
          "allowedGateways": [
            {
              "id": "17d8929d-ab32-46d1-858b-fdea74e93bf2"
            }
          ]
        },
        "git": {
          "defaultAction": "Deny"
        },
        "managedPrivateEndpoints": [
          {
            "id": "f3d04593-28fe-409e-a568-ebffbea69f37",
            "name": "SqlProdEndpoint",
            "targetPrivateLinkResourceId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg-prod/providers/Microsoft.Sql/servers/sql-prod-server",
            "targetSubresourceType": "sqlServer",
            "provisioningState": "Succeeded",
            "connectionState": {
              "status": "Approved",
              "description": "Auto-approved",
              "actionsRequired": "None"
            }
          }
        ]
      }
    },
    {
      "workspaceId": "b2c3d4e5-f6a7-4890-abcd-ef1234567890",
      "workspaceName": "Marketing Reports",
      "workspaceType": "Workspace",
      "inbound": {
        "publicAccessRules": {
          "defaultAction": "Allow"
        }
      },
      "outbound": {
        "publicAccessRules": {
          "defaultAction": "Allow"
        },
        "connections": {
          "defaultAction": "Allow",
          "rules": []
        },
        "gateways": {
          "defaultAction": "Allow",
          "allowedGateways": []
        },
        "git": {
          "defaultAction": "Allow"
        },
        "managedPrivateEndpoints": []
      }
    }
  ],
  "continuationUri": "https://api.fabric.microsoft.com/v1/admin/workspaces/networking/communicationpolicies?continuationToken=eyJMYXN0U2VlbkNvbm5lY3Rpb25JZCI6NX0%3D",
  "continuationToken": "eyJMYXN0U2VlbkNvbm5lY3Rpb25JZCI6NX0%3D"
}

Definizioni

Nome	Descrizione
ConnectionAccessActionType	Definisce il comportamento di controllo di accesso per le connessioni in uscita. Questa enumerazione viene utilizzata per il campo defaultAction per specificare se la comunicazione in uscita deve essere consentita o negata per impostazione predefinita. Questo tipo consente sia il controllo globale che specifico della connessione sull'accesso in uscita, consentendo di applicare criteri di comunicazione di rete sicuri e prevedibili. È possibile aggiungere altri tipi di azione di accesso alla connessione nel tempo.
ConnectionRuleEndpointMetadata	Rappresenta una singola regola di eccezione a livello di endpoint che consente la comunicazione in uscita a un dominio o a un host esterno specifico. Questo oggetto viene usato all'interno della matrice allowedEndpoints di una regola di connessione per autorizzare in modo esplicito l'accesso in uscita agli endpoint attendibili per un determinato connectionType. Questo è applicabile solo ai tipi di connessione che supportano il filtro basato su endpoint ,ad esempio SQL, MySQL, Web e così via.
ConnectionRuleWorkspaceMetadata	Rappresenta una regola di eccezione a livello di area di lavoro che consente la comunicazione in uscita a un'area di lavoro specifica per un determinato connectionType. Questo oggetto viene usato all'interno della matrice allowedWorkspaces di una regola di connessione per autorizzare in modo esplicito l'accesso tra aree di lavoro. Questo è applicabile solo ai tipi di connessione che supportano il filtro basato sull'area di lavoro, ad esempio Lakehouse, Warehouse, FabricSql e PowerPlatformDataflows.
ConnectionStatus	Stato della connessione dell'endpoint privato. È possibile aggiungere lo stato di connessione aggiuntivo nel tempo.
ErrorParameter	Parametro strutturato che fornisce un contesto aggiuntivo leggibile dal computer relativo a un errore.
ErrorRelatedResource	Oggetto dettagli risorsa correlato all'errore.
ErrorResponse	Risposta di errore.
ErrorResponseDetails	Dettagli della risposta di errore.
FirewallRule	Rappresenta una singola regola del firewall IP.
FirewallRules	Rappresenta le regole del firewall IP configurate per la protezione dell'accesso in ingresso di un'area di lavoro.
GatewayAccessActionType	Definisce il comportamento di controllo di accesso per i gateway in uscita. Questa enumerazione viene utilizzata per il campo defaultAction per specificare se la comunicazione in uscita deve essere consentita o negata per impostazione predefinita. Questo tipo consente sia il controllo globale che specifico del gateway sull'accesso in uscita, consentendo di applicare criteri di comunicazione di rete sicuri e prevedibili. È possibile aggiungere altri tipi di azione di accesso al gateway nel tempo.
GatewayAccessRuleMetadata	Rappresenta un gateway consentito per la comunicazione in uscita. Questo oggetto viene usato all'interno di allowedGateways per autorizzare in modo esplicito l'accesso in uscita.
ManagedPrivateEndpoint	Endpoint privato gestito.
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.
NetworkCommunicationPolicies	Elenco delle impostazioni dei criteri di comunicazione di rete per le aree di lavoro nel tenant.
NetworkCommunicationPolicyDetails	Rappresenta i dettagli delle impostazioni dei criteri di comunicazione di rete per ogni area di lavoro.
NetworkCommunicationPolicyInboundDetails	Rappresenta le impostazioni dei criteri di comunicazione di rete in ingresso per un'area di lavoro.
NetworkCommunicationPolicyOutboundDetails	Rappresenta le impostazioni dei criteri di comunicazione di rete in uscita per un'area di lavoro.
NetworkRules	I criteri che definiscono l'accesso a/da un'area di lavoro a/da reti pubbliche.
OutboundConnectionRule	Definisce una regola di accesso in uscita per una connessione cloud specifica.
PrivateEndpointConnectionState	Stato di connessione dell'endpoint privato
PrivateEndpointProvisioningState	Stato di provisioning dell'endpoint.
WorkspaceOutboundConnections	Rappresenta il set completo di regole di connessione cloud per la protezione dell'accesso in uscita configurate per un'area di lavoro come parte dei criteri di comunicazione di rete. Questo oggetto definisce le regole di connessione che regolano quali endpoint esterni e aree di lavoro sono consentiti o negati per la comunicazione in uscita
WorkspaceOutboundGateways	Rappresenta il set completo di regole di protezione dell'accesso in uscita del gateway configurate per un'area di lavoro come parte dei criteri di comunicazione di rete. Questo oggetto definisce le regole del gateway che regolano la comunicazione in uscita
WorkspaceType	Tipo di area di lavoro. È possibile aggiungere altri tipi di area di lavoro nel tempo.

ConnectionAccessActionType

Enumerazione

Definisce il comportamento di controllo di accesso per le connessioni in uscita. Questa enumerazione viene utilizzata per il campo defaultAction per specificare se la comunicazione in uscita deve essere consentita o negata per impostazione predefinita. Questo tipo consente sia il controllo globale che specifico della connessione sull'accesso in uscita, consentendo di applicare criteri di comunicazione di rete sicuri e prevedibili. È possibile aggiungere altri tipi di azione di accesso alla connessione nel tempo.

Valore	Descrizione
Allow	Consente le connessioni in uscita. Se usato come azione predefinita, tutte le connessioni cloud sono consentite.
Deny	Blocca le connessioni in uscita. Se usato come azione predefinita, tutte le connessioni cloud vengono negate a meno che non siano consentite in modo esplicito.

ConnectionRuleEndpointMetadata

Oggetto

Rappresenta una singola regola di eccezione a livello di endpoint che consente la comunicazione in uscita a un dominio o a un host esterno specifico. Questo oggetto viene usato all'interno della matrice allowedEndpoints di una regola di connessione per autorizzare in modo esplicito l'accesso in uscita agli endpoint attendibili per un determinato connectionType. Questo è applicabile solo ai tipi di connessione che supportano il filtro basato su endpoint ,ad esempio SQL, MySQL, Web e così via.

Nome	Tipo	Descrizione
hostnamePattern	string	Modello supportato da caratteri jolly che definisce l'endpoint esterno consentito. Gli esempi includono *.microsoft.com, api.contoso.com o data.partner.org.

ConnectionRuleWorkspaceMetadata

Oggetto

Rappresenta una regola di eccezione a livello di area di lavoro che consente la comunicazione in uscita a un'area di lavoro specifica per un determinato connectionType. Questo oggetto viene usato all'interno della matrice allowedWorkspaces di una regola di connessione per autorizzare in modo esplicito l'accesso tra aree di lavoro. Questo è applicabile solo ai tipi di connessione che supportano il filtro basato sull'area di lavoro, ad esempio Lakehouse, Warehouse, FabricSql e PowerPlatformDataflows.

Nome	Tipo	Descrizione
workspaceId	string (uuid)	Identificatore univoco (GUID) dell'area di lavoro di destinazione che può essere connessa dall'area di lavoro corrente.

ConnectionStatus

Enumerazione

Stato della connessione dell'endpoint privato. È possibile aggiungere lo stato di connessione aggiuntivo nel tempo.

Valore	Descrizione
Pending	Approvazione in sospeso
Approved	Endpoint approvato
Rejected	Endpoint rifiutato
Disconnected	Endpoint disconnesso

ErrorParameter

Oggetto

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

Oggetto dettagli risorsa correlato 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.
parameters	ErrorParameter[]	Parametri strutturati che forniscono un contesto aggiuntivo leggibile dal computer 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.
parameters	ErrorParameter[]	Parametri strutturati che forniscono un contesto aggiuntivo leggibile dal computer sull'errore.
relatedResource	ErrorRelatedResource	Dettagli della risorsa correlati all'errore.

FirewallRule

Oggetto

Rappresenta una singola regola del firewall IP.

Nome	Tipo	Descrizione
displayName	string	Nome visualizzato della regola del firewall.
value	string	Intervallo IP in formato iniziale (ad esempio, `0.0.0.0-255.255.255.255`) o notazione CIDR.

FirewallRules

Oggetto

Rappresenta le regole del firewall IP configurate per la protezione dell'accesso in ingresso di un'area di lavoro.

Nome	Tipo	Descrizione
rules	FirewallRule[]	Elenco delle regole del firewall IP configurate per l'area di lavoro.

GatewayAccessActionType

Enumerazione

Definisce il comportamento di controllo di accesso per i gateway in uscita. Questa enumerazione viene utilizzata per il campo defaultAction per specificare se la comunicazione in uscita deve essere consentita o negata per impostazione predefinita. Questo tipo consente sia il controllo globale che specifico del gateway sull'accesso in uscita, consentendo di applicare criteri di comunicazione di rete sicuri e prevedibili. È possibile aggiungere altri tipi di azione di accesso al gateway nel tempo.

Valore	Descrizione
Allow	Consente i gateway in uscita. Se usato come azione predefinita, tutti i gateway sono consentiti.
Deny	Blocca i gateway in uscita. Se usato come azione predefinita, tutti i gateway vengono negati a meno che non siano consentiti in modo esplicito.

GatewayAccessRuleMetadata

Oggetto

Rappresenta un gateway consentito per la comunicazione in uscita. Questo oggetto viene usato all'interno di allowedGateways per autorizzare in modo esplicito l'accesso in uscita.

Nome	Tipo	Descrizione
id	string (uuid)	ID gateway consentito.

ManagedPrivateEndpoint

Oggetto

Endpoint privato gestito.

Nome	Tipo	Descrizione
connectionState	PrivateEndpointConnectionState	Stato di connessione dell'endpoint degli endpoint di cui è stato effettuato il provisioning.
id	string (uuid)	ID endpoint privato gestito.
name	string	Nome dell'endpoint privato.
provisioningState	PrivateEndpointProvisioningState	Stato di provisioning dell'endpoint.
targetPrivateLinkResourceId	string	ID risorsa dell'origine dati per cui viene creato l'endpoint privato
targetSubresourceType	string	Risorsa secondaria che punta alla risorsa Collegamento privato.

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.

NetworkCommunicationPolicies

Oggetto

Elenco delle impostazioni dei criteri di comunicazione di rete per le aree di lavoro nel tenant.

Nome	Tipo	Descrizione
continuationToken	string	Token per il batch del set di risultati successivo. Se non sono presenti altri record, viene rimosso dalla risposta.
continuationUri	string	URI del batch del set di risultati successivo. Se non sono presenti altri record, viene rimosso dalla risposta.
value	NetworkCommunicationPolicyDetails[]	Elenco delle impostazioni dei criteri di comunicazione di rete per le aree di lavoro nel tenant.

NetworkCommunicationPolicyDetails

Oggetto

Rappresenta i dettagli delle impostazioni dei criteri di comunicazione di rete per ogni area di lavoro.

Nome	Tipo	Descrizione
inbound	NetworkCommunicationPolicyInboundDetails	Definisce le impostazioni di protezione dell'accesso in ingresso.
outbound	NetworkCommunicationPolicyOutboundDetails	Definisce le impostazioni di protezione dell'accesso in uscita.
workspaceId	string (uuid)	L’ID dell’area di lavoro.
workspaceName	string	Nome visualizzato dell'area di lavoro.
workspaceType	WorkspaceType	Tipo di area di lavoro.

NetworkCommunicationPolicyInboundDetails

Oggetto

Rappresenta le impostazioni dei criteri di comunicazione di rete in ingresso per un'area di lavoro.

Nome	Tipo	Descrizione
firewall	FirewallRules	Regole del firewall IP configurate per la protezione dell'accesso in ingresso dell'area di lavoro.
publicAccessRules	NetworkRules	Criteri per tutte le comunicazioni in ingresso a un'area di lavoro.

NetworkCommunicationPolicyOutboundDetails

Oggetto

Rappresenta le impostazioni dei criteri di comunicazione di rete in uscita per un'area di lavoro.

Nome	Tipo	Descrizione
connections	WorkspaceOutboundConnections	Rappresenta il set completo di regole di connessione cloud per la protezione dell'accesso in uscita configurate per un'area di lavoro come parte dei criteri di comunicazione di rete. Questo oggetto definisce le regole di connessione che regolano quali endpoint esterni e aree di lavoro sono consentiti o negati per la comunicazione in uscita.
gateways	WorkspaceOutboundGateways	Rappresenta il set completo di regole di protezione dell'accesso in uscita del gateway configurate per un'area di lavoro come parte dei criteri di comunicazione di rete. Questo oggetto definisce le regole del gateway che regolano la comunicazione in uscita.
git	NetworkRules	Rappresenta i criteri git in uscita per l'area di lavoro come parte dei criteri di comunicazione di rete.
managedPrivateEndpoints	ManagedPrivateEndpoint[]	Gli endpoint privati gestiti configurati per la protezione dell'accesso in uscita dell'area di lavoro.
publicAccessRules	NetworkRules	Criteri per tutte le comunicazioni in uscita da un'area di lavoro.

NetworkRules

Oggetto

I criteri che definiscono l'accesso a/da un'area di lavoro a/da reti pubbliche.

Nome	Tipo	Descrizione
defaultAction	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.

OutboundConnectionRule

Oggetto

Definisce una regola di accesso in uscita per una connessione cloud specifica.

Nome	Tipo	Descrizione
allowedEndpoints	ConnectionRuleEndpointMetadata[]	Definisce un elenco di endpoint esterni consentiti in modo esplicito per connectionType. Ogni voce nella matrice rappresenta un modello hostname consentito per la comunicazione in uscita dall'area di lavoro. Questo campo è applicabile solo ai tipi di connessione che supportano il filtro basato su endpoint ,ad esempio SQL, MySQL, Web e così via. Se defaultAction è impostato su "Nega" per il tipo di connessione, saranno consentiti solo gli endpoint elencati qui; tutti gli altri saranno bloccati.
allowedWorkspaces	ConnectionRuleWorkspaceMetadata[]	Specifica un elenco di ID dell'area di lavoro consentiti in modo esplicito per la comunicazione in uscita per il connectionType dell'infrastruttura specificato. Questo campo è applicabile solo ai tipi di connessione dell'infrastruttura che supportano il filtro basato sull'area di lavoro, limitato a Lakehouse, Warehouse, FabricSql e PowerPlatformDataflows. Quando defaultAction è impostato su "Nega" per un tipo di connessione, solo le aree di lavoro elencate in allowedWorkspaces saranno consentite per l'accesso in uscita; tutti gli altri saranno bloccati.
connectionType	string	Specifica il tipo di connessione cloud a cui si applica la regola. Il comportamento e l'applicabilità di altre proprietà della regola , ad esempio allowedEndpoints o allowedWorkspaces, possono variare a seconda delle funzionalità del tipo di connessione.
defaultAction	ConnectionAccessActionType	Definisce il comportamento di accesso in uscita predefinito per connectionType. Questo campo determina se le connessioni di questo tipo sono consentite o bloccate per impostazione predefinita, a meno che non vengano ulteriormente perfezionate da allowedEndpoints o allowedWorkspaces. Se impostato su "Consenti": tutte le connessioni di questo tipo sono consentite a meno che non venga negato esplicitamente da una regola più specifica. Questo campo fornisce un controllo granulare su ogni tipo di connessione e integra il comportamento di fallback globale definito da defaultAction.

PrivateEndpointConnectionState

Oggetto

Stato di connessione dell'endpoint privato

Nome	Tipo	Descrizione
actionsRequired	string	Azioni necessarie per stabilire la connessione.
description	string	Messaggio di descrizione (se presente) fornito per l'approvazione o il rifiuto del punto finale.
status	ConnectionStatus	Stato della connessione

PrivateEndpointProvisioningState

Enumerazione

Stato di provisioning dell'endpoint.

Valore	Descrizione
Provisioning	L'endpoint privato nel provisioning è in corso
Succeeded	Provisioning di endpoint privati Completato
Updating	Aggiornamento dell'endpoint privato
Deleting	Eliminazione dell'endpoint privato
Failed	Provisioning dell'endpoint privato non riuscito

WorkspaceOutboundConnections

Oggetto

Rappresenta il set completo di regole di connessione cloud per la protezione dell'accesso in uscita configurate per un'area di lavoro come parte dei criteri di comunicazione di rete. Questo oggetto definisce le regole di connessione che regolano quali endpoint esterni e aree di lavoro sono consentiti o negati per la comunicazione in uscita

Nome	Tipo	Descrizione
defaultAction	ConnectionAccessActionType	Definisce il comportamento predefinito per tutti i tipi di connessione cloud non elencati in modo esplicito nella matrice di regole. Se è impostato su "Consenti", tutti i tipi di connessione non specificati sono consentiti per impostazione predefinita. Se impostato su "Deny", tutti i tipi di connessione non specificati vengono bloccati per impostazione predefinita, a meno che non siano consentiti in modo esplicito. Questa impostazione funge da criterio di fallback globale ed è fondamentale per applicare un comportamento predefinito sicuro negli ambienti in cui devono essere consentite solo connessioni note e attendibili. Se omesso da un corpo della richiesta PUT, per impostazione predefinita questo campo è , che potrebbe consentire involontariamente `Allow`tutte le connessioni in uscita. Specificare sempre in modo esplicito questo campo in ogni corpo della richiesta PUT.
rules	OutboundConnectionRule[]	Elenco di regole che definiscono il comportamento di accesso in uscita per tipi di connessione cloud specifici. Ogni regola può includere restrizioni basate su endpoint o basate sull'area di lavoro a seconda dei tipi di connessione supportati.

WorkspaceOutboundGateways

Oggetto

Rappresenta il set completo di regole di protezione dell'accesso in uscita del gateway configurate per un'area di lavoro come parte dei criteri di comunicazione di rete. Questo oggetto definisce le regole del gateway che regolano la comunicazione in uscita

Nome	Tipo	Descrizione
allowedGateways	GatewayAccessRuleMetadata[]	Elenco di regole che definiscono il comportamento di accesso in uscita per i gateway.
defaultAction	GatewayAccessActionType	Definisce il comportamento predefinito per tutti i gateway non elencati in modo esplicito nella matrice di elenchi consentiti. Se è impostato su "Consenti", tutti i gateway non specificati sono consentiti per impostazione predefinita. Se impostato su "Nega", tutti i gateway non specificati vengono bloccati. Se omesso da un corpo della richiesta PUT, per impostazione predefinita questo campo è , che potrebbe consentire involontariamente `Allow`tutte le connessioni gateway in uscita. Specificare sempre in modo esplicito questo campo in ogni corpo della richiesta PUT.

WorkspaceType

Enumerazione

Tipo di area di lavoro. È possibile aggiungere altri tipi di area di lavoro nel tempo.

Valore	Descrizione
Personal	La cartella o l'area di lavoro personale usata per gestire gli elementi utente.
Workspace	Area di lavoro usata per gestire gli elementi dell'infrastruttura.
AdminWorkspace	Area di lavoro monitoraggio amministratore. Contiene report di amministratore, ad esempio il report di controllo e il report sull'utilizzo e l'adozione.