Dela via

Git - Get Status

  • Referens
Tjänst:
Core
API-version:
v1

Returnerar Git status av objekt i arbetsytan som kan checkas in på Git.
Det här API:et stöder tidskrävande åtgärder (LRO).

Statusen anger ändringar i objekten sedan den senaste synkroniseringen av arbetsytan och fjärrgrenen. Om båda platserna ändrades flaggar API:et en konflikt.

Behörigheter

Anroparen måste ha en deltagare eller högre arbetsyteroll.

Obligatoriska delegerade omfång

Workspace.GitUpdate.All eller Workspace.GitCommit.All

Identiteter som stöds av Microsoft Entra

Det här API:et stöder Microsoft identiteter som anges i det här avsnittet.

Identitet Stöd
Användare Ja
Tjänstens huvudnamn och hanterade identiteter Nej

Gränssnitt

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

URI-parametrar

Name I Obligatorisk Typ Description
workspaceId
 path True

string

uuid

Arbetsytans ID.

Svar

Name Typ Description
200 OK

GitStatusResponse

Begäran har slutförts.
202 Accepted

Begäran har godkänts och statusen pågår.

Sidhuvuden

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

ErrorResponse

Vanliga felkoder:

  • ArbetsytaNotConnectedToGit – Arbetsytan är inte ansluten till git.

  • ArbetsytaHasNoCapacityAssigned – Arbetsytan har inte kapacitet.

  • InsufficientPrivileges – anroparen har inte tillräcklig behörighet för arbetsytan.

Exempel

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

Get status example

Exempelbegäran

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

Exempelsvar

Statuskod:
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"
    }
  ]
}
Statuskod:
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

Exempelbegäran

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

Exempelsvar

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

Exempelbegäran

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

Exempelsvar

Statuskod:
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"
    }
  ]
}
Statuskod:
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

Definitioner

Name Description
ChangeType

En ändring av ett objekt. Ytterligare ändrade typer kan läggas till över tid.
ConflictType

En ändring av ett objekt på både arbetsyta och fjärrplats. Ytterligare ändrade typer kan läggas till över tid.
ErrorRelatedResource

Det felrelaterade resursinformationsobjektet.
ErrorResponse

Felsvaret.
ErrorResponseDetails

Information om felsvar.
GitStatusResponse

Innehåller statussvaret.
ItemChange

Innehåller objektets ändringsinformation.
ItemIdentifier

Innehåller objektidentifieraren. Minst en av egenskaperna måste definieras.
ItemMetadata

Innehåller objektmetadata.
ItemType

Typ av objekt. Ytterligare objekttyper kan läggas till över tid.

ChangeType

Uppräkning

En ändring av ett objekt. Ytterligare ändrade typer kan läggas till över tid.

Värde Description
Added

Ett nyligen skapat objekt.
Deleted

Objektet har tagits bort.
Modified

Objektinnehållet har ändrats.

ConflictType

Uppräkning

En ändring av ett objekt på både arbetsyta och fjärrplats. Ytterligare ändrade typer kan läggas till över tid.

Värde Description
Conflict

Det finns olika ändringar i objektet på arbetsytan och i git-fjärranslutna objekt.
None

Det finns inga ändringar i objektet.
SameChanges

Det finns identiska ändringar i objektet på arbetsytan och i git-fjärranslutna objekt.

ErrorRelatedResource

Objekt

Det felrelaterade resursinformationsobjektet.

Name Typ Description
resourceId

string

Det resurs-ID som ingår i felet.
resourceType

string

Typen av resurs som är inblandad i felet.

ErrorResponse

Objekt

Felsvaret.

Name Typ Description
errorCode

string

En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.
message

string

En mänsklig läsbar representation av felet.
moreDetails

ErrorResponseDetails[]

Lista över ytterligare felinformation.
relatedResource

ErrorRelatedResource

Felrelaterad resursinformation.
requestId

string

ID för den begäran som är associerad med felet.

ErrorResponseDetails

Objekt

Information om felsvar.

Name Typ Description
errorCode

string

En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.
message

string

En mänsklig läsbar representation av felet.
relatedResource

ErrorRelatedResource

Felrelaterad resursinformation.

GitStatusResponse

Objekt

Innehåller statussvaret.

Name Typ Description
changes

ItemChange[]

En lista över ändringar i fjärranslutna Git som inte tillämpas på den angivna arbetsytan och ändringar i arbetsytan som inte tillämpas på fjärranslutna Git.
remoteCommitHash

string

Fullständig SHA-incheckningshash för fjärranslutning.
workspaceHead

string

Fullständig SHA-hash som arbetsytan synkroniseras till.

ItemChange

Objekt

Innehåller objektets ändringsinformation.

Name Typ Description
conflictType

ConflictType

När det finns ändringar på både arbetsytans sida och git-fjärrsidan.
itemMetadata

ItemMetadata

Objektmetadata.
remoteChange

ChangeType

Ändra på git-fjärrsidan.
workspaceChange

ChangeType

Ändra på arbetsytans sida.

ItemIdentifier

Objekt

Innehåller objektidentifieraren. Minst en av egenskaperna måste definieras.

Name Typ Description
logicalId

string

uuid

Objektets logiska ID. När det logiska ID:t inte är tillgängligt eftersom objektet ännu inte har lagts till på arbetsytan kan du använda objekt-ID:t.
objectId

string

uuid

Objektets objekt-ID. När objekt-ID:t inte är tillgängligt eftersom objektet har tagits bort från arbetsytan kan du använda det logiska ID:t.

ItemMetadata

Objekt

Innehåller objektmetadata.

Name Typ Description
displayName

string

Objektets visningsnamn. Föredrar arbetsyteobjektets visningsnamn om det finns, annars använder displayName fjärrobjektets visningsnamn.
itemIdentifier

ItemIdentifier

Objektidentifieraren.
itemType

ItemType

Objekttypen.

ItemType

Uppräkning

Typ av objekt. Ytterligare objekttyper kan läggas till över tid.

Värde Description
Dashboard

PowerBI-instrumentpanel.
DataPipeline

En datapipeline.
Datamart

PowerBI-datamart.
Environment

En miljö.
Eventhouse

Ett eventhouse.
Eventstream

En händelseström.
GraphQLApi

Ett API för GraphQL-objekt.
KQLDashboard

En KQL-instrumentpanel.
KQLDatabase

En KQL-databas.
KQLQueryset

En KQL-frågeuppsättning.
Lakehouse

Ett sjöhus.
MLExperiment

Ett maskininlärningsexperiment.
MLModel

En maskininlärningsmodell.
MirroredDatabase

En speglad databas.
MirroredWarehouse

Ett speglat lager.
MountedDataFactory

En MountedDataFactory.
Notebook

En notebook-fil.
PaginatedReport

Sidnumrerad PowerBI-rapport.
Reflex

En reflex.
Report

PowerBI-rapport.
SQLDatabase

En SQLDatabase.
SQLEndpoint

En SQL-slutpunkt.
SemanticModel

PowerBI-semantisk modell.
SparkJobDefinition

En definition för Spark-jobb.
Warehouse

Ett lager.