แชร์ผ่าน

Git - Initialize Connection

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

เริ่มต้นการเชื่อมต่อสําหรับพื้นที่ทํางานที่เชื่อมต่อกับ Git
API นี้สนับสนุน การดําเนินการที่ใช้เวลานาน (LRO)

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

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

Permissions

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

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

Workspace.ReadWrite.All

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

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

Identity Support
User Yes
บริการหลักและข้อมูลประจําตัว ที่มีการจัดการ Yes

Interface

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/git/initializeConnection

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

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

string (uuid)

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

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

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

InitializationStrategy

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

การตอบสนอง

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

InitializeGitConnectionResponse

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

คําขอยอมรับแล้ว เตรียมใช้งานการเชื่อมต่อที่กําลังดําเนินการ

ส่วนหัว

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

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

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

  • WorkspaceHasNoCapacityAssigned - ไม่ได้กําหนดความจุให้กับพื้นที่ทํางาน

  • MissingInitializationPolicy - นโยบายการเตรียมใช้งานขาดหายไป

  • ไม่เพียงพอ Privileges - ผู้เรียกมีสิทธิ์เพียงพอบนพื้นที่ทํางาน

  • PrincipalTypeNotSupported - ไม่สนับสนุนชนิดข้อมูลประจําตัวของผู้เรียก

ตัวอย่าง

Initialize the connection of a workspace connected to a Git example

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

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

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

รหัสสถานะ:
200 
{
  "requiredAction": "UpdateFromGit",
  "workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "remoteCommitHash": "7d03b2918bf6aa62f96d0a4307293f3853201705"
}
รหัสสถานะ:
202 
Location: https://api.fabric.microsoft.com/v1/operations/431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7
x-ms-operation-id: 431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7
Retry-After: 30

คำจำกัดความ

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

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

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

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

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

ประกอบด้วยข้อมูลคําขอการเชื่อมต่อ Git เริ่มต้น
InitializeGitConnectionResponse

ประกอบด้วยข้อมูลการตอบสนองการเชื่อมต่อ Git เริ่มต้น
RequiredAction

จําเป็นต้องมีการดําเนินการหลังจากกระบวนการเตรียมใช้งานเสร็จสิ้น คุณสามารถเพิ่มการดําเนินการเพิ่มเติมเมื่อเวลาผ่านไป

ErrorRelatedResource

ออบเจ็กต์

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

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

string

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

string

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

ErrorResponse

ออบเจ็กต์

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

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

string

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

string

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

ErrorResponseDetails[]

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

ErrorRelatedResource

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

string

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

ErrorResponseDetails

ออบเจ็กต์

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

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

string

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

string

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

ErrorRelatedResource

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

InitializationStrategy

การแจงนับ

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

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

ไม่มีการกําหนดกลยุทธ์
PreferRemote

ต้องการเนื้อหาด้าน Git ระยะไกล
PreferWorkspace

ต้องการเนื้อหาด้านพื้นที่ทํางานมากกว่า

InitializeGitConnectionRequest

ออบเจ็กต์

ประกอบด้วยข้อมูลคําขอการเชื่อมต่อ Git เริ่มต้น

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

InitializationStrategy

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

InitializeGitConnectionResponse

ออบเจ็กต์

ประกอบด้วยข้อมูลการตอบสนองการเชื่อมต่อ Git เริ่มต้น

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

string

แฮชการยอมรับ SHA แบบเต็มระยะไกล
requiredAction

RequiredAction

จําเป็นต้องมีการดําเนินการหลังจากกระบวนการเตรียมใช้งานเสร็จสิ้น คุณสามารถเพิ่มการดําเนินการเพิ่มเติมเมื่อเวลาผ่านไป
workspaceHead

string

SHA แฮชเต็มรูปแบบที่พื้นที่ทํางานถูกซิงค์ด้วย

RequiredAction

การแจงนับ

จําเป็นต้องมีการดําเนินการหลังจากกระบวนการเตรียมใช้งานเสร็จสิ้น คุณสามารถเพิ่มการดําเนินการเพิ่มเติมเมื่อเวลาผ่านไป

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

ไม่จำเป็นต้องดำเนินการใดๆ
UpdateFromGit

จําเป็นต้องมีการอัปเดตจาก Git
CommitToGit

ต้องยอมรับ Git