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

  • An overview of all runners.

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

      List of runners

      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

        Additional properties are allowed.

        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

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

        Roles for the runner

        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

        Additional properties are allowed.

        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 \
 -X GET https://{{hostname}}/api/v1/platform/infrastructure/runners
Response examples (200)
{
  "runners": [
    {
      "runner_id": "string",
      "runner_name": "string",
      "zone": "string",
      "tags": {
        "additionalProperty1": "string",
        "additionalProperty2": "string"
      },
      "features": {
        "additionalProperty1": true,
        "additionalProperty2": true
      },
      "build_info": {
        "commit_hash": "string",
        "version": "string"
      },
      "host_ip": "string",
      "public_hostname": "string",
      "containers": [
        {
          "container_name": "string",
          "container_set_name": "string"
        }
      ],
      "roles": [
        {
          "role_name": "string"
        }
      ],
      "connected": true,
      "healthy": true,
      "health_checks": {
        "is_docker_healthy": true,
        "is_connected_to_zk": true,
        "has_containers": true
      },
      "region": "string"
    }
  ]
}