Git - Get My Git Credentials

Serviço:

Core

Versão da API:

v1

Retorna os detalhes de configuração das credenciais do Git do usuário.
Indica como as credenciais do usuário são obtidas para acessar o provedor Git relevante, automaticamente ou por meio de conexão configurada. Se as credenciais do usuário não estiverem configuradas, vá para Atualizar minha API de credenciais do Git .

Permissões

O chamador deve ter uma função de de espaço de trabalho de contribuidor ou superior.

Escopos delegados necessários

Workspace.Read.All ou Workspace.ReadWrite.All

Identidades suportadas pelo Microsoft Entra

Esta API suporta as identidades do Microsoft listadas nesta secção.

Identidade	Apoio
Utilizador	Yes
Entidade de serviço e identidades geridas	Yes

Interfaz

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
workspaceId	path	True	string (uuid)	O ID do espaço de trabalho.

Respostas

Name	Tipo	Description
200 OK	GitCredentialsConfigurationResponse: AutomaticGitCredentialsResponse NoneGitCredentialsResponse ConfiguredConnectionGitCredentialsResponse	Pedido concluído com sucesso.
Other Status Codes	ErrorResponse	Códigos de erro comuns: UnknownError - Ocorreu um erro. InsufficientPrivileges - O chamador não tem permissões de espaço de trabalho suficientes. WorkspaceNotConnectedToGit - O espaço de trabalho não está conectado ao git.

Exemplos

Get the user's Git credentials configuration for Azure DevOps when it is automatic example

Get the user's Git credentials configuration when it is configured by connection example

Get the user's Git credentials configuration when it is not configured example

Get the user's Git credentials configuration for Azure DevOps when it is automatic example

Pedido de amostra

HTTP

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

Resposta da amostra

Código de estado:

200

{
  "source": "Automatic"
}

Get the user's Git credentials configuration when it is configured by connection example

Pedido de amostra

HTTP

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

Resposta da amostra

Código de estado:

200

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

Get the user's Git credentials configuration when it is not configured example

Pedido de amostra

HTTP

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

Resposta da amostra

Código de estado:

200

{
  "source": "None"
}

Definições

Name	Description
AutomaticGitCredentialsResponse	Credenciais automáticas do Git.
ConfiguredConnectionGitCredentialsResponse	Credenciais Git de conexão configuradas.
ErrorRelatedResource	O objeto de detalhes do recurso relacionado ao erro.
ErrorResponse	A resposta de erro.
ErrorResponseDetails	Os detalhes da resposta de erro.
GitCredentialsSource	A fonte de credenciais do Git. Fontes adicionais de credenciais do Git podem ser adicionadas ao longo do tempo.
NoneGitCredentialsResponse	Credenciais do Git não configuradas.

AutomaticGitCredentialsResponse

Object

Credenciais automáticas do Git.

Name	Tipo	Description
source	string: Automatic	A fonte de credenciais do Git.

ConfiguredConnectionGitCredentialsResponse

Object

Credenciais Git de conexão configuradas.

Name	Tipo	Description
connectionId	string (uuid)	O ID do objeto da conexão.
source	string: ConfiguredConnection	A fonte de credenciais do Git.

ErrorRelatedResource

Object

O objeto de detalhes do recurso relacionado ao erro.

Name	Tipo	Description
resourceId	string	A ID do recurso envolvida no erro.
resourceType	string	O tipo de recurso envolvido no erro.

ErrorResponse

Object

A resposta de erro.

Name	Tipo	Description
errorCode	string	Um identificador específico que fornece informações sobre uma condição de erro, permitindo uma comunicação padronizada entre nosso serviço e seus usuários.
message	string	Uma representação legível por humanos do erro.
moreDetails	ErrorResponseDetails[]	Lista de detalhes de erro adicionais.
relatedResource	ErrorRelatedResource	Os detalhes do recurso relacionados ao erro.
requestId	string	ID da solicitação associada ao erro.

ErrorResponseDetails

Object

Os detalhes da resposta de erro.

Name	Tipo	Description
errorCode	string	Um identificador específico que fornece informações sobre uma condição de erro, permitindo uma comunicação padronizada entre nosso serviço e seus usuários.
message	string	Uma representação legível por humanos do erro.
relatedResource	ErrorRelatedResource	Os detalhes do recurso relacionados ao erro.

GitCredentialsSource

Enumeração

A fonte de credenciais do Git. Fontes adicionais de credenciais do Git podem ser adicionadas ao longo do tempo.

Valor	Description
ConfiguredConnection	As credenciais do Git são obtidas por meio de uma conexão configurada.
Automatic	As credenciais do Git são obtidas automaticamente pelo sistema, usando credenciais padrão, se disponíveis.
None	As credenciais do Git não estão configuradas.

NoneGitCredentialsResponse

Object

Credenciais do Git não configuradas.

Name	Tipo	Description
source	string: None	A fonte de credenciais do Git.