Git - Update From Git

Service:: Core

Version d'API:: v1

Met à jour l’espace de travail avec des validations envoyées à la branche connectée.
Cette API prend en charge opérations longues (LRO).

Pour utiliser cette API, les informations d’identification Git de l’appelant doivent être configurées à l’aide de l’API Mettre à jour mes informations d’identification Git . Vous pouvez utiliser l’API Obtenir mes informations d’identification Git pour vérifier la configuration des informations d’identification Git.

La mise à jour affecte uniquement les éléments de l’espace de travail qui ont été modifiés dans ces validations. Si elle est appelée après les API Connexion et Initialiser la connexion , elle effectue une mise à jour complète de l’ensemble de l’espace de travail.

Autorisations

L’appelant doit avoir un contributeur ou un rôle d’espace de travail supérieur.

Étendues déléguées requises

Workspace.GitUpdate.All

Identités prises en charge par Microsoft Entra

Cette API prend en charge les identités Microsoft répertoriées dans cette section.

Identité	Soutien
Utilisateur	Oui
principal de service et identités managées	Uniquement pris en charge lorsque tous les éléments impliqués dans l’opération prennent en charge les principaux de service

Interface

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/git/updateFromGit

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
workspaceId	path	True	string (uuid)	Identifiant de l’espace de travail.

Corps de la demande

Nom	Obligatoire	Type	Description
remoteCommitHash	True	string	Hachage de validation SHA complet distant.
conflictResolution		WorkspaceConflictResolution	Résolution de conflit à utiliser dans la mise à jour à partir de l’opération Git. Si les éléments sont en conflit et qu’une résolution de conflit n’est pas spécifiée, l’opération de mise à jour ne démarre pas.
options		UpdateOptions	Options à utiliser dans la mise à jour à partir de l’opération Git
workspaceHead		string	Hachage SHA complet auquel l’espace de travail est synchronisé. Cette valeur peut être null uniquement après l’initialisation de la connexion. Dans d’autres cas, le système vérifie que la valeur donnée est alignée sur la tête connue du système.

Réponses

Nom	Type	Description
200 OK		La demande s’est terminée avec succès.
202 Accepted		Demande acceptée, mise à jour de Git en cours. En-têtes Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Codes d’erreur courants : WorkspaceNotConnectedToGit : l’espace de travail n’est pas connecté à Git. WorkspaceHasNoCapacityAssigned : aucune capacité affectée à l’espace de travail. WorkspaceHeadMismatch : la tête dans la requête ne correspond pas à la tête du système. WorkspacePreviousOperationInProgress : l’opération précédente est toujours en cours. MissingDependency : une dépendance est manquante dans l’opération de mise à jour. PotentialDuplicateDisplayNameAndType : l’opération de mise à jour crée un nom d’affichage et un type d’affichage dupliqués. DependencyDeletionFailed : l’opération de mise à jour supprime la dépendance matérielle. InsufficientPrivileges : l’appelant ne dispose pas des autorisations d’espace de travail suffisantes. PrincipalTypeNotSupported : le type d’identité de l’appelant n’est pas pris en charge.

Nom

Type

Description

200 OK

La demande s’est terminée avec succès.

202 Accepted

Demande acceptée, mise à jour de Git en cours.

En-têtes

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

Other Status Codes

ErrorResponse

Codes d’erreur courants :

WorkspaceNotConnectedToGit : l’espace de travail n’est pas connecté à Git.
WorkspaceHasNoCapacityAssigned : aucune capacité affectée à l’espace de travail.
WorkspaceHeadMismatch : la tête dans la requête ne correspond pas à la tête du système.
WorkspacePreviousOperationInProgress : l’opération précédente est toujours en cours.
MissingDependency : une dépendance est manquante dans l’opération de mise à jour.
PotentialDuplicateDisplayNameAndType : l’opération de mise à jour crée un nom d’affichage et un type d’affichage dupliqués.
DependencyDeletionFailed : l’opération de mise à jour supprime la dépendance matérielle.
InsufficientPrivileges : l’appelant ne dispose pas des autorisations d’espace de travail suffisantes.
PrincipalTypeNotSupported : le type d’identité de l’appelant n’est pas pris en charge.

Exemples

Update a workspace using data from a Git example

Exemple de requête

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/1565e6a3-c020-4c0c-dda7-92bafe99eec5/git/updateFromGit

{
  "workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "remoteCommitHash": "7d03b2918bf6aa62f96d0a4307293f3853201705",
  "conflictResolution": {
    "conflictResolutionType": "Workspace",
    "conflictResolutionPolicy": "PreferWorkspace"
  },
  "options": {
    "allowOverrideItems": true
  }
}

Exemple de réponse

Code d’état:: 200

Code d’état:: 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

Définitions

Nom	Description
ConflictResolutionPolicy	Stratégie de résolution des conflits. Des stratégies de résolution de conflit supplémentaires peuvent être ajoutées au fil du temps.
ConflictResolutionType	Type de résolution de conflit. Des types de résolution de conflit supplémentaires peuvent être ajoutés au fil du temps.
ErrorRelatedResource	Objet de détails de ressource associé à l’erreur.
ErrorResponse	Réponse d’erreur.
ErrorResponseDetails	Détails de la réponse d’erreur.
UpdateFromGitRequest	Contient la mise à jour à partir des données de requête Git.
UpdateOptions	Contient les options activées pour la mise à jour à partir de Git.
WorkspaceConflictResolution	Données de résolution de conflit de base.

ConflictResolutionPolicy

Énumération

Stratégie de résolution des conflits. Des stratégies de résolution de conflit supplémentaires peuvent être ajoutées au fil du temps.

Valeur	Description
PreferRemote	Préférez le contenu côté Git distant.
PreferWorkspace	Préférer le contenu côté espace de travail.

ConflictResolutionType

Énumération

Type de résolution de conflit. Des types de résolution de conflit supplémentaires peuvent être ajoutés au fil du temps.

Valeur	Description
Workspace	Résolution des conflits représentant le niveau de l’espace de travail.

ErrorRelatedResource

Object

Objet de détails de ressource associé à l’erreur.

Nom	Type	Description
resourceId	string	ID de ressource impliqué dans l’erreur.
resourceType	string	Type de la ressource impliquée dans l’erreur.

ErrorResponse

Object

Réponse d’erreur.

Nom	Type	Description
errorCode	string	Identificateur spécifique qui fournit des informations sur une condition d’erreur, ce qui permet une communication standardisée entre notre service et ses utilisateurs.
message	string	Représentation lisible humaine de l’erreur.
moreDetails	ErrorResponseDetails[]	Liste des détails d’erreur supplémentaires.
relatedResource	ErrorRelatedResource	Détails de la ressource associée à l’erreur.
requestId	string	ID de la demande associée à l’erreur.

ErrorResponseDetails

Object

Détails de la réponse d’erreur.

Nom	Type	Description
errorCode	string	Identificateur spécifique qui fournit des informations sur une condition d’erreur, ce qui permet une communication standardisée entre notre service et ses utilisateurs.
message	string	Représentation lisible humaine de l’erreur.
relatedResource	ErrorRelatedResource	Détails de la ressource associée à l’erreur.

UpdateFromGitRequest

Object

Contient la mise à jour à partir des données de requête Git.

Nom	Type	Description
conflictResolution	WorkspaceConflictResolution	Résolution de conflit à utiliser dans la mise à jour à partir de l’opération Git. Si les éléments sont en conflit et qu’une résolution de conflit n’est pas spécifiée, l’opération de mise à jour ne démarre pas.
options	UpdateOptions	Options à utiliser dans la mise à jour à partir de l’opération Git
remoteCommitHash	string	Hachage de validation SHA complet distant.
workspaceHead	string	Hachage SHA complet auquel l’espace de travail est synchronisé. Cette valeur peut être null uniquement après l’initialisation de la connexion. Dans d’autres cas, le système vérifie que la valeur donnée est alignée sur la tête connue du système.

UpdateOptions

Object

Contient les options activées pour la mise à jour à partir de Git.

Nom	Type	Description
allowOverrideItems	boolean	Consentement de l’utilisateur pour remplacer les éléments entrants pendant la mise à jour à partir du processus Git. Lorsque les éléments entrants sont présents et que les éléments de remplacement autorisés ne sont pas spécifiés ou sont fournis comme faux, l’opération de mise à jour ne démarre pas. La valeur par défaut est False.

WorkspaceConflictResolution

Object

Données de résolution de conflit de base.

Nom	Type	Description
conflictResolutionPolicy	ConflictResolutionPolicy	Stratégie de résolution des conflits. Des stratégies de résolution de conflit supplémentaires peuvent être ajoutées au fil du temps.
conflictResolutionType	ConflictResolutionType	Type de résolution de conflit. Des types de résolution de conflit supplémentaires peuvent être ajoutés au fil du temps.

Partager via

Git - Update From Git

Autorisations

Étendues déléguées requises

Identités prises en charge par Microsoft Entra

Interface

Paramètres URI

Corps de la demande

Réponses

Exemples

Update a workspace using data from a Git example

Exemple de requête

Exemple de réponse

Définitions

ConflictResolutionPolicy

ConflictResolutionType

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

UpdateFromGitRequest

UpdateOptions

WorkspaceConflictResolution