Compartilhar via


Jira

O Jira é uma ferramenta de desenvolvimento de software para equipes ágeis planejarem, acompanharem e lançarem software de classe mundial. Conectar problemas do Jira ao restante de suas ferramentas ajuda a quebrar barreiras e liberar o potencial de sua equipe.

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

Service Class Regions
Copilot Studio Premium Todas as regiões do Power Automate , exceto as seguintes:
     - China Cloud operado pela 21Vianet
Aplicativos Lógicos Standard Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões do Power Apps , exceto as seguintes:
     - China Cloud operado pela 21Vianet
Power Automate Premium Todas as regiões do Power Automate , exceto as seguintes:
     - China Cloud operado pela 21Vianet
Contato
Nome Microsoft
URL https://support.microsoft.com/
Email abapi@microsoft.com
Metadados do conector
Publicador Microsoft
Site da Web https://www.atlassian.com/software/jira
Política de privacidade https://www.atlassian.com/legal/privacy-policy
Categorias Operações de TI; Colaboração

Para usar essa integração, você precisará de uma conta Jira.

Importante

Devido às alterações recentes nas APIs de back-end do Jira, as seguintes atualizações afetam o conector Jira:

  • Consistência de pesquisa: o ponto de extremidade de back-end não fornece consistência imediata de pesquisa após gravação. As atualizações recentes feitas pelos usuários podem não ser refletidas nos resultados da pesquisa imediatamente.
  • Limites de itens retornados: o ponto de extremidade retorna no máximo 20 comentários e 40 itens de changelog.
  • Consultas JQL em gatilhos: não há suporte para consultas JQL não associados. Solicitações com consultas não associadas resultarão em uma resposta de 400 solicitações incorretas.

Para obter mais detalhes: o que é pesquisa avançada no Jira Cloud? Referência: Atlassian Developer Changelog

Problemas e limitações conhecidos

  • Para autenticação, você precisa usar um token de API. Para obter um token, acesse este link.
  • A autenticação básica com senhas foi preterida. Para obter mais informações, consulte a documentação da API do jira.
  • Não há suporte para o Jira Server por trás de um firewall ou com a API REST desabilitada.
  • Ao criar uma conexão com o Jira Cloud, você precisa usar um endereço de email válido para nome de usuário. Caso contrário, a conexão não será estabelecida, embora pareça que foi bem-sucedida.
  • Os nomes de usuário no Jira Cloud são preteridos e não podem mais ser usados para campos como o Reporter. Para obter mais informações, consulte a documentação do Atlassian Cloud.
  • De acordo com a documentação da API Jira, a API jira retorna no máximo 50 projetos, portanto, os 50 principais projetos serão listados em lista suspensa em ações/gatilhos.
  • A paginação foi implementada em Obter projetos. Ele retornará todos os projetos.
  • A ação Criar um novo problema (V2) dá suporte apenas a tipos de campo simples, como 'string', 'number', 'date' e 'datetime' no esquema dinâmico. Se a configuração do projeto tiver campos necessários de tipos de dados complexos, a operação falhará com o erro: "O campo '{key}' do tipo '{type}' não tem suporte". Para solucionar isso, altere a configuração de campos de projeto e torne esses campos não necessários.
  • A ação Criar um novo problema (V3) dá suporte apenas a tipos de campo simples, como 'string', 'number', 'date' e 'datetime' no esquema dinâmico. Se a configuração do projeto tiver campos necessários de tipos de dados complexos, a operação falhará com o erro: "O campo '{key}' do tipo '{type}' não tem suporte". Para solucionar isso, altere a configuração de campos de projeto e torne esses campos não necessários.
  • A Project propriedade esperada pelas ações e gatilhos do conector deve ser preenchida usando uma das seguintes opções:
    • Escolha um projeto no seletor de projeto. Observe que as conexões do Jira Cloud mostram apenas os 50 principais projetos no seletor.
    • Use uma saída da ação Obter projetos (propriedade do Project Key projeto).
  • Para obter mais detalhes da operação Editar Problema , consulte a documentação da API do Jira
  • Quando um fluxo de trabalho começa a falhar com uma resposta 400 ou uma solicitação inválida para qualquer ação ou gatilho, verifique se a chave de API usada para criar a conexão expirou e, se sim, recriar a conexão com uma nova chave de API.

Criando uma conexão

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

API Token Usar o Token de API para acessar o Jira Todas as regiões Não compartilhável
Oauth Use o Oauth para acessar o Jira. Todas as regiões Não 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

Token API

ID de autenticação: APIToken

Aplicável: todas as regiões

Usar o Token de API para acessar o Jira

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.

Nome Tipo Description Obrigatório
Nome de usuário ou email cadeia Seu nome de usuário Jira. Para o Jira Cloud, você precisa usar um endereço de email válido. Verdade
Token de API secureString Seu token de API (https://id.atlassian.com/manage/api-tokens). Verdade

Oauth

ID de autenticação: oauth

Aplicável: todas as regiões

Use o Oauth para acessar o Jira.

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.

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.

Nome Tipo Description Obrigatório
Instância do Jira cadeia A URL em que a instância do Jira está hospedada (deve dar suporte a https). Verdade
Nome de usuário ou email cadeia Seu nome de usuário Jira. Para o Jira Cloud, você precisa usar um endereço de email válido. Verdade
Token de API secureString Seu token de API (https://id.atlassian.com/manage/api-tokens). Verdade

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 100 60 segundos
Frequência das pesquisas de gatilho 1 60 segundos

Ações

Adicionar comentário

Essa operação é usada para adicionar um comentário a um problema Jira existente.

Adicionar comentário (V2)

Essa operação é usada para adicionar um comentário a um problema Jira existente.

Atualizar Projeto

Atualiza os detalhes do projeto de um projeto.

Atualizar Projeto (V2)

Atualiza os detalhes do projeto de um projeto.

Cancelar tarefa

Cancela uma tarefa. Permissões necessárias: uma das seguintes: Administrar Jira ou Criador da tarefa.

Criar categoria de projeto

Cria uma categoria de projeto. Permissões necessárias: Administrar Jira (permissões globais)

Criar categoria de projeto (V2)

Cria uma categoria de projeto. Permissões necessárias: Administrar Jira (permissões globais)

Criar um novo problema (V2) [PRETERIDO]

Esta ação foi preterida. Em vez disso, use Criar um novo problema (V3 ).

Essa operação é usada para criar um novo problema.

Criar um novo problema (V3)

Essa operação é usada para criar um novo problema.

Criar um novo problema [PRETERIDO]

Esta ação foi preterida. Em vez disso, use Criar um novo problema (V3 ).

Essa operação é usada para criar um novo problema.

Criar um novo projeto

Essa operação é usada para criar um novo projeto Jira.

Criar um novo projeto (V2)

Essa operação é usada para criar um novo projeto Jira.

Editar problema

Edita um problema. Uma transição pode ser aplicada e emitir propriedades atualizadas como parte da edição. As edições para os campos do problema são definidas usando a atualização e os campos.

Exclui o Projeto

Exclui um projeto. Permissões necessárias: Administrar Jira (permissões globais)

Excluir Projeto (V2)

Exclui um projeto. Permissões necessárias: Administrar Jira (permissões globais)

Executa uma transição de problema

Faz a transição de um problema para um novo status.

Listar usuários por projeto

Essa operação é usada para recuperar uma lista de todos os usuários associados a um projeto.

Listar usuários por projeto (V2)

Essa operação é usada para recuperar uma lista de todos os usuários associados a um projeto.

Obter lista de filtros

Esta operação retorna uma lista de Filtros acessíveis ao usuário.

Obter lista de filtros (V2)

Esta operação retorna uma lista de Filtros acessíveis ao usuário.

Obter lista de problemas

Essa operação retorna uma lista de problemas usando JQL.

Obter lista de problemas (Datacenter)

Essa operação retorna uma lista de problemas usando JQL.

Obter lista de recursos

Esta operação retorna uma lista de recursos acessíveis ao usuário.

Obter lista de Transições

Retorna uma lista das transições possíveis para esse problema pelo usuário atual

Obter o usuário atual

Esta operação retorna detalhes para o usuário atual

Obter problema por chave

Esta operação é usada para recuperar o objeto de problema para uma chave de problema específica.

Obter problema por chave (V2)

Esta operação é usada para recuperar o objeto de problema para uma chave de problema específica.

Obter projetos

Essa operação é usada para recuperar uma lista de projetos para sua instância do Jira.

Obter projetos (V2)

Essa operação é usada para recuperar uma lista de projetos para sua instância do Jira.

Obter projetos [PRETERIDO]

Esta ação foi preterida. Em vez disso, use Obter projetos .

Essa operação é usada para recuperar uma lista de projetos para sua instância do Jira.

Obter Tarefa

Retorna o status de uma tarefa assíncrona de execução prolongada. Quando uma tarefa for concluída, essa operação retornará o blob JSON aplicável à tarefa.

Obter todas as categorias de projeto

Retorna todas as categorias de projeto.

Obter todas as categorias de projeto (V2)

Retorna todas as categorias de projeto.

Obter usuário

Retorna um usuário. Permissões necessárias: procurar usuários e grupos.

Obter usuário (V2)

Retorna um usuário. Permissões necessárias: procurar usuários e grupos.

Problema de edição (V2)

Edita um problema. Uma transição pode ser aplicada e emitir propriedades atualizadas como parte da edição. As edições para os campos do problema são definidas usando a atualização e os campos.

Remover categoria do projeto

Exclui uma categoria de projeto. Permissões necessárias: Administrar Jira (permissões globais)

Remover categoria do projeto (V2)

Exclui uma categoria de projeto. Permissões necessárias: Administrar Jira (permissões globais)

Servidor Jira MCP

Servidor Jira MCP

Tarefa Cancelar (V2)

Cancela uma tarefa. Permissões necessárias: uma das seguintes: Administrar Jira ou Criador da tarefa.

Tarefa Get (V2)

Retorna o status de uma tarefa assíncrona de execução prolongada. Quando uma tarefa for concluída, essa operação retornará o blob JSON aplicável à tarefa.

Adicionar comentário

Essa operação é usada para adicionar um comentário a um problema Jira existente.

Parâmetros

Nome Chave Obrigatório Tipo Description
Chave de problema
issueKey True string

Chave Exclusiva do problema ao qual adicionar um comentário.

Comment
body True string

Corpo do comentário.

Retornos

Adicionar comentário (V2)

Essa operação é usada para adicionar um comentário a um problema Jira existente.

Parâmetros

Nome Chave Obrigatório Tipo Description
Instância do Jira
X-Request-Jirainstance True string

A URL em que a instância do Jira está hospedada (deve dar suporte a https).

Chave de problema
issueKey True string

Chave Exclusiva do problema ao qual adicionar um comentário.

Comment
body True string

Corpo do comentário.

Retornos

Atualizar Projeto

Atualiza os detalhes do projeto de um projeto.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do projeto ou chave
projectIdOrKey True string

Forneça a ID do projeto ou a chave que você deseja atualizar1

chave
key string

Key

nome
name string

Nome

projectTypeKey
projectTypeKey string

Chave de tipo de projeto

projectTemplateKey
projectTemplateKey string

Chave do modelo de projeto

descrição
description string

Description

cliente potencial
lead string

Cliente Potencial

leadAccountId
leadAccountId string

ID da conta de cliente potencial

url
url string

URL

assigneeType
assigneeType string

Tipo de Atribuídor

avatarId
avatarId string

Avatar ID

issueSecurityScheme
issueSecurityScheme string

Problema de esquema de segurança

permissionScheme
permissionScheme string

Esquema de permissão

notificationScheme
notificationScheme string

Esquema de notificação

categoryId
categoryId string

ID da categoria

Atualizar Projeto (V2)

Atualiza os detalhes do projeto de um projeto.

Parâmetros

Nome Chave Obrigatório Tipo Description
Instância do Jira
X-Request-Jirainstance True string

A URL em que a instância do Jira está hospedada (deve dar suporte a https).

ID do projeto ou chave
projectIdOrKey True string

Forneça a ID do projeto ou a chave que você deseja atualizar1

chave
key string

Key

nome
name string

Nome

projectTypeKey
projectTypeKey string

Chave de tipo de projeto

projectTemplateKey
projectTemplateKey string

Chave do modelo de projeto

descrição
description string

Description

cliente potencial
lead string

Cliente Potencial

leadAccountId
leadAccountId string

ID da conta de cliente potencial

url
url string

URL

assigneeType
assigneeType string

Tipo de Atribuídor

avatarId
avatarId string

Avatar ID

issueSecurityScheme
issueSecurityScheme string

Problema de esquema de segurança

permissionScheme
permissionScheme string

Esquema de permissão

notificationScheme
notificationScheme string

Esquema de notificação

categoryId
categoryId string

ID da categoria

Cancelar tarefa

Cancela uma tarefa. Permissões necessárias: uma das seguintes: Administrar Jira ou Criador da tarefa.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da tarefa
taskId True string

A ID da tarefa.

Criar categoria de projeto

Cria uma categoria de projeto. Permissões necessárias: Administrar Jira (permissões globais)

Parâmetros

Nome Chave Obrigatório Tipo Description
nome
name string

Nome

descrição
description string

Description

Criar categoria de projeto (V2)

Cria uma categoria de projeto. Permissões necessárias: Administrar Jira (permissões globais)

Parâmetros

Nome Chave Obrigatório Tipo Description
Instância do Jira
X-Request-Jirainstance True string

A URL em que a instância do Jira está hospedada (deve dar suporte a https).

nome
name string

Nome

descrição
description string

Description

Criar um novo problema (V2) [PRETERIDO]

Esta ação foi preterida. Em vez disso, use Criar um novo problema (V3 ).

Essa operação é usada para criar um novo problema.

Parâmetros

Nome Chave Obrigatório Tipo Description
Projeto
projectKey True string

Escolha um projeto no qual criar o problema.

ID do tipo de problema
issueTypeIds True string

Escolha um tipo de problema.

item
item dynamic

Item

Retornos

Criar um novo problema (V3)

Essa operação é usada para criar um novo problema.

Parâmetros

Nome Chave Obrigatório Tipo Description
Instância do Jira
X-Request-Jirainstance True string

A URL em que a instância do Jira está hospedada (deve dar suporte a https).

Projeto
projectKey True string

Escolha um projeto no qual criar o problema.

ID do tipo de problema
issueTypeIds True string

Escolha um tipo de problema.

item
item dynamic

Item

Retornos

Criar um novo problema [PRETERIDO]

Esta ação foi preterida. Em vez disso, use Criar um novo problema (V3 ).

Essa operação é usada para criar um novo problema.

Parâmetros

Nome Chave Obrigatório Tipo Description
Projeto
projectKey True string

Escolha um projeto no qual criar o problema.

ID do tipo de problema
id True string

Escolha um tipo de problema.

Resumo
summary True string

Breve descrição do problema.

Components
components string

Um campo do sistema que é vários valores endereçados por 'name' (por exemplo, ID do Microsoft Entra, Comutador de Rede).

ID do repórter
id string

Pessoa relatando o problema.

Description
description string

Uma descrição detalhada do problema.

ID de prioridade
id string

Escolha uma prioridade para o problema.

Rótulos
labels string

Inserir uma lista separada por vírgulas de rótulos

ID do atribuídor
id string

Agente ao qual o problema é atribuído.

ID do problema pai
id string

Defina o pai para uma subtarefa.

Nome Épico (customfield_10011)
customfield_10119 string

O nome épico é necessário para o tipo de problema épico. Esse campo corresponde ao campo 'customfield_10011' no servidor Jira.

Retornos

Criar um novo projeto

Essa operação é usada para criar um novo projeto Jira.

Parâmetros

Nome Chave Obrigatório Tipo Description
Chave do Projeto
key True string

A chave exclusiva começa com uma letra maiúscula.

Nome
name True string

Título do projeto.

Tipo
projectTypeKey True string

Chave de tipo de projeto.

ID do cliente potencial
leadAccountId True string

ID do líder do Project.

Description
description string

Descrição detalhada do projeto.

Retornos

Criar um novo projeto (V2)

Essa operação é usada para criar um novo projeto Jira.

Parâmetros

Nome Chave Obrigatório Tipo Description
Instância do Jira
X-Request-Jirainstance True string

A URL em que a instância do Jira está hospedada (deve dar suporte a https).

Chave do Projeto
key True string

A chave exclusiva começa com uma letra maiúscula.

Nome
name True string

Título do projeto.

Tipo
projectTypeKey True string

Chave de tipo de projeto.

ID do cliente potencial
leadAccountId True string

ID do líder do Project.

Description
description string

Descrição detalhada do projeto.

Retornos

Editar problema

Edita um problema. Uma transição pode ser aplicada e emitir propriedades atualizadas como parte da edição. As edições para os campos do problema são definidas usando a atualização e os campos.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID ou chave do problema
issueIdOrKey True string

Forneça a ID do problema ou a chave para o problema que você deseja editar

Notificar usuários
notifyUsers boolean

Deseja notificar os usuários?

Substituir segurança de tela
overrideScreenSecurity boolean

Deseja substituir a segurança de tela?

Substituir Sinalizador Editável
overrideEditableFlag boolean

Deseja substituir o sinalizador editável?

ID de transição
id string

ID de transição

Transição em loop
looped string

Transição em loop

Fields
fields object

Lista de campos de tela de problema a serem atualizados, especificando o sub-campo a ser atualizado e seu valor para cada campo. Esse campo fornece uma opção simples ao definir um sub-campo. Quando vários sub-campos ou outras operações forem necessários, use a atualização. Os campos incluídos aqui não podem ser incluídos na atualização.

Update
update object

Um mapa que contém o nome do campo de campo e uma lista de operações a serem executadas no campo de tela de problema. Observe que os campos incluídos aqui não podem ser incluídos em campos.

Tipo de metadados
type string

Tipo de metadados de histórico

Descrição de metadados
description string

Descrição de metadados de histórico

Chave de descrição de metadados
descriptionKey string

Chave de descrição de metadados de histórico

Descrição da atividade de metadados
activityDescription string

Descrição da atividade de metadados de histórico

Chave de descrição da atividade de metadados
activityDescriptionKey string

Chave de descrição da atividade de metadados de histórico

Descrição do email de metadados
emailDescription string

Descrição do email de metadados de histórico

Chave de descrição de email de metadados
emailDescriptionKey string

Chave de descrição de email de metadados de histórico

ID do ator
id string

ID do ator

Nome de exibição do ator
displayName string

Nome de exibição do ator

Chave de nome de exibição do ator
displayNameKey string

Chave de nome de exibição do ator

Tipo de ator
type string

Tipo de ator

URL do avatar do ator
avatarUrl string

URL do avatar do ator

URL do ator
url string

URL do ator

ID do gerador
id string

ID do gerador

Nome de exibição do gerador
displayName string

Nome de exibição do gerador

Chave de nome de exibição do gerador
displayNameKey string

Chave de nome de exibição do gerador

Tipo de gerador
type string

Tipo de gerador

URL do avatar do gerador
avatarUrl string

URL do avatar do gerador

URL do gerador
url string

URL do gerador

ID da causa
id string

ID da causa

Causar nome de exibição
displayName string

Causar nome de exibição

Causar chave de nome de exibição
displayNameKey string

Causar chave de nome de exibição

Tipo de causa
type string

Tipo de causa

Causar url do avatar
avatarUrl string

Causar url do avatar

Url de causa
url string

Url de causa

Dados extras
extraData string

Dados extras

chave
key string

Key

Exclui o Projeto

Exclui um projeto. Permissões necessárias: Administrar Jira (permissões globais)

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do projeto ou chave
projectIdOrKey True string

A ID do projeto ou a chave do projeto (diferencia maiúsculas de minúsculas).

Habilitar Desfazer
enableUndo boolean

Se esse projeto é colocado na lixeira do Jira, onde ele estará disponível para restauração.

Excluir Projeto (V2)

Exclui um projeto. Permissões necessárias: Administrar Jira (permissões globais)

Parâmetros

Nome Chave Obrigatório Tipo Description
Instância do Jira
X-Request-Jirainstance True string

A URL em que a instância do Jira está hospedada (deve dar suporte a https).

ID do projeto ou chave
projectIdOrKey True string

A ID do projeto ou a chave do projeto (diferencia maiúsculas de minúsculas).

Habilitar Desfazer
enableUndo boolean

Se esse projeto é colocado na lixeira do Jira, onde ele estará disponível para restauração.

Executa uma transição de problema

Faz a transição de um problema para um novo status.

Parâmetros

Nome Chave Obrigatório Tipo Description
Instância do Jira
X-Request-Jirainstance True string

A URL em que a instância do Jira está hospedada (deve dar suporte a https).

ID ou chave do problema
issueIdOrKey True string

ID ou chave do problema a ser transitório

nome
name string
nome
name string
activityDescription
activityDescription string
avatarUrl
avatarUrl string
nome de exibição
displayName string
id
id string
tipo
type string
url
url string
id
id string
tipo
type string
descrição
description string
Iteração
Iteration string
Passo
Step string
id
id string
tipo
type string
tipo
type string
id
id string
body
body string

Listar usuários por projeto

Essa operação é usada para recuperar uma lista de todos os usuários associados a um projeto.

Parâmetros

Nome Chave Obrigatório Tipo Description
Chave do projeto
projectKey True string

Chave exclusiva do projeto.

Retornos

Itens
UserList

Listar usuários por projeto (V2)

Essa operação é usada para recuperar uma lista de todos os usuários associados a um projeto.

Parâmetros

Nome Chave Obrigatório Tipo Description
Instância do Jira
X-Request-Jirainstance True string

A URL em que a instância do Jira está hospedada (deve dar suporte a https).

Chave do projeto
projectKey True string

Chave exclusiva do projeto.

Retornos

Itens
UserList

Obter lista de filtros

Esta operação retorna uma lista de Filtros acessíveis ao usuário.

Retornos

Obter lista de filtros (V2)

Esta operação retorna uma lista de Filtros acessíveis ao usuário.

Parâmetros

Nome Chave Obrigatório Tipo Description
Instância do Jira
X-Request-Jirainstance True string

A URL em que a instância do Jira está hospedada (deve dar suporte a https).

Retornos

Obter lista de problemas

Essa operação retorna uma lista de problemas usando JQL.

Parâmetros

Nome Chave Obrigatório Tipo Description
Instância do Jira
X-Request-Jirainstance True string

A URL em que a instância do Jira está hospedada (deve dar suporte a https).

Retornos

Obter lista de problemas (Datacenter)

Essa operação retorna uma lista de problemas usando JQL.

Parâmetros

Nome Chave Obrigatório Tipo Description
Instância do Jira
X-Request-Jirainstance True string

A URL em que a instância do Jira está hospedada (deve dar suporte a https).

Retornos

Obter lista de recursos

Esta operação retorna uma lista de recursos acessíveis ao usuário.

Retornos

Itens
Sites

Obter lista de Transições

Retorna uma lista das transições possíveis para esse problema pelo usuário atual

Parâmetros

Nome Chave Obrigatório Tipo Description
Instância do Jira
X-Request-Jirainstance True string

A URL em que a instância do Jira está hospedada (deve dar suporte a https).

ID ou chave do problema
issueIdOrKey True string

ID ou chave do problema para recuperar transições para

Retornos

Nome Caminho Tipo Description
Transições
transitions array of Transition

Obter o usuário atual

Esta operação retorna detalhes para o usuário atual

Parâmetros

Nome Chave Obrigatório Tipo Description
Instância do Jira
X-Request-Jirainstance True string

A URL em que a instância do Jira está hospedada (deve dar suporte a https).

Expanda
expand string

Use expanda para incluir informações adicionais sobre os usuários na resposta. Esse parâmetro aceita uma lista separada por vírgulas. As opções de expansão incluem: * groups inclui todos os grupos e grupos aninhados aos quais o usuário pertence. * applicationRoles inclui detalhes de todos os aplicativos aos quais o usuário tem acesso.

Obter problema por chave

Esta operação é usada para recuperar o objeto de problema para uma chave de problema específica.

Parâmetros

Nome Chave Obrigatório Tipo Description
Chave de problema
issueKey True string

Chave Exclusiva do problema.

Retornos

Questão
FullIssue

Obter problema por chave (V2)

Esta operação é usada para recuperar o objeto de problema para uma chave de problema específica.

Parâmetros

Nome Chave Obrigatório Tipo Description
Instância do Jira
X-Request-Jirainstance True string

A URL em que a instância do Jira está hospedada (deve dar suporte a https).

Chave de problema
issueKey True string

Chave Exclusiva do problema.

Retornos

Questão
FullIssue

Obter projetos

Essa operação é usada para recuperar uma lista de projetos para sua instância do Jira.

Retornos

Obter projetos (V2)

Essa operação é usada para recuperar uma lista de projetos para sua instância do Jira.

Parâmetros

Nome Chave Obrigatório Tipo Description
Instância do Jira
X-Request-Jirainstance True string

A URL em que a instância do Jira está hospedada (deve dar suporte a https).

Retornos

Obter projetos [PRETERIDO]

Esta ação foi preterida. Em vez disso, use Obter projetos .

Essa operação é usada para recuperar uma lista de projetos para sua instância do Jira.

Retornos

Itens
ProjectArray

Obter Tarefa

Retorna o status de uma tarefa assíncrona de execução prolongada. Quando uma tarefa for concluída, essa operação retornará o blob JSON aplicável à tarefa.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da tarefa
taskId True string

A ID da tarefa.

Obter todas as categorias de projeto

Retorna todas as categorias de projeto.

Retornos

Nome Caminho Tipo Description
array of object
eu
self string

Self

id
id string

ID

descrição
description string

Description

nome
name string

Nome

Obter todas as categorias de projeto (V2)

Retorna todas as categorias de projeto.

Parâmetros

Nome Chave Obrigatório Tipo Description
Instância do Jira
X-Request-Jirainstance True string

A URL em que a instância do Jira está hospedada (deve dar suporte a https).

Retornos

Nome Caminho Tipo Description
array of object
eu
self string

Self

id
id string

ID

descrição
description string

Description

nome
name string

Nome

Obter usuário

Retorna um usuário. Permissões necessárias: procurar usuários e grupos.

Parâmetros

Nome Chave Obrigatório Tipo Description
AccountID
accountId True string

A ID da conta do usuário, que identifica exclusivamente o usuário em todos os produtos Atlassian. Por exemplo, 5b10ac8d82e05b22cc7d4ef5. Obrigatório

Expanda
expand string

Use expanda para incluir informações adicionais sobre os usuários na resposta. Esse parâmetro aceita uma lista separada por vírgulas. As opções de expansão incluem: * groups inclui todos os grupos e grupos aninhados aos quais o usuário pertence. * applicationRoles inclui detalhes de todos os aplicativos aos quais o usuário tem acesso.

Obter usuário (V2)

Retorna um usuário. Permissões necessárias: procurar usuários e grupos.

Parâmetros

Nome Chave Obrigatório Tipo Description
Instância do Jira
X-Request-Jirainstance True string

A URL em que a instância do Jira está hospedada (deve dar suporte a https).

AccountID
accountId True string

A ID da conta do usuário, que identifica exclusivamente o usuário em todos os produtos Atlassian. Por exemplo, 5b10ac8d82e05b22cc7d4ef5. Obrigatório

Expanda
expand string

Use expanda para incluir informações adicionais sobre os usuários na resposta. Esse parâmetro aceita uma lista separada por vírgulas. As opções de expansão incluem: * groups inclui todos os grupos e grupos aninhados aos quais o usuário pertence. * applicationRoles inclui detalhes de todos os aplicativos aos quais o usuário tem acesso.

Problema de edição (V2)

Edita um problema. Uma transição pode ser aplicada e emitir propriedades atualizadas como parte da edição. As edições para os campos do problema são definidas usando a atualização e os campos.

Parâmetros

Nome Chave Obrigatório Tipo Description
Instância do Jira
X-Request-Jirainstance True string

A URL em que a instância do Jira está hospedada (deve dar suporte a https).

ID ou chave do problema
issueIdOrKey True string

Forneça a ID do problema ou a chave para o problema que você deseja editar

Notificar usuários
notifyUsers boolean

Deseja notificar os usuários?

Substituir segurança de tela
overrideScreenSecurity boolean

Deseja substituir a segurança de tela?

Substituir Sinalizador Editável
overrideEditableFlag boolean

Deseja substituir o sinalizador editável?

ID de transição
id string

ID de transição

Transição em loop
looped string

Transição em loop

Fields
fields object

Lista de campos de tela de problema a serem atualizados, especificando o sub-campo a ser atualizado e seu valor para cada campo. Esse campo fornece uma opção simples ao definir um sub-campo. Quando vários sub-campos ou outras operações forem necessários, use a atualização. Os campos incluídos aqui não podem ser incluídos na atualização.

Update
update object

Um mapa que contém o nome do campo de campo e uma lista de operações a serem executadas no campo de tela de problema. Observe que os campos incluídos aqui não podem ser incluídos em campos.

Tipo de metadados
type string

Tipo de metadados de histórico

Descrição de metadados
description string

Descrição de metadados de histórico

Chave de descrição de metadados
descriptionKey string

Chave de descrição de metadados de histórico

Descrição da atividade de metadados
activityDescription string

Descrição da atividade de metadados de histórico

Chave de descrição da atividade de metadados
activityDescriptionKey string

Chave de descrição da atividade de metadados de histórico

Descrição do email de metadados
emailDescription string

Descrição do email de metadados de histórico

Chave de descrição de email de metadados
emailDescriptionKey string

Chave de descrição de email de metadados de histórico

ID do ator
id string

ID do ator

Nome de exibição do ator
displayName string

Nome de exibição do ator

Chave de nome de exibição do ator
displayNameKey string

Chave de nome de exibição do ator

Tipo de ator
type string

Tipo de ator

URL do avatar do ator
avatarUrl string

URL do avatar do ator

URL do ator
url string

URL do ator

ID do gerador
id string

ID do gerador

Nome de exibição do gerador
displayName string

Nome de exibição do gerador

Chave de nome de exibição do gerador
displayNameKey string

Chave de nome de exibição do gerador

Tipo de gerador
type string

Tipo de gerador

URL do avatar do gerador
avatarUrl string

URL do avatar do gerador

URL do gerador
url string

URL do gerador

ID da causa
id string

ID da causa

Causar nome de exibição
displayName string

Causar nome de exibição

Causar chave de nome de exibição
displayNameKey string

Causar chave de nome de exibição

Tipo de causa
type string

Tipo de causa

Causar url do avatar
avatarUrl string

Causar url do avatar

Url de causa
url string

Url de causa

Dados extras
extraData string

Dados extras

chave
key string

Key

Remover categoria do projeto

Exclui uma categoria de projeto. Permissões necessárias: Administrar Jira (permissões globais)

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do projeto
id True integer

ID da categoria do projeto a ser excluída.

Remover categoria do projeto (V2)

Exclui uma categoria de projeto. Permissões necessárias: Administrar Jira (permissões globais)

Parâmetros

Nome Chave Obrigatório Tipo Description
Instância do Jira
X-Request-Jirainstance True string

A URL em que a instância do Jira está hospedada (deve dar suporte a https).

ID do projeto
id True integer

ID da categoria do projeto a ser excluída.

Servidor Jira MCP

Servidor Jira MCP

Parâmetros

Nome Chave Obrigatório Tipo Description
jsonrpc
jsonrpc string
id
id string
método
method string
parâmetros
params object
resultado
result object
erro
error object
sessionId
sessionId string

Retornos

Tarefa Cancelar (V2)

Cancela uma tarefa. Permissões necessárias: uma das seguintes: Administrar Jira ou Criador da tarefa.

Parâmetros

Nome Chave Obrigatório Tipo Description
Instância do Jira
X-Request-Jirainstance True string

A URL em que a instância do Jira está hospedada (deve dar suporte a https).

ID da tarefa
taskId True string

A ID da tarefa.

Tarefa Get (V2)

Retorna o status de uma tarefa assíncrona de execução prolongada. Quando uma tarefa for concluída, essa operação retornará o blob JSON aplicável à tarefa.

Parâmetros

Nome Chave Obrigatório Tipo Description
Instância do Jira
X-Request-Jirainstance True string

A URL em que a instância do Jira está hospedada (deve dar suporte a https).

ID da tarefa
taskId True string

A ID da tarefa.

Gatilhos

Quando um novo problema é criado

Essa operação é disparada quando um novo problema é adicionado ao projeto especificado.

Quando um novo problema é criado (Datacenter)

Essa operação é disparada quando um novo problema é adicionado ao projeto especificado.

Quando um novo problema é criado (V2)

Essa operação é disparada quando um novo problema é adicionado ao projeto especificado.

Quando um novo problema é retornado por uma consulta JQL

Essa operação é disparada quando um novo problema aparece nos últimos 100 resultados de uma consulta JQL.

Quando um novo problema é retornado por uma consulta JQL (Datacenter)

Essa operação é disparada quando um novo problema aparece nos últimos 100 resultados de uma consulta JQL.

Quando um novo problema é retornado por uma consulta JQL (V2)

Essa operação é disparada quando um novo problema aparece nos últimos 100 resultados de uma consulta JQL.

Quando um problema é fechado

Essa operação é disparada quando um problema existente é fechado no projeto especificado.

Quando um problema é fechado (Datacenter)

Essa operação é disparada quando um problema existente é fechado no projeto especificado.

Quando um problema é fechado (V2)

Essa operação é disparada quando um problema existente é fechado no projeto especificado.

Quando um novo problema é criado

Essa operação é disparada quando um novo problema é adicionado ao projeto especificado.

Parâmetros

Nome Chave Obrigatório Tipo Description
Projeto
projectKey True string

Chave exclusiva do projeto para procurar novos problemas.

Retornos

Questão
FullIssue

Quando um novo problema é criado (Datacenter)

Essa operação é disparada quando um novo problema é adicionado ao projeto especificado.

Parâmetros

Nome Chave Obrigatório Tipo Description
Instância do Jira
X-Request-Jirainstance string

A URL em que a instância do Jira está hospedada (deve dar suporte a https).

Projeto
projectKey True string

Chave exclusiva do projeto para procurar novos problemas.

Retornos

Questão
FullIssue

Quando um novo problema é criado (V2)

Essa operação é disparada quando um novo problema é adicionado ao projeto especificado.

Parâmetros

Nome Chave Obrigatório Tipo Description
Instância do Jira
X-Request-Jirainstance string

A URL em que a instância do Jira está hospedada (deve dar suporte a https).

Projeto
projectKey True string

Chave exclusiva do projeto para procurar novos problemas.

Retornos

Questão
FullIssue

Quando um novo problema é retornado por uma consulta JQL

Essa operação é disparada quando um novo problema aparece nos últimos 100 resultados de uma consulta JQL.

Parâmetros

Nome Chave Obrigatório Tipo Description
Consulta JQL
jql True string

Consulta a ser usada.

Retornos

Questão
FullIssue

Quando um novo problema é retornado por uma consulta JQL (Datacenter)

Essa operação é disparada quando um novo problema aparece nos últimos 100 resultados de uma consulta JQL.

Parâmetros

Nome Chave Obrigatório Tipo Description
Instância do Jira
X-Request-Jirainstance string

A URL em que a instância do Jira está hospedada (deve dar suporte a https).

Consulta JQL
jql True string

Consulta a ser usada.

Retornos

Questão
FullIssue

Quando um novo problema é retornado por uma consulta JQL (V2)

Essa operação é disparada quando um novo problema aparece nos últimos 100 resultados de uma consulta JQL.

Parâmetros

Nome Chave Obrigatório Tipo Description
Instância do Jira
X-Request-Jirainstance string

A URL em que a instância do Jira está hospedada (deve dar suporte a https).

Consulta JQL
jql True string

Consulta a ser usada.

Retornos

Questão
FullIssue

Quando um problema é fechado

Essa operação é disparada quando um problema existente é fechado no projeto especificado.

Parâmetros

Nome Chave Obrigatório Tipo Description
Projeto
projectKey True string

Chave exclusiva do projeto para procurar novos problemas.

Retornos

Questão
FullIssue

Quando um problema é fechado (Datacenter)

Essa operação é disparada quando um problema existente é fechado no projeto especificado.

Parâmetros

Nome Chave Obrigatório Tipo Description
Instância do Jira
X-Request-Jirainstance string

A URL em que a instância do Jira está hospedada (deve dar suporte a https).

Projeto
projectKey True string

Chave exclusiva do projeto para procurar novos problemas.

Retornos

Questão
FullIssue

Quando um problema é fechado (V2)

Essa operação é disparada quando um problema existente é fechado no projeto especificado.

Parâmetros

Nome Chave Obrigatório Tipo Description
Instância do Jira
X-Request-Jirainstance string

A URL em que a instância do Jira está hospedada (deve dar suporte a https).

Projeto
projectKey True string

Chave exclusiva do projeto para procurar novos problemas.

Retornos

Questão
FullIssue

Definições

CreateProjectResponse

Nome Caminho Tipo Description
ID do projeto
id integer

ID exclusiva do projeto.

Chave do Projeto
key string

Chave exclusiva do projeto.

CreateIssueResponse

Nome Caminho Tipo Description
ID do problema
id string

Identificador exclusivo do problema.

Chave de problema
key string

Chave exclusiva do problema.

ListProjects_ResponseV2

Nome Caminho Tipo Description
values
values ProjectArray

ProjectArray

Nome Caminho Tipo Description
ID do projeto
id string

A ID exclusiva do projeto.

Chave do Projeto
key string

A chave exclusiva do projeto.

Nome do Projeto
name string

Nome do projeto.

Chave de tipo de projeto
projectTypeKey string

A chave exclusiva do tipo de projeto.

FullIssue

Nome Caminho Tipo Description
ID do problema
id string

ID exclusiva do problema.

Chave de problema
key string

Chave exclusiva do problema.

URL do problema
self string

Navegue até o problema usando essa URL.

ID do tipo de problema
fields.issuetype.id string

ID exclusiva do tipo de problema.

Descrição do tipo de problema
fields.issuetype.description string

Título detalhado do tipo de problema.

URL do ícone de tipo de problema
fields.issuetype.iconUrl string

Ícone associado ao tipo de problema.

Nome do tipo de problema
fields.issuetype.name string

Título do tipo de problema.

Tempo Gasto
fields.timespent integer

O tempo gasto em um problema

ID do projeto
fields.project.id string

A ID exclusiva do projeto.

Chave do Projeto
fields.project.key string

A chave exclusiva do projeto.

Nome do Projeto
fields.project.name string

Título do projeto.

Chave de tipo de projeto
fields.project.projectTypeKey string

Chave exclusiva do tipo de projeto.

Tempo agregado gasto
fields.aggregatetimespent integer

O tempo agregado gasto em subtarefas.

URL da resolução de problemas
fields.resolution.self string
ID da resolução de problemas
fields.resolution.id string
Descrição da resolução de problemas
fields.resolution.description string
Nome da resolução de problemas
fields.resolution.name string
Data de resolução
fields.resolutiondate date-time

yyyyy-MM-ddTHH:mm:ss.fffZ

Taxa de Trabalho
fields.workratio integer

O percentual de trabalho registrado em log versus a estimativa de problema.

Data de criação
fields.created date-time

yyyyy-MM-ddTHH:mm:ss.fffZ

URL do Ícone de Prioridade
fields.priority.iconUrl string

Ícone associado à prioridade de problema.

Nome da prioridade
fields.priority.name string

Título da prioridade.

ID de prioridade
fields.priority.id string

ID da prioridade do problema.

Estimativa de Tempo
fields.timeestimate integer

Tempo restante estimado em segundos.

Estimativa de tempo de agregação
fields.aggregatetimeoriginalestimate integer

A soma original de todas as estimativas de tempo de subtarefa em segundos.

ID do atribuídor
fields.assignee.accountId string

Pessoa à qual um problema é atribuído.

Chave do Atribuídor
fields.assignee.key string

A chave do usuário do problema da pessoa é atribuída.

Email do Atribuídor
fields.assignee.emailAddress string

O email do problema da pessoa é atribuído.

Nome de Exibição do Atribuídor
fields.assignee.displayName string

O nome de exibição do problema da pessoa é atribuído.

Atualização Date-Time
fields.updated date-time

yyyyy-MM-ddTHH:mm:ss.fffZ

Descrição do status
fields.status.description string

Status do problema.

URL do ícone de status
fields.status.iconUrl string

Status do problema.

Nome do Status
fields.status.name string

Status do problema.

Status Id
fields.status.id string

Status do problema.

ID da categoria de status
fields.status.statusCategory.id integer

Categoria de status do problema.

Chave de Categoria de Status
fields.status.statusCategory.key string

Categoria de status do problema.

Nome da cor da categoria de status
fields.status.statusCategory.colorName string

Categoria de status do problema.

Nome da categoria de status
fields.status.statusCategory.name string

Categoria de status do problema.

Estimativa de Tempo Original
fields.timeoriginalestimate integer

A estimativa de tempo original em segundos.

Description
fields.description string

Descrição do problema.

Estimativa de tempo de agregação
fields.aggregatetimeestimate integer

Soma de tempo de todas as subtarefas que permanecem tempo estimado em segundos.

Resumo
fields.summary string

Título do problema.

Components
fields.components array of object

Um campo do sistema que é vários valores endereçados por 'name' (por exemplo, ID do Microsoft Entra, Comutador de Rede).

ID do componente
fields.components.id string
Nome do componente
fields.components.name string
ID do criador
fields.creator.accountId string

Usuário que criou o problema.

Chave do Criador
fields.creator.key string

Chave exclusiva do usuário que criou o problema.

Email do Criador
fields.creator.emailAddress string

Email do usuário que criou o problema.

Nome de Exibição do Criador
fields.creator.displayName string

Nome do usuário que criou o problema.

ID do repórter
fields.reporter.accountId string

Usuário que relatou o problema.

Chave do Repórter
fields.reporter.key string

Chave exclusiva do usuário que relatou o problema.

Email do Repórter
fields.reporter.emailAddress string

Email do usuário que relatou o problema.

Nome de Exibição do Repórter
fields.reporter.displayName string

Nome de exibição do usuário que relatou o problema.

Progresso de agregação concluído
fields.aggregateprogress.progress integer

O progresso total concluído de todas as subtarefas em segundos.

Esforço estimado de agregação
fields.aggregateprogress.total integer

A soma total de todo o esforço de subtarefa estimado.

Porcentagem de progresso agregado
fields.aggregateprogress.percent integer

O percentual de progresso concluído agregado em relação ao esforço estimado.

Devido Date-Time
fields.duedate date-time

yyyyy-MM-ddTHH:mm:ss.fffZ

Progresso concluído
fields.progress.progress integer

O progresso é concluído em segundos.

Esforço estimado
fields.progress.total integer

O esforço estimado.

Porcentagem de progresso
fields.progress.percent integer

O percentual de progresso concluído em relação ao esforço estimado.

Nome Épico (customfield_10011)
fields.customfield_10119

O nome épico é necessário para o tipo de problema épico. Esse campo corresponde ao campo 'customfield_10011' no servidor Jira.

UserList

Nome Caminho Tipo Description
ID
accountId string

ID do membro do projeto.

Key
key string

Chave exclusiva associada ao usuário.

Email
emailAddress string

Email endereço do utilizador.

Nome de Exibição
displayName string

Nome completo do usuário.

ListFiltersResponse

Nome Caminho Tipo Description
values
values FilterArray

FilterArray

Nome Caminho Tipo Description
ID
id string

ID do Filtro.

Nome
name string

Nome do filtro.

JQL
jql string

jql usado em Filter.

ListIssuesResponse

Nome Caminho Tipo Description
issues
issues array of FullIssue

ListIssuesResponseDatacenter

Nome Caminho Tipo Description
issues
issues array of FullIssue

CommentResponse

Nome Caminho Tipo Description
ID do comentário
id string

ID exclusiva do comentário.

Corpo do Comentário
body string

Corpo do comentário.

Criado Date-Time
created date-time

yyyyy-MM-ddTHH:mm:ss.fffZ

Sites

Nome Caminho Tipo Description
ID da nuvem
id string

ID da instância do Jira

Nome do Site
name string
URL do site
url string

Transition

Nome Caminho Tipo Description
id
id string

ID da transição

nome
name string

Nome da transição

para
to TransitionStatus
fields
fields object

Campos necessários para essa transição

TransitionStatus

Nome Caminho Tipo Description
id
id string

ID do status

nome
name string

Nome do status

MCPQueryResponse

Nome Caminho Tipo Description
jsonrpc
jsonrpc string
id
id string
método
method string
parâmetros
params object
resultado
result object
erro
error object