Workspaces - Set Inbound External Data Shares Policy

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

Note

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

สิทธิ์

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

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

Workspace.ReadWrite.All

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

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

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

Interface

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

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

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

string (uuid)

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

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

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

string

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

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

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

NetworkAccessRule

กําหนดว่า ปริมาณการใช้งานการแชร์ข้อมูลภายนอกได้รับอนุญาตให้ข้ามข้อจํากัดด้านเครือข่ายขาเข้าหรือไม่

การตอบสนอง

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

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

ส่วนหัว

ETag: string

429 Too Many Requests

ErrorResponse

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

ส่วนหัว

Retry-After: integer

Other Status Codes

ErrorResponse

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

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

ตัวอย่าง

Set workspace inbound External Data Shares policy example

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

PUT https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/networking/communicationPolicy/inbound/externalDataShares


{
  "defaultAction": "Allow"
}

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

ETag: "e5f6g7h8"

คำจำกัดความ

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

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

ErrorRelatedResource

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

ErrorResponse

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

ErrorResponseDetails

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

NetworkAccessRule

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

WorkspaceInboundExternalDataSharesPolicy

นโยบายข้อยกเว้นของเครือข่ายขาเข้าสําหรับการแชร์ข้อมูลภายนอกในพื้นที่ทํางาน

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

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

NetworkAccessRule

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

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

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

Deny

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

WorkspaceInboundExternalDataSharesPolicy

นโยบายข้อยกเว้นของเครือข่ายขาเข้าสําหรับการแชร์ข้อมูลภายนอกในพื้นที่ทํางาน

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

NetworkAccessRule

กําหนดว่า ปริมาณการใช้งานการแชร์ข้อมูลภายนอกได้รับอนุญาตให้ข้ามข้อจํากัดด้านเครือข่ายขาเข้าหรือไม่