最新の GitHub ワークフロー実行を取得します

特定のワークフローの最新のGitHub Actionsワークフロー実行を取得します。正確なRun IDが不明な場合 — たとえば、実行をトリガーした直後などに役立ちます。常に最大1つの実行を返します。

このアクションでは、以下の入力を使用できます。

入力	タイプ	説明	例
token	弦	必須。シークレットとして保存されたGitHub Personal Access トークンです。きめ細かいPATには、「Actions: read」権限が必要です。Classic PATには、リポジトリスコープが必要です。	`"${{ :secrets:github-PAT-token }}"`
owner	弦	必須。リポジトリのアカウント所有者（ユーザーまたは組織のログイン）。大文字と小文字は区別されません。	`"octocat"`
repo	弦	必須。.gitを含まないリポジトリ名サフィックス。大文字と小文字は区別されません。	`"Hello-World"`
workflowId	弦	必須。ワークフローのファイル名（たとえば、`deploy.yml`）または数値のワークフローID。	`"deploy.yml"`
ブランチ	弦	オプション。ブランチ名でフィルタリングします。特定のブランチでトリガーされた実行に絞り込むのに役立ちます。	`"main"`
イベント	弦	オプション。トリガーとなるイベントタイプでフィルタリングします（例：`push`、`pull_request`、`workflow_dispatch`）。	`"workflow_dispatch"`
ステータス	弦	オプション。実行ステータスまたは結果でフィルタリングします。許可される値：`completed`、`action_required`、`cancelled`、`failure`、`neutral`、`skipped`、`stale`、`success`、`timed_out`、`in_progress`、`queued`、`requested`、`waiting`、`pending`。	`"completed"`
俳優	弦	オプション。ワークフローをトリガーしたユーザーのGitHubログインでフィルタリングします。	`"octocat"`
headSHA	弦	オプション。この特定のヘッドコミットSHAを持つ実行のみを返します。	`"5cd968b93ae41f708cd094303e80bd4fca09d980"`
excludePullRequests	ブール値	オプション。`true`の場合、レスポンスからプルリクエスト情報は省略されます。デフォルト：`false`。	`false`
selectors	リスト	オプション。レスポンスから値を抽出するためのJQセレクター。実行は`.workflow_runs[0]`です。一般的なセレクター：`.workflow_runs[0].id`、`.workflow_runs[0].status`、`.workflow_runs[0].conclusion`。	`[{"name": "runId", "expression": ".workflow_runs[0].id"}]`

このアクションは、以下の出力を返します。

出力	タイプ	例
response	オブジェクト	`{ "total_count": 15, "workflow_runs": [ { "id": 35064429580, "name": "Deploy to staging", "status": "completed", "conclusion": "success", "html_url": "https://github.com/owner/repo/actions/runs/35064429580", "run_number": 15, "event": "workflow_dispatch", "head_branch": "main", "created_at": "2026-09-16T06:35:42Z", "updated_at": "2026-09-16T06:35:50Z" } ] }`
success	ブール値	`success: true \| false`
errorMessage	弦	GitHub APIのエラーレスポンス本文が含まれます。

出力

タイプ

例

response

オブジェクト

{
  "total_count": 15,
  "workflow_runs": [
    {
      "id": 35064429580,
      "name": "Deploy to staging",
      "status": "completed",
      "conclusion": "success",
      "html_url": "https://github.com/owner/repo/actions/runs/35064429580",
      "run_number": 15,
      "event": "workflow_dispatch",
      "head_branch": "main",
      "created_at": "2026-09-16T06:35:42Z",
      "updated_at": "2026-09-16T06:35:50Z"
    }
  ]
}

success

ブール値

success: true | false

errorMessage

弦

GitHub APIのエラーレスポンス本文が含まれます。

ワークフローの例
name: get_latest_workflow_run description: Retrieve the most recent workflow run for a specific workflow steps: - name: get_latest_run type: action action: gitHub.workflowRun.getLatest version: 1 inputs: token: ${{ :secrets:github-PAT-token }} owner: your_user_name repo: test-workflow workflowId: deploy.yml branch: main event: workflow_dispatch selectors: - name: runId expression: ".workflow_runs[0].id" - name: conclusion expression: ".workflow_runs[0].conclusion" - name: htmlUrl expression: ".workflow_runs[0].html_url" next: end

ワークフローの例

name: get_latest_workflow_run
description: Retrieve the most recent workflow run for a specific workflow
steps:
  - name: get_latest_run
    type: action
    action: gitHub.workflowRun.getLatest
    version: 1
    inputs:
      token: ${{ :secrets:github-PAT-token }}
      owner: your_user_name
      repo: test-workflow
      workflowId: deploy.yml
      branch: main
      event: workflow_dispatch
      selectors:
        - name: runId
          expression: ".workflow_runs[0].id"
        - name: conclusion
          expression: ".workflow_runs[0].conclusion"
        - name: htmlUrl
          expression: ".workflow_runs[0].html_url"
    next: end

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

最新の GitHub ワークフロー実行を取得します