Conditional naming API - GET a naming rule
Gets parameters of the specified conditional naming rule.
The request produces an application/json
payload.
GET | ManagedDynatrace for Government | https://{your-domain}/e/{your-environment-id}/api/config/v1/conditionalNaming/{type}/{id} |
SaaS | https://{your-environment-id}.live.dynatrace.com/api/config/v1/conditionalNaming/{type}/{id} | |
Environment ActiveGate | https://{your-activegate-domain}:9999/e/{your-environment-id}/api/config/v1/conditionalNaming/{type}/{id} |
Authentication
To execute this request, you need an access token with ReadConfig
scope.
To learn how to obtain and use it, see Tokens and authentication.
Parameters
Parameter | Type | Description | In | Required |
---|---|---|---|---|
type | string | The type of the rule, defined by the type of Dynatrace entities to which the rule applies.
| path | required |
id | string | The ID of the required naming rule. | path | required |
Response
Refer to JSON models to find all JSON models that depend on the type of the model.
Response codes
Code | Type | Description |
---|---|---|
200 | ConditionalNamingRule | Success |
Response body objects
The ConditionalNamingRule
object
The rule for the conditional naming.
Element | Type | Description |
---|---|---|
displayName | string | The name of the rule |
enabled | boolean | The rule is enabled ( |
id | string | The ID of the naming rule. |
metadata | ConfigurationMetadata | Metadata useful for debugging |
nameFormat | string | The name to be assigned to matching entities. You can use the following placeholders here:
|
rules | EntityRuleEngineCondition[] | A list of matching conditions of the rule. The rule applies only if all conditions are fulfilled. |
type | string | The type of Dynatrace entities to which the rule applies.
|
The ConfigurationMetadata
object
Metadata useful for debugging
Element | Type | Description |
---|---|---|
clusterVersion | string | Dynatrace version. |
configurationVersions | integer[] | A sorted list of the version numbers of the configuration. |
currentConfigurationVersions | string[] | A sorted list of version numbers of the configuration. |
The EntityRuleEngineCondition
object
A condition defines how to execute matching logic for an entity.
Element | Type | Description |
---|---|---|
comparisonInfo | ComparisonBasic | Defines how the matching is actually performed: what and how are we comparing. The actual set of fields and possible values of the operator field depend on the type of the comparison. Find the list of actual objects in the description of the type field or see JSON models. |
key | ConditionKey | The key to identify the data we're matching. The actual set of fields and possible values depend on the type of the key. Find the list of actual objects in the description of the type field or see JSON models. |
The ComparisonBasic
object
Defines how the matching is actually performed: what and how are we comparing.
The actual set of fields and possible values of the operator field depend on the type of the comparison. Find the list of actual objects in the description of the type field or see JSON models.
Element | Type | Description |
---|---|---|
negate | boolean | Reverses the comparison operator. For example it turns the begins with into does not begin with. |
operator | string | Operator of the comparison. You can reverse it by setting negate to Possible values depend on the type of the comparison. Find the list of actual models in the description of the type field and check the description of the model you need. |
type | string | Defines the actual set of fields depending on the value. See one of the following objects:
|
value | object | The value to compare to. |
The ConditionKey
object
The key to identify the data we're matching.
The actual set of fields and possible values depend on the type of the key. Find the list of actual objects in the description of the type field or see JSON models.
Element | Type | Description |
---|---|---|
attribute | string | The attribute to be used for comparison.
|
type | string | Defines the actual set of fields depending on the value. See one of the following objects:
|
Response body JSON model
1{2 "displayName": "TestRule",3 "enabled": true,4 "id": "4e88530c-edec-4e31-9cb4-3f2c63abc2b7",5 "nameFormat": "TestNameFormat",6 "rules": [7 {8 "comparisonInfo": {9 "negate": "false",10 "operator": "EQUALS",11 "type": "SIMPLE_TECH",12 "value": {13 "type": "JAVA"14 }15 },16 "key": {17 "attribute": "PROCESS_GROUP_TECHNOLOGY"18 }19 },20 {21 "comparisonInfo": {22 "caseSensitive": true,23 "negate": "false",24 "operator": "CONTAINS",25 "type": "STRING",26 "value": "test"27 },28 "key": {29 "attribute": "PROCESS_GROUP_PREDEFINED_METADATA",30 "dynamicKey": "EXE_NAME",31 "type": "PROCESS_PREDEFINED_METADATA_KEY"32 }33 }34 ],35 "type": "PROCESS_GROUP"36}