Quadros do ADO

O Azure DevOps Boards fornece serviços para as equipes acompanharem o trabalho - para qualquer idioma, tudo em um único pacote.

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

Service	Classe	Regions
Aplicativos Lógicos	Standard	Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:      – Azure Government regiões      - Azure regiões da China      - Departamento de Defesa dos EUA (DoD)

Contato
Nome	Microsoft
URL	Suporte do Microsoft LogicApps

Metadados do conector
Publicador	Microsoft

Limitações

Nome	Chamadas	Período de renovação
Chamadas à 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 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 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 projetos	Recupera a lista de projetos em uma organização.
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 Assuntos com base na consulta	Obter Assuntos com base na consulta
Obter resultados da consulta (versão prévia)	Recupera o resultado de uma consulta de item de trabalho.
Obter um perfil de usuário	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

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 projeto	project	True	string	O nome do projeto dentro da Organização especificada.
Prioridade	priority		integer	A prioridade do item de trabalho.
Chave	key		string	A chave do campo
value	value		string	O valor do campo

Retornos

response

object

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 projeto	project	True	string	O nome do projeto dentro da Organização especificada.

Retornos

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 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 projeto	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

VstsListQueryHierarchyItem

Listar organizações

ID da operação:

ListAccounts

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

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
ID do membro	memberId	True	string	ID do membro

Retornos

Uma lista de modelos VSTS.

Corpo

VstsListAccount

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

Retornos

Corpo

VstsListListWorkItemResponse

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

VstsListProject

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 projeto	project	True	string	O nome do projeto dentro da Organização especificada.

Retornos

Uma lista de modelos VSTS.

Corpo

VstsListWorkItemType

Obter Assuntos com base na consulta

ID da operação:

GetSubject

Obter Assuntos com base na consulta

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.
Searchterm	query	True	string	Termo de pesquisa para pesquisar usuários ou/e grupos do Azure Devops.
SubjectKind	subjectKind	True	array of string	Usuário ou Grupo podem ser especificados, ambos ou qualquer um
Descritor de escopo	scopeDescriptor		string	Param opcional

Retornos

Uma lista de Assuntos do Graph.

Corpo

VstsListSubject

Obter resultados da consulta (versão prévia)

ID da operação:

GetQueryResults

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 projeto	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

VstsListJObject

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

Definições

VstsListAccount

Uma lista de modelos VSTS.

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

Conta

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

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

VstsListProject

Uma lista de modelos VSTS.

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

Projeto

Projeto

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

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

QueryHierarchyItem

Item de hierarquia de consulta

Nome	Caminho	Tipo	Description
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.
É Pasta	isFolder	boolean	Especifica se o item de hierarquia de consulta é uma pasta.
É público	isPublic	boolean	Especifica se o item de hierarquia de consulta é público.
Nome	name	string	O nome do item de hierarquia de consulta.
Caminho	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.

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

WorkItemType

Tipo de Item de Trabalho

Nome	Caminho	Tipo	Description
Descrição	description	string	A descrição do tipo.
Nome	name	string	O nome do 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

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

VstsListListWorkItemResponse

Nome	Caminho	Tipo	Description
value	value	array of ListWorkItemResponse

ListWorkItemResponse

Resposta do item de trabalho para a operação itens de trabalho de lista

Nome	Caminho	Tipo	Description
ID	id	integer	A ID exclusiva do item de trabalho.
Caminho de Área	areaPath	string	O caminho da área do item de trabalho.
Projeto de equipe	teamProject	string	O projeto de equipe ao qual o item de trabalho pertence.
Caminho de Iteração	iterationPath	string	O caminho de iteração do item de trabalho.
Tipo de Item de Trabalho	workItemType	string	O tipo do item de trabalho.
State	state	string	O estado do item de trabalho.
Reason	reason	string	O motivo inserido para o item de trabalho.
Data da Alteração	updatedAt	string	O datetime em que o item de trabalho foi alterado.
Data de vencimento	dueDate	string	A data de conclusão do item de trabalho.
priority	priority	string	priority
Título	title	string	O título do item de trabalho.
Etiquetas	tags	string	As marcas do item de trabalho.
Atribuído a	assignedTo	string	O email do membro da equipe que atualmente possui o item de trabalho.
Atribuído ao Nome	assignedToName	string	O nome do membro da equipe que possui atualmente o item de trabalho.

VstsListJObject

Uma lista de modelos VSTS.

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

VstsListSubject

Uma lista de Assuntos do Graph.

Nome	Caminho	Tipo	Description
Valor	value	array of Subject	As entidades do Graph

Assunto

Definição de assunto

Nome	Caminho	Tipo	Description
DisplayName	displayName	string	O identificador exclusivo da definição de build.
Endereço de email	mailAddress	string	Endereço de email do assunto
Nome principal	principalName	string	O nome principal do assunto
SubjectKind	subjectKind	string	O nome principal do assunto
Avatar	avatar	string	URL do avatar

Objeto

objeto

Esse é o tipo 'object'.