Workspaces - List Networking Communication Policies

Dienst:: Admin

API-Version:: v1

Gibt Netzwerkkommunikationsrichtlinieneinstellungen für alle Arbeitsbereiche im Mandanten zurück.
Gibt Details der paginierten Netzwerkkommunikationsrichtlinie für alle Arbeitsbereiche zurück. Die Antwort umfasst Einstellungen für den Schutz vor eingehendem Zugriff (Regeln für den öffentlichen Zugriff und IP-Firewall), Einstellungen für den Schutz vor ausgehendem Zugriff (Öffentliche Zugriffsregeln, Verbindungsregeln, Gatewayregeln, Git-Richtlinie und verwaltete private Endpunkte) und Arbeitsbereichsmetadaten.

Diese API unterstützt Paginierung. Mit dem in der Antwort bereitgestellten Fortsetzungstoken können Sie den nächsten Datensatzsatz abrufen.

Erlaubnisse

Der Aufrufer muss ein Fabric-Administrator sein oder sich mit einem Dienstprinzipal authentifizieren.

Erforderliche delegierte Bereiche

Tenant.Read.All oder Tenant.ReadWrite.All

Von Microsoft Entra unterstützte Identitäten

Diese API unterstützt die in diesem Abschnitt aufgeführten Microsoft Identitäten.

Identität	Support
Benutzer	Yes
Service Principal und Verwaltete Identitäten	Yes

Schnittstelle

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

Mit optionalen Parametern:

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
continuationToken	query		string	Ein Token zum Abrufen der nächsten Seite mit Ergebnissen.
filter	query		string	Filtert Arbeitsbereiche nach Richtlinienrichtung. Unterstützte Filterausdrücke: `inbound/publicAccessRules/defaultAction eq 'deny'`, `outbound/publicAccessRules/defaultAction eq 'deny'`, oder beide kombiniert mit `or`.

Antworten

Name Typ Beschreibung

200 OK

Name	Typ	Beschreibung
200 OK	NetworkCommunicationPolicies	Der Vorgang war erfolgreich.
429 Too Many Requests	ErrorResponse	Der Dienstratengrenzwert wurde überschritten. Der Server gibt einen `Retry-After` Header zurück, der in Sekunden angibt, wie lange der Client warten muss, bevor zusätzliche Anforderungen gesendet werden. Header Retry-After: integer
Other Status Codes	ErrorResponse	Häufige Fehlercodes: Nicht ausreichendprivilegiert – Der Aufrufer verfügt nicht über berechtigungen, um die API aufzurufen. InvalidFilterExpression – Der Filterausdruck ist ungültig oder enthält nicht unterstützte Eigenschaften.

NetworkCommunicationPolicies

Der Vorgang war erfolgreich.

429 Too Many Requests

ErrorResponse

Der Dienstratengrenzwert wurde überschritten. Der Server gibt einen Retry-After Header zurück, der in Sekunden angibt, wie lange der Client warten muss, bevor zusätzliche Anforderungen gesendet werden.

Header

Retry-After: integer

Other Status Codes

ErrorResponse

Häufige Fehlercodes:

Nicht ausreichendprivilegiert – Der Aufrufer verfügt nicht über berechtigungen, um die API aufzurufen.
InvalidFilterExpression – Der Filterausdruck ist ungültig oder enthält nicht unterstützte Eigenschaften.

Beispiele

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

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

Statuscode:: 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

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

Statuscode:: 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"
}

Definitionen

Name	Beschreibung
ConnectionAccessActionType	Definiert das Zugriffssteuerungsverhalten für ausgehende Verbindungen. Diese Enumeration wird für das Feld defaultAction verwendet, um anzugeben, ob ausgehende Kommunikation standardmäßig zulässig oder verweigert werden soll. Dieser Typ ermöglicht sowohl globale als auch verbindungsspezifische Kontrolle über ausgehenden Zugriff, wodurch sichere und vorhersehbare Netzwerkkommunikationsrichtlinien erzwungen werden. Zusätzliche Verbindungszugriffsaktionstypen können im Laufe der Zeit hinzugefügt werden.
ConnectionRuleEndpointMetadata	Stellt eine Ausnahmeregel auf einzelner Endpunktebene dar, die ausgehende Kommunikation mit einer bestimmten externen Domäne oder einem bestimmten Host ermöglicht. Dieses Objekt wird innerhalb des arrays allowedEndpoints einer Verbindungsregel verwendet, um explizit ausgehenden Zugriff auf vertrauenswürdige Endpunkte für einen bestimmten connectionType zu autorisieren. Dies gilt nur für Verbindungstypen, die endpunktbasierte Filterung unterstützen (z. B. SQL, MySQL, Web usw.).
ConnectionRuleWorkspaceMetadata	Stellt eine Ausnahmeregel auf Arbeitsbereichsebene dar, die ausgehende Kommunikation mit einem bestimmten Arbeitsbereich für einen bestimmten ConnectionType ermöglicht. Dieses Objekt wird innerhalb des arrays allowedWorkspaces einer Verbindungsregel verwendet, um den arbeitsbereichübergreifenden Zugriff explizit zu autorisieren. Dies gilt nur für Verbindungstypen, die arbeitsbereichbasierte Filterung unterstützen, z. B. Lakehouse, Warehouse, FabricSql und PowerPlatformDataflows.
ConnectionStatus	Verbindungsstatus des privaten Endpunkts. Der zusätzliche Verbindungsstatus kann im Laufe der Zeit hinzugefügt werden.
ErrorParameter	Ein strukturierter Parameter, der zusätzlichen computerlesbaren Kontext zu einem Fehler bereitstellt.
ErrorRelatedResource	Das Fehlerbezogene Ressourcendetails-Objekt.
ErrorResponse	Die Fehlerantwort.
ErrorResponseDetails	Die Fehlerantwortdetails.
FirewallRule	Stellt eine einzelne IP-Firewallregel dar.
FirewallRules	Stellt die IP-Firewallregeln dar, die für den Schutz des eingehenden Zugriffs eines Arbeitsbereichs konfiguriert sind.
GatewayAccessActionType	Definiert das Zugriffssteuerungsverhalten für ausgehende Gateways. Diese Enumeration wird für das Feld defaultAction verwendet, um anzugeben, ob ausgehende Kommunikation standardmäßig zulässig oder verweigert werden soll. Dieser Typ ermöglicht sowohl globale als auch gatewayspezifische Kontrolle über ausgehenden Zugriff, wodurch sichere und vorhersehbare Netzwerkkommunikationsrichtlinien erzwungen werden. Zusätzliche Gatewayzugriffsaktionstypen können im Laufe der Zeit hinzugefügt werden.
GatewayAccessRuleMetadata	Stellt ein Gateway dar, das für ausgehende Kommunikation zulässig ist. Dieses Objekt wird innerhalb der allowedGateways verwendet, um den ausgehenden Zugriff explizit zu autorisieren.
ManagedPrivateEndpoint	Verwalteter privater Endpunkt.
NetworkAccessRule	Die Standardrichtlinie für den Arbeitsbereichszugriff aus öffentlichen Netzwerken. Wenn sie von einem PUT-Anforderungstext nicht angegeben wird, wird `Allow`dieses Feld standardmäßig als "Netzwerkzugriff" festgelegt, wodurch der Netzwerkzugriff unbeabsichtigt geöffnet werden kann. Geben Sie dieses Feld immer explizit in jedem PUT-Anforderungstext an.
NetworkCommunicationPolicies	Eine Liste der Netzwerkkommunikationsrichtlinieneinstellungen für Arbeitsbereiche im Mandanten.
NetworkCommunicationPolicyDetails	Stellt die Details der Netzwerkkommunikationsrichtlinieneinstellungen für jeden Arbeitsbereich dar.
NetworkCommunicationPolicyInboundDetails	Stellt die Einstellungen für eingehende Netzwerkkommunikationsrichtlinien für einen Arbeitsbereich dar.
NetworkCommunicationPolicyOutboundDetails	Stellt die Einstellungen für ausgehende Netzwerkkommunikationsrichtlinien für einen Arbeitsbereich dar.
NetworkRules	Die Richtlinie, die den Zugriff auf/von einem Arbeitsbereich auf/von öffentlichen Netzwerken definiert.
OutboundConnectionRule	Definiert eine Ausgehende Zugriffsregel für eine bestimmte Cloudverbindung.
PrivateEndpointConnectionState	Verbindungsstatus des privaten Endpunkts
PrivateEndpointProvisioningState	Bereitstellungsstatus des Endpunkts.
WorkspaceOutboundConnections	Stellt den vollständigen Satz von Cloudverbindungsregeln für ausgehenden Zugriff dar, die für einen Arbeitsbereich als Teil der Netzwerkkommunikationsrichtlinie konfiguriert sind. Dieses Objekt definiert die Verbindungsregeln, die steuern, welche externen Endpunkte und Arbeitsbereiche für ausgehende Kommunikation zulässig oder verweigert werden.
WorkspaceOutboundGateways	Stellt den vollständigen Satz von Gateway-Schutzregeln für ausgehenden Zugriff dar, die für einen Arbeitsbereich im Rahmen der Netzwerkkommunikationsrichtlinie konfiguriert sind. Dieses Objekt definiert die Gatewayregeln, die ausgehende Kommunikation regeln.
WorkspaceType	Ein Arbeitsbereichstyp. Weitere Arbeitsbereichstypen können im Laufe der Zeit hinzugefügt werden.

ConnectionAccessActionType

Enumeration

Definiert das Zugriffssteuerungsverhalten für ausgehende Verbindungen. Diese Enumeration wird für das Feld defaultAction verwendet, um anzugeben, ob ausgehende Kommunikation standardmäßig zulässig oder verweigert werden soll. Dieser Typ ermöglicht sowohl globale als auch verbindungsspezifische Kontrolle über ausgehenden Zugriff, wodurch sichere und vorhersehbare Netzwerkkommunikationsrichtlinien erzwungen werden. Zusätzliche Verbindungszugriffsaktionstypen können im Laufe der Zeit hinzugefügt werden.

Wert	Beschreibung
Allow	Ermöglicht ausgehende Verbindungen. Bei Verwendung als Standardaktion sind alle Cloudverbindungen zulässig.
Deny	Blockiert ausgehende Verbindungen. Wenn sie als Standardaktion verwendet wird, werden alle Cloudverbindungen verweigert, es sei denn, sie sind explizit zulässig.

ConnectionRuleEndpointMetadata

Objekt

Stellt eine Ausnahmeregel auf einzelner Endpunktebene dar, die ausgehende Kommunikation mit einer bestimmten externen Domäne oder einem bestimmten Host ermöglicht. Dieses Objekt wird innerhalb des arrays allowedEndpoints einer Verbindungsregel verwendet, um explizit ausgehenden Zugriff auf vertrauenswürdige Endpunkte für einen bestimmten connectionType zu autorisieren. Dies gilt nur für Verbindungstypen, die endpunktbasierte Filterung unterstützen (z. B. SQL, MySQL, Web usw.).

Name	Typ	Beschreibung
hostnamePattern	string	Ein von Einem Wildcard unterstütztes Muster, das den zulässigen externen Endpunkt definiert. Beispiele sind *.microsoft.com, api.contoso.com oder data.partner.org.

ConnectionRuleWorkspaceMetadata

Objekt

Stellt eine Ausnahmeregel auf Arbeitsbereichsebene dar, die ausgehende Kommunikation mit einem bestimmten Arbeitsbereich für einen bestimmten ConnectionType ermöglicht. Dieses Objekt wird innerhalb des arrays allowedWorkspaces einer Verbindungsregel verwendet, um den arbeitsbereichübergreifenden Zugriff explizit zu autorisieren. Dies gilt nur für Verbindungstypen, die arbeitsbereichbasierte Filterung unterstützen, z. B. Lakehouse, Warehouse, FabricSql und PowerPlatformDataflows.

Name	Typ	Beschreibung
workspaceId	string (uuid)	Der eindeutige Bezeichner (GUID) des Zielarbeitsbereichs, der aus dem aktuellen Arbeitsbereich verbunden werden darf.

ConnectionStatus

Enumeration

Verbindungsstatus des privaten Endpunkts. Der zusätzliche Verbindungsstatus kann im Laufe der Zeit hinzugefügt werden.

Wert	Beschreibung
Pending	Genehmigung ausstehend
Approved	Endpunkt genehmigt
Rejected	Endpunkt abgelehnt
Disconnected	Endpunkt getrennt

ErrorParameter

Objekt

Ein strukturierter Parameter, der zusätzlichen computerlesbaren Kontext zu einem Fehler bereitstellt.

Name	Typ	Beschreibung
message	string	Eine lesbare Beschreibung der Bedeutung des Parameters.
name	string	Die Parameterkennung.
value	string	Der übergebene Wert

ErrorRelatedResource

Objekt

Das Fehlerbezogene Ressourcendetails-Objekt.

Name	Typ	Beschreibung
resourceId	string	Die Ressourcen-ID, die an dem Fehler beteiligt ist.
resourceType	string	Der Typ der Ressource, die an dem Fehler beteiligt ist.

ErrorResponse

Objekt

Die Fehlerantwort.

Name	Typ	Beschreibung
errorCode	string	Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht.
isRetriable	boolean	Wenn true, kann die Anforderung wiederholt werden. Verwenden Sie den `Retry-After` Antwortheader, um die Verzögerung zu ermitteln, falls verfügbar.
message	string	Eine lesbare Darstellung des Fehlers.
moreDetails	ErrorResponseDetails[]	Liste der zusätzlichen Fehlerdetails.
parameters	ErrorParameter[]	Strukturierte Parameter, die zusätzlichen maschinenlesbaren Kontext zu dem Fehler bereitstellen.
relatedResource	ErrorRelatedResource	Die fehlerbezogenen Ressourcendetails.
requestId	string (uuid)	ID der Anforderung, die dem Fehler zugeordnet ist.

ErrorResponseDetails

Objekt

Die Fehlerantwortdetails.

Name	Typ	Beschreibung
errorCode	string	Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht.
message	string	Eine lesbare Darstellung des Fehlers.
parameters	ErrorParameter[]	Strukturierte Parameter, die zusätzlichen maschinenlesbaren Kontext zu dem Fehler bereitstellen.
relatedResource	ErrorRelatedResource	Die fehlerbezogenen Ressourcendetails.

FirewallRule

Objekt

Stellt eine einzelne IP-Firewallregel dar.

Name	Typ	Beschreibung
displayName	string	Der Anzeigename der Firewallregel.
value	string	Der IP-Bereich im Start-End-Format (z `0.0.0.0-255.255.255.255`. B. ) oder CIDR-Notation.

FirewallRules

Objekt

Stellt die IP-Firewallregeln dar, die für den Schutz des eingehenden Zugriffs eines Arbeitsbereichs konfiguriert sind.

Name	Typ	Beschreibung
rules	FirewallRule[]	Eine Liste der IP-Firewallregeln, die für den Arbeitsbereich konfiguriert sind.

GatewayAccessActionType

Enumeration

Definiert das Zugriffssteuerungsverhalten für ausgehende Gateways. Diese Enumeration wird für das Feld defaultAction verwendet, um anzugeben, ob ausgehende Kommunikation standardmäßig zulässig oder verweigert werden soll. Dieser Typ ermöglicht sowohl globale als auch gatewayspezifische Kontrolle über ausgehenden Zugriff, wodurch sichere und vorhersehbare Netzwerkkommunikationsrichtlinien erzwungen werden. Zusätzliche Gatewayzugriffsaktionstypen können im Laufe der Zeit hinzugefügt werden.

Wert	Beschreibung
Allow	Erlaubt ausgehende Gateways. Bei Verwendung als Standardaktion sind alle Gateways zulässig.
Deny	Blockiert ausgehende Gateways. Wenn sie als Standardaktion verwendet wird, werden alle Gateways verweigert, es sei denn, dies ist explizit zulässig.

GatewayAccessRuleMetadata

Objekt

Stellt ein Gateway dar, das für ausgehende Kommunikation zulässig ist. Dieses Objekt wird innerhalb der allowedGateways verwendet, um den ausgehenden Zugriff explizit zu autorisieren.

Name	Typ	Beschreibung
id	string (uuid)	Gateway-ID zulässig.

ManagedPrivateEndpoint

Objekt

Verwalteter privater Endpunkt.

Name	Typ	Beschreibung
connectionState	PrivateEndpointConnectionState	Endpunktverbindungsstatus der bereitgestellten Endpunkte.
id	string (uuid)	Verwaltete private Endpunkt-ID.
name	string	Der Name des privaten Endpunkts.
provisioningState	PrivateEndpointProvisioningState	Bereitstellungsstatus des Endpunkts.
targetPrivateLinkResourceId	string	Ressourcen-ID der Datenquelle, für die ein privater Endpunkt erstellt wird
targetSubresourceType	string	Unterressource, die auf " Private-Link-Resoure" verweist.

NetworkAccessRule

Enumeration

Die Standardrichtlinie für den Arbeitsbereichszugriff aus öffentlichen Netzwerken. Wenn sie von einem PUT-Anforderungstext nicht angegeben wird, wird Allowdieses Feld standardmäßig als "Netzwerkzugriff" festgelegt, wodurch der Netzwerkzugriff unbeabsichtigt geöffnet werden kann. Geben Sie dieses Feld immer explizit in jedem PUT-Anforderungstext an.

Wert	Beschreibung
Allow	Alle Verbindungen zulassen.
Deny	Alle Verbindungen verweigern.

NetworkCommunicationPolicies

Objekt

Eine Liste der Netzwerkkommunikationsrichtlinieneinstellungen für Arbeitsbereiche im Mandanten.

Name	Typ	Beschreibung
continuationToken	string	Das Token für den nächsten Resultsetbatch. Wenn keine weiteren Datensätze vorhanden sind, wird sie aus der Antwort entfernt.
continuationUri	string	Der URI des nächsten Resultsetbatches. Wenn keine weiteren Datensätze vorhanden sind, wird sie aus der Antwort entfernt.
value	NetworkCommunicationPolicyDetails[]	Eine Liste der Netzwerkkommunikationsrichtlinieneinstellungen für Arbeitsbereiche im Mandanten.

NetworkCommunicationPolicyDetails

Objekt

Stellt die Details der Netzwerkkommunikationsrichtlinieneinstellungen für jeden Arbeitsbereich dar.

Name	Typ	Beschreibung
inbound	NetworkCommunicationPolicyInboundDetails	Definiert die Einstellungen für den Schutz vor eingehendem Zugriff.
outbound	NetworkCommunicationPolicyOutboundDetails	Definiert die Einstellungen für den Schutz vor ausgehenden Zugriff.
workspaceId	string (uuid)	Die Arbeitsbereichs-ID.
workspaceName	string	Der Anzeigename des Arbeitsbereichs.
workspaceType	WorkspaceType	Der Arbeitsbereichstyp.

NetworkCommunicationPolicyInboundDetails

Objekt

Stellt die Einstellungen für eingehende Netzwerkkommunikationsrichtlinien für einen Arbeitsbereich dar.

Name	Typ	Beschreibung
firewall	FirewallRules	Die IP-Firewallregeln, die für den Schutz des eingehenden Zugriffs des Arbeitsbereichs konfiguriert sind.
publicAccessRules	NetworkRules	Die Richtlinie für alle eingehenden Kommunikationen an einen Arbeitsbereich.

NetworkCommunicationPolicyOutboundDetails

Objekt

Stellt die Einstellungen für ausgehende Netzwerkkommunikationsrichtlinien für einen Arbeitsbereich dar.

Name	Typ	Beschreibung
connections	WorkspaceOutboundConnections	Stellt den vollständigen Satz von Cloudverbindungsregeln für ausgehenden Zugriff dar, die für einen Arbeitsbereich als Teil der Netzwerkkommunikationsrichtlinie konfiguriert sind. Dieses Objekt definiert die Verbindungsregeln, die steuern, welche externen Endpunkte und Arbeitsbereiche für ausgehende Kommunikation zulässig oder verweigert werden.
gateways	WorkspaceOutboundGateways	Stellt den vollständigen Satz von Gateway-Schutzregeln für ausgehenden Zugriff dar, die für einen Arbeitsbereich im Rahmen der Netzwerkkommunikationsrichtlinie konfiguriert sind. Dieses Objekt definiert die Gatewayregeln, die ausgehende Kommunikation regeln.
git	NetworkRules	Stellt die Git-ausgehende Richtlinie für den Arbeitsbereich als Teil der Netzwerkkommunikationsrichtlinie dar.
managedPrivateEndpoints	ManagedPrivateEndpoint[]	Die verwalteten privaten Endpunkte, die für den Schutz des ausgehenden Zugriffs des Arbeitsbereichs konfiguriert sind.
publicAccessRules	NetworkRules	Die Richtlinie für alle ausgehenden Kommunikationen aus einem Arbeitsbereich.

NetworkRules

Objekt

Die Richtlinie, die den Zugriff auf/von einem Arbeitsbereich auf/von öffentlichen Netzwerken definiert.

Name	Typ	Beschreibung
defaultAction	NetworkAccessRule	Die Standardrichtlinie für den Arbeitsbereichszugriff aus öffentlichen Netzwerken. Wenn sie von einem PUT-Anforderungstext nicht angegeben wird, wird `Allow`dieses Feld standardmäßig als "Netzwerkzugriff" festgelegt, wodurch der Netzwerkzugriff unbeabsichtigt geöffnet werden kann. Geben Sie dieses Feld immer explizit in jedem PUT-Anforderungstext an.

OutboundConnectionRule

Objekt

Definiert eine Ausgehende Zugriffsregel für eine bestimmte Cloudverbindung.

Name	Typ	Beschreibung
allowedEndpoints	ConnectionRuleEndpointMetadata[]	Definiert eine Liste der explizit zulässigen externen Endpunkte für den connectionType. Jeder Eintrag im Array stellt ein Hostnamenmuster dar, das für ausgehende Kommunikation aus dem Arbeitsbereich zulässig ist. Dieses Feld gilt nur für Verbindungstypen, die endpunktbasierte Filterung unterstützen (z. B. SQL, MySQL, Web usw.). Wenn defaultAction für den Verbindungstyp auf "Verweigern" festgelegt ist, sind nur die hier aufgeführten Endpunkte zulässig. alle anderen werden blockiert.
allowedWorkspaces	ConnectionRuleWorkspaceMetadata[]	Gibt eine Liste der Arbeitsbereichs-IDs an, die für die ausgehende Kommunikation für den angegebenen Fabric connectionType explizit zulässig sind. Dieses Feld gilt nur für Fabric-Verbindungstypen, die arbeitsbereichsbasierte Filterung unterstützen, beschränkt auf Lakehouse-, Warehouse-, FabricSql- und PowerPlatformDataflows. Wenn defaultAction für einen Verbindungstyp auf "Verweigern" festgelegt ist, werden nur die in allowedWorkspaces aufgeführten Arbeitsbereiche für ausgehenden Zugriff zugelassen. alle anderen werden blockiert.
connectionType	string	Gibt den Cloudverbindungstyp an, auf den die Regel angewendet wird. Das Verhalten und die Anwendbarkeit anderer Regeleigenschaften (z. B. allowedEndpoints oder allowedWorkspaces) kann je nach den Funktionen des Verbindungstyps variieren.
defaultAction	ConnectionAccessActionType	Definiert das standardverhalten des ausgehenden Zugriffs für den connectionType. Dieses Feld bestimmt, ob Verbindungen dieses Typs standardmäßig zulässig oder blockiert werden, es sei denn, sie werden von allowedEndpoints oder allowedWorkspaces weiter verfeinert. Wenn diese Einstellung auf "Zulassen" festgelegt ist: Alle Verbindungen dieses Typs sind zulässig, es sei denn, dies wird von einer spezifischeren Regel explizit verweigert. Dieses Feld bietet eine differenzierte Kontrolle über jeden Verbindungstyp und ergänzt das globale Fallbackverhalten, das standardmäßig definiert wird.

PrivateEndpointConnectionState

Objekt

Verbindungsstatus des privaten Endpunkts

Name	Typ	Beschreibung
actionsRequired	string	Zum Herstellen der Verbindung erforderliche Aktionen.
description	string	Beschreibungsmeldung (falls vorhanden) beim Genehmigen oder Ablehnen des Endpunkts.
status	ConnectionStatus	Status der Verbindung

PrivateEndpointProvisioningState

Enumeration

Bereitstellungsstatus des Endpunkts.

Wert	Beschreibung
Provisioning	Privater Endpunkt in der Bereitstellung wird in Bearbeitung
Succeeded	Private Endpunktbereitstellung erfolgreich
Updating	Aktualisierung des privaten Endpunkts
Deleting	Privater Endpunkt wird gelöscht
Failed	Fehler bei der Bereitstellung privater Endpunkte

WorkspaceOutboundConnections

Objekt

Stellt den vollständigen Satz von Cloudverbindungsregeln für ausgehenden Zugriff dar, die für einen Arbeitsbereich als Teil der Netzwerkkommunikationsrichtlinie konfiguriert sind. Dieses Objekt definiert die Verbindungsregeln, die steuern, welche externen Endpunkte und Arbeitsbereiche für ausgehende Kommunikation zulässig oder verweigert werden.

Name	Typ	Beschreibung
defaultAction	ConnectionAccessActionType	Definiert das Standardverhalten für alle Cloudverbindungstypen, die nicht explizit im Regelarray aufgeführt sind. Wenn sie auf "Zulassen" festgelegt ist, sind standardmäßig alle nicht angegebenen Verbindungstypen zulässig. Wenn dieser Wert auf "Verweigern" festgelegt ist, werden alle nicht angegebenen Verbindungstypen standardmäßig blockiert, es sei denn, dies ist explizit zulässig. Diese Einstellung fungiert als globale Fallbackrichtlinie und ist entscheidend für die Erzwingung eines sicheren Standardstatus in Umgebungen, in denen nur bekannte und vertrauenswürdige Verbindungen zulässig sein sollten. Wenn sie von einem PUT-Anforderungstext `Allow`weggelassen wird, wird dieses Feld standardmäßig als Standard verwendet, was unbeabsichtigt alle ausgehenden Verbindungen zulässt. Geben Sie dieses Feld immer explizit in jedem PUT-Anforderungstext an.
rules	OutboundConnectionRule[]	Eine Liste der Regeln, die das Verhalten des ausgehenden Zugriffs für bestimmte Cloudverbindungstypen definieren. Jede Regel kann endpunktbasierte oder arbeitsbereichbasierte Einschränkungen enthalten, je nach unterstützten Verbindungstypen.

WorkspaceOutboundGateways

Objekt

Stellt den vollständigen Satz von Gateway-Schutzregeln für ausgehenden Zugriff dar, die für einen Arbeitsbereich im Rahmen der Netzwerkkommunikationsrichtlinie konfiguriert sind. Dieses Objekt definiert die Gatewayregeln, die ausgehende Kommunikation regeln.

Name	Typ	Beschreibung
allowedGateways	GatewayAccessRuleMetadata[]	Eine Liste der Regeln, die das Verhalten des ausgehenden Zugriffs für Gateways definieren.
defaultAction	GatewayAccessActionType	Definiert das Standardverhalten für alle Gateways, die nicht explizit im zulässigen Listenarray aufgeführt sind. Wenn diese Option auf "Zulassen" festgelegt ist, sind standardmäßig alle nicht angegebenen Gateways zulässig. Wenn diese Option auf "Verweigern" festgelegt ist, werden alle nicht angegebenen Gateways blockiert. Wenn sie von einem PUT-Anforderungstext `Allow`weggelassen wird, wird in diesem Feld standardmäßig standardmäßig festgelegt, was unbeabsichtigt alle ausgehenden Gatewayverbindungen zulässt. Geben Sie dieses Feld immer explizit in jedem PUT-Anforderungstext an.

WorkspaceType

Enumeration

Ein Arbeitsbereichstyp. Weitere Arbeitsbereichstypen können im Laufe der Zeit hinzugefügt werden.

Wert	Beschreibung
Personal	Mein Ordner oder Mein Arbeitsbereich, der zum Verwalten von Benutzerelementen verwendet wird.
Workspace	Arbeitsbereich, der zum Verwalten der Fabric-Elemente verwendet wird.
AdminWorkspace	Administratorüberwachungsarbeitsbereich. Enthält Administratorberichte wie den Überwachungsbericht und den Nutzungs- und Einführungsbericht.