DescribeEvents - - Alibaba Cloud ドキュメントセンター

ディスクの脅威イベントをクエリします。

今すぐお試しください

この 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 ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ebs:DescribeEvents

none

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
RegionId	string	必須	リージョン ID。DescribeRegions を呼び出して、EBS レンズがサポートされているリージョンの一覧をクエリします。	cn-hangzhou
EventName	string	任意	イベント名。有効な値： NoSnapshot：データ保護 BurstIOTriggered：バースト IO CostOptimizationNeeded：コストの最適化 DiskSpecNotMatchedWithInstance：ディスクの仕様がインスタンスタイプと一致しません。 DiskIONo4kAligned：読み取り/書き込み操作が 4K アラインされていません。 DiskIOHang：ディスクで I/O ハングイベントが発生しました。 InstanceIOPSExceedInstanceMaxLimit：インスタンスの IOPS が上限に達しました。 InstanceBPSExceedInstanceMaxLimit：インスタンスの BPS が上限に達しました。 DiskIOPSExceedInstanceMaxLimit：ディスクの IOPS がインスタンスの上限に達しました。 DiskBPSExceedInstanceMaxLimit：ディスクの BPS がインスタンスの上限に達しました。 DiskIOPSExceedDiskMaxLimit：ディスクの IOPS がディスクの上限に達しました。 DiskBPSExceedDiskMaxLimit：ディスクの BPS がディスクの上限に達しました。	DiskIOHang
ResourceId	string	任意	リソース ID。	d-bp67acfmxazb4p****
ResourceType	string	任意	リソースタイプ。有効な値： disk：ディスク	disk
Status	string	任意	イベントステータス。有効な値： WillExecute：保留中 Executing：処理中 Executed：処理済み Ignore：無視 Expired：期限切れ Deleted：削除済み	WillExecute
StartTime	string	任意	クエリ対象の期間の開始時刻。yyyy-MM-ddTHH:mm:ssZ 形式の ISO 8601 標準で時刻を指定します。時刻は UTC でなければなりません。	2023-06-01T03:00:00Z
EndTime	string	任意	クエリ対象の期間の終了時刻。yyyy-MM-ddTHH:mm:ssZ 形式の ISO 8601 標準で時刻を指定します。時刻は UTC でなければなりません。	2023-06-01T04:00:00Z
MaxResults	integer	任意	各ページで返される最大エントリ数。このパラメーターを設定する場合は、`NextToken` パラメーターと組み合わせて使用して、ページングクエリを実行する必要があります。有効値：1 ～ 100。デフォルト値：10。	10
NextToken	string	任意	クエリトークン。前の API 呼び出しから返された NextToken 値に設定します。	AAAAAdDWBF2****
EventLevel	string	任意	イベントレベル。有効な値： INFO：通知 WARN：警告 CRITICAL：クリティカル	WARN

レスポンスフィールド

フィールド	型	説明	例
	object	レスポンスのスキーマ
RequestId	string	リクエスト ID	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
TotalCount	integer	ページングクエリで返されたエントリの総数。	1
NextToken	string	次のクエリに使用するトークン。このパラメーターが空の場合、すべての結果が返されています。	AAAAAdDWBF2****
ResourceEvents	array<object>	イベントのリスト。
	object
EventType	string	イベントタイプ。有効な値： Notification（通知） SystemException（システム例外） Alert（アラート）	Alert
EventName	string	イベント名。有効な値： NoSnapshot：データ保護 BurstIOTriggered：バースト IO CostOptimizationNeeded：コストの最適化 DiskSpecNotMatchedWithInstance：ディスクの仕様がインスタンスタイプと一致しません。 DiskIONo4kAligned：読み取り/書き込み操作が 4K アラインされていません。 DiskIOHang：ディスクで I/O ハングイベントが発生しました。 InstanceIOPSExceedInstanceMaxLimit：インスタンスの IOPS が上限に達しました。 InstanceBPSExceedInstanceMaxLimit：インスタンスの BPS が上限に達しました。 DiskIOPSExceedInstanceMaxLimit：ディスクの IOPS がインスタンスの上限に達しました。 DiskBPSExceedInstanceMaxLimit：ディスクの BPS がインスタンスの上限に達しました。 DiskIOPSExceedDiskMaxLimit：ディスクの IOPS がディスクの上限に達しました。 DiskBPSExceedDiskMaxLimit：ディスクの BPS がディスクの上限に達しました。	DiskIOHang
ResourceId	string	リソース ID。	d-bp67acfmxazb4p****
ResourceType	string	リソースタイプ。	disk
Status	string	イベントステータス。有効な値： WillExecute：保留中 Executing：処理中 Executed：処理済み Ignore：無視 Expired：期限切れ Deleted：削除済み	WillExecute
StartTime	string	イベントの開始時刻。この値はミリ秒単位の UNIX タイムスタンプです。	1684204822000
Description	string	イベントの説明。	need snapshot
RecommendAction	string	イベント発生後推奨される操作。有効な値： ModifyDiskSpec：ディスクのスペックアップまたはスペックダウン。 CreateSnapshot：スナップショットの作成。 ResizeDisk：ディスクのスケールアウト。 AdjustProvision：プロビジョンドパフォーマンスの調整。 ModifyInstanceSpec：インスタンスのスペックアップまたはスペックダウン。	AdjustProvision
RecommendParams	string	推奨操作のパラメーター。	4296
EventLevel	string	イベントレベル。有効な値： INFO WARN CRITICAL	INFO
EndTime	string	イベントの終了時刻。この値はミリ秒単位の UNIX タイムスタンプです。	1679538083000
ExtraAttributes	string	追加のプロパティ。以下のフィールドが含まれる可能性があります。 EcsInstanceId：ディスクが接続されている ECS インスタンスの ID。 Adapter：ディスクのマウントポイント。	{\"EcsInstanceId\":\"i-uf6dkn9qpcw6y94g7ag7\",\"Adapter\":\"hda\"}

例

成功レスポンス

JSONJSON

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "TotalCount": 1,
  "NextToken": "AAAAAdDWBF2****",
  "ResourceEvents": [
    {
      "EventType": "Alert",
      "EventName": "DiskIOHang",
      "ResourceId": "d-bp67acfmxazb4p****\n",
      "ResourceType": "disk",
      "Status": "WillExecute",
      "StartTime": "1684204822000",
      "Description": "need snapshot",
      "RecommendAction": "AdjustProvision",
      "RecommendParams": "4296",
      "EventLevel": "INFO",
      "EndTime": "1679538083000",
      "ExtraAttributes": "{\\\"EcsInstanceId\\\":\\\"i-uf6dkn9qpcw6y94g7ag7\\\",\\\"Adapter\\\":\\\"hda\\\"}"
    }
  ]
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	App.NumberExceed	The number of apps exceeded.
400	DocumentConvertFailed.ExceedFileSizeLimit	The conversion has been failed, exceed file size limit.	日文说明1
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.
400	IdempotentParameterMismatch	The specified parameter has changed while using an already used clientToken.
400	InvalidDiskSize.NotSupported	The specified parameter size is not valid.
400	InvalidParameter	The parameter %s is invalid.
400	InvalidParameter.Conflict	The specified parameter %s and %s are not blank at the same time.
400	InvalidParameter.EndTime	The specified parameter EndTime is earlier than StartTime.
400	InvalidParameter.Format	Specified parameter format is not valid.	日文说明
400	InvalidParameter.TooManyDataQueried	Too many data queried.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.
403	AliCroup2CloudUserCannotBuyNotInnerCommodity	There is no group cloud commodity label, and users within the group are not allowed to purchase.	日文说明1
403	Forbidden	User is not authorized to operate.
403	Forbidden.Action	User is not authorized to operate this action.
403	IncorrectDiskStatus.CreatingSnapshot	A previous snapshot creation is in process.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.
403	InvalidDiskCategory.NotSupported	The specified disk category is not supported.
404	InvalidApi.NotFound	Specified api is not found, please check your url and method.
404	NoSuchResource	The specified resource does not exist.
504	RequestTimeout	The request is timeout, please try again later.

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

変更履歴

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