You need to enable JavaScript to run this app.
导航
TrafficRoute DNS 套件
  • 文档首页
    • /
  • TrafficRoute DNS 套件

获取健康检查参数

最近更新时间：2023.08.24 19:21:40

首次发布时间：2023.08.21 14:31:37

我的收藏

API 说明

API 名称：GetProbe。
API 域名：open.volcengineapi.com。
API 描述：获取指定调度策略的健康检查参数。

请求方法

POST

请求参数

除了以下参数，您还需要 对请求进行鉴权。

参数名称
数据类型参数类型是否必选参数说明
ActionString查询参数是API 的名称。该参数的取值是 GetProbe。
VersionString查询参数是API 的版本。该参数的取值是 2023-01-01。
GtmIdString查询参数是GTM 实例的 UUID。您可以通过 ListGtms API 获取 GtmId。
PolicyTypeString查询参数否健康检查对应的策略类型。默认为 geo。
  • geo：地理位置策略。
  • perf：性能最优策略。

响应正文

ResponseMetadata 对象

参数名称
数据类型
参数说明
RequestId
String
标识本次请求的 ID。
Action
String
Action 查询参数的值。
Version
String
API 版本。
Service
String
服务类型。
Region
String
服务所在区域。

Result 对象

参数名称
数据类型
参数说明
Nodes
String[]
健康检查探测点。
IsManualNodes
Boolean
是否手动配置健康检查探测点。
  • true：手动配置健康检查探测点。
  • false：使用推荐的健康检查探测点。
AdvisedNodeCount
Integer
推荐的健康检查探测点数量。
Protocol
String
健康检查使用的协议。
  • ping：ICMP 协议。
  • http：HTTP 协议。
  • https：HTTPS 协议。
Interval
Integer
每次健康检查的时间间隔。单位为秒。
Timeout
Integer
健康检查任务的超时时间。单位为秒。
PingLossRate
Integer
丢包率。单位为百分比。如果丢包率大于该参数的值，则判定为结果异常。例如，如果该参数为 10，且健康检查时的丢包率大于 10，则判定为结果异常。

该参数仅在健康检查协议设置为 ping 时有效。
PingCount
Integer
发包数量。如果您将该参数设置为 10，每次 ping 检查会同时发出 10 个数据包。

该参数仅在健康检查协议设置为 ping 时有效。
Host
String
健康检查目标地址的完整域名。

该参数仅在健康检查协议设置为 HTTP 或 HTTPS 时有效。
Port
Integer
健康检查目标地址的端口。

该参数仅在健康检查协议设置为 HTTP 或 HTTPS 时有效。
Url
String
健康检查目标地址的 path 部分，以 / 开头。

该参数仅在健康检查协议设置为 HTTP 或 HTTPS 时有效。
HttpMethod
String
HTTP 请求方法。

该参数仅在健康检查协议设置为 HTTP 或 HTTPS 时有效。
Disable
Boolean
是否关闭了健康检查。
  • true：已关闭。
  • false：已开启。

示例

请求示例

POST https://open.volcengineapi.com?Action=GetProbe&Version=2023-01-01&GtmId=2a8f91c4-aa07-4ae4-9ebc-68750d611822

响应示例

{
    "ResponseMetadata": {
        "RequestId": "20230727101602DD1F0149CC7954127AA2",
        "Action": "GetProbe",
        "Version": "2023-01-01",
        "Service": "GTM",
        "Region": "cn-north-1"
    },
    "Result": {
        "Nodes": [
            "福建 厦门市 中国移动",
            "江西 南昌市 中国移动",
            "山东 济南市 中国移动",
            "江西 南昌市 中国联通",
            "山东 济南市 中国联通",
            "山西 太原市 中国电信",
            "山东 青岛市 中国电信",
            "山东 济南市 中国电信"
        ],
        "IsManualNodes": false,
        "AdvisedNodeCount": 8,
        "Protocol": "ping",
        "Interval": 60,
        "Timeout": 5,
        "PingLossRate": 10,
        "PingCount": 20,
        "Host": "",
        "Port": 80,
        "Url": "",
        "HttpMethod": "GET",
        "Disable": false
    }
}