Azure DevOps

Azure DevOps fornece serviços para que as equipes compartilhem código, acompanhem o trabalho e enviem softwares para qualquer idioma, tudo em um único pacote. É o complemento perfeito para seu IDE.

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

Service	Class	Regions
Copilot Studio	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)
Aplicativos Lógicos	Standard	Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: - Azure regiões da 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
Site da 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 essa integração, você precisará de acesso a uma conta Azure DevOps com acesso à API habilitado. Para fazer uma conexão, selecione Entrar. Em seguida, você será solicitado a fornecer sua conta do 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 que está esperando, 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 de Credencial de Identidade Federada

Juntamente com conexões que se conectam como um usuário ou usam um segredo ou certificado do cliente, o conector dá suporte a uma conexão FIC (Federated Identity Credential ). Ele se autentica como um aplicativo registrado em seu próprio locatário Microsoft Entra e não armazena um segredo do cliente ou certificado na conexão.

Configuração necessária de locatário e Azure DevOps

Registre um aplicativo de locatário único no Microsoft Entra ID e anote sua ID de Aplicativo (cliente) e ID de Diretório (locatário).
Adicione a entidade de serviço do aplicativo a cada Azure DevOps organização que ele precisa acessar. Atribua o nível de acesso mais baixo, as associações de grupo e as permissões de recurso exigidas pelos fluxos. Azure DevOps autoriza a entidade de serviço por meio de suas permissões de organização, não por meio Microsoft Entra permissões de aplicativo. Para obter detalhes, consulte Usar entidades de serviço e identidades gerenciadas no Azure DevOps.
Crie a conexão usando o tipo de autenticação de Credencial de Identidade Federada e forneça a ID do cliente e a ID do locatário. Permitir que o teste de conexão inicial falhe.
Copie o assunto esperado do AADSTS700212 erro e adicione uma credencial de identidade federada ao seu aplicativo com:
- Emissor:https://login.microsoftonline.com/<tenant-id>/v2.0
- Público-alvo:api://AzureADTokenExchange
- Assunto: o assunto exato gerado para a conexão
Teste novamente a mesma conexão depois que a credencial de identidade federada for replicada.

Não exclua e recrie a conexão ao concluir essa configuração. O assunto identifica essa conexão específica, portanto, uma conexão de substituição requer uma credencial de identidade federada diferente.

Enviando anexos

Você pode criar anexos de arquivo usando End uma solicitação HTTP para Azure DevOps ação e, em seguida, seguir estas etapas:

Converta o conteúdo do arquivo em uma cadeia de caracteres Base64 e coloque-o no parâmetro "Body".
Defina o parâmetro "Corpo é Base64" como Sim.

Criando planos de teste

Antes de criar um plano de teste usando a ação Criar um item de trabalho , primeiro você deve criar um Pacote de Testes. Você pode usar a mesma ação Criar um item de trabalho para criar Conjuntos de Testes e, em seguida, criar um Plano de Teste com um link para o Pacote de Testes.

Sua opção mais simples é invocar Test Plans – Criar API diretamente usando Send uma solicitação HTTP para Azure DevOps ação. A API cria automaticamente o Conjunto de Testes associado.

Outro parâmetro Fields

Criar um item de trabalho e atualizar ações de 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 no seguinte JSON:

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

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

Aqui estão alguns exemplos de uso. Você pode ajustar mais exemplos em Itens de Trabalho – Atualizar a API REST.

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

Problemas e limitações conhecidos

A lista a seguir fornece limitações conhecidas do uso 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.
Os detalhes do item de trabalho action Get e gatilhos baseados em item de trabalho podem perder alguns campos (como System.AttachedFileCount) em uma resposta, pois essa é uma limitação de Azure DevOps API REST. Para solucionar esse problema, você pode fazer um dos seguintes procedimentos:
- Use End uma solicitação HTTP para Azure DevOps com Get Work Item ponto de extremidade para obter campos específicos
- Usar Obter resultados de consulta com uma consulta que retorna os campos necessários
A ação End uma solicitação HTTP para Azure DevOps tem um conjunto limitado de escopos que controlam quais recursos podem ser acessados pela ação e quais operações a ação tem permissão para executar nesses recursos.

Escopos:
- vso.agentpools_manage
- vso.build_execute
- vso.chat_manage
- vso.code_manage
- vso.code_status
- vso.connected_server
- vso.dashboards_manage
- vso.rights
- vso.extension.data_write
- vso.extension_manage
- vso.identity
- vso.loadtest_write
- vso.packaging_manage
- vso.project_manage
- vso.release_manage
- vso.test_write
- vso.work_write
As conexões que se conectarem como usuário operam com as permissões de Azure DevOps desse usuário. As conexões federadas de credenciais de identidade, certificado e segredo do cliente operam com as permissões atribuídas à entidade de serviço em Azure DevOps.
Observe que as alterações de senha na conta Azure DevOps não afetarão a conexão existente.
Azure DevOps Tokens de Acesso Pessoal não têm suporte para autenticação com o conector.
Action Create a work item has limitation for Repro Steps parameter - an image larger than 30 KB could be displayed incorrectly in the created item. Uma imagem maior que 500 Kb pode ser removida da solicitação. O tamanho da imagem recomendado deve ser menor que 30 KB.
A ação Criar um item de trabalho raramente pode 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 campos estão sendo solicitados. A solicitação pode ser enviada para o banco de dados copiado. As alterações foram sincronizadas quase em tempo real, mas às vezes leva alguns segundos. Por 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 como o valor 'Não'.
Para conexões que fazem logon como usuário, somente as organizações do locatário inicial da conta de entrada são retornadas ao trabalhar em vários diretórios. A troca de diretórios da página de perfil Azure DevOps não afeta as organizações disponíveis. Para acessar organizações em outro locatário, crie a conexão usando credenciais para uma conta que pertence a esse locatário.

Observação

Na ação , crie um item de trabalho

O nome do campo deve atender aos critérios mencionados em Azure DevOps documentation.

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:


Autenticação de Certificado do Cliente	Fornecer credenciais de Microsoft Entra ID usando certificado PFX e senha	Todas as regiões	Compartilhável
Credencial de identidade federada	Use uma credencial de identidade federada em seu aplicativo Microsoft Entra ID para acessar Azure DevOps sem armazenar um segredo do cliente ou certificado na conexão.	Somente PRODUÇÃO	Compartilhável
Fazer logon com credenciais de Azure DevOps	Fazer logon com credenciais de Azure DevOps	somente Azure Governamental e governo dos EUA (GCC)	Não compartilhável
Fazer logon com a ID do Microsoft Entra	Faça logon com Microsoft Entra ID	Somente PRODUÇÃO	Não compartilhável
Autenticação do principal de serviço	Usar seu aplicativo Microsoft Entra ID para autenticação de entidade de serviço	Todas as regiões	Compartilhável
Padrão [PRETERIDO]	Essa 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 do Cliente

ID de autenticação: CertOauth

Aplicável: todas as regiões

Fornecer credenciais de Microsoft Entra ID usando certificado PFX e senha

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

Nome	Tipo	Description	Obrigatório
Inquilino	cadeia		Verdade
ID do cliente	cadeia	A ID do cliente do aplicativo Microsoft Entra ID	Verdade
Segredo do certificado do cliente	clientCertificate	O segredo do certificado do cliente permitido por este aplicativo	Verdade

Credencial de identidade federada

ID de autenticação: connectionfic

Aplicável: somente PRODUÇÃO

Use uma credencial de identidade federada em seu aplicativo Microsoft Entra ID para acessar Azure DevOps sem armazenar um segredo do cliente ou certificado na conexão.

Nome	Tipo	Description	Obrigatório
ID do cliente	cadeia		Verdade
ID do locatário	cadeia		Verdade

Fazer logon com credenciais de Azure DevOps

ID de autenticação: ADO3pAuthForGCC

Aplicável: somente Azure Governamental e Governo dos EUA (GCC)

Fazer logon com credenciais de Azure DevOps

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Faça logon com Microsoft Entra ID

ID de autenticação: EntraOAuth

Aplicável: somente PRODUÇÃO

Faça logon com Microsoft Entra ID

Essa não é uma conexão compartilhável. Se o aplicativo de energia 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

Usar seu aplicativo Microsoft Entra ID para autenticação de entidade de serviço

Nome	Tipo	Description	Obrigatório
Inquilino	cadeia		Verdade
ID do cliente	cadeia	A ID do cliente do aplicativo Microsoft Entra ID	Verdade
Segredo do cliente	secureString		Verdade

Padrão [PRETERIDO]

Aplicável: todas as regiões

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

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Limitações

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

Ações

Adicionar link do item de trabalho (versão prévia)	Adiciona um link a um item de trabalho.
Atualizar o comentário do item de trabalho (versão prévia)	Atualiza um comentário sobre um item de trabalho.
Atualizar um item de trabalho	Atualize um item de trabalho existente por ID.
Atualizar uma solicitação de pull	Atualiza uma solicitação de pull existente. Use isso para definir a conclusão automática, abandonar ou concluir uma solicitação de pull ou alterar seu título, descrição ou branch de destino.
Compilações de lista (versão prévia)	Recupera builds para o projeto especificado com filtros opcionais.
Criar comentário do item de trabalho (versão prévia)	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 um push	Envia por push uma ou mais confirmações para um repositório Git. Use isso para criar uma ramificação e confirmar alterações de arquivo em uma única chamada.
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 uma solicitação de pull em um repositório Git, vinculando opcionalmente itens de trabalho e adicionando revisores.
Enfileirar um novo build	Crie um build, com base em uma definição de build existente, e adicione-o à fila de build.
Enviar uma solicitação HTTP para Azure DevOps	Construa uma solicitação de API REST Azure DevOps a ser invocada. Consulte o seguinte link para todos os pontos de extremidade disponíveis: https://docs.microsoft.com/rest/api/azure/devops
Excluir comentário do item de trabalho (versão prévia)	Exclui um comentário em um item de trabalho.
Excluir link do item de trabalho (versão prévia)	Exclui um link de um item de trabalho.
Executar um pipeline	Enfileira uma nova execução de um pipeline YAML. Dá suporte a parâmetros de modelo, variáveis de runtime, a ramificação a ser executada e os estágios a serem ignoradas.
Listar branches do Git (versão prévia)	Recupera a lista de branches do Git disponíveis nos repositórios do projeto.
Listar branches e marcas	Recupera os refs de um repositório Git, opcionalmente filtrados por um prefixo de nome ref, como cabeças/principal.
Listar campos de item de trabalho (versão prévia)	Recupera os campos de item de trabalho disponíveis no projeto ou organização do Azure DevOps especificado.
Listar consultas de nível raiz	Recupera a lista de consultas de item de trabalho no nível raiz em um projeto.
Listar consultas dentro da pasta	Recupera a lista de consultas de item de trabalho em 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 principais execuções para um pipeline específico
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 os itens de trabalho	Retorna uma lista de itens de trabalho.
Listar pipelines	Recupera a lista de pipelines em um projeto.
Listar projetos	Recupera a lista de projetos em uma organização.
Listar repositórios Git	Recupera a lista de repositórios Git em um projeto.
Listar solicitantes de build (versão prévia)	Recupera membros exclusivos do projeto que podem ser usados para filtrar builds pela identidade solicitada.
Listar tipos de item de trabalho	Recupera a lista de tipos de item de trabalho acessíveis em um determinado projeto de Azure DevOps.
Obter anexo do item de trabalho (versão prévia)	Baixa o conteúdo de um anexo de item de trabalho.
Obter build (versão prévia)	Recupera um build por seu identificador.
Obter comentários do item de trabalho (versão prévia)	Recupera comentários de um item de trabalho.
Obter conteúdo de arquivo	Recupera um arquivo (ou metadados de pasta) de um repositório Git. O texto do arquivo é retornado na propriedade Content.
Obter detalhes do item de trabalho	Obtenha os detalhes de um único item de trabalho.
Obter detalhes do item de trabalho (V2) (versão prévia)	Obtenha os detalhes de um único item de trabalho com opções opcionais de seleção de campo e expansão.
Obter filhos do item de trabalho	Obtenha uma lista de filhos (tamanho máximo 1000) de um único item de trabalho.
Obter linha do tempo de build (versão prévia)	Recupera a linha do tempo de um build específico.
Obter resultados da consulta	Recupera o resultado de uma consulta de item de trabalho.
Obter resultados da consulta [PRETERIDO]	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 usuário	Obtém um perfil de usuário.
Obter uma execução de pipeline	Recupera uma única execução de um pipeline, incluindo seus parâmetros de estado, resultado e modelo.
Pesquisar itens de trabalho	Fornece um conjunto de resultados para o texto de pesquisa.

Adicionar link do item de trabalho (versão prévia)

ID da operação:: AddWorkItemLinkAsync

Adiciona um link a um item de trabalho.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	Project ID ou project nome
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	ID de um item de trabalho.
Tipo de link	linkType	True	string	Tipo de relação para o link. O padrão é 'System.LinkTypes.Related' quando omitido.
URL de Destino	targetUrl	True	string	URL absoluta do destino do link. Deve ser um URI absoluto e corresponder às expectativas do Tipo de Link selecionado.
Comment	comment		string	Comentário opcional armazenado junto com o link.

Retornos

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

Atualizar o comentário do item de trabalho (versão prévia)

ID da operação:: UpdateWorkItemCommentAsync

Atualiza um comentário sobre um item de trabalho.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	Project ID ou project nome
ID do item de trabalho	workItemId	True	integer	ID de um item de trabalho.
ID do comentário	commentId	True	integer	ID do comentário a ser atualizado.
Formato de 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.

Retornos

Comentário do Item de Trabalho

Corpo: WorkItemComment

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	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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.

Retornos

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

Atualizar uma solicitação de pull

ID da operação:: UpdateGitPullRequest

Atualiza uma solicitação de pull existente. Use isso para definir a conclusão automática, abandonar ou concluir uma solicitação de pull ou alterar seu título, descrição ou branch de destino.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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.
ID da Solicitação de Pull	pullRequestId	True	integer	O identificador da solicitação de pull.
Situação	status		string	O status a ser definido na solicitação de pull.
Title	title		string	O novo título da solicitação de pull.
Description	description		string	A nova descrição da solicitação de pull.
Branch de destino	targetRefName		string	O novo branch de destino da solicitação de pull.
É rascunho	isDraft		boolean	Defina como false para publicar uma solicitação de pull de rascunho.
ID de identidade	id		string	A ID de identidade que habilita o preenchimento automático.
ID de confirmação	commitId		string	A ID da confirmação.
Excluir Branch de Origem	deleteSourceBranch		boolean	Defina como true para excluir o branch de origem após a conclusão.
Mesclagem de Squash	squashMerge		boolean	Defina como true para esmagar as confirmações ao mesclar.
Política de bypass	bypassPolicy		boolean	Defina como true para ignorar as políticas de branch.
Motivo do bypass	bypassReason		string	O motivo pelo qual as políticas de branch são ignoradas.
Mesclar mensagem de confirmação	mergeCommitMessage		string	A mensagem da confirmação de mesclagem.
Itens de trabalho de transição	transitionWorkItems		boolean	Defina como true para fazer a transição dos itens de trabalho vinculados ao concluir.

Retornos

Uma solicitação de pull.

Corpo: GitPullRequestResponse

Compilações de lista (versão prévia)

ID da operação:: ListBuilds

Recupera builds para o projeto especificado com filtros opcionais.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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 IDs de definição	definitions		string	Lista separada por vírgulas de identificadores de definição a serem incluídos.
Filtrar por número de build	buildNumber		string	Filtrar por número de build.
Filtrar por ramificação	branchName		string	Filtrar por nome de branch (por exemplo, refs/heads/main).
Filtrar por resultado	resultFilter		string	Filtrar por resultado de build.
Filtrar por status	statusFilter		string	Filtrar por status de build.
Filtrar por motivo	reasonFilter		string	Filtrar por motivo de build.
Filtrar por solicitado	requestedFor		string	Filtrar pela identidade para quem o build foi solicitado.
Min Finish Time	minTime		date-time	Filtrar pelo tempo mínimo de término (inclusivo).
Tempo máximo de término	maxTime		date-time	Filtrar pelo tempo máximo de término (inclusivo).
Resultados máximos	$top		integer	Número máximo de builds a serem retornados.
Ordenar por	queryOrder		string	A ordem na qual os builds são retornados.
Filtrar por marcas	tagFilters		string	Lista separada por vírgulas de marcas. Somente compilações que carregam todas as marcas são retornadas.

Retornos

Uma lista de modelos VSTS.

Corpo: VstsList[BuildResult]

Criar comentário do item de trabalho (versão prévia)

ID da operação:: CreateWorkItemCommentAsync

Adiciona um comentário a um item de trabalho.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	Project ID ou project nome
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	ID de um item de trabalho.
Formato de 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.

Retornos

Comentário do Item de Trabalho

Corpo: 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	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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', somente a ID do item de trabalho será retornada. Se o valor for 'Sim', todos os campos do Item criado junto com a ID serão retornados. O valor padrão é 'Sim'
Detalhes do item de trabalho	workItem	True	dynamic	Informações a serem incluídas no novo item de trabalho

Retornos

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

Criar um push

ID da operação:: CreateGitPush

Envia por push uma ou mais confirmações para um repositório Git. Use isso para criar uma ramificação e confirmar alterações de arquivo em uma única chamada.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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 do Ref	name		string	O nome completo do ref para atualizar ou criar, por exemplo, refs/heads/my-branch.
ID do objeto antigo	oldObjectId		string	A ID do objeto na qual o ref aponta atualmente. Use a ID do objeto do branch base ao criar um branch.
ID do novo objeto	newObjectId		string	A ID do objeto em que o ref deve apontar. Necessário somente ao excluir ou redefinir um ref.
Comment	comment		string	A mensagem do commit.
Alterar Tipo	changeType		string	O tipo de alteração a ser aplicada.
Caminho do Item	path		string	O caminho relativo do repositório do item.
Content	content		string	O conteúdo do ficheiro.
Tipo de conteúdo	contentType		string	Como o conteúdo é codificado.

Retornos

O resultado de um push.

Corpo: GitPushResponse

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	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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 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 dos metadados de início da versão.
Nome	Name	True	string	O nome da variável de configuração.
Value	Value		string	O valor da variável de configuração.

Retornos

Liberação

Corpo: Release

Criar uma solicitação de pull

ID da operação:: CreateGitPullRequest

Cria uma solicitação de pull em um repositório Git, vinculando opcionalmente itens de trabalho e adicionando revisores.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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.
Branch de origem	sourceRefName	True	string	O branch do qual as alterações vêm, por exemplo, refs/heads/my-branch.
Branch de destino	targetRefName	True	string	O branch em que as alterações são mescladas, por exemplo, refs/heads/main.
Title	title	True	string	O título da solicitação de pull.
Description	description		string	A descrição da solicitação de pull.
É rascunho	isDraft		boolean	Defina como true para criar a solicitação de pull como um rascunho.
ID do item de trabalho	id		string	O identificador do item de trabalho.
ID do revisor	id		string	A ID de identidade do revisor.
É necessário	isRequired		boolean	Indica se o revisor é necessário.
Nome	name		string	O nome do rótulo.

Retornos

Uma solicitação de pull.

Corpo: GitPullRequestResponse

Enfileirar um novo build

ID da operação:: QueueNewBuild

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

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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 definição de build	buildDefId	True	string	O identificador da definição de build a ser usada.
Branch de origem	sourceBranch		string	O branch de origem do build.
Parâmetros	parameters		string	Um dicionário JSON de parâmetros de build opcionais.

Retornos

Resultado da compilação

Corpo: BuildResult

Enviar uma solicitação HTTP para Azure DevOps

ID da operação:: HttpRequest

Construa uma solicitação de API REST Azure DevOps a ser invocada. Consulte o seguinte link para todos os pontos de extremidade disponíveis: https://docs.microsoft.com/rest/api/azure/devops

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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 de solicitação.
Corpo	Body		string	O conteúdo da solicitação. Pode ser um objeto JSON ou dados binários codificados como cadeia de caracteres Base64.
O corpo é Base64	IsBase64		boolean	Deve ser verdadeiro se o conteúdo da solicitação for codificado como cadeia de caracteres Base64.

Retornos

response: ObjectWithoutType

Excluir comentário do item de trabalho (versão prévia)

ID da operação:: DeleteWorkItemCommentAsync

Exclui um comentário em um item de trabalho.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	Project ID ou project nome
ID do item de trabalho	workItemId	True	integer	ID de um item de trabalho.
ID do comentário	commentId	True	integer	Id do comentário a ser excluído.
Versão da API	api-version	True	string	Versão da API a ser usada. Definir como '7.1-preview.4'; o conector também pode fazer fallback para '7.1-preview.3' se necessário pelo serviço.

Excluir link do item de trabalho (versão prévia)

ID da operação:: DeleteWorkItemLinkAsync

Exclui um link de um item de trabalho.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	Project ID ou project nome
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	ID de um item de trabalho.
ID da relação	linkId		integer	Identificador de relação baseado em zero (attributes.relationId) ou posição da matriz da resposta do item de trabalho.
Link do item de trabalho para remover	workItemLinkToRemove		uri	URL absoluta do link a ser excluído quando um identificador de relação não for fornecido.
Tipo de relação de vínculo	linkType		string	Tipo de relação (rel) do link a ser excluído ao corresponder por URL.

Retornos

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

Executar um pipeline

ID da operação:: RunPipeline

Enfileira uma nova execução de um pipeline YAML. Dá suporte a parâmetros de modelo, variáveis de runtime, a ramificação a ser executada e os estágios a serem ignoradas.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da Organização especificada.
A ID do pipeline	pipelineId	True	integer	A ID do pipeline
A versão do pipeline	pipelineVersion		integer	A versão do pipeline
Repositórios	repositories		object	Recursos de repositório chaveados por alias de recurso, por exemplo, self.
Parâmetros do modelo	templateParameters		object	Os parâmetros de modelo do pipeline, como um objeto JSON de pares nome/valor.
Variables	variables		object	As variáveis de runtime do pipeline, como um objeto JSON chaveado pelo nome da variável.
Estágios para Ignorar	stagesToSkip		array of string	Os nomes dos estágios que não devem ser executados.
Execução de visualização	previewRun		boolean	Defina como true para validar o pipeline sem enfileirar uma execução.

Retornos

Uma única execução de pipeline.

Corpo: PipelineRun

Listar branches do Git (versão prévia)

ID da operação:: ListBuildBranchesAsync

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

Parâmetros

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

Retornos

Uma lista de modelos VSTS.

Corpo: VstsList[GitRef]

Listar branches e marcas

ID da operação:: ListGitRefsWithFilter

Recupera os refs de um repositório Git, opcionalmente filtrados por um prefixo de nome ref, como cabeças/principal.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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 ref	filter		string	Um prefixo de nome ref sem os refs principais/, por exemplo, cabeças/principais ou marcas/.
Marcas de casca	peelTags		boolean	Defina como true para resolver marcas anotadas para a confirmação em que elas apontam.

Retornos

Uma lista de refs do Git.

Corpo: GitRefList

Listar campos de item de trabalho (versão prévia)

ID da operação:: ListWorkItemFieldsAsync

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

Parâmetros

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

Retornos

Uma lista de modelos VSTS.

Corpo: VstsList[WorkItemField]

Listar consultas de nível raiz

ID da operação:: ListRootQueryFolders

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

Parâmetros

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

Retornos

Uma lista de modelos VSTS.

Corpo: VstsList[QueryHierarchyItem]

Listar consultas dentro da pasta

ID da operação:: ListQueriesInFolder

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

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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 no qual procurar consultas.

Retornos

Uma lista de modelos VSTS.

Corpo: 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	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da Organização especificada.

Retornos

Uma lista de modelos VSTS.

Corpo: VstsList[ReleaseDefinition]

Listar execuções de pipeline

ID da operação:: ListPipelineRuns

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

Parâmetros

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

Retornos

Corpo: Run

Listar iterações

ID da operação:: ListIterations

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

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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 Equipe	team	True	string	O nome da equipe dentro do projeto.

Retornos

Uma lista de modelos VSTS.

Corpo: VstsList[TeamSettingsIteration]

Listar organizações

ID da operação:: ListAccounts

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

Retornos

Uma lista de modelos VSTS.

Corpo: VstsList[Account]

Listar os itens de trabalho

ID da operação:: ListWorkItems

Retorna uma lista de itens de trabalho.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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 solicitadas.
Tipo de Item de Trabalho	workItemType		string	O tipo de item de trabalho para o qual gerar o esquema.

Retornos

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

Listar pipelines

ID da operação:: ListPipelines

Recupera a lista de pipelines em um projeto.

Parâmetros

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

Retornos

Corpo: Pipeline

Listar projetos

ID da operação:: ListProjects

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

Parâmetros

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

Retornos

Uma lista de modelos VSTS.

Corpo: VstsList[Project]

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	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da Organização especificada.

Retornos

Uma lista de modelos VSTS.

Corpo: VstsList[GitRepository]

Listar solicitantes de build (versão prévia)

ID da operação:: ListBuildRequestersAsync

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

Parâmetros

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

Retornos

Uma lista de modelos VSTS.

Corpo: VstsList[TeamMember]

Listar tipos de item de trabalho

ID da operação:: ListWorkItemTypes

Recupera a lista de tipos de item de trabalho acessíveis em um determinado projeto de Azure DevOps.

Parâmetros

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

Retornos

Uma lista de modelos VSTS.

Corpo: VstsList[WorkItemType]

Obter anexo do item de trabalho (versão prévia)

ID da operação:: GetWorkItemAttachmentAsync

Baixa o conteúdo de um anexo de item de trabalho.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do OAuth" habilitado para evitar erros na operação.
ID do anexo	attachmentId	True	string	A ID exclusiva do anexo a ser baixado.
Nome do Project	project		string	Projeto opcional dentro da Organização especificada para definir o escopo da solicitação.
Nome do arquivo	fileName		string	Dica de nome de arquivo opcional passada para Azure DevOps ao baixar o anexo.

Retornos

Corpo: WorkItemAttachmentResponse

Obter build (versão prévia)

ID da operação:: GetBuildAsync

Recupera um build por seu identificador.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da Organização especificada.
Build Id	buildId	True	integer	O identificador do build a ser recuperado.

Retornos

Resultado da compilação

Corpo: BuildResult

Obter comentários do item de trabalho (versão prévia)

ID da operação:: GetWorkItemCommentsAsync

Recupera comentários de um item de trabalho.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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	A ID exclusiva do item de trabalho para o qual obter comentários.
Máximo de comentários a serem retornados	$top		integer	Número máximo de comentários a serem retornados.
Ordem de classificação de comentário	order		string	Ordem de classificação para comentários. O padrão é 'desc'.
Incluir comentários excluídos	includeDeleted		boolean	Se deve incluir comentários que foram excluídos suavemente.
Opções de expansão	$expand		string	Controla quais dados de comentário adicionais devem ser retornados.

Retornos

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

Corpo: WorkItemCommentsResponse

Obter conteúdo de arquivo

ID da operação:: GetGitItem

Recupera um arquivo (ou metadados de pasta) de um repositório Git. O texto do arquivo é retornado na propriedade Content.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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 do repositório do item, por exemplo /docs/readme.md.
Incluir Conteúdo	includeContent		boolean	Defina como true para incluir o conteúdo do arquivo na resposta.
Versão	versionDescriptor.version		string	O branch, marca ou confirmação para ler o item. O padrão é o branch padrão do repositório.
Tipo de versão	versionDescriptor.versionType		string	O tipo de versão fornecida na Versão.

Retornos

Um item (arquivo ou pasta) em um repositório Git.

Corpo: 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	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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 o qual obter detalhes. O item de trabalho deve ser do tipo especificado em "Tipo de Item de Trabalho".

Retornos

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

Obter detalhes do item de trabalho (V2) (versão prévia)

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	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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 retornado e as saídas dinâmicas da unidade.
ID do item de trabalho	id	True	string	A ID exclusiva do item de trabalho para o qual obter detalhes.
Data de conclusão	asOf		date-time	Recupere o item de trabalho a partir desta data e hora.
Expanda	expand		string	Controla quais dados adicionais são incluídos na resposta.

Retornos

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

Obter filhos do item de trabalho

ID da operação:: GetWorkItemChildren

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

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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	A ID exclusiva do item de trabalho para o qual obter os filhos.
Tipo de item de trabalho filho	workItemType		string	O tipo dos itens de trabalho filhos

Retornos

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

Obter linha do tempo de build (versão prévia)

ID da operação:: GetBuildTimelineAsync

Recupera a linha do tempo de um build específico.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do OAuth" habilitado para evitar erros na operação.
Nome do Project	project	True	string	O nome do projeto dentro da Organização especificada.
Build Id	buildId	True	integer	O identificador do build para o qual recuperar a linha do tempo.
ID da linha do tempo	timelineId		string	Identificador de linha do tempo opcional quando existem várias linhas do tempo.
Alterar ID	changeId		integer	ID de alteração opcional para recuperar uma alteração de linha do tempo específica.
ID do plano	planId		string	Identificador de plano opcional para a linha do tempo.

Retornos

Linha do tempo de compilação

Corpo: Timeline

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	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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	A ID da consulta armazenada a ser executada.
Número de itens de trabalho a serem retornados	workItemsCount		integer	Contagem máxima de itens de trabalho a serem recuperados (1 a 20000)
Falhar se os resultados da consulta forem alterados	throwIfQueryChanged		boolean	Se os resultados da consulta forem alterados durante a execução do fluxo, a execução do fluxo deverá falhar para evitar inconsistências.

Retornos

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

Obter resultados da consulta [PRETERIDO]

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	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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	A ID da consulta armazenada a ser executada.

Retornos

Uma lista de modelos VSTS.

Corpo: VstsList[JObject]

Obter um perfil de usuário

ID da operação:: GetProfile

Obtém um perfil de usuário.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
ID do perfil	id	True	string	A ID do perfil na mesma organização ou "eu" para obter o perfil do usuário autenticado atual.

Retornos

Profile

Corpo: Profile

Obter uma execução de pipeline

ID da operação:: GetPipelineRun

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

Parâmetros

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

Retornos

Uma única execução de pipeline.

Corpo: PipelineRun

Pesquisar itens de trabalho

ID da operação:: SearchWorkItemsAsync

Fornece um conjunto de resultados para o texto de pesquisa.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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.
Ignorar	$skip		integer	Número de resultados a serem ignorados. O valor padrão é 0.
TOP	$top		integer	Número de resultados a ser retornado. O padrão é 100.
Filtros	filters		object	Filtros a serem aplicados. Defina-o como nulo se não houver filtros a serem aplicados.
Incluir Facetas	includeFacets		boolean	Sinalizar para optar pela faceta no resultado. O comportamento padrão é falso.
Campo	field		string	Nome do campo no qual a classificação deve ser feita.
Ordem de Classificação	sortOrder		string	Ordem (ASC/DESC) na qual os resultados devem ser classificados.

Retornos

Resposta de pesquisa de item de trabalho

Corpo: WorkItemSearchResponse

Gatilhos

Quando o código é enviado por push (Git)	Dispara um fluxo quando o código é enviado por push para um repositório Git.
Quando o código é verificado (TFVC)	Dispara um fluxo quando o código é verificado em um projeto de Controle de Versão do Team Foundation.
Quando um build é concluído	Dispara um fluxo quando um build é concluído.
Quando um item de trabalho é atribuído	Dispara um fluxo quando um item de trabalho que corresponde aos critérios fornecidos é atribuído ao usuário fornecido.
Quando um item de trabalho é atribuído [PRETERIDO]	Esta ação foi preterida. Use quando um item de trabalho é atribuído . ~~Dispara um fluxo quando um item de trabalho que corresponde aos critérios fornecidos é atribuído ao usuário fornecido.~~
Quando um item de trabalho é atualizado	Dispara um fluxo quando um item de trabalho que corresponde aos critérios fornecidos é atualizado.
Quando um item de trabalho é atualizado [PRETERIDO]	Esta ação foi preterida. Use quando um item de trabalho for atualizado . ~~Dispara um fluxo quando um item de trabalho que corresponde aos critérios fornecidos é atualizado.~~
Quando um item de trabalho é criado	Dispara um fluxo quando um item de trabalho que corresponde aos critérios fornecidos é criado.
Quando um item de trabalho é criado [PRETERIDO]	Esta ação foi preterida. Use quando um item de trabalho for criado . ~~Dispara um fluxo quando um item de trabalho que corresponde aos critérios fornecidos é criado.~~
Quando um item de trabalho é fechado	Dispara um fluxo quando um item de trabalho que corresponde aos critérios fornecidos é fechado.
Quando um item de trabalho é fechado [PRETERIDO]	Esta ação foi preterida. Use quando um item de trabalho for fechado . ~~Dispara um fluxo quando um item de trabalho que corresponde aos critérios fornecidos é fechado.~~
Quando uma solicitação de pull é criada (Git)	Dispara um fluxo quando uma solicitação de pull que corresponde aos critérios fornecidos é criada.
Quando uma solicitação de pull é fechada (Git)	Dispara um fluxo quando uma solicitação de pull que corresponde aos critérios fornecidos é fechada.

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

ID da operação:: OnGitPush

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

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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 do Ref	refName		string	O nome do git ref, como uma ramificação ou marca.

Retornos

Uma lista de modelos VSTS.

Corpo: VstsList[GitPush]

Quando o código é verificado (TFVC)

ID da operação:: OnTfvcCheckIn

Dispara 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	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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 Equipe	team		string	O nome da equipe que selecionará um autor.
Membro da equipe	author		string	O nome exclusivo do membro da equipe que criou o check-in.

Retornos

Uma lista de modelos VSTS.

Corpo: VstsList[TfvcChangeset]

Quando um build é concluído

ID da operação:: OnBuildCompleted

Dispara um fluxo quando um build é concluído.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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 em qual resultado de build será disparado. As opções válidas incluem '', 'succeeded', 'partiallySucceeded', 'failed' ou 'canceled'.
Filtrar por ID de definição	definitions		string	Uma opção que indica em qual id de definição de build será disparada.

Retornos

Uma lista de modelos VSTS.

Corpo: VstsList[BuildResult]

Quando um item de trabalho é atribuído

ID da operação:: OnWorkItemAssignedV2

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

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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 equipe (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 possui atualmente o item de trabalho.
Tipo	wiql__System_WorkItemType		string	O nome do tipo de item de trabalho.
Caminho de Área	wiql__System_AreaPath		string	O recurso do produto ou a área de equipe em que o item de trabalho está.
Comparação de caminho 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 o período em que o item de trabalho está.
Comparação de caminho de iteração	iterationPathComparison		string	A regra a ser usada ao comparar o campo Caminho da Iteração.
Priority	wiql__Microsoft_VSTS_Common_Priority		string	Uma classificação subjetiva do bug, problema, tarefa ou caso de teste, conforme ele se relaciona ao negócio.
Criado por	wiql__System_CreatedBy		string	O nome do membro da equipe que criou o item de trabalho.

Retornos

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

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

ID da operação:: OnWorkItemAssigned

Esta ação foi preterida. Use quando um item de trabalho é atribuído .

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

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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 possui atualmente o item de trabalho.
Nome da equipe (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 de Área	wiql__System_AreaPath		string	O recurso do produto ou a área de equipe em que o item de trabalho está.
Comparação de caminho 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 o período em que o item de trabalho está.
Comparação de caminho de iteração	iterationPathComparison		string	A regra a ser usada ao comparar o campo Caminho da Iteração.
Priority	wiql__Microsoft_VSTS_Common_Priority		string	Uma classificação subjetiva do bug, problema, tarefa ou caso de teste, conforme ele se relaciona ao negócio.
Equipe Project	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.

Retornos

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

Quando um item de trabalho é atualizado

ID da operação:: OnWorkItemUpdatedV2

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

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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 equipe (para escolher Atribuído a)	team		string	O nome da equipe da qual selecionar um atribuídor.
Atribuído a	wiql__System_AssignedTo		string	O nome do membro da equipe que possui atualmente o item de trabalho.
Tipo	wiql__System_WorkItemType		string	O nome do tipo de item de trabalho.
Caminho de Área	wiql__System_AreaPath		string	O recurso do produto ou a área de equipe em que o item de trabalho está.
Comparação de caminho 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 o período em que o item de trabalho está.
Comparação de caminho de iteração	iterationPathComparison		string	A regra a ser usada ao comparar o campo Caminho da Iteração.
Priority	wiql__Microsoft_VSTS_Common_Priority		string	Uma classificação subjetiva do bug, problema, tarefa ou caso de teste, conforme ele se relaciona ao negócio.
Criado por	wiql__System_CreatedBy		string	O nome do membro da equipe que criou o item de trabalho.

Retornos

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

Quando um item de trabalho é atualizado [PRETERIDO]

ID da operação:: OnWorkItemUpdated

Esta ação foi preterida. Use quando um item de trabalho for atualizado .

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

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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 equipe (para escolher Atribuído a)	team		string	O nome da equipe da qual selecionar um atribuídor.
Atribuído a	wiql__System_AssignedTo		string	O nome do membro da equipe que possui atualmente o item de trabalho.
Tipo	wiql__System_WorkItemType		string	O nome do tipo de item de trabalho.
Caminho de Área	wiql__System_AreaPath		string	O recurso do produto ou a área de equipe em que o item de trabalho está.
Comparação de caminho 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 o período em que o item de trabalho está.
Comparação de caminho de iteração	iterationPathComparison		string	A regra a ser usada ao comparar o campo Caminho da Iteração.
Priority	wiql__Microsoft_VSTS_Common_Priority		string	Uma classificação subjetiva do bug, problema, tarefa ou caso de teste, conforme ele se relaciona ao negócio.
Equipe Project	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.

Retornos

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

Quando um item de trabalho é criado

ID da operação:: OnWorkItemCreatedV2

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

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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 equipe (para escolher Atribuído a)	team		string	O nome da equipe da qual selecionar um atribuídor.
Atribuído a	wiql__System_AssignedTo		string	O nome do membro da equipe que possui atualmente o item de trabalho.
Tipo	wiql__System_WorkItemType		string	O nome do tipo de item de trabalho.
Caminho de Área	wiql__System_AreaPath		string	O recurso do produto ou a área de equipe em que o item de trabalho está.
Comparação de caminho 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 o período em que o item de trabalho está.
Comparação de caminho de iteração	iterationPathComparison		string	A regra a ser usada ao comparar o campo Caminho da Iteração.
Priority	wiql__Microsoft_VSTS_Common_Priority		string	Uma classificação subjetiva do bug, problema, tarefa ou caso de teste, conforme ele se relaciona ao negócio.
Criado por	wiql__System_CreatedBy		string	O nome do membro da equipe que criou o item de trabalho.

Retornos

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

Quando um item de trabalho é criado [PRETERIDO]

ID da operação:: OnWorkItemCreated

Esta ação foi preterida. Use quando um item de trabalho for criado .

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

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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 equipe (para escolher Atribuído a)	team		string	O nome da equipe da qual selecionar um atribuídor.
Atribuído a	wiql__System_AssignedTo		string	O nome do membro da equipe que possui atualmente o item de trabalho.
Tipo	wiql__System_WorkItemType		string	O nome do tipo de item de trabalho.
Caminho de Área	wiql__System_AreaPath		string	O recurso do produto ou a área de equipe em que o item de trabalho está.
Comparação de caminho 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 o período em que o item de trabalho está.
Comparação de caminho de iteração	iterationPathComparison		string	A regra a ser usada ao comparar o campo Caminho da Iteração.
Priority	wiql__Microsoft_VSTS_Common_Priority		string	Uma classificação subjetiva do bug, problema, tarefa ou caso de teste, conforme ele se relaciona ao negócio.
Equipe Project	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.

Retornos

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

Quando um item de trabalho é fechado

ID da operação:: OnWorkItemClosedV2

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

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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 equipe (para escolher Atribuído a)	team		string	O nome da equipe da qual selecionar um atribuídor.
Atribuído a	wiql__System_AssignedTo		string	O nome do membro da equipe que possui atualmente o item de trabalho.
Tipo	wiql__System_WorkItemType		string	O nome do tipo de item de trabalho.
Estado Fechado	closedState		string	A lista separada por vírgulas de valores do campo Estado que indica como o item de trabalho foi fechado (Concluído, Fechado, Concluído, Inativo).
Caminho de Área	wiql__System_AreaPath		string	O recurso do produto ou a área de equipe em que o item de trabalho está.
Comparação de caminho 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 o período em que o item de trabalho está.
Comparação de caminho de iteração	iterationPathComparison		string	A regra a ser usada ao comparar o campo Caminho da Iteração.
Priority	wiql__Microsoft_VSTS_Common_Priority		string	Uma classificação subjetiva do bug, problema, tarefa ou caso de teste, conforme ele se relaciona ao negócio.
Criado por	wiql__System_CreatedBy		string	O nome do membro da equipe que criou o item de trabalho.

Retornos

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

Quando um item de trabalho é fechado [PRETERIDO]

ID da operação:: OnWorkItemClosed

Esta ação foi preterida. Use quando um item de trabalho for fechado .

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

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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 equipe (para escolher Atribuído a)	team		string	O nome da equipe da qual selecionar um atribuídor.
Atribuído a	wiql__System_AssignedTo		string	O nome do membro da equipe que possui atualmente o item de trabalho.
Tipo	wiql__System_WorkItemType		string	O nome do tipo de item de trabalho.
Caminho de Área	wiql__System_AreaPath		string	O recurso do produto ou a área de equipe em que o item de trabalho está.
Comparação de caminho 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 o período em que o item de trabalho está.
Comparação de caminho de iteração	iterationPathComparison		string	A regra a ser usada ao comparar o campo Caminho da Iteração.
Priority	wiql__Microsoft_VSTS_Common_Priority		string	Uma classificação subjetiva do bug, problema, tarefa ou caso de teste, conforme ele se relaciona ao negócio.
Equipe Project	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.

Retornos

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

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

ID da operação:: OnGitPullCreated

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

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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 do ref de origem	sourceRefName		string	O nome do git ref, como uma ramificação ou marca.
Nome do ref de destino	targetRefName		string	O nome do git ref, como uma ramificação ou marca.

Retornos

Uma lista de modelos VSTS.

Corpo: VstsList[GitPullRequest]

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

ID da operação:: OnGitPullClosed

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

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado na URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "acesso a aplicativos de terceiros por meio do 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 do ref de origem	sourceRefName		string	O nome do git ref, como uma ramificação ou marca.
Nome do ref de destino	targetRefName		string	O nome do git ref, como uma ramificação ou marca.

Retornos

Uma lista de modelos VSTS.

Corpo: VstsList[GitPullRequest]

Definições

VstsList[Conta]

Uma lista de modelos VSTS.

Nome	Caminho	Tipo	Description
Value	value	array of Account	Os modelos VSTS

Conta

Nome	Caminho	Tipo	Description
ID da conta	accountId	string	A 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	Description
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 Email	emailAddress	string	Endereço de email da conta.
timestamp	timeStamp	date-time	A hora em que esse 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	Description
Value	value	array of TeamSettingsIteration	Os modelos VSTS

TeamSettingsIteration

Iteração work (Agile)

Nome	Caminho	Tipo	Description
Attributes	Attributes	TeamIterationAttributes	Atributos de iteração de 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 de equipe

Nome	Caminho	Tipo	Description
Data de término	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	Description
Web	web	WebLinks	Links da Web

WebLinks

Links da Web

Nome	Caminho	Tipo	Description
HTML Link	href	string	A URL da Web dos detalhes do build

BuildResult

Resultado da compilação

Nome	Caminho	Tipo	Description
Build Id	id	integer	O identificador exclusivo do build.
Número da Compilação	buildNumber	string	O número de build.
Branch de origem	sourceBranch	string	O branch de controle do código-fonte usado.
Versão de origem	sourceVersion	string	A versão de controle do código-fonte usada pelo build.
Situação	status	string	O status do build.
Priority	priority	string	A prioridade do build.
Tempo de espera	queueTime	date-time	A hora em que o build foi enfileirado.
Hora de Início	startTime	date-time	A hora em que o build foi iniciado.
Hora de término	finishTime	date-time	A hora em que o build foi concluído.
Reason	reason	string	O motivo da compilação.
Resultado	result	string	O resultado do build.
requestedFor	requestedFor	BuildRequestUser	Criar Usuário de Solicitação
Parâmetros	parameters	string	Parâmetros passados para o build, se houver.
definição	definition	BuildResultDefinition	Definição de resultado de build
_Links	_links	Links	Links
Etiquetas	tags	array of string	As marcas aplicadas ao build.
Parâmetros do modelo	templateParameters	object	Os parâmetros de modelo com os qual a execução foi enfileirada.

BuildRequestUser

Criar Usuário de Solicitação

Nome	Caminho	Tipo	Description
Solicitado para	uniqueName	string	O nome exclusivo do usuário para o qual o build foi solicitado.

BuildResultDefinition

Definição de resultado de build

Nome	Caminho	Tipo	Description
ID de definição de build	id	integer	O identificador do definiton de build.
Nome da definição de build	name	string	O nome da definição de build.

VstsList[BuildResult]

Uma lista de modelos VSTS.

Nome	Caminho	Tipo	Description
Value	value	array of BuildResult	Os modelos VSTS

Linha do tempo

Linha do tempo de compilação

Nome	Caminho	Tipo	Description
ID da linha do tempo	id	uuid	Identificador de linha do tempo.
Alterar ID	changeId	integer	Identificador de alteração da linha do tempo.
Última alteração por	lastChangedBy	uuid	O processo ou a pessoa que alterou a linha do tempo pela última vez.
Última alteração ativada	lastChangedOn	date-time	Hora em que a linha do tempo foi alterada pela última vez.
Registros da linha do tempo	records	array of TimelineRecord	Registros da linha do tempo.

TimelineRecord

Registro da linha do tempo

Nome	Caminho	Tipo	Description
ID do registro	id	uuid	Identificador de registro.
Alterar ID	changeId	integer	Identificador de alteração de registro.
ID pai	parentId	uuid	Identificador de registro pai.
Tipo	type	string	Tipo de registro.
Nome	name	string	Nome do registro.
Hora de Início	startTime	date-time	Hora de início do registro.
Hora de término	finishTime	date-time	Tempo de término do registro.
State	state	string	Estado do registro.
Resultado	result	string	Resultado do registro.
Nome do Trabalho	workerName	string	Trabalho processando o registro.
Tentar	attempt	integer	Número da tentativa de registro.
Identificador	identifier	string	Valor do identificador de registro.
Problemas	issues	array of TimelineIssue	Problemas encontrados pelo registro.
log	log	TimelineLogReference	Referência de log da linha do tempo
Pedido	order	integer	Ordem de execução de registro.
details	details	TimelineReference	Referência da linha do tempo
tarefa	task	TimelineTask	Tarefa Linha do tempo
Tentativas anteriores	previousAttempts	array of TimelineReference	Tentativas de registro anteriores.
Percentual Concluído	percentComplete	integer	Porcentagem de registro concluída.
Operação atual	currentOperation	string	Operação de registro atual.
URL	url	string	URL de registro.
Código de resultado	resultCode	string	Registrar código de resultado.
Propriedades	properties	object	Propriedades de registro.

TimelineIssue

Problema de linha do tempo

Nome	Caminho	Tipo	Description
Tipo	type	string	Tipo de problema.
Categoria	category	string	Categoria de problema.
Mensagem	message	string	Mensagem de problema.
Dados	data	object	Emitir dados.
Código de erro	errorCode	string	Emitir código de erro.
Código do aviso	warningCode	string	Emita o código de aviso.

TimelineLogReference

Referência de log da linha do tempo

Nome	Caminho	Tipo	Description
Log Id	id	integer	Identificador de log.
Tipo	type	string	Tipo de log.
Contagem de linhas	lineCount	integer	Número de linhas no log.
URL	url	string	URL de log.

TimelineReference

Referência da linha do tempo

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

TimelineTask

Tarefa Linha do tempo

Nome	Caminho	Tipo	Description
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	Description
Value	value	array of GitRepository	Os modelos VSTS

GitRepository

Repositório Git

Nome	Caminho	Tipo	Description
ID do repositório	id	string	A ID exclusiva 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 Remota do Repositório	remoteUrl	string	A URL por meio da qual o Git pode sincronizar com esse repositório.

VstsList[GitRef]

Uma lista de modelos VSTS.

Nome	Caminho	Tipo	Description
Value	value	array of GitRef	Os modelos VSTS

GitRef

Git Ref

Nome	Caminho	Tipo	Description
Ref Id	objectId	string	A ID exclusiva do ref.
Nome do Ref	name	string	O nome do ref.

VstsList[GitPush]

Uma lista de modelos VSTS.

Nome	Caminho	Tipo	Description
Value	value	array of GitPush	Os modelos VSTS

GitPush

Git Push

Nome	Caminho	Tipo	Description
repositório	repository	GitRepository	Repositório Git
pushedBy	pushedBy	GitPushUser	Git Push User
Ref Updates	refUpdates	array of GitRefUpdate	Os Refs que foram atualizados como parte deste push.
Push Id	pushId	integer	A ID exclusiva do push.
Date	date	date-time	A data em que o push foi criado.

GitPushUser

Git Push User

Nome	Caminho	Tipo	Description
Pusher Id	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 de imagem do pusher	imageUrl	string	A URL para a imagem deste usuário.

VstsList[GitPullRequest]

Uma lista de modelos VSTS.

Nome	Caminho	Tipo	Description
Value	value	array of GitPullRequest	Os modelos VSTS

GitPullRequest

Solicitação de Pull do Git

Nome	Caminho	Tipo	Description
repositório	repository	GitRepository	Repositório Git
ID da Solicitação de Pull	pullRequestId	integer	A ID exclusiva da solicitação de pull.
createdBy	createdBy	PullRequestCreatedBy	Solicitação pull criada por
Data de Criação	creationDate	date-time	A data em que a solicitação de pull foi criada
Data de Encerramento	closedDate	date-time	A data em que a solicitação de pull foi fechada (concluída, abandonada ou mesclada externamente)
Title	title	string	O título da solicitação de pull
Description	description	string	A descrição da solicitação de pull
Nome do ref de origem	sourceRefName	string	O nome do branch de origem da solicitação de pull
Nome do ref de destino	targetRefName	string	O nome do branch de destino da solicitação de pull
É rascunho	isDraft	boolean	Solicitação de pull de rascunho/WIP
Revisores	reviewers	array of PullRequestReviewer	Grupos ou equipes para os quais este revisor contribuiu.
Lista de revisor	reviewerList	string	Uma lista separada por ponto-e-vírgula de nomes exclusivos do revisor que são endereços de email válidos
Lista de revisor necessária	requiredReviewerList	string	Uma lista separada por ponto-e-vírgula de nomes exclusivos do revisor necessários que são endereços de email válidos
Confirmações	commits	array of GitCommitRef	As confirmações contidas na solicitação de pull.
completionOptions	completionOptions	PullRequestCompletionOptions	Opções de conclusão de solicitação de pull
mergeOptions	mergeOptions	PullRequestMergeOptions	Opções de mesclagem de solicitação de pull
Mensagem de falha de mesclagem	mergeFailureMessage	string	Se definido, a mesclagem da solicitação de pull falhou por esse motivo.
closedBy	closedBy	PullRequestClosedBy	Solicitação pull fechada por
autoCompleteSetBy	autoCompleteSetBy	PullRequestAutoCompleteSetBy	Pull Request Auto Complete Set By
URL	url	string	A URL da solicitação de pull.
URL Remota	remoteUrl	string	A URL remota para a solicitação de pull.
ID do artefato	artifactId	string	Uma cadeia de caracteres que identifica exclusivamente essa solicitação de pull.
ID de mesclagem	mergeId	string	A ID de mesclagem da solicitação de pull.
ID de revisão de código	codeReviewId	integer	A ID de revisão de código da solicitação de pull.
Tempo da Fila de Conclusão	completionQueueTime	string	A data mais recente em que a solicitação de pull entrou na fila para ser concluída.
Dá suporte a iterações	supportsIterations	boolean	Se true, essa solicitação de pull dá suporte a várias iterações.

PullRequestCreatedBy

Solicitação pull criada por

Nome	Caminho	Tipo	Description
Criado por nome de exibição	displayName	string	O nome de exibição do criador da solicitação de pull.
Criado por nome exclusivo	uniqueName	string	O nome exclusivo do criador da solicitação de pull.
Criado por ID	id	string	A ID do criador da solicitação de pull.
Criado por URL de Imagem	imageUrl	string	A URL para a imagem do criador da solicitação de pull.
Criado por URL	url	string	A URL do criador da solicitação de pull.

PullRequestClosedBy

Solicitação pull fechada por

Nome	Caminho	Tipo	Description
Fechado por nome de exibição	displayName	string	O nome de exibição da solicitação de pull mais perto.
Fechado por nome exclusivo	uniqueName	string	O nome exclusivo da solicitação de pull mais perto.
Fechado por ID	id	string	A ID da solicitação de pull mais perto.
Url de Imagem Fechada por Imagem	imageUrl	string	A URL para a imagem da solicitação de pull mais perto.
Fechado por URL	url	string	A URL da solicitação de pull mais perto.

PullRequestAutoCompleteSetBy

Pull Request Auto Complete Set By

Nome	Caminho	Tipo	Description
Preenchimento automático definido por nome de exibição	displayName	string	O nome de exibição do usuário que habilitou a conclusão automática.
Preenchimento automático definido por nome exclusivo	uniqueName	string	O nome exclusivo do usuário que habilitou a conclusão automática.
Preenchimento automático definido por ID	id	string	A ID do usuário que habilitou a conclusão automática.
Preenchimento automático definido por url de imagem	imageUrl	string	A URL para a imagem do usuário que habilitou a conclusão automática.
Preenchimento automático definido por url	url	string	A URL do usuário que habilitou a conclusão automática.

PullRequestReviewer

Revisor de Solicitação de Pull

Nome	Caminho	Tipo	Description
Nome de Exibição do Revisor	displayName	string	O nome de exibição do revisor de solicitação de pull.
Nome Exclusivo do Revisor	uniqueName	string	O nome exclusivo do revisor de solicitação de pull.
ID do revisor	id	string	A ID do revisor de solicitação de pull.
URL do Revisor	url	string	A URL do revisor de solicitação de pull.
Recusou	hasDeclined	boolean	Indica se esse revisor se recusou a examinar essa solicitação de pull.
Está sinalizado	isFlagged	boolean	Indica se esse revisor está sinalizado para atenção nesta solicitação de pull.
É necessário	isRequired	boolean	Indica se esse é um revisor necessário para essa solicitação de pull.
Vote	vote	integer	Votação de um pedido de pull: aprovado(10), aprovado com sugestões(5), sem voto(0), aguardando autor(-5), rejeitado(-10).
Votado em	votedFor	array of PullRequestReviewer	Grupos ou equipes para os quais este revisor contribuiu.

PullRequestMergeOptions

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

Nome	Caminho	Tipo	Description
Sem Avanço Rápido	noFastForward	string	Uma mesclagem de dois pais, sem avanço rápido. O branch de origem não foi alterado. Esse é o comportamento padrão.
Rebase	rebase	string	Basear novamente o branch de origem na parte superior da confirmação HEAD do branch de destino e encaminhar rapidamente o branch de destino.
Rebase Merge	rebaseMerge	string	Basear novamente o branch de origem na parte superior da confirmação HEAD do branch de destino e criar uma mesclagem sem avanço rápido de dois pais.
Abóbora	squash	string	Coloque todas as alterações da solicitação de pull em uma confirmação de pai único.

PullRequestMergeStrategy

Estratégia de mesclagem de solicitação de pull

Nome	Caminho	Tipo	Description
Confirmações de autoria de conflito	conflictAuthorshipCommits	boolean	Se for true, as resoluções de conflito aplicadas durante a mesclagem serão colocadas em confirmações separadas para preservar as informações de autoria para a culpa do git.
Detectar renomeação de falsos positivos	detectRenameFalsePositives	boolean	Se verdadeiro, detecta a renomeação de falsos positivos.
Desabilitar Renomeações	disableRenames	boolean	Se for true, a detecção de renomeação não será executada durante a mesclagem.

PullRequestCompletionOptions

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

Nome	Caminho	Tipo	Description
Ignorar automaticamente as IDs de configuração	autoCompleteIgnoreConfigIds	array of integer	Lista de quaisquer IDs de configuração de política que sejam concluídas automaticamente não devem aguardar
Política de bypass	bypassPolicy	boolean	Se for true, as políticas serão explicitamente ignoradas enquanto a solicitação de pull for concluída.
Motivo do bypass	bypassReason	string	Se as políticas forem ignoradas, esse motivo será armazenado quanto ao motivo pelo qual o bypass foi usado.
Excluir Branch de Origem	deleteSourceBranch	boolean	Se for true, o branch de origem da solicitação de pull será excluído após a conclusão.
Mesclar mensagem de confirmação	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 de pull
Mesclagem de Squash	squashMerge	boolean	Se MergeStrategy não estiver definido, a estratégia de mesclagem não será rápida se esse sinalizador for falso ou se for verdadeiro.
Itens de trabalho de transição	transitionWorkItems	boolean	Se for true, tentaremos fazer a transição de todos os itens de trabalho vinculados à solicitação de pull para o próximo estado lógico (ou seja, Ativo –> Resolvido).

CommitGitUserDate

Confirmar data do usuário do Git

Nome	Caminho	Tipo	Description
Confirmar Data do Usuário	date	string	Data da operação git.
Confirmar Email do Usuário	email	string	Endereço de email do usuário que está executando a operação Git.
Url de Imagem de Confirmação	imageUrl	string	Url para o avatar do usuário.
Confirmar nome de usuário	name	string	Nome do usuário que está executando a operação Git.

GitCommitRef

Git Commit Ref

Nome	Caminho	Tipo	Description
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 de comentário de confirmação completa do Git.
ID de confirmação	commitId	string	ID da confirmação.
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 Remota	remoteUrl	string	Caminho da URL remota para a confirmação.
Url de confirmação	url	string	URL REST para este recurso.

GitRefUpdate

Atualização do Git Ref

Nome	Caminho	Tipo	Description
Nome do Ref	name	string	O nome do Git Ref que foi atualizado.
ID do repositório	repositoryId	string	A ID exclusiva do repositório.
ID de Confirmação Antiga	oldObjectId	string	A ID da confirmação anterior que este Ref apontou antes da atualização.
Nova ID de Confirmação	newObjectId	string	A ID da nova confirmação que este Ref apontou antes da atualização.

VstsList[Project]

Uma lista de modelos VSTS.

Nome	Caminho	Tipo	Description
Value	value	array of Project	Os modelos VSTS

Project

Nome	Caminho	Tipo	Description
Project ID	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[TeamMember]

Uma lista de modelos VSTS.

Nome	Caminho	Tipo	Description
Value	value	array of TeamMember	Os modelos VSTS

TeamMember

Membro da equipe

Nome	Caminho	Tipo	Description
ID do membro da equipe	id	string	A ID exclusiva do membro da equipe.
Nome de Exibição	displayName	string	O nome de exibição do membro da equipe.
Nome Exclusivo	uniqueName	string	O nome de usuário do membro da equipe.
URI do membro	url	string	O URI do membro da equipe.
URI da imagem	imageUrl	string	O URI da imagem do membro da equipe.

VstsList[ReleaseDefinition]

Uma lista de modelos VSTS.

Nome	Caminho	Tipo	Description
Value	value	array of ReleaseDefinition	Os modelos VSTS

ReleaseDefinition

Definição de versão

Nome	Caminho	Tipo	Description
Comment	Comment	string	O comentário da definição de versão.
Data da criação	CreatedOn	date-time	A data em que a definição da 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.
ModifiedBy	ModifiedBy	IdentityRef	Ref de Identidade
Data da modificação	ModifiedOn	date-time	A data em que a definição da versão 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 da versão	ReleaseNameFormat	string	O formato do nome da versão da definição de versão.
Revisão	Revision	integer	O número de revisão da definição de versão.
Source	Source	string	A origem da definição de versão.
Etiquetas	Tags	array of string	A lista de marcas da definição de versão.
URL	Url	string	A URL para acessar a definição de versão.

IdentityRef

Ref de Identidade

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

ReleaseDefinitionShallowReference

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

Nome	Caminho	Tipo	Description
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	A URL da API REST para acessar a definição de versão.

Object

ObjectWithoutType

Liberação

Nome	Caminho	Tipo	Description
Comment	Comment	string	O comentário da versão.
CreatedBy	CreatedBy	IdentityRef	Ref de Identidade
Data da criação	CreatedOn	date-time	A data em que a versão foi criada.
Description	Description	string	A descrição da versão.
ID	Id	integer	O identificador exclusivo da versão.
Manter para sempre	KeepForever	boolean	Se deseja excluir a versão das políticas de retenção.
URL do Contêiner de Logs	LogsContainerUrl	string	A URL do contêiner de logs desta versão.
ModifiedBy	ModifiedBy	IdentityRef	Ref de Identidade
Data da modificação	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.
ReleaseDefinition	ReleaseDefinition	ReleaseDefinitionShallowReference	Referência superficial da definição de versão
Situação	Status	string	O status da versão.
URL	Url	string	A URL da versão.

VstsList[TfvcChangeset]

Uma lista de modelos VSTS.

Nome	Caminho	Tipo	Description
Value	value	array of TfvcChangeset	Os modelos VSTS

TfvcChangeset

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

Nome	Caminho	Tipo	Description
ID do conjunto de alterações	changesetId	integer	A ID exclusiva do conjunto de alterações.
autor	author	ChangesetAuthor	Autor do conjunto de alterações
checkedInBy	checkedInBy	ChangesetCheckedInBy	Conjunto de alterações check-in por
Data de criação	createdDate	date-time	O datetime 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	Description
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 check-in por

Nome	Caminho	Tipo	Description
Check-in por nome	displayName	string	O nome do usuário que verificou o 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	Description
Value	value	array of WorkItemType	Os modelos VSTS.

WorkItemHit

Termos correspondentes no campo do resultado do item de trabalho

Nome	Caminho	Tipo	Description
Nome da referência de campo	fieldReferenceName	string	Nome de referência do campo realçado.
Destaques	highlights	array of string	Snippets correspondentes/realçados do campo.

WorkItemResult

Resultado do item de trabalho que correspondeu a uma solicitação de pesquisa de item de trabalho

Nome	Caminho	Tipo	Description
projeto	project	SearchProject	Project detalhes dos resultados da pesquisa
Fields	fields	object	Um conjunto padrão de campos de item de trabalho e seus valores.
Hits	hits	array of WorkItemHit	Trechos de código realçados de campos que correspondem à solicitação de pesquisa.
URL	url	string	Referência ao item de trabalho.

SearchProject

Project detalhes dos resultados da pesquisa

Nome	Caminho	Tipo	Description
ID	id	string	ID do projeto.
Nome	name	string	Nome do projeto.

WorkItemSearchResponse

Resposta de pesquisa de item de trabalho

Nome	Caminho	Tipo	Description
Contagem	count	integer	Número total de itens de trabalho correspondentes.
Resultados	results	array of WorkItemResult	Lista dos principais itens de trabalho correspondentes.
Código de informações	infoCode	integer	Código numérico que indica informações adicionais.
Facetas	facets	object	Um dicionário armazenando uma matriz de objeto Filter em cada faceta.

WorkItemType

Tipo de Item de Trabalho

Nome	Caminho	Tipo	Description
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.
Fields	FieldInstances	array of WorkItemTypeFieldInstance	Uma lista de instâncias de campo associadas ao tipo.
ID do ícone	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 do campo Tipo de Item de Trabalho

Nome	Caminho	Tipo	Description
Sempre necessário	AlwaysRequired	boolean	Especifica se a instância de campo é sempre necessária.
Nome da 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 que aponta para detalhes da instância de campo.

WorkItemComment

Comentário do Item de Trabalho

Nome	Caminho	Tipo	Description
_Links	_links	ReferenceLinks	Coleção de links de referência REST.
ID do comentário	id	integer	A ID exclusiva do comentário.
ID do item de trabalho	workItemId	integer	A ID do item de trabalho à qual o comentário pertence.
Versão	version	integer	A revisão do item de trabalho associada a este comentário.
Formato de 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 de comentário.
createdBy	createdBy	IdentityRef	Ref de Identidade
Data de criação	createdDate	date-time	A data em que o comentário foi criado.
createdOnBehalfOf	createdOnBehalfOf	IdentityRef	Ref de Identidade
Data criada em nome	createdOnBehalfDate	date-time	Data de criação efetiva em nome de outra identidade.
modifiedBy	modifiedBy	IdentityRef	Ref de Identidade
Data de Modificação	modifiedDate	date-time	A data em que o comentário foi modificado pela última vez.
Está Excluído	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.

CommentFormat

Especifica como o texto do comentário é interpretado.

Formato de comentário: string

CommentMention

Representa uma menção em um comentário.

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

CommentReactionType

Tipo de reação de comentário.

Tipo de reação: string

CommentReaction

Contém informações sobre uma reação de comentário de item de trabalho.

Nome	Caminho	Tipo	Description
_Links	_links	ReferenceLinks	Coleção de links de referência REST.
ID do comentário	commentId	integer	A ID do comentário à qual essa reação pertence.
Contagem	count	integer	Número total de reações para esse tipo de reação.
O usuário atual está envolvido	isCurrentUserEngaged	boolean	Indica se o usuário atual se envolveu com essa reação.
Tipo de reação	type	CommentReactionType	Tipo de reação de comentário.
URL	url	string	A URL da API REST da reação.

ReferenceLinks

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

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

WorkItemAttachmentResponse

Nome	Caminho	Tipo	Description
attachmentId	attachmentId	string	Identificador do anexo.
fileName	fileName	string	Nome do arquivo de anexo.
tipo de conteúdo	contentType	string	Tipo MIME do anexo.
contentLength	contentLength	integer	Tamanho do anexo em bytes.
últimaModificação	lastModified	date-time	Carimbo de data/hora modificado pela última vez para o anexo.
conteúdo	content	byte	Conteúdo do anexo codificado como uma cadeia de caracteres Base64.

WorkItemCommentsResponse

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

Nome	Caminho	Tipo	Description
Contagem	count	integer	A contagem total de comentários.
Comments	comments	array of WorkItemComment	A lista de comentários.

VstsList[JObject]

Uma lista de modelos VSTS.

Nome	Caminho	Tipo	Description
Value	value	array of Object	Os modelos VSTS

VstsList[WorkItemField]

Uma lista de modelos VSTS.

Nome	Caminho	Tipo	Description
Value	value	array of WorkItemField	Os modelos VSTS

VstsList[QueryHierarchyItem]

Uma lista de modelos VSTS.

Nome	Caminho	Tipo	Description
Value	value	array of QueryHierarchyItem	Os modelos VSTS

QueryHierarchyItem

Item de hierarquia de consulta

Nome	Caminho	Tipo	Description
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 do 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 de hierarquia de consulta tem filhos.
ID	Id	string	O identifer exclusivo do item de hierarquia de consulta.
Está Excluído	IsDeleted	boolean	Especifica se o item de hierarquia de consulta é excluído.
É Pasta	IsFolder	boolean	Especifica se o item de hierarquia de consulta é uma pasta.
Sintaxe inválida	IsInvalidSyntax	boolean	Especifica se o item de hierarquia de consulta tem sintaxe inválida.
É público	IsPublic	boolean	Especifica se o item de hierarquia de consulta é público.
LinkClauses	LinkClauses	WorkItemQueryClause	Cláusula de consulta de item de trabalho
Nome	Name	string	O nome do item de 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.
SourceClauses	SourceClauses	WorkItemQueryClause	Cláusula de consulta de item de trabalho
TargetClauses	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	Description
categoria de estado	category	string	categoria de estado
Valor de cor	color	string	Valor de cor
nome do estado	name	string	Nome do estado do tipo de item de trabalho

WorkItemQueryClause

Cláusula de consulta de item de trabalho

Nome	Caminho	Tipo	Description
Cláusulas	Clauses	WorkItemQueryClause	Cláusula de consulta de item de trabalho
Campo	Field	WorkItemFieldReference	Referência de campo de item de trabalho
FieldValue	FieldValue	WorkItemFieldReference	Referência de campo de item de trabalho
É o valor do campo	IsFieldValue	boolean	Especifica se a cláusula de consulta do item de trabalho é um valor de campo.
Operador lógico	LogicalOperator	string	O operador lógico da cláusula de consulta do item de trabalho.
Operator	Operator	WorkItemFieldOperation	Operação de campo de item de trabalho
Value	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	Description
Nome	Name	string	O nome da referência do campo de item de trabalho.
Nome da 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 classificação de consulta de item de trabalho

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

WorkItemField

Campo Item de Trabalho

Nome	Caminho	Tipo	Description
Nome	Name	string	O nome de exibição do campo de item de trabalho.
Somente leitura	ReadOnly	boolean	Especifica se o campo é somente leitura.
É Identidade	IsIdentity	boolean	Especifica se o campo contém informações de identidade.
É a lista de seleção	IsPicklist	boolean	Especifica se o campo usa uma lista de seleção.
Nome da referência	ReferenceName	string	O nome de referência do campo de item de trabalho.
Description	Description	string	A descrição do campo de item de trabalho.
Operações com suporte	SupportedOperations	array of WorkItemFieldOperation	A lista de operações com suporte pelo campo.
Tipo	Type	string	O tipo de dados do campo de item de trabalho.
URL	Url	string	A URL do campo de item de trabalho.

WorkItemFieldOperation

Operação de campo de item de trabalho

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

Pipeline

Nome	Caminho	Tipo	Description
count	count	integer	count
value	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

Run

Nome	Caminho	Tipo	Description
count	count	integer	count
value	value	array of object	Execução do 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
estado	value.state	RunState	Estado de execução
createdDate	value.createdDate	string	data criada
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
finishedDate	value.finishedDate	string	data de término da execução

RunResult

Resultado da Execução

: string

RunState

Estado de execução

: string

PipelineRun

Uma única execução de pipeline.

Nome	Caminho	Tipo	Description
Executar ID	id	integer	O identificador da execução.
Nome da Execução	name	string	O nome da execução, que corresponde ao número de build.
State	state	string	O estado da execução.
Resultado	result	string	O resultado da execução após a conclusão.
Data de criação	createdDate	string	A hora em que a execução foi criada.
Data de término	finishedDate	string	A hora em que a execução terminou.
Executar URL	url	string	A URL REST da execução.
Parâmetros do modelo	templateParameters	object	Os parâmetros de modelo com os qual a execução foi iniciada.
Variables	variables	object	As variáveis de runtime com as qual a execução foi iniciada.
Resources	resources	object	As versões de recurso usadas pela execução.
Pipeline Id	pipeline.id	integer	O identificador do pipeline.
Nome do Pipeline	pipeline.name	string	O nome do pipeline.
Pasta	pipeline.folder	string	A pasta na qual o pipeline reside.
Revisão	pipeline.revision	integer	A revisão do pipeline.
Pipeline do URL	pipeline.url	string	A URL REST do pipeline.

GitItem

Um item (arquivo ou pasta) em um repositório Git.

Nome	Caminho	Tipo	Description
ID do objeto	objectId	string	A ID do objeto do item.
ID de confirmação	commitId	string	A confirmação da qual 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 do repositório do item.
É Pasta	isFolder	boolean	Indica se o item é uma pasta.
Content	content	string	O conteúdo do texto do arquivo. Retornado somente quando o conteúdo de inclusão for verdadeiro.
Item URL	url	string	A URL REST do item.

GitRefItem

Um ref do Git, como um branch ou uma marca.

Nome	Caminho	Tipo	Description
Nome do Ref	name	string	O nome completo do ref, por exemplo refs/heads/main.
ID do objeto	objectId	string	A ID do objeto em que o ref aponta.
ID do objeto descascado	peeledObjectId	string	A ID de confirmação para a qual uma marca anotada é resolvida.
Ref URL	url	string	A URL REST do ref.
Criador	creator	object	A identidade que criou o ref.

GitRefList

Uma lista de refs do Git.

Nome	Caminho	Tipo	Description
Contagem	count	integer	O número de refs retornados.
Refs	value	array of GitRefItem	Os árbitros.

GitPushResponse

O resultado de um push.

Nome	Caminho	Tipo	Description
Push Id	pushId	integer	O identificador do push.
Date	date	string	A hora em que o empurrão foi feito.
Push URL	url	string	A URL REST do push.
Enviado por push	pushedBy	object	A identidade que fez o push.
Ref Updates	refUpdates	array of GitRefItem	Os refs que foram atualizados.
Confirmações	commits	array of object	As confirmações que foram enviadas por push.
ID de confirmação	commits.commitId	string	A ID da confirmação.
Comment	commits.comment	string	A mensagem do commit.
URL da confirmação	commits.url	string	A URL REST da confirmação.

GitPullRequestResponse

Uma solicitação de pull.

Nome	Caminho	Tipo	Description
ID da Solicitação de Pull	pullRequestId	integer	O identificador da solicitação de pull.
ID de revisão de código	codeReviewId	integer	A ID de revisão de código da solicitação de pull.
Situação	status	string	O status da solicitação de pull.
Title	title	string	O título da solicitação de pull.
Description	description	string	A descrição da solicitação de pull.
Branch de origem	sourceRefName	string	A ramificação da qual as alterações vêm.
Branch de destino	targetRefName	string	A ramificação em que as alterações são mescladas.
Status da mesclagem	mergeStatus	string	O status de mesclagem da solicitação de pull.
É rascunho	isDraft	boolean	Indica se a solicitação de pull é um rascunho.
Data de Criação	creationDate	string	A hora em que a solicitação de pull foi criada.
URL da Solicitação de Pull	url	string	A URL REST da solicitação de pull.
Criado por	createdBy	object	A identidade que criou a solicitação de pull.
Repositório	repository	object	O repositório de destinos de solicitação de pull.