Git - Update My Git Credentials

Tjeneste:

Core

API-versjon:

v1

Oppdaterer brukerens konfigurasjonsdetaljer for Git-legitimasjon.
Hver bruker i arbeidsområdet har sin egen konfigurerte Git-legitimasjon. Du kan bruke API-en Hent Min Git-legitimasjon for å få konfigurasjonen av Git-legitimasjonen.

Hvis du vil ha tilkoblings-ID-en, kan du se Automatiser Git-integrasjon.

Tillatelser

Innringeren må ha en bidragsyter eller høyere arbeidsområderolle.

For konfigurert git-legitimasjon for tilkobling må anroperen ha tillatelse til tilkoblingen.

Nødvendige delegerte omfang

Workspace.ReadWrite.All

Begrensninger

Når du bruker automatisk legitimasjonskilde, blokkeres denne API-en for GitHub-leverandøren og for tjenestekontohaver.

Microsoft Entra-støttede identiteter

Denne API-en støtter Microsoft -identiteter oppført i denne delen.

Identitet	Støtte
Bruker	Ja
tjenestekontohaver og administrerte identiteter	Støttes bare når kilden er Konfigurert Tilkobling eller Ingen

Grensesnitt

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

URI-parametere

Navn	I	Obligatorisk	Type	Beskrivelse
workspaceId	path	True	string (uuid)	Arbeidsområde-ID-en.

Brødtekst for forespørsel

Forespørselsteksten kan være ett av følgende:

Navn	Beskrivelse
UpdateGitCredentialsToAutomaticRequest	Inneholder forespørselsdataene for å oppdatere Git-legitimasjonen til automatisk.
UpdateGitCredentialsToConfiguredConnectionRequest	Inneholder forespørselsdataene for å oppdatere Git-legitimasjonen til konfigurert tilkobling.
UpdateGitCredentialsToNoneRequest	Inneholder forespørselsdataene for å oppdatere Git-legitimasjonen til ingen.

UpdateGitCredentialsToAutomaticRequest

Inneholder forespørselsdataene for å oppdatere Git-legitimasjonen til automatisk.

Navn	Obligatorisk	Type	Beskrivelse
source	True	string: Automatic	Git-legitimasjonskilden.

UpdateGitCredentialsToConfiguredConnectionRequest

Inneholder forespørselsdataene for å oppdatere Git-legitimasjonen til konfigurert tilkobling.

Navn	Obligatorisk	Type	Beskrivelse
connectionId	True	string (uuid)	Objekt-ID-en for tilkoblingen.
source	True	string: ConfiguredConnection	Git-legitimasjonskilden.

UpdateGitCredentialsToNoneRequest

Inneholder forespørselsdataene for å oppdatere Git-legitimasjonen til ingen.

Navn	Obligatorisk	Type	Beskrivelse
source	True	string: None	Git-legitimasjonskilden.

Svar

Navn	Type	Beskrivelse
200 OK	GitCredentialsConfigurationResponse: AutomaticGitCredentialsResponse NoneGitCredentialsResponse ConfiguredConnectionGitCredentialsResponse	Forespørselen er fullført.
Other Status Codes	ErrorResponse	Vanlige feilkoder: UnknownError - Det oppstod en feil. InsufficientPrivileges – innringeren har ikke tilstrekkelige arbeidsområdetillatelser. WorkspaceNotConnectedToGit – arbeidsområdet er ikke koblet til git. ConnectionNotFound – Finner ikke den angitte tilkoblingen. ConnectionMismatch – tilkoblingen samsvarer ikke med git-leverandørdetaljene. PrincipalTypeNotSupported – identitetstypen Anroper støttes ikke.

Eksempler

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

Eksempelforespørsel

HTTP

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

{
  "source": "Automatic"
}

Eksempelsvar

Statuskode:

200

{
  "source": "Automatic"
}

Update user's Git credentials to ConfiguredConnection example

Eksempelforespørsel

HTTP

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

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

Eksempelsvar

Statuskode:

200

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

Update user's Git credentials to None example

Eksempelforespørsel

HTTP

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

{
  "source": "None"
}

Eksempelsvar

Statuskode:

200

{
  "source": "None"
}

Definisjoner

Navn	Beskrivelse
AutomaticGitCredentialsResponse	Automatisk Git-legitimasjon.
ConfiguredConnectionGitCredentialsResponse	Konfigurert git-legitimasjon for tilkobling.
ErrorRelatedResource	Objektet for feilrelaterte ressursdetaljer.
ErrorResponse	Feilsvaret.
ErrorResponseDetails	Feilsvardetaljene.
GitCredentialsSource	Git-legitimasjonskilden. Flere git-legitimasjonskilder kan legges til over tid.
NoneGitCredentialsResponse	Ikke konfigurert Git-legitimasjon.
UpdateGitCredentialsToAutomaticRequest	Inneholder forespørselsdataene for å oppdatere Git-legitimasjonen til automatisk.
UpdateGitCredentialsToConfiguredConnectionRequest	Inneholder forespørselsdataene for å oppdatere Git-legitimasjonen til konfigurert tilkobling.
UpdateGitCredentialsToNoneRequest	Inneholder forespørselsdataene for å oppdatere Git-legitimasjonen til ingen.

AutomaticGitCredentialsResponse

Object

Automatisk Git-legitimasjon.

Navn	Type	Beskrivelse
source	string: Automatic	Git-legitimasjonskilden.

ConfiguredConnectionGitCredentialsResponse

Object

Konfigurert git-legitimasjon for tilkobling.

Navn	Type	Beskrivelse
connectionId	string (uuid)	Objekt-ID-en for tilkoblingen.
source	string: ConfiguredConnection	Git-legitimasjonskilden.

ErrorRelatedResource

Object

Objektet for feilrelaterte ressursdetaljer.

Navn	Type	Beskrivelse
resourceId	string	Ressurs-ID-en som er involvert i feilen.
resourceType	string	Typen ressurs som er involvert i feilen.

ErrorResponse

Object

Feilsvaret.

Navn	Type	Beskrivelse
errorCode	string	En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.
message	string	En menneskelig lesbar representasjon av feilen.
moreDetails	ErrorResponseDetails[]	Liste over flere feildetaljer.
relatedResource	ErrorRelatedResource	Feilrelaterte ressursdetaljer.
requestId	string	ID for forespørselen som er knyttet til feilen.

ErrorResponseDetails

Object

Feilsvardetaljene.

Navn	Type	Beskrivelse
errorCode	string	En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.
message	string	En menneskelig lesbar representasjon av feilen.
relatedResource	ErrorRelatedResource	Feilrelaterte ressursdetaljer.

GitCredentialsSource

Opplisting

Git-legitimasjonskilden. Flere git-legitimasjonskilder kan legges til over tid.

Verdi	Beskrivelse
ConfiguredConnection	Git-legitimasjonen hentes via en konfigurert tilkobling.
Automatic	Git-legitimasjonen hentes automatisk av systemet ved hjelp av standardlegitimasjon hvis tilgjengelig.
None	Git-legitimasjonen er ikke konfigurert.

NoneGitCredentialsResponse

Object

Ikke konfigurert Git-legitimasjon.

Navn	Type	Beskrivelse
source	string: None	Git-legitimasjonskilden.

UpdateGitCredentialsToAutomaticRequest

Object

Inneholder forespørselsdataene for å oppdatere Git-legitimasjonen til automatisk.

Navn	Type	Beskrivelse
source	string: Automatic	Git-legitimasjonskilden.

UpdateGitCredentialsToConfiguredConnectionRequest

Object

Inneholder forespørselsdataene for å oppdatere Git-legitimasjonen til konfigurert tilkobling.

Navn	Type	Beskrivelse
connectionId	string (uuid)	Objekt-ID-en for tilkoblingen.
source	string: ConfiguredConnection	Git-legitimasjonskilden.

UpdateGitCredentialsToNoneRequest

Object

Inneholder forespørselsdataene for å oppdatere Git-legitimasjonen til ingen.

Navn	Type	Beskrivelse
source	string: None	Git-legitimasjonskilden.