为一个 GTM 实例上报地址池或地址的当前负载和目标负载。云调度 GTM 会根据该 API 上报的负载调整地址池或地址的流量分配比例。

注意事项

在调用该 API 前，您需要确保 GTM 实例的路由模式是负载反馈。参见 配置 GTM 实例。

请求说明

• 请求方式：POST
• 请求地址：https://open.volcengineapi.com/?Action=UpdateLoad&Version=2023-01-01

调试

请求参数

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

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

请求示例

POST https://open.volcengineapi.com/?Action=UpdateLoad&Version=2023-01-01

{
    "GtmId":"8234cb50-f957-4be9-b515-55c5d419ea9e",
    "Timestamp": 1700805259,
    "Statistics": [
        {
            "AddrValue": "1.1.1.1",
            "CurrentLoad": 20,
            "TargetLoad": 30,
            "Capacity": 50
        }
        {
            "AddrValue": "1.1.1.2",
            "CurrentLoad": 10,
            "TargetLoad": 20,
            "Capacity": 30
        },
    ]
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202307261734323E142F8FA3C8461563CC",
        "Action": "UpdateLoad",
        "Version": "2023-01-01",
        "Service": "GTM",
        "Region": "cn-north-1"
}

错误码

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