查询一个或多个实例的流量包详情信息。
接口说明
您可以查询一个或多个实例的流量包的详情信息,包括当月周期内的总流量、剩余流量、已使用的流量、超额流量等信息。
轻量应用服务器的套餐配置中提供了固定流量配额,固定流量配额内的流量费用已包含在套餐内。如果实际使用流量超出固定流量配额,阿里云将对超额的部分收取额外的流量费用。您需要注意:
仅服务器的出网流量属于使用流量(包括每月固定的流量配额和超出流量配额后的流量),服务器的入网流量不计费。
轻量应用服务器与其他阿里云服务之间通过公网产生的出网流量优先消耗服务器的固定流量配额,固定流量配额使用完毕后按超额流量计费。
同一局域网(即同一 VPC 内网)的轻量应用服务器之间的流量免费。
更多信息,请参见流量配额与计费。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
swas-open:ListInstancesTrafficPackages |
get |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| RegionId |
string |
是 |
地域 ID。您可以调用 ListRegions 查询可用地域。 |
cn-hangzhou |
| InstanceIds |
string |
是 |
轻量应用服务器实例 ID。取值可以由一个或多个实例 ID 组成一个 JSON 数组,最多支持 100 个实例 ID,实例 ID 之间用半角逗号(,)隔开。 |
["2ad1ae67295445f598017499dc******","2ad1ae67295445f598017499dc******"] |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| InstanceTrafficPackageUsages |
array<object> |
实例流量包详情信息。 |
|
|
object |
|||
| InstanceId |
string |
轻量应用服务器实例 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. | 内部错误,请重试。如果多次尝试失败,请提交工单。 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。