Partilhar via


Jira

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

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

Serviço Class Regiões
Estúdio Copiloto Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - China Cloud operado pela 21Vianet
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Premium Todas as regiões do Power Apps , exceto as seguintes:
     - China Cloud operado pela 21Vianet
Automatize o poder Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - China Cloud operado pela 21Vianet
Contato
Nome Microsoft
URL https://support.microsoft.com/
Email abapi@microsoft.com
Metadados do conector
Editora Microsoft
Sítio 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 do Jira.

Importante

Devido a alterações recentes nas APIs de back-end do Jira, as seguintes atualizações afetam o conector do 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 devolvidos: O ponto de extremidade retorna um máximo de 20 comentários e 40 itens do changelog.
  • Consultas JQL em gatilhos: Não há suporte para consultas JQL não limitadas. Solicitações com consultas ilimitadas resultarão em uma resposta de 400 solicitações incorretas.

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

Problemas conhecidos e limitações

  • 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.
  • O Jira Server atrás de um firewall ou com a API REST desabilitada não é suportado.
  • Ao criar uma conexão com o Jira Cloud, você precisa usar um endereço de e-mail válido para o nome de usuário. Caso contrário, a conexão não será estabelecida, embora pareça ter sido bem-sucedida.
  • Os nomes de usuário no Jira Cloud foram 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 do Jira, a API do 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 projetos Get. Vai devolver todos os projetos.
  • A ação Criar um novo problema (V2) suporta apenas tipos de campo simples, como 'string', 'number', 'date' e 'datetime' no esquema dinâmico. Se a configuração do projeto tiver campos obrigatórios de tipos de dados complexos, a operação falhará com o erro: "O campo '{key}' do tipo '{type}' não é suportado". Para contornar isso, altere a configuração dos campos do projeto e torne esses campos não necessários.
  • A ação Criar um novo problema (V3) suporta apenas tipos de campo simples, como 'string', 'number', 'date' e 'datetime' no esquema dinâmico. Se a configuração do projeto tiver campos obrigatórios de tipos de dados complexos, a operação falhará com o erro: "O campo '{key}' do tipo '{type}' não é suportado". Para contornar isso, altere a configuração dos campos do 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 projetos. 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 Edit Issue , consulte a documentação da API do Jira
  • Quando um fluxo de trabalho começar a falhar com uma resposta 400 ou uma solicitação incorreta para qualquer ação ou gatilho, verifique se a chave de API usada para criar a conexão expirou e, em caso afirmativo, recrie a conexão com uma nova chave de API.

A criar uma ligação

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

API Token Usar token de API para acessar o Jira Todas as regiões Não compartilhável
Oauth Use Oauth para acessar Jira. Todas as regiões Não compartilhável
Padrão [DEPRECATED] Esta opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores. Todas as regiões Não compartilhável

Chave de API

ID de autenticação: APIToken

Aplicável: Todas as regiões

Usar token de API para acessar o Jira

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

Nome Tipo Description Obrigatório
Nome de usuário ou e-mail cadeia (de caracteres) Seu nome de usuário do Jira. Para o Jira Cloud, você precisa usar um endereço de e-mail válido. Verdade
Token da 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 Oauth para acessar Jira.

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

Padrão [DEPRECATED]

Aplicável: Todas as regiões

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

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

Nome Tipo Description Obrigatório
Instância do Jira cadeia (de caracteres) A url onde sua instância do Jira está hospedada (deve suportar https). Verdade
Nome de usuário ou e-mail cadeia (de caracteres) Seu nome de usuário do Jira. Para o Jira Cloud, você precisa usar um endereço de e-mail válido. Verdade
Token da API securestring Seu token de API (https://id.atlassian.com/manage/api-tokens). Verdade

Limites de Limitação

Nome Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos
Frequência das sondagens de desencadeamento 1 60 segundos

Ações

Adicionar comentário

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

Adicionar comentário (V2)

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

Atualizar projeto

Atualiza os detalhes de um projeto.

Atualizar projeto (V2)

Atualiza os detalhes de um projeto.

Cancelar tarefa

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

Cancelar tarefa (V2)

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

Criar categoria de projeto

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

Criar categoria de projeto (V2)

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

Criar um novo problema (V2) [PRETERIDO]

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

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

Criar um novo problema (V3)

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

Criar um novo problema [DEPRECATED]

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

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

Criar um novo projeto

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

Criar um novo projeto (V2)

Esta 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 nos campos do problema são definidas usando update e fields.

Editar problema (V2)

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

Excluir projeto

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

Excluir projeto (V2)

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

Executa uma transição de problema

Transiciona um problema para um novo status.

Listar usuários por projeto

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

Listar usuários por projeto (V2)

Esta 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

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

Obter lista de problemas (Centro de dados)

Esta 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 problema por chave

Esta operação é usada para recuperar o objeto de problema para uma determinada chave de problema.

Obter problema por chave (V2)

Esta operação é usada para recuperar o objeto de problema para uma determinada chave de problema.

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 [DEPRECATED]

Esta ação foi preterida. Em vez disso, use Get projects .

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 longa execução. Quando uma tarefa é concluída, essa operação retorna o blob JSON aplicável à tarefa.

Obter tarefa (V2)

Retorna o status de uma tarefa assíncrona de longa execução. Quando uma tarefa é concluída, essa operação retorna 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: procure usuários e grupos.

Obter usuário (V2)

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

Obter usuário atual

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

Remover categoria de projeto

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

Remover categoria de projeto (V2)

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

Servidor Jira MCP

Servidor Jira MCP

Adicionar comentário

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

Parâmetros

Nome Chave Necessário Tipo Descrição
Chave do problema
issueKey True string

Chave exclusiva do problema para adicionar um comentário.

Comment
body True string

Corpo do comentário.

Regressos

Adicionar comentário (V2)

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

Parâmetros

Nome Chave Necessário Tipo Descrição
Instância do Jira
X-Request-Jirainstance True string

A url onde sua instância do Jira está hospedada (deve suportar https).

Chave do problema
issueKey True string

Chave exclusiva do problema para adicionar um comentário.

Comment
body True string

Corpo do comentário.

Regressos

Atualizar projeto

Atualiza os detalhes de um projeto.

Parâmetros

Nome Chave Necessário Tipo Descrição
ID ou chave do projeto
projectIdOrKey True string

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

chave
key string

Key

nome
name string

Nome

projectTypeKey
projectTypeKey string

Chave do tipo de projeto

projectTemplateKey
projectTemplateKey string

Chave do modelo de projeto

descrição
description string

Description

cliente potencial
lead string

Liderança

leadAccountId
leadAccountId string

ID da Conta Principal

URL
url string

URL

cessionárioTipo
assigneeType string

Tipo de cessionário

avatarId
avatarId string

Avatar ID

emitirSecurityScheme
issueSecurityScheme string

Emitir Esquema de Segurança

permissionScheme
permissionScheme string

Esquema de permissão

notificationScheme
notificationScheme string

Sistema de notificação

categoryId
categoryId string

ID da categoria

Atualizar projeto (V2)

Atualiza os detalhes de um projeto.

Parâmetros

Nome Chave Necessário Tipo Descrição
Instância do Jira
X-Request-Jirainstance True string

A url onde sua instância do Jira está hospedada (deve suportar https).

ID ou chave do projeto
projectIdOrKey True string

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

chave
key string

Key

nome
name string

Nome

projectTypeKey
projectTypeKey string

Chave do tipo de projeto

projectTemplateKey
projectTemplateKey string

Chave do modelo de projeto

descrição
description string

Description

cliente potencial
lead string

Liderança

leadAccountId
leadAccountId string

ID da Conta Principal

URL
url string

URL

cessionárioTipo
assigneeType string

Tipo de cessionário

avatarId
avatarId string

Avatar ID

emitirSecurityScheme
issueSecurityScheme string

Emitir Esquema de Segurança

permissionScheme
permissionScheme string

Esquema de permissão

notificationScheme
notificationScheme string

Sistema de notificação

categoryId
categoryId string

ID da categoria

Cancelar tarefa

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

Parâmetros

Nome Chave Necessário Tipo Descrição
ID da tarefa
taskId True string

A ID da tarefa.

Cancelar tarefa (V2)

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

Parâmetros

Nome Chave Necessário Tipo Descrição
Instância do Jira
X-Request-Jirainstance True string

A url onde sua instância do Jira está hospedada (deve suportar https).

ID da tarefa
taskId True string

A ID da tarefa.

Criar categoria de projeto

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

Parâmetros

Nome Chave Necessário Tipo Descrição
nome
name string

Nome

descrição
description string

Description

Criar categoria de projeto (V2)

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

Parâmetros

Nome Chave Necessário Tipo Descrição
Instância do Jira
X-Request-Jirainstance True string

A url onde sua instância do Jira está hospedada (deve suportar 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).

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

Parâmetros

Nome Chave Necessário Tipo Descrição
Projeto
projectKey True string

Escolha um projeto para criar o problema.

ID do tipo de problema
issueTypeIds True string

Escolha um tipo de problema.

item
item dynamic

Item

Regressos

Criar um novo problema (V3)

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

Parâmetros

Nome Chave Necessário Tipo Descrição
Instância do Jira
X-Request-Jirainstance True string

A url onde sua instância do Jira está hospedada (deve suportar https).

Projeto
projectKey True string

Escolha um projeto para criar o problema.

ID do tipo de problema
issueTypeIds True string

Escolha um tipo de problema.

item
item dynamic

Item

Regressos

Criar um novo problema [DEPRECATED]

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

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

Parâmetros

Nome Chave Necessário Tipo Descrição
Projeto
projectKey True string

Escolha um projeto para 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 'nome' (por exemplo, Microsoft Entra ID, Network Switch).

ID do repórter
id string

Pessoa que comunica o problema.

Description
description string

Uma descrição pormenorizada do problema.

ID de prioridade
id string

Escolha uma prioridade para o problema.

Rótulos / Etiquetas
labels string

Insira uma lista de rótulos separados por vírgulas

Identificação do cessionário
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. Este campo corresponde ao campo 'customfield_10011' no servidor Jira.

Regressos

Criar um novo projeto

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

Parâmetros

Nome Chave Necessário Tipo Descrição
Chave do Projeto
key True string

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

Nome
name True string

Título do projeto.

Tipo
projectTypeKey True string

Chave de tipo de projeto.

Identificação do lead
leadAccountId True string

Id do líder do projeto.

Description
description string

Descrição detalhada do projeto.

Regressos

Criar um novo projeto (V2)

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

Parâmetros

Nome Chave Necessário Tipo Descrição
Instância do Jira
X-Request-Jirainstance True string

A url onde sua instância do Jira está hospedada (deve suportar https).

Chave do Projeto
key True string

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

Nome
name True string

Título do projeto.

Tipo
projectTypeKey True string

Chave de tipo de projeto.

Identificação do lead
leadAccountId True string

Id do líder do projeto.

Description
description string

Descrição detalhada do projeto.

Regressos

Editar problema

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

Parâmetros

Nome Chave Necessário Tipo Descrição
ID ou chave do problema
issueIdOrKey True string

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

Notificar os usuários
notifyUsers boolean

Deseja notificar os usuários?

Substituir a segurança da tela
overrideScreenSecurity boolean

Deseja substituir a segurança da 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

Campos
fields object

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

Atualização
update object

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

Tipo de metadados
type string

Tipo de metadados do histórico

Descrição dos metadados
description string

Descrição dos metadados do histórico

Chave de descrição dos metadados
descriptionKey string

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

Descrição da atividade dos metadados
activityDescription string

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

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

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

Descrição do e-mail de metadados
emailDescription string

Descrição do e-mail de metadados do histórico

Chave de descrição de e-mail de metadados
emailDescriptionKey string

Chave de descrição de e-mail de metadados do 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

Nome de exibição da causa
displayName string

Nome de exibição da causa

Chave de nome de exibição da causa
displayNameKey string

Chave de nome de exibição da causa

Tipo de causa
type string

Tipo de causa

Causa url avatar
avatarUrl string

Causa url avatar

URL da causa
url string

URL da causa

Dados adicionais
extraData string

Dados adicionais

chave
key string

Key

Editar problema (V2)

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

Parâmetros

Nome Chave Necessário Tipo Descrição
Instância do Jira
X-Request-Jirainstance True string

A url onde sua instância do Jira está hospedada (deve suportar https).

ID ou chave do problema
issueIdOrKey True string

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

Notificar os usuários
notifyUsers boolean

Deseja notificar os usuários?

Substituir a segurança da tela
overrideScreenSecurity boolean

Deseja substituir a segurança da 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

Campos
fields object

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

Atualização
update object

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

Tipo de metadados
type string

Tipo de metadados do histórico

Descrição dos metadados
description string

Descrição dos metadados do histórico

Chave de descrição dos metadados
descriptionKey string

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

Descrição da atividade dos metadados
activityDescription string

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

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

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

Descrição do e-mail de metadados
emailDescription string

Descrição do e-mail de metadados do histórico

Chave de descrição de e-mail de metadados
emailDescriptionKey string

Chave de descrição de e-mail de metadados do 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

Nome de exibição da causa
displayName string

Nome de exibição da causa

Chave de nome de exibição da causa
displayNameKey string

Chave de nome de exibição da causa

Tipo de causa
type string

Tipo de causa

Causa url avatar
avatarUrl string

Causa url avatar

URL da causa
url string

URL da causa

Dados adicionais
extraData string

Dados adicionais

chave
key string

Key

Excluir projeto

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

Parâmetros

Nome Chave Necessário Tipo Descrição
ID ou chave do projeto
projectIdOrKey True string

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

Ativar Desfazer
enableUndo boolean

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

Excluir projeto (V2)

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

Parâmetros

Nome Chave Necessário Tipo Descrição
Instância do Jira
X-Request-Jirainstance True string

A url onde sua instância do Jira está hospedada (deve suportar https).

ID ou chave do projeto
projectIdOrKey True string

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

Ativar Desfazer
enableUndo boolean

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

Executa uma transição de problema

Transiciona um problema para um novo status.

Parâmetros

Nome Chave Necessário Tipo Descrição
Instância do Jira
X-Request-Jirainstance True string

A url onde sua instância do Jira está hospedada (deve suportar https).

ID ou chave do problema
issueIdOrKey True string

ID ou chave do problema a ser transferido

nome
name string
nome
name string
atividadeDescrição
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
Iteration
Iteration string
Step
Step string
id
id string
tipo
type string
tipo
type string
id
id string
body
body string

Listar usuários por projeto

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

Parâmetros

Nome Chave Necessário Tipo Descrição
Chave do projeto
projectKey True string

Chave única do projeto.

Regressos

Itens
UserList

Listar usuários por projeto (V2)

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

Parâmetros

Nome Chave Necessário Tipo Descrição
Instância do Jira
X-Request-Jirainstance True string

A url onde sua instância do Jira está hospedada (deve suportar https).

Chave do projeto
projectKey True string

Chave única do projeto.

Regressos

Itens
UserList

Obter lista de filtros

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

Regressos

Obter lista de filtros (V2)

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

Parâmetros

Nome Chave Necessário Tipo Descrição
Instância do Jira
X-Request-Jirainstance True string

A url onde sua instância do Jira está hospedada (deve suportar https).

Regressos

Obter lista de problemas

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

Parâmetros

Nome Chave Necessário Tipo Descrição
Instância do Jira
X-Request-Jirainstance True string

A url onde sua instância do Jira está hospedada (deve suportar https).

Regressos

Obter lista de problemas (Centro de dados)

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

Parâmetros

Nome Chave Necessário Tipo Descrição
Instância do Jira
X-Request-Jirainstance True string

A url onde sua instância do Jira está hospedada (deve suportar https).

Regressos

Obter lista de recursos

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

Regressos

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 Necessário Tipo Descrição
Instância do Jira
X-Request-Jirainstance True string

A url onde sua instância do Jira está hospedada (deve suportar https).

ID ou chave do problema
issueIdOrKey True string

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

Regressos

Nome Percurso Tipo Descrição
Transições
transitions array of Transition

Obter problema por chave

Esta operação é usada para recuperar o objeto de problema para uma determinada chave de problema.

Parâmetros

Nome Chave Necessário Tipo Descrição
Chave do problema
issueKey True string

Chave única da questão.

Regressos

Questão
FullIssue

Obter problema por chave (V2)

Esta operação é usada para recuperar o objeto de problema para uma determinada chave de problema.

Parâmetros

Nome Chave Necessário Tipo Descrição
Instância do Jira
X-Request-Jirainstance True string

A url onde sua instância do Jira está hospedada (deve suportar https).

Chave do problema
issueKey True string

Chave única da questão.

Regressos

Questão
FullIssue

Obter projetos

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

Regressos

Obter projetos (V2)

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

Parâmetros

Nome Chave Necessário Tipo Descrição
Instância do Jira
X-Request-Jirainstance True string

A url onde sua instância do Jira está hospedada (deve suportar https).

Regressos

Obter projetos [DEPRECATED]

Esta ação foi preterida. Em vez disso, use Get projects .

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

Regressos

Itens
ProjectArray

Obter tarefa

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

Parâmetros

Nome Chave Necessário Tipo Descrição
ID da tarefa
taskId True string

A ID da tarefa.

Obter tarefa (V2)

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

Parâmetros

Nome Chave Necessário Tipo Descrição
Instância do Jira
X-Request-Jirainstance True string

A url onde sua instância do Jira está hospedada (deve suportar https).

ID da tarefa
taskId True string

A ID da tarefa.

Obter todas as categorias de projeto

Retorna todas as categorias de projeto.

Regressos

Nome Percurso Tipo Descrição
array of object
Eu mesmo
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 Necessário Tipo Descrição
Instância do Jira
X-Request-Jirainstance True string

A url onde sua instância do Jira está hospedada (deve suportar https).

Regressos

Nome Percurso Tipo Descrição
array of object
Eu mesmo
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: procure usuários e grupos.

Parâmetros

Nome Chave Necessário Tipo Descrição
ID da conta
accountId True string

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

Expandir
expand string

Use expandir para incluir informações adicionais sobre os usuários na resposta. Este parâmetro aceita uma lista separada por vírgula. 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: procure usuários e grupos.

Parâmetros

Nome Chave Necessário Tipo Descrição
Instância do Jira
X-Request-Jirainstance True string

A url onde sua instância do Jira está hospedada (deve suportar https).

ID da conta
accountId True string

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

Expandir
expand string

Use expandir para incluir informações adicionais sobre os usuários na resposta. Este parâmetro aceita uma lista separada por vírgula. 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 atual

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

Parâmetros

Nome Chave Necessário Tipo Descrição
Instância do Jira
X-Request-Jirainstance True string

A url onde sua instância do Jira está hospedada (deve suportar https).

Expandir
expand string

Use expandir para incluir informações adicionais sobre os usuários na resposta. Este parâmetro aceita uma lista separada por vírgula. 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.

Remover categoria de projeto

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

Parâmetros

Nome Chave Necessário Tipo Descrição
ID do projeto
id True integer

ID da categoria do projeto a ser excluída.

Remover categoria de projeto (V2)

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

Parâmetros

Nome Chave Necessário Tipo Descrição
Instância do Jira
X-Request-Jirainstance True string

A url onde sua instância do Jira está hospedada (deve suportar 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 Necessário Tipo Descrição
jsonrpc
jsonrpc string
id
id string
método
method string
parâmetros
params object
Resultado
result object
erro
error object
ID de sessão
sessionId string

Regressos

Gatilhos

Quando um novo problema é criado

Esta operação é acionada quando um novo problema é adicionado ao projeto determinado.

Quando um novo problema é criado (V2)

Esta operação é acionada quando um novo problema é adicionado ao projeto determinado.

Quando um novo problema é devolvido por uma consulta JQL (Centro de dados)

Esta operação é acionada quando um novo problema aparece nos 100 resultados mais recentes de uma consulta JQL.

Quando um novo problema é retornado por uma consulta JQL

Esta operação é acionada quando um novo problema aparece nos 100 resultados mais recentes de uma consulta JQL.

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

Esta operação é acionada quando um novo problema aparece nos 100 resultados mais recentes de uma consulta JQL.

Quando um problema é encerrado (Centro de dados)

Esta operação é acionada quando um problema existente é fechado no projeto determinado.

Quando um problema é fechado

Esta operação é acionada quando um problema existente é fechado no projeto determinado.

Quando um problema é fechado (V2)

Esta operação é acionada quando um problema existente é fechado no projeto determinado.

Quando é criado um novo problema (Centro de dados)

Esta operação é acionada quando um novo problema é adicionado ao projeto determinado.

Quando um novo problema é criado

Esta operação é acionada quando um novo problema é adicionado ao projeto determinado.

Parâmetros

Nome Chave Necessário Tipo Descrição
Projeto
projectKey True string

Chave única do projeto para procurar novas questões.

Regressos

Questão
FullIssue

Quando um novo problema é criado (V2)

Esta operação é acionada quando um novo problema é adicionado ao projeto determinado.

Parâmetros

Nome Chave Necessário Tipo Descrição
Instância do Jira
X-Request-Jirainstance string

A url onde sua instância do Jira está hospedada (deve suportar https).

Projeto
projectKey True string

Chave única do projeto para procurar novas questões.

Regressos

Questão
FullIssue

Quando um novo problema é devolvido por uma consulta JQL (Centro de dados)

Esta operação é acionada quando um novo problema aparece nos 100 resultados mais recentes de uma consulta JQL.

Parâmetros

Nome Chave Necessário Tipo Descrição
Instância do Jira
X-Request-Jirainstance string

A url onde sua instância do Jira está hospedada (deve suportar https).

Consulta JQL
jql True string

Consulta a utilizar.

Regressos

Questão
FullIssue

Quando um novo problema é retornado por uma consulta JQL

Esta operação é acionada quando um novo problema aparece nos 100 resultados mais recentes de uma consulta JQL.

Parâmetros

Nome Chave Necessário Tipo Descrição
Consulta JQL
jql True string

Consulta a utilizar.

Regressos

Questão
FullIssue

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

Esta operação é acionada quando um novo problema aparece nos 100 resultados mais recentes de uma consulta JQL.

Parâmetros

Nome Chave Necessário Tipo Descrição
Instância do Jira
X-Request-Jirainstance string

A url onde sua instância do Jira está hospedada (deve suportar https).

Consulta JQL
jql True string

Consulta a utilizar.

Regressos

Questão
FullIssue

Quando um problema é encerrado (Centro de dados)

Esta operação é acionada quando um problema existente é fechado no projeto determinado.

Parâmetros

Nome Chave Necessário Tipo Descrição
Instância do Jira
X-Request-Jirainstance string

A url onde sua instância do Jira está hospedada (deve suportar https).

Projeto
projectKey True string

Chave única do projeto para procurar novas questões.

Regressos

Questão
FullIssue

Quando um problema é fechado

Esta operação é acionada quando um problema existente é fechado no projeto determinado.

Parâmetros

Nome Chave Necessário Tipo Descrição
Projeto
projectKey True string

Chave única do projeto para procurar novas questões.

Regressos

Questão
FullIssue

Quando um problema é fechado (V2)

Esta operação é acionada quando um problema existente é fechado no projeto determinado.

Parâmetros

Nome Chave Necessário Tipo Descrição
Instância do Jira
X-Request-Jirainstance string

A url onde sua instância do Jira está hospedada (deve suportar https).

Projeto
projectKey True string

Chave única do projeto para procurar novas questões.

Regressos

Questão
FullIssue

Quando é criado um novo problema (Centro de dados)

Esta operação é acionada quando um novo problema é adicionado ao projeto determinado.

Parâmetros

Nome Chave Necessário Tipo Descrição
Instância do Jira
X-Request-Jirainstance string

A url onde sua instância do Jira está hospedada (deve suportar https).

Projeto
projectKey True string

Chave única do projeto para procurar novas questões.

Regressos

Questão
FullIssue

Definições

CreateProjectResponse

Nome Percurso Tipo Descrição
ID do projeto
id integer

ID único do projeto.

Chave do Projeto
key string

Chave única do projeto.

CreateIssueResponse

Nome Percurso Tipo Descrição
ID do problema
id string

Identificador exclusivo do problema.

Chave do problema
key string

Chave única da questão.

ListProjects_ResponseV2

Nome Percurso Tipo Descrição
values
values ProjectArray

ProjectArray

Nome Percurso Tipo Descrição
ID do projeto
id string

O Id único do projeto.

Chave do Projeto
key string

A chave única do projeto.

Nome do Projeto
name string

Nome do projeto.

Chave do tipo de projeto
projectTypeKey string

A chave exclusiva do tipo de projeto.

Edição completa

Nome Percurso Tipo Descrição
ID do problema
id string

ID exclusivo do problema.

Chave do problema
key string

Chave única da questão.

URL do problema
self string

Navegue até o problema usando este URL.

ID do tipo de problema
fields.issuetype.id string

ID exclusivo do tipo de problema.

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

Título detalhado do tipo de emissão.

URL do ícone do 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 emissão.

Tempo gasto
fields.timespent integer

O tempo gasto em uma questão

ID do projeto
fields.project.id string

O id único do projeto.

Chave do Projeto
fields.project.key string

A chave única do projeto.

Nome do Projeto
fields.project.name string

Título do projeto.

Chave do 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 do problema
fields.resolution.self string
ID da resolução do problema
fields.resolution.id string
Descrição da resolução do problema
fields.resolution.description string
Nome para a resolução do problema
fields.resolution.name string
Data da Resolução
fields.resolutiondate date-time

aaaa-MM-ddTHH:mm:ss.fffZ

Relação de Trabalho
fields.workratio integer

A porcentagem de trabalho registrado versus a estimativa de problema.

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

aaaa-MM-ddTHH:mm:ss.fffZ

URL do ícone de prioridade
fields.priority.iconUrl string

Ícone associado à prioridade do problema.

Nome da prioridade
fields.priority.name string

Designação 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 agregado
fields.aggregatetimeoriginalestimate integer

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

Identificação do cessionário
fields.assignee.accountId string

Pessoa à qual um problema é atribuído.

Chave do cessionário
fields.assignee.key string

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

Endereço eletrónico do cessionário
fields.assignee.emailAddress string

O e-mail da pessoa a quem o problema é atribuído.

Nome de exibição do cessionário
fields.assignee.displayName string

Nome de exibição da pessoa a que o problema é atribuído.

Atualizado Date-Time
fields.updated date-time

aaaa-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 estado
fields.status.name string

Status do problema.

ID de Estado
fields.status.id string

Status do problema.

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

Categoria de status de emissão.

Chave de categoria de status
fields.status.statusCategory.key string

Categoria de status de emissão.

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

Categoria de status de emissão.

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

Categoria de status de emissão.

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 agregado
fields.aggregatetimeestimate integer

Soma de tempo de todas as subtarefas restantes tempo estimado em segundos.

Resumo
fields.summary string

Título da edição.

Components
fields.components array of object

Um campo do sistema que é vários valores endereçados por 'nome' (por exemplo, Microsoft Entra ID, Network Switch).

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.

E-mail do criador
fields.creator.emailAddress string

E-mail 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.

E-mail do repórter
fields.reporter.emailAddress string

E-mail do usuário que relatou o problema.

Nome de exibição do repórter
fields.reporter.displayName string

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

Progresso agregado concluído
fields.aggregateprogress.progress integer

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

Esforço estimado agregado
fields.aggregateprogress.total integer

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

Percentagem de progresso agregada
fields.aggregateprogress.percent integer

A percentagem do progresso total concluído em relação ao esforço estimado.

Devido Date-Time
fields.duedate date-time

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

Percentagem de progresso
fields.progress.percent integer

A percentagem 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. Este campo corresponde ao campo 'customfield_10011' no servidor Jira.

Lista de usuários

Nome Percurso Tipo Descrição
Id
accountId string

Id do membro do projeto.

Key
key string

Chave exclusiva associada ao usuário.

Email
emailAddress string

Endereço de e-mail do usuário.

Nome de exibição
displayName string

Nome completo do utilizador.

ListFiltersResponse

Nome Percurso Tipo Descrição
values
values FilterArray

FilterArray

Nome Percurso Tipo Descrição
Id
id string

Id do filtro.

Nome
name string

Nome do filtro.

JQL
jql string

jql usado em Filtro.

ListIssuesResponse

Nome Percurso Tipo Descrição
issues
issues array of FullIssue

ListIssuesResponseDatacenter

Nome Percurso Tipo Descrição
issues
issues array of FullIssue

ComentárioResposta

Nome Percurso Tipo Descrição
ID do comentário
id string

ID único do comentário.

Corpo do comentário
body string

Corpo do comentário.

Criado Date-Time
created date-time

aaaa-MM-ddTHH:mm:ss.fffZ

Sites

Nome Percurso Tipo Descrição
ID da nuvem
id string

ID da instância do Jira

Nome do Site
name string
Site URL
url string

Transition

Nome Percurso Tipo Descrição
id
id string

ID da transição

nome
name string

Nome da transição

Para
to TransitionStatus
campos
fields object

Campos necessários para esta transição

TransitionStatus

Nome Percurso Tipo Descrição
id
id string

ID do status

nome
name string

Nome do estatuto

MCPQueryResponse

Nome Percurso Tipo Descrição
jsonrpc
jsonrpc string
id
id string
método
method string
parâmetros
params object
Resultado
result object
erro
error object