docs
api
Global Dynamic Acceleration(PathX)
DescribeUPathTemplate

Query the monitoring template of UPath - DescribeUPathTemplate

Overview

Query the monitoring template of UPath

Definition

Public Parameters

Parameter NameTypeDescription InformationRequired
ActionstringCorresponding API command name, the current API is DescribeUPathTemplate.Yes
PublicKeystringThe user's public key can be obtained from Console (opens in a new tab)Yes
SignaturestringUser signature generated based on public key and API command, see Signature AlgorithmYes

Request Parameters

Parameter NameTypeDescription InformationRequired
ProjectIdstringProject ID. Please refer to the GetProjectList interface.Yes
UPathIdstringAcceleration Line Instance ID, format upath-xxxxYes

Response Field

Field NameTypeDescription InformationRequired
RetCodeintReturn status code. If it is 0, it means successful return. If it is not 0, it means failure.Yes
ActionstringOperation command name.Yes
MessagestringReturns an error message, providing detailed description when RetCode is non-zero.No
DataSetarray[AlarmRuler]Monitoring Template DetailsYes

Data Model

AlarmRuler

Field NameTypeDescription InformationRequired
AlarmStrategystringConvergence Strategy, optional range ['Exponential','Continuous','Once'], corresponding to Exponential Increase, Continuous Alert, Single Alert respectively.Yes
AlarmFrequencyintAlarm detection cycle, in secondsYes
ComparestringComparison strategy, optional ['GE','LE'] respectively represent not less than and not greater thanYes
ContactGroupIdintContact Group IDYes
MetricNamestringAlarm Metric Name, all 'n' counts must be consistent. Currently, only the following four items are allowed: UpathNetworkOut: Outbound Bandwidth, UpathNetworkIn: Inbound Bandwidth, UpathNetworkOutUsage: Outbound Bandwidth Usage, UpathNetworkInUsage: Inbound Bandwidth Usage.Yes
ThresholdintAlarm threshold, the threshold range for bandwidth usage is an integer between [50,100], the bandwidth alarm threshold is a multiple of 1000000, for example, if it exceeds 2Mbps, the alarm threshold should be set to 2000000.Yes
TriggerCountintAlarm Trigger Cycle (Times)Yes
AlarmTemplateRuleIdintAlarm Template Strategy IDYes
ResourceTypestringResource TypeNo

Example

Request Example

https://api.surfercloud.com/?Action=DescribeUPathTemplate
&ProjectId=org-xxxx
&UPathId=upath-xxxx

Response Example

{
  "Action": "DescribeUPathTemplateResponse",
  "DataSet": [
    {
      "AlarmFrequency": 0,
      "AlarmStrategy": "Exponential",
      "AlarmTemplateRuleId": 19733,
      "Compare": "GE",
      "ContactGroupId": 106696,
      "MetricName": "UpathNetworkIn",
      "ResourceType": "upath",
      "Threshold": 10000000,
      "TriggerCount": 3
    },
    {
      "AlarmFrequency": 0,
      "AlarmStrategy": "Exponential",
      "AlarmTemplateRuleId": 19734,
      "Compare": "GE",
      "ContactGroupId": 106696,
      "MetricName": "UpathNetworkOut",
      "ResourceType": "upath",
      "Threshold": 10000000,
      "TriggerCount": 3
    }
  ],
  "Message": "",
  "RetCode": 0
}
  • Company
  • ContactUs
  • Blog
Copyright © 2024 SurferCloud All Rights Reserved