Git - Get Status

Servicio:: Core

Versión de la API:: v1

Devuelve el Git status de elementos del área de trabajo, que se pueden confirmar en Git.
Esta API admite operaciones de larga duración (LRO).

El estado indica los cambios en los elementos desde el último área de trabajo y la sincronización de rama remota. Si se modificaron los elementos remotos y del área de trabajo, la API marca un conflicto.

Para usar esta API, las credenciales de Git del autor de la llamada deben configurarse mediante Update My Git Credentials API (Actualizar mis credenciales de Git ). Puede usar la API Obtener mis credenciales de Git para comprobar la configuración de credenciales de Git.

Permissions

El autor de la llamada debe tener un rol de colaborador o de área de trabajo superior.

Ámbitos delegados necesarios

Workspace.GitUpdate.All o Workspace.GitCommit.All

Identidades admitidas de Microsoft Entra

Esta API admite las identidades de Microsoft enumeradas en esta sección.

Identity	Support
User	Yes
Entidad de servicio e Identidades administradas	Yes

Interface

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
workspaceId	path	True	string (uuid)	Identificador del área de trabajo.

Respuestas

Nombre	Tipo	Description
200 OK	GitStatusResponse	Solicitud completada correctamente.
202 Accepted		Solicitud aceptada, obtener el estado en curso. Encabezados Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Códigos de error comunes: WorkspaceNotConnectedToGit: el área de trabajo no está conectada a Git. WorkspaceHasNoCapacityAssigned: el área de trabajo no está en capacidad. InsufficientPrivileges: el autor de la llamada no tiene suficientes permisos de área de trabajo. PrincipalTypeNotSupported: no se admite el tipo de identidad llamador.

Nombre

Tipo

Description

200 OK

GitStatusResponse

Solicitud completada correctamente.

202 Accepted

Solicitud aceptada, obtener el estado en curso.

Encabezados

Location: string
x-ms-operation-id: string
Retry-After: integer

Other Status Codes

ErrorResponse

Códigos de error comunes:

WorkspaceNotConnectedToGit: el área de trabajo no está conectada a Git.
WorkspaceHasNoCapacityAssigned: el área de trabajo no está en capacidad.
InsufficientPrivileges: el autor de la llamada no tiene suficientes permisos de área de trabajo.
PrincipalTypeNotSupported: no se admite el tipo de identidad llamador.

Ejemplos

Get status example

Get status no changes example

Get status with conflict example

Get status example

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

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

status code:: 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

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

status code:: 200

{
  "workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "remoteCommitHash": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "changes": []
}

status code:: 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

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

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

status code:: 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

Definiciones

Nombre	Description
ChangeType	Un cambio de un elemento. Se pueden agregar tipos modificados adicionales a lo largo del tiempo.
ConflictType	Un cambio de un elemento tanto en el área de trabajo como en el remoto. Se pueden agregar tipos modificados adicionales a lo largo del tiempo.
ErrorRelatedResource	Objeto de detalles del recurso relacionado con el error.
ErrorResponse	Respuesta de error.
ErrorResponseDetails	Detalles de la respuesta de error.
GitStatusResponse	Contiene la respuesta de estado.
ItemChange	Contiene la información de cambio del elemento.
ItemIdentifier	Contiene el identificador de elemento. Se debe definir al menos una de las propiedades.
ItemMetadata	Contiene los metadatos del elemento.
ItemType	Tipo del elemento. Se pueden agregar tipos de elementos adicionales a lo largo del tiempo.

ChangeType

Enumeración

Un cambio de un elemento. Se pueden agregar tipos modificados adicionales a lo largo del tiempo.

Valor	Description
Added	Un elemento recién creado.
Deleted	Se ha eliminado el elemento.
Modified	Se ha modificado el contenido del elemento.

ConflictType

Enumeración

Un cambio de un elemento tanto en el área de trabajo como en el remoto. Se pueden agregar tipos modificados adicionales a lo largo del tiempo.

Valor	Description
None	No hay ningún cambio en el elemento.
Conflict	Hay diferentes cambios en el elemento del área de trabajo y en Git remoto.
SameChanges	Hay cambios idénticos en el elemento del área de trabajo y en Git remoto.

ErrorRelatedResource

Objeto

Objeto de detalles del recurso relacionado con el error.

Nombre	Tipo	Description
resourceId	string	Identificador de recurso implicado en el error.
resourceType	string	Tipo del recurso implicado en el error.

ErrorResponse

Objeto

Respuesta de error.

Nombre	Tipo	Description
errorCode	string	Identificador específico que proporciona información sobre una condición de error, lo que permite una comunicación estandarizada entre nuestro servicio y sus usuarios.
message	string	Representación legible del error.
moreDetails	ErrorResponseDetails[]	Lista de detalles de error adicionales.
relatedResource	ErrorRelatedResource	Detalles del recurso relacionado con el error.
requestId	string	Identificador de la solicitud asociada al error.

ErrorResponseDetails

Objeto

Detalles de la respuesta de error.

Nombre	Tipo	Description
errorCode	string	Identificador específico que proporciona información sobre una condición de error, lo que permite una comunicación estandarizada entre nuestro servicio y sus usuarios.
message	string	Representación legible del error.
relatedResource	ErrorRelatedResource	Detalles del recurso relacionado con el error.

GitStatusResponse

Objeto

Contiene la respuesta de estado.

Nombre	Tipo	Description
changes	ItemChange[]	Lista de cambios en Git remoto que no se aplican al área de trabajo determinada y cambios en el área de trabajo que no se aplican a Git remoto.
remoteCommitHash	string	Hash de confirmación sha completo remoto.
workspaceHead	string	Hash sha completo al que se sincroniza el área de trabajo.

ItemChange

Objeto

Contiene la información de cambio del elemento.

Nombre	Tipo	Description
conflictType	ConflictType	Cuando hay cambios en el lado del área de trabajo y en el lado remoto de Git.
itemMetadata	ItemMetadata	Metadatos del elemento.
remoteChange	ChangeType	Cambie en el lado remoto de Git.
workspaceChange	ChangeType	Cambie en el lado del área de trabajo.

ItemIdentifier

Objeto

Contiene el identificador de elemento. Se debe definir al menos una de las propiedades.

Nombre	Tipo	Description
logicalId	string (uuid)	Identificador lógico del elemento. Cuando el identificador lógico no está disponible porque el elemento aún no se ha agregado al área de trabajo, puede usar el identificador de objeto.
objectId	string (uuid)	Identificador de objeto del elemento. Cuando el identificador de objeto no está disponible porque el elemento se eliminó del área de trabajo, puede usar el identificador lógico.

ItemMetadata

Objeto

Contiene los metadatos del elemento.

Nombre	Tipo	Description
displayName	string	Nombre para mostrar del elemento. Prefiere el nombre para mostrar del elemento del área de trabajo si existe; de lo contrario, displayName usa el nombre para mostrar del elemento remoto.
itemIdentifier	ItemIdentifier	Identificador del elemento.
itemType	ItemType	Tipo de elemento.

ItemType

Enumeración

Tipo del elemento. Se pueden agregar tipos de elementos adicionales a lo largo del tiempo.

Valor	Description
Dashboard	Panel de PowerBI.
Report	Informe de PowerBI.
SemanticModel	Modelo semántico de PowerBI.
PaginatedReport	Informe paginado de PowerBI.
Datamart	Datamart de PowerBI.
Lakehouse	Una casa de lago.
Eventhouse	Un centro de eventos.
Environment	Un entorno.
KQLDatabase	Una base de datos KQL.
KQLQueryset	Un conjunto de consultas KQL.
KQLDashboard	Un panel de KQL.
DataPipeline	Una canalización de datos.
Notebook	Un cuaderno.
SparkJobDefinition	Una definición de trabajo de Spark.
MLExperiment	Un experimento de aprendizaje automático.
MLModel	Un modelo de aprendizaje automático.
Warehouse	Un almacén.
Eventstream	Una secuencia de eventos.
SQLEndpoint	Un punto de conexión de SQL.
MirroredWarehouse	Un almacén reflejado.
MirroredDatabase	Una base de datos reflejada.
Reflex	Un reflejo.
GraphQLApi	Una API para el elemento GraphQL.
MountedDataFactory	A MountedDataFactory.
SQLDatabase	A SQLDatabase.
CopyJob	Un trabajo de copia.
VariableLibrary	A VariableLibrary.
Dataflow	Flujo de datos.
ApacheAirflowJob	An ApacheAirflowJob.
WarehouseSnapshot	Una instantánea de almacenamiento.
DigitalTwinBuilder	A DigitalTwinBuilder.
DigitalTwinBuilderFlow	Un flujo de Digital Twin Builder.
MirroredAzureDatabricksCatalog	Un catálogo de Azure Databricks reflejado.
Map	Un mapa.
AnomalyDetector	An Anomaly Detector.
UserDataFunction	Una función de datos de usuario.
GraphModel	Un GraphModel.
GraphQuerySet	Un conjunto de consultas de Graph.
SnowflakeDatabase	Una base de datos de Snowflake para almacenar tablas de Cosmos creadas a partir de la cuenta de Snowflake.
OperationsAgent	A OperationsAgent.
CosmosDBDatabase	Una base de datos de Cosmos DB.
Ontology	Una ontología.
EventSchemaSet	An EventSchemaSet.

Compartir a través de

Git - Get Status

Permissions

Ámbitos delegados necesarios

Identidades admitidas de Microsoft Entra

Interface

Parámetros de identificador URI

Respuestas

Ejemplos

Get status example

Solicitud de ejemplo

Respuesta de muestra

Get status no changes example

Solicitud de ejemplo

Respuesta de muestra

Get status with conflict example

Solicitud de ejemplo

Respuesta de muestra

Definiciones

ChangeType

ConflictType

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

GitStatusResponse

ItemChange

ItemIdentifier

ItemMetadata

ItemType