全部產品
Search

搜尋本產品

    Global Accelerator：UpdateApplicationMonitor - 修改來源站點探測任務配置

    文件中心

    Global Accelerator：UpdateApplicationMonitor - 修改來源站點探測任務配置

    更新時間：Dec 14, 2025

    調用UpdateApplicationMonitor介面修改來源站點探測任務配置。

    介面說明

    UpdateApplicationMonitor 介面屬於非同步介面，即系統會先返回一個請求 ID，但來源站點探測任務並未修改完成，系統背景修改任務仍在進行。您可以調用 DescribeApplicationMonitor 或 ListApplicationMonitor 查詢來源站點探測任務的配置是否完成修改：

    • 當修改的參數值未發生變更，表示來源站點探測任務正在修改中，在該情況下，您只能執行查詢操作，不能執行其他動作。

    • 當修改的參數值已發生變更，表示來源站點探測任務修改完成。

    調試

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

    調試

    授權資訊

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

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

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    ga:UpdateApplicationMonitor

    update

    *ApplicationMonitor

    acs:ga:{#regionId}:{#accountId}:sitemonitor/{#TaskId}

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    RegionId

    string

    否

    Global Acceleration執行個體所屬的地區 ID，僅取值：cn-hangzhou。

    cn-hangzhou
    ClientToken

    string

    否

    用戶端 Token，用於保證請求的等冪性。

    從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。

    說明

    若您未指定，則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 不一樣。

    123e4567-e89b-12d3-a456-426655440000
    TaskId

    string

    是

    需要修改來源站點探測的任務 ID。

    sm-bp1fpdjfju9k8yr1y****
    ListenerId

    string

    否

    需要修改來源站點探測的監聽執行個體 ID。

    lsr-bp1bpn0kn908w4nbw****
    TaskName

    string

    否

    來源站點探測的任務名稱。

    名稱長度為 1~128 個字元，以大小寫字母或中文開頭，可包含數字、半形句號（.）底線（_）和短劃線（-）。

    task1
    Address

    string

    否

    需要探測的 URL 或 IP 位址。

    https://www.aliyun.com
    OptionsJson

    string

    否

    來源站點探測任務對應監聽協議類型的進階擴充選項。不同來源站點探測任務的監聽協議類型對應不同的擴充選項。

    { "http_method": "get","header": "key:asd","acceptable_response_code": "500","cert_verify": true }
    DetectEnable

    boolean

    否

    是否開啟自動診斷功能。取值：

    • true：是。

    • false（預設值）：否。

    false
    DetectThreshold

    integer

    否

    設定自動診斷觸發閾值，當來源站點可用率低於設定的觸發閾值，則自動觸發診斷。

    取值範圍：0~100。

    0
    DetectTimes

    integer

    否

    觸發自動診斷需要達到觸發閾值的次數。

    取值範圍：1~20。

    1
    SilenceTime

    integer

    否

    自動診斷觸發的沉默時間。表示自動診斷觸發後，未恢複到正常，間隔多久觸發一次自動診斷。

    可用率連續多次（即設定的 DetectTimes）低於自動診斷觸發閾值時，觸發自動診斷，如果可用率在自動診斷觸發的沉默時間內持續低於自動診斷觸發閾值，在自動診斷觸發的沉默時間內不會重複出發自動診斷；如果可用率在自動診斷觸發的沉默時間後仍未恢複正常，則再次觸發自動診斷。

    單位：秒。取值範圍：300~86400。

    300

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回請求列表。

    RequestId

    string

    請求 ID。

    04F0F334-1335-436C-A1D7-6C044FE73368

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 InvalidateTaskId.ApplicationMonitor The application monitor task %s is not exist. 來源站點探測任務ID不存在。
    400 NotExist.Listener listener %s is not exist 監聽%s不存在。
    400 NotActive.Listener listener %s is not active 監聽%s不可用。
    400 ListenerNotSupport.ApplicationMonitor when the listener protocol is udp, application monitor is not supported. 來源站點探測不支援配置協議為UDP的監聽。
    400 InvalidatePort.ApplicationMonitor The address port not in listener port range. 來源站點探測網域名稱連接埠不在監聽連接埠範圍之內。

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

    變更歷史

    更多資訊，參考變更詳情。