Sdílet prostřednictvím


Git - Get Status

Vrátí Git status položek v pracovním prostoru, které je možné potvrdit do Gitu.
Toto rozhraní API podporuje dlouhotrvajících operací (LRO).

Stav označuje změny položek od poslední synchronizace pracovního prostoru a vzdálené větve. Pokud byla obě umístění upravena, rozhraní API označí konflikt.

Dovolení

Volající musí mít roli přispěvatele nebo vyšší roli pracovního prostoru.

Požadované delegovaná rozsahy

Workspace.GitUpdate.All nebo Workspace.GitCommit.All

Podporované identity Microsoft Entra

Toto rozhraní API podporuje identity Microsoft uvedené v této části.

Identita Podpora
Uživatel Ano
instančního objektu a spravované identity Ne

Rozhraní

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
workspaceId
path True

string

uuid

ID pracovního prostoru.

Odpovědi

Name Typ Description
200 OK

GitStatusResponse

Žádost byla úspěšně dokončena.

202 Accepted

Žádost byla přijata, získat probíhající stav.

Hlavičky

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

ErrorResponse

Běžné kódy chyb:

  • WorkspaceNotConnectedToGit – Pracovní prostor není připojený k Gitu.

  • WorkspaceHasNoCapacityAssigned – Pracovní prostor není v kapacitě.

  • InsufficientPrivileges – Volající nemá dostatečná oprávnění pracovního prostoru.

Příklady

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

Get status example

Ukázkový požadavek

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

Ukázková odpověď

{
  "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"
    }
  ]
}
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

Ukázkový požadavek

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

Ukázková odpověď

{
  "workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "remoteCommitHash": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "changes": []
}
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

Ukázkový požadavek

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

Ukázková odpověď

{
  "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"
    }
  ]
}
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

Definice

Name Description
ChangeType

Změna položky V průběhu času je možné přidat další změněné typy.

ConflictType

Změna položky v pracovním prostoru i ve vzdáleném prostředí V průběhu času je možné přidat další změněné typy.

ErrorRelatedResource

Chyba související s objektem podrobností o prostředku.

ErrorResponse

Odpověď na chybu.

ErrorResponseDetails

Podrobnosti o odpovědi na chybu.

GitStatusResponse

Obsahuje odpověď na stav.

ItemChange

Obsahuje informace o změně položky.

ItemIdentifier

Obsahuje identifikátor položky. Musí být definována alespoň jedna z vlastností.

ItemMetadata

Obsahuje metadata položky.

ItemType

Typ položky. V průběhu času je možné přidat další typy položek.

ChangeType

Změna položky V průběhu času je možné přidat další změněné typy.

Hodnota Description
Added

Nově vytvořená položka.

Deleted

Položka byla odstraněna.

Modified

Obsah položky byl změněn.

ConflictType

Změna položky v pracovním prostoru i ve vzdáleném prostředí V průběhu času je možné přidat další změněné typy.

Hodnota Description
Conflict

V pracovním prostoru a ve vzdáleném Gitu existují různé změny položky.

None

V položce nejsou žádné změny.

SameChanges

Existují stejné změny položky v pracovním prostoru a ve vzdáleném Gitu.

ErrorRelatedResource

Chyba související s objektem podrobností o prostředku.

Name Typ Description
resourceId

string

ID prostředku, které je součástí chyby.

resourceType

string

Typ prostředku, který je součástí chyby.

ErrorResponse

Odpověď na chybu.

Name Typ Description
errorCode

string

Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.

message

string

Lidské čitelné vyjádření chyby.

moreDetails

ErrorResponseDetails[]

Seznam dalších podrobností o chybě

relatedResource

ErrorRelatedResource

Podrobnosti o prostředku souvisejícím s chybou

requestId

string

ID požadavku přidruženého k chybě.

ErrorResponseDetails

Podrobnosti o odpovědi na chybu.

Name Typ Description
errorCode

string

Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.

message

string

Lidské čitelné vyjádření chyby.

relatedResource

ErrorRelatedResource

Podrobnosti o prostředku souvisejícím s chybou

GitStatusResponse

Obsahuje odpověď na stav.

Name Typ Description
changes

ItemChange[]

Seznam změn ve vzdáleném Gitu, které nejsou použity pro daný pracovní prostor, a změny v pracovním prostoru, které nejsou použity pro vzdálený Git.

remoteCommitHash

string

Vzdálená úplná hodnota hash potvrzení SHA

workspaceHead

string

Úplná hodnota hash SHA, se kterou se pracovní prostor synchronizuje.

ItemChange

Obsahuje informace o změně položky.

Name Typ Description
conflictType

ConflictType

Když na straně pracovního prostoru i na vzdálené straně Gitu dojde ke změnám.

itemMetadata

ItemMetadata

Metadata položky.

remoteChange

ChangeType

Změňte na vzdálené straně Gitu.

workspaceChange

ChangeType

Změňte na straně pracovního prostoru.

ItemIdentifier

Obsahuje identifikátor položky. Musí být definována alespoň jedna z vlastností.

Name Typ Description
logicalId

string

uuid

Logické ID položky. Pokud logické ID není k dispozici, protože položka ještě není přidána do pracovního prostoru, můžete použít ID objektu.

objectId

string

uuid

ID objektu položky. Pokud ID objektu není k dispozici, protože položka byla odstraněna z pracovního prostoru, můžete použít logické ID.

ItemMetadata

Obsahuje metadata položky.

Name Typ Description
displayName

string

Zobrazovaný název položky. Preferuje zobrazovaný název položky pracovního prostoru, pokud existuje, jinak displayName používá zobrazovaný název vzdálené položky.

itemIdentifier

ItemIdentifier

Identifikátor položky.

itemType

ItemType

Typ položky.

ItemType

Typ položky. V průběhu času je možné přidat další typy položek.

Hodnota Description
Dashboard

Řídicí panel PowerBI

DataPipeline

Datový kanál.

Datamart

Datový diagram PowerBI

Environment

Prostředí.

Eventhouse

Eventhouse.

Eventstream

Eventstream.

GraphQLApi

Rozhraní API pro položku GraphQL

KQLDashboard

Řídicí panel KQL.

KQLDatabase

Databáze KQL.

KQLQueryset

Sada dotazů KQL.

Lakehouse

Jezero.

MLExperiment

Experiment strojového učení.

MLModel

Model strojového učení.

MirroredDatabase

Zrcadlené databáze.

MirroredWarehouse

Zrcadlený sklad.

MountedDataFactory

A MountedDataFactory.

Notebook

Poznámkový blok.

PaginatedReport

Stránkovaná sestava PowerBI

Reflex

A Reflex.

Report

Sestava PowerBI

SQLDatabase

Databáze SQLDatabase.

SQLEndpoint

Koncový bod SQL.

SemanticModel

Sémantický model PowerBI

SparkJobDefinition

Definice úlohy Sparku.

Warehouse

Sklad.