全部產品
Search
文件中心

Compute Nest:PushMeteringData - 推送計量資料

更新時間:Oct 23, 2025

該API只支援推送隨用隨付的計算巢服務執行個體的計量資料,推送的計量項目需要定義為服務商上報

調試

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

調試

授權資訊

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

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

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

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

computenestsupplier:PushMeteringData

none

*ServiceInstance

acs:computenestsupplier:{#regionId}:{#accountId}:serviceinstance/{#ServiceInstanceId}

請求參數

名稱

類型

必填

描述

樣本值

Metering

string

樣本中的參數說明如下:

  • InstanceId:雲市場執行個體 ID 。參數類型為 String。

  • StartTime:計量開始時間。單位秒(格式為 Unix 時間戳記)。參數類型為 Long。

  • EndTime:計量結束時間。單位秒(格式為 Unix 時間戳記)。參數類型為 Long。

  • Entities:計量實體物件。參數類型為 List

    • Key:計量項目屬性名稱。參數類型為 String。
      • Frequency:使用次數(次)。

      • Period:使用小時時間長度(秒)。 注意:請求參數中的時間長度單位為秒,而計費單位為小時,因此計費時會轉換為小時,如推送 19:00-20:00 的用量 1800,計費價格為 1 美元/小時,按小時出賬該時段費用為 1800/3600 x 1 = 0.5 美元, 費用如為小數,保留兩位小數,超過兩位捨棄。

      • Storage:使用儲存空間(Byte)。 注意:請求參數中的單位為 Byte,而計費單位為 MB,因此計費時會轉換為 MB,如推送 19:00-20:00 的用量 524288,計費價格為 1 美元/MB,按小時出賬該時段費用為 524288 / 1024 / 1024 x 1 = 0.5 美元,費用如為小數,保留兩位小數,超過兩位捨棄。

      • NetworkOut:上行使用流量(Bit)。 注意:請求參數中的單位為 Bit,而計費單位為 Mb,因此計費時會轉換為 Mb,如推送 19:00-20:00 的用量 524288,計費價格為 1 美元/Mb,按小時出賬該時段費用為 524288 / 1024 / 1024 x 1 = 0.5 美元,費用如為小數,保留兩位小數,超過兩位捨棄。

      • NetworkIn:下行使用流量(Bit)。 注意:請求參數中的單位為 Bit,而計費單位為 Mb,因此計費時會轉換為 Mb,如推送 19:00-20:00 的用量 524288,計費價格為 1 美元/Mb,按小時出賬該時段費用為 524288 / 1024 / 1024 x 1 = 0.5 美元,費用如為小數,保留兩位小數,超過兩位捨棄。

      • Character:字元數(個)。

      • DailyActiveUser:日活躍使用者數(DAU)。

      • PeriodMin:使用分鐘時間長度(分鐘)。

      • VirtualCpu:虛擬 CPU 核心數。

        • Unit: Unit(個)

        • Memory: Memory(GB)

    • Value:計量數值(取值 >= 0)。參數類型為 Integer。

說明

  • 如果商品設定為即時出賬,StartTime 和 EndTime 為任意時間寬度均可以,但是 EndTime 一定要大於 StartTime 。

  • 如果商品設定為非即時出賬(即選擇按小時、按天、按月等),StartTime 和 EndTime 的間隔必須大於 5 分鐘。

  • 批量推送計量資料時,InstanceId 屬性必須為同一個商品所產生的執行個體,目前不支援多個商品的執行個體同時推送。

[{"StartTime":1711527396,"EndTime":1711527397,"Entities":[{"Key":"Unit","Value":"0"}]}]

ServiceInstanceId

string

服務執行個體 ID。

si-0e6fca6a51a54420****

返回參數

名稱

類型

描述

樣本值

object

RequestId

string

請求 ID。

94E89857-B994-44B6-9C4F-DBD200E9XXXX

樣本

正常返回樣本

JSON格式

{
  "RequestId": "94E89857-B994-44B6-9C4F-DBD200E9XXXX"
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情