全部產品
Search
文件中心

Anti-DDoS:SwitchSchedulerRule - 切換調度規則

更新時間:Dec 14, 2025

將業務流量切換到DDoS高防執行個體進行清洗、回切到聯動資源。

介面說明

本介面用於修改單個流量調度規則的當前生效資源,例如,將業務流量切換到 DDoS 高防執行個體進行清洗、回切到聯動資源。

調用本介面前,您必須已經調用 CreateSchedulerRule 建立了流量調度規則。

QPS 限制

本介面的單使用者 QPS 限制為 10 次/秒。超過限制,API 呼叫將會被限流,這可能影響您的業務,請合理調用。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

yundun-ddoscoo:SwitchSchedulerRule

update

*全部資源

*

請求參數

名稱

類型

必填

描述

樣本值

RuleName

string

要操作的流量調度規則的名稱。

說明

您可以調用 DescribeSchedulerRules 查詢所有流量調度規則的名稱。

testrule

RuleType

integer

流量調度規則的類型。取值:

  • 2:表示階梯防護規則。

  • 3:表示出海加速規則。

  • 5:表示 CDN 聯動規則。

  • 6:表示雲產品聯動規則。

6

SwitchData

string

業務流量切換操作的配置。使用 JSON 數組轉化的字串表示,JSON 數組的每個元素是一個結構體,結構體包含以下欄位:

  • Value:String 類型 | 必選 | 聯動資源的 IP 位址。

  • State:Integer 類型 | 必選 | 操作類型。取值:

    • 0:表示將業務流量從聯動資源切換到 DDoS 高防執行個體進行清洗。

    • 1:表示將業務流量回切到聯動資源。

  • Interval:Integer 類型 | 可選 | 回切時間,單位:分鐘。使用說明:

    • State0(表示切換到高防時),必須設定該參數為**-1**,否則會調用失敗。

    • State1(表示回切到雲資源時,無需設定該參數。

[{"Value":"39.104.XX.XX","State":0,"Interval":-1}]

調用 API 時,除了本文中該 API 的請求參數,還需加入阿里雲 API 公用請求參數。公用請求參數的詳細介紹,請參見公用參數

調用 API 的請求格式,請參見本文樣本中的請求樣本。

返回參數

名稱

類型

描述

樣本值

object

RequestId

string

本次請求的 ID。

7E3C301F-84BB-50E4-9DB9-2937B2429C1E

樣本

正常返回樣本

JSON格式

{
  "RequestId": "7E3C301F-84BB-50E4-9DB9-2937B2429C1E"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情