Del via

Git - Get Status

  • Reference
Tjeneste:
Core
API-version:
v1

Returnerer Git status af elementer i arbejdsområdet, der kan sendes til Git.
Denne API understøtter LRO-handlinger (Long Running Operations).

Status angiver ændringer af elementet eller elementerne siden sidste synkronisering af arbejdsområde og fjerngren. Hvis begge placeringer blev ændret, markerer API'en en konflikt.

Tilladelser

Den, der ringer op, skal have en bidragyder eller en højere rolle i arbejdsområdet.

Påkrævede delegerede områder

Workspace.GitUpdate.All eller Workspace.GitCommit.All

Microsoft Entra-understøttede identiteter

Denne API understøtter de Microsoft -identiteter, der angivet i dette afsnit.

Identitet Støtte
Bruger Ja
tjenesteprincipal og administrerede identiteter Nej

Grænseflade

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

URI-parametre

Name I Påkrævet Type Beskrivelse
workspaceId
 path True

string

uuid

Arbejdsområde-id'et.

Svar

Name Type Beskrivelse
200 OK

GitStatusResponse

Anmodningen blev fuldført.
202 Accepted

Anmodning accepteret. Få status i gang.

Headere

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

ErrorResponse

Almindelige fejlkoder:

  • WorkspaceNotConnectedToGit – Arbejdsområdet har ikke forbindelse til git.

  • WorkspaceHasNoCapacityAssigned – Arbejdsområdet er ikke på kapacitet.

  • InsufficientPrivileges – Den kaldende bruger har ikke tilstrækkelige tilladelser til arbejdsområdet.

Eksempler

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

Get status example

Eksempelanmodning

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

Eksempelanmodning

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

Eksempelanmodning

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

Definitioner

Name Beskrivelse
ChangeType

En ændring af et element. Der kan tilføjes flere ændrede typer over tid.
ConflictType

En ændring af et element i både arbejdsområde og fjern. Der kan tilføjes flere ændrede typer over tid.
ErrorRelatedResource

Objektet med fejlrelaterede ressourceoplysninger.
ErrorResponse

Fejlsvaret.
ErrorResponseDetails

Oplysninger om fejlsvar.
GitStatusResponse

Indeholder statussvaret.
ItemChange

Indeholder ændringsoplysningerne for elementet.
ItemIdentifier

Indeholder element-id'et. Mindst én af egenskaberne skal være defineret.
ItemMetadata

Indeholder elementets metadata.
ItemType

Elementets type. Der kan tilføjes flere elementtyper over tid.

ChangeType

Optælling

En ændring af et element. Der kan tilføjes flere ændrede typer over tid.

Værdi Beskrivelse
Added

Et nyoprettet element.
Deleted

Elementet er blevet slettet.
Modified

Elementindholdet er blevet ændret.

ConflictType

Optælling

En ændring af et element i både arbejdsområde og fjern. Der kan tilføjes flere ændrede typer over tid.

Værdi Beskrivelse
Conflict

Der er forskellige ændringer af elementet i arbejdsområdet og i fjern-Git.
None

Der er ingen ændringer af elementet.
SameChanges

Der er identiske ændringer af elementet i arbejdsområdet og i fjern-Git.

ErrorRelatedResource

Object

Objektet med fejlrelaterede ressourceoplysninger.

Name Type Beskrivelse
resourceId

string

Det ressource-id, der er involveret i fejlen.
resourceType

string

Typen af ressource, der er involveret i fejlen.

ErrorResponse

Object

Fejlsvaret.

Name Type Beskrivelse
errorCode

string

Et bestemt id, der indeholder oplysninger om en fejltilstand, der muliggør standardiseret kommunikation mellem vores tjeneste og dens brugere.
message

string

En menneskelig læsbar gengivelse af fejlen.
moreDetails

ErrorResponseDetails[]

Liste over yderligere oplysninger om fejl.
relatedResource

ErrorRelatedResource

De fejlrelaterede ressourceoplysninger.
requestId

string

Id'et for den anmodning, der er knyttet til fejlen.

ErrorResponseDetails

Object

Oplysninger om fejlsvar.

Name Type Beskrivelse
errorCode

string

Et bestemt id, der indeholder oplysninger om en fejltilstand, der muliggør standardiseret kommunikation mellem vores tjeneste og dens brugere.
message

string

En menneskelig læsbar gengivelse af fejlen.
relatedResource

ErrorRelatedResource

De fejlrelaterede ressourceoplysninger.

GitStatusResponse

Object

Indeholder statussvaret.

Name Type Beskrivelse
changes

ItemChange[]

En liste over ændringer i det eksterne Git, der ikke er anvendt på det angivne arbejdsområde, og ændringer i arbejdsområdet, der ikke anvendes på Git-fjernadgang.
remoteCommitHash

string

Fuldstændig SHA-bekræftelses-hash for fjernforbindelse.
workspaceHead

string

Fuld SHA-hash, som arbejdsområdet synkroniseres til.

ItemChange

Object

Indeholder ændringsoplysningerne for elementet.

Name Type Beskrivelse
conflictType

ConflictType

Når der er ændringer på både arbejdsområdesiden og den eksterne Git-side.
itemMetadata

ItemMetadata

Elementets metadata.
remoteChange

ChangeType

Skift på den eksterne Git-side.
workspaceChange

ChangeType

Skift på arbejdsområdesiden.

ItemIdentifier

Object

Indeholder element-id'et. Mindst én af egenskaberne skal være defineret.

Name Type Beskrivelse
logicalId

string

uuid

Det logiske id for elementet. Når det logiske id ikke er tilgængeligt, fordi elementet endnu ikke er føjet til arbejdsområdet, kan du bruge objekt-id'et.
objectId

string

uuid

Elementets objekt-id. Når objekt-id'et ikke er tilgængeligt, fordi elementet er slettet fra arbejdsområdet, kan du bruge det logiske id.

ItemMetadata

Object

Indeholder elementets metadata.

Name Type Beskrivelse
displayName

string

Elementets viste navn. Foretrækker det viste navn på arbejdsområdet, hvis det findes. Ellers bruger displayName fjernelementets viste navn.
itemIdentifier

ItemIdentifier

Element-id'et.
itemType

ItemType

Elementtypen.

ItemType

Optælling

Elementets type. Der kan tilføjes flere elementtyper over tid.

Værdi Beskrivelse
Dashboard

PowerBI-dashboard.
DataPipeline

En datapipeline.
Datamart

PowerBI-datamart.
Environment

Et miljø.
Eventhouse

Et eventhouse.
Eventstream

En hændelsesstream.
GraphQLApi

En API til GraphQL-element.
KQLDashboard

Et KQL-dashboard.
KQLDatabase

En KQL-database.
KQLQueryset

Et KQL-forespørgselssæt.
Lakehouse

Et søhus.
MLExperiment

Et maskinel indlæringseksperiment.
MLModel

En model til maskinel indlæring.
MirroredDatabase

En spejlet database.
MirroredWarehouse

Et spejlvendt lager.
MountedDataFactory

En MountedDataFactory.
Notebook

En notesbog.
PaginatedReport

Sideinddelt PowerBI-rapport.
Reflex

En refleks.
Report

PowerBI-rapport.
SQLDatabase

En SQLDatabase.
SQLEndpoint

Et SQL-slutpunkt.
SemanticModel

Semantisk PowerBI-model.
SparkJobDefinition

En spark jobdefinition.
Warehouse

Et lager.