查詢指定時間段內某個DDoS原生防護執行個體的流量統計資料。
介面說明
本介面用於查詢指定時間範圍內單個 DDoS 原生防護執行個體的流量統計資料。
調用本介面時，您必須設定 InstanceId 參數，指定要查詢的 DDoS 原生防護執行個體。
QPS 限制
本介面的單使用者 QPS 限制為 1 次/秒。超過限制，API 呼叫將會被限流，這可能影響您的業務，請合理調用。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| InstanceId |
string |
否 |
要查詢的 DDoS 原生防護執行個體的 ID。 說明
您可以調用 DescribeInstanceList 查詢所有 DDoS 原生防護執行個體的 ID。 如果此處設定的執行個體用於代播防護，您必須佈建要求參數 Interval。 |
ddosbgp-cn-n6w203qg**** |
| Ipnet |
string |
否 |
要查詢的代播網段。 |
111.XX.XX.0/24 |
| Ip |
string |
否 |
要查詢的公網 IP 資產。不設定該參數表示查詢 DDoS 原生防護執行個體防護的所有公網 IP 資產的流量統計資料。 說明
公網 IP 資產必須已經添加為 DDoS 原生防護執行個體的防護對象。您可以調用 DescribePackIpList 查詢 DDoS 原生防護執行個體的所有防護對象。 |
39.XX.XX.96 |
| StartTime |
integer |
是 |
查詢開始時間。使用時間戳格式，單位：秒。 |
1619798400 |
| EndTime |
integer |
否 |
查詢結束時間。使用時間戳格式，單位：秒。 不設定該參數表示以目前時間作為查詢結束時間。 |
1563445054 |
| Interval |
integer |
否 |
設定流量統計的時間間隔，單位：秒，表示將每多少秒時間段作為一個區間，統計該區間內的流量資料。預設值為 5。 |
5 |
| FlowType |
string |
否 |
要查詢的流量統計資料的類型。取值：
|
max |
| ResourceGroupId |
string |
否 |
DDoS 原生防護執行個體在資源管理服務中所屬的資源群組 ID。 不設定該參數表示預設資源群組。 |
rg-acfm2pz25js**** |
| RegionId |
string |
否 |
DDoS 原生防護執行個體所屬地區 ID。 說明
您可以調用 DescribeRegions 查詢 DDoS 原生防護支援的所有地區 ID。 |
cn-hangzhou |
調用 API 時，除了本文中該 API 的請求參數，還需加入阿里雲 API 公用請求參數。公用請求參數的詳細介紹，請參見公用參數。
調用 API 的請求格式，請參見本文樣本中的請求樣本。
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| RequestId |
string |
本次請求的 ID。 |
6A507DC8-F657-4C13-84E2-D1D1B9400753 |
| FlowList |
array<object> |
查詢到的流量統計資料。 |
|
|
object |
|||
| Time |
integer |
流量統計時間。使用時間戳表示，單位：秒。 |
1620951900 |
| FlowType |
string |
流量統計資料的類型。取值：
|
max |
| AttackPps |
integer |
攻擊流量的包轉寄率，單位：pps。 說明
僅在有攻擊流量時，返回該資料。 |
0 |
| Name |
string |
該次流量統計的 ID。 |
8e33f19e-5644-11eb-b5c1-d89d67182200 |
| Pps |
integer |
總流量的包轉寄率，單位：pps。 |
274 |
| Kbps |
integer |
總流量的寬頻速率，單位：Kbps。 |
417 |
| AttackBps |
integer |
攻擊流量的寬頻速率，單位：bps。 說明
僅在有攻擊流量時，返回該資料。 |
0 |
樣本
正常返回樣本
JSON格式
{
"RequestId": "6A507DC8-F657-4C13-84E2-D1D1B9400753",
"FlowList": [
{
"Time": 1620951900,
"FlowType": "max",
"AttackPps": 0,
"Name": "8e33f19e-5644-11eb-b5c1-d89d67182200",
"Pps": 274,
"Kbps": 417,
"AttackBps": 0
}
]
}異常返回樣本
JSON格式
{
"RequestId": "6A507DC8-F657-4C13-84E2-D1D1B9400753",
"FlowList": [
{
"Name": "73765106-54e7-11e9-aab0-d89d67182200",
"Pps": 25,
"Time": 1560855000,
"FlowType": "max",
"Kbps": 17
},
{
"Name": "73765106-54e7-11e9-aab0-d89d67182200",
"Pps": 9,
"Time": 1560857000,
"FlowType": "max",
"Kbps": 8
}
]
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。