แชร์ผ่าน


Workspaces - Set Network Communication Policy

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

Note

API นี้เป็นส่วนหนึ่งของการเผยแพร่ตัวอย่าง และมีไว้เพื่อวัตถุประสงค์ในการประเมินและการพัฒนาเท่านั้น ซึ่งอาจเปลี่ยนแปลงตามคําติชมและไม่แนะนําสําหรับการใช้งานด้านการผลิต

สิทธิ์

ผู้เรียกต้องมีบทบาทพื้นที่ทํางานของผู้ดูแลระบบ

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

Workspace.ReadWrite.All

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

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

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

อิน เทอร์ เฟซ

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

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

ชื่อ ใน จำเป็น พิมพ์ คำอธิบาย
workspaceId
path True

string (uuid)

ID พื้นที่ทํางาน

ส่วนหัวของคำขอ

ชื่อ จำเป็น พิมพ์ คำอธิบาย
If-Match

string

ค่า ETag ต้องระบุ ETag ในใบเสนอราคา ถ้าระบุไว้ การเรียกใช้จะสําเร็จก็ต่อเมื่อ ETag ของทรัพยากรตรงกับ ETag ที่ให้มา

เนื้อความของคำขอ

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

InboundRules

คุณสมบัติการสื่อสารเครือข่ายขาเข้าสําหรับพื้นที่ทํางาน

outbound

OutboundRules

คุณสมบัติการสื่อสารเครือข่ายขาออกสําหรับพื้นที่ทํางาน

การตอบสนอง

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

คําขอเสร็จสมบูรณ์

ส่วนหัว

ETag: string

Other Status Codes

ErrorResponse

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

  • UnknownError - เกิดข้อผิดพลาด

ตัวอย่าง

Set workspace networking communication policy example

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

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

{
  "inbound": {
    "publicAccessRules": {
      "defaultAction": "Allow"
    }
  },
  "outbound": {
    "publicAccessRules": {
      "defaultAction": "Deny"
    }
  }
}

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

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

คำจำกัดความ

ชื่อ คำอธิบาย
ErrorRelatedResource

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

ErrorResponse

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

ErrorResponseDetails

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

InboundRules

นโยบายสําหรับการสื่อสารขาเข้าทั้งหมดไปยังพื้นที่ทํางาน

NetworkAccessRule

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

NetworkRules

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

OutboundRules

นโยบายสําหรับการสื่อสารขาออกทั้งหมดจากพื้นที่ทํางาน

WorkspaceNetworkingCommunicationPolicy

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

ErrorRelatedResource

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

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

string

ID ทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

resourceType

string

ชนิดของทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponse

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

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

string

ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้

message

string

การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้

moreDetails

ErrorResponseDetails[]

รายการรายละเอียดข้อผิดพลาดเพิ่มเติม

relatedResource

ErrorRelatedResource

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

requestId

string

รหัสของคําขอที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponseDetails

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

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

string

ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้

message

string

การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้

relatedResource

ErrorRelatedResource

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

InboundRules

นโยบายสําหรับการสื่อสารขาเข้าทั้งหมดไปยังพื้นที่ทํางาน

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

NetworkRules

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

NetworkAccessRule

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

ค่า คำอธิบาย
Allow

อนุญาตการเชื่อมต่อทั้งหมด

Deny

ปฏิเสธการเชื่อมต่อทั้งหมด

NetworkRules

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

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

NetworkAccessRule

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

OutboundRules

นโยบายสําหรับการสื่อสารขาออกทั้งหมดจากพื้นที่ทํางาน

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

NetworkRules

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

WorkspaceNetworkingCommunicationPolicy

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

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

InboundRules

คุณสมบัติการสื่อสารเครือข่ายขาเข้าสําหรับพื้นที่ทํางาน

outbound

OutboundRules

คุณสมบัติการสื่อสารเครือข่ายขาออกสําหรับพื้นที่ทํางาน