Git - Update From Git

Serviço:: Core

Versão da API:: v1

Atualiza o workspace com confirmações enviadas por push para o branch conectado.
Essa API dá suporte a LRO (operações de execução longa).

Para usar essa API, as credenciais do Git do chamador devem ser configuradas usando a API Atualizar Minhas Credenciais do Git . Você pode usar a API Obter Minhas Credenciais do Git para verificar a configuração de credenciais do Git.

A atualização afeta apenas os itens no workspace que foram alterados nessas confirmações. Se chamado após as APIs conectar e inicializar conexão , ele executará uma atualização completa de todo o workspace.

Permissões

O chamador deve ter um colaborador ou uma função de workspace superior.

Escopos delegados necessários

Workspace.GitUpdate.All

Identidades com suporte do Microsoft Entra

Esta API dá suporte às identidades do Microsoft listadas nesta seção.

Identidade	Apoio
Utilizador	Sim
entidade de serviço e identidades gerenciadas	Só há suporte quando todos os itens envolvidos nas entidades de serviço de suporte da operação

Interfase

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/git/updateFromGit

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
workspaceId	path	True	string (uuid)	O identificador do espaço de trabalho.

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
remoteCommitHash	True	string	Hash de confirmação SHA completo remoto.
conflictResolution		WorkspaceConflictResolution	Resolução de conflitos a ser usada na atualização da operação git. Se os itens estiverem em conflito e uma resolução de conflitos não for especificada, a operação de atualização não será iniciada.
options		UpdateOptions	Opções a serem usadas na atualização da operação git
workspaceHead		string	Hash SHA completo ao qual o workspace está sincronizado. Esse valor pode ser nulo somente depois de Inicializar a Conexão. Em outros casos, o sistema validará que o valor fornecido está alinhado com o cabeçalho conhecido pelo sistema.

Respostas

Nome	Tipo	Description
200 OK		Solicitação concluída com êxito.
202 Accepted		Solicitação aceita, atualização do Git em andamento. Cabeçalhos Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Códigos de erro comuns: WorkspaceNotConnectedToGit – O workspace não está conectado ao git. WorkspaceHasNoCapacityAssigned – nenhuma capacidade atribuída ao workspace. WorkspaceHeadMismatch – Cabeçalho na solicitação não corresponde à cabeça no sistema. WorkspacePreviousOperationInProgress – A operação anterior ainda está em andamento. MissingDependency – Uma dependência está ausente na operação de atualização. PotentialDuplicateDisplayNameAndType – A operação de atualização criará um nome e um tipo de exibição duplicados. DependencyDeletionFailed - A operação de atualização excluirá a dependência rígida. InsufficientPrivileges - O chamador não tem permissões de workspace suficientes. PrincipalTypeNotSupported – Não há suporte para o tipo de identidade do chamador.

Nome

Tipo

Description

200 OK

Solicitação concluída com êxito.

202 Accepted

Solicitação aceita, atualização do Git em andamento.

Cabeçalhos

Location: string
x-ms-operation-id: string
Retry-After: integer

Other Status Codes

ErrorResponse

Códigos de erro comuns:

WorkspaceNotConnectedToGit – O workspace não está conectado ao git.
WorkspaceHasNoCapacityAssigned – nenhuma capacidade atribuída ao workspace.
WorkspaceHeadMismatch – Cabeçalho na solicitação não corresponde à cabeça no sistema.
WorkspacePreviousOperationInProgress – A operação anterior ainda está em andamento.
MissingDependency – Uma dependência está ausente na operação de atualização.
PotentialDuplicateDisplayNameAndType – A operação de atualização criará um nome e um tipo de exibição duplicados.
DependencyDeletionFailed - A operação de atualização excluirá a dependência rígida.
InsufficientPrivileges - O chamador não tem permissões de workspace suficientes.
PrincipalTypeNotSupported – Não há suporte para o tipo de identidade do chamador.

Exemplos

Update a workspace using data from a Git example

Solicitação de exemplo

HTTP

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

{
  "workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "remoteCommitHash": "7d03b2918bf6aa62f96d0a4307293f3853201705",
  "conflictResolution": {
    "conflictResolutionType": "Workspace",
    "conflictResolutionPolicy": "PreferWorkspace"
  },
  "options": {
    "allowOverrideItems": true
  }
}

Resposta de exemplo

Código de status:: 200

Código de status:: 202

Location: https://api.fabric.microsoft.com/v1/operations/431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7
x-ms-operation-id: 431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7
Retry-After: 30

Definições

Nome	Description
ConflictResolutionPolicy	Política de resolução de conflitos. Políticas adicionais de resolução de conflitos podem ser adicionadas ao longo do tempo.
ConflictResolutionType	Tipo de resolução de conflitos. Tipos adicionais de resolução de conflitos podem ser adicionados ao longo do tempo.
ErrorRelatedResource	O objeto de detalhes do recurso relacionado ao erro.
ErrorResponse	A resposta de erro.
ErrorResponseDetails	Os detalhes da resposta de erro.
UpdateFromGitRequest	Contém a atualização dos dados de solicitação do Git.
UpdateOptions	Contém as opções que estão habilitadas para a atualização do Git.
WorkspaceConflictResolution	Os dados básicos de resolução de conflitos.

ConflictResolutionPolicy

Enumeração

Política de resolução de conflitos. Políticas adicionais de resolução de conflitos podem ser adicionadas ao longo do tempo.

Valor	Description
PreferRemote	Prefira conteúdo remoto do lado do Git.
PreferWorkspace	Prefira o conteúdo do lado do workspace.

ConflictResolutionType

Enumeração

Tipo de resolução de conflitos. Tipos adicionais de resolução de conflitos podem ser adicionados ao longo do tempo.

Valor	Description
Workspace	Resolução de conflitos que representa o nível do workspace.

ErrorRelatedResource

Objeto

O objeto de detalhes do recurso relacionado ao erro.

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

ErrorResponse

Objeto

A resposta de erro.

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

ErrorResponseDetails

Objeto

Os detalhes da resposta de erro.

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

UpdateFromGitRequest

Objeto

Contém a atualização dos dados de solicitação do Git.

Nome	Tipo	Description
conflictResolution	WorkspaceConflictResolution	Resolução de conflitos a ser usada na atualização da operação git. Se os itens estiverem em conflito e uma resolução de conflitos não for especificada, a operação de atualização não será iniciada.
options	UpdateOptions	Opções a serem usadas na atualização da operação git
remoteCommitHash	string	Hash de confirmação SHA completo remoto.
workspaceHead	string	Hash SHA completo ao qual o workspace está sincronizado. Esse valor pode ser nulo somente depois de Inicializar a Conexão. Em outros casos, o sistema validará que o valor fornecido está alinhado com o cabeçalho conhecido pelo sistema.

UpdateOptions

Objeto

Contém as opções que estão habilitadas para a atualização do Git.

Nome	Tipo	Description
allowOverrideItems	boolean	Consentimento do usuário para substituir itens de entrada durante a atualização do processo do Git. Quando os itens de entrada estiverem presentes e os itens de substituição de permissão não forem especificados ou forem fornecidos como false, a operação de atualização não será iniciada. O valor padrão é falso.

WorkspaceConflictResolution

Objeto

Os dados básicos de resolução de conflitos.

Nome	Tipo	Description
conflictResolutionPolicy	ConflictResolutionPolicy	Política de resolução de conflitos. Políticas adicionais de resolução de conflitos podem ser adicionadas ao longo do tempo.
conflictResolutionType	ConflictResolutionType	Tipo de resolução de conflitos. Tipos adicionais de resolução de conflitos podem ser adicionados ao longo do tempo.

Compartilhar via

Git - Update From Git

Permissões

Escopos delegados necessários

Identidades com suporte do Microsoft Entra

Interfase

Parâmetros de URI

Corpo da solicitação

Respostas

Exemplos

Update a workspace using data from a Git example

Solicitação de exemplo

Resposta de exemplo

Definições

ConflictResolutionPolicy

ConflictResolutionType

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

UpdateFromGitRequest

UpdateOptions

WorkspaceConflictResolution