You need to enable JavaScript to run this app.
导航
修改静态调度策略
最近更新时间:2024.03.13 10:26:59首次发布时间: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 请求失败。关于更多错误码的信息,参见错误码