调用GetTransitRouterFlowTopN接口，获取跨域流量详情数据排名，覆盖一元组、二元组、五元组粒度，支持按流量、包数等指标排序。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| nis:GetTransitRouterFlowTopN |
|
| 无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| BeginTime | long | 是 | 查询起始时间的毫秒时间戳。最大支持查 24 小时跨度的数据。 | 1684373600099 |
| EndTime | long | 是 | 查询结束时间的毫秒时间戳。最大支持查 24 小时跨度的数据。 | 1638239093000 |
| TopN | integer | 否 | 取最大多少条数据。默认值：10。最大值：100。 | 20 |
| Direction | string | 是 | 对于当前地域或 IP 的流量方向。取值：
| in |
| GroupBy | string | 是 | 指定跨域流量排名的维度，大小写敏感，请注意区分大小写。取值：
| 1Tuple |
| ThisRegion | string | 否 | 当前地域，即 ThisIp 所在地域。 | cn-shanghai |
| ThisIp | string | 否 | 本端 IP 地址。 | 1.8.XX.XX |
| ThisPort | string | 否 | 本端端口。 | 80 |
| OtherRegion | string | 否 | 对端地域。 | ap-southeast-1 |
| OtherIp | string | 否 | 对端 IP 地址。 | 122.112.XX.XX |
| OtherPort | string | 否 | 对端端口。 | 10869 |
| Protocol | string | 否 | 协议号。 说明
支持全部协议，仅 GroupBy 配置为 5Tuple 或 Protocol 时，才需要配置该参数。
| 6 |
| OrderBy | string | 否 | 数据排序的指标。默认值：Bytes，表示按流量排序。 | Bytes |
| Sort | string | 否 | 流量数据的排序方式。
| desc |
| CenId | string | 否 | CEN 实例 ID。 | cen-ia8kw1zjv4hyal**** |
| BandwithPackageId | string | 否 | CEN 带宽包 ID。 | cenbwp-ia8kw1zjv4hyal**** |
| AccountIds | array | 否 | 成员账号 ID 列表。 | |
| long | 否 | 某个成员账号 ID。 | [\"118639953821****\"] | |
| UseMultiAccount | boolean | 否 | 是否使用多账号管理功能。默认值：false。表示不使用。 说明
多账号管理功能默认不开放，如需使用，请联系商务经理申请使用权限。
| false |
返回参数
示例
正常返回示例
JSON格式
{
"RequestId": "D5E98683-355B-5867-8D3D-A24755F6895B",
"TransitRouterFlowTopN": [
{
"AccountId": "118639953821****",
"CenId": "cen-ia8kw1zjv4hyal****",
"ThisRegion": "cn-shanghai",
"ThisIp": "1.8.XX.XX",
"ThisPort": "80",
"OtherRegion": "ap-southeast-1",
"OtherIp": "47.216.XX.XX",
"OtherPort": "53470",
"Protocol": "6",
"StartTime": "2023-01-31T05:40:00Z",
"EndTime": "2023-01-31T06:40:00Z",
"Packets": 88,
"Bytes": 188,
"BandwithPackageId": "cenbwp-ia8kw1zjv4hyal****"
}
]
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | IllegalParam.TopN | The TopN(%s) should not greater than 100. | 最大仅支持Top 100，实际传入为(%s)。 |
| 400 | IllegalParam.BeginTime | The specified begin time (%s) is invalid. | 指定的开始时间(%s)不合法。 |
| 400 | IllegalParam.BeginTimeAndEndTime | It only supports querying data for up to 7 days: %s. | 最大仅支持查询7天的数据：%s。 |
| 400 | IllegalParam.OrderBy | The specified param of orderBy (%s) is invalid. | 指定的排序字段(%s)不合法。 |
| 400 | IllegalParam.Sort | The specified Sort(%s) is invalid. | 排序字段必须为（'desc'，'asc'）其中之一 |
| 400 | IllegalParam.AccountIds | The specified parameter accountId (%s) is invalid. | 指定的AccountId (%s)不在用户可选范围内。 |
| 400 | IllegalParam.inOrOut | Valid values for the inOrOut parameter: in and out. | 参数inOrOut必须为i('in','out')之一。 |
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 | ||||
|---|---|---|---|---|---|---|
| 2023-12-07 | OpenAPI 错误码发生变更 | 看变更集 | ||||
| ||||||
| 2023-10-24 | OpenAPI 错误码发生变更 | 看变更集 | ||||
|