Workspaces - List Networking Communication Policies

บริการ:: Admin

เวอร์ชัน API:: v1

แสดงการตั้งค่านโยบายการสื่อสารเครือข่ายสําหรับพื้นที่ทํางานทั้งหมดในผู้เช่า
ส่งกลับรายละเอียดนโยบายการสื่อสารเครือข่ายที่มีการแบ่งหน้าสําหรับพื้นที่ทํางานทั้งหมด การตอบกลับประกอบด้วยการตั้งค่าการป้องกันการเข้าถึงขาเข้า (กฎการเข้าถึงสาธารณะและกฎไฟร์วอลล์ IP) การตั้งค่าการป้องกันการเข้าถึงขาออก (กฎการเข้าถึงสาธารณะ กฎการเชื่อมต่อ กฎเกตเวย์ นโยบาย Git และจุดสิ้นสุดส่วนตัวที่มีการจัดการ) และเมตาดาต้าของพื้นที่ทํางาน

API นี้สนับสนุน การแบ่งหน้า ด้วยโทเค็นต่อเนื่องที่ให้ไว้ในการตอบกลับ คุณสามารถรับชุดระเบียนถัดไปได้

การอนุญาต

ผู้เรียกต้องเป็นผู้ดูแลระบบ Fabric หรือรับรองความถูกต้องโดยใช้โครงร่างสําคัญของบริการ

จําเป็นต้องมีขอบเขตที่ได้รับมอบสิทธิ์

Tenant.Read.All หรือ Tenant.ReadWrite.All

ข้อมูลประจําตัวที่สนับสนุนของ Microsoft Entra

API นี้สนับสนุนข้อมูลประจําตัวของ Microsoft แสดงรายการในส่วนนี้

Identity	การสนับสนุน
ผู้ใช้	ตกลง
บริการหลักและข้อมูลประจําตัว ที่มีการจัดการ	ตกลง

อินเตอร์เฟซ

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}

พารามิเตอร์ URI

ชื่อ	ใน	จำเป็น	พิมพ์	คำอธิบาย
continuationToken	query		string	โทเค็นสําหรับการเรียกใช้หน้าถัดไปของผลลัพธ์
filter	query		string	กรองพื้นที่ทํางานตามทิศทางนโยบาย นิพจน์ตัวกรองที่สนับสนุน: `inbound/publicAccessRules/defaultAction eq 'deny'`, `outbound/publicAccessRules/defaultAction eq 'deny'`หรือทั้งสองอย่างรวมกับ`or`

การตอบสนอง

ชื่อ พิมพ์ คำอธิบาย

200 OK

ชื่อ	พิมพ์	คำอธิบาย
200 OK	NetworkCommunicationPolicies	การดําเนินการสําเร็จ
429 Too Many Requests	ErrorResponse	เกินขีดจํากัดอัตราการบริการ เซิร์ฟเวอร์จะส่งกลับ `Retry-After` ส่วนหัวที่ระบุ ภายในไม่กี่วินาที ระยะเวลาที่ไคลเอ็นต์ต้องรอก่อนที่จะส่งคําขอเพิ่มเติม ส่วนหัว Retry-After: integer
Other Status Codes	ErrorResponse	รหัสข้อผิดพลาดทั่วไป: ไม่เพียงพอ Privileges - ผู้เรียกไม่มีสิทธิ์ในการเรียกใช้ API InvalidFilterExpression - นิพจน์ตัวกรองไม่ถูกต้องหรือมีคุณสมบัติที่ไม่สนับสนุน

NetworkCommunicationPolicies

การดําเนินการสําเร็จ

429 Too Many Requests

ErrorResponse

เกินขีดจํากัดอัตราการบริการ เซิร์ฟเวอร์จะส่งกลับ Retry-After ส่วนหัวที่ระบุ ภายในไม่กี่วินาที ระยะเวลาที่ไคลเอ็นต์ต้องรอก่อนที่จะส่งคําขอเพิ่มเติม

ส่วนหัว

Retry-After: integer

Other Status Codes

ErrorResponse

รหัสข้อผิดพลาดทั่วไป:

ไม่เพียงพอ Privileges - ผู้เรียกไม่มีสิทธิ์ในการเรียกใช้ API
InvalidFilterExpression - นิพจน์ตัวกรองไม่ถูกต้องหรือมีคุณสมบัติที่ไม่สนับสนุน

ตัวอย่าง

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

คำขอตัวอย่าง

HTTP

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

คำตอบตัวอย่าง

รหัสสถานะ:: 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

คำขอตัวอย่าง

HTTP

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

คำตอบตัวอย่าง

รหัสสถานะ:: 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"
}

คำจำกัดความ

ชื่อ	คำอธิบาย
ConnectionAccessActionType	กําหนดลักษณะการทํางานของการควบคุมการเข้าถึงสําหรับการเชื่อมต่อขาออก Enum นี้ใช้สําหรับฟิลด์ defaultAction เพื่อระบุว่าควรอนุญาตหรือปฏิเสธการสื่อสารขาออกตามค่าเริ่มต้น ประเภทนี้เปิดใช้งานทั้งส่วนกลางและการควบคุมเฉพาะการเชื่อมต่อผ่านการเข้าถึงขาออกช่วยในการบังคับใช้นโยบายการสื่อสารเครือข่ายที่ปลอดภัยและคาดการณ์ได้ ประเภทการดําเนินการเข้าถึงการเชื่อมต่อเพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป
ConnectionRuleEndpointMetadata	แสดงกฎข้อยกเว้นระดับปลายทางเดียวที่อนุญาตให้สื่อสารขาออกไปยังโดเมนหรือโฮสต์ภายนอกที่เฉพาะเจาะจง วัตถุนี้ถูกใช้ภายในอาร์เรย์ AllowedEndpoints ของกฎการเชื่อมต่อเพื่ออนุญาตการเข้าถึงปลายทางขาออกที่เชื่อถือได้สําหรับ connectionType ที่กําหนดอย่างชัดเจน ซึ่งสามารถใช้ได้เฉพาะกับชนิดการเชื่อมต่อที่สนับสนุนการกรองตามจุดสิ้นสุดเท่านั้น (เช่น SQL, MySQL, เว็บ และอื่น ๆ)
ConnectionRuleWorkspaceMetadata	แสดงกฎข้อยกเว้นระดับพื้นที่ทํางานที่อนุญาตให้สื่อสารขาออกไปยังพื้นที่ทํางานเฉพาะสําหรับ connectionType ที่กําหนด วัตถุนี้ถูกใช้ภายในอาร์เรย์ AllowedWorkspaces ของกฎการเชื่อมต่อเพื่อให้อนุญาตการเข้าถึงข้ามพื้นที่ทํางานอย่างชัดเจน สามารถใช้ได้เฉพาะกับชนิดการเชื่อมต่อที่สนับสนุนการกรองตามพื้นที่ทํางาน เช่น Lakehouse, Warehouse, FabricSql และ PowerPlatformDataflows เท่านั้น
ConnectionStatus	สถานะการเชื่อมต่อปลายทางส่วนตัว สถานะการเชื่อมต่อเพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป
ErrorParameter	พารามิเตอร์ที่มีโครงสร้างให้บริบทที่สามารถอ่านได้ด้วยเครื่องเพิ่มเติมเกี่ยวกับข้อผิดพลาด
ErrorRelatedResource	ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
ErrorResponse	การตอบสนองข้อผิดพลาด
ErrorResponseDetails	รายละเอียดการตอบสนองข้อผิดพลาด
FirewallRule	แสดงกฎไฟร์วอลล์ IP เดียว
FirewallRules	แสดงกฎไฟร์วอลล์ IP ที่กําหนดค่าสําหรับการป้องกันการเข้าถึงขาเข้าของพื้นที่ทํางาน
GatewayAccessActionType	กําหนดลักษณะการทํางานของการควบคุมการเข้าถึงสําหรับเกตเวย์ขาออก Enum นี้ใช้สําหรับฟิลด์ defaultAction เพื่อระบุว่าควรอนุญาตหรือปฏิเสธการสื่อสารขาออกตามค่าเริ่มต้น ประเภทนี้เปิดใช้งานทั้งส่วนกลางและการควบคุมเฉพาะเกตเวย์ผ่านการเข้าถึงขาออกช่วยในการบังคับใช้นโยบายการสื่อสารเครือข่ายที่ปลอดภัยและคาดการณ์ได้ ประเภทการดําเนินการเข้าถึงเกตเวย์เพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป
GatewayAccessRuleMetadata	แสดงเกตเวย์ที่ได้รับอนุญาตสําหรับการสื่อสารขาออก วัตถุนี้ถูกใช้ภายใน allowedGateways เพื่ออนุญาตการเข้าถึงขาออกอย่างชัดเจน
ManagedPrivateEndpoint	จุดปลายทางส่วนตัวที่มีการจัดการ
NetworkAccessRule	นโยบายเริ่มต้นสําหรับการเข้าถึงพื้นที่ทํางานจากเครือข่ายสาธารณะ ถ้าเว้นไว้จากเนื้อความของคําขอ PUT เขตข้อมูลนี้จะเป็นค่าเริ่มต้น `Allow`ซึ่งอาจเปิดการเข้าถึงเครือข่ายโดยไม่ได้ตั้งใจ ระบุเขตข้อมูลนี้อย่างชัดเจนทุกครั้งในทุกเนื้อความของคําขอ PUT
NetworkCommunicationPolicies	รายการการตั้งค่านโยบายการสื่อสารเครือข่ายสําหรับพื้นที่ทํางานในผู้เช่า
NetworkCommunicationPolicyDetails	แสดงรายละเอียดของการตั้งค่านโยบายการสื่อสารเครือข่ายสําหรับแต่ละพื้นที่ทํางาน
NetworkCommunicationPolicyInboundDetails	แสดงการตั้งค่านโยบายการสื่อสารเครือข่ายขาเข้าสําหรับพื้นที่ทํางาน
NetworkCommunicationPolicyOutboundDetails	แสดงการตั้งค่านโยบายการสื่อสารเครือข่ายขาออกสําหรับพื้นที่ทํางาน
NetworkRules	นโยบายที่กําหนดการเข้าถึง/จากพื้นที่ทํางานไปยัง/จากเครือข่ายสาธารณะ
OutboundConnectionRule	กําหนดกฎการเข้าถึงขาออกสําหรับการเชื่อมต่อระบบคลาวด์เฉพาะ
PrivateEndpointConnectionState	สถานะการเชื่อมต่อปลายทางส่วนตัว
PrivateEndpointProvisioningState	สถานะการเตรียมใช้งานของปลายทาง
WorkspaceOutboundConnections	แสดงชุดของกฎการเชื่อมต่อระบบคลาวด์ของการป้องกันการเข้าถึงขาออกที่กําหนดค่าสําหรับพื้นที่ทํางานเป็นส่วนหนึ่งของนโยบายการสื่อสารเครือข่าย ออบเจ็กต์นี้จะกําหนดกฎการเชื่อมต่อที่ควบคุมว่าปลายทางและพื้นที่ทํางานภายนอกใดที่ได้รับอนุญาตหรือปฏิเสธสําหรับการสื่อสารขาออก
WorkspaceOutboundGateways	แสดงชุดของกฎการป้องกันการเข้าถึงขาออกของเกตเวย์ที่กําหนดค่าสําหรับพื้นที่ทํางานเป็นส่วนหนึ่งของนโยบายการสื่อสารเครือข่าย วัตถุนี้กําหนดกฎเกตเวย์ที่ควบคุมการสื่อสารขาออก
WorkspaceType	ชนิดของพื้นที่ทํางาน คุณสามารถเพิ่มชนิดพื้นที่ทํางานเพิ่มเติมเมื่อเวลาผ่านไป

ConnectionAccessActionType

การแจงนับ

กําหนดลักษณะการทํางานของการควบคุมการเข้าถึงสําหรับการเชื่อมต่อขาออก Enum นี้ใช้สําหรับฟิลด์ defaultAction เพื่อระบุว่าควรอนุญาตหรือปฏิเสธการสื่อสารขาออกตามค่าเริ่มต้น ประเภทนี้เปิดใช้งานทั้งส่วนกลางและการควบคุมเฉพาะการเชื่อมต่อผ่านการเข้าถึงขาออกช่วยในการบังคับใช้นโยบายการสื่อสารเครือข่ายที่ปลอดภัยและคาดการณ์ได้ ประเภทการดําเนินการเข้าถึงการเชื่อมต่อเพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
Allow	อนุญาตการเชื่อมต่อขาออก เมื่อใช้เป็นการดําเนินการเริ่มต้น การเชื่อมต่อระบบคลาวด์ทั้งหมดจะได้รับอนุญาต
Deny	บล็อกการเชื่อมต่อขาออก เมื่อใช้เป็นการดําเนินการเริ่มต้น การเชื่อมต่อระบบคลาวด์ทั้งหมดจะถูกปฏิเสธเว้นแต่ได้รับอนุญาตอย่างชัดเจน

ConnectionRuleEndpointMetadata

วัตถุ

แสดงกฎข้อยกเว้นระดับปลายทางเดียวที่อนุญาตให้สื่อสารขาออกไปยังโดเมนหรือโฮสต์ภายนอกที่เฉพาะเจาะจง วัตถุนี้ถูกใช้ภายในอาร์เรย์ AllowedEndpoints ของกฎการเชื่อมต่อเพื่ออนุญาตการเข้าถึงปลายทางขาออกที่เชื่อถือได้สําหรับ connectionType ที่กําหนดอย่างชัดเจน ซึ่งสามารถใช้ได้เฉพาะกับชนิดการเชื่อมต่อที่สนับสนุนการกรองตามจุดสิ้นสุดเท่านั้น (เช่น SQL, MySQL, เว็บ และอื่น ๆ)

ชื่อ	พิมพ์	คำอธิบาย
hostnamePattern	string	รูปแบบที่รองรับสัญลักษณ์ตัวแทนที่กําหนดจุดสิ้นสุดภายนอกที่ได้รับอนุญาต ตัวอย่างเช่น *.microsoft.com, api.contoso.com หรือ data.partner.org

ConnectionRuleWorkspaceMetadata

วัตถุ

แสดงกฎข้อยกเว้นระดับพื้นที่ทํางานที่อนุญาตให้สื่อสารขาออกไปยังพื้นที่ทํางานเฉพาะสําหรับ connectionType ที่กําหนด วัตถุนี้ถูกใช้ภายในอาร์เรย์ AllowedWorkspaces ของกฎการเชื่อมต่อเพื่อให้อนุญาตการเข้าถึงข้ามพื้นที่ทํางานอย่างชัดเจน สามารถใช้ได้เฉพาะกับชนิดการเชื่อมต่อที่สนับสนุนการกรองตามพื้นที่ทํางาน เช่น Lakehouse, Warehouse, FabricSql และ PowerPlatformDataflows เท่านั้น

ชื่อ	พิมพ์	คำอธิบาย
workspaceId	string (uuid)	ตัวระบุที่ไม่ซ้ํากัน (GUID) ของพื้นที่ทํางานเป้าหมายที่ได้รับอนุญาตให้เชื่อมต่อจากพื้นที่ทํางานปัจจุบัน

ConnectionStatus

การแจงนับ

สถานะการเชื่อมต่อปลายทางส่วนตัว สถานะการเชื่อมต่อเพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
Pending	ค้างอยู่รอการอนุมัติ
Approved	อนุมัติปลายทางแล้ว
Rejected	จุดสิ้นสุดที่ถูกปฏิเสธ
Disconnected	จุดสิ้นสุดถูกยกเลิกการเชื่อมต่อ

ErrorParameter

วัตถุ

พารามิเตอร์ที่มีโครงสร้างให้บริบทที่สามารถอ่านได้ด้วยเครื่องเพิ่มเติมเกี่ยวกับข้อผิดพลาด

ชื่อ	พิมพ์	คำอธิบาย
message	string	คําอธิบายที่มนุษย์สามารถอ่านได้ของความหมายของพารามิเตอร์
name	string	ตัวระบุพารามิเตอร์
value	string	ค่าพารามิเตอร์

ErrorRelatedResource

วัตถุ

ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

ชื่อ	พิมพ์	คำอธิบาย
resourceId	string	ID ทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
resourceType	string	ชนิดของทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponse

วัตถุ

การตอบสนองข้อผิดพลาด

ชื่อ	พิมพ์	คำอธิบาย
errorCode	string	ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้
isRetriable	boolean	เมื่อเป็นจริง สามารถลองคําขอใหม่ได้ ใช้ส่วนหัวการตอบสนอง `Retry-After` เพื่อกําหนดความล่าช้า ถ้ามี
message	string	การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้
moreDetails	ErrorResponseDetails[]	รายการรายละเอียดข้อผิดพลาดเพิ่มเติม
parameters	ErrorParameter[]	พารามิเตอร์ที่มีโครงสร้างให้บริบทที่สามารถอ่านได้ด้วยเครื่องเพิ่มเติมเกี่ยวกับข้อผิดพลาด
relatedResource	ErrorRelatedResource	รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
requestId	string (uuid)	รหัสของคําขอที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponseDetails

วัตถุ

รายละเอียดการตอบสนองข้อผิดพลาด

ชื่อ	พิมพ์	คำอธิบาย
errorCode	string	ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้
message	string	การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้
parameters	ErrorParameter[]	พารามิเตอร์ที่มีโครงสร้างให้บริบทที่สามารถอ่านได้ด้วยเครื่องเพิ่มเติมเกี่ยวกับข้อผิดพลาด
relatedResource	ErrorRelatedResource	รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

FirewallRule

วัตถุ

แสดงกฎไฟร์วอลล์ IP เดียว

ชื่อ	พิมพ์	คำอธิบาย
displayName	string	ชื่อที่แสดงของกฎไฟร์วอลล์
value	string	ช่วง IP ในรูปแบบเริ่มต้น(ตัวอย่างเช่น `0.0.0.0-255.255.255.255`) หรือเครื่องหมาย CIDR

FirewallRules

วัตถุ

แสดงกฎไฟร์วอลล์ IP ที่กําหนดค่าสําหรับการป้องกันการเข้าถึงขาเข้าของพื้นที่ทํางาน

ชื่อ	พิมพ์	คำอธิบาย
rules	FirewallRule[]	รายการของกฎไฟร์วอลล์ IP ที่กําหนดค่าสําหรับพื้นที่ทํางาน

GatewayAccessActionType

การแจงนับ

กําหนดลักษณะการทํางานของการควบคุมการเข้าถึงสําหรับเกตเวย์ขาออก Enum นี้ใช้สําหรับฟิลด์ defaultAction เพื่อระบุว่าควรอนุญาตหรือปฏิเสธการสื่อสารขาออกตามค่าเริ่มต้น ประเภทนี้เปิดใช้งานทั้งส่วนกลางและการควบคุมเฉพาะเกตเวย์ผ่านการเข้าถึงขาออกช่วยในการบังคับใช้นโยบายการสื่อสารเครือข่ายที่ปลอดภัยและคาดการณ์ได้ ประเภทการดําเนินการเข้าถึงเกตเวย์เพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
Allow	อนุญาตเกตเวย์ขาออก เมื่อใช้เป็นการดําเนินการเริ่มต้น เกตเวย์ทั้งหมดจะได้รับอนุญาตให้ใช้งานได้
Deny	บล็อกเกตเวย์ขาออก เมื่อใช้เป็นการดําเนินการเริ่มต้น เกตเวย์ทั้งหมดจะถูกปฏิเสธเว้นแต่ได้รับอนุญาตอย่างชัดเจน

GatewayAccessRuleMetadata

วัตถุ

แสดงเกตเวย์ที่ได้รับอนุญาตสําหรับการสื่อสารขาออก วัตถุนี้ถูกใช้ภายใน allowedGateways เพื่ออนุญาตการเข้าถึงขาออกอย่างชัดเจน

ชื่อ	พิมพ์	คำอธิบาย
id	string (uuid)	Id เกตเวย์ที่ได้รับอนุญาต

ManagedPrivateEndpoint

วัตถุ

จุดปลายทางส่วนตัวที่มีการจัดการ

ชื่อ	พิมพ์	คำอธิบาย
connectionState	PrivateEndpointConnectionState	สถานะการเชื่อมต่อปลายทางของจุดสิ้นสุดที่เตรียมใช้งาน
id	string (uuid)	จัดการรหัสจุดปลายทางส่วนตัวแล้ว
name	string	ชื่อจุดปลายทางส่วนตัว
provisioningState	PrivateEndpointProvisioningState	สถานะการเตรียมใช้งานของปลายทาง
targetPrivateLinkResourceId	string	รหัสทรัพยากรของแหล่งข้อมูลที่สร้างจุดปลายทางส่วนตัวขึ้น
targetSubresourceType	string	ทรัพยากรย่อยชี้ไปยังที่เก็บลิงก์ส่วนตัว

NetworkAccessRule

การแจงนับ

นโยบายเริ่มต้นสําหรับการเข้าถึงพื้นที่ทํางานจากเครือข่ายสาธารณะ ถ้าเว้นไว้จากเนื้อความของคําขอ PUT เขตข้อมูลนี้จะเป็นค่าเริ่มต้น Allowซึ่งอาจเปิดการเข้าถึงเครือข่ายโดยไม่ได้ตั้งใจ ระบุเขตข้อมูลนี้อย่างชัดเจนทุกครั้งในทุกเนื้อความของคําขอ PUT

ค่า	คำอธิบาย
Allow	อนุญาตการเชื่อมต่อทั้งหมด
Deny	ปฏิเสธการเชื่อมต่อทั้งหมด

NetworkCommunicationPolicies

วัตถุ

รายการการตั้งค่านโยบายการสื่อสารเครือข่ายสําหรับพื้นที่ทํางานในผู้เช่า

ชื่อ	พิมพ์	คำอธิบาย
continuationToken	string	โทเค็นสําหรับชุดผลลัพธ์ชุดถัดไป ถ้าไม่มีระเบียนเพิ่มเติม จะถูกลบออกจากการตอบสนอง
continuationUri	string	URI ของชุดงานชุดผลลัพธ์ถัดไป ถ้าไม่มีระเบียนเพิ่มเติม จะถูกลบออกจากการตอบสนอง
value	NetworkCommunicationPolicyDetails[]	รายการการตั้งค่านโยบายการสื่อสารเครือข่ายสําหรับพื้นที่ทํางานในผู้เช่า

NetworkCommunicationPolicyDetails

วัตถุ

แสดงรายละเอียดของการตั้งค่านโยบายการสื่อสารเครือข่ายสําหรับแต่ละพื้นที่ทํางาน

ชื่อ	พิมพ์	คำอธิบาย
inbound	NetworkCommunicationPolicyInboundDetails	กําหนดการตั้งค่าการป้องกันการเข้าถึงขาเข้า
outbound	NetworkCommunicationPolicyOutboundDetails	กําหนดการตั้งค่าการป้องกันการเข้าถึงขาออก
workspaceId	string (uuid)	ID พื้นที่ทํางาน
workspaceName	string	ชื่อที่แสดงของพื้นที่ทํางาน
workspaceType	WorkspaceType	ประเภทพื้นที่ทํางาน

NetworkCommunicationPolicyInboundDetails

วัตถุ

แสดงการตั้งค่านโยบายการสื่อสารเครือข่ายขาเข้าสําหรับพื้นที่ทํางาน

ชื่อ	พิมพ์	คำอธิบาย
firewall	FirewallRules	กฎไฟร์วอลล์ IP ที่กําหนดค่าสําหรับการป้องกันการเข้าถึงขาเข้าของพื้นที่ทํางาน
publicAccessRules	NetworkRules	นโยบายสําหรับการสื่อสารขาเข้าทั้งหมดไปยังพื้นที่ทํางาน

NetworkCommunicationPolicyOutboundDetails

วัตถุ

แสดงการตั้งค่านโยบายการสื่อสารเครือข่ายขาออกสําหรับพื้นที่ทํางาน

ชื่อ	พิมพ์	คำอธิบาย
connections	WorkspaceOutboundConnections	แสดงชุดของกฎการเชื่อมต่อระบบคลาวด์ของการป้องกันการเข้าถึงขาออกที่กําหนดค่าสําหรับพื้นที่ทํางานเป็นส่วนหนึ่งของนโยบายการสื่อสารเครือข่าย ออบเจ็กต์นี้จะกําหนดกฎการเชื่อมต่อที่ควบคุมว่าจุดสิ้นสุดและพื้นที่ทํางานภายนอกใดที่ได้รับอนุญาตหรือปฏิเสธสําหรับการสื่อสารขาออก
gateways	WorkspaceOutboundGateways	แสดงชุดของกฎการป้องกันการเข้าถึงขาออกของเกตเวย์ที่กําหนดค่าสําหรับพื้นที่ทํางานเป็นส่วนหนึ่งของนโยบายการสื่อสารเครือข่าย วัตถุนี้กําหนดกฎเกตเวย์ที่ควบคุมการสื่อสารขาออก
git	NetworkRules	แสดงนโยบายขาออกของ Git สําหรับพื้นที่ทํางานเป็นส่วนหนึ่งของนโยบายการสื่อสารระบบเครือข่าย
managedPrivateEndpoints	ManagedPrivateEndpoint[]	จุดปลายทางส่วนตัวที่มีการจัดการที่กําหนดค่าสําหรับการป้องกันการเข้าถึงขาออกของพื้นที่ทํางาน
publicAccessRules	NetworkRules	นโยบายสําหรับการสื่อสารขาออกทั้งหมดจากพื้นที่ทํางาน

NetworkRules

วัตถุ

นโยบายที่กําหนดการเข้าถึง/จากพื้นที่ทํางานไปยัง/จากเครือข่ายสาธารณะ

ชื่อ	พิมพ์	คำอธิบาย
defaultAction	NetworkAccessRule	นโยบายเริ่มต้นสําหรับการเข้าถึงพื้นที่ทํางานจากเครือข่ายสาธารณะ ถ้าเว้นไว้จากเนื้อความของคําขอ PUT เขตข้อมูลนี้จะเป็นค่าเริ่มต้น `Allow`ซึ่งอาจเปิดการเข้าถึงเครือข่ายโดยไม่ได้ตั้งใจ ระบุเขตข้อมูลนี้อย่างชัดเจนทุกครั้งในทุกเนื้อความของคําขอ PUT

OutboundConnectionRule

วัตถุ

กําหนดกฎการเข้าถึงขาออกสําหรับการเชื่อมต่อระบบคลาวด์เฉพาะ

ชื่อ	พิมพ์	คำอธิบาย
allowedEndpoints	ConnectionRuleEndpointMetadata[]	กําหนดรายการของจุดสิ้นสุดภายนอกที่อนุญาตอย่างชัดเจนสําหรับ connectionType รายการแต่ละรายการในอาร์เรย์ แสดงถึงรูปแบบชื่อโฮสต์ที่ได้รับอนุญาตสําหรับการสื่อสารขาออกจากพื้นที่ทํางาน ฟิลด์นี้จะใช้ได้เฉพาะกับชนิดการเชื่อมต่อที่สนับสนุนการกรองตามปลายทาง (เช่น SQL, MySQL, เว็บ และอื่น ๆ) เท่านั้น ถ้ามีการตั้งค่า defaultAction เป็น "ปฏิเสธ" สําหรับชนิดการเชื่อมต่อ เฉพาะจุดสิ้นสุดที่แสดงไว้ที่นี่เท่านั้นที่ได้รับอนุญาต รายการอื่นๆ ทั้งหมดจะถูกบล็อก
allowedWorkspaces	ConnectionRuleWorkspaceMetadata[]	ระบุรายการของรหัสพื้นที่ทํางานที่ได้รับอนุญาตอย่างชัดเจนสําหรับการสื่อสารขาออกสําหรับชนิดการเชื่อมต่อผ้าที่ระบุ เขตข้อมูลนี้สามารถใช้ได้เฉพาะกับชนิดการเชื่อมต่อผ้าที่สนับสนุนการกรองตามพื้นที่ทํางาน จํากัดอยู่ที่ Lakehouse, Warehouse, FabricSql และ PowerPlatformDataflows เมื่อ defaultAction ถูกตั้งค่าเป็น "ปฏิเสธ" สําหรับชนิดการเชื่อมต่อ เฉพาะพื้นที่ทํางานที่แสดงใน allowedWorkspaces เท่านั้นที่จะได้รับอนุญาตให้เข้าถึงขาออกได้ รายการอื่นๆ ทั้งหมดจะถูกบล็อก
connectionType	string	ระบุชนิดการเชื่อมต่อคลาวด์ที่ใช้กฎ ลักษณะการทํางานและการใช้งานของคุณสมบัติกฎอื่น ๆ (เช่น allowedEndpoints หรือ allowedWorkspaces) อาจแตกต่างกันขึ้นอยู่กับความสามารถของชนิดการเชื่อมต่อ
defaultAction	ConnectionAccessActionType	กําหนดลักษณะการทํางานการเข้าถึงขาออกเริ่มต้นสําหรับ connectionType ฟิลด์นี้กําหนดว่าการเชื่อมต่อของชนิดนี้ได้รับอนุญาตหรือบล็อกตามค่าเริ่มต้น เว้นแต่ว่ามีการปรับแต่งเพิ่มเติมโดย AllowedEndpoints หรือ AllowedWorkspaces ถ้าตั้งค่าเป็น "อนุญาต": การเชื่อมต่อทั้งหมดของชนิดนี้จะได้รับอนุญาตให้ดําเนินการเว้นแต่จะถูกปฏิเสธอย่างชัดเจนโดยกฎที่เฉพาะเจาะจงมากขึ้น เขตข้อมูลนี้มีตัวควบคุมแบบละเอียดเหนือชนิดการเชื่อมต่อแต่ละชนิด และเสริมลักษณะการทํางานที่ใช้แสดงแทนส่วนกลางที่กําหนดโดย defaultAction

PrivateEndpointConnectionState

วัตถุ

สถานะการเชื่อมต่อปลายทางส่วนตัว

ชื่อ	พิมพ์	คำอธิบาย
actionsRequired	string	การดําเนินการที่จําเป็นเพื่อสร้างการเชื่อมต่อ
description	string	ข้อความคําอธิบาย (ถ้ามี) ที่มีให้ในการอนุมัติหรือปฏิเสธจุดสิ้นสุด
status	ConnectionStatus	สถานะการเชื่อมต่อ

PrivateEndpointProvisioningState

การแจงนับ

สถานะการเตรียมใช้งานของปลายทาง

ค่า	คำอธิบาย
Provisioning	จุดสิ้นสุดส่วนตัวในการเตรียมใช้งานอยู่ในระหว่างดําเนินการ
Succeeded	การเตรียมใช้งานจุดสิ้นสุดส่วนตัวสําเร็จ
Updating	การอัปเดตจุดสิ้นสุดส่วนตัว
Deleting	การลบปลายทางส่วนตัว
Failed	การเตรียมใช้งานจุดสิ้นสุดส่วนตัวล้มเหลว

WorkspaceOutboundConnections

วัตถุ

แสดงชุดของกฎการเชื่อมต่อระบบคลาวด์ของการป้องกันการเข้าถึงขาออกที่กําหนดค่าสําหรับพื้นที่ทํางานเป็นส่วนหนึ่งของนโยบายการสื่อสารเครือข่าย ออบเจ็กต์นี้จะกําหนดกฎการเชื่อมต่อที่ควบคุมว่าปลายทางและพื้นที่ทํางานภายนอกใดที่ได้รับอนุญาตหรือปฏิเสธสําหรับการสื่อสารขาออก

ชื่อ	พิมพ์	คำอธิบาย
defaultAction	ConnectionAccessActionType	กําหนดลักษณะการทํางานเริ่มต้นสําหรับชนิดการเชื่อมต่อระบบคลาวด์ทั้งหมดที่ไม่ได้ระบุไว้อย่างชัดเจนในอาร์เรย์ของกฎ ถ้าตั้งค่าเป็น "อนุญาต" ชนิดการเชื่อมต่อที่ไม่ได้ระบุทั้งหมดจะได้รับอนุญาตให้ตามค่าเริ่มต้น ถ้าตั้งค่าเป็น "Deny" ชนิดการเชื่อมต่อที่ไม่ได้ระบุทั้งหมดจะถูกบล็อกตามค่าเริ่มต้น เว้นแต่ว่าได้รับอนุญาตอย่างชัดเจน การตั้งค่านี้ทําหน้าที่เป็นนโยบายที่ใช้แสดงแทนสากล และมีความสําคัญสําหรับการบังคับใช้ท่าทางเริ่มต้นที่ปลอดภัยในสภาพแวดล้อมที่ควรอนุญาตเฉพาะการเชื่อมต่อที่รู้จักและเชื่อถือได้เท่านั้น ถ้าเว้นไว้จากเนื้อความของคําขอ PUT เขตข้อมูลนี้จะเป็นค่าเริ่มต้น `Allow`ซึ่งอาจอนุญาตให้มีการเชื่อมต่อขาออกทั้งหมดโดยไม่ได้ตั้งใจ ระบุเขตข้อมูลนี้อย่างชัดเจนทุกครั้งในทุกเนื้อความของคําขอ PUT
rules	OutboundConnectionRule[]	รายการของกฎที่กําหนดลักษณะการทํางานการเข้าถึงขาออกสําหรับชนิดการเชื่อมต่อระบบคลาวด์ที่เฉพาะเจาะจง กฎแต่ละกฎอาจมีข้อจํากัดตามตําแหน่งข้อมูลหรือตามพื้นที่ทํางาน ทั้งนี้ขึ้นอยู่กับชนิดการเชื่อมต่อที่ได้รับการสนับสนุน

WorkspaceOutboundGateways

วัตถุ

แสดงชุดของกฎการป้องกันการเข้าถึงขาออกของเกตเวย์ที่กําหนดค่าสําหรับพื้นที่ทํางานเป็นส่วนหนึ่งของนโยบายการสื่อสารเครือข่าย วัตถุนี้กําหนดกฎเกตเวย์ที่ควบคุมการสื่อสารขาออก

ชื่อ	พิมพ์	คำอธิบาย
allowedGateways	GatewayAccessRuleMetadata[]	รายการของกฎที่กําหนดลักษณะการทํางานการเข้าถึงขาออกสําหรับเกตเวย์
defaultAction	GatewayAccessActionType	กําหนดลักษณะการทํางานเริ่มต้นสําหรับเกตเวย์ทั้งหมดที่ไม่ได้ระบุไว้อย่างชัดเจนในอาร์เรย์รายการที่อนุญาต ถ้าตั้งค่าเป็น "อนุญาต" เกตเวย์ที่ไม่ได้ระบุทั้งหมดจะได้รับอนุญาตให้ตามค่าเริ่มต้น ถ้าตั้งค่าเป็น "Deny" เกตเวย์ที่ไม่ได้ระบุทั้งหมดจะถูกบล็อก ถ้าเว้นไว้จากเนื้อความของคําขอ PUT เขตข้อมูลนี้จะเป็นค่าเริ่มต้น `Allow`ซึ่งอาจอนุญาตให้มีการเชื่อมต่อเกตเวย์ขาออกทั้งหมดโดยไม่ได้ตั้งใจ ระบุเขตข้อมูลนี้อย่างชัดเจนทุกครั้งในทุกเนื้อความของคําขอ PUT

WorkspaceType

การแจงนับ

ชนิดของพื้นที่ทํางาน คุณสามารถเพิ่มชนิดพื้นที่ทํางานเพิ่มเติมเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
Personal	โฟลเดอร์ของฉันหรือพื้นที่ทํางานของฉันที่ใช้ในการจัดการรายการของผู้ใช้
Workspace	พื้นที่ทํางานที่ใช้ในการจัดการรายการ Fabric
AdminWorkspace	ผู้ดูแลระบบตรวจสอบพื้นที่ทํางาน ประกอบด้วยรายงานของผู้ดูแลระบบ เช่น รายงานการตรวจสอบและรายงานการใช้งานและการปรับใช้