Docs
api
Global Dynamic Acceleration(PathX)
GetPathXMetric

Obtain global acceleration monitoring information - GetPathXMetric

Overview

Obtain global acceleration monitoring information

Definition

Public Parameters

Parameter NameTypeDescription InformationRequired
ActionstringCorresponding API command name, the current API is GetPathXMetric.Yes
PublicKeystringThe user’s public key can be obtained from ConsoleYes
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
ResourceIdstringResource ID, such as upath ID and uga IDYes
BeginTimeintQuery start time, 10-digit timestampYes
EndTimeintQuery end time, 10-digit timestampYes
MetricName.NstringQuery the monitoring metrics. Currently, only the following four items are allowed: NetworkOut: Outbound bandwidth, NetworkIn: Inbound bandwidth, NetworkOutUsage: Outbound bandwidth usage rate, NetworkInUsage: Inbound bandwidth usage rate.Yes
ResourceTypestringupath: Acceleration Line, uga: Acceleration InstanceYes
LineIdstringSpecific line id, call the DescribePathXLineConfig interface to get the line listYes

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
DataSetMetricPeriodMonitoring Data Result SetNo

Data Model

MetricPeriod

Field NameTypeDescription InformationRequired
NetworkOutarray[MatricPoint]Outgoing BandwidthNo
NetworkInarray[MatricPoint]Inbound BandwidthNo
NetworkOutUsagearray[MatricPoint]Outbound Bandwidth UsageNo
NetworkInUsagearray[MatricPoint]Inbound Bandwidth UsageNo

MatricPoint

Field NameTypeDescription InformationRequired
TimestampintNo
ValueintNo

Example

Request Example

https://api.dezai.com/?Action=GetPathXMetric
&ProjectId=org-ejcxxx
&ResourceType=upath
&ResourceId=upath-1boe2u
&BeginTime=1568797253
&EndTime=1568800853
&LineId=line_cn_afr-nigeria
&MetricName.0=NetworkOutUsage
&MetricName.1=NetworkInUsage

Response Example

{
  "Action": "GetPathXMetricResponse",
  "DataSet": {
    "NetworkIn": null,
    "NetworkInUsage": [
      {
        "Timestamp": 1568797260,
        "Value": 12
      },
      {
        "Timestamp": 1568797320,
        "Value": 18
      },
      {
        "Timestamp": 1568797380,
        "Value": 17
      },
      {
        "Timestamp": 1568797440,
        "Value": 17
      }
    ],
    "NetworkOut": null,
    "NetworkOutUsage": [
      {
        "Timestamp": 1568797260,
        "Value": 14
      },
      {
        "Timestamp": 1568797320,
        "Value": 23
      },
      {
        "Timestamp": 1568797380,
        "Value": 21
      },
      {
        "Timestamp": 1568797440,
        "Value": 20
      }
    ]
  },
  "Message": "",
  "RetCode": 0
}