You need to enable JavaScript to run this app.
导航
停用云服务商加速 CNAME
最近更新时间:2024.12.16 14:13:48首次发布时间:2024.06.07 10:07:16

调用本接口在调度实例层面停用指定的云服务商加速 CNAME。
停用云服务商加速 CNAME 后,多云CDN的调度实例将暂停将用户请求路由到该云服务商的加速 CNAME。此操作会影响调度实例下所有已启用的调度策略。

示例:
假设某个静态策略引用了 Vendor[A] 的加速 CNAME,该策略中预设的流量分配比例为 Vendor[A]:Vendor[B]:Vendor[C] = 50%:10%:40%。
如果您停用了 Vendor[A] 的加速 CNAME,那么该策略的实际流量分配比例将变为 Vendor[A]:Vendor[B]:Vendor[C] = 0%:20%:80%。

使用说明

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

使用限制

  • 节流限制:您每秒最多可以提交 10 个 API 请求。
  • 操作限制:以下情形下,该操作不被允许:
    • 云服务商被某条调度策略引用,且在引用它的策略中,该云服务商是唯一使用的云服务商。
    • 云服务商被某条调度策略引用,且该策略是通过关联策略模板生成的。关于策略模板的更多信息,请参见管理模板

请求说明

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

请求参数

Query

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

Body

参数名称
数据类型
是否必选
参数说明
示例
DnsScheduleId
String

调度实例 ID。

说明

您可以调用 ListDnsSchedules 接口获取所有调度实例的 ID。

27557981222815XXXX
DomainId
String

通过云服务商加速域名 ID,指定要停用的加速 CNAME。

说明

您可以调用 DescribeDnsSchedule 接口获取指定调度实例包含的所有加速域名的 ID。

654a589230060dd533d3****

返回参数

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

请求示例

POST https://open.volcengineapi.com/?Action=DisableDnsScheduleDomain&Version=2022-03-01
{
    "DnsScheduleId": "27557981222815XXXX",
    "DomainId": "654a589230060dd533d3****"
}

返回示例

{
    "ResponseMetadata": {
        "RequestID": "202406051706466FB3775B8536FA050C4D",
        "Action": "DisableDnsScheduleDomain",
        "Version": "2022-03-01",
        "Service": "mcdn",
        "Region": "cn-north-1"
    },
    "Result": {}
}

错误码

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