Jaa

Git - Get Status

  • Viite
Palvelu:
Core
Ohjelmointirajapinnan versio:
v1

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

Tila ilmaisee kohteiden muutokset viimeisimmän työtilan ja etähaaran synkronoinnin jälkeen. Jos molempia sijainteja on muokattu, ohjelmointirajapinta merkitsee ristiriidan.

Käyttöoikeudet

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.

Identiteetti Tuki
Käyttäjä Kyllä
palvelun päänimen ja Hallittujen käyttäjätietojen Ei

Rajapinta

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.

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

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

Mallipyyntö

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

Mallivastaus

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

Mallipyyntö

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

Mallivastaus

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

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

Luettelointi

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

Luettelointi

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

Arvo Description
Conflict

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

Kohteeseen ei ole tehty muutoksia.
SameChanges

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

ErrorRelatedResource

Object

Virheeseen liittyvä resurssitieto-objekti.

Nimi Tyyppi Description
resourceId

string

Virheestä liittyvä resurssitunnus.
resourceType

string

Virheestä liittyvän resurssin tyyppi.

ErrorResponse

Object

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

Object

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

Object

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

Object

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

Object

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

Object

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

Luettelointi

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

Arvo Description
Dashboard

Power BI -koontinäyttö.
DataPipeline

Tietoputki.
Datamart

PowerBI -tietomarssi.
Environment

Ympäristö.
Eventhouse

Tapahtumatalo.
Eventstream

Tapahtumavirta.
GraphQLApi

Ohjelmointirajapinta GraphQL-kohteelle.
KQLDashboard

KQL-koontinäyttö.
KQLDatabase

KQL-tietokanta.
KQLQueryset

KQL-kyselyjoukko.
Lakehouse

Tämä on lakehouse.
MLExperiment

Koneoppimisen kokeilu.
MLModel

Koneoppimismalli.
MirroredDatabase

Peilattu tietokanta.
MirroredWarehouse

Peilattu varasto.
MountedDataFactory

A MountedDataFactory.
Notebook

Muistikirja.
PaginatedReport

PowerBI:n sivutettu raportti.
Reflex

Refleksi.
Report

PowerBI -raportti.
SQLDatabase

A SQLDatabase.
SQLEndpoint

SQL-päätepiste.
SemanticModel

PowerBI:n semanttinen malli.
SparkJobDefinition

Spark-työn määritelmä.
Warehouse

Varasto.