GitHubのワークフロー実行を一覧表示します。

リポジトリのGitHub Actionsワークフローの実行を一覧表示します。オプションで、ワークフロー、ブランチ、イベント、ステータスなどによるフィルタリングが可能です。workflowIdが指定された場合、リストはその特定のワークフローに限定されます。それ以外の場合は、リポジトリ内のすべてのワークフローの実行を返します。

認証の設定については、GitHubワークフロー実行アクションをご覧ください。

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

入力	タイプ	説明	例
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"`
イベント	弦	オプション。トリガーとなるイベントタイプでフィルタリングします。	`"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"`
resultsPerPage	Int	オプション。1ページあたりの結果数（1～100）。デフォルト：`30`。	`10`
ページ	Int	オプション。取得する結果のページ番号です。デフォルト：`1`。	`1`
作成された	弦	オプション。GitHubの日付範囲構文を使用して、作成日でフィルタリングします。	`">=2026-09-01"` または `"2026-09-01..2026-09-17"`
excludePullRequests	ブール値	オプション。`true`の場合、レスポンスからプルリクエスト情報は省略されます。デフォルト：`false`。	`false`
checkSuiteId	Int	オプション。関連付けられたチェックスイートのIDでフィルタリングします。	`12345`
selectors	リスト	オプション。レスポンスから値を抽出するためのJQセレクター。実行は`.workflow_runs[]`にあります。一般的なセレクター：`.total_count`、`.workflow_runs[0].id`、`.workflow_runs[0].conclusion`。	`[{"name": "latestRunId", "expression": ".workflow_runs[0].id"}]`

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

出力	タイプ	例
response	オブジェクト	`{ "total_count": 27, "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": 27,
  "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: list_workflow_runs description: List GitHub Actions workflow runs for a specific workflow steps: - name: list_runs type: action action: gitHub.workflowRun.list version: 1 inputs: token: ${{ :secrets:github-PAT-token }} owner: your_user_name repo: test-workflow workflowId: deploy.yml branch: main status: completed resultsPerPage: 10 selectors: - name: totalCount expression: ".total_count" - name: latestRunId expression: ".workflow_runs[0].id" - name: latestConclusion expression: ".workflow_runs[0].conclusion" next: end

ワークフローの例

name: list_workflow_runs
description: List GitHub Actions workflow runs for a specific workflow
steps:
  - name: list_runs
    type: action
    action: gitHub.workflowRun.list
    version: 1
    inputs:
      token: ${{ :secrets:github-PAT-token }}
      owner: your_user_name
      repo: test-workflow
      workflowId: deploy.yml
      branch: main
      status: completed
      resultsPerPage: 10
      selectors:
        - name: totalCount
          expression: ".total_count"
        - name: latestRunId
          expression: ".workflow_runs[0].id"
        - name: latestConclusion
          expression: ".workflow_runs[0].conclusion"
    next: end

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

GitHubのワークフロー実行を一覧表示します。