ListInstancesTrafficPackages - 擷取指定伺服器的流量包使用方式 - Simple Application Server

介面說明

您可以查詢一個或多個執行個體的流量包的詳情資訊，包括當月周期內的總流量、剩餘流量、已使用的流量、超額流量等資訊。

Simple Application Server的套餐配置中提供了固定流量配額，固定流量配額內的流量費用已包含在套餐內。如果實際使用流量超出固定流量配額，阿里雲將對超額的部分收取額外的流量費用。您需要注意：

僅伺服器的出網流量屬於使用流量（包括每月固定的流量配額和超出流量配額後的流量），伺服器的入網流量不計費。
Simple Application Server與其他阿里雲服務之間通過公網產生的出網流量優先消耗伺服器的固定流量配額，固定流量配額使用完畢後按超額流量計費。
同一區域網路（即同一 VPC 內網）的Simple Application Server之間的流量免費。

更多資訊，請參見流量配額與計費。

調試

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

調試

授權資訊

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

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

swas-open:ListInstancesTrafficPackages

get

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
RegionId	string	是	地區 ID。您可以調用 ListRegions 查詢可用地區。	cn-hangzhou
InstanceIds	string	是	Simple Application Server執行個體 ID。取值可以由一個或多個執行個體 ID 組成一個 JSON 數組，最多支援 100 個執行個體 ID，執行個體 ID 之間用半形逗號（,）隔開。	["2ad1ae67295445f598017499dc****","2ad1ae67295445f598017499dc****"]

返回參數

名稱	類型	描述	樣本值
	object
InstanceTrafficPackageUsages	array<object>	執行個體流量包詳情資訊。
	object
InstanceId	string	Simple Application Server執行個體 ID。	ccscqwqwqqqw****
TrafficUsed	integer	流量包當月周期內已使用流量。單位：Byte。	10000
TrafficPackageTotal	integer	流量包當月周期內的總流量。單位：Byte。說明流量包當月周期內的總流量=流量包當月周期內已使用流量+流量包當月周期內的剩餘流量	20000
TrafficPackageRemaining	integer	流量包當月周期內的剩餘流量。單位：Byte。	10000
TrafficOverflow	integer	流量包當月周期內超出流量包額度的流量。單位：Byte。	0
RequestId	string	請求 ID。	20758A-585D-4A41-A9B2-28DA8F4F****

樣本

正常返回樣本

JSON格式

{
  "InstanceTrafficPackageUsages": [
    {
      "InstanceId": "ccscqwqwqqqw****",
      "TrafficUsed": 10000,
      "TrafficPackageTotal": 20000,
      "TrafficPackageRemaining": 10000,
      "TrafficOverflow": 0
    }
  ],
  "RequestId": "20758A-585D-4A41-A9B2-28DA8F4F****"
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	RegionIdNotMatchHost	The parameter regionId does not match the endpoint host.	傳入的regionId和請求的地址不匹配。
500	InternalError	An error occurred while processing your request.	內部錯誤，請重試。如果多次嘗試失敗，請提交工單。

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

變更歷史

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