Workspaces - Get Outbound Gateway Rules

送信アクセス保護 (OAP) で有効になっているワークスペースのゲートウェイ規則を返します。 この API は、ワークスペース管理者がオンプレミスおよび Vnet データ ゲートウェイに適用される効果的な送信ネットワーク通信ポリシーを表示できるように設計されています。 送信アクセス保護ゲートウェイ規則は、ワークスペースのネットワーク通信ポリシーに outbound.publicAccessRules.defaultAction が Deny に設定されている場合にのみ返され、適用されます。 ワークスペースで OAP が有効になっていない場合、送信接続が制限されていないため、API は失敗します。 現在、この機能はプレビュー段階にあります。

Permissions

呼び出し元には、ビューアー 以上のワークスペース ロールが必要です。

必要な委任されたスコープ

Workspace.Read.All または Workspace.ReadWrite.All

Microsoft Entra でサポートされている ID

この API では、このセクションに記載されている Microsoft ID がサポートされています。

インターフェイス

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

URI パラメーター

応答

例

Get workspace outbound access protection gateway rule for example

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

ETag: 0f8fad5b-d9cb-469f-a165-70867728950e

{
  "defaultAction": "Deny",
  "allowedGateways": [
    {
      "id": "91c5ae74-e82d-4dd3-bfeb-6b1814030123"
    }
  ]
}

定義

ErrorRelatedResource

エラー関連のリソース詳細オブジェクト。

ErrorResponse

エラー応答。

ErrorResponseDetails

エラー応答の詳細。

GatewayAccessActionType

送信ゲートウェイのアクセス制御動作を定義します。 この列挙型は、既定で送信通信を許可するか拒否するかを指定するために、defaultAction フィールドに使用されます。 この種類により、送信アクセスに対するグローバルな制御とゲートウェイ固有の制御の両方が可能になり、セキュリティで保護された予測可能なネットワーク通信ポリシーを適用できます。 ゲートウェイ アクセス アクションの種類は、時間の経過と同時に追加される場合があります。

GatewayAccessRuleMetadata

送信通信が許可されているゲートウェイを表します。 このオブジェクトは、発信アクセスを明示的に承認するために allowedGateways 内で使用されます。

WorkspaceOutboundGateways

ネットワーク通信ポリシーの一部としてワークスペース用に構成されたゲートウェイ送信アクセス保護規則の完全なセットを表します。 このオブジェクトは、送信通信を制御するゲートウェイルールを定義します。