Condividi tramite

Git - Update My Git Credentials

Servizio:
Core
Versione API:
v1

Aggiorna i dettagli di configurazione delle credenziali Git dell'utente.
Ogni utente nell'area di lavoro ha le proprie credenziali Git configurate. È possibile usare l'API Get My Git Credentials (Ottieni credenziali Git personali ) per ottenere la configurazione delle credenziali Git.

Per ottenere l'ID connessione, vedere Automatizzare l'integrazione di Git.

Autorizzazioni

Il chiamante deve avere un ruolo di collaboratore o superiore dell'area di lavoro.

Per le credenziali Git di connessione configurate, il chiamante deve disporre dell'autorizzazione per la connessione.

Ambiti delegati obbligatori

SpazioDiLavoro.LetturaScrittura.Tutti

Limitazioni

Quando si usa l'origine delle credenziali automatiche, questa API viene bloccata per il provider GitHub e per l'entità servizio.

Identità supportate da Microsoft Entra

Questa API supporta le identità di Microsoft elencate in questa sezione.

Identità Assistenza
Utente Sì
Entità servizio e Identità gestite Supportato solo quando l'origine è ConfiguredConnection o None

Interfaccia

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
workspaceId
 path True

string (uuid)

ID dell'area di lavoro.

Corpo della richiesta

Il corpo della richiesta può essere uno dei seguenti:

Nome Descrizione
UpdateGitCredentialsToAutomaticRequest

Contiene i dati della richiesta per aggiornare le credenziali Git in automatico.
UpdateGitCredentialsToConfiguredConnectionRequest

Contiene i dati della richiesta per aggiornare le credenziali Git alla connessione configurata.
UpdateGitCredentialsToNoneRequest

Contiene i dati della richiesta per aggiornare le credenziali Git a nessuno.

UpdateGitCredentialsToAutomaticRequest

Contiene i dati della richiesta per aggiornare le credenziali Git in automatico.

Nome Necessario Tipo Descrizione
source True string:

Automatic

Origine delle credenziali Git.

UpdateGitCredentialsToConfiguredConnectionRequest

Contiene i dati della richiesta per aggiornare le credenziali Git alla connessione configurata.

Nome Necessario Tipo Descrizione
connectionId True

string (uuid)

ID oggetto della connessione.
source True string:

ConfiguredConnection

Origine delle credenziali Git.

UpdateGitCredentialsToNoneRequest

Contiene i dati della richiesta per aggiornare le credenziali Git a nessuno.

Nome Necessario Tipo Descrizione
source True string:

None

Origine delle credenziali Git.

Risposte

Nome Tipo Descrizione
200 OK GitCredentialsConfigurationResponse:

Richiesta completata correttamente.
Other Status Codes

ErrorResponse

Codici di errore comuni:

  • UnknownError: si è verificato un errore.

  • InsufficientPrivileges: il chiamante non dispone di autorizzazioni sufficienti per l'area di lavoro.

  • WorkspaceNotConnectedToGit: l'area di lavoro non è connessa a Git.

  • ConnectionNotFound: la connessione specificata non è stata trovata.

  • ConnectionMismatch: la connessione non corrisponde ai dettagli del provider Git.

  • PrincipalTypeNotSupported: il tipo di identità del chiamante non è supportato.

Esempio

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

Esempio di richiesta

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

{
  "source": "Automatic"
}

Risposta di esempio

Codice di stato:
200 
{
  "source": "Automatic"
}

Update user's Git credentials to ConfiguredConnection example

Esempio di richiesta

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

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

Risposta di esempio

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

Update user's Git credentials to None example

Esempio di richiesta

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

{
  "source": "None"
}

Risposta di esempio

Codice di stato:
200 
{
  "source": "None"
}

Definizioni

Nome Descrizione
AutomaticGitCredentialsResponse

Credenziali Git automatiche.
ConfiguredConnectionGitCredentialsResponse

Credenziali Git di connessione configurate.
ErrorRelatedResource

Oggetto dettagli risorsa correlato all'errore.
ErrorResponse

Risposta di errore.
ErrorResponseDetails

Dettagli della risposta di errore.
GitCredentialsSource

Origine delle credenziali Git. È possibile aggiungere altre origini credenziali Git nel tempo.
NoneGitCredentialsResponse

Credenziali Git non configurate.
UpdateGitCredentialsToAutomaticRequest

Contiene i dati della richiesta per aggiornare le credenziali Git in automatico.
UpdateGitCredentialsToConfiguredConnectionRequest

Contiene i dati della richiesta per aggiornare le credenziali Git alla connessione configurata.
UpdateGitCredentialsToNoneRequest

Contiene i dati della richiesta per aggiornare le credenziali Git a nessuno.

AutomaticGitCredentialsResponse

Object

Credenziali Git automatiche.

Nome Tipo Descrizione
source string:

Automatic

Origine delle credenziali Git.

ConfiguredConnectionGitCredentialsResponse

Object

Credenziali Git di connessione configurate.

Nome Tipo Descrizione
connectionId

string (uuid)

ID oggetto della connessione.
source string:

ConfiguredConnection

Origine delle credenziali Git.

ErrorRelatedResource

Object

Oggetto dettagli risorsa correlato all'errore.

Nome Tipo Descrizione
resourceId

string

ID risorsa coinvolto nell'errore.
resourceType

string

Tipo della risorsa coinvolta nell'errore.

ErrorResponse

Object

Risposta di errore.

Nome Tipo Descrizione
errorCode

string

Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
message

string

Rappresentazione leggibile dell'errore.
moreDetails

ErrorResponseDetails[]

Elenco di dettagli aggiuntivi sull'errore.
relatedResource

ErrorRelatedResource

Dettagli della risorsa correlati all'errore.
requestId

string

ID della richiesta associata all'errore.

ErrorResponseDetails

Object

Dettagli della risposta di errore.

Nome Tipo Descrizione
errorCode

string

Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
message

string

Rappresentazione leggibile dell'errore.
relatedResource

ErrorRelatedResource

Dettagli della risorsa correlati all'errore.

GitCredentialsSource

Enumerazione

Origine delle credenziali Git. È possibile aggiungere altre origini credenziali Git nel tempo.

Valore Descrizione
ConfiguredConnection

Le credenziali Git vengono ottenute tramite una connessione configurata.
Automatic

Le credenziali Git vengono ottenute automaticamente dal sistema, usando le credenziali predefinite, se disponibili.
None

Le credenziali Git non sono configurate.

NoneGitCredentialsResponse

Object

Credenziali Git non configurate.

Nome Tipo Descrizione
source string:

None

Origine delle credenziali Git.

UpdateGitCredentialsToAutomaticRequest

Object

Contiene i dati della richiesta per aggiornare le credenziali Git in automatico.

Nome Tipo Descrizione
source string:

Automatic

Origine delle credenziali Git.

UpdateGitCredentialsToConfiguredConnectionRequest

Object

Contiene i dati della richiesta per aggiornare le credenziali Git alla connessione configurata.

Nome Tipo Descrizione
connectionId

string (uuid)

ID oggetto della connessione.
source string:

ConfiguredConnection

Origine delle credenziali Git.

UpdateGitCredentialsToNoneRequest

Object

Contiene i dati della richiesta per aggiornare le credenziali Git a nessuno.

Nome Tipo Descrizione
source string:

None

Origine delle credenziali Git.