Service detection API - PUT an opaque web request rule

The OpaqueAndExternalWebRequestRule object

The service detection rule of the OPAQUE_AND_EXTERNAL_WEB_REQUEST type.

The PublicDomainName object

The contribution to the service ID calculation from the domain name where the web request has been detected.

You have two mutually exclusive options:

• Override the detected value with a specified static value. Specify the new value in the valueOverride field.
• Dynamically transform the detected value. Specify the transformation parameters in the transformations field.

The Port object

The contribution to the service ID calculation from the port, where the web request has been detected.

The ContextRoot object

The contribution to the service ID calculation from the detected context root.

The context root is the first segment of the request URL after server name. For example, in the www.dynatrace.com/support/help/extend-dynatrace/dynatrace-api/ URL the context root is support.

You have two options:

• Keep a part of the detected URL. Specify the number of segments to be kept in the segmentsToCopyFromUrlPath field.
• Dynamically transform the detected URL. Specify the transformation parameters in the transformations field.

You can use one or both options. If you use both, the transformation applies to the modified URL.

The ContextRootTransformation object

Configuration of transformation of the detected value.

If several transformations are specified, they are handled sequentially from top to bottom. Each transformation is applied to the result of the preceding transformation. For example, the second transformation is applied to the result of the first transformation.

The actual set of fields depends on the type of the transformation.

The ApplicationId object

The contribution to the service ID calculation from the detected application ID.

You have two mutually exclusive options:

• Override the detected value with a specified static value. Specify the new value in the valueOverride field.
• Dynamically transform the detected value. Specify the transformation parameters in the transformations field.

The TransformationBase object

Configuration of transformation of the detected value.

If several transformations are specified, they are handled sequentially from top to bottom. Each transformation is applied to the result of the preceding transformation. For example, the second transformation is applied to the result of the first transformation.

The actual set of fields depends on the type of the transformation.

The ConditionsOpaqueAndExternalWebRequestAttributeTypeDto object

A condition of the service detection rule.

The CompareOperation object

The condition of the rule.

The actual set of fields depends on the type of the condition.

      
  {
  "type": "OPAQUE_AND_EXTERNAL_WEB_REQUEST",
  "name": "My sample rule",
  "description": "REST API example\n",
  "enabled": true,
  "managementZones": [
    "zone1"
  ],
  "conditions": [
    {
      "attributeType": "URL_HOST_NAME",
      "compareOperations": [
        {
          "type": "STRING_CONTAINS",
          "ignoreCase": "false",
          "values": [
            "value1",
            "value2"
          ]
        }
      ]
    }
  ],
  "applicationId": {
    "valueOverride": "abc"
  },
  "contextRoot": {
    "segmentsToCopyFromUrlPath": 2,
    "transformations": [
      {
        "type": "BEFORE",
        "delimiter": "/"
      }
    ]
  },
  "port": {
    "doNotUseForServiceId": "true"
  },
  "publicDomainName": {
    "copyFromHostName": "true",
    "transformations": [
      {
        "type": "BEFORE",
        "delimiter": "/"
      }
    ]
  }
}
      
    

The EntityShortRepresentation object

The short representation of a Dynatrace entity.

    
{
  "id": "6a98d7bc-abb9-44f8-ae6a-73e68e71812a",
  "name": "Dynatrace entity",
  "description": "Dynatrace entity for the REST API example\n"
}