Jira Automation のアクション

Actions are the doers of your rule. They allow you to automate tasks and make changes within your site, and can perform many tasks, such as editing an issue, sending a notification, or creating sub-tasks.

See how to use all of these actions in our Jira automation template library.

課題の割り当て

  • Use smart values here: Yes

  • Required permissions: Assign issues, Assignable user

課題をユーザーに割り当てます。

課題の割り当てには以下の 8 個のオプションを使用できます。

  • A user in a defined list: An issue that passes a restriction (specified in JQL) is assigned to a user from a specified list of users using the method of your choosing. This can be:

    • Balanced Workload: Ensures that each user in the list has the same number of issues assigned. The scope of these issues is defined by the JQL.

    • Random: Assigns randomly from the list of users.

    • Round-Robin: Assigns issues based on the sequence in the list of specified users.

  • Another field value or comment: Assign the issue based on user field values on the issue or in a comment. For example, assign the issue to a previous assignee based on the issue history, or assign the issue to its creator. If you specify users to exclude, or groups the user must be in, any user not matching this requirement will be skipped and the action will continue looking for matching users (such as going further back in the issue history of assignees).

  • Automatic: Assign the issue to the project's default assignee.

  • Copy from another issue: Copy the assignee from a related issue. You can also use JQL to find an issue to copy the assignee from.

  • Smart value: Assign the issue based on a smart value. For example, when an issue is commented on, you can assign it to the author of the comment. Learn more about user smart values.

  • Specify user: Assign to a selected user.

  • Unassigned: Remove existing user and set the issue as ‘Unassigned’.

  • User who triggered the event: Assign the issue to the user who triggered the event.

  • User in a role: Assign the issue to a specific role within a team.

  • User in a group: Assign the issue to a user under a selected group.

  • On-call responder: Assign the issue to who is on-call, based on a team's Opsgenie on-call schedule. Responders are assigned randomly if the selected schedule includes multiple rotations.

課題の割り当てアクションを含む自動化ルール

フォームを添付する

フォーム関連のコンポーネントはプロジェクト固有なので、グローバル自動化では設定できないことに注意してください。フォーム コンポーネントはプロジェクト自動化でのみ使用できます。

Attach one or more forms to an issue. You can also set the visibility of the forms. Learn more about how forms work in the issue view.

フォームの添付アクションを含む自動化ルール

課題のクローンを作成する

  • Use smart values here: Yes

同じプロジェクトまたは選択したプロジェクト内の課題を重複作成します。

This action can be used as part of a workaround for moving issues between projects.

This action will create a new issue and copy across all field data possible, including the ability to copy attachments by selecting the Attachment field from the list of supported issue fields and then choosing the source issue from which attachments need to be copied.

その後、対応するワークフローの最初のステップにステータスが設定され、元の課題にあるすべての解決が削除されます。課題は純粋なクローンではないため、元の課題には紐づけされません。

You can also set values to override any copied data in supported fields. For Jira Service Management, you set both Jira fields and Assets fields. Learn more about Assets in Jira Service Management.

Select More options to display additional fields for advanced field editing.

このアクションでは、課題のリンクまたはコメントは複製されません。

課題の複製アクションを含む自動化ルール

課題にコメントする

  • Use smart values here: Yes

課題にコメントを追加します。

You can use smart values to reference issue fields to personalize the comment. You can also set the comment visibility.

"課題にコメント" アクションを含む自動化ルール

フォームをコピーする

フォーム関連のコンポーネントはプロジェクト固有なので、グローバル自動化では設定できないことに注意してください。フォーム コンポーネントはプロジェクト自動化でのみ使用できます。

1 つの課題から 1 つ以上のフォームを現在の課題にコピーします。

"フォームをコピー" アクションを含む自動化ルール

ブランチを (製品名で) 作成する

ブランチを選択したツールで作成します。現在、次の 3 つの方法があります。

  • ブランチを Bitbucket で作成

  • ブランチを GitHub で作成

  • ブランチを GitLab で作成

This requires setting up a connection between your automation rule and the other tool. Learn more about connections in automation.

You can also use smart values to access information related to these branches - learn more about created branch smart values.

ブランチに名前を付ける際の制限

次はブランチの名前に使用できません。

  • HEAD (予約語であるため)

  • / で開始または終了する名前

  • . で開始または終了する名前

  • 末尾が .lock

  • スペースを含む名前

  • 次の記号セットを含む名前: ..~^:?*[/\\@{

Confluence ページを作成する

  • Use smart values here: Yes

選択した Atlassian Cloud サイトに Confluence ページ (またはブログ) を作成します。これにより Confluence ページは作成されますが、コンテンツは入力されないことに注意してください。つまり、スマート値を使用してページ タイトルを定義することはできますが、自動化ルールではどのページ コンテンツも定義できません。

Requires a connection between your Jira project and Confluence. Learn more about using Jira automation with Confluence.

課題の作成

  • Use smart values here: Yes

  • Required permissions: Browse projects, Create issues

Creates an issue of any type to a project. You can select fields to configure, and set their values. You can copy attachments by selecting the Attachment field from the list of supported issue fields and then choosing the source issue from which attachments need to be copied.

Select More options to display additional fields for advanced field editing.

For Jira Service Management, you can set both Jira fields and Assets fields. For Jira Service Management, if the rule is triggered by an object, you can select Insert object to automatically add the triggered object via AQL. Learn more about Assets in Jira Service Management.

Take care when using Project > Same project as trigger on global rules. As the project type is unknown until the rule runs, all issue types are available to configure. This means that you can select an issue type that will not exist in the project.

ルックアップ テーブルを作成する

キーと値のマッピングのテーブルを作成して、それをスマート値に割り当てます。スマート値は、ルール内のその他のアクションや条件で使用できます。次に例を示します。

「ルックアップテーブルを作成」アクションの画像。定義されているキーは、HR、IT、Ops、RandD とそれに対応する値です。

The smart value {{departments.get("HR")}} would return Human Resources.

キーと値のマップは、同じルール内でのみ呼び出せます。アクションがブランチで使用される場合、スマート値は同じブランチ内でのみ使用できます。キー/値のマッピングは、その他のルールやブランチには引き継がれません。

 

ユース ケースの例

たとえば、優先度に基づいてバグに期限を割り当てる自動化ルールを作成したいとします。優先度の高いバグは、その週内に完了する必要があります。一方、優先度の低いバグは、翌 6 か月内に完了すれば構いません。

次の値でキー/値のマップを作成できます。

「ルックアップ テーブルを作成」アクションの画像では、キーは異なる優先度名 (最低から最高) を表しています。

その後、「課題を編集」アクションと {{dueDates.get(issue.Priority.name)}} スマート値を使用すると、バグの緊急度に基づいて、期限を自動的に割り当てることができます。

"課題を編集" アクションの画像。"期限" フィールドには、スマート値 {dueDates.get(issue.Priority)} が含まれます。

この方法でスマート値をネストする場合、ネストされたスマート値によって返される値は文字列でなければならないことに注意してください。この例では、代わりに issue.Priority.id を使用した場合、.format(“#”) を追加して出力を文字列 (つまり {{dueDates.get(issue.Priority.id.format("#"))}}) に変換しない限り機能しません

サブタスクの作成

  • Use smart values here: Yes

課題のサブタスクを作成します。

This action only supports setting the Summary of the sub-task.

Selecting Add fields will convert the Create sub-tasks action into a Create issue (issue type: sub-task) action, allowing you to set additional fields.

スプリントの作成

  • Use smart values here: Yes

  • Jira 専用です。 

選択したソフトウェアプロジェクトボードでスプリントを作成します。

  • 企業管理対象プロジェクトでは、ボードがスクラム ボードである必要があります。

  • For team-managed projects, the board must have the Sprints feature enabled. .

You also have the option of entering specific values for start date, end date, and goal. For start and end dates, you may find it useful to use date and time smart values. For example, you could set {{now}} as the start date, and {{now.plusweeks(2)}} as the end date. Learn more about date and time smart values.

注意事項:

  • 開始日を設定する場合は、終了日も設定する必要があります。

  • スプリント名は 30 文字を超えることができないため、手動で入力するスプリント名や、長すぎるテキストを返すスマート バリューに注意する必要があります。

変数の作成

  • Use smart values here: Yes

独自のスマート バリューを定義します。この値は、同一ルールの他のアクションや条件で使用できます。定義したスマート バリューには、他のスマート バリューや数学関数を含めることができます。

Note that this will always return a string. For example, if you created variable called Stakeholders with the smart value {{issue.watchers.distinct}}, your variable would return the list of watchers but the list would be rendered as a string.

コメントの削除

  • Use smart values here: Yes

課題のコメントを削除するために使用できます。このアクションを使用するには、次の 2 つの方法があります。

  • Deleting a trigger comment: If the rule uses a trigger that involves adding a comment, such as Issue commentedIssue transitioned, or Issue updated, {{comment.id}} will delete that comment.

  • Deleting other comments: Delete a comment on an active issue by using a comment smart value, such as {{issue.comment.first.id}}.

課題を削除する

  • Use smart values here: No

コンテキストにある現在の課題を削除します。

This action allows you to remove unwanted issues from your site, such as when automating moving issues between projects.

Deletes the current issue that is in context. This is a great way to remove unwanted issues from Jira, such as in automating moving issues between projects.

  • Use smart values here: No

この操作では現在課題にある任意の課題リンクを削除できます。特定のタイプにおけるすべての課題リンクを削除するか (たとえば、すべての「ブロックされた」課題を削除するなど)、特定の課題を選択してリンクを解除できます。

コメントを編集する

  • Use smart here: Yes

このアクションによって、コメントの表示やコメントの内容を編集できるようになります。利用可能なオプションは次のとおりです。

  • 最初のコメント: 課題に関する最初のコメントを編集します。

  • 最後のコメント: 課題に関する最新のコメントを編集します。

  • Trigger comment: Edit the comment that triggered the rule. Used with triggers such as Issue commented or Issue comment edited. Learn more about automation triggers.

  • スマート値: コメント スマート値を指定して、編集するコメントを選択します。

オプションを選択したら、次のフィールドを空白のままにしてコメントを変更せずに残せます。これは、コメントの表示のみを編集して他の部分には手を付けない際に役立ちます。スマート値 {{currentComment}} を入力すると、コメントの現在のコンテンツが返されます。これは、現在のコメントを保持してその前後にコンテンツを追加する際に役立ちます。

[アセット] フィールドの属性を編集する

  • Use smart values here: Yes

Jira Service Management でのみ利用できます。このアクションは、[アセット] フィールドの属性値を編集します。スマート値、文字列値、またはアセット オブジェクトの ID/キーのいずれかを入力できます。ここでフィールドを空のままにすると、オブジェクトの値がクリアされます。

アセット属性はさまざまなタイプの値 (文字列、整数、ユーザー、日付、参照オブジェクトなど) を持てるため、ここでは適切に入力する必要があります。このアクションの値が属性タイプと一致しない場合は、このルールでエラーが発生します。

課題の編集

  • Use smart values here: Yes

Edit the current issue by choosing the field to set and value to add. For Jira Service Management, you can edit both Jira fields and Assets fields. Learn more about Assets in Jira Service Management.

You can set some values to be dynamic. You can also copy attachments by selecting the Attachment field from the list of supported issue fields and then choosing the source issue from which attachments need to be copied. Select More options to display additional fields for advanced field editing.

オブジェクトを編集する

  • スマート バリューの使用: あり

  • Jira Service Management にのみ適用されます。 

オブジェクトの属性値を更新します。スマート値、文字列値、またはアセット オブジェクトの ID/キーのいずれかを入力できます。ここでフィールドを空のままにすると、オブジェクトの値がクリアされます。

Assets attributes can have many different types of values (string, integer, user, date, reference object, etc.), so you have to get the input right here. This rule will result in an error if the value in this action doesn't match the attribute type. Learn more about Assets in Jira Service Management.

このアクションは、次の場合にのみ使用できます。

  • for global automation rules and only when an object is the focus of the rule. For example, if the rule begins with an Object trigger, the object that triggered the rule will be the object that is edited by this action.

  • when it's under a branch on an AQL branch. It won't work on its own and it won't work with the Lookup objects action.

リクエスト タイプの編集

  • Use smart values here: Yes

  • Jira Service Management にのみ適用されます。 

課題のリクエスト タイプをアップデートします。リクエスト タイプは課題タイプに基づいていることにご注意ください。複数のリクエスト タイプが 1 つの課題タイプに対応している場合もあります。ただし、自動化ルールが課題に作用する場合は、選択したリクエスト タイプがその課題タイプに対応している必要があります。そうでない場合は、アクションが実行されると監査ログでエラーが検出されます。

  • Use smart values here: No

  • 「脆弱性の検出時」トリガーとの併用時にのみ使用できます。

トリガーとなる脆弱性を課題にリンクします。

トリガーとなる脆弱性ごとに新しい課題を作成してリンクするには、次の手順に従います。

  1. 「脆弱性の検出時」トリガーと「課題を作成」アクションを使用して、自動化を作成します。

  2. 「課題を脆弱性にリンクする」アクションのドロップダウン メニューで、最近作成された課題を選択します。

トリガーとなるすべての脆弱性を 1 つの課題にリンクするには、次の手順に従います。

  1. 「脆弱性の検出時」トリガーで自動化を作成します。

  2. 「課題を脆弱性にリンクする」アクションのドロップダウン メニューに、課題キーを入力します。

このアクションで課題キーを入力した場合は、ルールの実行時に課題が存在しないと自動化が失敗します。

  • Use smart values here: Yes

リンクのタイプとリンクする課題を選択して、別の課題とリンクします。

ルールをトリガーする課題、関連する課題ブランチにある現在の課題、スマート バリュー、または課題キーにリンクできます。

ログ

  • Use smart values here: Yes

Logs time against an issue.

You can use date and time smart values to dynamically set the date started, and text smart values to customize the description.

課題のルックアップ

  • Use smart values here: Yes

Search for up to 100 issues using a JQL query. Include the results list in other actions by using the {{lookupIssues}} smart value. Learn more about using smart values with issue lists.

All fields and custom fields can be accessed from the lookupIssues list. For example, to print the issue key for each issue in bullet point form:

{{#lookupIssues}} * {{key}} {{/}}

以下の例では、課題リストのすべてのストーリー ポイントを集計しています。

There are {{lookupIssues.Story Points.sum}} story points remaining.

オブジェクトのルックアップ

  • Use smart values here: Yes

  • Jira Service Management にのみ適用されます。

Search for up to 100 objects using an Assets AQL query. Learn more about Assets in Jira Service Management.

Pass the resulting list of objects to other actions by using the {{lookupObjects}} smart value. This can be used to access and print the list of objects, but can't be used to trigger other rules. Learn more about smart values for JSM Assets.

ウォッチャーの管理

  • Use smart values here: Yes

課題に/からウォッチャーを追加/削除します。

フィールドで直接スマート バリューを使って、ユーザーを指定して追加または削除できます。

課題のトランジション

  • Use smart values here: Yes

ワークフロー内で、課題をあるステータスから別のステータスにトランジションします。

課題のトランジションと同時に更新するフィールドを選択できます。たとえば、以下を更新できます。

  • Copy from issue: copies the status from a related issues or an issue on a branch rule.

  • Copy from parent: for use with sub-tasks; copies the status from a parent.

  • Copy from Epic: copies the status from the issue's associated Epic.

  • Copy from Trigger issue: copies the status from the issue that triggered the rule.

  • Same status (loop): for use when a transition exists from the current status back to itself; this can be used together with a screen to gather more data from users, e.g. an Escalate transition.

You can also copy attachments by selecting the Attachment field from the list of supported issue fields and then choosing the source issue from which attachments need to be copied. Select More options to display additional fields for advanced field editing.

For Jira Service Management, you can edit both Jira fields and Assets fields. Learn more about Assets in Jira Service Management.

メールを送信

「返信先」のアドレスを変更する

From June 28, 2021, only the first email listed in the Reply to field will receive reply emails. This means:

  • [メールを送信] アクションを持つ新しい自動化ルールでは、[返信先] フィールドにアドレスを 1 つだけ入力することをお勧めします。

  • [メールを送信] アクションを使用する既存のルールについては、[返信先] フィールドで 1 つのアドレスだけが使用されるようにルールを再構成することをお勧めします。

  • Use smart values here: Yes

メールを送信します。 このアクションのすべてのフィールドで、スマート バリューを使ったカスタマイズがサポートされています。

Selecting All customers involved from the To field will trigger the email to be sent to the reporter, request participants, customers whose organization has been added to the issue, and customers who have subscribed to issue notification. Learn more about customers and organizations in Jira Service Management.

Note that there are limits around how many emails this action can send - Learn more about Automation service limits.

このアクションでは、メールのメッセージ ID が監査ログに自動的に記録されます。メールを追跡する必要がある場合は、<message-id>@automation.atlassian.com の形式で記録された情報を使用してください。

Global admins can also set restrictions on which domains can be used by the action - read more about adding restrictions to automation components.

Microsoft Teams のメッセージを送信する

  • Use smart values here: Yes

Microsoft Teams のメッセージを送信して、ルール実行時にチームに通知します。プライベート チャンネルにメッセージを送信できません。

You can personalize the message in this action. Learn more about using automation with Microsoft Teams.

Global admins can also set restrictions on which domains can be used by the action - read more about adding restrictions to automation components.

Slack のメッセージを送信する

  • Use smart values here: Yes

ルールの実行時にチームや個人に通知するために Slack のメッセージを送信します

You can personalize the message in this action. Learn more about using automation with Slack.

Global admins can also set restrictions on which domains can be used by the action - read more about adding restrictions to automation components.

Twilio (SMS) メッセージを送信する

  • Use smart values here: Yes

Twilio サービスを使用して通知を送信します。

このアクションは、オンコール シナリオで SMS を利用するサービス チームで役立ちます。

Global admins can also set restrictions on which domains can be used by the action - read more about adding restrictions to automation components.

Web リクエストを送信

  • Use smart values here: Yes

この機能を使用するには、ネットワークでアトラシアンからのリクエストを許可する必要があります。発信接続については、「Atlassian Cloud 製品の IP アドレスとドメイン」をご覧ください。

発信 Web リクエストを送信して、ルール実行時に別のシステムに通知します。 後続のアクションで使える応答データを返すようにこのアクションを設定できます。

Global admins can also set restrictions on which domains can be used by the action - read more about adding restrictions to automation components.

データ形式

以下の 3 つの形式から選択できます。

非表示の値

When configuring your web request, you can also Hide certain values, making them more secure. If a value is marked as hidden and the rule is saved, the value will be replaced by asterisks (i.e., *****) - it longe will no longer be visible, and you won’t be able to inspect any payload. Once a value is hidden, this can’t be reversed (i.e. the Hidden checkbox can’t be unselected), though the value itself can still be changed when editing your rule.

For security reasons, hidden values will be lost if the entire rule is duplicated or exported/imported, or if the Send web request component itself is duplicated. If this happens, you’ll need to reconfigure the component and re-enter those values.

その他の注意点

  • Permitted ports: Note that the only permitted ports for urls from the Send web request action are 80, 8080, 443, 6017, 8443, 8444, 7990, 8090, 8085, 8060, 8900, 9900.

  • Data sensitivity: The Send web request action can be used to configured to sensitive data to third-parties. This is true even after the rule is saved, because someone with permission to edit the rule can reconfigure the Send web request action to send out data that they shouldn’t. For this reason, we recommend that before using this action, ensure that only people you trust can edit automation rules.

サービス プロジェクト カスタマーを追加する

  • Use smart values here: Yes

Jira Service Management のプロジェクトに新しい顧客を追加します。

スマート バリューはすべてのフィールドで使用でき、既存組織に顧客を追加できます。

このアクションを短い間隔で複数回連続して呼び出した場合、カスタマーが存在するものの、ユーザーの検索結果にはまだ表示されないため、最初の呼び出しは成功し、後続の呼び出しは失敗します。検索結果に新しいユーザーが表示されてこの問題が解決されるまで、最大で15 秒かかります。

{{customer}} のスマート バリューでは、検索結果に表示できない既存のユーザーは返されないため、エラーが発生します。

If this issue is affecting your rule, you can introduce a delay into your rule by adding a number of Re-fetch issue data actions right before the Add Service Project customer action – note that this may not work in all cases.

リクエストを承認/却下する

  • Use smart values here: No

Jira Service Management のリクエストを承認または却下します。ワークフローを進めるために必要な承認者の数は問いません。

You can use this action on Jira Service Management issues that are pending approval on the current workflow status. Approvals are managed through the workflow. Learn more about approvals in Jira Service Management.

リクエスト タイプを使用して課題を作成する

  • Use smart values here: Yes

選択したリクエスト タイプを使用して、Jira Service Management プロジェクトに新しい課題を作成します。

All request types you’ve added to the service project can be used with this action. Learn how to organize your request types into portal groups

Similar to the Create issue action, this action allows you to configure any field available using smart values.

インシデントを作成

  • Use smart values here: Yes

  • Required permissions: Browse projects, Create issues

このアクションが実行されると、Jira Service Management の選択したサービス プロジェクトに、選択したリクエスト タイプのインシデントが作成されます。たとえば、課題が作成され、特定の基準を満たした場合に、このアクションを使用して新しいインシデントを作成できます。

アクションによってプロジェクト内に同じタイプの未解決のインシデントがすでに作成されている場合は、新しいインシデントが作成されないようにすることもできます。

You need to have a service project and a request type for incidents to use this action.

バージョンの作成

  • Use smart values here: Yes

課題を割り当てられる新しいバージョンを作成します。

同じ名前のバージョンがすでに存在する場合は、新しいバージョンは作成されません。

バージョンをリリースする

  • Use smart values here: Yes

バージョンをリリースします。

By default, this action will release the next unreleased version of a project with the existing release date. This is determined by the order the versions are set in Releases.

リリースする特定のバージョンを選択し、スマート バリューを使って動的な名前を設定できます。

添付ファイルを削除する

  • Use smart values here: Yes

添付ファイルのファイル名に基づいて、正規表現の一致を使って添付ファイルを削除します。

ログ アクション

  • Use smart values here: Yes

監査ログに値を記録します。

This action is useful when testing smart values, and debugging rules.

課題データを再取得する

  • Use smart values here: No

最新のフィールド値でスマート バリューを更新します。

デフォルトでは、{{issue}} 参照値はルールの実行中には更新されず、ルールが最初にトリガーされたときと同じ値が含まれます。

エンティティのプロパティを設定する

  • Use smart values here: Yes

ルール実行のトリガー課題に関連する課題、プロジェクト、ユーザーにエンティティのプロパティを設定します。

これらの非表示のプロパティは、特定の機能でアプリに使用されます。エンティティのプロパティでは、プラグインから課題とプロジェクトにキー/値ストアを追加できます。これらの値は、REST API または JQL を使ってインデックス化してクエリを実行できます。

バージョンのリリースを元に戻す

  • Use smart values here: Yes

Unrelease a released version for a chosen project. By default, this will be the rule's project, but you can select More options to choose a different project.

Amazon SNS トピックにメッセージを送信する

  • Use smart values here: Yes

このアクションを実行すると、選択した Amazon Simple Notification Service トピックに JSON メッセージが送信されます。

You can add up to 10 key-value pairs to an action. If you’d like to add more, contact support.

 Amazon SNS トピック

スマート値はすべての値タイプ (文字列、リスト、数値、ブール値、カスタム) で使用できます。ただし、カスタムはスマート値のみをサポートしています。

Make sure that your Amazon SNS topic allows Atlassian Automation to publish messages. Learn more about configuring Amazon SNS.

AWS SSM ドキュメントを実行する

  • Use smart values here: Yes

このアクションを実行すると、選択した AWS Systems Manager ドキュメントが実行されます。ドキュメントの事前設定されたパラメータに値を追加できます。

AWS SSM

Make sure that the IAM role has a Permission Policy allowing Atlassian Automation to access and run SSM documents. Learn more about configuring AWS IAM.

AWS SSM ドキュメントを実行する

このアクションは、Enterprise プランでのみ応答待ちをサポートします。

このアクションによって、AWS SSM からレスポンスを受信するまでルールを一時停止できます。有効にすると、AWS SSM が指定された時間 (最大 15 分) 以内に成功の応答を返した場合にのみ、ルールが再開されます。この時間内に成功の応答が受信されない場合、ルールは失敗します。

さらに、次の場合にルールが再開されるように設定できます。

  • 応答失敗時に再開: AWS SSM が指定された時間内に失敗した応答を返した場合でも、ルールは再開されます。

  • 応答がないと再開する: AWS SSM が指定された時間内に応答を返さない場合でも、ルールは再開されます。

AWS SSM からペイロードにアクセスするには、{{awsSsm.output}} スマート値 を使用します。

応答のステータスを確認するには、スマート値 {{awsSsm.status}}を使用すると「成功」または「失敗」のいずれかが表示されます。応答が受信されない場合、値は空になります。

仮想マシンを Azure で再起動

  • Use smart values here: No

このアクションを実行すると、Microsoft Azure で選択された仮想マシンがアトラシアン自動化によって再起動されます。

仮想マシンを Azure で再起動
仮想マシンを Azure で再起動

Make sure you’ve added Email in your Microsoft Azure profile information for authentication of the rule’s connection. Learn how to add or change profile information in Microsoft Azure

このアクションは、Enterprise プランでのみ応答待ちをサポートします。

このアクションにより、Azure 仮想マシンから応答を受信するまでルールを一時停止できます。有効にすると、Azure 仮想マシンが指定された時間 (最大 15 分) 内に成功の応答を返した場合にのみ、ルールが再開されます。この時間内に成功の応答が受信されない場合、ルールは失敗します。

さらに、次の場合にルールが再開されるように設定できます。

  • 応答がないと再開する: Azure Virtual Machine が指定された時間内に応答を返さない場合、ルールは再開されます。

応答のステータスを判断するには、スマート値 {{azureVm.status}}を使用できます。応答が受信されない場合、値は空になります。



Azure でランブックを開始

  • Use smart values here: No

このアクションを実行すると、Microsoft Azure で選択されたランブックが Atlassian Automation によって開始され、実行されます。Microsoft Azure に送信される JSON メッセージに含めるキーと値のペアを追加することもできます。

Azure でランブックを開始

Make sure you’ve added Email in your Microsoft Azure profile information for authentication of the rule’s connection. Learn how to add or change profile information in Microsoft Azure

このアクションは、Enterprise プランでのみ応答待ちをサポートします。

このアクションによって、Azure から応答を受信するまでルールを一時停止できます。有効にすると、Azure が指定された時間内 (最大 15 分) に成功の応答を返した場合にのみ、ルールが再開されます。この時間内に成功の応答が受信されない場合、ルールは失敗します。

さらに、次の場合にルールが再開されるように設定できます。

  • 応答が失敗したら再開する: 指定された時間内に Azure が失敗した応答を返した場合でも、ルールは再開されます。

  • 応答がないと再開する: 指定された時間内に Azure が応答を返さない場合でも、ルールは再開されます。

Azure からペイロードにアクセスするには、{{azureRunbook.output}} スマート値 を使用します。

応答のステータスを確認するには、スマート値 {{azureRunbook.status}}を使用すると「成功」または「失敗」のいずれかが表示されます。応答が受信されない場合、値は空になります。

インシデント用の Slack チャンネルを作成

  • Use smart values here: Yes

このアクションを実行すると、選択した Slack ワークスペースに新しい Slack チャンネルが作成され、インシデント担当者がそのチャンネルに自動で追加されます。利用可能なすべてのインシデントの詳細とアクションが投稿され、対応チームが迅速に状況を把握して行動を起こせるようになります。

チャンネルを作成するための Slack ワークスペースを選択したり、プレーン テキストとスマート バリューを使用してチャンネルの名前と説明をカスタマイズしたり、チャンネルに追加するチーム メンバーを選択したりできます。既定では、チャンネルの名前と説明は、ルールをトリガーするインシデントのキー、要約、URLになります。

This action will run successfully only for issues of an incident request type. Read how to create a request type

To get started, connect your Slack workspace with your Jira Service Management site and project. Read how to connect Slack with Jira Service Management

インシデントに Microsoft Teams のチャットまたはミーティングを作成する

  • Use smart values here: Yes

このアクションを実行すると、選択した Microsoft テナントに新しい Microsoft Teams チャットまたはミーティングが作成され、インシデント担当者がチャットまたはミーティングに自動で追加されます。利用可能で関連するすべてのインシデントの詳細とアクションが投稿され、対応チームが迅速に状況を把握して行動を起こせるようになります。

チャットやミーティングを作成するための Microsoft テナントを選択したり、プレーン テキストとスマート値を使用して名前と説明をカスタマイズしたり、追加するチーム メンバーを選択したりできます。既定では、チャットまたはミーティングの名前と説明は、ルールをトリガーするインシデントのキー、要約、URL になります。

This action will run successfully only for issues of an incident request type. Read about creating a request type

To get started, connect your Microsoft tenant with your Jira Service Management site and project. Read how to connect Microsoft Teams with Jira Service Management

Jira Edge Connector を使用してスクリプトを実行する

このアクションを実行すると、オンプレミス システムで選択したアクションが Jira Edge Connector 経由で実行されます。

Microsoft Azure に送信される JSON メッセージに、含めたいキーと値のペアを追加することもできます。Jira はキーと値のペアを検証しないため、必ず確認してください。

Jira Edge Connector で Jira 自動化を使用する方法をご確認ください。

このアクションは、Enterprise プランでのみ応答待ちをサポートします。

このアクションによって、JEC から応答を受信するまでルールを一時停止できます。有効にすると、JEC が指定された時間内(最大 15 分)に成功の応答を返した場合にのみ、ルールが再開されます。この時間内に成功の応答が受信されない場合、ルールは失敗します。

さらに、次の場合にルールが再開されるように設定できます。

  • 応答失敗時に再開:JEC が指定された時間内に失敗した応答を返した場合でも、ルールを再開します。

  • 応答がないと再開: JEC が指定された時間内に応答を返さなくても、ルールは再開されます。

JEC からペイロードにアクセスするには、{{jecAction.output}} スマート値 を使用します。

応答のステータスを確認するには、スマート値 {{jecAction.status}}を使用すると「成功」または「失敗」のいずれかが表示されます。応答が受信されない場合、値は空になります。

アラート ステータスを変更

このアクションは、Jira Service Management の Premium と Enterprise の各プランでのみ利用できます。

このアクションが実行されると、アラートのステータスはユーザーが選択した新しいステータスに変更されます。アラートのステータスを、確認済み、オープン、クローズ済み、スヌーズに変更できます。

When SNOOZED is selected, you get to pick a custom snooze duration (between 1 minute and 7 days) which also supports the date and time smart values.

Ansible でジョブ テンプレートを起動

このアクションは、Jira Service Management の Premium と Enterprise の各プランでのみ利用できます。

このアクションが実行されると、選択したジョブ テンプレートが Ansible で起動されます。ジョブ テンプレートを正常に起動するために追加情報が必要な場合は、アクションにその情報を JSON 形式で指定できます。

Ansible でジョブ テンプレートを起動

Make sure you’ve created an application in Ansible Automation Controller, as you’ll need its token to connect it with Atlassian Automation. Read more about connecting with Ansible

Ansible 自動化コントローラー

このアクションは、Enterprise プランでのみ応答待ちをサポートします。

このアクションにより、Ansible から応答を受信するまでルールを一時停止できます。有効にすると、Ansible が指定された時間 (最大 15 分) 以内に成功の応答を返した場合にのみ、ルールが再開されます。この時間内に成功の応答が受信されない場合、ルールは失敗します。

さらに、次の場合にルールが再開されるように設定できます。

  • 応答失敗時に再開: Ansible が指定された時間内に失敗した応答を返した場合でも、ルールは再開されます。

  • 応答がないと再開: Ansible が指定された時間内に応答を返さない場合でも、ルールは再開されます。

Ansible からペイロードにアクセスするには、{{ansibleJobTemplate.output}} スマート値 を使用します。

応答のステータスを確認するには、スマート値 {{ansibleJobTemplate.status}}を使用すると「成功」または「失敗」のいずれかが表示されます。応答が受信されない場合、値は空になります。

 

New Relic でクエリを実行する

このアクションは、Jira Service Management の Premium と Enterprise の各プランでのみ利用できます。

When this action is executed, the given query is run in New Relic using NRQL. You can connect with New Relic using your user key.

New Relic でクエリを実行する

接続したら、New Relic のアカウント ID と、New Relic で実行したいクエリを入力できます。

New Relic のアカウント ID

このアクションは応答待ちをサポートします

New Relic では、このオプションは既定で有効になっているため、New Relic が 15 分以内に正常な応答を返した場合にのみルールが再開されます。それ以外の場合、ルールは失敗します。

さらに、次の場合にルールが再開されるように設定できます。

  • 応答失敗時に再開: New Relic が指定された時間内に失敗した応答を返した場合でも、ルールは再開されます。

  • 応答がないと再開する: New Relic が指定された時間内に応答を返さない場合、ルールは再開されます。

New Relic からペイロードにアクセスするには、{{newRelicQuery.results}} スマート値を使用します。

遅延

このアクションは、すべての Premium プランと Enterprise プランでのみ利用できます。

  • Use smart values here: No

このアクションを(条件または別のアクションの前に)ルールに追加すると、2 つのコンポーネント間に時間ベースの遅延が追加されます。ルールは、ルール内の次のコンポーネントが実行されるまでに X 時間遅延します。

遅延コンポーネントをブランチに追加しても、ブランチのコンポーネントの実行が遅延するだけで、ルールの他の部分には影響しません。

遅延コンポーネントでは、15 分または 900 秒を超える遅延を設定できません。また、ルール内の遅延時間の合計が 60 分を超えることはできません。このアクションは、現時点では Premium プランと Enterprise プランでのみ利用可能です。

アラート イベントが発生するまでの遅延

このアクションは、すべての Premium プランと Enterprise プランでのみ利用できます。

  • Use smart values here: No

イベント ベースの遅延アクションを使用すると、関連するアラート エンティティで特定のイベントが発生するまで、ルールの実行を最大 15 分遅らせられます。アラート スマート値の再取得は遅延の開始前とイベントの受信後に行われます。この機能は、ルールの次のステップに進む前に特定の条件またはメトリックが満たされていることを検証することが極めて重要なインシデント管理シナリオで特に役立ちます。

サポートされているイベント:

  • 優先度が変更されました

  • ステータスが更新されました

設定:

  • 管理者は、変更を監視するフィールド (優先度やステータスなど) を選択できます。ルールは、指定されたイベントがこのフィールドで発生するまで最大 15 分間一時停止します。

  • イベントがルールの継続をトリガーするために満たす必要のある条件を定義します。利用可能な条件は次のとおりです。

    • 指定の値に等しい

    • 等しくない

    • 次のいずれかです

    • 次のいずれでもない

値を選択:

管理者はさらに、ルールの継続をトリガーするためにイベント フィールドが満たす必要のある値も指定する必要があります。

ルールの実行:

  • ルールは最大 15 分、または指定されたイベントが発生するまでのいずれか早い方で一時停止します。

  • イベントが 15 分以内に発生しない場合、ルールは自動的に再開されます。

  • イベントが発生しなくてもルールによって実行が中止されることはありません。遅延後も継続されます。

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。