修改静态调度策略--多云CDN-火山引擎

文档中心

立即注册

导航

修改静态调度策略

最近更新时间：2024.08.23 17:21:13首次发布时间：2024.03.13 10:26:59

调用本接口修改指定静态调度策略的流量分配设置。

说明

本接口只可用于修改已有静态调度策略的流量分配比例，不能修改调度区域。如需基于新的调度区域指定流量分配比例，请调用 AddDnsScheduleStaticWeight 接口创建一条新的静态调度策略。

使用说明

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

使用限制

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

请求说明

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

请求参数

Query

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

Body

参数名称	数据类型	是否必选	参数说明	示例
DnsScheduleId	String	是	指定静态调度策略所属调度实例的 ID。说明调度实例 ID 是多云CDN为调度实例分配的唯一标识符。您可以调用 ListDnsSchedules 接口查询所有调度实例的 ID。	`27557981222815XXXX`
WeightId	String	是	指定要修改的静态调度策略的 ID。说明调度策略 ID 是多云CDN为调度策略分配的唯一标识符。您可以调用 DescribeDnsScheduleStaticWeights 接口查询调度实例下所有静态调度策略的 ID。	`28368966611182XXXX`
WeightItems	Object[]	是	为当前调度区域设置流量分配比例。

返回参数

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

请求示例

POST https://open.volcengineapi.com/?Action=UpdateDnsScheduleStaticWeight&Version=2022-03-01&<其他公共请求参数>=
{
    "DnsScheduleId": "27557981222815XXXX",
    "WeightId": "28368966611182XXXX",
    "WeightItems": [
        {
            "DomainId": "655372e030060dd533f9****",
            "Value": 70
        },
                {
            "DomainId": "65537682167cb75a3dc4****",
            "Value": 30
        }
    ]
}

返回示例

{
    "ResponseMetadata": {
        "RequestID": "202402222021333D5D3EC369D05A87EF09",
        "Action": "UpdateDnsScheduleStaticWeight",
        "Version": "2022-03-01",
        "Service": "mcdn",
        "Region": "cn-north-1"
    },
    "Result": {}
}

错误码

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