Actualizar una incidencia de Jira

Actualiza una incidencia de Jira existente.

Para la configuración de la autenticación, consulte las acciones de incidencias de Jira.

Aporte	Tipo	Descripción	Ejemplo
authToken	Cadena	Requerido. Cadena de `email:API_Token` codificada en Base64 para la autenticación básica. Se debe proporcionar como un secreto. Consulte Crear y administrar tokens de API .	`"${{ :secrets:jiraAuthToken }}"`
dominio	Cadena	Requerido. El dominio de la instancia de Jira Cloud (nombre de la empresa). Se utiliza para construir la URL base `your-domain.atlassian.net` .	`"mycompany"`
issueKey	Cadena	Requerido. La clave de la incidencia de Jira que se actualizará.	`"PROJ-123"`
parámetro	Mapa	Opcional. Parámetros de consulta de URL opcionales para la solicitud de la API de Jira. Consulte la tabla de referencia de parámetros a continuación.	`{"notifyUsers": "false", "returnIssue": "true", "expand": "changelog,renderedFields"}`
campos	Mapa	Opcional. Un mapa de los campos de la pantalla de incidencias para actualizar, especificando el subcampo y su valor. Use esto para actualizaciones sencillas de un solo subcampo. Los campos incluidos aquí no se pueden incluir también en `update` . Para obtener todos los campos con valores permitidos, use `GET /rest/api/3/issue/{issueKey}/editmeta` .	`{"priority": {"name": "High"}, "labels": ["bug", "production"]}`
actualizar	Mapa	Opcional. Un mapa de nombres de campos y una lista de operaciones para realizar en el campo de la pantalla de la incidencia. Utilice esto cuando se requieran varios subcampos u otras operaciones. Los campos incluidos aquí no se pueden incluir también en `fields` .	`{"labels": [{"add": "critical"}, {"remove": "minor"}], "components": [{"set": [{"name": "Backend"}]}]}`
selectors	Lista	Opcional. Una lista de expresiones con nombre para extraer valores específicos de la respuesta.	`[{"name": "summary", "expression": ".responseBody.result.summary"}]`

Referencia de parámetros

Parámetro	Tipo	Descripción	Por defecto
notifyUsers	Booleano	Si se envía un correo electrónico de notificación sobre la actualización del problema a todos los observadores. Para desactivar la notificación, se requieren los permisos Administrar Jira o Administrar proyecto . Si el usuario no tiene el permiso necesario, esto se ignora.	`true`
overrideScreenSecurity	Booleano	Si se anula la seguridad de la pantalla para permitir la edición de campos ocultos. Disponible para los usuarios de las aplicaciones Connect y Forge con el permiso global Administer Jira .	`false`
overrideEditableFlag	Booleano	Si se anula la seguridad de la pantalla para permitir que se editen los campos no editables. Disponible para los usuarios de las aplicaciones Connect y Forge con el permiso global Administer Jira .	`false`
returnIssue	Booleano	Si la respuesta debe contener el problema con los campos editados en esta solicitud, con el formato de la API Get issue.	`false`
expandir	Cadena	El parámetro expand de la API Get issue para usar en la respuesta si `returnIssue` es `true` .

Producción	Tipo	Ejemplo
response	Objeto	Una actualización exitosa devuelve un cuerpo vacío con el estado 204.
success	Booleano	`success: true \| false`
errorMessage	Cadena	`{ "errorMessages": ["Can not update issue with invalid data"], "errors": { "summary": "Summary is required" } }`

Ejemplo de flujo de trabajo
name: update-jira-issues description: 'Updates a ticket summary and adds a new label' steps: - name: set_summary type: action action: jira.issue.update version: 1 inputs: authToken: ${{ :secrets:jiraAuthToken }} domain: mycompany issueKey: "PROJ-123" fields: summary: "Updated: Critical production error resolved" description: type: "doc" version: 1 content: - type: "paragraph" content: - type: "text" text: "Root cause identified and fix deployed to production" update: labels: - add: "resolved" - add: "production" parameters: returnIssue: "true" next: end

Ejemplo de flujo de trabajo

name: update-jira-issues
description: 'Updates a ticket summary and adds a new label'
steps:
  - name: set_summary
    type: action
    action: jira.issue.update
    version: 1
    inputs:
      authToken: ${{ :secrets:jiraAuthToken }}
      domain: mycompany
      issueKey: "PROJ-123"
      fields:
        summary: "Updated: Critical production error resolved"
        description:
          type: "doc"
          version: 1
          content:
            - type: "paragraph"
              content:
                - type: "text"
                  text: "Root cause identified and fix deployed to production"
      update:
        labels:
          - add: "resolved"
          - add: "production"
      parameters:
        returnIssue: "true"
    next: end

Te ofrecemos esta traducción automática para facilitar la lectura.

Referencia de parámetros