Querying Monitoring Data (Offline Soon)

Function

This API is used to query monitoring data of metrics within a specified time period. You can specify a dimension or period to query data.

URI

POST /v1/{project_id}/ams/metricdata?fillValue=xx

For details about the substitute API, see Querying Monitoring Data.

Table 1 describes the parameters.

Request

Request parameters

Table 2 describes the request parameters.

Request headers

Table 3 describes the request headers.

Example request

{ 
    "metrics": [ 
        { 
            "namespace": "abc", 
            "metricName": "def", 
            "dimensions": [ 
                { 
                    "name": "instance_id", 
                    "value": "demo1" 
                } 
            ] 
        } 
    ], 
    "period": 60, 
    "timerange": "-1.-1.5",//Last 5 minutes
      "statistics": [ 
        "maximum", 
        "minimum", 
        "sum" 
    ] 
}

Response

Response parameters

Table 4 describes the response parameters.

Example response

{ 
    "errorCode": "SVCSTG.AMS.2000", 
    "errorMessage": "success", 
    "metrics": [{ 
      "metric": { 
        "namespace": "abc", 
        "metricName": "def", 
        "dimensions": [{ 
          "name": "ghi", 
          "value": "lmn" 
        }] 
      }, 
      "dataPoints": [{ 
        "timestamp": 1467892800000, 
        "unit": "Percent", 
        "statistics": [{ 
          "statistic": "maximum", 
          "value": 23
        }] 
      }] 
    }] 
}

Status Code

• Success response

  Table 5 describes the status code.

  Table 5 Status code

  Status Code	Message	Description
  200	OK	The request has succeeded.

• Error response

  Table 6 describes the status codes. For more information, see Status Codes.

  Table 6 Status codes

  Status Code	Message	Description
  400	Bad Request	The request is invalid. The client should not repeat the request without modifications.
  401	Unauthorized	The authorization information provided by the client is incorrect or invalid.
  403	Forbidden	The request is rejected. The server has received the request and understood it, but the server is refusing to respond to it. The client should not repeat the request without modifications.
  500	InternalServerError	The server is able to receive the request but unable to understand the request.
  503	Service Unavailable	The requested service is invalid. The client should not repeat the request without modifications.

Error Code