Git - Get Status

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 byly položky vzdáleného i pracovního prostoru změněny, rozhraní API označí konflikt.

Pokud chcete toto rozhraní API použít, musí být přihlašovací údaje Git volajícího nakonfigurované pomocí rozhraní UPDATE MY Git CREDENTIALS API. Ke kontrole konfigurace přihlašovacích údajů Gitu můžete použít rozhraní API Získat moje přihlašovací údaje Gitu .

Permissions

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.

Identity	Support
User	Yes
Hlavní služba a Spravované identity	Yes

Interface

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. PrincipalTypeNotSupported – Typ identity volajícího není podporován.

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.
PrincipalTypeNotSupported – Typ identity volajícího není podporován.

Příklady

Get status example

Get status no changes example

Get status with conflict example

Get status example

Ukázkový požadavek

HTTP

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

HTTP

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

HTTP

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
None	V položce nejsou žádné změny.
Conflict	V pracovním prostoru a ve vzdáleném Gitu existují různé změny položky.
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
Report	Sestava PowerBI
SemanticModel	Sémantický model PowerBI
PaginatedReport	Stránkovaná sestava PowerBI
Datamart	Datový diagram PowerBI
Lakehouse	Jezero.
Eventhouse	Eventhouse.
Environment	Prostředí.
KQLDatabase	Databáze KQL.
KQLQueryset	Sada dotazů KQL.
KQLDashboard	Řídicí panel KQL.
DataPipeline	Datový kanál.
Notebook	Poznámkový blok.
SparkJobDefinition	Definice úlohy Sparku.
MLExperiment	Experiment strojového učení.
MLModel	Model strojového učení.
Warehouse	Sklad.
Eventstream	Eventstream.
SQLEndpoint	Koncový bod SQL.
MirroredWarehouse	Zrcadlený sklad.
MirroredDatabase	Zrcadlené databáze.
Reflex	A Reflex.
GraphQLApi	Rozhraní API pro položku GraphQL
MountedDataFactory	A MountedDataFactory.
SQLDatabase	Databáze SQLDatabase.
CopyJob	Úloha kopírování.
VariableLibrary	ProměnnáLibrary.
Dataflow	Tok dat.
ApacheAirflowJob	An ApacheAirflowJob.
WarehouseSnapshot	Snímek skladu.
DigitalTwinBuilder	A DigitalTwinBuilder.
DigitalTwinBuilderFlow	Tok digitálního dvojčete.
MirroredAzureDatabricksCatalog	Zrcadlený katalog Azure Databricks.
Map	Mapa.
AnomalyDetector	Detektor anomálií.
UserDataFunction	Funkce uživatelských dat.
GraphModel	A GraphModel.
GraphQuerySet	Sada dotazů grafu.
SnowflakeDatabase	Snowflake Database pro ukládání tabulek Iceberg vytvořených z účtu Snowflake.
OperationsAgent	A OperationsAgent.
CosmosDBDatabase	Databáze Cosmos DB.

Sdílet prostřednictvím

Git - Get Status

Permissions

Požadované delegovaná rozsahy

Podporované identity Microsoft Entra

Interface

Parametry identifikátoru URI

Odpovědi

Příklady

Get status example

Ukázkový požadavek

Ukázková odpověď

Get status no changes example

Ukázkový požadavek

Ukázková odpověď

Get status with conflict example

Ukázkový požadavek

Ukázková odpověď

Definice

ChangeType

ConflictType

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

GitStatusResponse

ItemChange

ItemIdentifier

ItemMetadata

ItemType