Git - Get Status

Služba:: Core

Verzia rozhrania API:: v1

Git status Vráti položky v pracovnom priestore, ktoré možno zaviazať k službe Git.
Toto rozhranie API podporuje dlhotrvajúce operácie (LRO).

Stav označuje zmeny položiek od posledného pracovného priestoru a synchronizáciu vzdialenej vetvy. Ak boli položky vzdialeného aj pracovného priestoru upravené, rozhranie API označí konflikt. Rozhranie API by sa nemalo volať, kým sa vykonáva operácia Git Aktualizovať z .

Na používanie tohto rozhrania API musia byť poverenia Git volajúceho nakonfigurované pomocou rozhrania API Aktualizovať moje poverenia Git . Na kontrolu konfigurácie poverení Git môžete použiť rozhranie API Načítať moje poverenia Git .

Permissions

Volajúci musí mať rolu prispievateľa alebo vyššieho pracovného priestoru.

Povinné delegované rozsahy

Workspace.GitUpdate.All alebo Workspace.GitCommit.All

Podporované identity v aplikácii Microsoft Entra

Toto rozhranie API podporuje identity Microsoft uvedené v tejto časti.

Identity	Support
User	Yes
Objekt služby a spravované identity	Yes

Interface

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

Parametre URI

Name	V	Povinné	Typ	Description
workspaceId	path	True	string (uuid)	ID pracovného priestoru.

Odpovede

Name	Typ	Description
200 OK	GitStatusResponse	Požiadavka sa úspešne dokončila.
202 Accepted		Žiadosť prijatá, získanie prebiehajúceho stavu. Hlavičky Location: string x-ms-operation-id: string Retry-After: integer
429 Too Many Requests	ErrorResponse	Prekročil sa limit rýchlosti služby. Server vráti hlavičku `Retry-After` v sekundách, ako dlho musí klient počkať, kým odošle ďalšie požiadavky. Hlavičky Retry-After: integer
Other Status Codes	ErrorResponse	Bežné kódy chýb: WorkspaceNotConnectedToGit – pracovný priestor nie je pripojený k službe git. WorkspaceHasNoCapacityAssigned – pracovný priestor nie je v kapacite. InsufficientPrivileges – volajúci nemá dostatočné povolenia pracovného priestoru. PrincipalTypeNotSupported – Typ identity volajúceho nie je podporovaný.

Príklady

Get status example

Get status no changes example

Get status with conflict example

Get status example

Vzorová požiadavka

HTTP

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

Vzorová odpoveď

Kód stavu:: 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"
    }
  ]
}

Kód stavu:: 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

Vzorová požiadavka

HTTP

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

Vzorová odpoveď

Kód stavu:: 200

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

Kód stavu:: 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

Vzorová požiadavka

HTTP

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

Vzorová odpoveď

Kód stavu:: 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"
    }
  ]
}

Kód stavu:: 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

Definície

Name	Description
ChangeType	Zmena položky. V priebehu času je možné pridať ďalšie zmenené typy.
ConflictType	Zmena položky v pracovnom priestore aj na diaľku. V priebehu času je možné pridať ďalšie zmenené typy.
ErrorRelatedResource	Objekt s podrobnosťami o zdroji súvisiacej s chybou.
ErrorResponse	Odpoveď na chybu.
ErrorResponseDetails	Podrobnosti o chybovej odpovedi.
GitStatusResponse	Obsahuje odpoveď na stav.
ItemChange	Obsahuje informácie o zmene položky.
ItemIdentifier	Obsahuje identifikátor položky. Musí byť definovaná aspoň jedna z vlastností.
ItemMetadata	Obsahuje metaúdaje položky.
ItemType	Typ položky. V priebehu času je možné pridať ďalšie typy položiek.

ChangeType

Enumerácia

Zmena položky. V priebehu času je možné pridať ďalšie zmenené typy.

Hodnota	Description
Added	Novovytvorená položka.
Deleted	Položka bola odstránená.
Modified	Obsah položky sa upravil.

ConflictType

Enumerácia

Zmena položky v pracovnom priestore aj na diaľku. V priebehu času je možné pridať ďalšie zmenené typy.

Hodnota	Description
None	V položke sa nič nemení.
Conflict	Existujú rôzne zmeny položky v pracovnom priestore a vo vzdialenom Git.
SameChanges	Existujú identické zmeny položky v pracovnom priestore a vo vzdialenom Git.

ErrorRelatedResource

Object

Objekt s podrobnosťami o zdroji súvisiacej s chybou.

Name	Typ	Description
resourceId	string	ID prostriedku, ktoré je súčasťou chyby.
resourceType	string	Typ prostriedku, ktorý je zapojený do chyby.

ErrorResponse

Object

Odpoveď na chybu.

Name	Typ	Description
errorCode	string	Konkrétny identifikátor, ktorý poskytuje informácie o chybovej podmienke a umožňuje štandardizovanú komunikáciu medzi našou službou a používateľmi.
message	string	Zobrazenie chyby čitateľné ľuďmi.
moreDetails	ErrorResponseDetails[]	Zoznam ďalších podrobností o chybe.
relatedResource	ErrorRelatedResource	Podrobnosti o zdrojoch súvisiacich s chybou.
requestId	string (uuid)	ID požiadavky súvisiacej s chybou.

ErrorResponseDetails

Object

Podrobnosti o chybovej odpovedi.

Name	Typ	Description
errorCode	string	Konkrétny identifikátor, ktorý poskytuje informácie o chybovej podmienke a umožňuje štandardizovanú komunikáciu medzi našou službou a používateľmi.
message	string	Zobrazenie chyby čitateľné ľuďmi.
relatedResource	ErrorRelatedResource	Podrobnosti o zdrojoch súvisiacich s chybou.

GitStatusResponse

Object

Obsahuje odpoveď na stav.

Name	Typ	Description
changes	ItemChange[]	Zoznam zmien vo vzdialenom Git, ktoré sa nepoužijú na daný pracovný priestor, a zmien v pracovnom priestore, ktoré sa nepoužijú na vzdialený Git.
remoteCommitHash	string	Vzdialená úplná hash hlásenia SHA.
workspaceHead	string	Celkový hash SHA, s ktorým je pracovný priestor synchronizovaný.

ItemChange

Object

Obsahuje informácie o zmene položky.

Name	Typ	Description
conflictType	ConflictType	Keď dôjde k zmenám na strane pracovného priestoru aj na vzdialenej strane systému Git.
itemMetadata	ItemMetadata	Metaúdaje položky.
remoteChange	ChangeType	Zmeňte sa na vzdialenej strane Git.
workspaceChange	ChangeType	Zmena na strane pracovného priestoru.

ItemIdentifier

Object

Obsahuje identifikátor položky. Musí byť definovaná aspoň jedna z vlastností.

Name	Typ	Description
logicalId	string (uuid)	Logické ID položky. Keď logické ID nie je k dispozícii, pretože položka ešte nie je pridaná do pracovného priestoru, môžete použiť ID objektu.
objectId	string (uuid)	ID objektu položky. Keď ID objektu nie je k dispozícii, pretože položka bola odstránená z pracovného priestoru, môžete použiť logické ID.

ItemMetadata

Object

Obsahuje metaúdaje položky.

Name	Typ	Description
displayName	string	Zobrazovaný názov položky. Preferuje zobrazovaný názov položky pracovného priestoru, ak existuje, v opačnom prípade displayName používa zobrazovaný názov vzdialenej položky.
itemIdentifier	ItemIdentifier	Identifikátor položky.
itemType	ItemType	Typ položky.

ItemType

Enumerácia

Typ položky. V priebehu času je možné pridať ďalšie typy položiek.

Hodnota	Description
Dashboard	Tabuľa služby PowerBI.
Report	Zostava PowerBI.
SemanticModel	Sémantický model PowerBI.
PaginatedReport	Stránkovaná zostava služby PowerBI.
Datamart	Údajový diagram služby PowerBI.
Lakehouse	Jazero.
Eventhouse	Eventhouse.
Environment	Prostredie.
KQLDatabase	Databáza KQL.
KQLQueryset	Množina dotazov KQL.
KQLDashboard	Tabuľa KQL.
DataPipeline	Kanál údajov.
Notebook	Poznámkový blok.
SparkJobDefinition	Definícia úlohy iskry.
MLExperiment	Experiment strojového učenia.
MLModel	Model strojového učenia.
Warehouse	Sklad.
Eventstream	Udalosť eventstream.
SQLEndpoint	Koncový bod SQL.
MirroredWarehouse	Zrkadlový sklad.
MirroredDatabase	Zrkadlová databáza.
Reflex	A Reflex.
GraphQLApi	Rozhranie API pre položku GraphQL.
MountedDataFactory	A MountedDataFactory.
SQLDatabase	Databáza SQLDatabase.
CopyJob	Kopírovať úlohu.
VariableLibrary	A VariableLibrary.
Dataflow	Tok údajov.
ApacheAirflowJob	An ApacheAirflowJob.
WarehouseSnapshot	Snímka skladu.
DigitalTwinBuilder	A DigitalTwinBuilder.
DigitalTwinBuilderFlow	Digitálny postup Twin Buildera.
MirroredAzureDatabricksCatalog	Zrkadlový katalóg Azure databricks.
Map	Mapa.
AnomalyDetector	Detektor anomálií.
UserDataFunction	Funkcia user data function.
GraphModel	A GraphModel.
GraphQuerySet	Množina dotazov Graphu.
SnowflakeDatabase	Databáza Snowflake na ukladanie tabuliek ľadovec vytvorených z konta Snowflake.
OperationsAgent	OperationsAgent (Operácia).
CosmosDBDatabase	Databáza Cosmos DB.
Ontology	Ontológia.
EventSchemaSet	Množina schém udalosti.
DataAgent	DataAgent (Údajovýgens).

Zdieľať cez

Git - Get Status

Permissions

Povinné delegované rozsahy

Podporované identity v aplikácii Microsoft Entra

Interface

Parametre URI

Odpovede

Príklady

Get status example

Vzorová požiadavka

Vzorová odpoveď

Get status no changes example

Vzorová požiadavka

Vzorová odpoveď

Get status with conflict example

Vzorová požiadavka

Vzorová odpoveď

Definície

ChangeType

ConflictType

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

GitStatusResponse

ItemChange

ItemIdentifier

ItemMetadata

ItemType