Conselhos ADO

O Azure DevOps Boards fornece serviços para equipas acompanharem o trabalho – para qualquer linguagem, tudo num único pacote.

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

Service	Classe	Regiões
Aplicações Lógicas	Standard	Todas as regiões do Logic Apps , exceto as seguintes:      - Regiões Azure Government      - Regiões Azure China      - Departamento de Defesa dos EUA (DoD)

Entrar em contato
Nome	Microsoft
URL	Suporte do Microsoft LogicApps

Metadados do conector
Editor	Microsoft

Limites de Limitação

Name	Chamadas	Período de Renovação
Chamadas de API por conexão	100	60 segundos

Ações

Atualizar um item de trabalho	Atualize um item de trabalho existente por id.
Listar consultas de nível raiz	Recupera a lista de consultas de item de trabalho de nível raiz em um projeto.
Listar consultas dentro da pasta	Recupera a lista de consultas de item de trabalho dentro de uma pasta para um determinado projeto.
Listar itens de trabalho	Retorna uma lista de itens de trabalho.
Listar organizações	Recupera a lista de Organizações das quais o usuário é membro.
Listar projetos	Recupera a lista de projetos em uma organização.
Listar tipos de item de trabalho	Recupera a lista de Tipos de Itens de Trabalho acessíveis num dado projeto Azure DevOps.
Obtenha as disciplinas com base na consulta	Obtenha as disciplinas com base na consulta
Obter resultados de consultas (Pré-visualização)	Recupera o resultado de uma consulta de item de trabalho.
Obter um perfil de utilizador	Obtém um perfil de usuário.

Atualizar um item de trabalho

ID da Operação:

UpdateWorkItem

Atualize um item de trabalho existente por id.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
ID do item de trabalho	id	True	string	A ID exclusiva do item de trabalho a ser atualizado.
Nome do Projeto	project	True	string	O nome do projeto dentro da organização especificada.
Prioridade	priority		integer	A prioridade do trabalho.
Chave	key		string	A chave do campo
value	value		string	O valor do campo

Devoluções

response

object

Listar consultas de nível raiz

ID da Operação:

ListRootQueryFolders

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

Parâmetros

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

Devoluções

Uma lista de modelos VSTS.

Corpo

VstsListQueryHierarchyItem

Listar consultas dentro da pasta

ID da Operação:

ListQueriesInFolder

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

Parâmetros

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

Devoluções

Uma lista de modelos VSTS.

Corpo

VstsListQueryHierarchyItem

Listar itens de trabalho

ID da Operação:

ListWorkItems

Retorna uma lista de itens de trabalho.

Parâmetros

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

Devoluções

Corpo

VstsListListWorkItemResponse

Listar organizações

ID da Operação:

ListAccounts

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

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID do Membro	memberId	True	string	ID do Membro

Devoluções

Uma lista de modelos VSTS.

Corpo

VstsListAccount

Listar projetos

ID da Operação:

ListProjects

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

Parâmetros

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

Devoluções

Uma lista de modelos VSTS.

Corpo

VstsListProject

Listar tipos de item de trabalho

ID da Operação:

ListWorkItemTypes

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

Parâmetros

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

Devoluções

Uma lista de modelos VSTS.

Corpo

VstsListWorkItemType

Obtenha as disciplinas com base na consulta

ID da Operação:

GetSubject

Obtenha as disciplinas com base na consulta

Parâmetros

Name	Chave	Necessário	Tipo	Description
Nome da Organização	account	True	string	O nome da Organização. Isso pode ser encontrado no URL da instância, ou seja, {Organization}.visualstudio.com. A Organização deve ter o "Acesso a aplicativos de terceiros via OAuth" habilitado para evitar erros na operação.
SearchTerm	query	True	string	Termo de pesquisa para pesquisar utilizadores e/ou grupos de Azure DevOps.
SujeitoTipo	subjectKind	True	array of string	Utilizador ou Grupo podem ser especificados, ambos ou qualquer um dos dois
Descritor de Âmbito	scopeDescriptor		string	Param opcional

Devoluções

Uma lista de Sujeitos de Grafos.

Corpo

VstsListSubject

Obter resultados de consultas (Pré-visualização)

ID da Operação:

GetQueryResults

Recupera o resultado de uma consulta de item de trabalho.

Parâmetros

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

Devoluções

Uma lista de modelos VSTS.

Corpo

VstsListJObject

Obter um perfil de utilizador

ID da Operação:

GetProfile

Obtém um perfil de usuário.

Parâmetros

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

Devoluções

Perfil

Corpo

Profile

Definições

VstsListAccount

Uma lista de modelos VSTS.

Name	Caminho	Tipo	Description
Valor	value	array of Account	Os modelos VSTS

Conta

Conta

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

Perfil

Perfil

Name	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 E-mail	emailAddress	string	Endereço de e-mail da conta.
Carimbo de data/hora	timeStamp	date-time	O momento em que este perfil foi alterado pela última vez.
revisão	revision	integer	O número máximo de revisão de qualquer atributo.
CoreRevision	coreRevision	integer	CoreRevision

VstsListProject

Uma lista de modelos VSTS.

Name	Caminho	Tipo	Description
Valor	value	array of Project	Os modelos VSTS

Projeto

Projeto

Name	Caminho	Tipo	Description
ID do projeto	id	string	O identificador exclusivo do projeto.
Nome do Projeto	name	string	O nome do projeto.
URL do projeto	url	string	A URL da API do projeto.

VstsListQueryHierarchyItem

Uma lista de modelos VSTS.

Name	Caminho	Tipo	Description
Valor	value	array of QueryHierarchyItem	Os modelos VSTS

QueryHierarchyItem

Item de hierarquia de consulta

Name	Caminho	Tipo	Description
Tem filhos	hasChildren	boolean	Especifica se o item da hierarquia de consulta tem filhos.
Id	id	string	O identificador exclusivo do item de hierarquia de consulta.
É pasta	isFolder	boolean	Especifica se o item da hierarquia de consulta é uma pasta.
É público	isPublic	boolean	Especifica se o item da hierarquia de consulta é público.
Nome	name	string	O nome do item da hierarquia de consulta.
Path	path	string	O caminho 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.

VstsListWorkItemType

Uma lista de modelos VSTS.

Name	Caminho	Tipo	Description
Valor	value	array of WorkItemType	Os modelos VSTS.

WorkItemType

Tipo de item de trabalho

Name	Caminho	Tipo	Description
Descrição	description	string	A descrição do tipo.
Nome	name	string	O nome do tipo.
ícone Id	icon.id	string	O identificador do ícone
URL do ícone	icon.url	string	A URL REST do recurso
States	states	array of WorkItemStateColor	Estados do tipo de item de trabalho

WorkItemStateColor

Cor do Estado do Item de Trabalho

Name	Caminho	Tipo	Description
Categoria de Estado	category	string	Categoria de Estado
Valor da cor	color	string	Valor da cor
nome do estado	name	string	Nome do estado do tipo de item de trabalho

VstsListListWorkItemResponse

Name	Caminho	Tipo	Description
value	value	array of ListWorkItemResponse

ListWorkItemResponse

Resposta a Item de Trabalho para a operação Listar Itens de Trabalho

Name	Caminho	Tipo	Description
Id	id	integer	O ID único do artigo de trabalho.
Caminho da Área	areaPath	string	O caminho da área do item de trabalho.
Projeto de Equipa	teamProject	string	O projeto de equipa ao qual pertence o item de trabalho.
Caminho de iteração	iterationPath	string	O caminho de iteração do item de trabalho.
Tipo de item de trabalho	workItemType	string	O tipo de artigo de trabalho.
Estado	state	string	O estado do item de trabalho.
Justificação	reason	string	A razão introduzida para o item de trabalho.
Data alterada	updatedAt	string	A data e hora do item do trabalho foi alterada.
Data de vencimento	dueDate	string	A data de entrega é o item do trabalho.
priority	priority	string	priority
Título	title	string	O título do artigo de trabalho.
Etiquetas	tags	string	As etiquetas do artigo de trabalho.
Atribuído A	assignedTo	string	O email do membro da equipa que atualmente detém o item de trabalho.
Atribuído ao Nome	assignedToName	string	O nome do membro da equipe que atualmente possui o item de trabalho.

VstsListJObject

Uma lista de modelos VSTS.

Name	Caminho	Tipo	Description
Valor	value	array of Object	Os modelos VSTS

VstsListSubject

Uma lista de Sujeitos de Grafos.

Name	Caminho	Tipo	Description
Valor	value	array of Subject	Os Sujeitos do Grafo

Assunto

Definição do Sujeito

Name	Caminho	Tipo	Description
Nome de Exibição	displayName	string	O identificador único da definição de build.
Endereço de correio	mailAddress	string	Endereço postal do objeto
Nome Principal	principalName	string	O nome principal do sujeito
SujeitoTipo	subjectKind	string	O nome principal do sujeito
Avatar	avatar	string	URL do avatar

Objeto

objecto

Este é o tipo 'objeto'.