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
| ชื่อ | ใน | จำเป็น | พิมพ์ | คำอธิบาย |
|---|---|---|---|---|
|
workspace
|
path | True |
string (uuid) |
ID พื้นที่ทํางาน |
ส่วนหัวของคำขอ
| ชื่อ | จำเป็น | พิมพ์ | คำอธิบาย |
|---|---|---|---|
| If-Match |
string |
ค่า ETag ต้องระบุ ETag ในใบเสนอราคา ถ้าระบุไว้ การเรียกใช้จะสําเร็จก็ต่อเมื่อ ETag ของทรัพยากรตรงกับ ETag ที่ให้มา |
เนื้อความของคำขอ
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| defaultAction |
กําหนดว่า ปริมาณการใช้งานการแชร์ข้อมูลภายนอกได้รับอนุญาตให้ข้ามข้อจํากัดด้านเครือข่ายขาเข้าหรือไม่ |
การตอบสนอง
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| 200 OK |
คําขอเสร็จสมบูรณ์ ส่วนหัว ETag: string |
|
| 429 Too Many Requests |
เกินขีดจํากัดอัตราการบริการ เซิร์ฟเวอร์จะส่งกลับ ส่วนหัว Retry-After: integer |
|
| Other Status Codes |
รหัสข้อผิดพลาดทั่วไป:
|
ตัวอย่าง
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"
คำจำกัดความ
| ชื่อ | คำอธิบาย |
|---|---|
|
Error |
พารามิเตอร์ที่มีโครงสร้างให้บริบทที่สามารถอ่านได้ด้วยเครื่องเพิ่มเติมเกี่ยวกับข้อผิดพลาด |
|
Error |
ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด |
|
Error |
การตอบสนองข้อผิดพลาด |
|
Error |
รายละเอียดการตอบสนองข้อผิดพลาด |
|
Network |
นโยบายเริ่มต้นสําหรับการเข้าถึงพื้นที่ทํางานจากเครือข่ายสาธารณะ ถ้าเว้นไว้จากเนื้อความของคําขอ PUT เขตข้อมูลนี้จะเป็นค่าเริ่มต้น |
|
Workspace |
นโยบายข้อยกเว้นของเครือข่ายขาเข้าสําหรับการแชร์ข้อมูลภายนอกในพื้นที่ทํางาน |
ErrorParameter
พารามิเตอร์ที่มีโครงสร้างให้บริบทที่สามารถอ่านได้ด้วยเครื่องเพิ่มเติมเกี่ยวกับข้อผิดพลาด
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| message |
string |
คําอธิบายที่มนุษย์สามารถอ่านได้ของความหมายของพารามิเตอร์ |
| name |
string |
ตัวระบุพารามิเตอร์ |
| value |
string |
ค่าพารามิเตอร์ |
ErrorRelatedResource
ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| resourceId |
string |
ID ทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด |
| resourceType |
string |
ชนิดของทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด |
ErrorResponse
การตอบสนองข้อผิดพลาด
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| errorCode |
string |
ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้ |
| isRetriable |
boolean |
เมื่อเป็นจริง สามารถลองคําขอใหม่ได้ ใช้ส่วนหัวการตอบสนอง |
| message |
string |
การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้ |
| moreDetails |
รายการรายละเอียดข้อผิดพลาดเพิ่มเติม |
|
| parameters |
พารามิเตอร์ที่มีโครงสร้างให้บริบทที่สามารถอ่านได้ด้วยเครื่องเพิ่มเติมเกี่ยวกับข้อผิดพลาด |
|
| relatedResource |
รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด |
|
| requestId |
string (uuid) |
รหัสของคําขอที่เกี่ยวข้องกับข้อผิดพลาด |
ErrorResponseDetails
รายละเอียดการตอบสนองข้อผิดพลาด
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| errorCode |
string |
ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้ |
| message |
string |
การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้ |
| parameters |
พารามิเตอร์ที่มีโครงสร้างให้บริบทที่สามารถอ่านได้ด้วยเครื่องเพิ่มเติมเกี่ยวกับข้อผิดพลาด |
|
| relatedResource |
รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด |
NetworkAccessRule
นโยบายเริ่มต้นสําหรับการเข้าถึงพื้นที่ทํางานจากเครือข่ายสาธารณะ ถ้าเว้นไว้จากเนื้อความของคําขอ PUT เขตข้อมูลนี้จะเป็นค่าเริ่มต้น Allowซึ่งอาจเปิดการเข้าถึงเครือข่ายโดยไม่ได้ตั้งใจ ระบุเขตข้อมูลนี้อย่างชัดเจนทุกครั้งในทุกเนื้อความของคําขอ PUT
| ค่า | คำอธิบาย |
|---|---|
| Allow |
อนุญาตการเชื่อมต่อทั้งหมด |
| Deny |
ปฏิเสธการเชื่อมต่อทั้งหมด |
WorkspaceInboundExternalDataSharesPolicy
นโยบายข้อยกเว้นของเครือข่ายขาเข้าสําหรับการแชร์ข้อมูลภายนอกในพื้นที่ทํางาน
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| defaultAction |
กําหนดว่า ปริมาณการใช้งานการแชร์ข้อมูลภายนอกได้รับอนุญาตให้ข้ามข้อจํากัดด้านเครือข่ายขาเข้าหรือไม่ |