Freigeben über

Workspaces - Get Network Communication Policy

Dienst:
Core
API-Version:
v1

Gibt die Netzwerkkommunikationsrichtlinie für den angegebenen Arbeitsbereich zurück. Dieses Feature befindet sich derzeit in der Vorschau.

Hinweis

Diese API ist Teil einer Preview-Version und wird nur für Evaluierungs- und Entwicklungszwecke bereitgestellt. Sie kann sich basierend auf Feedback ändern und wird nicht für den Produktionseinsatz empfohlen.

Erlaubnisse

Der Anrufer muss über die Rolle "Viewer " oder einen höheren Arbeitsbereich verfügen.

Erforderliche delegierte Bereiche

Workspace.Read.All oder Workspace.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
Dienstprinzipal und verwaltete Identitäten Yes

Schnittstelle

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
workspaceId
 path True

string (uuid)

Die Arbeitsbereichs-ID.

Antworten

Name Typ Beschreibung
200 OK

WorkspaceNetworkingCommunicationPolicy

Die Anforderung wurde erfolgreich abgeschlossen.

Header

ETag: string
Other Status Codes

ErrorResponse

Häufige Fehlercodes:

  • UnknownError – Ein Fehler ist aufgetreten.

Beispiele

Get workspace networking communication policy example

Beispielanforderung

GET https://api.fabric.microsoft.com/v1/workspaces/47482db6-4583-4672-86dd-999d0f8f4d7a/networking/communicationPolicy

Beispiel für eine Antwort

Statuscode:
200 
ETag: 0f8fad5b-d9cb-469f-a165-70867728950e
{
  "inbound": {
    "publicAccessRules": {
      "defaultAction": "Deny"
    }
  },
  "outbound": {
    "publicAccessRules": {
      "defaultAction": "Allow"
    }
  }
}

Definitionen

Name Beschreibung
ErrorRelatedResource

Das Fehlerbezogene Ressourcendetails-Objekt.
ErrorResponse

Die Fehlerantwort.
ErrorResponseDetails

Die Fehlerantwortdetails.
InboundRules

Die Richtlinie für alle eingehenden Kommunikationen an einen Arbeitsbereich.
NetworkAccessRule

Standardrichtlinie für den Arbeitsbereichszugriff aus öffentlichen Netzwerken.
NetworkRules

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

Die Richtlinie für alle ausgehenden Kommunikationen aus einem Arbeitsbereich.
WorkspaceNetworkingCommunicationPolicy

Die Netzwerkkommunikationsrichtlinie für einen Arbeitsbereich.

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

string

Eine lesbare Darstellung des Fehlers.
moreDetails

ErrorResponseDetails[]

Liste der zusätzlichen Fehlerdetails.
relatedResource

ErrorRelatedResource

Die fehlerbezogenen Ressourcendetails.
requestId

string

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

ErrorRelatedResource

Die fehlerbezogenen Ressourcendetails.

InboundRules

Objekt

Die Richtlinie für alle eingehenden Kommunikationen an einen Arbeitsbereich.

Name Typ Beschreibung
publicAccessRules

NetworkRules

Die Richtlinie für eingehende Kommunikationen an einen Arbeitsbereich aus öffentlichen Netzwerken.

NetworkAccessRule

Enumeration

Standardrichtlinie für den Arbeitsbereichszugriff aus öffentlichen Netzwerken.

Wert Beschreibung
Allow

Alle Verbindungen zulassen.
Deny

Alle Verbindungen verweigern.

NetworkRules

Objekt

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

Name Typ Beschreibung
defaultAction

NetworkAccessRule

Standardrichtlinie für den Arbeitsbereichszugriff aus öffentlichen Netzwerken.

OutboundRules

Objekt

Die Richtlinie für alle ausgehenden Kommunikationen aus einem Arbeitsbereich.

Name Typ Beschreibung
publicAccessRules

NetworkRules

Die Richtlinie für ausgehende Kommunikation mit öffentlichen Netzwerken aus einem Arbeitsbereich.

WorkspaceNetworkingCommunicationPolicy

Objekt

Die Netzwerkkommunikationsrichtlinie für einen Arbeitsbereich.

Name Typ Beschreibung
inbound

InboundRules

Die Eigenschaften der eingehenden Netzwerkkommunikation für einen Arbeitsbereich.
outbound

OutboundRules

Die Eigenschaften der ausgehenden Netzwerkkommunikation für einen Arbeitsbereich.