Compartir a través de


Jira

Jira es una herramienta de desarrollo de software para que los equipos ágiles planeen, realicen un seguimiento y publiquen software de primera clase. Conectar problemas de Jira con el resto de las herramientas ayuda a romper las barreras y liberar el potencial de su equipo.

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Premium Todas las regiones de Power Automate excepto las siguientes:
     - China Cloud operado por 21Vianet
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps excepto las siguientes:
     - Regiones de Azure China
     - Departamento de Defensa de EE. UU. (DoD)
Power Apps Premium Todas las regiones de Power Apps excepto las siguientes:
     - China Cloud operado por 21Vianet
Power Automate Premium Todas las regiones de Power Automate excepto las siguientes:
     - China Cloud operado por 21Vianet
Contacto
Nombre Microsoft
URL https://support.microsoft.com/
Correo Electrónico abapi@microsoft.com
Metadatos del conector
Publicador Microsoft
Sitio web https://www.atlassian.com/software/jira
Directiva de privacidad https://www.atlassian.com/legal/privacy-policy
Categorías Operaciones de TI; Colaboración

Para usar esta integración, necesitará una cuenta de Jira.

Importante

Debido a los cambios recientes en las API de back-end de Jira, las siguientes actualizaciones afectan al conector jira:

  • Coherencia de búsqueda: el punto de conexión de back-end no proporciona coherencia inmediata de búsqueda después de escritura. Es posible que los usuarios no reflejen las actualizaciones recientes realizadas en los resultados de búsqueda inmediatamente.
  • Límites de elementos devueltos: el punto de conexión devuelve un máximo de 20 comentarios y 40 elementos de registro de cambios.
  • Consultas JQL en desencadenadores: no se admiten consultas JQL sin enlazar. Las solicitudes con consultas sin enlazar darán lugar a una respuesta 400 Solicitud incorrecta.

Para obtener más información: ¿Qué es la búsqueda avanzada en Jira Cloud? Referencia: Registro de cambios para desarrolladores de Atlassian

Problemas conocidos y limitaciones

  • Para la autenticación, debe usar un token de API. Para obtener un token, vaya a este vínculo.
  • La autenticación básica con contraseñas está en desuso. Para más información, consulte la documentación de jira API.
  • No se admite jira Server detrás de un firewall o con la API REST deshabilitada.
  • Al crear una conexión a Jira Cloud, debe usar una dirección de correo electrónico válida para el nombre de usuario. De lo contrario, no se establecerá la conexión, aunque parece que se realiza correctamente.
  • Los nombres de usuario de Jira Cloud están en desuso y ya no se pueden usar para campos como Reporter. Para más información, consulte la documentación de Atlassian Cloud.
  • Según la documentación de jira API, jira API devuelve un máximo de 50 proyectos, por lo que los 50 proyectos principales se mostrarán en la lista desplegable en acciones o desencadenadores.
  • La paginación se implementó en proyectos Get. Devolverá todos los proyectos.
  • La acción Crear un nuevo problema (V2) solo admite tipos de campo simples, como "string", "number", "date" y "datetime" en el esquema dinámico. Si la configuración del proyecto tiene campos obligatorios de tipos de datos complejos, se producirá un error en la operación: "No se admite el campo '{key}' del tipo '{type}'". Para solucionar esta solución, cambie la configuración de campos del proyecto y haga que estos campos no sean necesarios.
  • La acción Crear un nuevo problema (V3) solo admite tipos de campo simples, como "string", "number", "date" y "datetime" en el esquema dinámico. Si la configuración del proyecto tiene campos obligatorios de tipos de datos complejos, se producirá un error en la operación: "No se admite el campo '{key}' del tipo '{type}'". Para solucionar esta solución, cambie la configuración de campos del proyecto y haga que estos campos no sean necesarios.
  • La Project propiedad esperada por las acciones y desencadenadores del conector debe rellenarse mediante una de las siguientes opciones:
    • Elija un proyecto del selector de proyectos. Tenga en cuenta que las conexiones de Jira Cloud muestran solo los 50 proyectos principales en el selector.
    • Use una salida de la acción Obtener proyectos (propiedad del Project Key proyecto).
  • Para más información sobre la edición de la operación del problema, consulte la documentación de Jira API.
  • Cuando un flujo de trabajo comienza a generar errores con una respuesta 400 o una solicitud incorrecta para cualquier acción o desencadenador, compruebe si la clave de API usada para crear la conexión ha expirado y, si es así, vuelva a crear la conexión con una nueva clave de API.

Creación de una conexión

El conector admite los siguientes tipos de autenticación:

API Token Uso del token de API para acceder a Jira Todas las regiones No se puede compartir
Oauth Use Oauth para acceder a Jira. Todas las regiones No se puede compartir
Valor predeterminado [EN DESUSO] Esta opción solo es para conexiones anteriores sin un tipo de autenticación explícito y solo se proporciona para la compatibilidad con versiones anteriores. Todas las regiones No se puede compartir

Token API

Identificador de autenticación: APIToken

Aplicable: Todas las regiones

Uso del token de API para acceder a Jira

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre Tipo Description Obligatorio
Nombre de usuario o correo electrónico cuerda / cadena Su nombre de usuario jira. Para Jira Cloud, debe usar una dirección de correo electrónico válida. Cierto
Token de API securestring El token de API (https://id.atlassian.com/manage/api-tokens). Cierto

Oauth

Identificador de autenticación: oauth

Aplicable: Todas las regiones

Use Oauth para acceder a Jira.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Valor predeterminado [EN DESUSO]

Aplicable: Todas las regiones

Esta opción solo es para conexiones anteriores sin un tipo de autenticación explícito y solo se proporciona para la compatibilidad con versiones anteriores.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre Tipo Description Obligatorio
Instancia de Jira cuerda / cadena Dirección URL donde se hospeda la instancia de Jira (debe admitir https). Cierto
Nombre de usuario o correo electrónico cuerda / cadena Su nombre de usuario jira. Para Jira Cloud, debe usar una dirección de correo electrónico válida. Cierto
Token de API securestring El token de API (https://id.atlassian.com/manage/api-tokens). Cierto

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 100 60 segundos
Frecuencia de sondeos de desencadenador 1 60 segundos

Acciones

Actualizar proyecto

Actualiza los detalles del proyecto de un proyecto.

Actualizar proyecto (V2)

Actualiza los detalles del proyecto de un proyecto.

Agregar comentario

Esta operación se usa para agregar un comentario a un problema de Jira existente.

Agregar comentario (V2)

Esta operación se usa para agregar un comentario a un problema de Jira existente.

Cancelar tarea

Cancela una tarea. Permisos necesarios: cualquiera de: Administrar Jira o Creador de la tarea.

Cancelar tarea (V2)

Cancela una tarea. Permisos necesarios: cualquiera de: Administrar Jira o Creador de la tarea.

Creación de un nuevo problema (V3)

Esta operación se usa para crear un problema.

Creación de un nuevo proyecto

Esta operación se usa para crear un nuevo proyecto jira.

Creación de un nuevo proyecto (V2)

Esta operación se usa para crear un nuevo proyecto jira.

Crear categoría de proyecto

Crea una categoría de proyecto. Permisos necesarios: Administrar Jira (permisos globales)

Crear categoría de proyecto (V2)

Crea una categoría de proyecto. Permisos necesarios: Administrar Jira (permisos globales)

Crear un nuevo problema (V2) [EN DESUSO]

Esta acción ha quedado en desuso. En su lugar, use Create a new issue (V3) (Crear un problema nuevo [V3] ).

Esta operación se usa para crear un problema.

Crear un nuevo problema [EN DESUSO]

Esta acción ha quedado en desuso. En su lugar, use Create a new issue (V3) (Crear un problema nuevo [V3] ).

Esta operación se usa para crear un problema.

Editar problema

Edita un problema. Se puede aplicar una transición y emitir propiedades actualizadas como parte de la edición. Las modificaciones en los campos del problema se definen mediante la actualización y los campos.

Editar problema (V2)

Edita un problema. Se puede aplicar una transición y emitir propiedades actualizadas como parte de la edición. Las modificaciones en los campos del problema se definen mediante la actualización y los campos.

Elimina un proyecto

Elimina un proyecto. Permisos necesarios: Administrar Jira (permisos globales)

Eliminar proyecto (V2)

Elimina un proyecto. Permisos necesarios: Administrar Jira (permisos globales)

Enumerar usuarios por proyecto

Esta operación se usa para recuperar una lista de todos los usuarios asociados a un proyecto.

Enumerar usuarios por proyecto (V2)

Esta operación se usa para recuperar una lista de todos los usuarios asociados a un proyecto.

Obtención del problema por clave

Esta operación se usa para recuperar el objeto issue de una clave de problema determinada.

Obtención del problema por clave (V2)

Esta operación se usa para recuperar el objeto issue de una clave de problema determinada.

Obtención del usuario actual

Esta operación devuelve los detalles del usuario actual.

Obtener la lista de filtros

Esta operación devuelve una lista de filtros accesibles para el usuario.

Obtener la lista de filtros (V2)

Esta operación devuelve una lista de filtros accesibles para el usuario.

Obtener la lista de problemas

Esta operación devuelve una lista de problemas mediante JQL.

Obtener la lista de problemas (centro de datos)

Esta operación devuelve una lista de problemas mediante JQL.

Obtener la lista de recursos

Esta operación devuelve una lista de recursos accesibles para el usuario.

Obtener la lista de transiciones

Devuelve una lista de las transiciones posibles para este problema por parte del usuario actual.

Obtener proyectos

Esta operación se usa para recuperar una lista de proyectos para la instancia de Jira.

Obtener proyectos (V2)

Esta operación se usa para recuperar una lista de proyectos para la instancia de Jira.

Obtener proyectos [EN DESUSO]

Esta acción ha quedado en desuso. En su lugar, use Get projects (Obtener proyectos ).

Esta operación se usa para recuperar una lista de proyectos para la instancia de Jira.

Obtener tarea

Devuelve el estado de una tarea asincrónica de ejecución prolongada. Una vez finalizada una tarea, esta operación devuelve el blob JSON aplicable a la tarea.

Obtener tarea (V2)

Devuelve el estado de una tarea asincrónica de ejecución prolongada. Una vez finalizada una tarea, esta operación devuelve el blob JSON aplicable a la tarea.

Obtener todas las categorías de proyecto

Devuelve todas las categorías de proyecto.

Obtener todas las categorías de proyecto (V2)

Devuelve todas las categorías de proyecto.

Obtener usuario

Devuelve un usuario. Permisos necesarios: examine usuarios y grupos.

Obtener usuario (V2)

Devuelve un usuario. Permisos necesarios: examine usuarios y grupos.

Quitar categoría de proyecto

Elimina una categoría de proyecto. Permisos necesarios: Administrar Jira (permisos globales)

Quitar categoría de proyecto (V2)

Elimina una categoría de proyecto. Permisos necesarios: Administrar Jira (permisos globales)

Realiza una transición de problema

Realiza una transición de un problema a un nuevo estado.

Servidor MCP de Jira

Servidor MCP de Jira

Actualizar proyecto

Actualiza los detalles del proyecto de un proyecto.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de proyecto o clave
projectIdOrKey True string

Proporcione el identificador de proyecto o la clave que desea actualizar1.

key
key string

Key

nombre
name string

Nombre

projectTypeKey
projectTypeKey string

Clave de tipo de proyecto

projectTemplateKey
projectTemplateKey string

Clave de plantilla de proyecto

descripción
description string

Description

Conducir
lead string

Plomo

leadAccountId
leadAccountId string

Id. de cuenta de cliente potencial

URL
url string

URL

assigneeType
assigneeType string

Tipo asignado

avatarId
avatarId string

Id. de avatar

issueSecurityScheme
issueSecurityScheme string

Esquema de seguridad de problemas

permissionScheme
permissionScheme string

Esquema de permisos

notificationScheme
notificationScheme string

Esquema de notificación

categoryId
categoryId string

Id. de categoría

Actualizar proyecto (V2)

Actualiza los detalles del proyecto de un proyecto.

Parámetros

Nombre Clave Requerido Tipo Description
Instancia de Jira
X-Request-Jirainstance True string

Dirección URL donde se hospeda la instancia de Jira (debe admitir https).

Id. de proyecto o clave
projectIdOrKey True string

Proporcione el identificador de proyecto o la clave que desea actualizar1.

key
key string

Key

nombre
name string

Nombre

projectTypeKey
projectTypeKey string

Clave de tipo de proyecto

projectTemplateKey
projectTemplateKey string

Clave de plantilla de proyecto

descripción
description string

Description

Conducir
lead string

Plomo

leadAccountId
leadAccountId string

Id. de cuenta de cliente potencial

URL
url string

URL

assigneeType
assigneeType string

Tipo asignado

avatarId
avatarId string

Id. de avatar

issueSecurityScheme
issueSecurityScheme string

Esquema de seguridad de problemas

permissionScheme
permissionScheme string

Esquema de permisos

notificationScheme
notificationScheme string

Esquema de notificación

categoryId
categoryId string

Id. de categoría

Agregar comentario

Esta operación se usa para agregar un comentario a un problema de Jira existente.

Parámetros

Nombre Clave Requerido Tipo Description
Clave de problema
issueKey True string

Clave única del problema al que agregar un comentario.

Comentario
body True string

Cuerpo del comentario.

Devoluciones

Agregar comentario (V2)

Esta operación se usa para agregar un comentario a un problema de Jira existente.

Parámetros

Nombre Clave Requerido Tipo Description
Instancia de Jira
X-Request-Jirainstance True string

Dirección URL donde se hospeda la instancia de Jira (debe admitir https).

Clave de problema
issueKey True string

Clave única del problema al que agregar un comentario.

Comentario
body True string

Cuerpo del comentario.

Devoluciones

Cancelar tarea

Cancela una tarea. Permisos necesarios: cualquiera de: Administrar Jira o Creador de la tarea.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de tarea
taskId True string

Identificador de la tarea.

Cancelar tarea (V2)

Cancela una tarea. Permisos necesarios: cualquiera de: Administrar Jira o Creador de la tarea.

Parámetros

Nombre Clave Requerido Tipo Description
Instancia de Jira
X-Request-Jirainstance True string

Dirección URL donde se hospeda la instancia de Jira (debe admitir https).

Id. de tarea
taskId True string

Identificador de la tarea.

Creación de un nuevo problema (V3)

Esta operación se usa para crear un problema.

Parámetros

Nombre Clave Requerido Tipo Description
Instancia de Jira
X-Request-Jirainstance True string

Dirección URL donde se hospeda la instancia de Jira (debe admitir https).

Proyecto
projectKey True string

Elija un proyecto en el que crear el problema.

Identificador de tipo de problema
issueTypeIds True string

Elija un tipo de problema.

item
item dynamic

Elemento

Devoluciones

Creación de un nuevo proyecto

Esta operación se usa para crear un nuevo proyecto jira.

Parámetros

Nombre Clave Requerido Tipo Description
Clave de proyecto
key True string

La clave única comienza con una letra mayúscula.

Nombre
name True string

Título del proyecto.

Tipo
projectTypeKey True string

Clave de tipo de proyecto.

Id. de cliente potencial
leadAccountId True string

Identificador del cliente potencial de Project.

Description
description string

Descripción detallada del proyecto.

Devoluciones

Creación de un nuevo proyecto (V2)

Esta operación se usa para crear un nuevo proyecto jira.

Parámetros

Nombre Clave Requerido Tipo Description
Instancia de Jira
X-Request-Jirainstance True string

Dirección URL donde se hospeda la instancia de Jira (debe admitir https).

Clave de proyecto
key True string

La clave única comienza con una letra mayúscula.

Nombre
name True string

Título del proyecto.

Tipo
projectTypeKey True string

Clave de tipo de proyecto.

Id. de cliente potencial
leadAccountId True string

Identificador del cliente potencial de Project.

Description
description string

Descripción detallada del proyecto.

Devoluciones

Crear categoría de proyecto

Crea una categoría de proyecto. Permisos necesarios: Administrar Jira (permisos globales)

Parámetros

Nombre Clave Requerido Tipo Description
nombre
name string

Nombre

descripción
description string

Description

Crear categoría de proyecto (V2)

Crea una categoría de proyecto. Permisos necesarios: Administrar Jira (permisos globales)

Parámetros

Nombre Clave Requerido Tipo Description
Instancia de Jira
X-Request-Jirainstance True string

Dirección URL donde se hospeda la instancia de Jira (debe admitir https).

nombre
name string

Nombre

descripción
description string

Description

Crear un nuevo problema (V2) [EN DESUSO]

Esta acción ha quedado en desuso. En su lugar, use Create a new issue (V3) (Crear un problema nuevo [V3] ).

Esta operación se usa para crear un problema.

Parámetros

Nombre Clave Requerido Tipo Description
Proyecto
projectKey True string

Elija un proyecto en el que crear el problema.

Identificador de tipo de problema
issueTypeIds True string

Elija un tipo de problema.

item
item dynamic

Elemento

Devoluciones

Crear un nuevo problema [EN DESUSO]

Esta acción ha quedado en desuso. En su lugar, use Create a new issue (V3) (Crear un problema nuevo [V3] ).

Esta operación se usa para crear un problema.

Parámetros

Nombre Clave Requerido Tipo Description
Proyecto
projectKey True string

Elija un proyecto en el que crear el problema.

Identificador de tipo de problema
id True string

Elija un tipo de problema.

Resumen
summary True string

Breve descripción del problema.

Components
components string

Campo del sistema que es varios valores dirigidos por "name" (por ejemplo, Microsoft Entra ID, Network Switch).

Id. del periodista
id string

Persona que informa del problema.

Description
description string

Descripción detallada del problema.

Id. de prioridad
id string

Elija una prioridad para el problema.

Etiquetas
labels string

Escriba una lista separada por comas de etiquetas.

Id. de asignado
id string

Agente al que se asigna el problema.

Identificador de problema primario
id string

Establezca el elemento primario de una subtarea.

Nombre épico (customfield_10011)
customfield_10119 string

El nombre épico es necesario para el tipo de problema épico. Este campo coincide con el campo "customfield_10011" en el servidor Jira.

Devoluciones

Editar problema

Edita un problema. Se puede aplicar una transición y emitir propiedades actualizadas como parte de la edición. Las modificaciones en los campos del problema se definen mediante la actualización y los campos.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de problema o clave
issueIdOrKey True string

Proporcione el identificador de problema o la clave para el problema que desea editar.

Notificar a los usuarios
notifyUsers boolean

¿Desea notificar a los usuarios?

Invalidar la seguridad de la pantalla
overrideScreenSecurity boolean

¿Desea invalidar la seguridad de la pantalla?

Invalidar marca editable
overrideEditableFlag boolean

¿Desea invalidar la marca editable?

Id. de transición
id string

Id. de transición

Transición en bucle
looped string

Transición en bucle

Fields
fields object

Lista de campos de pantalla de problemas que se van a actualizar, especificando el subcampo que se va a actualizar y su valor para cada campo. Este campo proporciona una opción sencilla al establecer un subcampo. Cuando se requieren varios subprocesos u otras operaciones, use update. Los campos incluidos aquí no se pueden incluir en la actualización.

Update
update object

Mapa que contiene el nombre del campo de campo y una lista de operaciones que se van a realizar en el campo de pantalla de problema. Tenga en cuenta que los campos incluidos aquí no se pueden incluir en los campos.

Tipo de metadatos
type string

Tipo de metadatos del historial

Descripción de metadatos
description string

Descripción de metadatos del historial

Clave de descripción de metadatos
descriptionKey string

Clave de descripción de metadatos del historial

Descripción de la actividad de metadatos
activityDescription string

Descripción de la actividad de metadatos del historial

Clave de descripción de la actividad de metadatos
activityDescriptionKey string

Clave de descripción de la actividad de metadatos del historial

Descripción del correo electrónico de metadatos
emailDescription string

Descripción del correo electrónico de metadatos del historial

Clave de descripción del correo electrónico de metadatos
emailDescriptionKey string

Clave de descripción del correo electrónico de metadatos del historial

Id. de actor
id string

Id. de actor

Nombre para mostrar del actor
displayName string

Nombre para mostrar del actor

Clave de nombre para mostrar del actor
displayNameKey string

Clave de nombre para mostrar del actor

Tipo de actor
type string

Tipo de actor

Dirección URL del avatar del actor
avatarUrl string

Dirección URL del avatar del actor

Dirección URL del actor
url string

Dirección URL del actor

Id. del generador
id string

Id. del generador

Nombre para mostrar del generador
displayName string

Nombre para mostrar del generador

Clave de nombre para mostrar del generador
displayNameKey string

Clave de nombre para mostrar del generador

Tipo de generador
type string

Tipo de generador

Dirección URL del avatar del generador
avatarUrl string

Dirección URL del avatar del generador

Dirección URL del generador
url string

Dirección URL del generador

Id. de causa
id string

Id. de causa

Causa del nombre para mostrar
displayName string

Causa del nombre para mostrar

Causa de la clave de nombre para mostrar
displayNameKey string

Causa de la clave de nombre para mostrar

Tipo de causa
type string

Tipo de causa

Causa de la dirección URL del avatar
avatarUrl string

Causa de la dirección URL del avatar

Dirección URL de la causa
url string

Dirección URL de la causa

Datos adicionales
extraData string

Datos adicionales

key
key string

Key

Editar problema (V2)

Edita un problema. Se puede aplicar una transición y emitir propiedades actualizadas como parte de la edición. Las modificaciones en los campos del problema se definen mediante la actualización y los campos.

Parámetros

Nombre Clave Requerido Tipo Description
Instancia de Jira
X-Request-Jirainstance True string

Dirección URL donde se hospeda la instancia de Jira (debe admitir https).

Identificador de problema o clave
issueIdOrKey True string

Proporcione el identificador de problema o la clave para el problema que desea editar.

Notificar a los usuarios
notifyUsers boolean

¿Desea notificar a los usuarios?

Invalidar la seguridad de la pantalla
overrideScreenSecurity boolean

¿Desea invalidar la seguridad de la pantalla?

Invalidar marca editable
overrideEditableFlag boolean

¿Desea invalidar la marca editable?

Id. de transición
id string

Id. de transición

Transición en bucle
looped string

Transición en bucle

Fields
fields object

Lista de campos de pantalla de problemas que se van a actualizar, especificando el subcampo que se va a actualizar y su valor para cada campo. Este campo proporciona una opción sencilla al establecer un subcampo. Cuando se requieren varios subprocesos u otras operaciones, use update. Los campos incluidos aquí no se pueden incluir en la actualización.

Update
update object

Mapa que contiene el nombre del campo de campo y una lista de operaciones que se van a realizar en el campo de pantalla de problema. Tenga en cuenta que los campos incluidos aquí no se pueden incluir en los campos.

Tipo de metadatos
type string

Tipo de metadatos del historial

Descripción de metadatos
description string

Descripción de metadatos del historial

Clave de descripción de metadatos
descriptionKey string

Clave de descripción de metadatos del historial

Descripción de la actividad de metadatos
activityDescription string

Descripción de la actividad de metadatos del historial

Clave de descripción de la actividad de metadatos
activityDescriptionKey string

Clave de descripción de la actividad de metadatos del historial

Descripción del correo electrónico de metadatos
emailDescription string

Descripción del correo electrónico de metadatos del historial

Clave de descripción del correo electrónico de metadatos
emailDescriptionKey string

Clave de descripción del correo electrónico de metadatos del historial

Id. de actor
id string

Id. de actor

Nombre para mostrar del actor
displayName string

Nombre para mostrar del actor

Clave de nombre para mostrar del actor
displayNameKey string

Clave de nombre para mostrar del actor

Tipo de actor
type string

Tipo de actor

Dirección URL del avatar del actor
avatarUrl string

Dirección URL del avatar del actor

Dirección URL del actor
url string

Dirección URL del actor

Id. del generador
id string

Id. del generador

Nombre para mostrar del generador
displayName string

Nombre para mostrar del generador

Clave de nombre para mostrar del generador
displayNameKey string

Clave de nombre para mostrar del generador

Tipo de generador
type string

Tipo de generador

Dirección URL del avatar del generador
avatarUrl string

Dirección URL del avatar del generador

Dirección URL del generador
url string

Dirección URL del generador

Id. de causa
id string

Id. de causa

Causa del nombre para mostrar
displayName string

Causa del nombre para mostrar

Causa de la clave de nombre para mostrar
displayNameKey string

Causa de la clave de nombre para mostrar

Tipo de causa
type string

Tipo de causa

Causa de la dirección URL del avatar
avatarUrl string

Causa de la dirección URL del avatar

Dirección URL de la causa
url string

Dirección URL de la causa

Datos adicionales
extraData string

Datos adicionales

key
key string

Key

Elimina un proyecto

Elimina un proyecto. Permisos necesarios: Administrar Jira (permisos globales)

Parámetros

Nombre Clave Requerido Tipo Description
Id. de proyecto o clave
projectIdOrKey True string

Identificador de proyecto o clave de proyecto (distingue mayúsculas de minúsculas).

Habilitar deshacer
enableUndo boolean

Si este proyecto se coloca en la papelera de reciclaje de Jira, donde estará disponible para la restauración.

Eliminar proyecto (V2)

Elimina un proyecto. Permisos necesarios: Administrar Jira (permisos globales)

Parámetros

Nombre Clave Requerido Tipo Description
Instancia de Jira
X-Request-Jirainstance True string

Dirección URL donde se hospeda la instancia de Jira (debe admitir https).

Id. de proyecto o clave
projectIdOrKey True string

Identificador de proyecto o clave de proyecto (distingue mayúsculas de minúsculas).

Habilitar deshacer
enableUndo boolean

Si este proyecto se coloca en la papelera de reciclaje de Jira, donde estará disponible para la restauración.

Enumerar usuarios por proyecto

Esta operación se usa para recuperar una lista de todos los usuarios asociados a un proyecto.

Parámetros

Nombre Clave Requerido Tipo Description
Clave del proyecto
projectKey True string

Clave única del proyecto.

Devoluciones

Productos
UserList

Enumerar usuarios por proyecto (V2)

Esta operación se usa para recuperar una lista de todos los usuarios asociados a un proyecto.

Parámetros

Nombre Clave Requerido Tipo Description
Instancia de Jira
X-Request-Jirainstance True string

Dirección URL donde se hospeda la instancia de Jira (debe admitir https).

Clave del proyecto
projectKey True string

Clave única del proyecto.

Devoluciones

Productos
UserList

Obtención del problema por clave

Esta operación se usa para recuperar el objeto issue de una clave de problema determinada.

Parámetros

Nombre Clave Requerido Tipo Description
Clave de problema
issueKey True string

Clave única del problema.

Devoluciones

Cuestión
FullIssue

Obtención del problema por clave (V2)

Esta operación se usa para recuperar el objeto issue de una clave de problema determinada.

Parámetros

Nombre Clave Requerido Tipo Description
Instancia de Jira
X-Request-Jirainstance True string

Dirección URL donde se hospeda la instancia de Jira (debe admitir https).

Clave de problema
issueKey True string

Clave única del problema.

Devoluciones

Cuestión
FullIssue

Obtención del usuario actual

Esta operación devuelve los detalles del usuario actual.

Parámetros

Nombre Clave Requerido Tipo Description
Instancia de Jira
X-Request-Jirainstance True string

Dirección URL donde se hospeda la instancia de Jira (debe admitir https).

Expandir
expand string

Use expand para incluir información adicional sobre los usuarios en la respuesta. Este parámetro acepta una lista separada por comas. Las opciones de expansión incluyen: * groups incluye todos los grupos y grupos anidados a los que pertenece el usuario. * applicationRoles incluye detalles de todas las aplicaciones a las que tiene acceso el usuario.

Obtener la lista de filtros

Esta operación devuelve una lista de filtros accesibles para el usuario.

Devoluciones

Obtener la lista de filtros (V2)

Esta operación devuelve una lista de filtros accesibles para el usuario.

Parámetros

Nombre Clave Requerido Tipo Description
Instancia de Jira
X-Request-Jirainstance True string

Dirección URL donde se hospeda la instancia de Jira (debe admitir https).

Devoluciones

Obtener la lista de problemas

Esta operación devuelve una lista de problemas mediante JQL.

Parámetros

Nombre Clave Requerido Tipo Description
Instancia de Jira
X-Request-Jirainstance True string

Dirección URL donde se hospeda la instancia de Jira (debe admitir https).

Devoluciones

Obtener la lista de problemas (centro de datos)

Esta operación devuelve una lista de problemas mediante JQL.

Parámetros

Nombre Clave Requerido Tipo Description
Instancia de Jira
X-Request-Jirainstance True string

Dirección URL donde se hospeda la instancia de Jira (debe admitir https).

Devoluciones

Obtener la lista de recursos

Esta operación devuelve una lista de recursos accesibles para el usuario.

Devoluciones

Productos
Sites

Obtener la lista de transiciones

Devuelve una lista de las transiciones posibles para este problema por parte del usuario actual.

Parámetros

Nombre Clave Requerido Tipo Description
Instancia de Jira
X-Request-Jirainstance True string

Dirección URL donde se hospeda la instancia de Jira (debe admitir https).

Identificador de problema o clave
issueIdOrKey True string

Identificador o clave del problema para recuperar las transiciones de

Devoluciones

Nombre Ruta de acceso Tipo Description
Transiciones
transitions array of Transition

Obtener proyectos

Esta operación se usa para recuperar una lista de proyectos para la instancia de Jira.

Devoluciones

Obtener proyectos (V2)

Esta operación se usa para recuperar una lista de proyectos para la instancia de Jira.

Parámetros

Nombre Clave Requerido Tipo Description
Instancia de Jira
X-Request-Jirainstance True string

Dirección URL donde se hospeda la instancia de Jira (debe admitir https).

Devoluciones

Obtener proyectos [EN DESUSO]

Esta acción ha quedado en desuso. En su lugar, use Get projects (Obtener proyectos ).

Esta operación se usa para recuperar una lista de proyectos para la instancia de Jira.

Devoluciones

Productos
ProjectArray

Obtener tarea

Devuelve el estado de una tarea asincrónica de ejecución prolongada. Una vez finalizada una tarea, esta operación devuelve el blob JSON aplicable a la tarea.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de tarea
taskId True string

Identificador de la tarea.

Obtener tarea (V2)

Devuelve el estado de una tarea asincrónica de ejecución prolongada. Una vez finalizada una tarea, esta operación devuelve el blob JSON aplicable a la tarea.

Parámetros

Nombre Clave Requerido Tipo Description
Instancia de Jira
X-Request-Jirainstance True string

Dirección URL donde se hospeda la instancia de Jira (debe admitir https).

Id. de tarea
taskId True string

Identificador de la tarea.

Obtener todas las categorías de proyecto

Devuelve todas las categorías de proyecto.

Devoluciones

Nombre Ruta de acceso Tipo Description
array of object
propio
self string

Self

id
id string

identificación

descripción
description string

Description

nombre
name string

Nombre

Obtener todas las categorías de proyecto (V2)

Devuelve todas las categorías de proyecto.

Parámetros

Nombre Clave Requerido Tipo Description
Instancia de Jira
X-Request-Jirainstance True string

Dirección URL donde se hospeda la instancia de Jira (debe admitir https).

Devoluciones

Nombre Ruta de acceso Tipo Description
array of object
propio
self string

Self

id
id string

identificación

descripción
description string

Description

nombre
name string

Nombre

Obtener usuario

Devuelve un usuario. Permisos necesarios: examine usuarios y grupos.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de cuenta
accountId True string

Identificador de cuenta del usuario, que identifica de forma única al usuario en todos los productos atlassian. Por ejemplo, 5b10ac8d82e05b22cc7d4ef5. Obligatorio.

Expandir
expand string

Use expand para incluir información adicional sobre los usuarios en la respuesta. Este parámetro acepta una lista separada por comas. Las opciones de expansión incluyen: * groups incluye todos los grupos y grupos anidados a los que pertenece el usuario. * applicationRoles incluye detalles de todas las aplicaciones a las que tiene acceso el usuario.

Obtener usuario (V2)

Devuelve un usuario. Permisos necesarios: examine usuarios y grupos.

Parámetros

Nombre Clave Requerido Tipo Description
Instancia de Jira
X-Request-Jirainstance True string

Dirección URL donde se hospeda la instancia de Jira (debe admitir https).

Id. de cuenta
accountId True string

Identificador de cuenta del usuario, que identifica de forma única al usuario en todos los productos atlassian. Por ejemplo, 5b10ac8d82e05b22cc7d4ef5. Obligatorio.

Expandir
expand string

Use expand para incluir información adicional sobre los usuarios en la respuesta. Este parámetro acepta una lista separada por comas. Las opciones de expansión incluyen: * groups incluye todos los grupos y grupos anidados a los que pertenece el usuario. * applicationRoles incluye detalles de todas las aplicaciones a las que tiene acceso el usuario.

Quitar categoría de proyecto

Elimina una categoría de proyecto. Permisos necesarios: Administrar Jira (permisos globales)

Parámetros

Nombre Clave Requerido Tipo Description
Id. de proyecto
id True integer

Identificador de la categoría del proyecto que se va a eliminar.

Quitar categoría de proyecto (V2)

Elimina una categoría de proyecto. Permisos necesarios: Administrar Jira (permisos globales)

Parámetros

Nombre Clave Requerido Tipo Description
Instancia de Jira
X-Request-Jirainstance True string

Dirección URL donde se hospeda la instancia de Jira (debe admitir https).

Id. de proyecto
id True integer

Identificador de la categoría del proyecto que se va a eliminar.

Realiza una transición de problema

Realiza una transición de un problema a un nuevo estado.

Parámetros

Nombre Clave Requerido Tipo Description
Instancia de Jira
X-Request-Jirainstance True string

Dirección URL donde se hospeda la instancia de Jira (debe admitir https).

Identificador de problema o clave
issueIdOrKey True string

Identificador o clave del problema que se va a realizar la transición

nombre
name string
nombre
name string
activityDescription
activityDescription string
avatarUrl
avatarUrl string
Nombre para mostrar
displayName string
id
id string
type
type string
URL
url string
id
id string
type
type string
descripción
description string
Iteración
Iteration string
Step
Step string
id
id string
type
type string
type
type string
id
id string
body
body string

Servidor MCP de Jira

Servidor MCP de Jira

Parámetros

Nombre Clave Requerido Tipo Description
jsonrpc
jsonrpc string
id
id string
method
method string
parámetros
params object
resultado
result object
error
error object
sessionId
sessionId string

Devoluciones

Desencadenadores

Cuando se cierra un problema

Esta operación se desencadena cuando se cierra un problema existente en el proyecto determinado.

Cuando se cierra un problema (centro de datos)

Esta operación se desencadena cuando se cierra un problema existente en el proyecto determinado.

Cuando se cierra un problema (V2)

Esta operación se desencadena cuando se cierra un problema existente en el proyecto determinado.

Cuando se crea un nuevo problema (centro de datos)

Esta operación se desencadena cuando se agrega un nuevo problema al proyecto determinado.

Cuando se crea un problema nuevo

Esta operación se desencadena cuando se agrega un nuevo problema al proyecto determinado.

Cuando se crea un problema nuevo (V2)

Esta operación se desencadena cuando se agrega un nuevo problema al proyecto determinado.

Cuando se devuelve un nuevo problema mediante una consulta JQL (V2)

Esta operación se desencadena cuando aparece un nuevo problema en los últimos 100 resultados de una consulta JQL.

Cuando se devuelve un problema nuevo mediante una consulta JQL (Centro de datos)

Esta operación se desencadena cuando aparece un nuevo problema en los últimos 100 resultados de una consulta JQL.

Cuando una consulta JQL devuelve un nuevo problema

Esta operación se desencadena cuando aparece un nuevo problema en los últimos 100 resultados de una consulta JQL.

Cuando se cierra un problema

Esta operación se desencadena cuando se cierra un problema existente en el proyecto determinado.

Parámetros

Nombre Clave Requerido Tipo Description
Proyecto
projectKey True string

Clave única del proyecto para buscar nuevos problemas.

Devoluciones

Cuestión
FullIssue

Cuando se cierra un problema (centro de datos)

Esta operación se desencadena cuando se cierra un problema existente en el proyecto determinado.

Parámetros

Nombre Clave Requerido Tipo Description
Instancia de Jira
X-Request-Jirainstance string

Dirección URL donde se hospeda la instancia de Jira (debe admitir https).

Proyecto
projectKey True string

Clave única del proyecto para buscar nuevos problemas.

Devoluciones

Cuestión
FullIssue

Cuando se cierra un problema (V2)

Esta operación se desencadena cuando se cierra un problema existente en el proyecto determinado.

Parámetros

Nombre Clave Requerido Tipo Description
Instancia de Jira
X-Request-Jirainstance string

Dirección URL donde se hospeda la instancia de Jira (debe admitir https).

Proyecto
projectKey True string

Clave única del proyecto para buscar nuevos problemas.

Devoluciones

Cuestión
FullIssue

Cuando se crea un nuevo problema (centro de datos)

Esta operación se desencadena cuando se agrega un nuevo problema al proyecto determinado.

Parámetros

Nombre Clave Requerido Tipo Description
Instancia de Jira
X-Request-Jirainstance string

Dirección URL donde se hospeda la instancia de Jira (debe admitir https).

Proyecto
projectKey True string

Clave única del proyecto para buscar nuevos problemas.

Devoluciones

Cuestión
FullIssue

Cuando se crea un problema nuevo

Esta operación se desencadena cuando se agrega un nuevo problema al proyecto determinado.

Parámetros

Nombre Clave Requerido Tipo Description
Proyecto
projectKey True string

Clave única del proyecto para buscar nuevos problemas.

Devoluciones

Cuestión
FullIssue

Cuando se crea un problema nuevo (V2)

Esta operación se desencadena cuando se agrega un nuevo problema al proyecto determinado.

Parámetros

Nombre Clave Requerido Tipo Description
Instancia de Jira
X-Request-Jirainstance string

Dirección URL donde se hospeda la instancia de Jira (debe admitir https).

Proyecto
projectKey True string

Clave única del proyecto para buscar nuevos problemas.

Devoluciones

Cuestión
FullIssue

Cuando se devuelve un nuevo problema mediante una consulta JQL (V2)

Esta operación se desencadena cuando aparece un nuevo problema en los últimos 100 resultados de una consulta JQL.

Parámetros

Nombre Clave Requerido Tipo Description
Instancia de Jira
X-Request-Jirainstance string

Dirección URL donde se hospeda la instancia de Jira (debe admitir https).

Consulta JQL
jql True string

Consulta que se va a usar.

Devoluciones

Cuestión
FullIssue

Cuando se devuelve un problema nuevo mediante una consulta JQL (Centro de datos)

Esta operación se desencadena cuando aparece un nuevo problema en los últimos 100 resultados de una consulta JQL.

Parámetros

Nombre Clave Requerido Tipo Description
Instancia de Jira
X-Request-Jirainstance string

Dirección URL donde se hospeda la instancia de Jira (debe admitir https).

Consulta JQL
jql True string

Consulta que se va a usar.

Devoluciones

Cuestión
FullIssue

Cuando una consulta JQL devuelve un nuevo problema

Esta operación se desencadena cuando aparece un nuevo problema en los últimos 100 resultados de una consulta JQL.

Parámetros

Nombre Clave Requerido Tipo Description
Consulta JQL
jql True string

Consulta que se va a usar.

Devoluciones

Cuestión
FullIssue

Definiciones

CreateProjectResponse

Nombre Ruta de acceso Tipo Description
Identificación del proyecto
id integer

Identificador único del proyecto.

Clave de proyecto
key string

Clave única del proyecto.

CreateIssueResponse

Nombre Ruta de acceso Tipo Description
Identificador de problema
id string

Identificador único del problema.

Clave de problema
key string

Clave única del problema.

ListProjects_ResponseV2

Nombre Ruta de acceso Tipo Description
values
values ProjectArray

ProjectArray

Nombre Ruta de acceso Tipo Description
Identificación del proyecto
id string

Identificador único del proyecto.

Clave de proyecto
key string

Clave única del proyecto.

Nombre del proyecto
name string

Nombre del proyecto.

Clave de tipo de proyecto
projectTypeKey string

Clave única del tipo de proyecto.

FullIssue

Nombre Ruta de acceso Tipo Description
Identificador de problema
id string

Identificador único del problema.

Clave de problema
key string

Clave única del problema.

Dirección URL del problema
self string

Vaya al problema mediante esta dirección URL.

Identificador de tipo de problema
fields.issuetype.id string

Identificador único del tipo de problema.

Descripción del tipo de problema
fields.issuetype.description string

Título detallado del tipo de problema.

Dirección URL del icono de tipo de problema
fields.issuetype.iconUrl string

Icono asociado al tipo de problema.

Nombre del tipo de problema
fields.issuetype.name string

Título del tipo de problema.

Tiempo invertido
fields.timespent integer

El tiempo invertido en un problema

Identificación del proyecto
fields.project.id string

Identificador único del proyecto.

Clave de proyecto
fields.project.key string

Clave única del proyecto.

Nombre del proyecto
fields.project.name string

Título del proyecto.

Clave de tipo de proyecto
fields.project.projectTypeKey string

Clave única del tipo de proyecto.

Tiempo agregado invertido
fields.aggregatetimespent integer

Tiempo agregado invertido en subtareas.

Dirección URL de la resolución de problemas
fields.resolution.self string
Identificador de la resolución de problemas
fields.resolution.id string
Descripción de la resolución de problemas
fields.resolution.description string
Nombre para la resolución de problemas
fields.resolution.name string
Fecha de resolución
fields.resolutiondate date-time

aaaa-MM-ddTHH:mm:ss.fffZ

Relación de trabajo
fields.workratio integer

Porcentaje de trabajo registrado frente a la estimación del problema.

Fecha de creación
fields.created date-time

aaaa-MM-ddTHH:mm:ss.fffZ

Dirección URL del icono de prioridad
fields.priority.iconUrl string

Icono asociado a la prioridad del problema.

Nombre de prioridad
fields.priority.name string

Título de la prioridad.

Id. de prioridad
fields.priority.id string

Identificador de la prioridad del problema.

Estimación de tiempo
fields.timeestimate integer

Tiempo restante estimado en segundos.

Estimación de tiempo agregado
fields.aggregatetimeoriginalestimate integer

La suma original de todas las estimaciones de tiempo de la subtarea en segundos.

Id. de asignado
fields.assignee.accountId string

Persona a la que se asigna un problema.

Clave asignada
fields.assignee.key string

Se asigna la clave de usuario del problema de persona.

Correo electrónico asignado
fields.assignee.emailAddress string

Se asigna el correo electrónico del problema de persona.

Nombre para mostrar del receptor
fields.assignee.displayName string

Se asigna el nombre para mostrar del problema de persona.

Date-Time actualizado
fields.updated date-time

aaaa-MM-ddTHH:mm:ss.fffZ

Descripción del estado
fields.status.description string

Estado del problema.

Dirección URL del icono de estado
fields.status.iconUrl string

Estado del problema.

Nombre del estado
fields.status.name string

Estado del problema.

Id. de estado
fields.status.id string

Estado del problema.

Identificador de categoría de estado
fields.status.statusCategory.id integer

Categoría de estado del problema.

Clave de categoría de estado
fields.status.statusCategory.key string

Categoría de estado del problema.

Nombre de color de categoría de estado
fields.status.statusCategory.colorName string

Categoría de estado del problema.

Nombre de categoría de estado
fields.status.statusCategory.name string

Categoría de estado del problema.

Estimación de hora original
fields.timeoriginalestimate integer

La estimación de tiempo original en segundos.

Description
fields.description string

Descripción del problema.

Estimación de tiempo agregado
fields.aggregatetimeestimate integer

Suma de tiempo de todas las subtareas restantes en segundos.

Resumen
fields.summary string

Título del problema.

Components
fields.components array of object

Campo del sistema que es varios valores dirigidos por "name" (por ejemplo, Microsoft Entra ID, Network Switch).

Id. de componente
fields.components.id string
Nombre del componente
fields.components.name string
Id. de creador
fields.creator.accountId string

Usuario que creó el problema.

Clave de creador
fields.creator.key string

Clave única del usuario que creó el problema.

Correo electrónico del creador
fields.creator.emailAddress string

Correo electrónico del usuario que creó el problema.

Nombre para mostrar del creador
fields.creator.displayName string

Nombre del usuario que creó el problema.

Id. del periodista
fields.reporter.accountId string

Usuario que informó del problema.

Clave de reportera
fields.reporter.key string

Clave única del usuario que informó del problema.

Correo electrónico del periodista
fields.reporter.emailAddress string

Correo electrónico del usuario que informó del problema.

Nombre para mostrar del periodista
fields.reporter.displayName string

Nombre para mostrar del usuario que informó del problema.

Progreso agregado completado
fields.aggregateprogress.progress integer

Progreso total completado de todas las subtareas en segundos.

Esfuerzo estimado agregado
fields.aggregateprogress.total integer

Suma total de todos los esfuerzos de subtarea estimados.

Porcentaje de progreso agregado
fields.aggregateprogress.percent integer

Porcentaje del progreso completado agregado en relación con el esfuerzo estimado.

Date-Time
fields.duedate date-time

aaaa-MM-ddTHH:mm:ss.fffZ

Progreso completado
fields.progress.progress integer

El progreso se completa en segundos.

Esfuerzo estimado
fields.progress.total integer

El esfuerzo estimado.

Porcentaje de progreso
fields.progress.percent integer

Porcentaje del progreso completado en relación con el esfuerzo estimado.

Nombre épico (customfield_10011)
fields.customfield_10119

El nombre épico es necesario para el tipo de problema épico. Este campo coincide con el campo "customfield_10011" en el servidor Jira.

UserList

Nombre Ruta de acceso Tipo Description
Id
accountId string

Identificador del miembro del proyecto.

Key
key string

Clave única asociada al usuario.

Correo Electrónico
emailAddress string

Email dirección del usuario.

Nombre de pantalla
displayName string

Nombre completo del usuario.

ListFiltersResponse

Nombre Ruta de acceso Tipo Description
values
values FilterArray

FilterArray

Nombre Ruta de acceso Tipo Description
Id
id string

Identificador del filtro.

Nombre
name string

Nombre del filtro.

JQL
jql string

jql usado en Filter.

ListIssuesResponse

Nombre Ruta de acceso Tipo Description
issues
issues array of FullIssue

ListIssuesResponseDatacenter

Nombre Ruta de acceso Tipo Description
issues
issues array of FullIssue

CommentResponse

Nombre Ruta de acceso Tipo Description
Id. de comentario
id string

Identificador único del comentario.

Cuerpo del comentario
body string

Cuerpo del comentario.

Date-Time creados
created date-time

aaaa-MM-ddTHH:mm:ss.fffZ

Sites

Nombre Ruta de acceso Tipo Description
id. de nube
id string

Identificador de instancia de Jira

Nombre del sitio
name string
Dirección URL del sitio
url string

Transition

Nombre Ruta de acceso Tipo Description
id
id string

Identificador de la transición

nombre
name string

Nombre de la transición

to
to TransitionStatus
fields
fields object

Campos necesarios para esta transición

TransitionStatus

Nombre Ruta de acceso Tipo Description
id
id string

Identificador del estado

nombre
name string

Nombre del estado

MCPQueryResponse

Nombre Ruta de acceso Tipo Description
jsonrpc
jsonrpc string
id
id string
method
method string
parámetros
params object
resultado
result object
error
error object