Partager via

Git - Update My Git Credentials

Service:
Core
Version d'API:
v1

Met à jour les détails de configuration des informations d’identification Git de l’utilisateur.
Chaque utilisateur de l’espace de travail possède ses propres informations d’identification Git configurées. Vous pouvez utiliser l’API Obtenir mes informations d’identification Git pour obtenir la configuration des informations d’identification Git.

Pour obtenir l’ID de connexion, consultez Automatiser l’intégration git.

Autorisations

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

Pour les informations d’identification Git de connexion configurées, l’appelant doit disposer de l’autorisation pour la connexion.

Étendues déléguées requises

Workspace.ReadWrite.All

Limites

Lorsque vous utilisez la source d’informations d’identification automatiques, cette API est bloquée pour le fournisseur GitHub et pour le principal de service.

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 Pris en charge uniquement lorsque la source est ConfigureConnection ou None

Interface

PATCH https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/git/myGitCredentials

Paramètres URI

Nom Dans Obligatoire Type Description
workspaceId
 path True

string (uuid)

Identifiant de l’espace de travail.

Corps de la demande

Le corps de la requête peut être l’un des suivants :

Nom Description
UpdateGitCredentialsToAutomaticRequest

Contient les données de requête pour mettre à jour les informations d’identification Git en automatique.
UpdateGitCredentialsToConfiguredConnectionRequest

Contient les données de demande pour mettre à jour les informations d’identification Git pour configurer la connexion.
UpdateGitCredentialsToNoneRequest

Contient les données de demande pour mettre à jour les informations d’identification Git en aucun.

UpdateGitCredentialsToAutomaticRequest

Contient les données de requête pour mettre à jour les informations d’identification Git en automatique.

Nom Obligatoire Type Description
source True string:

Automatic

Source des informations d’identification Git.

UpdateGitCredentialsToConfiguredConnectionRequest

Contient les données de demande pour mettre à jour les informations d’identification Git pour configurer la connexion.

Nom Obligatoire Type Description
connectionId True

string (uuid)

ID d’objet de la connexion.
source True string:

ConfiguredConnection

Source des informations d’identification Git.

UpdateGitCredentialsToNoneRequest

Contient les données de demande pour mettre à jour les informations d’identification Git en aucun.

Nom Obligatoire Type Description
source True string:

None

Source des informations d’identification Git.

Réponses

Nom Type Description
200 OK GitCredentialsConfigurationResponse:

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

ErrorResponse

Codes d’erreur courants :

  • UnknownError : une erreur s’est produite.

  • InsufficientPrivileges : l’appelant dispose d’autorisations d’espace de travail insuffisantes.

  • WorkspaceNotConnectedToGit : l’espace de travail n’est pas connecté à Git.

  • ConnectionNotFound : la connexion spécifiée est introuvable.

  • ConnectionMismatch : la connexion ne correspond pas aux détails du fournisseur Git.

  • PrincipalTypeNotSupported : le type d’identité de l’appelant n’est pas pris en charge.

Exemples

Update user's Git credentials to Automatic example
Update user's Git credentials to ConfiguredConnection example
Update user's Git credentials to None example

Update user's Git credentials to Automatic example

Exemple de requête

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

{
  "source": "Automatic"
}

Exemple de réponse

Code d’état:
200 
{
  "source": "Automatic"
}

Update user's Git credentials to ConfiguredConnection example

Exemple de requête

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

{
  "source": "ConfiguredConnection",
  "connectionId": "3f2504e0-4f89-11d3-9a0c-0305e82c3301"
}

Exemple de réponse

Code d’état:
200 
{
  "source": "ConfiguredConnection",
  "connectionId": "3f2504e0-4f89-11d3-9a0c-0305e82c3301"
}

Update user's Git credentials to None example

Exemple de requête

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

{
  "source": "None"
}

Exemple de réponse

Code d’état:
200 
{
  "source": "None"
}

Définitions

Nom Description
AutomaticGitCredentialsResponse

Informations d’identification Git automatiques.
ConfiguredConnectionGitCredentialsResponse

Informations d’identification Git de connexion configurées.
ErrorRelatedResource

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

Réponse d’erreur.
ErrorResponseDetails

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

Source des informations d’identification Git. Des sources d’informations d’identification Git supplémentaires peuvent être ajoutées au fil du temps.
NoneGitCredentialsResponse

Informations d’identification Git non configurées.
UpdateGitCredentialsToAutomaticRequest

Contient les données de requête pour mettre à jour les informations d’identification Git en automatique.
UpdateGitCredentialsToConfiguredConnectionRequest

Contient les données de demande pour mettre à jour les informations d’identification Git pour configurer la connexion.
UpdateGitCredentialsToNoneRequest

Contient les données de demande pour mettre à jour les informations d’identification Git en aucun.

AutomaticGitCredentialsResponse

Object

Informations d’identification Git automatiques.

Nom Type Description
source string:

Automatic

Source des informations d’identification Git.

ConfiguredConnectionGitCredentialsResponse

Object

Informations d’identification Git de connexion configurées.

Nom Type Description
connectionId

string (uuid)

ID d’objet de la connexion.
source string:

ConfiguredConnection

Source des informations d’identification Git.

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.

GitCredentialsSource

Énumération

Source des informations d’identification Git. Des sources d’informations d’identification Git supplémentaires peuvent être ajoutées au fil du temps.

Valeur Description
ConfiguredConnection

Les informations d’identification Git sont obtenues via une connexion configurée.
Automatic

Les informations d’identification Git sont obtenues automatiquement par le système, à l’aide des informations d’identification par défaut si elles sont disponibles.
None

Les informations d’identification Git ne sont pas configurées.

NoneGitCredentialsResponse

Object

Informations d’identification Git non configurées.

Nom Type Description
source string:

None

Source des informations d’identification Git.

UpdateGitCredentialsToAutomaticRequest

Object

Contient les données de requête pour mettre à jour les informations d’identification Git en automatique.

Nom Type Description
source string:

Automatic

Source des informations d’identification Git.

UpdateGitCredentialsToConfiguredConnectionRequest

Object

Contient les données de demande pour mettre à jour les informations d’identification Git pour configurer la connexion.

Nom Type Description
connectionId

string (uuid)

ID d’objet de la connexion.
source string:

ConfiguredConnection

Source des informations d’identification Git.

UpdateGitCredentialsToNoneRequest

Object

Contient les données de demande pour mettre à jour les informations d’identification Git en aucun.

Nom Type Description
source string:

None

Source des informations d’identification Git.