调用DescribeSiteMonitorStatistics接口查询指定站点监控任务中指定监控项的平均统计数据。
本文将提供一个示例,查询站点监控任务ef4cdc8b-9dc7-43e7-810e-f950e56c****
中监控项Availability
(可用率)的平均统计数据。返回结果显示可用率为100
。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeSiteMonitorStatistics | 系统规定参数。取值:DescribeSiteMonitorStatistics。 |
TaskId | String | 是 | ef4cdc8b-9dc7-43e7-810e-f950e56c**** | 站点监控任务ID。 关于如何获取站点监控任务ID,请参见DescribeSiteMonitorList。 |
TimeRange | String | 否 | 1440 | 统计周期。 单位:分钟。默认值:1440(1天)。最大值:43200(30天)。 |
StartTime | String | 否 | 1576142850527 | 开始时间戳。 单位:毫秒。默认值为当前时间向前推1小时。 |
MetricName | String | 是 | Availability | 监控项名称。取值:
|
关于公共请求参数的详情,请参见公共参数。
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Code | String | 200 | 状态码。 说明 200表示成功。 |
Message | String | Successful | 返回信息。 |
Data | String | 100 | 统计结果。 |
RequestId | String | 3AD2724D-E317-4BFB-B422-D6691D071BE1 | 请求ID。 |
Success | String | true | 操作是否成功。取值:
|
示例
请求示例
http(s)://[Endpoint]/?Action=DescribeSiteMonitorStatistics
&MetricName=Availability
&TaskId=ef4cdc8b-9dc7-43e7-810e-f950e56c****
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeSiteMonitorStatisticsResponse>
<Message>successful</Message>
<RequestId>3AD2724D-E317-4BFB-B422-D6691D071BE1</RequestId>
<Data>100</Data>
<Code>200</Code>
<Success>true</Success>
</DescribeSiteMonitorStatisticsResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"Message" : "successful",
"RequestId" : "3AD2724D-E317-4BFB-B422-D6691D071BE1",
"Data" : 100,
"Code" : "200",
"Success" : true
}
错误码
访问错误中心查看更多错误码。