Get runners

GET /platform/infrastructure/runners

Retrieves an overview of all runners.

Query parameters

  • q string

    An optional query to filter runners by. Maps to an Elasticsearch query_string query.

Responses

  • 200 application/json

    An overview of all runners.

    Hide response attribute Show response attribute object
    • runners array[object] Required

      List of runners

      Information about a specified runner.

      Hide runners attributes Show runners attributes object
      • runner_id string Required

        The runner identifier

      • The runner name

      • zone string

        Identifier of the zone

      • tags object

        Meta data of the runner, like image ID or processor architecture

        Hide tags attribute Show tags attribute object
        • * string Additional properties
      • features object

        State of features of the runner

        Hide features attribute Show features attribute object
        • * boolean Additional properties
      • Build Info of the container artifact

        Hide build_info attributes Show build_info attributes object
      • host_ip string Required

        Host IP for the runner

      • public_hostname string Required

        Public hostname for the runner

      • containers array[object] Required

        Containers for the runner

        Information about a container within a runner.

        Hide containers attributes Show containers attributes object
      • roles array[object] Required

        Roles for the runner

        Information about a runner role.

        Hide roles attribute Show roles attribute object
      • connected boolean Required

        Specifies if the runner is connected

      • healthy boolean Required

        Specifies if the runner is healthy

      • Checks used to determine if a runner is healthy or not

        Hide health_checks attributes Show health_checks attributes object
      • region string

        The region that this runner belongs to. Only populated in SaaS or federated ECE.

GET /platform/infrastructure/runners
curl \
 --request GET 'https://{{hostname}}/api/v1/platform/infrastructure/runners' \
 --user "username:password"
OSZAR »