Hosts API - DELETE tag
This API is deprecated. Use the Monitored entities API instead. You can find more information about switching to the new API in the migration guide.
Deletes the specified custom tag from the specified host. Deletion cannot be undone.
DELETE | ManagedDynatrace for Government | https://{your-domain}/e/{your-environment-id}/api/v1/entity/infrastructure/hosts/{meIdentifier}/tags/{tag} |
SaaS | https://{your-environment-id}.live.dynatrace.com/api/v1/entity/infrastructure/hosts/{meIdentifier}/tags/{tag} | |
Environment ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/v1/entity/infrastructure/hosts/{meIdentifier}/tags/{tag} |
Authentication
To execute this request, you need an access token with DataExport
scope.
To learn how to obtain and use it, see Tokens and authentication.
Parameters
Parameter | Type | Description | In | Required |
---|---|---|---|---|
meIdentifier | string | The Dynatrace entity ID of the host. | path | required |
tag | string | The tag to be removed. | path | required |
Response
Response codes
Code | Type | Description |
---|---|---|
204 | Success. The tag of the host has been removed. | |
400 | ErrorEnvelope | Failed. The input is invalid. |
404 | Failure. The tag could not be found. |
Example
In this example, the request deletes the Rack123 tag from 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/tags/Rack123 \
-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'
Request URL
https://mySampleEnv.live.dynatrace.com/api/v1/entity/infrastructure/hosts/HOST-B7A6F9EE9F366CB5/tags/Rack123
Response code
204