Zdieľať cez

Git - Update My Git Credentials

Služba:
Core
Verzia rozhrania API:
v1

Aktualizuje podrobnosti konfigurácie poverení Git používateľa.
Každý používateľ v pracovnom priestore má vlastné nakonfigurované poverenia Git. Ak chcete získať konfiguráciu poverení Git, môžete použiť rozhranie Get My Git Credentials API.

Ak chcete získať ID pripojenia, pozrite si tému Automatizácia integrácie systému Git.

Povolenia

Volajúci musí mať rolu prispievateľa alebo vyššieho pracovného priestoru.

V prípade nakonfigurovaných poverení Git pripojenia musí mať volajúci povolenie na pripojenie.

Povinné delegované rozsahy

Workspace.ReadWrite.All

Obmedzenia

Keď používate zdroj automatických poverení, toto rozhranie API je zablokované pre poskytovateľa služby GitHub a pre objekt služby.

Podporované identity v aplikácii Microsoft Entra

Toto rozhranie API podporuje identity Microsoft uvedené v tejto časti.

Identita Podpora
Používateľ Áno
Objekt služby a spravované identity Podporované iba v prípadoch, keď je zdroj NakonfigurovanýPripojenie alebo Žiadne

Rozhranie

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

Parametre URI

Name V Povinné Typ Description
workspaceId
 path True

string (uuid)

ID pracovného priestoru.

Text požiadavky

Textom požiadavky môže byť niektorá z týchto možností:

Name Description
UpdateGitCredentialsToAutomaticRequest

Obsahuje údaje požiadavky na automatickú aktualizáciu poverení Git.
UpdateGitCredentialsToConfiguredConnectionRequest

Obsahuje údaje požiadavky na aktualizáciu poverení Git na nakonfigurované pripojenie.
UpdateGitCredentialsToNoneRequest

Obsahuje údaje požiadavky na aktualizáciu poverení Git na žiadne.

UpdateGitCredentialsToAutomaticRequest

Obsahuje údaje požiadavky na automatickú aktualizáciu poverení Git.

Name Povinné Typ Description
source True string:

Automatic

Zdroj poverení systému Git.

UpdateGitCredentialsToConfiguredConnectionRequest

Obsahuje údaje požiadavky na aktualizáciu poverení Git na nakonfigurované pripojenie.

Name Povinné Typ Description
connectionId True

string (uuid)

ID objektu pripojenia.
source True string:

ConfiguredConnection

Zdroj poverení systému Git.

UpdateGitCredentialsToNoneRequest

Obsahuje údaje požiadavky na aktualizáciu poverení Git na žiadne.

Name Povinné Typ Description
source True string:

None

Zdroj poverení systému Git.

Odpovede

Name Typ Description
200 OK GitCredentialsConfigurationResponse:

Požiadavka sa úspešne dokončila.
429 Too Many Requests

ErrorResponse

Prekročil sa limit rýchlosti služby. Server vráti hlavičku Retry-After v sekundách, ako dlho musí klient počkať, kým odošle ďalšie požiadavky.

Hlavičky

Retry-After: integer
Other Status Codes

ErrorResponse

Bežné kódy chýb:

  • UnknownError – vyskytla sa chyba.

  • InsufficientPrivileges – volajúci má nedostatočné povolenia pracovného priestoru.

  • WorkspaceNotConnectedToGit – pracovný priestor nie je pripojený k službe git.

  • ConnectionNotFound – zadané pripojenie sa nenašlo.

  • ConnectionMismatch – pripojenie sa nezhoduje s podrobnosťami poskytovateľa systému Git.

  • PrincipalTypeNotSupported – Typ identity volajúceho nie je podporovaný.

Príklady

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

Vzorová požiadavka

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

{
  "source": "Automatic"
}

Vzorová odpoveď

Kód stavu:
200 
{
  "source": "Automatic"
}

Update user's Git credentials to ConfiguredConnection example

Vzorová požiadavka

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

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

Vzorová odpoveď

Kód stavu:
200 
{
  "source": "ConfiguredConnection",
  "connectionId": "3f2504e0-4f89-11d3-9a0c-0305e82c3301"
}

Update user's Git credentials to None example

Vzorová požiadavka

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

{
  "source": "None"
}

Vzorová odpoveď

Kód stavu:
200 
{
  "source": "None"
}

Definície

Name Description
AutomaticGitCredentialsResponse

Automatické poverenia Git.
ConfiguredConnectionGitCredentialsResponse

Nakonfigurované prihlasovacie údaje Git pre pripojenie.
ErrorRelatedResource

Objekt s podrobnosťami o zdroji súvisiacej s chybou.
ErrorResponse

Odpoveď na chybu.
ErrorResponseDetails

Podrobnosti o chybovej odpovedi.
GitCredentialsSource

Zdroj poverení systému Git. Ďalšie zdroje poverení systému Git je možné pridať v priebehu času.
NoneGitCredentialsResponse

Nenakonfigurované poverenia Git.
UpdateGitCredentialsToAutomaticRequest

Obsahuje údaje požiadavky na automatickú aktualizáciu poverení Git.
UpdateGitCredentialsToConfiguredConnectionRequest

Obsahuje údaje požiadavky na aktualizáciu poverení Git na nakonfigurované pripojenie.
UpdateGitCredentialsToNoneRequest

Obsahuje údaje požiadavky na aktualizáciu poverení Git na žiadne.

AutomaticGitCredentialsResponse

Object

Automatické poverenia Git.

Name Typ Description
source string:

Automatic

Zdroj poverení systému Git.

ConfiguredConnectionGitCredentialsResponse

Object

Nakonfigurované prihlasovacie údaje Git pre pripojenie.

Name Typ Description
connectionId

string (uuid)

ID objektu pripojenia.
source string:

ConfiguredConnection

Zdroj poverení systému Git.

ErrorRelatedResource

Object

Objekt s podrobnosťami o zdroji súvisiacej s chybou.

Name Typ Description
resourceId

string

ID prostriedku, ktoré je súčasťou chyby.
resourceType

string

Typ prostriedku, ktorý je zapojený do chyby.

ErrorResponse

Object

Odpoveď na chybu.

Name Typ Description
errorCode

string

Konkrétny identifikátor, ktorý poskytuje informácie o chybovej podmienke a umožňuje štandardizovanú komunikáciu medzi našou službou a používateľmi.
message

string

Zobrazenie chyby čitateľné ľuďmi.
moreDetails

ErrorResponseDetails[]

Zoznam ďalších podrobností o chybe.
relatedResource

ErrorRelatedResource

Podrobnosti o zdrojoch súvisiacich s chybou.
requestId

string (uuid)

ID požiadavky súvisiacej s chybou.

ErrorResponseDetails

Object

Podrobnosti o chybovej odpovedi.

Name Typ Description
errorCode

string

Konkrétny identifikátor, ktorý poskytuje informácie o chybovej podmienke a umožňuje štandardizovanú komunikáciu medzi našou službou a používateľmi.
message

string

Zobrazenie chyby čitateľné ľuďmi.
relatedResource

ErrorRelatedResource

Podrobnosti o zdrojoch súvisiacich s chybou.

GitCredentialsSource

Enumerácia

Zdroj poverení systému Git. Ďalšie zdroje poverení systému Git je možné pridať v priebehu času.

Hodnota Description
ConfiguredConnection

Poverenia Git sa získavajú prostredníctvom nakonfigurovaného pripojenia.
Automatic

Poverenia Gitu systém automaticky získa s použitím predvolených poverení, ak sú k dispozícii.
None

Prihlasovacie údaje Git nie sú nakonfigurované.

NoneGitCredentialsResponse

Object

Nenakonfigurované poverenia Git.

Name Typ Description
source string:

None

Zdroj poverení systému Git.

UpdateGitCredentialsToAutomaticRequest

Object

Obsahuje údaje požiadavky na automatickú aktualizáciu poverení Git.

Name Typ Description
source string:

Automatic

Zdroj poverení systému Git.

UpdateGitCredentialsToConfiguredConnectionRequest

Object

Obsahuje údaje požiadavky na aktualizáciu poverení Git na nakonfigurované pripojenie.

Name Typ Description
connectionId

string (uuid)

ID objektu pripojenia.
source string:

ConfiguredConnection

Zdroj poverení systému Git.

UpdateGitCredentialsToNoneRequest

Object

Obsahuje údaje požiadavky na aktualizáciu poverení Git na žiadne.

Name Typ Description
source string:

None

Zdroj poverení systému Git.