Jaa kautta


Git - Get Status

Palauttaa työtilan kohteiden Git status, jotka voidaan sitoa Gitille.
Tämä ohjelmointirajapinta tukee pitkäkestoisia toimintoja.

Tila ilmaisee kohteiden muutoksia viimeisimmän työtilan ja etähaaran synkronoinnin jälkeen. Jos sekä etä- että työtilakohteita muokattiin, ohjelmointirajapinta merkitsee ristiriidan.

Jotta voit käyttää tätä ohjelmointirajapintaa, soittajan Git-tunnistetiedot on määritettävä Käyttämällä Päivitä Omat Git-tunnistetiedot -ohjelmointirajapintaa. Voit tarkistaa Git-tunnistetietojen määritykset Hanki Omat Git-tunnistetiedot -ohjelmointirajapinnan avulla.

Permissions

Kutsujalla on oltava osallistujan tai suurempi työtilarooli.

Vaaditut delegoidut vaikutusalueet

Workspace.GitUpdate.All tai Workspace.GitCommit.All

Microsoft Entran tukemat käyttäjätiedot

Tämä ohjelmointirajapinta tukee tässä osiossa lueteltuja Microsoft -käyttäjätietoja.

Identity Support
User Yes
palvelun päänimen ja Hallittujen käyttäjätietojen Yes

Interface

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

URI-parametrit

Nimi Kohteessa Pakollinen Tyyppi Description
workspaceId
path True

string (uuid)

Työtilan tunnus.

Vastaukset

Nimi Tyyppi Description
200 OK

GitStatusResponse

Pyynnön valmistuttua.

202 Accepted

Pyyntö hyväksytty, tilan saaminen on meneillään.

Otsikot

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

ErrorResponse

Yleiset virhekoodit:

  • WorkspaceNotConnectedToGit – Työtila ei ole yhteydessä Gitiin.

  • WorkspaceHasNoCapacityAssigned – Työtila ei ole kapasiteetissa.

  • InsufficientPrivileges – Soittajalla ei ole riittäviä työtilan käyttöoikeuksia.

  • PrincipalTypeNotSupported – Soittajan käyttäjätietotyyppiä ei tueta.

Esimerkit

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

Get status example

Mallipyyntö

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

Mallivastaus

{
  "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

Mallipyyntö

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

Mallivastaus

{
  "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

Mallipyyntö

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

Mallivastaus

{
  "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

Määritelmät

Nimi Description
ChangeType

Kohteen muutos. Muita muutettuja tyyppejä voidaan lisätä ajan mittaan.

ConflictType

Kohteen muutos sekä työtilassa että etäkohteessa. Muita muutettuja tyyppejä voidaan lisätä ajan mittaan.

ErrorRelatedResource

Virheeseen liittyvä resurssitieto-objekti.

ErrorResponse

Virhevastaus.

ErrorResponseDetails

Virheen vastauksen tiedot.

GitStatusResponse

Sisältää tilavastauksen.

ItemChange

Sisältää kohteen muutostiedot.

ItemIdentifier

Sisältää kohteen tunnuksen. Vähintään yksi ominaisuuksista on määritettävä.

ItemMetadata

Sisältää kohteen metatiedot.

ItemType

Kohteen tyyppi. Muita kohdetyyppejä voidaan lisätä ajan kuluessa.

ChangeType

Kohteen muutos. Muita muutettuja tyyppejä voidaan lisätä ajan mittaan.

Arvo Description
Added

Juuri luotu kohde.

Deleted

Kohde on poistettu.

Modified

Kohteen sisältöä on muokattu.

ConflictType

Kohteen muutos sekä työtilassa että etäkohteessa. Muita muutettuja tyyppejä voidaan lisätä ajan mittaan.

Arvo Description
None

Kohteeseen ei ole tehty muutoksia.

Conflict

Työtilan ja etägit-etäkohteen kohdalla on erilaisia muutoksia.

SameChanges

Työtilassa ja Etä-Git-etäkohteessa on samat muutokset.

ErrorRelatedResource

Virheeseen liittyvä resurssitieto-objekti.

Nimi Tyyppi Description
resourceId

string

Virheestä liittyvä resurssitunnus.

resourceType

string

Virheestä liittyvän resurssin tyyppi.

ErrorResponse

Virhevastaus.

Nimi Tyyppi Description
errorCode

string

Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.

message

string

Ihmisen luettavissa oleva esitys virheestä.

moreDetails

ErrorResponseDetails[]

Luettelo virheiden lisätiedoista.

relatedResource

ErrorRelatedResource

Virheisiin liittyvät resurssitiedot.

requestId

string

Virheeseen liittyvän pyynnön tunnus.

ErrorResponseDetails

Virheen vastauksen tiedot.

Nimi Tyyppi Description
errorCode

string

Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.

message

string

Ihmisen luettavissa oleva esitys virheestä.

relatedResource

ErrorRelatedResource

Virheisiin liittyvät resurssitiedot.

GitStatusResponse

Sisältää tilavastauksen.

Nimi Tyyppi Description
changes

ItemChange[]

Luettelo etä git-etäympäristön muutoksista, joita ei käytetä kyseisessä työtilassa, sekä työtilan muutokset, joita ei sovelleta etänä Git-etäyhteydessä.

remoteCommitHash

string

Täysi SHA-etähallintatoiminnon hajautus

workspaceHead

string

Koko SHA-hajautustoiminto, johon työtila on synkronoitu.

ItemChange

Sisältää kohteen muutostiedot.

Nimi Tyyppi Description
conflictType

ConflictType

Kun muutoksia on sekä työtilan puolella että etä-Git-puolella.

itemMetadata

ItemMetadata

Kohteen metatiedot.

remoteChange

ChangeType

Vaihda etä-Git-puolella.

workspaceChange

ChangeType

Muuta työtilan puolella.

ItemIdentifier

Sisältää kohteen tunnuksen. Vähintään yksi ominaisuuksista on määritettävä.

Nimi Tyyppi Description
logicalId

string (uuid)

Kohteen looginen tunnus. Jos looginen tunnus ei ole käytettävissä, koska kohdetta ei ole vielä lisätty työtilaan, voit käyttää objektitunnusta.

objectId

string (uuid)

Kohteen objektitunnus. Jos objektitunnus ei ole käytettävissä, koska kohde on poistettu työtilasta, voit käyttää loogista tunnusta.

ItemMetadata

Sisältää kohteen metatiedot.

Nimi Tyyppi Description
displayName

string

Kohteen näyttönimi. Suosii työtilakohteen näyttönimeä, jos se on olemassa, muussa tapauksessa displayName käyttää etäkohteen näyttönimeä.

itemIdentifier

ItemIdentifier

Kohteen tunnus.

itemType

ItemType

Kohdetyyppi.

ItemType

Kohteen tyyppi. Muita kohdetyyppejä voidaan lisätä ajan kuluessa.

Arvo Description
Dashboard

Power BI -koontinäyttö.

Report

PowerBI -raportti.

SemanticModel

PowerBI:n semanttinen malli.

PaginatedReport

PowerBI:n sivutettu raportti.

Datamart

PowerBI -tietomarssi.

Lakehouse

Tämä on lakehouse.

Eventhouse

Tapahtumatalo.

Environment

Ympäristö.

KQLDatabase

KQL-tietokanta.

KQLQueryset

KQL-kyselyjoukko.

KQLDashboard

KQL-koontinäyttö.

DataPipeline

Tietoputki.

Notebook

Muistikirja.

SparkJobDefinition

Spark-työn määritelmä.

MLExperiment

Koneoppimisen kokeilu.

MLModel

Koneoppimismalli.

Warehouse

Varasto.

Eventstream

Tapahtumavirta.

SQLEndpoint

SQL-päätepiste.

MirroredWarehouse

Peilattu varasto.

MirroredDatabase

Peilattu tietokanta.

Reflex

Refleksi.

GraphQLApi

Ohjelmointirajapinta GraphQL-kohteelle.

MountedDataFactory

A MountedDataFactory.

SQLDatabase

A SQLDatabase.

CopyJob

Kopiotyö.

VariableLibrary

MuuttujaLibrary.

Dataflow

Tietovuo.

ApacheAirflowJob

An ApacheAirflowJob.

WarehouseSnapshot

Varastotilannevedos.

DigitalTwinBuilder

A DigitalTwinBuilder.

DigitalTwinBuilderFlow

Digital Twin Builder -työnkulku.

MirroredAzureDatabricksCatalog

Peilattu Azure Databricks -luettelo.

Map

Kartta.

AnomalyDetector

Poikkeamien tunnistaminen.

UserDataFunction

Käyttäjätietofunktio.

GraphModel

A GraphModel.

GraphQuerySet

A Graph QuerySet.

SnowflakeDatabase

Snowflake-tietokannalla tallennetaan Snowflake-tililtä luodut Iceberg-taulukot.

OperationsAgent

A OperationsAgent.

CosmosDBDatabase

Cosmos DB -tietokanta.