Git - Get Status

บริการ:: Core

เวอร์ชัน API:: v1

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

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

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

Permissions

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

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

Workspace.GitUpdate.All หรือ Workspace.GitCommit.All

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

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

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

Interface

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/git/status

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

ชื่อ	ใน	จำเป็น	พิมพ์	คำอธิบาย
workspaceId	path	True	string (uuid)	ID พื้นที่ทํางาน

การตอบสนอง

ชื่อ	พิมพ์	คำอธิบาย
200 OK	GitStatusResponse	คําขอเสร็จสมบูรณ์
202 Accepted		คําขอยอมรับแล้ว รับสถานะที่กําลังดําเนินการ ส่วนหัว Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	รหัสข้อผิดพลาดทั่วไป: WorkspaceNotConnectedToGit - พื้นที่ทํางานไม่ได้เชื่อมต่อกับ git WorkspaceHasNoCapacityAssigned - พื้นที่ทํางานไม่ได้อยู่ในความจุ ไม่เพียงพอ Privileges - ผู้เรียกไม่มีสิทธิ์พื้นที่ทํางานเพียงพอ PrincipalTypeNotSupported - ไม่สนับสนุนชนิดข้อมูลประจําตัวของผู้เรียก

ชื่อ

พิมพ์

คำอธิบาย

200 OK

GitStatusResponse

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

202 Accepted

คําขอยอมรับแล้ว รับสถานะที่กําลังดําเนินการ

ส่วนหัว

Location: string
x-ms-operation-id: string
Retry-After: integer

Other Status Codes

ErrorResponse

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

WorkspaceNotConnectedToGit - พื้นที่ทํางานไม่ได้เชื่อมต่อกับ git
WorkspaceHasNoCapacityAssigned - พื้นที่ทํางานไม่ได้อยู่ในความจุ
ไม่เพียงพอ Privileges - ผู้เรียกไม่มีสิทธิ์พื้นที่ทํางานเพียงพอ
PrincipalTypeNotSupported - ไม่สนับสนุนชนิดข้อมูลประจําตัวของผู้เรียก

ตัวอย่าง

Get status example

Get status no changes example

Get status with conflict example

Get status example

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

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/1455b6a2-c120-4c1c-dda7-92bafe99bec3/git/status

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

รหัสสถานะ:: 200

{
  "workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "remoteCommitHash": "7d03b2918bf6aa62f96d0a4307293f3853201705",
  "changes": [
    {
      "itemMetadata": {
        "itemIdentifier": {
          "objectId": "7753f3b4-dbb8-44c1-a94f-6ae4d776369e"
        },
        "itemType": "SemanticModel",
        "displayName": "My new dataset in the workspace"
      },
      "workspaceChange": "Added",
      "conflictType": "None"
    },
    {
      "itemMetadata": {
        "itemIdentifier": {
          "logicalId": "1423f3b4-dba5-44c1-a94f-6ae4d776369a"
        },
        "itemType": "Report",
        "displayName": "My deleted report in Git"
      },
      "remoteChange": "Deleted",
      "conflictType": "None"
    },
    {
      "itemMetadata": {
        "itemIdentifier": {
          "logicalId": "111e8d7b-4a95-4c02-8ccd-6faef5ba1bd1",
          "objectId": "1153f3b4-dbb8-33c1-a84f-6ae4d776362d"
        },
        "itemType": "SemanticModel",
        "displayName": "Modified dataset in the workspace"
      },
      "workspaceChange": "Modified",
      "conflictType": "None"
    }
  ]
}

รหัสสถานะ:: 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

Get status no changes example

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

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/1455b6a2-c120-4c1c-dda7-92bafe99bec3/git/status

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

รหัสสถานะ:: 200

{
  "workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "remoteCommitHash": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "changes": []
}

รหัสสถานะ:: 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

Get status with conflict example

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

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/1455b6a2-c120-4c1c-dda7-92bafe99bec3/git/status

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

รหัสสถานะ:: 200

{
  "workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "remoteCommitHash": "7d03b2918bf6aa62f96d0a4307293f3853201705",
  "changes": [
    {
      "itemMetadata": {
        "itemIdentifier": {
          "logicalId": "222e8d7b-4a95-4c02-8ccd-6faef5ba1bd2",
          "objectId": "8853f3b4-dbb8-33c1-a84f-6ae4d776362a"
        },
        "itemType": "Report",
        "displayName": "Modified report on both sides"
      },
      "remoteChange": "Modified",
      "workspaceChange": "Modified",
      "conflictType": "Conflict"
    }
  ]
}

รหัสสถานะ:: 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

คำจำกัดความ

ชื่อ	คำอธิบาย
ChangeType	การเปลี่ยนแปลงหน่วยข้อมูล คุณสามารถเพิ่มชนิดการเปลี่ยนแปลงเพิ่มเติมเมื่อเวลาผ่านไป
ConflictType	การเปลี่ยนแปลงรายการทั้งในพื้นที่ทํางานและระยะไกล คุณสามารถเพิ่มชนิดการเปลี่ยนแปลงเพิ่มเติมเมื่อเวลาผ่านไป
ErrorRelatedResource	ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
ErrorResponse	การตอบสนองข้อผิดพลาด
ErrorResponseDetails	รายละเอียดการตอบสนองข้อผิดพลาด
GitStatusResponse	ประกอบด้วยการตอบสนองสถานะ
ItemChange	ประกอบด้วยข้อมูลการเปลี่ยนแปลงของรายการ
ItemIdentifier	ประกอบด้วยตัวระบุรายการ ต้องกําหนดคุณสมบัติอย่างน้อยหนึ่งอย่าง
ItemMetadata	ประกอบด้วยเมตาดาต้าของหน่วยข้อมูล
ItemType	ชนิดของสินค้า คุณสามารถเพิ่มชนิดหน่วยข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป

ChangeType

การแจงนับ

การเปลี่ยนแปลงหน่วยข้อมูล คุณสามารถเพิ่มชนิดการเปลี่ยนแปลงเพิ่มเติมเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
Added	รายการที่สร้างขึ้นใหม่
Deleted	รายการถูกลบแล้ว
Modified	เนื้อหาของรายการถูกปรับเปลี่ยนแล้ว

ConflictType

การแจงนับ

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

ค่า	คำอธิบาย
None	ไม่มีการเปลี่ยนแปลงในรายการ
Conflict	มีการเปลี่ยนแปลงที่แตกต่างกันในรายการในพื้นที่ทํางานและใน Git ระยะไกล
SameChanges	มีการเปลี่ยนแปลงที่เหมือนกันกับรายการในพื้นที่ทํางานและใน Git ระยะไกล

ErrorRelatedResource

วัตถุ

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

ชื่อ	พิมพ์	คำอธิบาย
resourceId	string	ID ทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
resourceType	string	ชนิดของทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponse

วัตถุ

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

ชื่อ	พิมพ์	คำอธิบาย
errorCode	string	ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้
message	string	การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้
moreDetails	ErrorResponseDetails[]	รายการรายละเอียดข้อผิดพลาดเพิ่มเติม
relatedResource	ErrorRelatedResource	รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
requestId	string	รหัสของคําขอที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponseDetails

วัตถุ

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

ชื่อ	พิมพ์	คำอธิบาย
errorCode	string	ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้
message	string	การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้
relatedResource	ErrorRelatedResource	รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

GitStatusResponse

วัตถุ

ประกอบด้วยการตอบสนองสถานะ

ชื่อ	พิมพ์	คำอธิบาย
changes	ItemChange[]	รายการของการเปลี่ยนแปลงใน Git ระยะไกลที่ไม่ได้นําไปใช้กับพื้นที่ทํางานที่ระบุ และการเปลี่ยนแปลงในพื้นที่ทํางานที่ไม่ได้นําไปใช้กับ Git ระยะไกล
remoteCommitHash	string	แฮชการยอมรับ SHA แบบเต็มระยะไกล
workspaceHead	string	SHA แฮชเต็มรูปแบบที่พื้นที่ทํางานถูกซิงค์ด้วย

ItemChange

วัตถุ

ประกอบด้วยข้อมูลการเปลี่ยนแปลงของรายการ

ชื่อ	พิมพ์	คำอธิบาย
conflictType	ConflictType	เมื่อมีการเปลี่ยนแปลงทั้งด้านพื้นที่ทํางานและด้าน Git ระยะไกล
itemMetadata	ItemMetadata	เมตาดาต้าของหน่วยข้อมูล
remoteChange	ChangeType	เปลี่ยนด้าน Git ระยะไกล
workspaceChange	ChangeType	เปลี่ยนด้านพื้นที่ทํางาน

ItemIdentifier

วัตถุ

ประกอบด้วยตัวระบุรายการ ต้องกําหนดคุณสมบัติอย่างน้อยหนึ่งอย่าง

ชื่อ	พิมพ์	คำอธิบาย
logicalId	string (uuid)	ID เชิงตรรกะของสินค้า เมื่อ ID เชิงตรรกะไม่พร้อมใช้งานเนื่องจากรายการยังไม่ได้เพิ่มไปยังพื้นที่ทํางาน คุณสามารถใช้ ID ออบเจ็กต์ได้
objectId	string (uuid)	ID ออปเจ็กต์ของรายการ เมื่อ ID ออบเจ็กต์ไม่พร้อมใช้งานเนื่องจากรายการถูกลบจากพื้นที่ทํางาน คุณสามารถใช้ ID เชิงตรรกะได้

ItemMetadata

วัตถุ

ประกอบด้วยเมตาดาต้าของหน่วยข้อมูล

ชื่อ	พิมพ์	คำอธิบาย
displayName	string	ชื่อที่แสดงของรายการ ต้องการชื่อที่แสดงของรายการพื้นที่ทํางานถ้ามี ไม่เช่นนั้น displayName จะใช้ชื่อที่แสดงของรายการระยะไกล
itemIdentifier	ItemIdentifier	ตัวระบุรายการ
itemType	ItemType	ชนิดหน่วยข้อมูล

ItemType

การแจงนับ

ชนิดของสินค้า คุณสามารถเพิ่มชนิดหน่วยข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
Dashboard	แดชบอร์ด PowerBI
Report	รายงาน PowerBI
SemanticModel	แบบจําลองความหมายของ PowerBI
PaginatedReport	รายงานที่มีการแบ่งหน้าของ PowerBI
Datamart	Datamart ของ PowerBI
Lakehouse	เลคเฮ้าส์
Eventhouse	อาคารจัดงาน
Environment	สภาพแวดล้อม
KQLDatabase	ฐานข้อมูล KQL
KQLQueryset	ชุดคิวรี KQL
KQLDashboard	แดชบอร์ด KQL
DataPipeline	ไปป์ไลน์ข้อมูล
Notebook	โน๊ตบุ๊ค
SparkJobDefinition	ข้อกําหนดงานแบบประกายไฟ
MLExperiment	การทดลองการเรียนรู้ของเครื่อง
MLModel	แบบจําลองการเรียนรู้ของเครื่อง
Warehouse	คลังสินค้า
Eventstream	เหตุการณ์กระแสข้อมูล
SQLEndpoint	จุดสิ้นสุด SQL
MirroredWarehouse	คลังสินค้าที่มิเรอร์
MirroredDatabase	ฐานข้อมูลที่มิเรอร์
Reflex	รีเฟล็กซ์
GraphQLApi	API สําหรับรายการ GraphQL
MountedDataFactory	เมาท์ DataFactory
SQLDatabase	SQLDatabase
CopyJob	งานคัดลอก
VariableLibrary	VariableLibrary
Dataflow	กระแสข้อมูล
ApacheAirflowJob	ApacheAirflowJob
WarehouseSnapshot	สแนปช็อตของคลังสินค้า
DigitalTwinBuilder	DigitalTwinBuilder
DigitalTwinBuilderFlow	โฟลว์ Digital Twin Builder
MirroredAzureDatabricksCatalog	แค็ตตาล็อก azure databricks ที่มิเรอร์
Map	แผนที่.
AnomalyDetector	การตรวจหาความผิดปกติ
UserDataFunction	ฟังก์ชันข้อมูลผู้ใช้
GraphModel	GraphModel
GraphQuerySet	ชุดคิวรีกราฟ
SnowflakeDatabase	ฐานข้อมูล Snowflake เพื่อจัดเก็บตาราง Iceberg ที่สร้างขึ้นจากบัญชี Snowflake
OperationsAgent	OperationsAgent
CosmosDBDatabase	ฐานข้อมูล Cosmos DB
Ontology	โทโพโลยี
EventSchemaSet	EventSchemaSet

แชร์ผ่าน

Git - Get Status

Permissions

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

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

Interface

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

การตอบสนอง

ตัวอย่าง

Get status example

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

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

Get status no changes example

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

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

Get status with conflict example

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

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

คำจำกัดความ

ChangeType

ConflictType

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

GitStatusResponse

ItemChange

ItemIdentifier

ItemMetadata

ItemType