获取公网流量详情数据排名,覆盖一元组、二元组、五元组粒度,支持按流量、包数等指标排序。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息,可以在RAM权限策略语句的Action
元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:
- 操作:是指具体的权限点。
- 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
- 资源类型:是指操作中支持授权的资源类型。具体说明如下:
- 对于必选的资源类型,用背景高亮的方式表示。
- 对于不支持资源级授权的操作,用
全部资源
表示。
- 条件关键字:是指云产品自身定义的条件关键字。
- 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
---|---|---|---|---|
nis:GetInternetTuple | Read |
|
| 无 |
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
RegionId | string | 是 | 要查询的公网流量的地域ID。 | cn-shanghai |
TupleType | integer | 是 | 查询的元组类型。取值:
| 1 |
BeginTime | long | 是 | 查询起始时间的毫秒时间戳。 | 1684373600099 |
EndTime | long | 是 | 查询结束时间的毫秒时间戳。 | 1684373700099 |
Direction | string | 是 | 查询流量方向,取值:
| in |
OrderBy | string | 否 | 数据排序的指标。默认值:ByteCount,表示按流量排序。 枚举值:
| ByteCount |
CloudIp | string | 否 | 阿里云端IP。 | 112.74.XX.XX |
CloudPort | string | 否 | 阿里云端端口。 说明
仅TupleType配置为5时,才需要配置该参数。
| 443 |
OtherIp | string | 否 | 对端IP。 说明
仅TupleType配置为2或5时,才需要配置该参数。
| 122.112.XX.XX |
OtherPort | string | 否 | 对端端口。 说明
仅TupleType配置为5时,才需要配置该参数。
| 40002 |
InstanceId | string | 否 | 阿里云端实例ID。 | eip-sample* |
Protocol | string | 否 | 协议号。 说明
支持全部协议, 仅TupleType配置为5时,才需要配置该参数。
| 6 |
Sort | string | 否 | 流量数据的排序方式。
| desc |
TopN | integer | 否 | 展示排序靠前的数据。默认值:10。表示默认展示排序前10的数据。 | 10 |
CloudIsp | string | 否 | 云端运营商。 说明
通常为“阿里巴巴”或“阿里云”
| 阿里巴巴 |
OtherIsp | string | 否 | 对端运营商。 说明
查看运营商情况时,请指定此参数。
| 移动 |
OtherCountry | string | 否 | 对端国家。 说明
仅TupleType配置为2或5时,才需要配置该参数。
| 中国 |
OtherCity | string | 否 | 对端城市。 说明
仅TupleType配置为2或5时,才需要配置该参数。
| 杭州市 |
InstanceList | array | 否 | 批量过滤时的实例ID列表。 | |
string | 否 | 批量过滤时的实例ID。 | [\"eip-sample*\"] | |
UseMultiAccount | boolean | 否 | 是否使用多账号管理功能。默认值:false。表示不使用。 说明
多账号管理功能默认不开放,如需使用,请联系商务经理申请使用权限。
| false |
AccountIds | array | 否 | 成员账号ID列表。 | |
long | 否 | 某个成员账号ID。 | [123] |
返回参数
示例
正常返回示例
JSON
格式
{
"RequestId": "D5E98683-355B-5867-8D3D-A24755F6895B",
"Data": [
{
"BeginTime": "1684373600099",
"Direction": "in",
"InstanceId": "eip-sample*",
"AccessRegion": "cn-hongkong-pop",
"CloudIp": "112.74.XX.XX",
"CloudPort": "443",
"OtherIp": "122.112.XX.XX",
"OtherPort": "40002",
"Protocol": "6",
"CloudCountry": "中国",
"CloudProvince": "江苏省",
"CloudCity": "南京市",
"CloudIsp": "移动",
"CloudProduct": "EIP",
"OtherCountry": "美国",
"OtherProvince": "得克萨斯州",
"OtherCity": "奥斯汀",
"OtherIsp": "amazon.com",
"OtherProduct": "ECS",
"Rtt": 10000,
"ByteCount": 88,
"PacketCount": 66,
"OutOrderCount": 1,
"InByteCount": 88,
"OutByteCount": 66,
"InPacketCount": 33,
"OutPacketCount": 22,
"InOutOrderCount": 2,
"OutOutOrderCount": 1,
"InRetranCount": 0,
"OutRetranCount": 1,
"RetransmitRate": 0.1
}
]
}
错误码
HTTP status code | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | IllegalParam.TopN | The TopN(%s) should not greater than 100. | 最大仅支持Top 100,实际传入为(%s)。 |
400 | IllegalParam.BeginTimeAndEndTime1H | It only supports querying data for up to 1 hour: %s. | 最长支持查询1小时数据: %s。 |
400 | IllegalParam.GroupBy | The specified param of GroupBy (%s) is invalid. | 指定的分组字段(%s)不合法。 |
400 | IllegalParam.OrderBy | The specified param of orderBy (%s) is invalid. | 指定的排序字段(%s)不合法。 |
400 | IllegalParam.RegionId | The specified region ID (%s) is invalid. | 指定的地域(%s)不合法。 |
400 | IllegalParam.BeginTimeAndEndTime | It only supports querying data for up to 24 hours: %s. | 最大支持查询24小时数据。 |
400 | IllegalParam.BeginTimeAndEndTime5M | It only supports querying data for up to 5 minute when TupleType is 5 and the CloudIp and OtherIp are both empty: %s. | 当TupleType=5且CloudIp、OtherIp都是空时,只支持查询最长5分钟范围的数据。 |
400 | OperationFailed.DbConcurrentTooHigh | The operation failed due to too many concurrent queries. Please try again later. | 当前用户过多,导致操作失败,请稍后再重试。 |
访问错误中心查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
2023-12-07 | OpenAPI 错误码发生变更 | 看变更集 | ||||||||||
| ||||||||||||
2023-11-24 | OpenAPI 错误码发生变更 | 看变更集 | ||||||||||
| ||||||||||||
2023-11-17 | OpenAPI 错误码发生变更 | 看变更集 | ||||||||||
| ||||||||||||
2023-11-16 | OpenAPI 错误码发生变更,OpenAPI 返回结构发生变更 | 看变更集 | ||||||||||
| ||||||||||||
2023-06-19 | OpenAPI 错误码发生变更,OpenAPI 入参发生变更 | 看变更集 | ||||||||||
|