文档中心

专线连接

专线健康检查

DescribeDirectConnectHealthChecks - 查询专线健康检查列表

调用 DescribeDirectConnectHealthChecks 接口，查询符合要求的健康检查实例的详细信息。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action String 必选示例值：DescribeDirectConnectHealthChecks

接口名称。当前 API 的名称为 DescribeDirectConnectHealthChecks。

Version String 必选示例值：2020-04-01

接口版本。当前 API 的版本为 2020-04-01。

DirectConnectHealthCheckIds.N String 可选示例值：dhc-2752hz4tek****

健康检查实例的ID。

参数 - N：表示健康检查实例ID的序号，单次调用数量上限100个。

多个健康检查实例ID之间用&分隔。

DirectConnectHealthCheckName String 可选示例值：dchc-01

健康检查实例的名称。

PageNumber Integer 可选示例值：1

列表的页码。

如需传入此参数，请传入非负整数。

不传或传入0，则均默认为1。

PageSize Integer 可选示例值：20

分页查询时每页的行数。最大值为100，默认值为20。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

TotalCount Integer 示例值：1

满足指定条件的健康检查实例总数。

PageNumber Integer 示例值：1

当前页码。

PageSize Integer 示例值：20

当前分页的行数。

DirectConnectHealthChecks Object[] 示例值：-

健康检查实例的详细信息。

VpcId String 示例值：vpc-01

健康检查实例所在的私有网络。

Status String 示例值：Available

健康检查实例的状态。

Creating: 创建中

Deleting: 删除中

Pending：配置中

Available：可用

SubnetId String 示例值：subnet-2752hyf603yf

目标监测源IP所在的子网。

AccountId String 示例值：20******57

资源归属账号ID。

UpdateTime String 示例值：2021-12-07T15:57:22+08:00

健康检查实例更新的时间。

Description String 示例值：This is a healthcheck

健康检查实例的描述。

CreationTime String 示例值：2021-12-07T15:57:22+08:00

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

DirectConnectHealthCheckId String 示例值：dhc-274oahfm8gjy87fap8tpn6n1c

健康检查实例的ID。

DirectConnectHealthCheckName String 示例值：dchc-01

健康检查实例的名称。

DirectConnectHealthCheckProbeIds String[] 示例值：dhp-2752hz4****

健康检查实例中包含的探针列表。

请求示例

返回示例

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	InvalidPage.Malformed	The specified page is malformed.	指定的分页参数不合法。
400	LimitExceeded.DirectConnectHealthCheckId	You've reached the limit on the number of direct connect health check IDs that you can describe.	已达到可查询的健康检查ID数量上限。

最近更新时间：2026.01.23 17:00:42

这个页面对您有帮助吗？

有用

无用