Sdílet prostřednictvím

Git - Get Status

  • Reference
Služba:
Core
Verze rozhraní API:
v1

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ěď

Stavový kód:
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"
    }
  ]
}
Stavový kód:
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

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
200 
{
  "workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "remoteCommitHash": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "changes": []
}
Stavový kód:
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

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
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"
    }
  ]
}
Stavový kód:
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

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

Výčet

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

Výčet

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

Objekt

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

Objekt

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

Objekt

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

Objekt

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

Objekt

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

Objekt

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

Objekt

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

Výčet

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.