Ansibleジョブのステータスを取得する

このページでは、ワークフロー自動化アクションカタログで利用可能なansible.job.getStatusアクションのリファレンスを提供します。このアクションを使用して、ansible.job.launchによって作成されたジョブが終了状態になるまでポーリングします。

前提条件については、Ansibleジョブアクションをご覧ください。

Ansibleジョブのステータスを取得する

アクション識別子はansible.job.getStatusです。

Automation Controllerジョブのステータスと詳細を取得します。ジョブのステータスは、終了状態（successful、failed、error、またはcanceled）に達する前に、pendingからwaiting、runningへと進行します。エンドポイントはGET https://{host}/api/controller/v2/jobs/{jobId}/です。

次の表は、このアクションで利用可能なすべての入力フィールドについて説明しています。

入力	タイプ	説明	例
ホスト	弦	必須。スキームを含まない、Automation Controllerのホスト名（およびオプションのポート）。	`${{ :secrets:host }}`
authToken	弦	必須。 OAuth2 トークンは `Authorization: Bearer <token>` として送信されます。	`${{ :secrets:ansibleControllerToken }}`
jobId	Int	必須。ポーリングする数値のジョブID。通常は、 `ansible.job.launch` によって返される `id` です。	`128`
selectors	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "status", "expression": ".status"}, {"name": "failed", "expression": ".failed"}]`

次の表は、このアクションによって返されるすべての出力フィールドについて説明しています。

出力	タイプ	説明
success	ブール値	`true` 成功時は、失敗時は `false` 。
response	オブジェクト	Automation Controller APIからのジョブの詳細。 `{ "id": 128, "status": "successful", "failed": false, "started": "2026-07-08T10:00:00Z", "finished": "2026-07-08T10:02:13Z", "elapsed": 133.0 }`
errorMessage	弦	失敗時のエラーメッセージ。成功した場合は `null` 。

出力

タイプ

説明

success

ブール値

true

成功時は、失敗時は

false

。

response

オブジェクト

Automation Controller APIからのジョブの詳細。

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

errorMessage

弦

失敗時のエラーメッセージ。成功した場合は

null

。

以下の例では、Ansibleジョブをポーリングし、結果に基づいて分岐します。

ワークフローの例
`name: check-ansible-job description: Fetch 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" selectors: - name: status expression: ".status" - name: failed expression: ".failed" next: end`

ワークフローの例

name: check-ansible-job
description: Fetch 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"
      selectors:
        - name: status
          expression: ".status"
        - name: failed
          expression: ".failed"
    next: end

この機械翻訳は、参考として提供されています。

Ansibleジョブのステータスを取得する

Ansibleジョブのステータスを取得する.css-21sua1{background:none;border:none;width:0;padding:0;}

Ansibleジョブのステータスを取得する