Failure detection API - GET a detection rule
Gets the specified failure detection rule.
The request produces an application/json
payload.
GET | SaaS | https://{your-environment-id}.live.dynatrace.com/api/config/v1/service/failureDetection/parameterSelection/rules/{id} |
Environment ActiveGate | https://{your-activegate-domain}:9999/e/{your-environment-id}/api/config/v1/service/failureDetection/parameterSelection/rules/{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
The ID of the required failure detection rule. Needs to be a valid RFC 4122 UUID.
Response
To find all model variations that depend on the type of the model, see JSON models.
Response codes
Failed. The specified entity doesn't exist.
Response body objects
The FailureDetectionRule
object
Configuration of the failure detection rule.
A list of conditions of the rule.
The rule applies when all conditions are fulfilled.
A short description of the rule.
The rule is enabled (true
) or disabled (false
).
The failure detection parameter (FDP) set of the rule.
Specify the ID of the set here. The FDP set must exist at the time of rule creation.
The ID of the rule.
The display name of the rule.
The length of the name is limited to 150 characters.
The FailureDetectionCondition
object
The condition of the failure detection rule.
The attribute to be checked.
PG_NAME
PG_TAG
SERVICE_MANAGEMENT_ZONES
SERVICE_NAME
SERVICE_SERVICE_TYPE
SERVICE_TAG
The predicate that tests the value of the attribute.
The actual set of fields depends on the type of the predicate. Find the list of actual objects in the description of the type field or see Failure detection API - JSON models.
The FdcPredicate
object
The predicate that tests the value of the attribute.
The actual set of fields depends on the type of the predicate. Find the list of actual objects in the description of the type field or see Failure detection API - JSON models.
Defines the actual set of fields depending on the value. See one of the following objects:
STRING_EQUALS
-> FdcPredicateStringEqualsSTRING_STARTS_WITH
-> FdcPredicateStringStartsWithSTRING_ENDS_WITH
-> FdcPredicateStringEndsWithSTRING_CONTAINS_SUBSTRING
-> FdcPredicateStringContainsINTEGER_EQUALS
-> FdcPredicateIntegerEqualsINTEGER_LESS_THAN
-> FdcPredicateIntegerLessThanINTEGER_LESS_THAN_OR_EQUAL
-> FdcPredicateIntegerLessThanOrEqualINTEGER_GREATER_THAN
-> FdcPredicateIntegerGreaterThanINTEGER_GREATER_THAN_OR_EQUAL
-> FdcPredicateIntegerGreaterThanOrEqualLONG_EQUALS
-> FdcPredicateLongEqualsLONG_LESS_THAN
-> FdcPredicateLongLessThanLONG_LESS_THAN_OR_EQUAL
-> FdcPredicateLongLessThanOrEqualLONG_GREATER_THAN
-> FdcPredicateLongGreaterThanLONG_GREATER_THAN_OR_EQUAL
-> FdcPredicateLongGreaterThanOrEqualTAG_KEY_EQUALS
-> FdcPredicateTagKeyEqualsTAG_EQUALS
-> FdcPredicateTagEqualsSERVICE_TYPE_EQUALS
-> FdcPredicateServiceTypeEqualsMANAGEMENT_ZONES_CONTAINS_ALL
-> FdcPredicateManagementZonesContainsAllSET_OF_INTEGERS_CONTAINS_ANY
-> FdcPredicateSetOfIntegersContainsAnySET_OF_INTEGERS_CONTAINS_ALL
-> FdcPredicateSetOfIntegersContainsAll
INTEGER_EQUALS
INTEGER_GREATER_THAN
INTEGER_GREATER_THAN_OR_EQUAL
INTEGER_LESS_THAN
INTEGER_LESS_THAN_OR_EQUAL
LONG_EQUALS
LONG_GREATER_THAN
LONG_GREATER_THAN_OR_EQUAL
LONG_LESS_THAN
LONG_LESS_THAN_OR_EQUAL
MANAGEMENT_ZONES_CONTAINS_ALL
SERVICE_TYPE_EQUALS
SET_OF_INTEGERS_CONTAINS_ALL
SET_OF_INTEGERS_CONTAINS_ANY
STRING_CONTAINS_SUBSTRING
STRING_ENDS_WITH
STRING_EQUALS
STRING_STARTS_WITH
TAG_EQUALS
TAG_KEY_EQUALS
Response body JSON model
{"conditions": [{"attribute": "SERVICE_NAME","predicate": {"ignoreCase": false,"type": "STRING_STARTS_WITH","values": ["shp","stg_shp"]}}],"description": "for requests from shipping module","enabled": true,"fdpId": "FDP_9","id": "R_5","name": "shipping"}