Sdílet prostřednictvím

Git - Update My Git Credentials

Služba:
Core
Verze rozhraní API:
v1

Aktualizuje podrobnosti konfigurace přihlašovacích údajů gitu uživatele.
Každý uživatel v pracovním prostoru má své vlastní nakonfigurované přihlašovací údaje Gitu. K získání konfigurace přihlašovacích údajů Gitu můžete použít rozhraní GET MY Git Credentials API.

Id připojení získáte v tématu Automatizace integrace Gitu.

Dovolení

Volající musí mít roli přispěvatele nebo vyšší roli pracovního prostoru.

Pro nakonfigurované přihlašovací údaje Gitu pro připojení musí volající mít oprávnění pro připojení.

Požadované delegovaná rozsahy

Workspace.ReadWrite.All

Omezení

Při použití automatického zdroje přihlašovacích údajů se toto rozhraní API zablokuje pro poskytovatele GitHubu a pro instanční objekt.

Podporované identity Microsoft Entra

Toto rozhraní API podporuje identity Microsoft uvedené v této části.

Identita Podpora
Uživatel Ano
Hlavní služba a Spravované identity Podporováno pouze v případech, kdy je zdroj nakonfigurovánoConnection nebo None

Rozhraní

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
workspaceId
 path True

string (uuid)

ID pracovního prostoru.

Text požadavku

Text žádosti může tvořit:

Name Description
UpdateGitCredentialsToAutomaticRequest

Obsahuje data žádosti o aktualizaci přihlašovacích údajů Gitu na automatické.
UpdateGitCredentialsToConfiguredConnectionRequest

Obsahuje data žádosti o aktualizaci přihlašovacích údajů Gitu na nakonfigurované připojení.
UpdateGitCredentialsToNoneRequest

Obsahuje data žádosti o aktualizaci přihlašovacích údajů Gitu na žádné.

UpdateGitCredentialsToAutomaticRequest

Obsahuje data žádosti o aktualizaci přihlašovacích údajů Gitu na automatické.

Name Vyžadováno Typ Description
source True string:

Automatic

Zdroj přihlašovacích údajů Gitu.

UpdateGitCredentialsToConfiguredConnectionRequest

Obsahuje data žádosti o aktualizaci přihlašovacích údajů Gitu na nakonfigurované připojení.

Name Vyžadováno Typ Description
connectionId True

string (uuid)

ID objektu připojení.
source True string:

ConfiguredConnection

Zdroj přihlašovacích údajů Gitu.

UpdateGitCredentialsToNoneRequest

Obsahuje data žádosti o aktualizaci přihlašovacích údajů Gitu na žádné.

Name Vyžadováno Typ Description
source True string:

None

Zdroj přihlašovacích údajů Gitu.

Odpovědi

Name Typ Description
200 OK GitCredentialsConfigurationResponse:

Žádost byla úspěšně dokončena.
Other Status Codes

ErrorResponse

Běžné kódy chyb:

  • Neznámá chyba – došlo k chybě.

  • InsufficientPrivileges – Volající nemá dostatečná oprávnění pracovního prostoru.

  • WorkspaceNotConnectedToGit – Pracovní prostor není připojený k Gitu.

  • ConnectionNotFound – Zadané připojení nebylo nalezeno.

  • ConnectionMismatch – Připojení neodpovídá podrobnostem zprostředkovatele Gitu.

  • PrincipalTypeNotSupported – Typ identity volajícího není podporován.

Pří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

Ukázkový požadavek

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

{
  "source": "Automatic"
}

Ukázková odpověď

Stavový kód:
200 
{
  "source": "Automatic"
}

Update user's Git credentials to ConfiguredConnection example

Ukázkový požadavek

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

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

Ukázková odpověď

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

Update user's Git credentials to None example

Ukázkový požadavek

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

{
  "source": "None"
}

Ukázková odpověď

Stavový kód:
200 
{
  "source": "None"
}

Definice

Name Description
AutomaticGitCredentialsResponse

Automatické přihlašovací údaje Gitu
ConfiguredConnectionGitCredentialsResponse

Nakonfigurované přihlašovací údaje Gitu pro připojení
ErrorRelatedResource

Chyba související s objektem podrobností o prostředku.
ErrorResponse

Odpověď na chybu.
ErrorResponseDetails

Podrobnosti o odpovědi na chybu.
GitCredentialsSource

Zdroj přihlašovacích údajů Gitu. Další zdroje přihlašovacích údajů Gitu se můžou přidat v průběhu času.
NoneGitCredentialsResponse

Nenakonfigurované přihlašovací údaje Gitu
UpdateGitCredentialsToAutomaticRequest

Obsahuje data žádosti o aktualizaci přihlašovacích údajů Gitu na automatické.
UpdateGitCredentialsToConfiguredConnectionRequest

Obsahuje data žádosti o aktualizaci přihlašovacích údajů Gitu na nakonfigurované připojení.
UpdateGitCredentialsToNoneRequest

Obsahuje data žádosti o aktualizaci přihlašovacích údajů Gitu na žádné.

AutomaticGitCredentialsResponse

Objekt

Automatické přihlašovací údaje Gitu

Name Typ Description
source string:

Automatic

Zdroj přihlašovacích údajů Gitu.

ConfiguredConnectionGitCredentialsResponse

Objekt

Nakonfigurované přihlašovací údaje Gitu pro připojení

Name Typ Description
connectionId

string (uuid)

ID objektu připojení.
source string:

ConfiguredConnection

Zdroj přihlašovacích údajů Gitu.

ErrorRelatedResource

Objekt

Chyba související s objektem podrobností o prostředku.

Name Typ Description
resourceId

string

ID prostředku, které je součástí chyby.
resourceType

string

Typ prostředku, který je součástí chyby.

ErrorResponse

Objekt

Odpověď na chybu.

Name Typ Description
errorCode

string

Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message

string

Lidské čitelné vyjádření chyby.
moreDetails

ErrorResponseDetails[]

Seznam dalších podrobností o chybě
relatedResource

ErrorRelatedResource

Podrobnosti o prostředku souvisejícím s chybou
requestId

string

ID požadavku přidruženého k chybě.

ErrorResponseDetails

Objekt

Podrobnosti o odpovědi na chybu.

Name Typ Description
errorCode

string

Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message

string

Lidské čitelné vyjádření chyby.
relatedResource

ErrorRelatedResource

Podrobnosti o prostředku souvisejícím s chybou

GitCredentialsSource

Výčet

Zdroj přihlašovacích údajů Gitu. Další zdroje přihlašovacích údajů Gitu se můžou přidat v průběhu času.

Hodnota Description
ConfiguredConnection

Přihlašovací údaje Gitu se získávají prostřednictvím nakonfigurovaného připojení.
Automatic

Přihlašovací údaje Gitu automaticky získá systém s použitím výchozích přihlašovacích údajů, pokud jsou k dispozici.
None

Přihlašovací údaje Gitu nejsou nakonfigurované.

NoneGitCredentialsResponse

Objekt

Nenakonfigurované přihlašovací údaje Gitu

Name Typ Description
source string:

None

Zdroj přihlašovacích údajů Gitu.

UpdateGitCredentialsToAutomaticRequest

Objekt

Obsahuje data žádosti o aktualizaci přihlašovacích údajů Gitu na automatické.

Name Typ Description
source string:

Automatic

Zdroj přihlašovacích údajů Gitu.

UpdateGitCredentialsToConfiguredConnectionRequest

Objekt

Obsahuje data žádosti o aktualizaci přihlašovacích údajů Gitu na nakonfigurované připojení.

Name Typ Description
connectionId

string (uuid)

ID objektu připojení.
source string:

ConfiguredConnection

Zdroj přihlašovacích údajů Gitu.

UpdateGitCredentialsToNoneRequest

Objekt

Obsahuje data žádosti o aktualizaci přihlašovacích údajů Gitu na žádné.

Name Typ Description
source string:

None

Zdroj přihlašovacích údajů Gitu.