Git - Update From Git

Serviço:

Core

Versão da API:

v1

Atualiza o espaço de trabalho com confirmações enviadas por push para a ramificação conectada.
Esta API suporta operações de longa duração (LRO).

Para usar essa API, as credenciais do Git do chamador devem ser configuradas usando Update My Git Credentials API. Você pode usar a API Get My Git Credentials para verificar a configuração das credenciais do Git.

A atualização afeta apenas os itens no espaço de trabalho 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 espaço de trabalho.

Permissões

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

Escopos delegados necessários

Workspace.GitUpdate.All

Identidades suportadas pelo Microsoft Entra

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

Identidade	Apoio
Utilizador	Sim
Entidade de serviço e identidades geridas	Suportado apenas quando todos os itens envolvidos na operação suportam entidades de serviço

Interfaz

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

Parâmetros do URI

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

Corpo do Pedido

Name	Necessá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 conflito 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 com o qual o espaço de trabalho está sincronizado. Esse valor pode ser nulo somente após Initialize Connection. Em outros casos, o sistema validará se o valor dado está alinhado com a cabeça conhecida pelo sistema.

Respostas

Name	Tipo	Description
200 OK		Pedido concluído com sucesso.
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 espaço de trabalho não está conectado ao git. WorkspaceHasNoCapacityAssigned - Nenhuma capacidade atribuída ao espaço de trabalho. WorkspaceHeadMismatch - O cabeçalho na solicitação não corresponde ao cabeçalho no sistema. WorkspacePreviousOperationInProgress - A operação anterior ainda está em andamento. MissingDependency - Uma dependência está faltando 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 espaço de trabalho suficientes. PrincipalTypeNotSupported - O tipo de identidade do chamador não é suportado.

Exemplos

Update a workspace using data from a Git example

Pedido de amostra

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 da amostra

Código de estado:

200

Código de estado:

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

Name	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 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 Git.
PreferWorkspace	Prefira o conteúdo do lado do espaço de trabalho.

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 espaço de trabalho.

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.

UpdateFromGitRequest

Object

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

Name	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 conflito 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 com o qual o espaço de trabalho está sincronizado. Esse valor pode ser nulo somente após Initialize Connection. Em outros casos, o sistema validará se o valor dado está alinhado com a cabeça conhecida pelo sistema.

UpdateOptions

Object

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

Name	Tipo	Description
allowOverrideItems	boolean	Consentimento do usuário para substituir itens recebidos durante a atualização do processo Git. Quando os itens de entrada estiverem presentes e a permissão de substituição de itens não for especificada ou for fornecida como falsa, a operação de atualização não será iniciada. O valor predefinido é falso.

WorkspaceConflictResolution

Object

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

Name	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.