Topology & Smartscape API - Hosts

The Topology & Smartscape—Hosts API enables you to get details of currently monitored hosts as well as assign tags to them. You can:

GET list of hosts

Fetches the list of all hosts in your Dynatrace environment, along with their parameters.

The full list can be lengthy, so you can narrow it down by specifying filter parameters, like tags. See the Parameters expandable section for more details.

The request produces application/json payload.

GET
  • Managed https://{your-domain}/e/{your-environment-id}/api/v1/entity/infrastructure/hosts
  • SaaS https://{your-environment-id}.live.dynatrace.com/api/v1/entity/infrastructure/hosts

GET host parameters

Gets the parameters of the specified host.

The request produces application/json payload.

GET
  • Managed https://{your-domain}/e/{your-environment-id}/api/v1/entity/infrastructure/hosts/{meIdentifier}
  • SaaS https://{your-environment-id}.live.dynatrace.com/api/v1/entity/infrastructure/hosts/{meIdentifier}

POST tags to the host

Assigns custom tags to the specified host. You only need to provide tag value. The CONTEXTLESS context will be assigned automatically.

The request consumes host/json payload.

POST
  • Managed https://{your-domain}/e/{your-environment-id}/api/v1/entity/infrastructure/hosts/{meIdentifier}
  • SaaS https://{your-environment-id}.live.dynatrace.com/api/v1/entity/infrastructure/hosts/{meIdentifier}