다음을 통해 공유

Git - Get Status

  • 참조
서비스:
Core
API 버전:
v1

Git에 커밋할 수 있는 작업 영역의 항목 Git status 반환합니다.
이 API는 LRO(장기 실행 작업)지원합니다.

상태는 마지막 작업 영역 및 원격 분기 동기화 이후 항목의 변경 내용을 나타냅니다. 두 위치가 모두 수정된 경우 API는 충돌에 플래그를 지정합니다.

권한을

호출자에게는 기여자 이상의 작업 영역 역할이 있어야 합니다.

필요한 위임된 범위

Workspace.GitUpdate.All 또는 Workspace.GitCommit.All

Microsoft Entra 지원 ID

이 API는 이 섹션에 나열된 Microsoft ID 지원합니다.

신원 지원
사용자 예
서비스 주체 및 관리 ID 아니요

인터페이스

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
workspaceId
 path True

string

uuid

작업 영역 ID입니다.

응답

Name 형식 Description
200 OK

GitStatusResponse

요청이 성공적으로 완료되었습니다.
202 Accepted

요청을 수락하고 진행 중인 상태를 가져옵니다.

헤더

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

ErrorResponse

일반적인 오류 코드:

  • WorkspaceNotConnectedToGit - 작업 영역이 git에 연결되어 있지 않습니다.

  • WorkspaceHasNoCapacityAssigned - 작업 영역이 용량에 없습니다.

  • InsufficientPrivileges - 호출자에게 충분한 작업 영역 권한이 없습니다.

예제

Get status example
Get status no changes example
Get status with conflict example

Get status example

샘플 요청

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

샘플 요청

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

샘플 요청

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

정의

Name Description
ChangeType

항목의 변경 내용입니다. 변경된 형식은 시간이 지남에 따라 추가될 수 있습니다.
ConflictType

작업 영역과 원격 모두에서 항목의 변경 내용입니다. 변경된 형식은 시간이 지남에 따라 추가될 수 있습니다.
ErrorRelatedResource

오류 관련 리소스 세부 정보 개체입니다.
ErrorResponse

오류 응답입니다.
ErrorResponseDetails

오류 응답 세부 정보입니다.
GitStatusResponse

상태 응답을 포함합니다.
ItemChange

항목의 변경 정보를 포함합니다.
ItemIdentifier

항목 식별자를 포함합니다. 하나 이상의 속성을 정의해야 합니다.
ItemMetadata

항목 메타데이터를 포함합니다.
ItemType

항목의 형식입니다. 추가 항목 유형은 시간이 지남에 따라 추가될 수 있습니다.

ChangeType

Enumeration

항목의 변경 내용입니다. 변경된 형식은 시간이 지남에 따라 추가될 수 있습니다.

값 Description
Added

새로 만든 항목입니다.
Deleted

항목이 삭제되었습니다.
Modified

항목 콘텐츠가 수정되었습니다.

ConflictType

Enumeration

작업 영역과 원격 모두에서 항목의 변경 내용입니다. 변경된 형식은 시간이 지남에 따라 추가될 수 있습니다.

값 Description
Conflict

작업 영역 및 원격 Git에서 항목에 대한 다른 변경 내용이 있습니다.
None

항목에 대한 변경 내용이 없습니다.
SameChanges

작업 영역 및 원격 Git에서 항목에 동일한 변경 내용이 있습니다.

ErrorRelatedResource

Object

오류 관련 리소스 세부 정보 개체입니다.

Name 형식 Description
resourceId

string

오류와 관련된 리소스 ID입니다.
resourceType

string

오류와 관련된 리소스의 형식입니다.

ErrorResponse

Object

오류 응답입니다.

Name 형식 Description
errorCode

string

오류 조건에 대한 정보를 제공하여 서비스와 사용자 간의 표준화된 통신을 허용하는 특정 식별자입니다.
message

string

사용자가 읽을 수 있는 오류 표현입니다.
moreDetails

ErrorResponseDetails[]

추가 오류 세부 정보 목록입니다.
relatedResource

ErrorRelatedResource

오류 관련 리소스 세부 정보입니다.
requestId

string

오류와 연결된 요청의 ID입니다.

ErrorResponseDetails

Object

오류 응답 세부 정보입니다.

Name 형식 Description
errorCode

string

오류 조건에 대한 정보를 제공하여 서비스와 사용자 간의 표준화된 통신을 허용하는 특정 식별자입니다.
message

string

사용자가 읽을 수 있는 오류 표현입니다.
relatedResource

ErrorRelatedResource

오류 관련 리소스 세부 정보입니다.

GitStatusResponse

Object

상태 응답을 포함합니다.

Name 형식 Description
changes

ItemChange[]

지정된 작업 영역에 적용되지 않는 원격 Git의 변경 내용 및 원격 Git에 적용되지 않은 작업 영역의 변경 내용 목록입니다.
remoteCommitHash

string

원격 전체 SHA 커밋 해시입니다.
workspaceHead

string

작업 영역이 동기화되는 전체 SHA 해시입니다.

ItemChange

Object

항목의 변경 정보를 포함합니다.

Name 형식 Description
conflictType

ConflictType

작업 영역 쪽과 원격 Git 쪽 모두에 변경 내용이 있는 경우
itemMetadata

ItemMetadata

항목 메타데이터입니다.
remoteChange

ChangeType

원격 Git 쪽에서 변경합니다.
workspaceChange

ChangeType

작업 영역 쪽에서 변경합니다.

ItemIdentifier

Object

항목 식별자를 포함합니다. 하나 이상의 속성을 정의해야 합니다.

Name 형식 Description
logicalId

string

uuid

항목의 논리적 ID입니다. 항목이 작업 영역에 아직 추가되지 않았기 때문에 논리 ID를 사용할 수 없는 경우 개체 ID를 사용할 수 있습니다.
objectId

string

uuid

항목의 개체 ID입니다. 작업 영역에서 항목이 삭제되어 개체 ID를 사용할 수 없는 경우 논리 ID를 사용할 수 있습니다.

ItemMetadata

Object

항목 메타데이터를 포함합니다.

Name 형식 Description
displayName

string

항목의 표시 이름입니다. 작업 영역 항목이 있는 경우 표시 이름을 사용하는 것이 좋습니다. 그렇지 않으면 displayName은 원격 항목의 표시 이름을 사용합니다.
itemIdentifier

ItemIdentifier

항목 식별자입니다.
itemType

ItemType

항목 유형입니다.

ItemType

Enumeration

항목의 형식입니다. 추가 항목 유형은 시간이 지남에 따라 추가될 수 있습니다.

값 Description
Dashboard

PowerBI 대시보드.
DataPipeline

데이터 파이프라인입니다.
Datamart

PowerBI datamart.
Environment

환경입니다.
Eventhouse

이벤트 하우스.
Eventstream

eventstream입니다.
GraphQLApi

GraphQL 항목에 대한 API입니다.
KQLDashboard

KQL 대시보드.
KQLDatabase

KQL 데이터베이스입니다.
KQLQueryset

KQL 쿼리 세트입니다.
Lakehouse

레이크 하우스.
MLExperiment

기계 학습 실험입니다.
MLModel

기계 학습 모델입니다.
MirroredDatabase

미러된 데이터베이스입니다.
MirroredWarehouse

미러된 창고입니다.
MountedDataFactory

MountedDataFactory입니다.
Notebook

전자 필기장입니다.
PaginatedReport

PowerBI 페이지를 매긴 보고서입니다.
Reflex

반사.
Report

PowerBI 보고서입니다.
SQLDatabase

SQLDatabase입니다.
SQLEndpoint

SQL 엔드포인트입니다.
SemanticModel

PowerBI 의미 체계 모델입니다.
SparkJobDefinition

Spark 작업 정의입니다.
Warehouse

창고.