Utility functions
You can use utility functions to compose the remote action payload templates.
Syntax
There are two different syntactical notations to refer to functions:
Shorthand notation
The shorthand notation is $util.function() – using this shorter notation is usually preferable for brevity, and also required within the Automate with AWS post function.
Formal notation
The formal notation is ${util.function()} – using this longer notation is optional in general, but not supported within the Automate with AWS post function.
Functions
The currently available functions in the $util namespace are:
Actions
You can use utility functions in the following actions:
-
Using the Automate with AWS notification recipient in Bamboo — Use the Automate with AWS notification recipient to run remote actions with AWS from Bamboo notifications, specifically from plan level and system level notifications.
-
Using the Automate with AWS post function in Jira — Use the Automate with AWS post function to run remote actions with AWS from Jira workflow post functions.
-
Using the Automate with AWS task in Bamboo — Use the Automate with AWS task to run remote actions with AWS from Bamboo jobs, specifically from builds and deployments.
-
Using the Automate with AWS then action in Jira Service Management — Use the Automate with AWS then action to run remote actions with AWS from Jira Service Management automation rules.
-
Using the Get Systems Manager Parameter action — Use the Get Systems Manager Parameter action to evaluate remote conditions so that you can control Jira Service Management automation rules via the Automate with AWS if condition, control Jira workflow transitions via the Automate with AWS workflow condition and Automate with AWS workflow validator, and fail or succeed Bamboo builds and deployments via the Automate with AWS task. You can also use this action to inject remote configuration data and secrets stored as secure parameters in the AWS Systems Manager Parameter Store, or stored as secrets within AWS Secrets Manager.
-
Using the Invoke Lambda Function action — Use the Invoke Lambda Function action to process Bamboo tasks and notifications, Jira workflow transitions and Jira Service Management automation rule executions with AWS Lambda, which lets you run code without provisioning or managing servers:
-
Using the Publish SNS Message action — Use the Publish SNS Message action to relay Bamboo tasks and notifications, Jira workflow transitions and Jira Service Management automation rule executions via the Amazon Simple Notification Service (SNS), a fast, flexible, fully managed push notification service that lets you send individual messages or to fan-out messages to large numbers of recipients:
-
Using the Put EventBridge/CloudWatch Events action — Use the Put EventBridge/CloudWatch Events action to process Jira workflow transitions, Jira Service Management automation rule executions, and Bamboo tasks and notifications with Amazon EventBridge (Amazon CloudWatch Events) to connect application data from your own apps, SaaS, and AWS services:
-
Using the Put Systems Manager Parameter action — Use the Put Systems Manager Parameter action to persist event data from Bamboo tasks and notifications, Jira workflow transitions and Jira Service Management automation rule executions into the AWS Systems Manager Parameter Store that you can then consume in subsequent automation workflows. This allows you to decouple the capturing of secrets and configuration data from Jira Service Management request approvals, Jira issue edits or Bamboo plan executions from the decision to trigger subsequent automation by one or more target services:
-
Using the Send SQS Message action — Use the Send SQS Message action to relay Bamboo tasks and notifications, Jira workflow transitions and Jira Service Management automation rule executions via the Amazon Simple Queue (SQS), a fully managed message queuing service that enables you to decouple and scale microservices, distributed systems, and serverless applications:
-
Using the Start Step Functions Execution action — Use the Start Step Functions Execution action to process Bamboo tasks and notifications, Jira workflow transitions and Jira Service Management automation rule executions with AWS Step Functions to coordinate multiple AWS services into serverless workflows so you can build and update apps quickly:
-
Using the Start Systems Manager Automation Execution action — Use the Start Systems Manager Automation Execution action from Bamboo tasks and notifications, Jira workflow transitions and Jira Service Management automation rule executions to simplify common maintenance and deployment tasks of Amazon EC2 instances and other AWS resources via AWS Systems Manager Automation. Automation enables you to do the following.:
How-to Articles