全部產品
Search

搜尋本產品

    Cloud Monitor：DescribeSiteMonitorData - 查詢任務的細粒度監控資料

    文件中心

    Cloud Monitor：DescribeSiteMonitorData - 查詢任務的細粒度監控資料

    更新時間：Mar 21, 2026

    調用DescribeSiteMonitorData介面查詢任務的細粒度監控資料。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    cms:DescribeSiteMonitorData

    get

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    TaskId

    string

    是

    任務 ID。

    49f7b317-7645-4cc9-94fd-ea42e522****
    Type

    string

    否

    監控的資料類型。取值：

    • metric：時序類指標監控

    • event：事件類別監控

    metric
    MetricName

    string

    是

    監控項的名稱。取值：

    • Availability：可用率

    • ResponseTime：回應時間

    Availability
    StartTime

    string

    否

    開始時間。支援的格式：

    • Unix 時間戳記：從 1970 年 1 月 1 日開始所經過的毫秒數。

    • Format 格式：YYYY-MM-DDThh:mm:ssZ。

    1551579637000
    EndTime

    string

    否

    結束時間。支援的格式：

    • Unix 時間戳記：從 1970 年 1 月 1 日開始所經過的毫秒數。

    • Format 格式：YYYY-MM-DDThh:mm:ssZ。

    1551581437000
    Period

    string

    否

    統計周期。單位：秒，取值為 60 或 60 的整數倍。

    說明

    預設根據探測頻率最小周期返回資料。

    60
    NextToken

    string

    否

    分頁遊標。

    49f7b317-7645-4cc9-94fd-ea42e5220930ea42e5220930ea42e522****
    Length

    integer

    否

    返回的資料點數量。

    1000

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    NextToken

    string

    分頁遊標。

    ea42e5220930ea42e522****
    Data

    string

    監控資料。

    [{"Maximum":247,"Mimimum":61,"Average":154,"userId":"127067667954****","taskId":"49f7b317-7645-4cc9-94fd-ea42e522****","timestamp":1551581760000}]
    RequestId

    string

    請求 ID。

    3febb181-0d98-4af9-8b04-7faf36b048b9
    Success

    string

    操作是否成功。true 表示成功，false 表示失敗。

    true
    Code

    string

    狀態代碼。

    說明

    200 表示成功。

    200
    Message

    string

    返回資訊。

    Successful

    返回結果是一個 JSON 字串，描述資訊如下：

    • Error4XXRate：4XX 錯誤佔比

    • Error6XXRate：6xx 錯誤佔比

    • Error5XXRate：5xx 錯誤佔比

    • Error4XXNumber：4xx 錯誤探針的數量

    • Error5XXNumber：5xx 錯誤探針的數量

    • Error6XXNumber：6xx 錯誤探針數量

    • Over5totalTime：回應時間超過 5000 毫秒的佔比

    • Over3totalTime：回應時間超過 3000 毫秒的佔比

    • Over2totalTime：回應時間超過 2000 毫秒的佔比

    • Over10FailureRate：錯誤大於 10%所佔的比例

    • Over100FailureRate：錯誤大於 99%所佔的比例

    • Over30FailureRate：錯誤大於 30%所佔的比例

    • Over50FailureRate：錯誤大於 50%所佔的比例

    • Over80FailureRate：錯誤大於 80%所佔的比例

    • Over90FailureRate：錯誤大於 90%所佔的比例

    • Over400NumberRate：超過 4XX 錯誤所佔的比例

    • Over500NumberRate：超過 5XX 錯誤所佔的比例

    • AvailableNumber：可用探針數量

    • UnavailableNumber：不可用探測點數量

    • Availability：可用率

    • Unavailability：不可用率

    • ErrorCodeMaximum：最大錯誤碼，例如：1 分鐘內 5 個探測點有 4 個是 200， 1 個是 404， 那麼最大錯誤碼就是 404

    • ErrorCodeMinimum：最小錯誤碼， 例如：1 分鐘內 5 個探測點有 4 個是 200， 1 個是 404， 那麼最小錯誤碼就是 200

    說明

    建議您使用 AvailableNumber、UnavailableNumber、Availability、Unavailability、ErrorCodeMaximum 或 ErrorCodeMinimum，其他計算方式較繁瑣。

    樣本

    正常返回樣本

    JSON格式

    {
  "NextToken": "ea42e5220930ea42e522****",
  "Data": "[{\"Maximum\":247,\"Mimimum\":61,\"Average\":154,\"userId\":\"127067667954****\",\"taskId\":\"49f7b317-7645-4cc9-94fd-ea42e522****\",\"timestamp\":1551581760000}]",
  "RequestId": "3febb181-0d98-4af9-8b04-7faf36b048b9",
  "Success": "true",
  "Code": "200",
  "Message": "Successful"
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 InvalidQueryParameter %s
    401 AccessDeniedException You donot have sufficient access to perform this action.
    500 InternalError %s
    402 LimitExceeded The quota for this customer had been reached.
    403 Forbidden You are not authorized to operate the specified resource. 沒有許可權，請使用RAM進行授權
    503 %s %s
    406 ExceedingQuota Exceeding quota limits. 任務數量超出限額
    429 ThrottlingException The request was denied due to request throttling.
    409 %s %s

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

    變更歷史

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