Get proxy health

GET /platform/infrastructure/proxies/health

Get the health status of all proxies.

Query parameters

Responses

  • Returns health information on all the proxies

    Hide response attributes Show response attributes object
    • observed_proxies_count integer(int32) Required

      Total number of proxies

    • expected_proxies_count integer(int32) Required

      Expected minimum number of proxies

    • allocations array[object] Required

      Allocations for proxies

      Hide allocations attributes Show allocations attributes object
    • filtered_groups array[object] Required

      Filtered groups of proxies with associated status

      Hide filtered_groups attributes Show filtered_groups attributes object
      • group object Required

        A set of proxy filters with an expected number of matching proxies.

        Additional properties are allowed.

        Hide group attributes Show group attributes object
        • id string

          Identifier of the filtered group of proxies

        • filters array[object] Required

          Filters to be matched

          Hide filters attributes Show filters attributes object
          • key string Required

            Key of the proxy metadata item to be matched

          • value string Required

            Value of the proxy metadata item to be matched

        • expected_proxies_count integer(int32) Required

          Expected minimum number of proxies matching all filters in this group

      • observed_proxies_count integer(int32) Required

        The number of proxies that match all of the filters in the group

      • status string Required

        "Health status for this filtered group. One of "Green", "Yellow" or "Red"

    • status string Required

      "Health status for all proxies. One of "Green", "Yellow" or "Red"

  • The health status is worse than the expected one.

    Hide response attributes Show response attributes object
    • observed_proxies_count integer(int32) Required

      Total number of proxies

    • expected_proxies_count integer(int32) Required

      Expected minimum number of proxies

    • allocations array[object] Required

      Allocations for proxies

      Hide allocations attributes Show allocations attributes object
    • filtered_groups array[object] Required

      Filtered groups of proxies with associated status

      Hide filtered_groups attributes Show filtered_groups attributes object
      • group object Required

        A set of proxy filters with an expected number of matching proxies.

        Additional properties are allowed.

        Hide group attributes Show group attributes object
        • id string

          Identifier of the filtered group of proxies

        • filters array[object] Required

          Filters to be matched

          Hide filters attributes Show filters attributes object
          • key string Required

            Key of the proxy metadata item to be matched

          • value string Required

            Value of the proxy metadata item to be matched

        • expected_proxies_count integer(int32) Required

          Expected minimum number of proxies matching all filters in this group

      • observed_proxies_count integer(int32) Required

        The number of proxies that match all of the filters in the group

      • status string Required

        "Health status for this filtered group. One of "Green", "Yellow" or "Red"

    • status string Required

      "Health status for all proxies. One of "Green", "Yellow" or "Red"

GET /platform/infrastructure/proxies/health
curl \
 -X GET https://{{hostname}}/api/v1/platform/infrastructure/proxies/health
Response examples (200)
{
  "observed_proxies_count": 42,
  "expected_proxies_count": 42,
  "allocations": [
    {
      "allocations_type": "string",
      "max_allocations": 42,
      "proxies_at_max_allocations": 42
    }
  ],
  "filtered_groups": [
    {
      "group": {
        "id": "string",
        "filters": [
          {
            "key": "string",
            "value": "string"
          }
        ],
        "expected_proxies_count": 42
      },
      "observed_proxies_count": 42,
      "status": "string"
    }
  ],
  "status": "string"
}
Response examples (417)
{
  "observed_proxies_count": 42,
  "expected_proxies_count": 42,
  "allocations": [
    {
      "allocations_type": "string",
      "max_allocations": 42,
      "proxies_at_max_allocations": 42
    }
  ],
  "filtered_groups": [
    {
      "group": {
        "id": "string",
        "filters": [
          {
            "key": "string",
            "value": "string"
          }
        ],
        "expected_proxies_count": 42
      },
      "observed_proxies_count": 42,
      "status": "string"
    }
  ],
  "status": "string"
}