Process groups API - POST tags

Assigns custom tags to the specified process group. You need only provide a 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/process-groups/{meIdentifier} SaaS https://{your-environment-id}.live.dynatrace.com/api/v1/entity/infrastructure/process-groups/{meIdentifier}

Authentication

To execute this request, you need the Access problem and event feed, metrics, and topology permission assigned to your API token. See the Authentication page to learn how to obtain and use it.

Parameters

Parameter	Type	Description	In	Required
meIdentifier	string	The Dynatrace entity ID of the process group to be updated.	path	required
body	UpdateEntity	The JSON body of the request. Contains tags to be added to the process group.	body	optional

Request parameters JSON model

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

This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request. See the Example expandable section for working sample request.

      
  {
  "tags": [
    "office-linz",
    "office-klagenfurt"
  ]
}

Response format

A successful request doesn't return any content.

Example

In this example, the request assigns the PHP tag to the PHP-FPM process group, which has the ID of PROCESS_GROUP-E5C3CC7EC1F80B5B.

The API token is passed in the Authorization header.

Curl

curl -X POST \
  https://mySampleEnv.live.dynatrace.com/api/v1/entity/infrastructure/process-groups/PROCESS_GROUP-E5C3CC7EC1F80B5B \
  -H 'Authorization: Api-Token abcdefjhij1234567890' \  
  -H 'Content-Type: application/json' \
  -d '{
  "tags": [
    "PHP"
  ]
}'

Request URL

https://mySampleEnv.live.dynatrace.com/api/v1/entity/infrastructure/process-groups/PROCESS_GROUP-E5C3CC7EC1F80B5B

Request body

{
  "tags": [
    "PHP"
  ]
}

Response code

204