调用DescribeHealthCheckAttribute查询健康检查实例详情。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeHealthCheckAttribute

系统规定参数。取值:DescribeHealthCheckAttribute

RegionId String cn-shanghai

智能接入网关实例的地域ID。

HcInstanceId String hc-1k4ucuq77b56x4****

健康检查实例ID。

SmartAGId String sag-1um5x5nwhilymw****

智能接入网关实例ID。

返回数据

名称 类型 示例值 描述
SrcPort Integer 2334

健康检查的源端口。

说明 该功能目前不支持。
Description String hc-123

健康检查实例描述。

RequestId String DDA08B78-5634-4A83-94E4-5C58FD7EBA19

请求ID。

SrcIpAddr String 10.XX.XX.1

健康检查的源地址。

CreateTime Long 1586759657000

健康检查实例创建时间戳。

单位:毫秒。

FailCountThreshold Integer 3

连续探测失败次数阈值。

取值范围:1~15

默认值:3

DstPort Integer 1223

健康检查的目的端口。

说明 该功能目前不支持。
Name String bvt-test-03****

健康检查实例名称。

ProbeCount Integer 3

每次健康检查探测次数。

取值范围:1~20

默认值:1

Type String ICMP_ECHO

健康检查报文类型。

目前仅支持ICMP_ECHO

ProbeTimeout Integer 1000

健康检查一次探测的超时时间。

取值范围:10~30000

默认值:1000

单位:毫秒。

HcInstanceId String hc-1k4ucuq77b56x4****

健康检查实例ID。

RttThreshold Integer 300

双向时延阈值。

取值:-11~5000

默认值:-1,表示不配置双向时延阈值。

ProbeInterval Integer 2000

健康检查配置探测间隔,一次探测未完成情况下,不会发起下一次探测。

取值范围:1000~60000

默认值:2000

单位:毫秒。

SmartAGId String sag-1um5x5nwhilymw****

智能接入网关实例ID。

RttFailThreshold Integer 3

时延阈值触发次数。

取值范围:1~15

默认值:3

DstIpAddr String 192.XX.XX.1

健康检查的目的地址。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeHealthCheckAttribute
&HcInstanceId=hc-1k4ucuq77b56x4****
&RegionId=cn-shanghai
&SmartAGId=sag-1um5x5nwhilymw****
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeHealthCheckAttributeResponse>
<CreateTime>1586759657000</CreateTime>
<Description>TEST</Description>
<SrcPort>44</SrcPort>
<RequestId>66ECCDF6-7290-44A6-A2D0-3B926CEE82C6</RequestId>
<SrcIpAddr>2.XX.XX.1</SrcIpAddr>
<FailCountThreshold>3</FailCountThreshold>
<DstPort>33</DstPort>
<Name>TEST</Name>
<ProbeCount>5</ProbeCount>
<Type>ICMP_ECHO</Type>
<ProbeTimeout>30</ProbeTimeout>
<HcInstanceId>hc-l3x9k16ag24d6j****</HcInstanceId>
<RttThreshold>-1</RttThreshold>
<ProbeInterval>2000</ProbeInterval>
<SmartAGId>sag-4goc1sj3c978z2****</SmartAGId>
<RttFailThreshold>5</RttFailThreshold>
<DstIpAddr>12.XX.XX.1</DstIpAddr>
</DescribeHealthCheckAttributeResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "CreateTime" : 1586759657000,
  "Description" : "TEST",
  "SrcPort" : 44,
  "RequestId" : "66ECCDF6-7290-44A6-A2D0-3B926CEE82C6",
  "SrcIpAddr" : "2.XX.XX.1",
  "FailCountThreshold" : 3,
  "DstPort" : 33,
  "Name" : "TEST",
  "ProbeCount" : 5,
  "Type" : "ICMP_ECHO",
  "ProbeTimeout" : 30,
  "HcInstanceId" : "hc-l3x9k16ag24d6j****",
  "RttThreshold" : -1,
  "ProbeInterval" : 2000,
  "SmartAGId" : "sag-4goc1sj3c978z2****",
  "RttFailThreshold" : 5,
  "DstIpAddr" : "12.XX.XX.1"
}

错误码

HttpCode 错误码 错误信息 描述
400 HC.InstanceNoFound The specified network health check instance does not exist. 健康检查实例不存在。

访问错误中心查看更多错误码。