Se usó la API de Cloud Translation para traducir esta página.

Jira Cloud

El conector de Jira Cloud te permite realizar operaciones de inserción, eliminación, actualización y lectura en los datos de Jira, que se modelan como una base de datos.

Versiones compatibles

El conector de Jira Cloud usa las versiones 2 y 3 de la API de REST de Jira Cloud. Se administran de forma interna y no tienes que realizar ninguna configuración adicional.

Antes de comenzar

Antes de usar el conector de Jira Cloud, realiza las siguientes tareas:

En tu proyecto de Google Cloud, haz lo siguiente:
- Asegúrate de que la conectividad de red esté configurada. Para obtener información sobre los patrones de red, consulta Conectividad de red.
- Otorga el rol de IAM roles/connectors.admin al usuario que configura el conector.
- Otorga los siguientes roles de IAM a la cuenta de servicio que deseas usar para el conector:
  - roles/secretmanager.viewer
  - roles/secretmanager.secretAccessor
  Una cuenta de servicio es un tipo de Cuenta de Google especial que representa a un usuario no humano que debe autenticarse y tener autorización para acceder a los datos de las APIs de Google. Si no tienes una cuenta de servicio, debes crear una. Para obtener más información, consulta Crea una cuenta de servicio.
- Habilita los siguientes servicios:
  - secretmanager.googleapis.com (API de Secret Manager)
  - connectors.googleapis.com (API de conectores)
  Para comprender cómo habilitar servicios, consulta Habilita servicios.
Si estos servicios o permisos no se habilitaron antes para tu proyecto, se te solicitará que los habilites cuando configures el conector.

Configura el conector

Una conexión es específica de una fuente de datos. Significa que, si tienes muchas fuentes de datos, debes crear una conexión independiente para cada fuente. Para crear una conexión, haz lo siguiente:

En la consola de Cloud, ve a la página Conectores de Integration > Conexiones y, luego, selecciona o crea un proyecto de Google Cloud.
Ir a la página Conexiones
Haz clic en + CREAR NUEVO para abrir la página Crear conexión.
En la sección Ubicación, elige la ubicación para la conexión.
1. Región: selecciona una ubicación de la lista desplegable.
  Para obtener la lista de todas las regiones compatibles, consulta Ubicaciones.
2. Haz clic en SIGUIENTE.
En la sección Detalles de la conexión, completa lo siguiente:
1. Conector: selecciona Jira Cloud en la lista desplegable de conectores disponibles.
2. Versión del conector: selecciona la versión del conector de la lista desplegable de versiones disponibles.
3. En el campo Nombre de la conexión, ingresa un nombre para la instancia de conexión.
  Los nombres de las conexiones deben cumplir con los siguientes criterios:
  - Los nombres de las conexiones pueden usar letras, números o guiones.
  - Las letras deben estar en minúsculas.
  - Los nombres de las conexiones deben comenzar con una letra y terminar con una letra o un número.
  - Los nombres de las conexiones no pueden superar los 49 caracteres.
  - En el caso de los conectores que admiten la suscripción a eventos, los nombres de las conexiones no pueden comenzar con el prefijo "goog".
4. De manera opcional, ingresa una Descripción para la instancia de conexión.
5. De manera opcional, habilita Cloud Logging y, luego, selecciona un nivel de registro. De forma predeterminada, el nivel de registro se establece en Error.
6. Cuenta de servicio: Selecciona una cuenta de servicio que tenga los roles necesarios.
7. Para usar la conexión en las suscripciones a eventos, selecciona Habilitar suscripción a eventos. Si seleccionas esta opción, se mostrarán las siguientes opciones:
  - Habilitar la suscripción al evento con entidades y acciones: Selecciona esta opción para usar la conexión tanto para la suscripción al evento como para las operaciones del conector (entidades y acciones).
  - Habilitar solo la suscripción a eventos: Selecciona esta opción para usar la conexión solo para la suscripción a eventos. Si seleccionas esta opción, haz clic en Siguiente y, luego, configura la suscripción a eventos.
8. De manera opcional, configura los parámetros de nodo de conexión:
  - Cantidad mínima de nodos: Ingresa la cantidad mínima de nodos de conexión.
  - Cantidad máxima de nodos: Ingresa la cantidad máxima de nodos de conexión.
  Un nodo es una unidad (o réplica) de una conexión que procesa transacciones. Se requieren más nodos para procesar más transacciones para una conexión y, del mismo modo, se requieren menos para procesar menos transacciones. Para comprender cómo los nodos afectan el precio del conector, consulta Precios de nodos de conexión. Si no ingresas ningún valor, se establecen de forma predeterminada los nodos mínimos en 2 (para una mejor disponibilidad) y los nodos máximos se establecen en 50.
9. (Opcional) En la sección Configuración avanzada, selecciona la casilla de verificación Usar proxy para configurar un servidor proxy para la conexión y establecer los siguientes valores:
10. De forma opcional, haz clic en + AGREGAR ETIQUETA para agregar una etiqueta a la conexión en forma de un par clave-valor.
11. Haga clic en SIGUIENTE.
En la sección Destinos, ingresa los detalles del host remoto (sistema de backend) al que deseas conectarte.
1. Tipo de destino: Selecciona un Tipo de destino.
  - Dirección del host: Especifica el nombre de host o la dirección IP del destino.
    Nota: Si especificas un nombre de host, debes especificar la URL junto con el protocolo (HTTP o HTTPS).
    
    Si deseas establecer una conexión privada a tu backend, haz lo siguiente:
    - Crea un adjunto de servicio de PSC.
    - Crea un adjunto de extremo y, luego, ingresa los detalles del adjunto del extremo en el campo Dirección del host.
  Para ingresar destinos adicionales, haz clic en +AGREGAR DESTINO.
2. Haga clic en SIGUIENTE.
En la sección Autenticación, ingresa los detalles de autenticación.
1. Selecciona un Tipo de autenticación y, luego, ingresa los detalles relevantes.
  Las conexiones de Jira Cloud admiten los siguientes tipos de autenticación:
  - Nombre de usuario y contraseña
2. Haz clic en SIGUIENTE.
Si habilitaste la suscripción a eventos, aparecerá la sección Event Subscription Details en la página de creación de la conexión. Para comprender cómo configurar los detalles de la suscripción a eventos, consulta Cómo configurar la suscripción a eventos.
Revisa: Revisa tus detalles de conexión y autenticación.
Haz clic en Crear.

Configura la suscripción a eventos

Si habilitaste la suscripción a eventos, ingresa los siguientes valores en la sección Detalles de la suscripción a eventos:

Selecciona un Tipo de destino.
- Dirección de host: Ingresa la URL de registro de tu sistema de backend en el campo host.
Ingresa los detalles de autenticación.
1. Nombre de usuario: Ingresa el nombre de usuario.
2. Token de API: Selecciona el Secret de Secret Manager que contiene el token de API.
3. Versión del secreto: Selecciona la versión del secreto.
Selecciona Habilitar conectividad privada para establecer una conectividad segura entre tu aplicación de backend y tu conexión. Si seleccionas esta opción, debes realizar pasos de configuración adicionales después de crear la conexión. Para obtener más información, consulta Conectividad privada para la suscripción a eventos.
Ingresa la configuración de mensajes no entregados. Si configuras mensajes no entregados, la conexión escribe los eventos sin procesar en el tema de Pub/Sub especificado. Ingresa los siguientes detalles:
1. ID del proyecto de mensajes no entregados: Es el ID del proyecto de Google Cloud en el que configuraste el tema de Pub/Sub de mensajes no entregados.
2. Tema de mensajes no entregados: Es el tema de Pub/Sub en el que deseas escribir los detalles del evento no procesado.
Si deseas usar un proxy para conectarte a tu backend (para la suscripción a eventos), ingresa los siguientes detalles:

Tipo de SSL del proxy: el tipo de SSL que se usará para conectarse al servidor del proxy. Selecciona cualquiera de los siguientes tipos de autenticación:
- Siempre: La conexión siempre está habilitada para SSL en la suscripción a eventos.
- Nunca: La conexión no está habilitada para SSL en la suscripción a eventos.
Esquema de autenticación del proxy: Selecciona el tipo de autenticación para autenticar con el servidor proxy. Se admiten los siguientes tipos de autenticación:
- Básico: Autenticación HTTP básica.
Usuario de proxy: Ingresa el nombre de usuario que se usará para autenticarse con el servidor proxy.
Contraseña de proxy: Selecciona el secreto de Secret Manager de la contraseña del usuario.
Versión del secreto: Selecciona la versión del secreto.
En la sección Proxy Server, ingresa los detalles del servidor proxy.
1. Haz clic en + Agregar destino y, luego, selecciona Dirección de host como el Tipo de destino.
2. Ingresa el nombre de host o la dirección IP del servidor proxy, y el número de puerto del servidor proxy.

Configura la autenticación

Ingresa los detalles según la autenticación que desees usar.

Nombre de usuario y contraseña
- Nombre de usuario: el nombre de usuario de Jira Cloud que se usa para la conexión.
- Token de API: La contraseña del nombre de usuario será un token de API. Selecciona el Secret de Secret Manager que contiene el token de API asociado con el nombre de usuario de Jira Cloud.
Código de autorización de OAuth 2.0

ID de cliente: Es el ID de cliente que proporciona tu aplicación externa.
Permiso: Alcance del permiso. Los permisos offline_access y read:jira-user son obligatorios para crear una conexión. Para comprender cómo funcionan los permisos y ver todos los permisos disponibles de Jira Cloud, consulta Permisos.
Secreto del cliente: Selecciona el secreto de Secret Manager. Debes crear el secreto de Secret Manager antes de configurar esta autorización.
Versión del secreto: La versión del secreto de Secret Manager para el secreto del cliente.
ID de Cloud: Especifica el ID de Cloud del sitio de Atlassian. Para obtener información sobre cómo obtener el ID de Cloud, consulta ID de Cloud.

Para el tipo de autenticación Authorization code, después de crear la conexión, debes realizar algunos pasos adicionales a fin de configurar la autenticación. Para obtener más información, consulta Pasos adicionales después de la creación de la conexión.

Nota: Si usas el tipo de autenticación Authorization code y realizaste cambios de configuración en tu aplicación de Jira Cloud, debes volver a autorizar tu conexión de Jira Cloud. Para comprender cómo volver a autorizar, consulta la página sobre cómo volver a autorizar el código de autorización.

Pasos adicionales después de la creación de la conexión

Si seleccionaste OAuth 2.0 - Authorization code para la autenticación, debes seguir estos pasos adicionales después de crear la conexión:

En la página Connections, busca la conexión recién creada.
Observa que el Estado del conector nuevo será Se requiere autorización.
Haz clic en Se requiere autorización.
Se mostrará el panel Editar autorización.
Copia el valor del URI de redireccionamiento en tu aplicación externa.
Verifica los detalles de la autorización.
Haz clic en Autorizar.
Si la autorización se realiza correctamente, el estado de la conexión se establecerá como Activa en la página Conexiones.

Cómo volver a autorizar el código de autorización

Si usas el tipo de autenticación Authorization code y realizaste cambios de configuración en tu aplicación de Jira Cloud, debes volver a autorizar tu conexión de Jira Cloud. Para volver a autorizar una conexión, sigue estos pasos:

Haz clic en la conexión requerida en la página Conexiones.
Se abrirá la página de detalles de la conexión.
Haz clic en Editar para editar los detalles de la conexión.
Verifica los detalles de OAuth 2.0 - Código de autorización en la sección Autenticación.
Si es necesario, realiza los cambios necesarios.
Haz clic en Guardar. Esto te llevará a la página de detalles de la conexión.
Haz clic en Editar autorización en la sección Autenticación. Se mostrará el panel Autorizar.
Haz clic en Autorizar.
Si la autorización se realiza correctamente, el estado de la conexión se establecerá en Activa en la página Conexiones.

Limitaciones del sistema

El conector de Jira Cloud puede procesar un máximo de 10 transacciones por segundo, por nodo, y limita las transacciones que superen este límite. De forma predeterminada, Integration Connectors asigna 2 nodos (para una mejor disponibilidad) a una conexión.

Para obtener información sobre los límites aplicables a Integration Connectors, consulta Límites.

Nota: La cantidad de nodos de Integration Connectors se ajustará automáticamente según tu uso. Sin embargo, si deseas reservar capacidad para grandes volúmenes sin esperar el ajuste de escala automático, puedes ajustar el valor mínimo de nodos para una conexión. Se requieren más nodos para procesar más transacciones para una conexión. Por el contrario, se requieren menos nodos si una conexión procesa menos transacciones. Para configurar los valores del nodo, haz lo siguiente:

Si eres cliente de pago por uso, configura el valor mínimo y máximo del nodo en la página de edición de la conexión.
Si eres cliente de un plan de suscripción, comunícate con el equipo de asistencia.

La cantidad máxima de transacciones que puede controlar un nodo depende de varios factores. Por lo tanto, antes de ajustar la cantidad mínima de nodos para mejorar el rendimiento, te recomendamos que verifiques si tus sistemas de backend están configurados de manera óptima para controlar el tráfico requerido.

Ejemplos de operaciones de entidades

En esta sección, se muestra cómo realizar algunas de las operaciones de entidades en este conector.

Ejemplo: Problemas con la lista

En el cuadro de diálogo Configure connector task, haz clic en Entities.
Selecciona Problemas en la lista Entity.
Selecciona la operación LIST y haz clic en Listo.
En la sección Entrada de tarea de la tarea Connectors, puedes establecer la filterClause según los requisitos del cliente.

Debes usar comillas simples ("'") para incluir el valor de un filterClause, por ejemplo, CreatorEmail = "cruz@altostrat.com". Puedes usar filterClause para filtrar registros según las columnas.

En algunas entidades, solo la operación List no puede recuperar datos. En esas entidades, puedes usar filetClause.

Ejemplo: Obtener problemas

En el cuadro de diálogo Configure connector task, haz clic en Entities.
Selecciona Problemas en la lista Entity.
Selecciona la operación GET y haz clic en Listo.
Configura el ID de la entidad en 10000, que es el ID de la clave que se pasará para los problemas. Para establecer el ID de la entidad, en la sección Task Input de la tarea Connectors, haz clic en EntityId y, luego, ingresa 10000 en el campo Valor predeterminado.

El valor del ID de entidad debe pasarse directamente, por ejemplo, 10000. Aquí, 10000 es el valor único de la clave primaria. La operación Get solo se puede realizar en entidades con clave primaria única.

Ejemplo: Borrar problemas

En el cuadro de diálogo Configure connector task, haz clic en Entities.
Selecciona Problemas en la lista Entity.
Selecciona la operación DELETE y haz clic en Listo.
Establece el ID de la entidad en 10000, que es la clave que se pasará. Para establecer el ID de la entidad, en la sección Task Input de la tarea Connectors, haz clic en EntityId y, luego, ingresa 10000 en el campo Valor predeterminado.

La operación de eliminación solo se puede realizar en entidades con clave primaria única.

Ejemplo: Crea IssueTypes

En el cuadro de diálogo Configure connector task, haz clic en Entities.
Selecciona IssueTypes en la lista Entity.
Selecciona la operación Create y haz clic en Listo.
En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:
```
{
  "Name": "task123456",
  "Description": "New description is added."
}
```
Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:
```
{
  "Id": "10041"
}
```

Ejemplo: Crea problemas

En el cuadro de diálogo Configure connector task, haz clic en Entities.
Selecciona Problemas en la lista Entity.
Selecciona la operación Create y haz clic en Listo.
En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:
```
  {
    "IssueTypeName": "Subtask", 
    "ProjectName": "kanban4", 
    "Summary": "Summary Added", 
    "ParentKey": "KN-6" 
  }
```
Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:
```
{
  "Id": 10071.0
}
```

Ejemplo: Crea sprints

En el cuadro de diálogo Configure connector task, haz clic en Entities.
Selecciona Sprints en la lista Entity.
Selecciona la operación Create y haz clic en Listo.
En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:
```
{
  "Name": "PROJ Sprint GCPcloud",
  "State": "future",
  "Goal": null,
  "OriginBoardId": 2.0,
  "StartDate": "2023-06-27 07:06:08",
  "EndDate": "2023-07-27 07:06:08"
}
```
Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:
```
{
  "Id": 23.0
}
```

Ejemplo: Crea comentarios

En el cuadro de diálogo Configure connector task, haz clic en Entities.
Selecciona Comentarios en la lista Entity.
Selecciona la operación Create y haz clic en Listo.
En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:
```
{
  "IssueId": 10001.0,
  "Body": "Adding comments to above ID by editing it"
}
```
Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:
```
{
  "Id": 10023.0,
  "IssueId": null
}
```

Ejemplo: Crear usuarios

En el cuadro de diálogo Configure connector task, haz clic en Entities.
Selecciona Usuarios en la lista Entity.
Selecciona la operación Create y haz clic en Listo.
En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:
```
{
  "GroupName": null,
  "DisplayName": "Charlie",
  "EmailAddress": "charlie@altostrat.com",
  "Active": true,
  "TimeZone": null,
  "Locale": "en_US",
  "AccountType": "atlassian"
}
```
Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea de conectores tendrá un valor similar al siguiente:
```
{
  "AccountId": "557058:0a04612c-746d-4d47-a909-71ba797fe228"
}
```

Ejemplo: Crea registros de trabajo

En el cuadro de diálogo Configure connector task, haz clic en Entities.
Selecciona Registros de trabajo en la lista Entity.
Selecciona la operación Create y haz clic en Listo.
En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:
```
{
  "IssueKey": "GJCT-1",
  "Started": "2023-06-10 08:08:08",
  "TimeSpent": "2000"
}
```
Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:
```
{
  "Id": "41718",
  "IssueId": 10000.0
}
```

Ejemplo: Actualiza IssueTypes

En el cuadro de diálogo Configure connector task, haz clic en Entities.
Selecciona IssueTypes en la lista Entity.
Selecciona la operación Update y haz clic en Listo.
En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:
```
{
  "Name": "NEW_TASK",
  "Description": "New Description"
}
```
Configura el ID de la entidad en la entidad de IssueTypes. Para establecer el ID de la entidad, haz clic en entityId y, luego, ingresa 10038 en el campo Valor predeterminado.
Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:
```
{
  "Id": "10038"
}
```

Ejemplo: Problemas con la actualización

En el cuadro de diálogo Configure connector task, haz clic en Entities.
Selecciona Problemas en la lista Entity.
Selecciona la operación Update y haz clic en Listo.
En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:
```
{
  "AssigneeAccountId": "61d572aa7c6f9800705289a1",
  "AssigneeName": "Charlie c"
}
```
Establece el ID de la entidad en la entidad de los problemas. Para establecer el ID de la entidad, haz clic en entityId y, luego, ingresa 10024 en el campo Valor predeterminado.
Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:
```
{
  "AssigneeDisplayName": "Charlie Cruz"
}
```

Ejemplo: Actualización de sprints

En el cuadro de diálogo Configure connector task, haz clic en Entities.
Selecciona Sprints en la lista Entity.
Selecciona la operación Update y haz clic en Listo.
En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:
```
{
  "Name": "PROJ Sprint GCP_Updated",
  "State": "future",
  "StartDate": "2023-06-27 07:06:08",
  "EndDate": "2023-07-27 07:06:08"
} 
```
Establece el ID de la entidad en la entidad de los sprints. Para establecer el ID de la entidad, haz clic en entityId y, luego, ingresa 2 en el campo Valor predeterminado.
Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:
```
{
}
```

Ejemplo: Actualizar comentarios

En el cuadro de diálogo Configure connector task, haz clic en Entities.
Selecciona Comentarios en la lista Entity.
Selecciona la operación Update y haz clic en Listo.
En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:
```
{
  "Name": "PROJ Sprint GCPcloud_Updated",
  "State": "future",
  "StartDate": "2023-06-27 07:06:08",
  "EndDate": "2023-07-27 07:06:08"
} 
```
Establece el ID de la entidad en la entidad de los comentarios. Para establecer el ID de la entidad, haz clic en entityId y, luego, ingresa 2 en el campo Valor predeterminado.
Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:
```
{
}
```

Crea conexiones con Terraform

Puedes usar el recurso de Terraform para crear una conexión nueva.

Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de Terraform.

Para ver una plantilla de Terraform de ejemplo para la creación de conexiones, consulta la plantilla de ejemplo.

Cuando crees esta conexión con Terraform, debes establecer las siguientes variables en tu archivo de configuración de Terraform:

Nombre del parámetro	Tipo de datos	Obligatorio	Descripción
proxy_enabled	BOOLEAN	Falso	Selecciona esta casilla de verificación para configurar un servidor proxy para la conexión.
proxy_auth_scheme	ENUM	Falso	Tipo de autenticación que se usará para autenticarse en el proxy de ProxyServer. Los valores admitidos son BASIC, DIGEST y NONE.
proxy_user	STRING	Falso	Nombre de usuario que se usará para autenticarse en el proxy de ProxyServer.
proxy_password	SECRET	Falso	Contraseña que se usará para la autenticación en el proxy de ProxyServer.
proxy_ssltype	ENUM	Falso	Es el tipo de SSL que se usará para conectarse al proxy de ProxyServer. Los valores admitidos son AUTO, ALWAYS, NEVER y TUNNEL.

Usa la conexión de Jira Cloud en una integración

Después de crear la conexión, estará disponible en la integración de Apigee y en Application Integration. Puedes usar la conexión en una integración a través de la tarea Connectors.

Para comprender cómo crear y usar la tarea Connectors en Apigee Integration, consulta Tarea Connectors.
Para comprender cómo crear y usar la tarea Connectors en Application Integration, consulta Tarea Connectors.

Obtén ayuda de la Comunidad de Google Cloud

Puedes publicar tus preguntas y debatir sobre este conector en la comunidad de Google Cloud en Cloud Forums.

¿Qué sigue?

Obtén información para suspender y reanudar una conexión.
Obtén información para supervisar el uso del conector.
Comprende cómo ver los registros del conector.