OpenPipeline API - POST verify a matcher

Verifies if the given matcher is valid.

The request produces an application/json payload.

POST SaaS https://{your-environment-id}.apps.dynatrace.com/platform/openpipeline/v1/matcher/verify

You can execute this request also with an OAuth2 client with openpipeline:configurations:read permission.

To learn how to obtain and use it, see OAuth clients.

Parameters

Parameter	Type	Description	In	Required
body	MatcherVerifyRequest	Single matcher to verify.	body	required

Request body objects

The `MatcherVerifyRequest` object

Element	Type	Description	Required
configurationId	string	Identifier of the configuration in which the validity of the matcher query should be verified.	optional
context	string	Context in which the validity of the matcher query should be verified. Takes the stage identifier, for example "processing" or "ROUTING_RULE" for routing entries.	optional
query	string	The matcher query to process.	optional

Request body JSON model

This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.

{
  "query": "matchesValue(type, \"security\")"
}

Response

Response codes

Code	Type	Description
200	VerifyResponse	Returns the verification result of the matcher.
4XX	ErrorResponseEnvelope	Client-side error.
5XX	ErrorResponseEnvelope	Server-side error.

Response body objects

The `VerifyResponse` object

Verify response.

Element	Type	Description
notifications	MetadataNotification[]	The notifications related to the supplied input string.
valid	boolean	True if the supplied input string is valid.

The `MetadataNotification` object

The message that provides additional information about the execution of the input string.

Element	Type	Description
arguments	string[]	The arguments for the message format.
message	string	The complete message of the notification.
messageFormat	string	The message format of the notification, string.format based
messageFormatSpecifierTypes	string[]	The corresponding types for each format specifier used in the error message format.
notificationType	string	The notification type.
severity	string	The severity of the notification, currently: INFO, WARN, ERROR.
syntaxPosition	TokenPosition	The position of a token in the input string used for errors and notification to map the message to a specific part of the input.

The `TokenPosition` object

The position of a token in the input string used for errors and notification to map the message to a specific part of the input.

Element	Type	Description
end	PositionInfo	The exact position in the query string.
start	PositionInfo	The exact position in the query string.

The `PositionInfo` object

The exact position in the query string.

Element	Type	Description
column	integer	Input string position column zero based index.
index	integer	Input string position index.
line	integer	Input string position line zero based index.

Response body JSON model

{
  "valid": false,
  "notifications": [
    {
      "severity": "ERROR",
      "syntaxPosition": {
        "start": {
          "column": 1,
          "index": 0,
          "line": 1
        },
        "end": {
          "column": 6,
          "index": 5,
          "line": 1
        }
      },
      "message": "There's been an error during parsing: There's no command `parsee`."
    }
  ]
}

JSON models

The `ErrorResponseEnvelope` object

Encloses the encountered error.

Element	Type	Description
error	ErrorResponse	Basic information of the encountered error.

The `ErrorResponse` object

Basic information of the encountered error.

Element	Type	Description
code	integer	The returned HTTP status code.
details	ErrorResponseDetails	Detailed information of the error.
message	string	Description of the encountered error.

The `ErrorResponseDetails` object

Detailed information of the error.

Element	Type	Description
type	string	Defines the actual set of fields depending on the value. See one of the following objects: `constraintViolation` -> ConstraintViolationDetails `constraintViolation`

The `ConstraintViolationDetails` object

List of encountered constraint violations.

Element	Type	Description
constraintViolations	ConstraintViolation[]	List of encountered constraint violations.

The `ConstraintViolation` object

Information about a single constraint violation.

Element	Type	Description
message	string	Description of the constraint violation.

OpenPipeline API - POST verify a matcher

Parameters

Request body objects

The MatcherVerifyRequest object

Request body JSON model

Response

Response codes

Response body objects

The VerifyResponse object

The MetadataNotification object

The TokenPosition object

The PositionInfo object