Git - Create Workspace Relation

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

สร้างความสัมพันธ์ของพื้นที่ทํางานระหว่างพื้นที่ทํางานที่ระบุและพื้นที่ทํางานที่เกี่ยวข้อง

Note

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

สร้างความสัมพันธ์สาขาระหว่างพื้นที่ทํางานสาขาและพื้นที่ทํางานพื้นฐานของพื้นที่ทํางาน

Permissions

ผู้โทรต้องมีบทบาท ผู้ดูแลระบบ ในพื้นที่ทํางานของสาขาและบทบาท ผู้สนับสนุน หรือสูงกว่าบนพื้นที่ทํางานพื้นฐาน

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

Workspace.ReadWrite.All

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

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

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

อินเตอร์เฟซ

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

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

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

string (uuid)

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

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

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

string (uuid)

ID พื้นที่ทํางานที่เกี่ยวข้อง
relationType True

WorkspaceRelationType

ชนิดของพื้นที่ทํางานที่เกี่ยวข้องที่จะสร้างในความสัมพันธ์ เฉพาะ Base และ Branch เท่านั้นที่ถูกต้องสําหรับการสร้าง

การตอบสนอง

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

WorkspaceRelation

สร้างเสร็จเรียบร้อยแล้ว
429 Too Many Requests

ErrorResponse

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

ส่วนหัว

Retry-After: integer
Other Status Codes

ErrorResponse

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

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

  • WorkspaceNotFound - ไม่พบพื้นที่ทํางานที่ระบุ

  • WorkspaceRelationAlreadyExists - ความสัมพันธ์ระหว่างพื้นที่ทํางานที่ระบุมีอยู่แล้ว

  • WorkspaceRelationBidirectionalExists - ความสัมพันธ์ระหว่างพื้นที่ทํางานเหล่านี้มีอยู่แล้วในทิศทางตรงกันข้าม

  • WorkspaceRelationInvalidArgument - อาร์กิวเมนต์ที่ไม่ถูกต้องที่ระบุไว้สําหรับการดําเนินการความสัมพันธ์ของพื้นที่ทํางาน

  • WorkspaceRelationInvalidType - ชนิดความสัมพันธ์ของพื้นที่ทํางานไม่ถูกต้อง

  • WorkspaceRelationSelfReferencing - พื้นที่ทํางานไม่สามารถเกี่ยวข้องกับตัวเองได้

  • WorkspaceRelationBaseIsBranch - พื้นที่ทํางานพื้นฐานมีสาขาของพื้นที่ทํางานอื่นแล้ว

  • WorkspaceRelationTargetHasBranches - พื้นที่ทํางานเป้าหมายมีพื้นที่ทํางานสาขาอยู่แล้ว

  • WorkspaceRelationDifferentBase - พื้นที่ทํางานเป้าหมายมีพื้นที่ทํางานพื้นฐานที่แตกต่างกัน

  • WorkspaceRelationRootDirectoryMismatch - พื้นที่ทํางานไม่ได้เชื่อมต่อกับรากของที่เก็บ Git เดียวกัน

ตัวอย่าง

Create a workspace relation example

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

POST https://api.fabric.microsoft.com/v1/workspaces/55555555-5555-5555-5555-555555555555/git/workspaceRelations

{
  "relatedWorkspaceId": "33333333-3333-3333-3333-333333333333",
  "relationType": "Base"
}

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

รหัสสถานะ:
201 
{
  "id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
  "workspaceId": "55555555-5555-5555-5555-555555555555",
  "relatedWorkspaceId": "33333333-3333-3333-3333-333333333333",
  "relationType": "Base"
}

คำจำกัดความ

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

คําขอส่วนข้อมูลสําหรับการสร้างความสัมพันธ์ของพื้นที่ทํางาน
ErrorParameter

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

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

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

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

ออบเจ็กต์ความสัมพันธ์ของพื้นที่ทํางาน
WorkspaceRelationType

ชนิดของพื้นที่ทํางานที่เกี่ยวข้องในความสัมพันธ์ คุณสามารถเพิ่มประเภทพื้นที่ทํางานที่เกี่ยวข้องเพิ่มเติมเมื่อเวลาผ่านไป

CreateWorkspaceRelationRequest

วัตถุ

คําขอส่วนข้อมูลสําหรับการสร้างความสัมพันธ์ของพื้นที่ทํางาน

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

string (uuid)

ID พื้นที่ทํางานที่เกี่ยวข้อง
relationType

WorkspaceRelationType

ชนิดของพื้นที่ทํางานที่เกี่ยวข้องที่จะสร้างในความสัมพันธ์ เฉพาะ Base และ Branch เท่านั้นที่ถูกต้องสําหรับการสร้าง

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

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

WorkspaceRelation

วัตถุ

ออบเจ็กต์ความสัมพันธ์ของพื้นที่ทํางาน

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

string (uuid)

รหัสความสัมพันธ์ของพื้นที่ทํางาน
relatedWorkspaceId

string (uuid)

ID พื้นที่ทํางานที่เกี่ยวข้อง
relationType

WorkspaceRelationType

ชนิดของพื้นที่ทํางานที่เกี่ยวข้องในความสัมพันธ์
workspaceId

string (uuid)

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

WorkspaceRelationType

การแจงนับ

ชนิดของพื้นที่ทํางานที่เกี่ยวข้องในความสัมพันธ์ คุณสามารถเพิ่มประเภทพื้นที่ทํางานที่เกี่ยวข้องเพิ่มเติมเมื่อเวลาผ่านไป

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

พื้นที่ทํางานที่เกี่ยวข้องคือพื้นที่ทํางานพื้นฐาน (แหล่งที่มา)
Branch

พื้นที่ทํางานที่เกี่ยวข้องเป็นพื้นที่ทํางานสาขา
RelatedWorkspace

พื้นที่ทํางานที่เกี่ยวข้องมีความสัมพันธ์ทั่วไป