Del via

Git - Get Status

  • Referanse
Tjeneste:
Core
API-versjon:
v1

Returnerer Git status elementer i arbeidsområdet, som kan forpliktes til Git.
Denne API-en støtter langvarige operasjoner (LRO).

Statusen angir endringer i elementet(e) siden forrige arbeidsområde og ekstern grensynkronisering. Hvis begge plasseringene ble endret, flagger API-en konflikt.

Tillatelser

Innringeren må ha en bidragsyter eller høyere arbeidsområderolle.

Nødvendige delegerte omfang

Workspace.GitUpdate.All eller Workspace.GitCommit.All

Microsoft Entra-støttede identiteter

Denne API-en støtter Microsoft -identiteter oppført i denne delen.

Identitet Støtte
Bruker Ja
tjenestekontohaver og administrerte identiteter Nei

Grensesnitt

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

URI-parametere

Navn I Obligatorisk Type Beskrivelse
workspaceId
 path True

string

uuid

Arbeidsområde-ID-en.

Svar

Navn Type Beskrivelse
200 OK

GitStatusResponse

Forespørselen er fullført.
202 Accepted

Forespørsel godtatt, få status pågår.

Overskrifter

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

ErrorResponse

Vanlige feilkoder:

  • WorkspaceNotConnectedToGit – arbeidsområdet er ikke koblet til git.

  • WorkspaceHasNoCapacityAssigned – arbeidsområdet er ikke på kapasitet.

  • InsufficientPrivileges – Innringeren har ikke tilstrekkelige arbeidsområdetillatelser.

Eksempler

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

Get status example

Eksempelforespørsel

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

Eksempelsvar

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

Eksempelforespørsel

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

Eksempelsvar

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

Eksempelforespørsel

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

Eksempelsvar

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

Definisjoner

Navn Beskrivelse
ChangeType

En endring av et element. Flere endrede typer kan legges til over tid.
ConflictType

En endring av et element i både arbeidsområde og ekstern. Flere endrede typer kan legges til over tid.
ErrorRelatedResource

Objektet for feilrelaterte ressursdetaljer.
ErrorResponse

Feilsvaret.
ErrorResponseDetails

Feilsvardetaljene.
GitStatusResponse

Inneholder statussvaret.
ItemChange

Inneholder endringsinformasjonen for elementet.
ItemIdentifier

Inneholder elementidentifikatoren. Minst én av egenskapene må defineres.
ItemMetadata

Inneholder elementmetadataene.
ItemType

Typen element. Flere elementtyper kan legges til over tid.

ChangeType

Opplisting

En endring av et element. Flere endrede typer kan legges til over tid.

Verdi Beskrivelse
Added

Et nyopprettet element.
Deleted

Elementet er slettet.
Modified

Elementinnhold er endret.

ConflictType

Opplisting

En endring av et element i både arbeidsområde og ekstern. Flere endrede typer kan legges til over tid.

Verdi Beskrivelse
Conflict

Det finnes forskjellige endringer i elementet i arbeidsområdet og i ekstern Git.
None

Det er ingen endringer i elementet.
SameChanges

Det er identiske endringer i elementet i arbeidsområdet og i ekstern Git.

ErrorRelatedResource

Object

Objektet for feilrelaterte ressursdetaljer.

Navn Type Beskrivelse
resourceId

string

Ressurs-ID-en som er involvert i feilen.
resourceType

string

Typen ressurs som er involvert i feilen.

ErrorResponse

Object

Feilsvaret.

Navn Type Beskrivelse
errorCode

string

En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.
message

string

En menneskelig lesbar representasjon av feilen.
moreDetails

ErrorResponseDetails[]

Liste over flere feildetaljer.
relatedResource

ErrorRelatedResource

Feilrelaterte ressursdetaljer.
requestId

string

ID for forespørselen som er knyttet til feilen.

ErrorResponseDetails

Object

Feilsvardetaljene.

Navn Type Beskrivelse
errorCode

string

En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.
message

string

En menneskelig lesbar representasjon av feilen.
relatedResource

ErrorRelatedResource

Feilrelaterte ressursdetaljer.

GitStatusResponse

Object

Inneholder statussvaret.

Navn Type Beskrivelse
changes

ItemChange[]

En liste over endringer i ekstern Git som ikke brukes på det angitte arbeidsområdet, og endringer i arbeidsområdet som ikke brukes på ekstern Git.
remoteCommitHash

string

Ekstern fullstendig SHA-utføringsnummer.
workspaceHead

string

Fullstendig SHA-hash som arbeidsområdet er synkronisert til.

ItemChange

Object

Inneholder endringsinformasjonen for elementet.

Navn Type Beskrivelse
conflictType

ConflictType

Når det er endringer på både arbeidsområdesiden og den eksterne Git-siden.
itemMetadata

ItemMetadata

Elementmetadataene.
remoteChange

ChangeType

Endre på den eksterne Git-siden.
workspaceChange

ChangeType

Endre på arbeidsområdesiden.

ItemIdentifier

Object

Inneholder elementidentifikatoren. Minst én av egenskapene må defineres.

Navn Type Beskrivelse
logicalId

string

uuid

Den logiske ID-en for elementet. Når den logiske IDen ikke er tilgjengelig fordi elementet ennå ikke er lagt til i arbeidsområdet, kan du bruke objekt-ID-en.
objectId

string

uuid

Objekt-ID-en for elementet. Når objekt-ID-en ikke er tilgjengelig fordi elementet ble slettet fra arbeidsområdet, kan du bruke den logiske ID-en.

ItemMetadata

Object

Inneholder elementmetadataene.

Navn Type Beskrivelse
displayName

string

Visningsnavnet for elementet. Foretrekker visningsnavnet for arbeidsområdet hvis det finnes, ellers bruker displayName visningsnavnet for det eksterne elementet.
itemIdentifier

ItemIdentifier

Elementidentifikatoren.
itemType

ItemType

Elementtypen.

ItemType

Opplisting

Typen element. Flere elementtyper kan legges til over tid.

Verdi Beskrivelse
Dashboard

PowerBI-instrumentbord.
DataPipeline

Et datasamlebånd.
Datamart

PowerBI-datamart.
Environment

Et miljø.
Eventhouse

Et arrangementshus.
Eventstream

En hendelsesstrøm.
GraphQLApi

En API for GraphQL-element.
KQLDashboard

Et KQL-instrumentbord.
KQLDatabase

En KQL-database.
KQLQueryset

Et KQL-spørringssett.
Lakehouse

Et innsjøhus.
MLExperiment

Et maskinlæringseksperiment.
MLModel

En maskinlæringsmodell.
MirroredDatabase

En speilvendt database.
MirroredWarehouse

Et speilvendt lager.
MountedDataFactory

En MountedDataFactory.
Notebook

En notatblokk.
PaginatedReport

Paginert powerbi-rapport.
Reflex

En refleks.
Report

PowerBI-rapport.
SQLDatabase

En SQLDatabase.
SQLEndpoint

Et SQL-endepunkt.
SemanticModel

Semantisk PowerBI-modell.
SparkJobDefinition

En spark-jobbdefinisjon.
Warehouse

Et lager.