Git - Update Connection Settings

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

Note

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

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

การอนุญาต

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

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

Workspace.ReadWrite.All

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

API นี้สนับสนุน Microsoft identitiesที่ระบุในส่วนนี้

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

ส่วนติดต่อ

PATCH https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/git/connectionSettings

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

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

string (uuid)

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

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

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

GitAdditionalBranchChangingRoles

บทบาทพื้นที่ทํางานเพิ่มเติมนอกเหนือจากผู้ดูแลระบบที่ได้รับอนุญาตให้เปลี่ยนสาขา Git ที่เชื่อมต่อกัน

การตอบสนอง

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

GitConnectionSettings

คําขอเสร็จสมบูรณ์
429 Too Many Requests

ErrorResponse

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

ส่วนหัว

Retry-After: integer
Other Status Codes

ErrorResponse

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

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

  • ไม่เพียงพอ Privileges - ผู้เรียกไม่มีบทบาทผู้ดูแลระบบสําหรับพื้นที่ทํางาน

  • WorkspaceNotConnectedToGit - พื้นที่ทํางานไม่ได้เชื่อมต่อกับ git

ตัวอย่าง

Update connection settings example

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

PATCH https://api.fabric.microsoft.com/v1/workspaces/1565e6a3-c020-4c0c-dda7-92bafe99eec5/git/connectionSettings

{
  "additionalRolesAuthorizedToChangeBranch": "MemberAndContributor"
}

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

รหัสสถานะ:
200 
{
  "additionalRolesAuthorizedToChangeBranch": "MemberAndContributor"
}

คำจำกัดความ

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

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

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

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

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

บทบาทพื้นที่ทํางานเพิ่มเติมนอกเหนือจากผู้ดูแลระบบที่ได้รับอนุญาตให้เปลี่ยนสาขา Git ที่เชื่อมต่อกัน อาจมีการเพิ่มค่าเพิ่มเติมเมื่อเวลาผ่านไป
GitConnectionSettings

ประกอบด้วยการตั้งค่าการเชื่อมต่อ Git
UpdateGitConnectionSettingsRequest

ประกอบด้วยข้อมูลการร้องขอเพื่อปรับปรุงการตั้งค่าการเชื่อมต่อ Git

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

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

GitAdditionalBranchChangingRoles

การแจงนับ

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

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

ไม่มีบทบาทเพิ่มเติมนอกเหนือจากผู้ดูแลระบบที่สามารถเปลี่ยนสาขาได้ นี่คือค่าเริ่มต้น
MemberAndContributor

สมาชิกและผู้สนับสนุนยังสามารถเปลี่ยนสาขานอกเหนือจากผู้ดูแลระบบได้

GitConnectionSettings

วัตถุ

ประกอบด้วยการตั้งค่าการเชื่อมต่อ Git

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

GitAdditionalBranchChangingRoles

บทบาทพื้นที่ทํางานเพิ่มเติมนอกเหนือจากผู้ดูแลระบบที่ได้รับอนุญาตให้เปลี่ยนสาขา Git ที่เชื่อมต่อกัน

UpdateGitConnectionSettingsRequest

วัตถุ

ประกอบด้วยข้อมูลการร้องขอเพื่อปรับปรุงการตั้งค่าการเชื่อมต่อ Git

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

GitAdditionalBranchChangingRoles

บทบาทพื้นที่ทํางานเพิ่มเติมนอกเหนือจากผู้ดูแลระบบที่ได้รับอนุญาตให้เปลี่ยนสาขา Git ที่เชื่อมต่อกัน