Azure DevOps

O Azure DevOps fornece serviços para equipas partilharem código, acompanharem trabalho e lançarem software – para qualquer linguagem, tudo num único pacote. É o complemento perfeito para o seu IDE.

Este conector está disponível nos seguintes produtos e regiões:

Serviço	Class	Regiões
Estúdio Copiloto	Premium	Todas as regiões Power Automate exceto as seguintes: - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas	Standard	Todas as regiões do Logic Apps , exceto as seguintes: - Regiões Azure China - Departamento de Defesa dos EUA (DoD)
Power Apps	Premium	Todas as regiões Power Apps exceto as seguintes: - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD)
Power Automate	Premium	Todas as regiões Power Automate exceto as seguintes: - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD)

Contato
Nome	Microsoft
URL	https://azure.microsoft.com/en-us/support/?icid=devops

Metadados do conector
Publisher	Microsoft
Sítio Web	https://learn.microsoft.com/en-us/azure/devops/?view=azure-devops
Política de privacidade	https://privacy.microsoft.com
Categorias	Operações de TI

Para usar esta integração, vai precisar de acesso a uma conta Azure DevOps com acesso à API ativado. Para estabelecer uma ligação, selecione Iniciar sessão. É então solicitado que forneça a sua conta de Azure DevOps Services. Siga o restante das telas para criar uma conexão.

Ao usar a conexão, se você não estiver vendo a lista de projetos esperados, verifique a conta com a qual criou a conexão e tente novamente. Mais detalhes podem ser encontrados no Visual Studio Marketplace.

Agora você está pronto para começar a usar essa integração.

Autenticação por Credenciais de Identidade Federada

Juntamente com as ligações que iniciam sessão como utilizador ou utilizam um segredo ou certificado de cliente, o conector suporta uma ligação de Credencial de Identidade Federada (FIC ). Autentica-se como uma aplicação registada no seu próprio tenant Microsoft Entra e não armazena um segredo de cliente ou certificado na ligação.

Inquilino obrigatório e configuração Azure DevOps

Registe uma aplicação de inquilino único no Microsoft Entra ID e indique o seu ID de Aplicação (cliente) e ID de Diretório (inquilino).
Adicione o principal de serviço da aplicação a todas as organizações Azure DevOps a que precisa de aceder. Atribui o nível de acesso mais baixo, as pertenças a grupos e as permissões de recursos exigidas pelos teus fluxos. O Azure DevOps autoriza o principal do serviço através das permissões da sua organização, não através das permissões da aplicação Microsoft Entra. Para mais detalhes, veja Usar princípios de serviço e identidades geridas no Azure DevOps.
Crie a ligação usando o tipo de autenticação de credenciais de identidade federada e forneça o ID do cliente e o ID do inquilino. Deixe o teste inicial de ligação falhar.
Copie o sujeito esperado do AADSTS700212 erro e depois adicione uma credencial de identidade federada à sua candidatura com:
- Emitente:https://login.microsoftonline.com/<tenant-id>/v2.0
- Público:api://AzureADTokenExchange
- Sujeito: o sujeito exato gerado para a ligação
Teste novamente a mesma ligação depois de a credencial de identidade federada ter sido replicada.

Não apague nem recrie a ligação enquanto completa esta configuração. O sujeito identifica essa ligação específica, por isso uma ligação de substituição requer uma credencial de identidade federada diferente.

Envio de anexos

Pode criar anexos de ficheiros usando Enviar um pedido HTTP para a ação Azure DevOps, seguindo estes passos:

Converta o conteúdo do arquivo em uma string Base64 e coloque-o no parâmetro "Body".
Defina o parâmetro "Body is Base64" como Sim.

Criação de planos de teste

Antes de criar um Plano de Teste usando a ação Criar um item de trabalho , você deve primeiro criar um Test Suite. Você pode usar a mesma ação Criar um item de trabalho para criar Suítes de Teste e, em seguida, criar um Plano de Teste com um link para o Conjunto de Testes.

A sua opção mais simples é invocar Planos de Teste - Criar API diretamente usando Enviar um pedido HTTP para a ação Azure DevOps. A API cria automaticamente o Test Suite associado.

Parâmetro Other Fields

As ações Criar um item de trabalho e Atualizar um item de trabalho têm suporte de Other Fields parâmetro. Esses campos oferecem flexibilidade adicional ao atualizar itens de trabalho. Os pares chave-valor são transformados para o seguinte JSON:

{
  "op": "add",
  "path": "/fields/<key>",
  "value": <value>
}

Observe que é uma constante e espera-se que op seja um nome de campo válido na enumeração DevOps<key>./fields

Aqui estão alguns exemplos de uso. Você pode obter mais exemplos em Itens de trabalho - Atualizar API REST.

Atualização do key histórico = System.History value = Movendo-se para o caminho da área direita'
Mover itens de trabalho: key = System.TeamProject value = Fabrikam-Scrum

Problemas conhecidos e limitações

A lista seguinte apresenta limitações conhecidas na utilização do conector Azure DevOps.

Gatilho Quando um item de trabalho é atualizado será ignorado quando links novos/existentes foram adicionados/excluídos ao item de trabalho.
A ação Get work item details e os gatilhos baseados em item de trabalho podem falhar alguns campos (como System.AttachedFileCount) numa resposta, pois isto é uma limitação da API REST Azure DevOps. Para contornar esse problema, você pode fazer o seguinte:
- Use Enviar um pedido HTTP para Azure DevOps com o endpoint Get Work Item para obter campos específicos
- Usar Obter resultados da consulta com uma consulta que retorna os campos obrigatórios
A ação Enviar um pedido HTTP para Azure DevOps tem um conjunto limitado de escopos que controlam que recursos podem ser acedidos pela ação e que operações a ação pode realizar nesses recursos.

Âmbitos de aplicação:
- vso.agentpools_manage
- vso.build_execute
- vso.chat_manage
- vso.code_manage
- vso.code_status
- vso.connected_server
- vso.dashboards_manage
- vso.direitos
- vso.extension.data_write
- vso.extension_manage
- vso.identidade
- vso.loadtest_write
- vso.packaging_manage
- vso.project_manage
- vso.release_manage
- vso.test_write
- vso.work_write
As ligações que iniciam sessão como utilizador operam com as permissões Azure DevOps desse utilizador. Credenciais de identidade federadas, certificados e ligações secretas do cliente operam com as permissões atribuídas ao seu principal de serviço no Azure DevOps.
Por favor, note que alterações de palavra-passe na conta Azure DevOps não afetam a ligação existente.
Os Tokens de Acesso Pessoal do Azure DevOps não são suportados para autenticação com o conector.
Ação Criar um item de trabalho tem limitação para o parâmetro Repro Steps - uma imagem maior que 30 KB pode ser exibida incorretamente no item criado. Imagem maior que 500Kb pode ser removida da solicitação. O tamanho de imagem recomendado deve ser inferior a 30 KB.
Ação Criar um item de trabalho muito raramente poderia retornar o código de resposta 404. Na maioria das vezes, isso acontece pelo seguinte motivo: imediatamente após a criação de um item, todos os seus campos estão sendo solicitados. O pedido pode ser enviado para a base de dados copiada. As alterações são sincronizadas quase em tempo real, mas às vezes leva alguns segundos. Devido a isso, a solicitação GET pode retornar um resultado vazio que representa como um código de status 404 em uma resposta. Para evitar essa exceção, você pode usar o sinalizador "Retornar todos os campos" e defini-lo com o valor "Não".
Para ligações que iniciam sessão como utilizador, apenas as organizações do inquilino principal da conta iniciada são devolvidas quando trabalham em múltiplos diretórios. Mudar de diretórios a partir da página de perfil Azure DevOps não afeta as organizações disponíveis. Para aceder a organizações noutro tenant, crie a ligação usando as credenciais de uma conta que pertença a esse tenant.

Observação

Na ação Criar um item de trabalho

O nome do campo deve cumprir os critérios mencionados na documentação Azure DevOps.

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:


Autenticação de certificado de cliente	Forneça credenciais Microsoft Entra ID usando certificado e palavra-passe PFX	Todas as regiões	Compartilhável
Credencial de Identidade Federada	Use uma credencial de identidade federada na sua aplicação Microsoft Entra ID para aceder ao Azure DevOps sem armazenar um segredo de cliente ou certificado na ligação.	APENAS PRODUÇÃO	Compartilhável
Iniciar sessão com Azure DevOps Credenciais	Login with Azure DevOps Credentials	Apenas Azure Government e Governo dos EUA (GCC)	Não compartilhável
Iniciar sessão com Microsoft Entra ID	Iniciar sessão com o Microsoft Entra ID	APENAS PRODUÇÃO	Não compartilhável
Autenticação do principal de serviço	Use a sua aplicação Microsoft Entra ID para autenticação do principal de serviço	Todas as regiões	Compartilhável
Padrão [DEPRECATED]	Esta opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores.	Todas as regiões	Não compartilhável

Autenticação de certificado de cliente

ID de autenticação: CertOauth

Aplicável: Todas as regiões

Forneça credenciais Microsoft Entra ID usando certificado e palavra-passe PFX

Esta é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, a conexão também será compartilhada. Para mais informações, consulte a visão geral Connectors para aplicações canvas - Power Apps | Microsoft Docs

Nome	Tipo	Description	Obrigatório
Tenant	cadeia (de caracteres)		Verdade
ID do Cliente	cadeia (de caracteres)	O ID do cliente da aplicação Microsoft Entra ID	Verdade
Segredo do certificado do cliente	certificado do cliente	O segredo do certificado do cliente permitido por este aplicativo	Verdade

Credencial de Identidade Federada

ID de autenticação: connectionfic

Aplicável: PRODUÇÃO apenas

Use uma credencial de identidade federada na sua aplicação Microsoft Entra ID para aceder ao Azure DevOps sem armazenar um segredo de cliente ou certificado na ligação.

Nome	Tipo	Description	Obrigatório
ID do Cliente	cadeia (de caracteres)		Verdade
ID do inquilino	cadeia (de caracteres)		Verdade

Login with Azure DevOps Credentials

ID de autenticação: ADO3pAuthForGCC

Aplicável: apenas Azure Government e US Government (GCC)

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Iniciar sessão com o Microsoft Entra ID

ID de autenticação: EntraOAuth

Aplicável: PRODUÇÃO apenas

Iniciar sessão com o Microsoft Entra ID

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Autenticação do principal de serviço

ID de autenticação: OauthSP

Aplicável: Todas as regiões

Use a sua aplicação Microsoft Entra ID para autenticação do principal de serviço

Nome	Tipo	Description	Obrigatório
Tenant	cadeia (de caracteres)		Verdade
ID do Cliente	cadeia (de caracteres)	O ID do cliente da aplicação Microsoft Entra ID	Verdade
Segredo do cliente	securestring		Verdade

Padrão [DEPRECATED]

Aplicável: Todas as regiões

Esta opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Limites de Limitação

Nome	Chamadas	Período de Renovação
Chamadas de API por conexão	300	60 segundos

Ações

Apagar comentário sobre item de trabalho (Pré-visualização)	Apaga um comentário sobre um item de trabalho.
Atualizar um item de trabalho	Atualize um item de trabalho existente por id.
Atualizar um pedido de pull	Atualiza um pull request existente. Use isto para definir o auto-completamento, abandonar ou concluir um pull request, ou alterar o seu título, descrição ou ramo de destino.
Builds de listas (Pré-visualização)	Recupera compilações para o projeto especificado com filtros opcionais.
Comentário do item de atualização (Pré-visualização)	Atualiza um comentário sobre um item de trabalho.
Cria um push	Empurra um ou mais commits para um repositório Git. Use isto para criar um branch e confirmar alterações de ficheiros numa única chamada.
Criar comentário de item de trabalho (Pré-visualização)	Adiciona um comentário a um item de trabalho.
Criar um item de trabalho	Crie um novo item de trabalho com os atributos fornecidos.
Criar uma nova versão	Crie uma versão, com base em uma definição de versão existente.
Criar uma solicitação de pull	Cria um pull request num repositório Git, opcionalmente ligando itens de trabalho e adicionando revisores.
Enfileirar uma nova compilação	Crie uma compilação, com base em uma definição de compilação existente, e adicione-a à fila de compilação.
Enviar um pedido HTTP para Azure DevOps	Construa uma Azure DevOps REST API request to invoke. Consulte a seguinte ligação para todos os parâmetros de avaliação disponíveis: https://docs.microsoft.com/rest/api/azure/devops
Executar um pipeline	Coloca em fila uma nova execução de um pipeline YAML. Suporta parâmetros de template, variáveis de runtime, a ramificação a partir da corrida e os estágios a saltar.
Link para adicionar item de trabalho (Pré-visualização)	Adiciona um link para um item de trabalho.
Link para eliminar item de trabalho (Pré-visualização)	Apaga um link de um item de trabalho.
Listar campos de itens de trabalho (Pré-visualização)	Recupera os campos do item de trabalho disponíveis dentro da organização ou projeto Azure DevOps especificado.
Listar consultas de nível raiz	Recupera a lista de consultas de item de trabalho de nível raiz em um projeto.
Listar consultas dentro da pasta	Recupera a lista de consultas de item de trabalho dentro de uma pasta para um determinado projeto.
Listar definições de versão	Recupera a lista de definições de versão associadas a um projeto.
Listar execuções de pipeline	Obtém as 10000 melhores execuções para um pipeline específico
Listar itens de trabalho	Retorna uma lista de itens de trabalho.
Listar iterações	Recupera a lista de iterações de um projeto.
Listar organizações	Recupera a lista de Organizações das quais o usuário é membro.
Listar pipelines	Recupera a lista de pipelines em um projeto.
Listar projetos	Recupera a lista de projetos em uma organização.
Listar ramificações Git (Pré-visualização)	Recupera a lista de branches Git disponíveis nos repositórios do projeto.
Listar ramos e etiquetas	Recupera as referências de um repositório Git, opcionalmente filtradas por um prefixo de nome de referência, como heads/main.
Listar repositórios Git	Recupera a lista de repositórios Git em um projeto.
Listar tipos de item de trabalho	Recupera a lista de Tipos de Itens de Trabalho acessíveis num dado projeto Azure DevOps.
Obtenha a linha do tempo da construção (Pré-visualização)	Recupera a linha temporal de uma build específica.
Obtenha detalhes do item de trabalho (V2) (Pré-visualização)	Obtenha os detalhes de um único item de trabalho com opções opcionais de seleção de campo e expansão.
Obter anexo de item de trabalho (Pré-visualização)	Descarrega o conteúdo de um anexo de trabalho.
Obter build (Pré-visualização)	Recupera uma build pelo seu identificador.
Obter conteúdo de ficheiro	Recupera um ficheiro (ou metadados de pasta) de um repositório Git. O texto do ficheiro é devolvido na propriedade Conteúdo.
Obter detalhes do item de trabalho	Obtenha os detalhes de um único item de trabalho.
Obter filhos de item de trabalho	Obtenha uma lista de crianças (tamanho máximo 1000) de um único item de trabalho.
Obter resultados da consulta	Recupera o resultado de uma consulta de item de trabalho.
Obter resultados da consulta [DEPRECATED]	Esta ação foi preterida. Em vez disso, use Obter resultados da consulta . ~~Recupera o resultado de uma consulta de item de trabalho.~~
Obter um perfil de utilizador	Obtém um perfil de usuário.
Obter uma execução de pipeline	Recupera uma única execução de um pipeline, incluindo o seu estado, resultado e parâmetros do template.
Pesquisar itens de trabalho	Fornece um conjunto de resultados para o texto da pesquisa.
Receba comentários sobre itens de trabalho (Pré-visualização)	Recupera comentários de um item de trabalho.
Requerentes de compilações de listas (Pré-visualização)	Recupera membros únicos do projeto que podem ser usados para filtrar builds pela identidade solicitada.

Apagar comentário sobre item de trabalho (Pré-visualização)

ID da Operação:: DeleteWorkItemCommentAsync

Apaga um comentário sobre um item de trabalho.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	ID do Project ou nome do project
ID do item de trabalho	workItemId	True	integer	Identificação de um artigo de trabalho.
ID do comentário	commentId	True	integer	ID do comentário para apagar.
Versão da API	api-version	True	string	Versão da API a ser usada. Definido para '7.1-preview.4'; O conector pode também recorrer ao '7.1-preview.3', se o serviço o exigir.

Atualizar um item de trabalho

ID da Operação:: UpdateWorkItem

Atualize um item de trabalho existente por id.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
ID do item de trabalho	id	True	string	A ID exclusiva do item de trabalho a ser atualizado.
Nome do Project	project		string	O nome do projeto dentro da organização especificada.
Tipo de item de trabalho	type		string	O tipo de item de trabalho para o qual gerar o esquema.
Detalhes do item de trabalho	workItem	True	dynamic	Os detalhes do item de trabalho.

Devoluções

As saídas desta operação são dinâmicas.

Atualizar um pedido de pull

ID da Operação:: UpdateGitPullRequest

Atualiza um pull request existente. Use isto para definir o auto-completamento, abandonar ou concluir um pull request, ou alterar o seu título, descrição ou ramo de destino.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
Nome do repositório	repositoryId	True	string	O nome ou identificador do repositório Git dentro do projeto especificado.
Pull Request Id	pullRequestId	True	integer	O identificador do pull request.
Situação	status		string	O estado a definir no pull request.
Title	title		string	O novo título do pull request.
Description	description		string	A nova descrição do pull request.
Ramo Alvo	targetRefName		string	O novo ramo alvo do pull request.
É rascunho	isDraft		boolean	Defina para falso para publicar um rascunho de pull request.
ID de Identidade	id		string	O id de identidade que permite o auto-completamento.
ID de confirmação	commitId		string	O id da confirmação.
Excluir ramificação de origem	deleteSourceBranch		boolean	Defina para true para eliminar a ramificação de origem após a conclusão.
Fusão de Squash	squashMerge		boolean	Define para true para esmagar os commits ao fundir.
Política de desvio	bypassPolicy		boolean	Defina como true para contornar as políticas de branch.
Motivo do desvio	bypassReason		string	A razão pela qual as políticas das filiais são ignoradas.
Mensagem de confirmação de mesclagem	mergeCommitMessage		string	A mensagem do commit da fusão.
Itens de trabalho de transição	transitionWorkItems		boolean	Defina para true para transitar os itens de trabalho ligados ao concluir.

Devoluções

Um pull request.

Body: GitPullRequestResponse

Builds de listas (Pré-visualização)

ID da Operação:: ListBuilds

Recupera compilações para o projeto especificado com filtros opcionais.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
Filtrar IDs por Definição	definitions		string	Lista separada por vírgulas de identificadores de definição a incluir.
Filtrar por Número de Build	buildNumber		string	Filtra por número de construção.
Filtrar por Ramo	branchName		string	Filtra por nome de ramo (por exemplo, refs/heads/main).
Filtrar por resultado	resultFilter		string	Filtrar por resultado da build.
Filtrar por Estado	statusFilter		string	Filtra pelo estado da construção.
Filtrar por Razão	reasonFilter		string	Filtra por razão de construção.
Filtrar por Pedido	requestedFor		string	Filtra pela identidade para quem a build foi solicitada.
Tempo mínimo de chegada	minTime		date-time	Filtra pelo tempo mínimo de conclusão (inclusive).
Tempo Máximo de Chegada	maxTime		date-time	Filtra pelo tempo máximo de conclusão (inclusive).
Resultados Máximos	$top		integer	Número máximo de builds para regressar.
Ordenar por	queryOrder		string	A ordem em que as builds são devolvidas.
Filtrar por Etiquetas	tagFilters		string	Lista de tags separadas por vírgula. Apenas as construções que transportam todas as etiquetas são devolvidas.

Devoluções

Uma lista de modelos VSTS.

Body: VstsList[BuildResult]

Comentário do item de atualização (Pré-visualização)

ID da Operação:: UpdateWorkItemCommentAsync

Atualiza um comentário sobre um item de trabalho.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	ID do Project ou nome do project
ID do item de trabalho	workItemId	True	integer	Identificação de um artigo de trabalho.
ID do comentário	commentId	True	integer	Id do comentário para atualizar.
Formato do Comentário	format		string	Formato de um comentário de item de trabalho (Markdown ou Html).
Texto do comentário	text	True	string	O texto do comentário.

Devoluções

Comentário do Item de Trabalho

Body: WorkItemComment

Cria um push

ID da Operação:: CreateGitPush

Empurra um ou mais commits para um repositório Git. Use isto para criar um branch e confirmar alterações de ficheiros numa única chamada.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
Nome do repositório	repositoryId	True	string	O nome ou identificador do repositório Git dentro do projeto especificado.
Nome Ref	name		string	O nome completo da referência a atualizar ou criar, por exemplo refs/heads/my-branch.
Id do Objeto Antigo	oldObjectId		string	O ID do objeto para o qual a referência aponta atualmente. Use o ID do objeto do ramo base ao criar um ramo.
Novo ID de Objeto	newObjectId		string	O ID do objeto para o qual a referência deve apontar. Só é obrigatório ao apagar ou reiniciar uma referência.
Comment	comment		string	A mensagem de commit.
Alterar Tipo	changeType		string	O tipo de mudança a aplicar.
Caminho do item	path		string	O caminho relativo ao repositório do item.
Content	content		string	O conteúdo do arquivo.
Tipo de conteúdo	contentType		string	Como o conteúdo é codificado.

Devoluções

O resultado de um empurrão.

Body: GitPushResponse

Criar comentário de item de trabalho (Pré-visualização)

ID da Operação:: CreateWorkItemCommentAsync

Adiciona um comentário a um item de trabalho.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	ID do Project ou nome do project
Tipo de item de trabalho	type		string	O tipo de item de trabalho para o qual gerar o esquema.
ID do item de trabalho	workItemId	True	integer	Identificação de um artigo de trabalho.
Formato do Comentário	format		string	Formato de um comentário de item de trabalho (Markdown ou Html).
Texto do comentário	text	True	string	O texto do comentário.

Devoluções

Comentário do Item de Trabalho

Body: WorkItemComment

Criar um item de trabalho

ID da Operação:: CreateWorkItem

Crie um novo item de trabalho com os atributos fornecidos.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
Tipo de item de trabalho	type	True	string	Tipo deste item de trabalho
Retornar todos os campos	shouldReturnAllFields		boolean	Ao definir o valor como 'Não', apenas o ID do item de trabalho será retornado. Se o valor for 'Sim', todos os campos do Item criado juntamente com o ID serão devolvidos. O valor padrão é 'Sim'
Detalhes do item de trabalho	workItem	True	dynamic	Informações a incluir no novo item de trabalho

Devoluções

As saídas desta operação são dinâmicas.

Criar uma nova versão

ID da Operação:: CreateRelease

Crie uma versão, com base em uma definição de versão existente.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
ID da definição de versão	releaseDefId	True	string	O identificador da definição de versão a ser usada.
Description	Description		string	A descrição dos metadados de início da versão.
É rascunho	IsDraft		boolean	Especifica se a versão é um rascunho.
Reason	Reason		string	O motivo para os metadados de início de lançamento.
Nome	Name	True	string	O nome da variável de configuração.
Valor	Value		string	O valor da variável de configuração.

Devoluções

Release

Body: Release

Criar uma solicitação de pull

ID da Operação:: CreateGitPullRequest

Cria um pull request num repositório Git, opcionalmente ligando itens de trabalho e adicionando revisores.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
Nome do repositório	repositoryId	True	string	O nome ou identificador do repositório Git dentro do projeto especificado.
Sucursal de origem	sourceRefName	True	string	O ramo de onde vêm as alterações, por exemplo refs/heads/my-branch.
Ramo Alvo	targetRefName	True	string	O ramo em que as alterações são integradas, por exemplo refs/heads/main.
Title	title	True	string	O título da solicitação pull.
Description	description		string	A descrição do pull request.
É rascunho	isDraft		boolean	Defina para true para criar o pull request como rascunho.
ID do item de trabalho	id		string	O identificador do item de trabalho.
ID do revisor	id		string	O ID de identidade do crítico.
é obrigatório	isRequired		boolean	Indica se o revisor é obrigatório.
Nome	name		string	O nome do rótulo.

Devoluções

Um pull request.

Body: GitPullRequestResponse

Enfileirar uma nova compilação

ID da Operação:: QueueNewBuild

Crie uma compilação, com base em uma definição de compilação existente, e adicione-a à fila de compilação.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
ID da definição de compilação	buildDefId	True	string	O identificador da definição de compilação a ser usada.
Sucursal de origem	sourceBranch		string	A ramificação de origem da compilação.
Parâmetros	parameters		string	Um dicionário JSON de parâmetros de compilação opcionais.

Devoluções

Resultado da construção

Body: BuildResult

Enviar um pedido HTTP para Azure DevOps

ID da Operação:: HttpRequest

Construa uma Azure DevOps REST API request to invoke. Consulte a seguinte ligação para todos os parâmetros de avaliação disponíveis: https://docs.microsoft.com/rest/api/azure/devops

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Método	Method	True	string	O método HTTP.
URI relativo	Uri	True	string	O URI relativo. Exemplo: {project}/{team}/_apis/wit/templates?api-version=5.0-preview.1.
Headers	Headers		object	Os cabeçalhos da solicitação.
Body	Body		string	O conteúdo da solicitação. Pode ser objeto JSON ou dados binários codificados como cadeia de caracteres Base64.
Corpo é Base64	IsBase64		boolean	Deve ser true se o conteúdo da solicitação estiver codificado como cadeia de caracteres Base64.

Devoluções

response: ObjectWithoutType

Executar um pipeline

ID da Operação:: RunPipeline

Coloca em fila uma nova execução de um pipeline YAML. Suporta parâmetros de template, variáveis de runtime, a ramificação a partir da corrida e os estágios a saltar.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
O ID do pipeline	pipelineId	True	integer	O ID do pipeline
A versão do pipeline	pipelineVersion		integer	A versão do pipeline
Repositórios	repositories		object	Recursos do repositório selecionados por alias de recursos, por exemplo self.
Parâmetros do modelo	templateParameters		object	Os parâmetros do template do pipeline, como um objeto JSON de pares nome/valor.
Variables	variables		object	As variáveis de tempo de execução do pipeline, como um objeto JSON indexado pelo nome da variável.
Etapas a Saltar	stagesToSkip		array of string	Os nomes das fases que não deviam correr.
Corrida de Pré-visualização	previewRun		boolean	Defina para true para validar o pipeline sem entrar em fila de execução.

Devoluções

Uma única corrida de pipeline.

Body: PipelineRun

Link para adicionar item de trabalho (Pré-visualização)

ID da Operação:: AddWorkItemLinkAsync

Adiciona um link para um item de trabalho.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	ID do Project ou nome do project
Tipo de item de trabalho	type	True	string	O tipo de item de trabalho do item de trabalho.
ID do item de trabalho	workItemId	True	integer	Identificação de um artigo de trabalho.
Tipo de link	linkType	True	string	Tipo de relação para a ligação. Por defeito é 'System.LinkTypes.Related' quando omitido.
URL de destino	targetUrl	True	string	URL absoluta do alvo do link. Deve ser um URI absoluto e corresponder às expectativas para o Tipo de Link selecionado.
Comment	comment		string	Comentário opcional guardado junto ao link.

Devoluções

As saídas desta operação são dinâmicas.

Link para eliminar item de trabalho (Pré-visualização)

ID da Operação:: DeleteWorkItemLinkAsync

Apaga um link de um item de trabalho.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	ID do Project ou nome do project
Tipo de item de trabalho	type	True	string	O tipo de item de trabalho do item de trabalho.
ID do item de trabalho	workItemId	True	integer	Identificação de um artigo de trabalho.
Id de Relação	linkId		integer	Identificador de relação baseado em zero (attributes.relationId) ou posição do array a partir da resposta do item de trabalho.
Link do Item de Trabalho para Remover	workItemLinkToRemove		uri	URL absoluta do link a eliminar quando não for fornecido um identificador de relação.
Tipo de Relação de Ligação	linkType		string	Tipo de relação (rel) do link a eliminar ao corresponder por URL.

Devoluções

As saídas desta operação são dinâmicas.

Listar campos de itens de trabalho (Pré-visualização)

ID da Operação:: ListWorkItemFieldsAsync

Recupera os campos do item de trabalho disponíveis dentro da organização ou projeto Azure DevOps especificado.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project		string	Projeto opcional dentro da Organização para definir a lista de campos.
Expandir opções	expand		string	Controla quais informações adicionais são devolvidas para cada campo.

Devoluções

Uma lista de modelos VSTS.

Body: VstsList[WorkItemField]

Listar consultas de nível raiz

ID da Operação:: ListRootQueryFolders

Recupera a lista de consultas de item de trabalho de nível raiz em um projeto.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.

Devoluções

Uma lista de modelos VSTS.

Body: VstsList[QueryHierarchyItem]

Listar consultas dentro da pasta

ID da Operação:: ListQueriesInFolder

Recupera a lista de consultas de item de trabalho dentro de uma pasta para um determinado projeto.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
Caminho da pasta	folderPath	True	string	O caminho da pasta sob o qual procurar consultas.

Devoluções

Uma lista de modelos VSTS.

Body: VstsList[QueryHierarchyItem]

Listar definições de versão

ID da Operação:: ListReleaseDefinitions

Recupera a lista de definições de versão associadas a um projeto.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.

Devoluções

Uma lista de modelos VSTS.

Body: VstsList[ReleaseDefinition]

Listar execuções de pipeline

ID da Operação:: ListPipelineRuns

Obtém as 10000 melhores execuções para um pipeline específico

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
O ID do pipeline	pipelineId	True	integer	O ID do pipeline

Devoluções

Body: Run

Listar itens de trabalho

ID da Operação:: ListWorkItems

Retorna uma lista de itens de trabalho.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
IDs de item de trabalho	workItemIds	True	string	A lista separada por vírgulas de IDs de item de trabalho solicitado.
Tipo de item de trabalho	workItemType		string	O tipo de item de trabalho para o qual gerar o esquema.

Devoluções

As saídas desta operação são dinâmicas.

Listar iterações

ID da Operação:: ListIterations

Recupera a lista de iterações de um projeto.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
Nome da Equipa	team	True	string	O nome da equipe dentro do projeto.

Devoluções

Uma lista de modelos VSTS.

Body: VstsList[TeamSettingsIteration]

Listar organizações

ID da Operação:: ListAccounts

Recupera a lista de Organizações das quais o usuário é membro.

Devoluções

Uma lista de modelos VSTS.

Body: VstsList[Account]

Listar pipelines

ID da Operação:: ListPipelines

Recupera a lista de pipelines em um projeto.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.

Devoluções

Body: Pipeline

Listar projetos

ID da Operação:: ListProjects

Recupera a lista de projetos em uma organização.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.

Devoluções

Uma lista de modelos VSTS.

Body: VstsList[Project]

Listar ramificações Git (Pré-visualização)

ID da Operação:: ListBuildBranchesAsync

Recupera a lista de branches Git disponíveis nos repositórios do projeto.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.

Devoluções

Uma lista de modelos VSTS.

Body: VstsList[GitRef]

Listar ramos e etiquetas

ID da Operação:: ListGitRefsWithFilter

Recupera as referências de um repositório Git, opcionalmente filtradas por um prefixo de nome de referência, como heads/main.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
Nome do repositório	repositoryId	True	string	O nome ou identificador do repositório Git dentro do projeto especificado.
Filtro de Nome de Referência	filter		string	Um prefixo de nome de referência sem as referências iniciais/, por exemplo heads/main ou tags/.
Etiquetas de descascamento	peelTags		boolean	Defina como true para resolver etiquetas anotadas no commit para o qual apontam.

Devoluções

Uma lista de referências do Git.

Body: GitRefList

Listar repositórios Git

ID da Operação:: ListGitRepositories

Recupera a lista de repositórios Git em um projeto.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.

Devoluções

Uma lista de modelos VSTS.

Body: VstsList[GitRepository]

Listar tipos de item de trabalho

ID da Operação:: ListWorkItemTypes

Recupera a lista de Tipos de Itens de Trabalho acessíveis num dado projeto Azure DevOps.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.

Devoluções

Uma lista de modelos VSTS.

Body: VstsList[WorkItemType]

Obtenha a linha do tempo da construção (Pré-visualização)

ID da Operação:: GetBuildTimelineAsync

Recupera a linha temporal de uma build específica.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
ID de construção	buildId	True	integer	O identificador da build para recuperar a linha temporal.
Linha temporal Id	timelineId		string	Identificador opcional de linha temporal quando existem múltiplas linhas temporais.
ID de alteração	changeId		integer	ID de alteração opcional para recuperar uma alteração específica na linha temporal.
Id do plano	planId		string	Identificador opcional do plano para o cronograma.

Devoluções

Cronologia de construção

Body: Timeline

Obtenha detalhes do item de trabalho (V2) (Pré-visualização)

ID da Operação:: GetWorkItemDetailsV2Async

Obtenha os detalhes de um único item de trabalho com opções opcionais de seleção de campo e expansão.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
Tipo de item de trabalho	typeName	True	string	O tipo de item de trabalho usado para validar o item de trabalho devolvido e controlar as saídas dinâmicas.
ID do item de trabalho	id	True	string	O ID único do artigo de trabalho para obter informações.
À data	asOf		date-time	Recupere o item de trabalho a partir desta data e hora.
Expandir	expand		string	Controla quais dados adicionais são incluídos na resposta.

Devoluções

As saídas desta operação são dinâmicas.

Obter anexo de item de trabalho (Pré-visualização)

ID da Operação:: GetWorkItemAttachmentAsync

Descarrega o conteúdo de um anexo de trabalho.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
ID do anexo	attachmentId	True	string	O ID único do anexo para descarregar.
Nome do Project	project		string	Projeto opcional dentro da Organização especificada para definir o âmbito do pedido.
Nome do arquivo	fileName		string	Dica opcional do nome do ficheiro passada ao Azure DevOps ao descarregar o anexo.

Devoluções

Body: WorkItemAttachmentResponse

Obter build (Pré-visualização)

ID da Operação:: GetBuildAsync

Recupera uma build pelo seu identificador.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
ID de construção	buildId	True	integer	O identificador da build a recuperar.

Devoluções

Resultado da construção

Body: BuildResult

Obter conteúdo de ficheiro

ID da Operação:: GetGitItem

Recupera um ficheiro (ou metadados de pasta) de um repositório Git. O texto do ficheiro é devolvido na propriedade Conteúdo.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
Nome do repositório	repositoryId	True	string	O nome ou identificador do repositório Git dentro do projeto especificado.
Caminho do item	path	True	string	O caminho relativo ao repositório do item, por exemplo /docs/readme.md.
Incluir conteúdo	includeContent		boolean	Defina para true para incluir o conteúdo do ficheiro na resposta.
Versão	versionDescriptor.version		string	O branch, tag ou commit para ler o item. Por defeito, o ramo predefinido do repositório.
Tipo de Versão	versionDescriptor.versionType		string	O tipo de versão fornecida na Versão.

Devoluções

Um item (ficheiro ou pasta) num repositório Git.

Body: GitItem

Obter detalhes do item de trabalho

ID da Operação:: GetWorkItemDetails

Obtenha os detalhes de um único item de trabalho.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
Tipo de item de trabalho	typeName	True	string	O tipo de item de trabalho do item de trabalho.
ID do item de trabalho	id	True	string	A id exclusiva do item de trabalho para obter detalhes. O item de trabalho deve ser do tipo especificado em 'Tipo de item de trabalho'.

Devoluções

As saídas desta operação são dinâmicas.

Obter filhos de item de trabalho

ID da Operação:: GetWorkItemChildren

Obtenha uma lista de crianças (tamanho máximo 1000) de um único item de trabalho.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
ID do item de trabalho	id	True	string	O id exclusivo do item de trabalho para obter as crianças.
Tipo de item de trabalho para crianças	workItemType		string	O tipo do(s) artigo(s) de trabalho das crianças

Devoluções

As saídas desta operação são dinâmicas.

Obter resultados da consulta

ID da Operação:: GetQueryResultsV2

Recupera o resultado de uma consulta de item de trabalho.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
ID da consulta	queryId	True	string	O Id da consulta armazenada a ser executada.
Número de itens de trabalho a devolver	workItemsCount		integer	Contagem máxima de itens de trabalho para recuperar (1 - 20000)
Falhar se os resultados da consulta forem alterados	throwIfQueryChanged		boolean	Se os resultados da consulta mudarem durante a execução do fluxo, a execução do fluxo deverá falhar para evitar inconsistências.

Devoluções

As saídas desta operação são dinâmicas.

Obter resultados da consulta [DEPRECATED]

ID da Operação:: GetQueryResults

Esta ação foi preterida. Em vez disso, use Obter resultados da consulta .

~~Recupera o resultado de uma consulta de item de trabalho.~~

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
ID da consulta	queryId	True	string	O Id da consulta armazenada a ser executada.

Devoluções

Uma lista de modelos VSTS.

Body: VstsList[JObject]

Obter um perfil de utilizador

ID da Operação:: GetProfile

Obtém um perfil de usuário.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
ID do perfil	id	True	string	O ID do perfil dentro da mesma organização, ou 'eu' para obter o perfil do usuário autenticado atual.

Devoluções

Profile

Body: Profile

Obter uma execução de pipeline

ID da Operação:: GetPipelineRun

Recupera uma única execução de um pipeline, incluindo o seu estado, resultado e parâmetros do template.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
O ID do pipeline	pipelineId	True	integer	O ID do pipeline
Id de execução	runId	True	integer	O identificador da corrida do pipeline.

Devoluções

Uma única corrida de pipeline.

Body: PipelineRun

Pesquisar itens de trabalho

ID da Operação:: SearchWorkItemsAsync

Fornece um conjunto de resultados para o texto da pesquisa.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
Pesquisar Texto	searchText	True	string	O texto da pesquisa.
Pular	$skip		integer	Número de resultados a ignorar. O valor padrão é 0.
Início	$top		integer	Número de resultados a devolver. O padrão é 100.
Filtros	filters		object	Filtros a aplicar. Define-o como null se não houver filtros a aplicar.
Incluir Facetas	includeFacets		boolean	Marque para optar pelo facetado no resultado. O comportamento padrão é falso.
Campo	field		string	Nome do campo em que ordenação deve ser feita.
Ordem de classificação	sortOrder		string	Ordem (ASC/DESC) em que os resultados devem ser organizados.

Devoluções

Resposta de Pesquisa por Item de Trabalho

Body: WorkItemSearchResponse

Receba comentários sobre itens de trabalho (Pré-visualização)

ID da Operação:: GetWorkItemCommentsAsync

Recupera comentários de um item de trabalho.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
ID do item de trabalho	workItemId	True	integer	O ID único do artigo de trabalho para obter comentários.
Número máximo de comentários a regressar	$top		integer	Número máximo de comentários para responder.
Ordem de ordenação dos comentários	order		string	Ordenar os comentários. Por defeito é 'desc'.
Incluir comentários eliminados	includeDeleted		boolean	Se deve incluir comentários que foram apagados de forma suave.
Expandir opções	$expand		string	Controla quais os dados adicionais dos comentários que devem ser devolvidos.

Devoluções

Representa a resposta que contém comentários sobre itens de trabalho.

Body: WorkItemCommentsResponse

Requerentes de compilações de listas (Pré-visualização)

ID da Operação:: ListBuildRequestersAsync

Recupera membros únicos do projeto que podem ser usados para filtrar builds pela identidade solicitada.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.

Devoluções

Uma lista de modelos VSTS.

Body: VstsList[TeamMember]

Acionadores

Quando o código é enviado por push (Git)	Aciona um fluxo quando o código é enviado por push para um repositório Git.
Quando o código é verificado (TFVC)	Aciona um fluxo quando o código é verificado em um projeto de controle de versão do Team Foundation.
Quando um item de trabalho é atribuído	Aciona um fluxo quando um item de trabalho que corresponde aos critérios fornecidos é atribuído ao usuário determinado.
Quando um item de trabalho é atribuído [DEPRECATED]	Esta ação foi preterida. Por favor, use Quando um item de trabalho é atribuído em vez disso. ~~Aciona um fluxo quando um item de trabalho que corresponde aos critérios fornecidos é atribuído ao usuário determinado.~~
Quando um item de trabalho é atualizado	Aciona um fluxo quando um item de trabalho que corresponde aos critérios fornecidos é atualizado.
Quando um item de trabalho é atualizado [DEPRECATED]	Esta ação foi preterida. Em vez disso, use Quando um item de trabalho é atualizado . ~~Aciona um fluxo quando um item de trabalho que corresponde aos critérios fornecidos é atualizado.~~
Quando um item de trabalho é criado	Aciona um fluxo quando um item de trabalho que corresponde aos critérios fornecidos é criado.
Quando um item de trabalho é criado [DEPRECATED]	Esta ação foi preterida. Em vez disso, use Quando um item de trabalho é criado . ~~Aciona um fluxo quando um item de trabalho que corresponde aos critérios fornecidos é criado.~~
Quando um item de trabalho é fechado	Aciona um fluxo quando um item de trabalho que corresponde aos critérios fornecidos é fechado.
Quando um item de trabalho é fechado [DEPRECATED]	Esta ação foi preterida. Em vez disso, use Quando um item de trabalho estiver fechado . ~~Aciona um fluxo quando um item de trabalho que corresponde aos critérios fornecidos é fechado.~~
Quando uma compilação é concluída	Aciona um fluxo quando uma compilação é concluída.
Quando uma solicitação pull é criada (Git)	Aciona um fluxo quando uma solicitação pull que corresponde aos critérios fornecidos é criada.
Quando uma solicitação pull é fechada (Git)	Aciona um fluxo quando uma solicitação pull que corresponde aos critérios fornecidos é fechada.

Quando o código é enviado por push (Git)

ID da Operação:: OnGitPush

Aciona um fluxo quando o código é enviado por push para um repositório Git.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
Nome do repositório	repository	True	string	O nome do repositório dentro do projeto especificado.
Nome Ref	refName		string	O nome da referência do Git, como uma ramificação ou tag.

Devoluções

Uma lista de modelos VSTS.

Body: VstsList[GitPush]

Quando o código é verificado (TFVC)

ID da Operação:: OnTfvcCheckIn

Aciona um fluxo quando o código é verificado em um projeto de controle de versão do Team Foundation.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
Nome da Equipa	team		string	O nome da equipa que pretende selecionar um autor.
Membro da Equipa	author		string	O nome exclusivo do membro da equipe que criou o check-in.

Devoluções

Uma lista de modelos VSTS.

Body: VstsList[TfvcChangeset]

Quando um item de trabalho é atribuído

ID da Operação:: OnWorkItemAssignedV2

Aciona um fluxo quando um item de trabalho que corresponde aos critérios fornecidos é atribuído ao usuário determinado.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
Nome da Equipa (para escolher Atribuído a)	team	True	string	O nome da equipe da qual selecionar um membro.
Atribuído A	wiql__System_AssignedTo	True	string	O nome do membro da equipe que atualmente possui o item de trabalho.
Tipo	wiql__System_WorkItemType		string	O nome do tipo de item de trabalho.
Caminho da Área	wiql__System_AreaPath		string	O recurso do produto ou a área da equipe em que o item de trabalho está.
Comparação de caminhos de área	areaPathComparison		string	A regra a ser usada ao comparar o campo Caminho da área.
Caminho de Iteração	wiql__System_IterationPath		string	O sprint nomeado ou período de tempo em que o item de trabalho está.
Comparação de caminhos de iteração	iterationPathComparison		string	A regra a ser usada ao comparar o campo Caminho de Iteração.
Priority	wiql__Microsoft_VSTS_Common_Priority		string	Uma classificação subjetiva do bug, problema, tarefa ou caso de teste em relação ao negócio.
Criado por	wiql__System_CreatedBy		string	O nome do membro da equipe que criou o item de trabalho.

Devoluções

As saídas desta operação são dinâmicas.

Quando um item de trabalho é atribuído [DEPRECATED]

ID da Operação:: OnWorkItemAssigned

Esta ação foi preterida. Por favor, use Quando um item de trabalho é atribuído em vez disso.

~~Aciona um fluxo quando um item de trabalho que corresponde aos critérios fornecidos é atribuído ao usuário determinado.~~

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
Atribuído A	wiql__System_AssignedTo	True	string	O nome do membro da equipe que atualmente possui o item de trabalho.
Nome da Equipa (para escolher Atribuído a)	team		string	O nome da equipe da qual selecionar um membro.
Tipo	wiql__System_WorkItemType		string	O nome do tipo de item de trabalho.
Caminho da Área	wiql__System_AreaPath		string	O recurso do produto ou a área da equipe em que o item de trabalho está.
Comparação de caminhos de área	areaPathComparison		string	A regra a ser usada ao comparar o campo Caminho da área.
Caminho de Iteração	wiql__System_IterationPath		string	O sprint nomeado ou período de tempo em que o item de trabalho está.
Comparação de caminhos de iteração	iterationPathComparison		string	A regra a ser usada ao comparar o campo Caminho de Iteração.
Priority	wiql__Microsoft_VSTS_Common_Priority		string	Uma classificação subjetiva do bug, problema, tarefa ou caso de teste em relação ao negócio.
Projeto de Equipa	wiql__System_TeamProject		string	O projeto de equipe ao qual este item de trabalho pertence.
Criado por	wiql__System_CreatedBy		string	O nome do membro da equipe que criou o item de trabalho.

Devoluções

As saídas desta operação são dinâmicas.

Quando um item de trabalho é atualizado

ID da Operação:: OnWorkItemUpdatedV2

Aciona um fluxo quando um item de trabalho que corresponde aos critérios fornecidos é atualizado.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
Nome da Equipa (para escolher Atribuído a)	team		string	O nome da equipa a partir da qual selecionar um cessionário.
Atribuído A	wiql__System_AssignedTo		string	O nome do membro da equipe que atualmente possui o item de trabalho.
Tipo	wiql__System_WorkItemType		string	O nome do tipo de item de trabalho.
Caminho da Área	wiql__System_AreaPath		string	O recurso do produto ou a área da equipe em que o item de trabalho está.
Comparação de caminhos de área	areaPathComparison		string	A regra a ser usada ao comparar o campo Caminho da área.
Caminho de Iteração	wiql__System_IterationPath		string	O sprint nomeado ou período de tempo em que o item de trabalho está.
Comparação de caminhos de iteração	iterationPathComparison		string	A regra a ser usada ao comparar o campo Caminho de Iteração.
Priority	wiql__Microsoft_VSTS_Common_Priority		string	Uma classificação subjetiva do bug, problema, tarefa ou caso de teste em relação ao negócio.
Criado por	wiql__System_CreatedBy		string	O nome do membro da equipe que criou o item de trabalho.

Devoluções

As saídas desta operação são dinâmicas.

Quando um item de trabalho é atualizado [DEPRECATED]

ID da Operação:: OnWorkItemUpdated

Esta ação foi preterida. Em vez disso, use Quando um item de trabalho é atualizado .

~~Aciona um fluxo quando um item de trabalho que corresponde aos critérios fornecidos é atualizado.~~

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
Nome da Equipa (para escolher Atribuído a)	team		string	O nome da equipa a partir da qual selecionar um cessionário.
Atribuído A	wiql__System_AssignedTo		string	O nome do membro da equipe que atualmente possui o item de trabalho.
Tipo	wiql__System_WorkItemType		string	O nome do tipo de item de trabalho.
Caminho da Área	wiql__System_AreaPath		string	O recurso do produto ou a área da equipe em que o item de trabalho está.
Comparação de caminhos de área	areaPathComparison		string	A regra a ser usada ao comparar o campo Caminho da área.
Caminho de Iteração	wiql__System_IterationPath		string	O sprint nomeado ou período de tempo em que o item de trabalho está.
Comparação de caminhos de iteração	iterationPathComparison		string	A regra a ser usada ao comparar o campo Caminho de Iteração.
Priority	wiql__Microsoft_VSTS_Common_Priority		string	Uma classificação subjetiva do bug, problema, tarefa ou caso de teste em relação ao negócio.
Projeto de Equipa	wiql__System_TeamProject		string	O projeto de equipe ao qual este item de trabalho pertence.
Criado por	wiql__System_CreatedBy		string	O nome do membro da equipe que criou o item de trabalho.

Devoluções

As saídas desta operação são dinâmicas.

Quando um item de trabalho é criado

ID da Operação:: OnWorkItemCreatedV2

Aciona um fluxo quando um item de trabalho que corresponde aos critérios fornecidos é criado.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
Nome da Equipa (para escolher Atribuído a)	team		string	O nome da equipa a partir da qual selecionar um cessionário.
Atribuído A	wiql__System_AssignedTo		string	O nome do membro da equipe que atualmente possui o item de trabalho.
Tipo	wiql__System_WorkItemType		string	O nome do tipo de item de trabalho.
Caminho da Área	wiql__System_AreaPath		string	O recurso do produto ou a área da equipe em que o item de trabalho está.
Comparação de caminhos de área	areaPathComparison		string	A regra a ser usada ao comparar o campo Caminho da área.
Caminho de Iteração	wiql__System_IterationPath		string	O sprint nomeado ou período de tempo em que o item de trabalho está.
Comparação de caminhos de iteração	iterationPathComparison		string	A regra a ser usada ao comparar o campo Caminho de Iteração.
Priority	wiql__Microsoft_VSTS_Common_Priority		string	Uma classificação subjetiva do bug, problema, tarefa ou caso de teste em relação ao negócio.
Criado por	wiql__System_CreatedBy		string	O nome do membro da equipe que criou o item de trabalho.

Devoluções

As saídas desta operação são dinâmicas.

Quando um item de trabalho é criado [DEPRECATED]

ID da Operação:: OnWorkItemCreated

Esta ação foi preterida. Em vez disso, use Quando um item de trabalho é criado .

~~Aciona um fluxo quando um item de trabalho que corresponde aos critérios fornecidos é criado.~~

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
Nome da Equipa (para escolher Atribuído a)	team		string	O nome da equipa a partir da qual selecionar um cessionário.
Atribuído A	wiql__System_AssignedTo		string	O nome do membro da equipe que atualmente possui o item de trabalho.
Tipo	wiql__System_WorkItemType		string	O nome do tipo de item de trabalho.
Caminho da Área	wiql__System_AreaPath		string	O recurso do produto ou a área da equipe em que o item de trabalho está.
Comparação de caminhos de área	areaPathComparison		string	A regra a ser usada ao comparar o campo Caminho da área.
Caminho de Iteração	wiql__System_IterationPath		string	O sprint nomeado ou período de tempo em que o item de trabalho está.
Comparação de caminhos de iteração	iterationPathComparison		string	A regra a ser usada ao comparar o campo Caminho de Iteração.
Priority	wiql__Microsoft_VSTS_Common_Priority		string	Uma classificação subjetiva do bug, problema, tarefa ou caso de teste em relação ao negócio.
Projeto de Equipa	wiql__System_TeamProject		string	O projeto de equipe ao qual este item de trabalho pertence.
Criado por	wiql__System_CreatedBy		string	O nome do membro da equipe que criou o item de trabalho.

Devoluções

As saídas desta operação são dinâmicas.

Quando um item de trabalho é fechado

ID da Operação:: OnWorkItemClosedV2

Aciona um fluxo quando um item de trabalho que corresponde aos critérios fornecidos é fechado.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
Nome da Equipa (para escolher Atribuído a)	team		string	O nome da equipa a partir da qual selecionar um cessionário.
Atribuído A	wiql__System_AssignedTo		string	O nome do membro da equipe que atualmente possui o item de trabalho.
Tipo	wiql__System_WorkItemType		string	O nome do tipo de item de trabalho.
Estado fechado	closedState		string	A lista de valores separados por vírgulas do campo Estado que indica como o item de trabalho foi fechado (Concluído, Fechado, Concluído, Inativo).
Caminho da Área	wiql__System_AreaPath		string	O recurso do produto ou a área da equipe em que o item de trabalho está.
Comparação de caminhos de área	areaPathComparison		string	A regra a ser usada ao comparar o campo Caminho da área.
Caminho de Iteração	wiql__System_IterationPath		string	O sprint nomeado ou período de tempo em que o item de trabalho está.
Comparação de caminhos de iteração	iterationPathComparison		string	A regra a ser usada ao comparar o campo Caminho de Iteração.
Priority	wiql__Microsoft_VSTS_Common_Priority		string	Uma classificação subjetiva do bug, problema, tarefa ou caso de teste em relação ao negócio.
Criado por	wiql__System_CreatedBy		string	O nome do membro da equipe que criou o item de trabalho.

Devoluções

As saídas desta operação são dinâmicas.

Quando um item de trabalho é fechado [DEPRECATED]

ID da Operação:: OnWorkItemClosed

Esta ação foi preterida. Em vez disso, use Quando um item de trabalho estiver fechado .

~~Aciona um fluxo quando um item de trabalho que corresponde aos critérios fornecidos é fechado.~~

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
Nome da Equipa (para escolher Atribuído a)	team		string	O nome da equipa a partir da qual selecionar um cessionário.
Atribuído A	wiql__System_AssignedTo		string	O nome do membro da equipe que atualmente possui o item de trabalho.
Tipo	wiql__System_WorkItemType		string	O nome do tipo de item de trabalho.
Caminho da Área	wiql__System_AreaPath		string	O recurso do produto ou a área da equipe em que o item de trabalho está.
Comparação de caminhos de área	areaPathComparison		string	A regra a ser usada ao comparar o campo Caminho da área.
Caminho de Iteração	wiql__System_IterationPath		string	O sprint nomeado ou período de tempo em que o item de trabalho está.
Comparação de caminhos de iteração	iterationPathComparison		string	A regra a ser usada ao comparar o campo Caminho de Iteração.
Priority	wiql__Microsoft_VSTS_Common_Priority		string	Uma classificação subjetiva do bug, problema, tarefa ou caso de teste em relação ao negócio.
Projeto de Equipa	wiql__System_TeamProject		string	O projeto de equipe ao qual este item de trabalho pertence.
Criado por	wiql__System_CreatedBy		string	O nome do membro da equipe que criou o item de trabalho.

Devoluções

As saídas desta operação são dinâmicas.

Quando uma compilação é concluída

ID da Operação:: OnBuildCompleted

Aciona um fluxo quando uma compilação é concluída.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
Filtrar por resultado	resultFilter		string	Uma opção que indica qual resultado de compilação deve ser acionado. As opções válidas incluem '', 'succeeded', 'partiallySucceeded', 'failed' ou 'canceled'.
Filtrar por ID de definição	definitions		string	Uma opção que indica qual id de definição de compilação deve ser acionado.

Devoluções

Uma lista de modelos VSTS.

Body: VstsList[BuildResult]

Quando uma solicitação pull é criada (Git)

ID da Operação:: OnGitPullCreated

Aciona um fluxo quando uma solicitação pull que corresponde aos critérios fornecidos é criada.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
Nome do repositório	repository	True	string	O nome do repositório dentro do projeto especificado.
Nome da Ref da Fonte	sourceRefName		string	O nome da referência do Git, como uma ramificação ou tag.
Nome da referência de destino	targetRefName		string	O nome da referência do Git, como uma ramificação ou tag.

Devoluções

Uma lista de modelos VSTS.

Body: VstsList[GitPullRequest]

Quando uma solicitação pull é fechada (Git)

ID da Operação:: OnGitPullClosed

Aciona um fluxo quando uma solicitação pull que corresponde aos critérios fornecidos é fechada.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da organização especificada.
Nome do repositório	repository	True	string	O nome do repositório dentro do projeto especificado.
Nome da Ref da Fonte	sourceRefName		string	O nome da referência do Git, como uma ramificação ou tag.
Nome da referência de destino	targetRefName		string	O nome da referência do Git, como uma ramificação ou tag.

Devoluções

Uma lista de modelos VSTS.

Body: VstsList[GitPullRequest]

Definições

VstsList[Conta]

Uma lista de modelos VSTS.

Nome	Caminho	Tipo	Descrição
Valor	value	array of Account	Os modelos VSTS

Account

Nome	Caminho	Tipo	Descrição
ID da conta	accountId	string	O id da conta.
URI da conta	accountUri	string	O URI da conta.
Nome da Conta	accountName	string	O nome da conta.
Proprietário da Conta	accountOwner	string	O proprietário do conjunto da conta.
Nome da Organização	organizationName	string	O nome da organização correspondente à conta.
Tipo de Conta	accountType	string	O tipo da conta.

Profile

Nome	Caminho	Tipo	Descrição
nome de exibição	displayName	string	Nome de exibição do usuário
id	id	string	O identificador exclusivo do perfil.
publicAlias	publicAlias	string	Alias Público.
Endereço de E-mail	emailAddress	string	Endereço de e-mail da conta.
Carimbo de data/hora	timeStamp	date-time	O momento em que este perfil foi alterado pela última vez.
revisão	revision	integer	O número máximo de revisão de qualquer atributo.
CoreRevision	coreRevision	integer	CoreRevision

VstsList[TeamSettingsIteration]

Uma lista de modelos VSTS.

Nome	Caminho	Tipo	Descrição
Valor	value	array of TeamSettingsIteration	Os modelos VSTS

TeamSettingsIteration

Iteração de trabalho (ágil)

Nome	Caminho	Tipo	Descrição
Attributes	Attributes	TeamIterationAttributes	Atributos de iteração da equipe
Id	Id	string	Id do recurso.
Nome	Name	string	Nome do recurso.
Caminho	Path	string	Caminho relativo para a iteração.
Links	_links	object	Coleção de links relevantes para o recurso.
URL	Url	string	Link HTTP completo para o recurso.

TeamIterationAttributes

Atributos de iteração da equipe

Nome	Caminho	Tipo	Descrição
Data de Conclusão	FinishDate	date-time	O atributo de iteração da equipe de data de término.
Data de início	StartDate	date-time	O atributo de iteração da equipe de data de início.

Links

Nome	Caminho	Tipo	Descrição
Web	web	WebLinks	Ligações Web

Ligações Web.

Ligações Web

Nome	Caminho	Tipo	Descrição
HTML Link	href	string	O URL da Web dos detalhes da compilação

BuildResult

Resultado da construção

Nome	Caminho	Tipo	Descrição
ID de construção	id	integer	O identificador exclusivo da compilação.
Número de compilação	buildNumber	string	O número da compilação.
Sucursal de origem	sourceBranch	string	A ramificação de controle do código-fonte usada pela compilação.
Versão original	sourceVersion	string	A versão de controle do código-fonte usada pela compilação.
Situação	status	string	O status da compilação.
Priority	priority	string	A prioridade da construção.
Tempo de fila	queueTime	date-time	A hora em que a compilação estava na fila.
Hora de Início	startTime	date-time	A hora em que a compilação começou.
Hora de Término	finishTime	date-time	O tempo que a construção terminou.
Reason	reason	string	A razão para a construção.
Result	result	string	O resultado da construção.
solicitadoPor	requestedFor	BuildRequestUser	Usuário de solicitação de compilação
Parâmetros	parameters	string	Parâmetros passados para a compilação, se houver.
Definição	definition	BuildResultDefinition	Definição de resultados de compilação
_links	_links	Links	Links
Etiquetas	tags	array of string	As etiquetas aplicavam-se à construção.
Parâmetros do modelo	templateParameters	object	Os parâmetros do template com que a execução foi colocada em fila.

BuildRequestUser

Usuário de solicitação de compilação

Nome	Caminho	Tipo	Descrição
Solicitado para	uniqueName	string	O nome exclusivo do usuário para o qual a compilação foi solicitada.

BuildResultDefinition

Definição de resultados de compilação

Nome	Caminho	Tipo	Descrição
ID da definição de compilação	id	integer	O identificador da definição de compilação.
Nome da definição de compilação	name	string	O nome da definição de compilação.

VstsList[BuildResult]

Uma lista de modelos VSTS.

Nome	Caminho	Tipo	Descrição
Valor	value	array of BuildResult	Os modelos VSTS

Linha cronológica

Cronologia de construção

Nome	Caminho	Tipo	Descrição
Linha temporal Id	id	uuid	Identificador da linha temporal.
ID de alteração	changeId	integer	Identificador de alteração da linha temporal.
Última alteração por	lastChangedBy	uuid	O processo ou a pessoa que finalmente mudou a linha temporal.
Última alteração em	lastChangedOn	date-time	A última vez que a linha temporal foi alterada.
Recordes da Linha do Tempo	records	array of TimelineRecord	Registos da linha temporal.

CronologiaRecorde

Registo da linha temporal

Nome	Caminho	Tipo	Descrição
ID do registo	id	uuid	Identificador de registo.
ID de alteração	changeId	integer	Identificador de alteração de registo.
ID principal	parentId	uuid	Identificador de registo parental.
Tipo	type	string	Tipo de registo.
Nome	name	string	Nome do disco.
Hora de Início	startTime	date-time	Recorde a hora de início.
Hora de Término	finishTime	date-time	Tempo recorde de chegada.
Estado	state	string	Estado recorde.
Result	result	string	Resultado recorde.
Nome do trabalhador	workerName	string	Trabalhador a processar o registo.
Tentativa	attempt	integer	Número de recorde da tentativa.
Identificador	identifier	string	Valor do identificador de registo.
Issues	issues	array of TimelineIssue	Problemas encontrados pelo disco.
registar	log	TimelineLogReference	Referência do registo da linha temporal
Encomenda	order	integer	Registo da ordem de execução.
details	details	TimelineReference	Referência da linha temporal
tarefa	task	TimelineTask	Tarefa da linha temporal
Tentativas anteriores	previousAttempts	array of TimelineReference	Tentativas de recorde anteriores.
Percentagem Concluída	percentComplete	integer	Percentagem recorde concluída.
Operação atual	currentOperation	string	Operação recorde atual.
URL	url	string	URL de gravação.
Código de Resultado	resultCode	string	Registar o código do resultado.
Propriedades	properties	object	Propriedades do disco.

Questão da Linha do Tempo

Questão da linha temporal

Nome	Caminho	Tipo	Descrição
Tipo	type	string	Tipo de problema.
Categoria	category	string	Categoria de questão.
Mensagem	message	string	Mensagem de emissão.
Dados	data	object	Dados da questão.
Código de Erro	errorCode	string	Emitir código de erro.
Código de aviso	warningCode	string	Emitir o código de aviso.

TimelineLogReference

Referência do registo da linha temporal

Nome	Caminho	Tipo	Descrição
ID de registo	id	integer	Identificador de log.
Tipo	type	string	Tipo de tronco.
Contagem de linhas	lineCount	integer	Número de linhas no registo.
URL	url	string	URL de registo.

TimelineReference

Referência da linha temporal

Nome	Caminho	Tipo	Descrição
Id	id	uuid	Identificador de referência.
ID de alteração	changeId	integer	Identificador de alteração de referência.

Tarefa da Linha do Tempo

Tarefa da linha temporal

Nome	Caminho	Tipo	Descrição
ID da Tarefa	id	uuid	Identificador de tarefa.
Nome	name	string	Nome da tarefa.
Versão	version	string	Versão da tarefa.

VstsList[GitRepository]

Uma lista de modelos VSTS.

Nome	Caminho	Tipo	Descrição
Valor	value	array of GitRepository	Os modelos VSTS

GitRepositório

Repositório Git

Nome	Caminho	Tipo	Descrição
ID do repositório	id	string	O id exclusivo do repositório.
Nome do repositório	name	string	O nome do repositório.
URL do navegador do repositório	url	string	A URL é o ponto de extremidade da API para o repositório.
URL remoto do repositório	remoteUrl	string	O URL através do qual o git pode sincronizar com este repositório.

VstsList[GitRef]

Uma lista de modelos VSTS.

Nome	Caminho	Tipo	Descrição
Valor	value	array of GitRef	Os modelos VSTS

GitRef

Git Ref

Nome	Caminho	Tipo	Descrição
Ref Id	objectId	string	O ID único do árbitro.
Nome Ref	name	string	O nome do árbitro.

VstsList[GitPush]

Uma lista de modelos VSTS.

Nome	Caminho	Tipo	Descrição
Valor	value	array of GitPush	Os modelos VSTS

GitPush

Git Empurrar

Nome	Caminho	Tipo	Descrição
repositório	repository	GitRepository	Repositório Git
empurradoPor	pushedBy	GitPushUser	Usuário do Git Push
Ref Atualizações	refUpdates	array of GitRefUpdate	As Refs que foram atualizadas como parte deste push.
ID de envio	pushId	integer	O id único do push.
Date	date	date-time	A data em que o push foi criado.

GitPushUser

Usuário do Git Push

Nome	Caminho	Tipo	Descrição
Identificação do Empurrador	id	string	O identificador exclusivo do usuário que criou o push.
Nome do Pusher	displayName	string	O nome do usuário que criou o push.
Nome Exclusivo do Pusher	uniqueName	string	O nome exclusivo do usuário que criou o push.
URL da imagem do Pusher	imageUrl	string	O url para a imagem para este usuário.

VstsList[GitPullRequest]

Uma lista de modelos VSTS.

Nome	Caminho	Tipo	Descrição
Valor	value	array of GitPullRequest	Os modelos VSTS

GitPullRequest

Solicitação de pull do Git

Nome	Caminho	Tipo	Descrição
repositório	repository	GitRepository	Repositório Git
Pull Request Id	pullRequestId	integer	O id exclusivo da solicitação pull.
criado por	createdBy	PullRequestCreatedBy	Pull Request criado por
Data de criação	creationDate	date-time	A data em que a solicitação pull foi criada
Data de encerramento	closedDate	date-time	A data em que a solicitação pull foi fechada (concluída, abandonada ou mesclada externamente)
Title	title	string	O título do pull request
Description	description	string	A descrição do pull request
Nome da Ref da Fonte	sourceRefName	string	O nome da ramificação de origem da solicitação pull
Nome da referência de destino	targetRefName	string	O nome da ramificação de destino da solicitação pull
É rascunho	isDraft	boolean	Solicitação de pull de rascunho / WIP
Revisores	reviewers	array of PullRequestReviewer	Grupos ou equipas para os quais este revisor contribuiu.
Lista de Revisores	reviewerList	string	Uma lista separada por ponto-e-vírgula de nomes exclusivos de revisores que são endereços de e-mail válidos
Lista de Revisores Obrigatórios	requiredReviewerList	string	Uma lista separada por ponto-e-vírgula de nomes exclusivos de revisores necessários que são endereços de e-mail válidos
Consolidações	commits	array of GitCommitRef	Os commits contidos no pull request.
conclusãoOpções	completionOptions	PullRequestCompletionOptions	Opções de conclusão de solicitação pull
mesclarOpções	mergeOptions	PullRequestMergeOptions	Opções de mesclagem de solicitação pull
Mensagem de falha de mesclagem	mergeFailureMessage	string	Se definido, a mesclagem de solicitação pull falhou por esse motivo.
fechadoPor	closedBy	PullRequestClosedBy	Pull Request Fechado por
autoCompleteSetBy	autoCompleteSetBy	PullRequestAutoCompleteSetBy	Pull Request Auto Complete set By
Endereço URL	url	string	A url da solicitação pull.
URL remoto	remoteUrl	string	A url remota para a solicitação pull.
ID do artefato	artifactId	string	Uma cadeia de caracteres que identifica exclusivamente essa solicitação pull.
ID de mesclagem	mergeId	string	A id de mesclagem da solicitação pull.
ID de revisão de código	codeReviewId	integer	A ID de revisão de código da solicitação pull.
Tempo da fila de conclusão	completionQueueTime	string	A data mais recente em que a solicitação pull entrou na fila para ser concluída.
Suporta iterações	supportsIterations	boolean	Se verdadeiro, essa solicitação pull suporta várias iterações.

PullRequestCreatedBy

Pull Request criado por

Nome	Caminho	Tipo	Descrição
Criado por Nome de Exibição	displayName	string	O nome para exibição do criador da solicitação pull.
Criado por nome exclusivo	uniqueName	string	O nome exclusivo do criador da solicitação pull.
Criado por Id	id	string	O Id do criador da solicitação pull.
Criado por Image Url	imageUrl	string	O url para a imagem do criador da solicitação pull.
Criado por Url	url	string	A url do criador da solicitação pull.

PullRequestFechadoPor

Pull Request Fechado por

Nome	Caminho	Tipo	Descrição
Fechado por nome de exibição	displayName	string	O nome de exibição da solicitação pull mais perto.
Fechado por nome exclusivo	uniqueName	string	O nome exclusivo da solicitação pull mais perto.
Fechado por Id	id	string	O Id da solicitação pull mais perto.
Fechado por URL da imagem	imageUrl	string	O url para a imagem da solicitação pull mais perto.
Fechado por url	url	string	A url da solicitação pull mais próxima.

PullRequestAutoCompleteSetBy

Pull Request Auto Complete set By

Nome	Caminho	Tipo	Descrição
Preenchimento automático definido por nome de exibição	displayName	string	O nome para exibição do usuário que habilitou o preenchimento automático.
Conjunto de preenchimento automático por nome exclusivo	uniqueName	string	O nome exclusivo do usuário que habilitou o preenchimento automático.
Preenchimento automático definido por id	id	string	A ID do usuário que habilitou o preenchimento automático.
Auto Complete set By Image Url	imageUrl	string	A url para a imagem do usuário que ativou o preenchimento automático.
Preenchimento automático definido por url	url	string	A url do usuário que ativou o preenchimento automático.

PullRequestReviewer

Revisor de solicitação pull

Nome	Caminho	Tipo	Descrição
Nome de exibição do revisor	displayName	string	O nome para exibição do revisor de solicitação pull.
Nome exclusivo do revisor	uniqueName	string	O nome exclusivo do revisor de solicitação pull.
ID do revisor	id	string	O Id do revisor de solicitação pull.
URL do revisor	url	string	A url do revisor de solicitação pull.
Recusou	hasDeclined	boolean	Indica se este revisor se recusou a revisar essa solicitação pull.
Está sinalizado	isFlagged	boolean	Indica se esse revisor está sinalizado para atenção nessa solicitação pull.
é obrigatório	isRequired	boolean	Indica se este é um revisor necessário para essa solicitação pull.
Voto	vote	integer	Votação de um pull request: aprovado(10), aprovado com sugestões(5), sem voto(0), aguardando autor(-5), rejeitado(-10).
Votado a favor	votedFor	array of PullRequestReviewer	Grupos ou equipas para os quais este revisor contribuiu.

PullRequestMergeOptions

Opções de mesclagem de solicitação pull

Nome	Caminho	Tipo	Descrição
Sem avanço rápido	noFastForward	string	Uma fusão biparental, sem avanço rápido. A ramificação de origem permanece inalterada. Este é o comportamento padrão.
Rebase	rebase	string	Rebaseie a ramificação de origem sobre a confirmação HEAD da ramificação de destino e avance rapidamente a ramificação de destino.
Mesclagem de rebase	rebaseMerge	string	Rebaseie a ramificação de origem sobre a confirmação HEAD da ramificação de destino e crie uma mesclagem pai e sem avanço rápido.
Squash	squash	string	Coloque todas as alterações da solicitação pull em uma confirmação monoparental.

PullRequestMergeStrategy

Estratégia de mesclagem de solicitação pull

Nome	Caminho	Tipo	Descrição
Autoria de Conflitos	conflictAuthorshipCommits	boolean	Se verdadeiro, as resoluções de conflitos aplicadas durante a mesclagem serão colocadas em commits separados para preservar as informações de autoria para a culpa do git.
Detetar Renomear Falsos Positivos	detectRenameFalsePositives	boolean	Se verdadeiro, deteta renomear falsos positivos.
Desativar Renomeações	disableRenames	boolean	Se verdadeiro, a deteção de renomeação não será executada durante a mesclagem.

PullRequestCompletionOptions

Opções de conclusão de solicitação pull

Nome	Caminho	Tipo	Descrição
Preenchimento automático Ignorar IDs de configuração	autoCompleteIgnoreConfigIds	array of integer	Lista de quaisquer IDs de configuração de política que o preenchimento automático não deve esperar
Política de desvio	bypassPolicy	boolean	Se verdadeiro, as políticas serão explicitamente ignoradas enquanto a solicitação pull for concluída.
Motivo do desvio	bypassReason	string	Se as políticas forem ignoradas, esse motivo será armazenado quanto ao motivo pelo qual o bypass foi usado.
Excluir ramificação de origem	deleteSourceBranch	boolean	Se verdadeiro, a ramificação de origem da solicitação pull será excluída após a conclusão.
Mensagem de confirmação de mesclagem	mergeCommitMessage	string	Se definido, isso será usado como a mensagem de confirmação da confirmação de mesclagem.
mergeStrategy	mergeStrategy	PullRequestMergeStrategy	Estratégia de mesclagem de solicitação pull
Fusão de Squash	squashMerge	boolean	Se MergeStrategy não estiver definido, a estratégia de mesclagem não será fast-forward se esse sinalizador for false, ou squash se true.
Itens de trabalho de transição	transitionWorkItems	boolean	Se verdadeiro, tentaremos fazer a transição de quaisquer itens de trabalho vinculados à solicitação pull para o próximo estado lógico (ou seja, Ativo -> Resolvido).

CommitGitUserDate

Confirmar data do usuário do Git

Nome	Caminho	Tipo	Descrição
Data de confirmação do usuário	date	string	Data da operação Git.
Confirmar e-mail do usuário	email	string	Endereço de e-mail do usuário que executa a operação Git.
Confirmar URL da imagem	imageUrl	string	Url para o avatar do usuário.
Confirmar nome de usuário	name	string	Nome do usuário que executa a operação Git.

GitCommitRef

Git Commit Ref

Nome	Caminho	Tipo	Descrição
autor	author	CommitGitUserDate	Confirmar data do usuário do Git
Confirmar comentário	comment	string	Comentário ou mensagem do commit.
Confirmar comentário truncado	commentTruncated	string	Indica se o comentário está truncado da mensagem completa de comentário de confirmação do Git.
ID de confirmação	commitId	string	Id do compromisso.
Committer	committer	CommitGitUserDate	Confirmar data do usuário do Git
Pais	parents	array of string	Uma enumeração das IDs de confirmação pai para essa confirmação.
Confirmar URL Remoto	remoteUrl	string	Caminho de URL remoto para a confirmação.
URL de confirmação	url	string	URL REST para este recurso.

GitRefUpdate

Atualização Git Ref

Nome	Caminho	Tipo	Descrição
Nome Ref	name	string	O nome do Git Ref que foi atualizado.
ID do repositório	repositoryId	string	O id exclusivo do repositório.
ID de confirmação antiga	oldObjectId	string	O id da confirmação anterior que esta Ref apontou antes da atualização.
Nova ID de confirmação	newObjectId	string	O id do novo commit que esta Ref apontou antes da atualização.

VstsList[Project]

Uma lista de modelos VSTS.

Nome	Caminho	Tipo	Descrição
Valor	value	array of Project	Os modelos VSTS

Project

Nome	Caminho	Tipo	Descrição
ID do projeto	id	string	O identificador exclusivo do projeto.
Nome do Project	name	string	O nome do projeto.
URL do Project	url	string	A URL da API do projeto.

VstsList[Membro da Equipa]

Uma lista de modelos VSTS.

Nome	Caminho	Tipo	Descrição
Valor	value	array of TeamMember	Os modelos VSTS

Membro da Equipa

Nome	Caminho	Tipo	Descrição
ID de Membro da Equipa	id	string	O ID único do membro da equipa.
Nome de exibição	displayName	string	O nome para exibição do membro da equipe.
Nome Exclusivo	uniqueName	string	O nome de utilizador do membro da equipa.
URI dos membros	url	string	O URI do membro da equipa.
URI da Imagem	imageUrl	string	O URI da imagem do membro da equipa.

VstsList[ReleaseDefinition]

Uma lista de modelos VSTS.

Nome	Caminho	Tipo	Descrição
Valor	value	array of ReleaseDefinition	Os modelos VSTS

Definição de Lançamento

Definição de versão

Nome	Caminho	Tipo	Descrição
Comment	Comment	string	O comentário da definição de lançamento.
Criado em	CreatedOn	date-time	A data em que a definição de versão foi criada.
Description	Description	string	A descrição da definição de versão.
Id	Id	integer	O identificador exclusivo da definição de versão.
Modificadopor	ModifiedBy	IdentityRef	Identidade Ref
Modificados Em	ModifiedOn	date-time	A data em que a definição de lançamento foi modificada.
Nome	Name	string	O nome da definição de versão.
Caminho	Path	string	O caminho da definição de versão.
Formato do nome de versão	ReleaseNameFormat	string	O formato do nome da versão da definição da versão.
Revisão	Revision	integer	O número de revisão da definição de versão.
Fonte	Source	string	A origem da definição de versão.
Etiquetas	Tags	array of string	A lista de tags da definição de versão.
URL	Url	string	A URL para acessar a definição de versão.

IdentityRef

Identidade Ref

Nome	Caminho	Tipo	Descrição
Alias de diretório	DirectoryAlias	string	O alias de diretório da referência de identidade.
Nome de exibição	DisplayName	string	O nome para exibição da referência de identidade.
Nome Exclusivo	UniqueName	string	O nome exclusivo da referência de identidade.
URL	Url	string	O URL da referência de identidade.
Id	Id	string	O Id da referência de identidade.

ReleaseDefinitionShallowReference

Referência superficial de definição de versão

Nome	Caminho	Tipo	Descrição
Id	Id	integer	O identificador exclusivo da definição de versão.
Nome	Name	string	O nome da definição de versão.
URL	Url	string	O REST API URL para acessar a definição de versão.

Objeto

ObjectWithoutType

Release

Nome	Caminho	Tipo	Descrição
Comment	Comment	string	O comentário do lançamento.
Criado Por	CreatedBy	IdentityRef	Identidade Ref
Criado em	CreatedOn	date-time	A data em que a versão foi criada.
Description	Description	string	A descrição da libertação.
Id	Id	integer	O identificador exclusivo da versão.
Guarde para sempre	KeepForever	boolean	Se a versão deve ser excluída das políticas de retenção.
Registra a URL do contêiner	LogsContainerUrl	string	O URL do contêiner de logs desta versão.
Modificadopor	ModifiedBy	IdentityRef	Identidade Ref
Modificados Em	ModifiedOn	date-time	Data em que a versão foi modificada.
Nome	Name	string	O nome da versão.
Reason	Reason	string	O motivo da liberação.
Definição de Lançamento	ReleaseDefinition	ReleaseDefinitionShallowReference	Referência superficial de definição de versão
Situação	Status	string	O status da liberação.
URL	Url	string	O URL da versão.

VstsList[TfvcChangeset]

Uma lista de modelos VSTS.

Nome	Caminho	Tipo	Descrição
Valor	value	array of TfvcChangeset	Os modelos VSTS

TfvcChangeset

Conjunto de alterações do controle de versão do Team Foundation

Nome	Caminho	Tipo	Descrição
ID do conjunto de alterações	changesetId	integer	O id exclusivo do conjunto de alterações.
autor	author	ChangesetAuthor	Autor do conjunto de alterações
checkedInBy	checkedInBy	ChangesetCheckedInBy	Conjunto de alterações com check-in feito por
Data de criação	createdDate	date-time	A data/hora em que o conjunto de alterações foi criado.
Comment	comment	string	O comentário que descreve o conjunto de alterações.

ChangesetAuthor

Autor do conjunto de alterações

Nome	Caminho	Tipo	Descrição
Nome do Autor	displayName	string	O nome do usuário que criou o conjunto de alterações.
Nome Exclusivo do Autor	uniqueName	string	O nome exclusivo do usuário que criou o conjunto de alterações.

ChangesetCheckedInBy

Conjunto de alterações com check-in feito por

Nome	Caminho	Tipo	Descrição
Check-in por nome	displayName	string	O nome do usuário que fez check-in no conjunto de alterações.
Check-in por nome exclusivo	uniqueName	string	O nome exclusivo do usuário que criou o conjunto de alterações.

VstsList[WorkItemType]

Uma lista de modelos VSTS.

Nome	Caminho	Tipo	Descrição
Valor	value	array of WorkItemType	Os modelos VSTS.

WorkItemHit

Termos correspondidos no campo do resultado do item de trabalho

Nome	Caminho	Tipo	Descrição
Nome de Referência do Campo	fieldReferenceName	string	Nome de referência do campo destacado.
Destaques	highlights	array of string	Fragmentos coincididos/destacados do campo.

WorkItemResult

Resultado de Item de Trabalho que correspondeu a um pedido de pesquisa de item de trabalho

Nome	Caminho	Tipo	Descrição
projecto	project	SearchProject	Detalhes do Project para resultados de pesquisa
Campos	fields	object	Um conjunto padrão de campos de itens de trabalho e os seus valores.
Acertos	hits	array of WorkItemHit	Destacados excertos de campos que correspondem ao pedido de pesquisa.
URL	url	string	Referência ao item de trabalho.

SearchProject

Detalhes do Project para resultados de pesquisa

Nome	Caminho	Tipo	Descrição
Id	id	string	Identificação do projeto.
Nome	name	string	Nome do projeto.

WorkItemPesquisaResposta

Resposta de Pesquisa por Item de Trabalho

Nome	Caminho	Tipo	Descrição
Contar	count	integer	Número total de itens de trabalho combinados.
Results	results	array of WorkItemResult	Lista dos itens de trabalho mais combinados.
Código de Informação	infoCode	integer	Código numérico a indicar qualquer informação adicional.
Facetas	facets	object	Um dicionário que armazena um array de objetos Filter em cada faceta.

WorkItemType

Tipo de item de trabalho

Nome	Caminho	Tipo	Descrição
Description	Description	string	A descrição do tipo.
Nome	Name	string	O nome do tipo.
Formulário XML	XmlForm	string	Uma representação XML do tipo.
Campos	FieldInstances	array of WorkItemTypeFieldInstance	Uma lista de instâncias de campo associadas ao tipo.
ícone Id	icon.id	string	O identificador do ícone
URL do ícone	icon.url	string	A URL REST do recurso
States	states	array of WorkItemStateColor	Estados do tipo de item de trabalho

WorkItemTypeFieldInstance

Instância de campo do tipo de item de trabalho

Nome	Caminho	Tipo	Descrição
Sempre Necessário	AlwaysRequired	boolean	Especifica se a instância de campo é sempre necessária.
Nome de referência	ReferenceName	string	O nome de referência da instância de campo.
Nome	Name	string	O nome da instância de campo.
URL	Url	string	Uma URL apontando para os detalhes da instância do campo.

WorkItemComment

Comentário do Item de Trabalho

Nome	Caminho	Tipo	Descrição
_links	_links	ReferenceLinks	Coleção de links de referência REST.
ID do comentário	id	integer	O id único do comentário.
ID do item de trabalho	workItemId	integer	O ID do item de trabalho a que pertence o comentário.
Versão	version	integer	A revisão do item de trabalho associada a este comentário.
Formato do Comentário	format	CommentFormat	Especifica como o texto do comentário é interpretado.
Texto do comentário	text	string	O texto do comentário.
Texto Renderizado	renderedText	string	A versão HTML renderizada do texto do comentário.
criado por	createdBy	IdentityRef	Identidade Ref
Data de criação	createdDate	date-time	A data em que o comentário foi criado.
createdOnMehalfOf	createdOnBehalfOf	IdentityRef	Identidade Ref
Data de Criação em Nome	createdOnBehalfDate	date-time	Data de criação efetiva em nome de outra identidade.
modificadoPor	modifiedBy	IdentityRef	Identidade Ref
Data de Modificação	modifiedDate	date-time	A data em que o comentário foi alterado pela última vez.
É suprimido	isDeleted	boolean	Indica se o comentário foi excluído.
Menções	mentions	array of CommentMention	Menções incluídas no comentário.
Reações	reactions	array of CommentReaction	Reações ao comentário.
URL	url	string	A URL DA API REST do comentário.

ComentárioFormato

Especifica como o texto do comentário é interpretado.

Formato do Comentário: string

ComentárioMention

Representa uma menção dentro de um comentário.

Nome	Caminho	Tipo	Descrição
_links	_links	ReferenceLinks	Coleção de links de referência REST.
ID do artefato	artifactId	string	A parte do artefacto do texto analisado (por exemplo, o id do item de trabalho).
Tipo de artefacto	artifactType	string	O tipo atribuído à menção (pessoa, item de trabalho, etc).
ID do comentário	commentId	integer	O id do comentário que contém a menção.
ID do alvo	targetId	string	O alvo resolvido da menção.
URL	url	string	A REST API URL da menção.

ComentárioTipo de Reação

Tipo de reação ao comentário.

Tipo de reação: string

ComentárioReação

Contém informação sobre a reação a um comentário de um item de trabalho.

Nome	Caminho	Tipo	Descrição
_links	_links	ReferenceLinks	Coleção de links de referência REST.
ID do comentário	commentId	integer	O id do comentário a que esta reação pertence.
Contar	count	integer	Número total de reações para este tipo de reação.
O Utilizador Atual Está Envolvido	isCurrentUserEngaged	boolean	Indica se o utilizador atual se envolveu com esta reação.
Tipo de reação	type	CommentReactionType	Tipo de reação ao comentário.
URL	url	string	A REST API URL da reação.

ReferênciaLinks

Coleção de links de referência REST.

Nome	Caminho	Tipo	Descrição
		object	Coleção de links de referência REST.

RespostaAnexoItemTrabalho

Nome	Caminho	Tipo	Descrição
attachmentId	attachmentId	string	Identificador do anexo.
nomeDoFicheiro	fileName	string	Nome do ficheiro anexo.
TipoDeConteúdo	contentType	string	Tipo MIME do anexo.
contentLength	contentLength	integer	Tamanho do anexo em bytes.
últimaModificação	lastModified	date-time	Último carimbo temporal modificado para o anexo.
conteúdo	content	byte	Conteúdo de anexo codificado como uma cadeia Base64.

ComentáriosItemResposta

Representa a resposta que contém comentários sobre itens de trabalho.

Nome	Caminho	Tipo	Descrição
Contar	count	integer	O número total de comentários.
Comments	comments	array of WorkItemComment	A lista de comentários.

VstsList[JObject]

Uma lista de modelos VSTS.

Nome	Caminho	Tipo	Descrição
Valor	value	array of Object	Os modelos VSTS

VstsList[WorkItemField]

Uma lista de modelos VSTS.

Nome	Caminho	Tipo	Descrição
Valor	value	array of WorkItemField	Os modelos VSTS

VstsList[QueryHierarchyItem]

Uma lista de modelos VSTS.

Nome	Caminho	Tipo	Descrição
Valor	value	array of QueryHierarchyItem	Os modelos VSTS

QueryHierarchyItem

Item de hierarquia de consulta

Nome	Caminho	Tipo	Descrição
Crianças	Children	array of QueryHierarchyItem	A lista de itens filhos associados ao item de hierarquia de consulta.
Cláusulas	Clauses	WorkItemQueryClause	Cláusula de consulta de item de trabalho
Columns	Columns	array of WorkItemFieldReference	A lista de colunas de campo de item de trabalho associadas ao item de hierarquia de consulta.
Opções de Filtro	FilterOptions	string	As opções de filtro do item de hierarquia de consulta.
Tem filhos	HasChildren	boolean	Especifica se o item da hierarquia de consulta tem filhos.
Id	Id	string	O identificador exclusivo do item de hierarquia de consulta.
É suprimido	IsDeleted	boolean	Especifica se o item da hierarquia de consulta é excluído.
É pasta	IsFolder	boolean	Especifica se o item da hierarquia de consulta é uma pasta.
A sintaxe é inválida	IsInvalidSyntax	boolean	Especifica se o item da hierarquia de consulta tem sintaxe inválida.
É público	IsPublic	boolean	Especifica se o item da hierarquia de consulta é público.
Cláusulas LinkClauses	LinkClauses	WorkItemQueryClause	Cláusula de consulta de item de trabalho
Nome	Name	string	O nome do item da hierarquia de consulta.
Caminho	Path	string	O caminho do item de hierarquia de consulta.
Tipo de consulta	QueryType	string	O tipo de consulta do item de hierarquia de consulta.
Classificar colunas	SortColumns	array of WorkItemQuerySortColumn	A lista de colunas de classificação do item de hierarquia de consulta.
Cláusulas Fonte	SourceClauses	WorkItemQueryClause	Cláusula de consulta de item de trabalho
Cláusulas-alvo	TargetClauses	WorkItemQueryClause	Cláusula de consulta de item de trabalho
Wiql	Wiql	string	O WIQL do item de hierarquia de consulta.
Links	_links	object	A coleção de links relevantes para o item de hierarquia de consulta.
URL	Url	string	O link HTTP completo para o item de hierarquia de consulta.

WorkItemStateColor

Cor do Estado do Item de Trabalho

Nome	Caminho	Tipo	Descrição
Categoria de Estado	category	string	Categoria de Estado
Valor da cor	color	string	Valor da cor
nome do estado	name	string	Nome do estado do tipo de item de trabalho

Cláusula WorkItemQueryClause

Cláusula de consulta de item de trabalho

Nome	Caminho	Tipo	Descrição
Cláusulas	Clauses	WorkItemQueryClause	Cláusula de consulta de item de trabalho
Campo	Field	WorkItemFieldReference	Referência de campo de item de trabalho
Valor do campo	FieldValue	WorkItemFieldReference	Referência de campo de item de trabalho
É valor de campo	IsFieldValue	boolean	Especifica se a cláusula de consulta de item de trabalho é um valor de campo.
Operador lógico	LogicalOperator	string	O operador lógico da cláusula de consulta de item de trabalho.
Operator	Operator	WorkItemFieldOperation	Operação de campo de item de trabalho
Valor	Value	string	O valor da cláusula de consulta do item de trabalho.

WorkItemFieldReference

Referência de campo de item de trabalho

Nome	Caminho	Tipo	Descrição
Nome	Name	string	O nome da referência do campo de item de trabalho.
Nome de referência	ReferenceName	string	O nome de referência da referência do campo de item de trabalho.
URL	Url	string	A URL da referência do campo de item de trabalho.

WorkItemQuerySortColumn

Coluna Classificar Consulta de Item de Trabalho

Nome	Caminho	Tipo	Descrição
Descending	Descending	boolean	Especifica se a coluna de classificação da consulta do item de trabalho é decrescente.
Campo	Field	WorkItemFieldReference	Referência de campo de item de trabalho

WorkItemField

Campo do Item de Trabalho

Nome	Caminho	Tipo	Descrição
Nome	Name	string	O nome de exibição do campo do item de trabalho.
Somente leitura	ReadOnly	boolean	Especifica se o campo é apenas de leitura.
É Identidade	IsIdentity	boolean	Especifica se o campo contém informação de identidade.
Is Picklist	IsPicklist	boolean	Especifica se o campo utiliza uma lista de seleção.
Nome de referência	ReferenceName	string	O nome de referência do campo do item de trabalho.
Description	Description	string	A descrição do campo do item de trabalho.
Operações suportadas	SupportedOperations	array of WorkItemFieldOperation	A lista de operações apoiadas pelo campo.
Tipo	Type	string	O tipo de dado do campo do item de trabalho.
URL	Url	string	A URL do campo do item de trabalho.

WorkItemFieldOperation

Operação de campo de item de trabalho

Nome	Caminho	Tipo	Descrição
Nome	Name	string	O nome da operação de campo de item de trabalho.
Nome de referência	ReferenceName	string	O nome de referência da operação de campo de item de trabalho.

Gasoduto

Nome	Caminho	Tipo	Descrição
count	count	integer	count
valor	value	array of object	Matriz que tem a lista de todos os pipelines
HREF	value._links.self.href	string	HREF
HREF	value._links.web.href	string	HREF
pasta	value.folder	string	pasta
id	value.id	integer	id
nome	value.name	string	nome
revisão	value.revision	integer	revisão
URL	value.url	string	URL

Correr

Nome	Caminho	Tipo	Descrição
count	count	integer	count
valor	value	array of object	Execução de pipeline
HREF	value._links.self.href	string
HREF	value._links.web.href	string
HREF	value._links.pipeline.web.href	string
HREF	value._links.pipeline.href	string
URL	value.pipeline.url	string
id	value.pipeline.id	integer
revisão	value.pipeline.revision	integer
nome	value.pipeline.name	string
pasta	value.pipeline.folder	string
state	value.state	RunState	Estado de execução
createdDate (Data de criação)	value.createdDate	string	data de criação
URL	value.url	string	URL para pipeline
id	value.id	integer	ID do pipeline
nome	value.name	string	nome
Resultado	value.result	RunResult	Resultado da execução
Data de conclusão	value.finishedDate	string	data de conclusão da execução

RunResult

Resultado da execução

: string

RunState

Estado de execução

: string

PipelineRun

Uma única corrida de pipeline.

Nome	Caminho	Tipo	Descrição
Id de execução	id	integer	O identificador da corrida.
Nome da Corrida	name	string	O nome da corrida, que corresponde ao número de construção.
Estado	state	string	O estado da corrida.
Result	result	string	O resultado da corrida uma vez concluída.
Data de criação	createdDate	string	A hora em que a corrida foi criada.
Data de Conclusão	finishedDate	string	A hora em que a corrida terminou.
Executar URL	url	string	A URL REST da corrida.
Parâmetros do modelo	templateParameters	object	Os parâmetros do modelo com que a corrida foi iniciada.
Variables	variables	object	As variáveis de tempo de execução com que a execução foi iniciada.
Resources	resources	object	As versões de recursos que a run utilizou.
Pipeline Id	pipeline.id	integer	O identificador do oleoduto.
Nome da canalização	pipeline.name	string	O nome do gasoduto.
Folder	pipeline.folder	string	A pasta onde vive o pipeline.
Revisão	pipeline.revision	integer	A revisão do oleoduto.
URL do Pipeline	pipeline.url	string	O URL REST do pipeline.

GitItem

Um item (ficheiro ou pasta) num repositório Git.

Nome	Caminho	Tipo	Descrição
ID do objeto	objectId	string	O ID do objeto do item.
ID de confirmação	commitId	string	O commit de onde o item foi lido.
Tipo de Objeto Git	gitObjectType	string	O tipo de objeto Git, por exemplo blob ou árvore.
Caminho do item	path	string	O caminho relativo ao repositório do item.
É pasta	isFolder	boolean	Indica se o item é uma pasta.
Content	content	string	O conteúdo de texto do arquivo. Só deves quando Incluir Conteúdo for verdadeiro.
Item URL	url	string	A URL REST do item.

GitRefItem

Um ref Git, como um branch ou uma etiqueta.

Nome	Caminho	Tipo	Descrição
Nome Ref	name	string	O nome completo do árbitro, por exemplo refs/heads/main.
ID do objeto	objectId	string	O ID do objeto para onde o ref aponta.
Identificação do Objeto Descascado	peeledObjectId	string	O commit id de uma tag anotada resolve-se.
URL da referência	url	string	O URL REST do árbitro
Criador	creator	object	A identidade que criou o árbitro.

GitRefList

Uma lista de referências do Git.

Nome	Caminho	Tipo	Descrição
Contar	count	integer	O número de árbitros voltou.
Árbitros	value	array of GitRefItem	Os árbitros.

GitPushResponse

O resultado de um empurrão.

Nome	Caminho	Tipo	Descrição
ID de envio	pushId	integer	O identificador do empurrão.
Date	date	string	O momento em que o empurrão foi feito.
Push URL	url	string	O URL REST do push.
Empurrado por	pushedBy	object	A identidade que fez a investida.
Ref Atualizações	refUpdates	array of GitRefItem	As referências que foram atualizadas.
Consolidações	commits	array of object	Os commits que foram empurrados.
ID de confirmação	commits.commitId	string	O id da confirmação.
Comment	commits.comment	string	A mensagem de commit.
Commit URL	commits.url	string	O URL REST do commit.

GitPullRequestResponse

Um pull request.

Nome	Caminho	Tipo	Descrição
Pull Request Id	pullRequestId	integer	O identificador do pull request.
ID de revisão de código	codeReviewId	integer	A ID de revisão de código da solicitação pull.
Situação	status	string	O status da solicitação pull.
Title	title	string	O título da solicitação pull.
Description	description	string	A descrição do pull request.
Sucursal de origem	sourceRefName	string	O ramo de onde vêm as mudanças.
Ramo Alvo	targetRefName	string	A ramificação em que as alterações estão integradas.
Estado da Fusão	mergeStatus	string	O estado da fusão do pull request.
É rascunho	isDraft	boolean	Indica se a solicitação pull é um rascunho.
Data de criação	creationDate	string	A hora em que o pull request foi criado.
Pull Request URL	url	string	O URL REST do pull request.
Criado por	createdBy	object	A identidade que criou o pull request.
Repositório	repository	object	O repositório que os pull requests apontam.