调用本接口在调度实例层面停用指定的云服务商加速 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%。
每个请求中必须包含鉴权信息。该鉴权信息用以验证请求者的身份。参见签名机制。
参数名称 | 数据类型 | 是否必选 | 参数说明 |
---|---|---|---|
Action | String | 是 | 接口名称。当前 API 的名称为 DisableDnsScheduleDomain 。 |
Version | String | 是 | 接口版本。当前 API 的版本为 2022-03-01 。 |
参数名称 | 数据类型 | 是否必选 | 参数说明 | 示例 |
---|---|---|---|---|
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 请求失败。关于更多错误码的信息,参见错误码。