Workspaces - Set Git Outbound Policy

บริการ:
Core
เวอร์ชัน API:
v1

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

Note

ถ้า defaultAction ถูกเว้นไว้จากเนื้อความของคําขอ ค่าเริ่มต้นคือ Allowซึ่งอาจอนุญาตให้มีการรวม Git โดยไม่ได้ตั้งใจเมื่อควรจํากัดการเข้าถึงขาออก ระบุ defaultAction อย่างชัดเจนทุกครั้งในทุกเนื้อความของคําขอ PUT

การอนุญาต

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

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

Workspace.ReadWrite.All

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

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

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

อินเตอร์เฟซ

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

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

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

string (uuid)

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

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

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

string

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

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

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

NetworkAccessRule

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

การตอบสนอง

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

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

ส่วนหัว

ETag: string
429 Too Many Requests

ErrorResponse

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

ส่วนหัว

Retry-After: integer
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/outbound/git

{
  "defaultAction": "Allow"
}

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

รหัสสถานะ:
200 
ETag: 0f8fad5b-d9cb-469f-a165-70867728950e

คำจำกัดความ

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

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

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

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

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

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

ErrorRelatedResource

วัตถุ

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

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

string

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

string

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

ErrorResponse

วัตถุ

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

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

string

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

boolean

เมื่อเป็นจริง สามารถลองคําขอใหม่ได้ ใช้ส่วนหัวการตอบสนอง Retry-After เพื่อกําหนดความล่าช้า ถ้ามี
message

string

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

ErrorResponseDetails[]

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

ErrorRelatedResource

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

string (uuid)

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

ErrorResponseDetails

วัตถุ

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

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

string

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

string

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

ErrorRelatedResource

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

NetworkAccessRule

การแจงนับ

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

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

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

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

NetworkRules

วัตถุ

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

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

NetworkAccessRule

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