查询生效中的流量分配比例--多云CDN-火山引擎

文档中心

立即注册

导航

查询生效中的流量分配比例

最近更新时间：2024.12.16 14:13:47首次发布时间：2024.03.13 10:27:00

调用本接口查询指定调度实例下当前生效的流量分配比例。

使用说明

每个请求中必须包含鉴权信息。该鉴权信息用以验证请求者的身份。参见签名机制。

使用限制

节流限制：您每秒最多可以提交 10 个 API 请求。

请求说明

请求方式：POST
请求地址：https://open.volcengineapi.com/?Action=DescribeDnsScheduleActiveWeights&Version=2022-03-01

请求参数

Query

参数名称	数据类型	是否必选	参数说明
Action	String	是	接口名称。当前 API 的名称为 `DescribeDnsScheduleActiveWeights`。
Version	String	是	接口版本。当前 API 的版本为 `2022-03-01`。

Body

参数名称	数据类型	是否必选	参数说明	示例
DnsScheduleId	String	是	要查询的调度实例的 ID。说明调度实例 ID 是多云CDN为调度实例生成的唯一标识符。您可以调用 ListDnsSchedules 接口查询所有调度实例的 ID。	`27557981222815XXXX`

返回参数

参数名称	数据类型	参数说明	示例
ActiveWeights	Object[]	调度实例下当前生效的调度策略的信息列表。
TimeAt	Long	返回数据对应时刻。格式为 UNIX 时间戳，单位是秒。	`1708654068`

请求示例

POST https://open.volcengineapi.com/?Action=DescribeDnsScheduleActiveWeights&Version=2022-03-01&<其他公公请求参数>=
{
    "DnsScheduleId": "27557981222815XXXX"
}

返回示例

{
    "ResponseMetadata": {
        "RequestID": "202402231007475EC103FE9E893BCA73B6",
        "Action": "DescribeDnsScheduleActiveWeights",
        "Version": "2022-03-01",
        "Service": "mcdn",
        "Region": "cn-north-1"
    },
    "Result": {
        "ActiveWeights": [
            {
                "Country": "CN",
                "Province": "",
                "Isp": "",
                "WeightInfoItems": [
                    {
                        "DomainId": "654a589230060dd533d3****",
                        "Value": 33,
                        "ActualValue": 33
                    },
                    {
                        "DomainId": "655372e030060dd533f9****",
                        "Value": 34,
                        "ActualValue": 34
                    },
                    {
                        "DomainId": "65537682167cb75a3dc4****",
                        "Value": 33,
                        "ActualValue": 33
                    }
                ],
                "Strategy": "Static",
                "StrategyRelatedId": "27557981284891XXXX",
                "IsFailover": false
            },
            {
                "Country": "CN",
                "Province": "BJ",
                "Isp": "MOBILE",
                "WeightInfoItems": [
                    {
                        "DomainId": "655372e030060dd533f9****",
                        "Value": 70,
                        "ActualValue": 70
                    },
                    {
                        "DomainId": "65537682167cb75a3dc4****",
                        "Value": 30,
                        "ActualValue": 30
                    }
                ],
                "Strategy": "Static",
                "RelatedStrategyId": "28368966611182XXXX",
                "IsFailover": false
            }
        ],
        "TimeAt": 1708654068
    }
}

错误码

如果响应正文的 ResponseMetadata 字段中包含 Error 字段，则表示 API 请求失败。关于更多错误码的信息，参见错误码。