Git - Update My Git Credentials

Service:

Core

API-versie:

v1

Hiermee werkt u de configuratiegegevens van de Git-referenties van de gebruiker bij.
Elke gebruiker in de werkruimte heeft zijn eigen geconfigureerde Git-referenties. U kunt de API Mijn Git-referenties ophalen gebruiken om de configuratie van Git-referenties op te halen.

Zie Git-integratie automatiseren om de verbindings-id op te halen.

Machtigingen

De aanroeper moet een inzender hebben of een hogere werkruimterol.

Voor geconfigureerde Git-referenties voor de verbinding moet de aanroeper gemachtigd zijn voor de verbinding.

Vereiste gedelegeerde bereiken

Workspace.ReadWrite.All

Door Microsoft Entra ondersteunde identiteiten

Deze API ondersteunt de Microsoft -identiteiten vermeld in deze sectie.

Identiteit	Ondersteuning
Gebruiker	Ja
serviceprincipal en beheerde identiteiten	Alleen ondersteund wanneer de Git-provider GitHub is

gebruikersinterface

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

URI-parameters

Name	In	Vereist	Type	Description
workspaceId	path	True	string (uuid)	De werkruimte-id.

Aanvraagbody

De aanvraagtekst kan een van de volgende zijn:

Name	Description
UpdateGitCredentialsToAutomaticRequest	Bevat de aanvraaggegevens om de Git-referenties automatisch bij te werken.
UpdateGitCredentialsToConfiguredConnectionRequest	Bevat de aanvraaggegevens voor het bijwerken van de Git-referenties voor de geconfigureerde verbinding.
UpdateGitCredentialsToNoneRequest	Bevat de aanvraaggegevens voor het bijwerken van de Git-referenties naar geen.

UpdateGitCredentialsToAutomaticRequest

Bevat de aanvraaggegevens om de Git-referenties automatisch bij te werken.

Name	Vereist	Type	Description
source	True	string: Automatic	De Git-referentiebron.

UpdateGitCredentialsToConfiguredConnectionRequest

Bevat de aanvraaggegevens voor het bijwerken van de Git-referenties voor de geconfigureerde verbinding.

Name	Vereist	Type	Description
connectionId	True	string (uuid)	De object-id van de verbinding.
source	True	string: ConfiguredConnection	De Git-referentiebron.

UpdateGitCredentialsToNoneRequest

Bevat de aanvraaggegevens voor het bijwerken van de Git-referenties naar geen.

Name	Vereist	Type	Description
source	True	string: None	De Git-referentiebron.

Antwoorden

Name	Type	Description
200 OK	GitCredentialsConfigurationResponse: AutomaticGitCredentialsResponse NoneGitCredentialsResponse ConfiguredConnectionGitCredentialsResponse	De aanvraag is voltooid.
Other Status Codes	ErrorResponse	Veelvoorkomende foutcodes: UnknownError: er is een fout opgetreden. InsufficientPrivileges - Aanroeper heeft onvoldoende werkruimtemachtigingen. WorkspaceNotConnectedToGit - Werkruimte is niet verbonden met Git. ConnectionNotFound: de opgegeven verbinding is niet gevonden. ConnectionMismatch: de verbinding komt niet overeen met de details van de Git-provider. PrincipalTypeNotSupported - Identiteitstype beller wordt niet ondersteund.

Voorbeelden

Update user's Git credentials to ConfiguredConnection example

Update user's Git credentials to None example

Update user's Git credentials to ConfiguredConnection example

Voorbeeldaanvraag

HTTP

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

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

Voorbeeldrespons

Statuscode:

200

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

Update user's Git credentials to None example

Voorbeeldaanvraag

HTTP

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

{
  "source": "None"
}

Voorbeeldrespons

Statuscode:

200

{
  "source": "None"
}

Definities

Name	Description
AutomaticGitCredentialsResponse	Automatische Git-referenties.
ConfiguredConnectionGitCredentialsResponse	Geconfigureerde Git-referenties voor verbinding.
ErrorRelatedResource	Het foutgerelateerde resourcedetailsobject.
ErrorResponse	Het foutbericht.
ErrorResponseDetails	De details van het foutbericht.
GitCredentialsSource	De Git-referentiebron. Er kunnen na verloop van tijd extra Git-referentiesbronnen worden toegevoegd.
NoneGitCredentialsResponse	Niet geconfigureerde Git-referenties.
UpdateGitCredentialsToAutomaticRequest	Bevat de aanvraaggegevens om de Git-referenties automatisch bij te werken.
UpdateGitCredentialsToConfiguredConnectionRequest	Bevat de aanvraaggegevens voor het bijwerken van de Git-referenties voor de geconfigureerde verbinding.
UpdateGitCredentialsToNoneRequest	Bevat de aanvraaggegevens voor het bijwerken van de Git-referenties naar geen.

AutomaticGitCredentialsResponse

Object

Automatische Git-referenties.

Name	Type	Description
source	string: Automatic	De Git-referentiebron.

ConfiguredConnectionGitCredentialsResponse

Object

Geconfigureerde Git-referenties voor verbinding.

Name	Type	Description
connectionId	string (uuid)	De object-id van de verbinding.
source	string: ConfiguredConnection	De Git-referentiebron.

ErrorRelatedResource

Object

Het foutgerelateerde resourcedetailsobject.

Name	Type	Description
resourceId	string	De resource-id die betrokken is bij de fout.
resourceType	string	Het type resource dat betrokken is bij de fout.

ErrorResponse

Object

Het foutbericht.

Name	Type	Description
errorCode	string	Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message	string	Een leesbare weergave van de fout.
moreDetails	ErrorResponseDetails[]	Lijst met aanvullende foutdetails.
relatedResource	ErrorRelatedResource	De foutgerelateerde resourcedetails.
requestId	string	Id van de aanvraag die is gekoppeld aan de fout.

ErrorResponseDetails

Object

De details van het foutbericht.

Name	Type	Description
errorCode	string	Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message	string	Een leesbare weergave van de fout.
relatedResource	ErrorRelatedResource	De foutgerelateerde resourcedetails.

GitCredentialsSource

Inventarisatie

De Git-referentiebron. Er kunnen na verloop van tijd extra Git-referentiesbronnen worden toegevoegd.

Waarde	Description
Automatic	De Git-referenties worden automatisch door het systeem verkregen met behulp van standaardreferenties, indien beschikbaar.
ConfiguredConnection	De Git-referenties worden verkregen via een geconfigureerde verbinding.
None	De Git-referenties zijn niet geconfigureerd.

NoneGitCredentialsResponse

Object

Niet geconfigureerde Git-referenties.

Name	Type	Description
source	string: None	De Git-referentiebron.

UpdateGitCredentialsToAutomaticRequest

Object

Bevat de aanvraaggegevens om de Git-referenties automatisch bij te werken.

Name	Type	Description
source	string: Automatic	De Git-referentiebron.

UpdateGitCredentialsToConfiguredConnectionRequest

Object

Bevat de aanvraaggegevens voor het bijwerken van de Git-referenties voor de geconfigureerde verbinding.

Name	Type	Description
connectionId	string (uuid)	De object-id van de verbinding.
source	string: ConfiguredConnection	De Git-referentiebron.

UpdateGitCredentialsToNoneRequest

Object

Bevat de aanvraaggegevens voor het bijwerken van de Git-referenties naar geen.

Name	Type	Description
source	string: None	De Git-referentiebron.