日本熟妇hd丰满老熟妇,中文字幕一区二区三区在线不卡 ,亚洲成片在线观看,免费女同在线一区二区

AI 助理
備案控制臺
文檔
輸入文檔關鍵字查找
首頁 云監控 開發參考 API參考 API目錄 云產品監控 DescribeMetricTop - 查詢排序后的最新監控數據

DescribeMetricTop - 查詢排序后的最新監控數據

更新時間：
產品詳情
我的收藏

調用DescribeMetricTop接口先查詢指定云產品的指定監控項的最新監控數據，再查詢該監控項排序后的監控數據。

接口說明

使用限制

  • 調用 DescribeMetricLast、DescribeMetricList、DescribeMetricData 和 DescribeMetricTop 的接口，有 100 萬次/月免費額度（總計），當免費額度用完且您沒有開通基礎云監控按量計費時，將無法正常使用該 API。如果您已開通基礎云監控的按量計費，當免費調用額度用完時，該 API 仍然可以正常使用，超出免費額度部分將自動按使用量計費。開通方法詳見開通按量計費。
  • 單個 API 的調用次數限制為 10 次/秒。一個阿里云賬號及該賬號下的 RAM 用戶共用 10 次/秒。

注意事項

各云產品監控數據的存儲時長與Period（統計周期）有關，Period越大，查詢的監控數據越稀疏，監控數據的存儲時間越長，具體關系如下：

  • Period小于 60 秒，存儲時長為 7 天。
  • Period等于 60 秒，存儲時長為 31 天。
  • Period等于 300 秒，存儲時長為 91 天。

使用說明

本文將提供一個示例，查詢云服務acs_ecs_dashboard監控項cpu_idle在最近 60 秒的監控數據，并對監控數據的Average從大到小排序。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

授權信息

下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：

  • 操作：是指具體的權限點。
  • 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
  • 資源類型：是指操作中支持授權的資源類型。具體說明如下：
    • 對于必選的資源類型，用背景高亮的方式表示。
    • 對于不支持資源級授權的操作，用全部資源表示。
  • 條件關鍵字：是指云產品自身定義的條件關鍵字。
  • 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
操作訪問級別資源類型條件關鍵字關聯操作
cms:QueryMetricTopget
  • 全部資源
    *
    無
無

請求參數

名稱類型必填描述示例值
Periodstring否

監控數據的統計周期。

取值：15、60、900 和 3600。

單位：秒。

說明
  • 如果不設置統計周期，則按照注冊監控項時申請的上報周期來查詢監控數據。
    •
    • 每個云產品的監控項（MetricName）的統計周期不同。更多信息，請參見云產品監控項。
    		60
    Namespacestring是

    云產品的數據命名空間。

    關于云產品的數據命名空間，請參見云產品監控項。

    		acs_ecs_dashboard
    MetricNamestring是

    云產品的監控項名稱。

    關于監控項名稱，請參見云產品監控項。

    		cpu_idle
    StartTimestring否

    查詢監控數據的開始時間。

    • 當您未設置StartTime和EndTime時，查詢當前時間最近一個統計周期Period的監控數據。

    • 當您同時設置StartTime和EndTime時，查詢指定時間段內距離EndTime最近一個統計周期Period的監控數據。具體如下：

      • 當Period設置為 15 秒時，指定時間段必須小于或等于 20 分鐘。例如：StartTime 為 2021-05-08 08:10:00，EndTime 為 2021-05-08 08:30:00，統計距離 2021-05-08 08:30:00 最近一個 15 秒的監控數據。

      • 當Period設置為 60 秒或 900 秒時，指定時間段必須小于或等于 2 小時。例如：Period 為 60 秒，StartTime 為 2021-05-08 08:00:00，EndTime 為 2021-05-08 10:00:00，統計距離 2021-05-08 10:00:00 最近一個 60 秒的監控數據。

      • 當Period設置為 3600 秒時，指定時間段必須小于或等于 2 天。例如：StartTime 為 2021-05-08 08:00:00，EndTime 為 2021-05-10 08:00:00，統計距離 2021-05-10 08:00:00 最近一個 3600 秒的監控數據。

    開始時間支持的格式：

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

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

    說明
  • StartTime如果設置過早，則無效。
    •
    • 建議您使用 Unix 時間戳，避免時區的問題。
    		2021-05-08 08:00:00
    EndTimestring否

    查詢監控數據的結束時間。

    • 當您未設置StartTime和EndTime時，查詢當前時間最近一個統計周期Period的監控數據。

    • 當您同時設置StartTime和EndTime時，查詢指定時間段內距離EndTime最近一個統計周期Period的監控數據。具體如下：

      • 當Period設置為 15 秒時，指定時間段必須小于或等于 20 分鐘。例如：StartTime 為 2021-05-08 08:10:00，EndTime 為 2021-05-08 08:30:00，統計距離 2021-05-08 08:30:00 最近一個 15 秒的監控數據。

      • 當Period設置為 60 秒或 900 秒時，指定時間段必須小于或等于 2 小時。例如：Period 為 60 秒，StartTime 為 2021-05-08 08:00:00，EndTime 為 2021-05-08 10:00:00，統計距離 2021-05-08 10:00:00 最近一個 60 秒的監控數據。

      • 當Period設置為 3600 秒時，指定時間段必須小于或等于 2 天。例如：StartTime 為 2021-05-08 08:00:00，EndTime 為 2021-05-10 08:00:00，統計距離 2021-05-10 08:00:00 最近一個 3600 秒的監控數據。

    結束時間支持的格式：

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

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

    說明 建議您使用 Unix 時間戳，避免時區的問題。
    		2021-05-08 10:00:00
    Dimensionsstring否

    指定資源的監控維度。

    格式：key:value鍵值對形式的集合，例如：{"userId":"120886317861****"}和{"instanceId":"i-2ze2d6j5uhg20x47****"}。

    說明 單次請求最多支持批量查詢 50 個實例。
    		[{"instanceId": "i-2ze2d6j5uhg20x47****"}]
    Orderbystring是

    排序字段，即按該字段進行排序。取值：

    • Average：平均值。

    • Minimum：最小值。

    • Maximum：最大值。

    		Average
    OrderDescstring否

    排序方式。取值：

    • true：由小到大排序。
    • false（默認值）：由大到小排序。
    		false
    Lengthstring否

    每頁顯示的記錄條數。

    用于分頁查詢，默認值：10。

    說明 單次請求 Length 的最大值為 1440。
    		10
    Expressstring否

    對查詢出的現有結果進行實時計算的表達式。

    說明 目前僅支持groupby（類似數據庫的 groupby 語句）。
    		{"groupby":["userId","instanceId"]}

    關于公共請求參數的詳情，請參見公共參數。

    返回參數

    名稱類型描述示例值
    object
    Codestring

    狀態碼。

    說明 200 表示成功。
    		200
    Messagestring

    錯誤信息。

    		The specified resource is not found.
    RequestIdstring

    請求 ID。

    		3121AE7D-4AFF-4C25-8F1D-C8226EBB1F42
    Datapointsstring

    監控數據列表。

    		[{\"order\":1,\"timestamp\":1620287520000,\"userId\":\"120886317861****\",\"instanceId\":\"i-j6ccf7d5fn335qpo****\",\"Average\":99.92,\"Minimum\":99.5,\"Maximum\":100.0,\"_count\":1.0},{\"order\":2,\"timestamp\":1620287520000,\"userId\":\"120886317861****\",\"instanceId\":\"i-0xii2bvf42iqvxbp****\",\"Average\":99.91,\"Minimum\":99.0,\"Maximum\":100.0,\"_count\":1.0}]
    Periodstring

    監控數據的統計周期。單位：秒。取值：15、60、900 和 3600。

    		60

    示例

    正常返回示例

    JSON格式

    {
  "Code": "200",
  "Message": "The specified resource is not found.",
  "RequestId": "3121AE7D-4AFF-4C25-8F1D-C8226EBB1F42",
  "Datapoints": "[{\\\"order\\\":1,\\\"timestamp\\\":1620287520000,\\\"userId\\\":\\\"120886317861****\\\",\\\"instanceId\\\":\\\"i-j6ccf7d5fn335qpo****\\\",\\\"Average\\\":99.92,\\\"Minimum\\\":99.5,\\\"Maximum\\\":100.0,\\\"_count\\\":1.0},{\\\"order\\\":2,\\\"timestamp\\\":1620287520000,\\\"userId\\\":\\\"120886317861****\\\",\\\"instanceId\\\":\\\"i-0xii2bvf42iqvxbp****\\\",\\\"Average\\\":99.91,\\\"Minimum\\\":99.0,\\\"Maximum\\\":100.0,\\\"_count\\\":1.0}]",
  "Period": "60"
}

    錯誤碼

    HTTP status code錯誤碼錯誤信息描述
    400ParameterInvalidIllegal parameters.-
    403AccessForbiddenUser not authorized to operate on the specified resource.-
    404ResourceNotFoundThe specified resource is not found.未找到指定資源。
    500InternalErrorThe request processing has failed due to some unknown error.-

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

    變更歷史

    變更時間變更內容概要操作
    暫無變更歷史