DAdatadog
Hosts

Get the total number of active hosts

This endpoint returns the total number of active and up hosts in your Datadog account. Active means the host has reported in the past hour, and up means it has reported in the past two hours.

get/api/v1/hosts/totals

Request

  • Base URL
    https://api.datadoghq.com
  • URL
    https://api.datadoghq.com/api/v1/hosts/totals
  • Auth
    • API key in header DD-API-KEY and API key in header DD-APPLICATION-KEY
    • or OAuth 2
      Authorization code: /oauth2/v1/authorize
      Token URL: /oauth2/v1/token scopes: hosts_read

Query parameters

frominteger

Number of seconds from which you want to get total number of active hosts.

Response

OK

total_activeinteger

Total number of active host (UP and ???) reporting to Datadog.

total_upinteger

Number of host that are UP and reporting to Datadog.

Changes

No recorded changes to this operation across all 1 revision of this API.