Git - Get Status

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 elementer siden sidste synkronisering af arbejdsområde og fjerngren. Hvis fjern- og arbejdsområdeelementerne begge blev ændret, markerer API'en en konflikt.

Hvis du vil bruge denne API, skal den kaldendes Git-legitimationsoplysninger konfigureres ved hjælp af API'en Opdater Mine Git-legitimationsoplysninger . Du kan bruge API'en Hent Mine Git-legitimationsoplysninger til at kontrollere konfigurationen af Git-legitimationsoplysningerne.

Permissions

Den, der ringer op, skal have en bidragyderrolle 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.

Identity	Support
User	Yes
tjenesteprincipal og administrerede identiteter	Yes

Interface

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. PrincipalTypeNotSupported – Opkaldsidentitetstypen understøttes ikke.

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.
PrincipalTypeNotSupported – Opkaldsidentitetstypen understøttes ikke.

Eksempler

Get status example

Get status no changes example

Get status with conflict example

Get status example

Eksempelanmodning

HTTP

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

HTTP

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

HTTP

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
None	Der er ingen ændringer af elementet.
Conflict	Der er forskellige ændringer af elementet i arbejdsområdet og i fjern-Git.
SameChanges	Der er identiske ændringer af elementet i arbejdsområdet og i fjern-Git.

ErrorRelatedResource

Objekt

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

Objekt

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

Objekt

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

Objekt

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

Objekt

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

Objekt

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

Objekt

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.
Report	PowerBI-rapport.
SemanticModel	Semantisk PowerBI-model.
PaginatedReport	Sideinddelt PowerBI-rapport.
Datamart	PowerBI-datamart.
Lakehouse	Et søhus.
Eventhouse	Et eventhouse.
Environment	Et miljø.
KQLDatabase	En KQL-database.
KQLQueryset	Et KQL-forespørgselssæt.
KQLDashboard	Et KQL-dashboard.
DataPipeline	En datapipeline.
Notebook	En notesbog.
SparkJobDefinition	En spark jobdefinition.
MLExperiment	Et maskinel indlæringseksperiment.
MLModel	En model til maskinel indlæring.
Warehouse	Et lager.
Eventstream	En hændelsesstream.
SQLEndpoint	Et SQL-slutpunkt.
MirroredWarehouse	Et spejlvendt lager.
MirroredDatabase	En spejlet database.
Reflex	En refleks.
GraphQLApi	En API til GraphQL-element.
MountedDataFactory	En MountedDataFactory.
SQLDatabase	En SQLDatabase.
CopyJob	Et kopijob.
VariableLibrary	En VariabelLibrary.
Dataflow	Et dataflow.
ApacheAirflowJob	En ApacheAirflowJob.
WarehouseSnapshot	Et lagersnapshot.
DigitalTwinBuilder	En DigitalTwinBuilder.
DigitalTwinBuilderFlow	Et Digital Twin Builder-flow.
MirroredAzureDatabricksCatalog	Et spejlet Azure Databricks-katalog.
Map	Et kort.
AnomalyDetector	En uregelmæssighedsregistrering.
UserDataFunction	En brugerdatafunktion.
GraphModel	En GraphModel.
GraphQuerySet	Et Graph QuerySet.
SnowflakeDatabase	En Snowflake-database til lagring af Iceberg-tabeller, der er oprettet fra Snowflake-konto.
OperationsAgent	En OperationsAgent.
CosmosDBDatabase	En Cosmos DB-database.

Del via

Git - Get Status

Permissions

Påkrævede delegerede områder

Microsoft Entra-understøttede identiteter

Interface

URI-parametre

Svar

Eksempler

Get status example

Eksempelanmodning

Eksempelsvar

Get status no changes example

Eksempelanmodning

Eksempelsvar

Get status with conflict example

Eksempelanmodning

Eksempelsvar

Definitioner

ChangeType

ConflictType

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

GitStatusResponse

ItemChange

ItemIdentifier

ItemMetadata

ItemType