Git - Get Status

Referencia

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 la última área de trabajo y la sincronización remota de la rama. Si se modificaron ambas ubicaciones, la API marca un conflicto.

Permisos

El autor de la llamada debe tener un rol de colaborador o 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.

Identidad	Apoyo
Usuario	Sí
de entidad de servicio y identidades administradas	No

Interfaz

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.

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.

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
Conflict	Hay diferentes cambios en el elemento del área de trabajo y en Git remoto.
None	No hay ningún cambio en el elemento.
SameChanges	Hay cambios idénticos en el elemento del área de trabajo y en Git remoto.

ErrorRelatedResource

Object

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

Object

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

Object

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

Object

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

Object

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

Object

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

Object

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.
DataPipeline	Una canalización de datos.
Datamart	Datamart de PowerBI.
Environment	Un entorno.
Eventhouse	Un centro de eventos.
Eventstream	Una secuencia de eventos.
GraphQLApi	Una API para el elemento GraphQL.
KQLDashboard	Un panel de KQL.
KQLDatabase	Una base de datos KQL.
KQLQueryset	Un conjunto de consultas KQL.
Lakehouse	Una casa de lago.
MLExperiment	Un experimento de aprendizaje automático.
MLModel	Un modelo de aprendizaje automático.
MirroredDatabase	Una base de datos reflejada.
MirroredWarehouse	Un almacén reflejado.
MountedDataFactory	A MountedDataFactory.
Notebook	Un cuaderno.
PaginatedReport	Informe paginado de PowerBI.
Reflex	Un reflejo.
Report	Informe de PowerBI.
SQLDatabase	A SQLDatabase.
SQLEndpoint	Un punto de conexión de SQL.
SemanticModel	Modelo semántico de PowerBI.
SparkJobDefinition	Una definición de trabajo de Spark.
Warehouse	Un almacén.

Compartir a través de

Git - Get Status

Permisos

Ámbitos delegados necesarios

Identidades admitidas de Microsoft Entra

Interfaz

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

Recursos adicionales