View a markdown version of this page

AWS-CreateJiraIssue - AWS Systems Manager Automation Runbook Reference

AWS-CreateJiraIssue

Description

Create an issue in Jira.

Note

For better control and validation, we recommend cloning the AWS-CreateJiraIssue runbook to create your own private version. In your cloned runbook, add validation logic for the JiraURL parameter to ensure it matches your approved Jira instances before execution. Then use your cloned runbook in place of the AWS-managed one and restrict IAM permissions for executing AWS-CreateJiraIssue. This approach gives you more flexibility and ensures the parameter meets your organization's security and compliance requirements.

Run this Automation (console)

Document type

Automation

Owner

Amazon

Platforms

Linux, macOS, Windows

Parameters

  • AssigneeName

    Type: String

    Description: (Optional) The username of the person the issue should be assigned to.

  • DueDate

    Type: String

    Description: (Optional) The due date for the issue in yyyy-mm-dd format.

  • IssueDescription

    Type: String

    Description: (Required) A detailed description of the issue.

  • IssueSummary

    Type: String

    Description: (Required) A brief summary of the issue.

  • IssueTypeName

    Type: String

    Description: (Required) The name of the type of issue you want to create (for example, Task, Sub-task, Bug, etc.).

  • JiraURL

    Type: String

    Description: (Required) The url of the Jira instance.

  • JiraUsername

    Type: String

    Description: (Required) The name of the user the issue will be created with.

  • PriorityName

    Type: String

    Description: (Optional) The name of the priority of the issue.

  • ProjectKey

    Type: String

    Description: (Required) The key of the project the issue should be created in.

  • SSMParameterName

    Type: String

    Description: (Required) The name of an encrypted SSM Parameter containing the API key or password for the Jira user.

Document Steps

aws:createStack - Create CloudFormation stack to create Lambda IAM role and function.

aws:invokeLambdaFunction - Invoke Lambda function to create the Jira issue

aws:deleteStack - Delete the CloudFormation stack created.

Outputs

IssueId: ID of the newly created Jira issue