Hosts API - POST tags

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

The request consumes application/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}

Parameters

Parameter Type Description In Required
meIdentifier string

The Dynatrace entity ID of the host to be updated.

path required
body UpdateEntity body optional

The UpdateEntity object

A list of tags to be assigned to a Dynatrace entity.

Element Type Description Required
tags string[]

A list of tags to be assigned to a Dynatrace entity.

required

Response format

A successful request doesn't return any content.

Example

In this example, the request assigns the Linux and Rack 123 tags to the tag009 host, which has the ID of HOST-B7A6F9EE9F366CB5.

The API token is passed in the Authorization header.

Curl

curl -X POST \
  https://mySampleEnv.live.dynatrace.com/api/v1/entity/infrastructure/hosts/HOST-B7A6F9EE9F366CB5 \
  -H 'Authorization: Api-Token abcdefjhij1234567890' \  
  -H 'Content-Type: application/json' \  
  -d '{
  "tags": [
    "Linux",
    "Rack 123"
  ]
}'

Request URL

https://mySampleEnv.live.dynatrace.com/api/v1/entity/infrastructure/hosts/HOST-B7A6F9EE9F366CB5

Request body

{
  "tags": [
    "iOS app",
    "Adnroid app"
  ]
}

Response code

204