Ansibleジョブのステータス取得アクション

このページでは、ワークフロー自動化アクションカタログで利用可能なansible.job.getStatusアクションのリファレンスを提供します。このアクションを使用して、Ansible Automation プラットフォーム（Automation Controller）ジョブのステータスと詳細を取得します。ansible.job.launchによって作成されたジョブをポーリングするには、このアクションを使用します。このアクションは、http.getベースアクションに基づいています。

エンドポイント： GET https://{host}/api/controller/v2/jobs/{jobId}/

前提条件

ワークフローの自動化でこのアクションを使用する前に、以下が準備されていることを確認してください：

• HTTPS経由でアクセス可能なAnsible Automation プラットフォーム（Automation Controller）インスタンス。
• 書き込みスコープを持つOAuth2トークン（Automation Controller → ユーザー → トークンで作成してください）
• ポーリングする数値ジョブID（通常はansible.job.launchによって返されるidフィールド）。

ジョブステータスの取得

[{"name": "status", "expression": ".status"}, {"name": "finished", "expression": ".finished"}, {"name": "failed", "expression": ".failed"}]

{
  "id": 128,
  "status": "successful",
  "failed": false,
  "started": "2026-07-08T10:00:00Z",
  "finished": "2026-07-08T10:02:13Z",
  "elapsed": 133.0
}

name: check-ansible-job
description: 'Fetches the status of a previously launched Ansible job.'
steps:
  - name: get_status
    type: action
    action: ansible.job.getStatus
    version: 1
    inputs:
      host: ${{ :secrets:host }}
      authToken: ${{ :secrets:ansibleControllerToken }}
      jobId: "128"
    next: end