DescribeApisecStatistics による API セキュリティリスクのモニタリング - WAF

API セキュリティリスクまたはセキュリティイベントの統計を照会します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

yundun-waf:DescribeApisecStatistics

get

*All Resource

*

acs:ResourceGroupId

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
InstanceId	string	必須	WAF インスタンスの ID です。説明 DescribeInstance 操作を呼び出して、現在の WAF インスタンスの ID を照会します。	waf_v2_public_cn-uax***b09
Type	string	任意	検出統計のタイプ。有効な値は次のとおりです。 risk: セキュリティリスクに関する統計。 event: 攻撃に関する統計。	risk
ClusterId	string	任意	ハイブリッドクラウドクラスターの ID です。説明このパラメーターは、ハイブリッドクラウドシナリオでのみ使用できます。DescribeHybridCloudClusters 操作を呼び出して、ハイブリッドクラウドクラスターに関する情報を照会します。	428
RegionId	string	任意	WAF インスタンスが存在するリージョン。有効な値は次のとおりです。 cn-hangzhou: 中国本土。 ap-southeast-1: 中国本土以外。	cn-hangzhou
ResourceManagerResourceGroupId	string	任意	Alibaba Cloud リソースグループの ID です。	rg-aek2***uwbs5q
StartTime	integer	任意	照会する時間範囲の開始時刻。この値は秒単位の UNIX タイムスタンプです。時刻は UTC です。	1668496310
EndTime	integer	任意	照会する時間範囲の終了時刻。この値は秒単位の UNIX タイムスタンプです。時刻は UTC です。	1726113600
UserStatusList	array	任意	検出統計のステータスのリスト。
	string	任意	セキュリティリスクまたはセキュリティイベントのステータス。説明サポートされているリスクとセキュリティイベントのステータス値の詳細については、「DescribeApisecAbnormals および DescribeApisecEvents の UserStatus リクエストパラメーター」をご参照ください。	toBeConfirmed

レスポンスフィールド

フィールド	型	説明	例
	object	リクエストの結果。
RequestId	string	リクエスト ID です。	221F0F14-54C6-59A1-9967-72***81B61A
Data	object	統計結果。
High	integer	高リスク項目の数。	135
ToBeFixed	integer	修正が必要な項目の数。	3
Ignore	integer	無視された項目の数。	3
TodayTotal	string	本日の新しい項目の総数。	3
TodayMedium	string	本日の新しい中リスク項目の数。	0
TodayHigh	string	本日の新しい高リスク項目の数。	3
Low	integer	低リスク項目の数。	160
Medium	integer	中リスク項目の数。	27
Total	integer	総数。説明これは、High、Medium、および Low レスポンスパラメーターの値の合計です。	322
TodayLow	integer	本日の新しい低リスク項目の数。	0
ToBeConfirmed	integer	確認が必要な項目の数。	295
Api	integer	API の数。	202
Confirmed	integer	確認済みの項目の数。	11
Domain	integer	ドメイン名の数。	22
Fixed	integer	手動で修正済みとして検証された項目の数。	13
Actioned	integer	処理済みの項目の数。	1
ToBeVerified	integer	システムによって検証される項目の数。	2
NotFixed	integer	未修正として検証された項目の数。	0
SystemFixed	integer	システムによって修正済みとして検証された項目の数。	1
Account	integer	アカウントの数。	1

例

成功レスポンス

JSONJSON

{
  "RequestId": "221F0F14-54C6-59A1-9967-72***81B61A",
  "Data": {
    "High": 135,
    "ToBeFixed": 3,
    "Ignore": 3,
    "TodayTotal": "3",
    "TodayMedium": "0",
    "TodayHigh": "3",
    "Low": 160,
    "Medium": 27,
    "Total": 322,
    "TodayLow": 0,
    "ToBeConfirmed": 295,
    "Api": 202,
    "Confirmed": 11,
    "Domain": 22,
    "Fixed": 13,
    "Actioned": 1,
    "ToBeVerified": 2,
    "NotFixed": 0,
    "SystemFixed": 1,
    "Account": 1
  }
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。