Workspaces - List Networking Communication Policies

Zwraca ustawienia zasad komunikacji sieciowej dla wszystkich obszarów roboczych w dzierżawie.
Zwraca szczegóły zasad komunikacji sieciowej podzielonej na strony dla wszystkich obszarów roboczych. Odpowiedź zawiera ustawienia ochrony dostępu przychodzącego (reguły dostępu publicznego i reguły zapory IP), ustawienia ochrony dostępu wychodzącego (reguły dostępu publicznego, reguły połączenia, reguły bramy, zasady usługi Git i zarządzane prywatne punkty końcowe) oraz metadane obszaru roboczego.

Ten interfejs API obsługuje stronicowanie. Token kontynuacji podany w odpowiedzi umożliwia uzyskanie następnego zestawu rekordów.

Permissions

Obiekt wywołujący musi być administratorem sieci szkieletowej lub uwierzytelniać się przy użyciu jednostki usługi.

Wymagane zakresy delegowane

Tenant.Read.All lub Tenant.ReadWrite.All

Tożsamości obsługiwane przez Microsoft Entra

To API obsługuje tożsamości Microsoft wymienione w tej sekcji.

Tożsamość Support
User Tak
Główne usługi i Tożsamości zarządzane Tak

Interfejs

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

Parametry identyfikatora URI

Nazwisko W Wymagane Typ Opis
continuationToken
query

string

Token do pobierania następnej strony wyników.

filter
query

string

Filtruje obszary robocze według kierunku zasad. Obsługiwane wyrażenia filtru: inbound/publicAccessRules/defaultAction eq 'deny', lub outbound/publicAccessRules/defaultAction eq 'deny'oba w połączeniu z or.

Odpowiedzi

Nazwisko Typ Opis
200 OK

NetworkCommunicationPolicies

Operacja zakończyła się pomyślnie.

429 Too Many Requests

ErrorResponse

Przekroczono limit szybkości usługi. Serwer zwraca nagłówek wskazujący Retry-After w sekundach, jak długo klient musi czekać przed wysłaniem dodatkowych żądań.

Nagłówki

Retry-After: integer

Other Status Codes

ErrorResponse

Typowe kody błędów:

  • InsufficientPrivileges — obiekt wywołujący nie ma uprawnień do wywoływania interfejsu API.

  • InvalidFilterExpression — wyrażenie filtru jest nieprawidłowe lub zawiera nieobsługiwane właściwości.

Przykłady

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

Przykładowe żądanie

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

Przykładowa odpowiedź

{
  "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

Przykładowe żądanie

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

Przykładowa odpowiedź

{
  "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"
}

Definicje

Nazwisko Opis
ConnectionAccessActionType

Definiuje zachowanie kontroli dostępu dla połączeń wychodzących. To wyliczenie jest używane dla pola defaultAction, aby określić, czy komunikacja wychodząca powinna być domyślnie dozwolona, czy blokowana. Ten typ umożliwia zarówno globalną, jak i specyficzną dla połączenia kontrolę dostępu wychodzącego, pomagając wymuszać bezpieczne i przewidywalne zasady komunikacji sieciowej. Dodatkowe typy akcji dostępu do połączeń mogą być dodawane w czasie.

ConnectionRuleEndpointMetadata

Reprezentuje regułę wyjątku na poziomie pojedynczego punktu końcowego, która zezwala na komunikację wychodzącą z określoną domeną zewnętrzną lub hostem. Ten obiekt jest używany w tablicy allowedEndpoints reguły połączenia, aby jawnie autoryzować dostęp wychodzący do zaufanych punktów końcowych dla danego parametru connectionType. Dotyczy to tylko typów połączeń, które obsługują filtrowanie oparte na punkcie końcowym (np. SQL, MySQL, Web itp.).

ConnectionRuleWorkspaceMetadata

Reprezentuje regułę wyjątku na poziomie obszaru roboczego, która umożliwia komunikację wychodzącą z określonym obszarem roboczym dla danego parametru connectionType. Ten obiekt jest używany w tablicy allowedWorkspaces reguły połączenia, aby jawnie autoryzować dostęp między obszarami roboczymi. Dotyczy to tylko typów połączeń, które obsługują filtrowanie oparte na obszarze roboczym, takie jak Lakehouse, Warehouse, FabricSql i PowerPlatformDataflows.

ConnectionStatus

Stan połączenia prywatnego punktu końcowego. W czasie może zostać dodany dodatkowy stan połączenia.

ErrorParameter

Parametr ustrukturyzowany zapewniający dodatkowy kontekst czytelny dla maszyny o błędzie.

ErrorRelatedResource

Obiekt szczegółów zasobu powiązanego z błędem.

ErrorResponse

Odpowiedź na błąd.

ErrorResponseDetails

Szczegóły odpowiedzi na błąd.

FirewallRule

Reprezentuje pojedynczą regułę zapory ip.

FirewallRules

Reprezentuje reguły zapory ip skonfigurowane na potrzeby ochrony dostępu przychodzącego obszaru roboczego.

GatewayAccessActionType

Definiuje zachowanie kontroli dostępu dla bram wychodzących. To wyliczenie jest używane dla pola defaultAction, aby określić, czy komunikacja wychodząca powinna być domyślnie dozwolona, czy blokowana. Ten typ umożliwia zarówno globalną, jak i specyficzną dla bramy kontrolę dostępu wychodzącego, ułatwiając wymuszanie bezpiecznych i przewidywalnych zasad komunikacji sieciowej. Dodatkowe typy akcji dostępu do bramy mogą być dodawane w czasie.

GatewayAccessRuleMetadata

Reprezentuje bramę dozwoloną dla komunikacji wychodzącej. Ten obiekt jest używany w dozwolonych Bramach do jawnego autoryzowania dostępu wychodzącego.

ManagedPrivateEndpoint

Zarządzany prywatny punkt końcowy.

NetworkAccessRule

Domyślne zasady dostępu do obszaru roboczego z sieci publicznych. Jeśli pominięto treść żądania PUT, to pole jest domyślnie ustawione na Allow, co może przypadkowo otworzyć dostęp sieciowy. Zawsze jawnie określ to pole w każdej treści żądania PUT.

NetworkCommunicationPolicies

Lista ustawień zasad komunikacji sieciowej dla obszarów roboczych w dzierżawie.

NetworkCommunicationPolicyDetails

Reprezentuje szczegóły ustawień zasad komunikacji sieciowej dla każdego obszaru roboczego.

NetworkCommunicationPolicyInboundDetails

Reprezentuje ustawienia zasad komunikacji sieciowej dla ruchu przychodzącego dla obszaru roboczego.

NetworkCommunicationPolicyOutboundDetails

Reprezentuje ustawienia zasad komunikacji sieciowej dla ruchu wychodzącego dla obszaru roboczego.

NetworkRules

Zasady definiujące dostęp do/z obszaru roboczego do/z sieci publicznych.

OutboundConnectionRule

Definiuje regułę dostępu wychodzącego dla określonego połączenia w chmurze.

PrivateEndpointConnectionState

Stan połączenia prywatnego punktu końcowego

PrivateEndpointProvisioningState

Stan aprowizacji punktu końcowego.

WorkspaceOutboundConnections

Reprezentuje kompletny zestaw reguł połączeń z chmurą ochrony dostępu wychodzącego skonfigurowanych dla obszaru roboczego w ramach zasad komunikacji sieciowej. Ten obiekt definiuje reguły połączeń, które określają, które zewnętrzne punkty końcowe i obszary robocze są dozwolone lub blokowane dla komunikacji wychodzącej

WorkspaceOutboundGateways

Reprezentuje kompletny zestaw reguł ochrony dostępu wychodzącego bramy skonfigurowanych dla obszaru roboczego w ramach zasad komunikacji sieciowej. Ten obiekt definiuje reguły bramy, które zarządzają komunikacją wychodzącą

WorkspaceType

Typ obszaru roboczego. Dodatkowe typy obszarów roboczych można dodawać w czasie.

ConnectionAccessActionType

Definiuje zachowanie kontroli dostępu dla połączeń wychodzących. To wyliczenie jest używane dla pola defaultAction, aby określić, czy komunikacja wychodząca powinna być domyślnie dozwolona, czy blokowana. Ten typ umożliwia zarówno globalną, jak i specyficzną dla połączenia kontrolę dostępu wychodzącego, pomagając wymuszać bezpieczne i przewidywalne zasady komunikacji sieciowej. Dodatkowe typy akcji dostępu do połączeń mogą być dodawane w czasie.

Wartość Opis
Allow

Zezwala na połączenia wychodzące. W przypadku użycia jako akcji domyślnej wszystkie połączenia w chmurze są dozwolone.

Deny

Blokuje połączenia wychodzące. W przypadku użycia jako akcji domyślnej wszystkie połączenia w chmurze są odrzucane, chyba że jawnie dozwolone.

ConnectionRuleEndpointMetadata

Reprezentuje regułę wyjątku na poziomie pojedynczego punktu końcowego, która zezwala na komunikację wychodzącą z określoną domeną zewnętrzną lub hostem. Ten obiekt jest używany w tablicy allowedEndpoints reguły połączenia, aby jawnie autoryzować dostęp wychodzący do zaufanych punktów końcowych dla danego parametru connectionType. Dotyczy to tylko typów połączeń, które obsługują filtrowanie oparte na punkcie końcowym (np. SQL, MySQL, Web itp.).

Nazwisko Typ Opis
hostnamePattern

string

Wzorzec obsługiwany przez symbol wieloznaczny, który definiuje dozwolony zewnętrzny punkt końcowy. Przykłady obejmują *.microsoft.com, api.contoso.com lub data.partner.org.

ConnectionRuleWorkspaceMetadata

Reprezentuje regułę wyjątku na poziomie obszaru roboczego, która umożliwia komunikację wychodzącą z określonym obszarem roboczym dla danego parametru connectionType. Ten obiekt jest używany w tablicy allowedWorkspaces reguły połączenia, aby jawnie autoryzować dostęp między obszarami roboczymi. Dotyczy to tylko typów połączeń, które obsługują filtrowanie oparte na obszarze roboczym, takie jak Lakehouse, Warehouse, FabricSql i PowerPlatformDataflows.

Nazwisko Typ Opis
workspaceId

string (uuid)

Unikatowy identyfikator (GUID) docelowego obszaru roboczego, który może być połączony z bieżącym obszarem roboczym.

ConnectionStatus

Stan połączenia prywatnego punktu końcowego. W czasie może zostać dodany dodatkowy stan połączenia.

Wartość Opis
Pending

Oczekiwanie na zatwierdzenie

Approved

Zatwierdzony punkt końcowy

Rejected

Punkt końcowy został odrzucony

Disconnected

Odłączony punkt końcowy

ErrorParameter

Parametr ustrukturyzowany zapewniający dodatkowy kontekst czytelny dla maszyny o błędzie.

Nazwisko Typ Opis
message

string

Czytelny dla człowieka opis znaczenia parametru.

name

string

Identyfikator parametru.

value

string

Wartość parametru.

ErrorRelatedResource

Obiekt szczegółów zasobu powiązanego z błędem.

Nazwisko Typ Opis
resourceId

string

Identyfikator zasobu, który jest zaangażowany w błąd.

resourceType

string

Typ zasobu, który jest zaangażowany w błąd.

ErrorResponse

Odpowiedź na błąd.

Nazwisko Typ Opis
errorCode

string

Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.

isRetriable

boolean

Jeśli to prawda, żądanie można ponowić. Użyj nagłówka Retry-After odpowiedzi, aby określić opóźnienie, jeśli jest dostępne.

message

string

Czytelna reprezentacja błędu przez człowieka.

moreDetails

ErrorResponseDetails[]

Lista dodatkowych szczegółów błędu.

parameters

ErrorParameter[]

Parametry ustrukturyzowane zapewniające dodatkowy kontekst czytelny dla maszyny o błędzie.

relatedResource

ErrorRelatedResource

Szczegóły zasobu powiązanego z błędem.

requestId

string (uuid)

Identyfikator żądania skojarzonego z błędem.

ErrorResponseDetails

Szczegóły odpowiedzi na błąd.

Nazwisko Typ Opis
errorCode

string

Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.

message

string

Czytelna reprezentacja błędu przez człowieka.

parameters

ErrorParameter[]

Parametry ustrukturyzowane zapewniające dodatkowy kontekst czytelny dla maszyny o błędzie.

relatedResource

ErrorRelatedResource

Szczegóły zasobu powiązanego z błędem.

FirewallRule

Reprezentuje pojedynczą regułę zapory ip.

Nazwisko Typ Opis
displayName

string

Nazwa wyświetlana reguły zapory.

value

string

Zakres adresów IP w formacie początkowym (na przykład 0.0.0.0-255.255.255.255) lub notacji CIDR.

FirewallRules

Reprezentuje reguły zapory ip skonfigurowane na potrzeby ochrony dostępu przychodzącego obszaru roboczego.

Nazwisko Typ Opis
rules

FirewallRule[]

Lista reguł zapory adresów IP skonfigurowanych dla obszaru roboczego.

GatewayAccessActionType

Definiuje zachowanie kontroli dostępu dla bram wychodzących. To wyliczenie jest używane dla pola defaultAction, aby określić, czy komunikacja wychodząca powinna być domyślnie dozwolona, czy blokowana. Ten typ umożliwia zarówno globalną, jak i specyficzną dla bramy kontrolę dostępu wychodzącego, ułatwiając wymuszanie bezpiecznych i przewidywalnych zasad komunikacji sieciowej. Dodatkowe typy akcji dostępu do bramy mogą być dodawane w czasie.

Wartość Opis
Allow

Zezwala na bramy wychodzące. W przypadku użycia jako akcji domyślnej wszystkie bramy są dozwolone.

Deny

Blokuje bramy wychodzące. W przypadku użycia jako akcji domyślnej wszystkie bramy są odrzucane, chyba że jawnie dozwolone.

GatewayAccessRuleMetadata

Reprezentuje bramę dozwoloną dla komunikacji wychodzącej. Ten obiekt jest używany w dozwolonych Bramach do jawnego autoryzowania dostępu wychodzącego.

Nazwisko Typ Opis
id

string (uuid)

Identyfikator bramy może być dozwolony.

ManagedPrivateEndpoint

Zarządzany prywatny punkt końcowy.

Nazwisko Typ Opis
connectionState

PrivateEndpointConnectionState

Stan połączenia punktu końcowego aprowizowania punktów końcowych.

id

string (uuid)

Identyfikator zarządzanego prywatnego punktu końcowego.

name

string

Nazwa prywatnego punktu końcowego.

provisioningState

PrivateEndpointProvisioningState

Stan aprowizacji punktu końcowego.

targetPrivateLinkResourceId

string

Identyfikator zasobu źródła danych, dla którego jest tworzony prywatny punkt końcowy

targetSubresourceType

string

Zasób podrzędny wskazujący na zasoby łącza prywatnego.

NetworkAccessRule

Domyślne zasady dostępu do obszaru roboczego z sieci publicznych. Jeśli pominięto treść żądania PUT, to pole jest domyślnie ustawione na Allow, co może przypadkowo otworzyć dostęp sieciowy. Zawsze jawnie określ to pole w każdej treści żądania PUT.

Wartość Opis
Allow

Zezwalaj na wszystkie połączenia.

Deny

Odmów wszystkich połączeń.

NetworkCommunicationPolicies

Lista ustawień zasad komunikacji sieciowej dla obszarów roboczych w dzierżawie.

Nazwisko Typ Opis
continuationToken

string

Token dla następnej partii zestawu wyników. Jeśli nie ma więcej rekordów, zostanie on usunięty z odpowiedzi.

continuationUri

string

Identyfikator URI następnego zestawu wyników wsadowy. Jeśli nie ma więcej rekordów, zostanie on usunięty z odpowiedzi.

value

NetworkCommunicationPolicyDetails[]

Lista ustawień zasad komunikacji sieciowej dla obszarów roboczych w dzierżawie.

NetworkCommunicationPolicyDetails

Reprezentuje szczegóły ustawień zasad komunikacji sieciowej dla każdego obszaru roboczego.

Nazwisko Typ Opis
inbound

NetworkCommunicationPolicyInboundDetails

Definiuje ustawienia ochrony dostępu przychodzącego.

outbound

NetworkCommunicationPolicyOutboundDetails

Definiuje ustawienia ochrony dostępu wychodzącego.

workspaceId

string (uuid)

Identyfikator przestrzeni roboczej.

workspaceName

string

Nazwa wyświetlana obszaru roboczego.

workspaceType

WorkspaceType

Typ obszaru roboczego.

NetworkCommunicationPolicyInboundDetails

Reprezentuje ustawienia zasad komunikacji sieciowej dla ruchu przychodzącego dla obszaru roboczego.

Nazwisko Typ Opis
firewall

FirewallRules

Reguły zapory ip skonfigurowane na potrzeby ochrony dostępu przychodzącego obszaru roboczego.

publicAccessRules

NetworkRules

Zasady dotyczące całej komunikacji przychodzącej do obszaru roboczego.

NetworkCommunicationPolicyOutboundDetails

Reprezentuje ustawienia zasad komunikacji sieciowej dla ruchu wychodzącego dla obszaru roboczego.

Nazwisko Typ Opis
connections

WorkspaceOutboundConnections

Reprezentuje kompletny zestaw reguł połączeń z chmurą ochrony dostępu wychodzącego skonfigurowanych dla obszaru roboczego w ramach zasad komunikacji sieciowej. Ten obiekt definiuje reguły połączeń, które określają, które zewnętrzne punkty końcowe i obszary robocze są dozwolone lub blokowane dla komunikacji wychodzącej.

gateways

WorkspaceOutboundGateways

Reprezentuje kompletny zestaw reguł ochrony dostępu wychodzącego bramy skonfigurowanych dla obszaru roboczego w ramach zasad komunikacji sieciowej. Ten obiekt definiuje reguły bramy, które zarządzają komunikacją wychodzącą.

git

NetworkRules

Reprezentuje zasady ruchu wychodzącego Usługi Git dla obszaru roboczego w ramach zasad komunikacji sieciowej.

managedPrivateEndpoints

ManagedPrivateEndpoint[]

Zarządzane prywatne punkty końcowe skonfigurowane na potrzeby ochrony dostępu wychodzącego obszaru roboczego.

publicAccessRules

NetworkRules

Zasady dotyczące całej komunikacji wychodzącej z obszaru roboczego.

NetworkRules

Zasady definiujące dostęp do/z obszaru roboczego do/z sieci publicznych.

Nazwisko Typ Opis
defaultAction

NetworkAccessRule

Domyślne zasady dostępu do obszaru roboczego z sieci publicznych. Jeśli pominięto treść żądania PUT, to pole jest domyślnie ustawione na Allow, co może przypadkowo otworzyć dostęp sieciowy. Zawsze jawnie określ to pole w każdej treści żądania PUT.

OutboundConnectionRule

Definiuje regułę dostępu wychodzącego dla określonego połączenia w chmurze.

Nazwisko Typ Opis
allowedEndpoints

ConnectionRuleEndpointMetadata[]

Definiuje listę jawnie dozwolonych zewnętrznych punktów końcowych dla parametru connectionType. Każdy wpis w tablicy reprezentuje wzorzec nazwy hosta dozwolony dla komunikacji wychodzącej z obszaru roboczego. To pole ma zastosowanie tylko do typów połączeń, które obsługują filtrowanie oparte na punkcie końcowym (np. SQL, MySQL, Web itp.). Jeśli ustawienie defaultAction ma wartość "Odmów" dla typu połączenia, dozwolone będą tylko punkty końcowe wymienione tutaj; wszystkie inne zostaną zablokowane.

allowedWorkspaces

ConnectionRuleWorkspaceMetadata[]

Określa listę identyfikatorów obszarów roboczych, które są jawnie dozwolone dla komunikacji wychodzącej dla danego parametru connectionType sieci szkieletowej. To pole ma zastosowanie tylko do typów połączeń sieci szkieletowych, które obsługują filtrowanie oparte na obszarze roboczym, ograniczone do usługi Lakehouse, Warehouse, FabricSql i PowerPlatformDataflows. Jeśli ustawienie defaultAction ma wartość "Odmów" dla typu połączenia, tylko obszary robocze wymienione w obszarze allowedWorkspaces będą dozwolone dla dostępu wychodzącego; wszystkie inne zostaną zablokowane.

connectionType

string

Określa typ połączenia w chmurze, do którego ma zastosowanie reguła. Zachowanie i zastosowanie innych właściwości reguły (takich jak allowedEndpoints lub allowedWorkspaces) może się różnić w zależności od możliwości typu połączenia.

defaultAction

ConnectionAccessActionType

Definiuje domyślne zachowanie dostępu wychodzącego dla parametru connectionType. To pole określa, czy połączenia tego typu są domyślnie dozwolone lub blokowane, chyba że bardziej uściślić dozwolone Punkty końcowe lub dozwoloneWorkspaces. Jeśli ustawiono wartość "Zezwalaj": wszystkie połączenia tego typu są dozwolone, chyba że jawnie odmówiono przez bardziej szczegółową regułę. To pole zapewnia szczegółową kontrolę nad każdym typem połączenia i uzupełnia globalne zachowanie rezerwowe zdefiniowane domyślnie.

PrivateEndpointConnectionState

Stan połączenia prywatnego punktu końcowego

Nazwisko Typ Opis
actionsRequired

string

Akcje wymagane do nawiązania połączenia.

description

string

Komunikat opisu (jeśli istnieje) podany podczas zatwierdzania lub odrzucania punktu końcowego.

status

ConnectionStatus

Stan połączenia

PrivateEndpointProvisioningState

Stan aprowizacji punktu końcowego.

Wartość Opis
Provisioning

Prywatny punkt końcowy aprowizacji jest w toku

Succeeded

Aprowizowanie prywatnego punktu końcowego powiodło się

Updating

Aktualizowanie prywatnego punktu końcowego

Deleting

Usuwanie prywatnego punktu końcowego

Failed

Aprowizowanie prywatnego punktu końcowego nie powiodło się

WorkspaceOutboundConnections

Reprezentuje kompletny zestaw reguł połączeń z chmurą ochrony dostępu wychodzącego skonfigurowanych dla obszaru roboczego w ramach zasad komunikacji sieciowej. Ten obiekt definiuje reguły połączeń, które określają, które zewnętrzne punkty końcowe i obszary robocze są dozwolone lub blokowane dla komunikacji wychodzącej

Nazwisko Typ Opis
defaultAction

ConnectionAccessActionType

Definiuje domyślne zachowanie dla wszystkich typów połączeń w chmurze, które nie są jawnie wymienione w tablicy reguł. W przypadku ustawienia opcji "Zezwalaj" wszystkie nieokreślone typy połączeń są domyślnie dozwolone. W przypadku ustawienia opcji "Odmów" wszystkie nieokreślone typy połączeń są domyślnie blokowane, chyba że jawnie dozwolone. To ustawienie działa jako globalne zasady rezerwowe i ma kluczowe znaczenie dla wymuszania bezpiecznego stanu domyślnego w środowiskach, w których powinny być dozwolone tylko znane i zaufane połączenia. Jeśli pominięto treść żądania PUT, to pole jest domyślnie ustawione na Allowwartość , co może przypadkowo zezwalać na wszystkie połączenia wychodzące. Zawsze jawnie określ to pole w każdej treści żądania PUT.

rules

OutboundConnectionRule[]

Lista reguł definiujących zachowanie dostępu wychodzącego dla określonych typów połączeń w chmurze. Każda reguła może obejmować ograniczenia oparte na punkcie końcowym lub obszarze roboczym w zależności od obsługiwanych typów połączeń.

WorkspaceOutboundGateways

Reprezentuje kompletny zestaw reguł ochrony dostępu wychodzącego bramy skonfigurowanych dla obszaru roboczego w ramach zasad komunikacji sieciowej. Ten obiekt definiuje reguły bramy, które zarządzają komunikacją wychodzącą

Nazwisko Typ Opis
allowedGateways

GatewayAccessRuleMetadata[]

Lista reguł definiujących zachowanie dostępu wychodzącego dla bram.

defaultAction

GatewayAccessActionType

Definiuje domyślne zachowanie wszystkich bram, które nie są jawnie wymienione w tablicy dozwolonych list. W przypadku ustawienia opcji "Zezwalaj" wszystkie nieokreślone bramy są domyślnie dozwolone. Jeśli ustawiono wartość "Odmów", wszystkie nieokreślone bramy zostaną zablokowane. Jeśli pominięto treść żądania PUT, to pole jest domyślnie ustawione na Allowwartość , co może przypadkowo zezwalać na wszystkie połączenia bramy wychodzącej. Zawsze jawnie określ to pole w każdej treści żądania PUT.

WorkspaceType

Typ obszaru roboczego. Dodatkowe typy obszarów roboczych można dodawać w czasie.

Wartość Opis
Personal

Mój folder lub Mój obszar roboczy służący do zarządzania elementami użytkownika.

Workspace

Obszar roboczy służący do zarządzania elementami sieci szkieletowej.

AdminWorkspace

Obszar roboczy monitorowania przez administratora. Zawiera raporty administratora, takie jak raport inspekcji i raport użycia i wdrażania.