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 |
---|---|---|---|---|
workspace
|
path | True |
string uuid |
ID pracovního prostoru. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
Žádost byla úspěšně dokončena. |
|
202 Accepted |
Žádost byla přijata, získat probíhající stav. Hlavičky
|
|
Other Status Codes |
Běžné kódy chyb:
|
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 |
---|---|
Change |
Změna položky V průběhu času je možné přidat další změněné typy. |
Conflict |
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. |
Error |
Chyba související s objektem podrobností o prostředku. |
Error |
Odpověď na chybu. |
Error |
Podrobnosti o odpovědi na chybu. |
Git |
Obsahuje odpověď na stav. |
Item |
Obsahuje informace o změně položky. |
Item |
Obsahuje identifikátor položky. Musí být definována alespoň jedna z vlastností. |
Item |
Obsahuje metadata položky. |
Item |
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 |
Seznam dalších podrobností o chybě |
|
relatedResource |
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 |
Podrobnosti o prostředku souvisejícím s chybou |
GitStatusResponse
Obsahuje odpověď na stav.
Name | Typ | Description |
---|---|---|
changes |
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 |
Když na straně pracovního prostoru i na vzdálené straně Gitu dojde ke změnám. |
|
itemMetadata |
Metadata položky. |
|
remoteChange |
Změňte na vzdálené straně Gitu. |
|
workspaceChange |
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 |
Identifikátor položky. |
|
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. |