DescribeEvents を使用したディスクの脅威イベントクエリ - ECS - Alibaba Cloud - Elastic Compute Service

クラウドディスクのリスクイベントを照会します。

今すぐお試しください

この 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: バースト I/O CostOptimizationNeeded: コスト最適化 DiskSpecNotMatchedWithInstance: インスタンスとディスクの仕様の不一致 DiskIONo4kAligned: 非 4K アラインメント読み取り/書き込み DiskIOHang: ディスク IOHang の発生 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	任意	イベントの開始時刻。時間は ISO 8601 標準の yyyy-MM-ddTHH:mm:ssZ フォーマットで指定します。時間は協定世界時 (UTC) でなければなりません。	2023-06-01T03:00:00Z
EndTime	string	任意	イベントの終了時間。時間は ISO 8601 標準の yyyy-MM-ddTHH:mm:ssZ フォーマットで指定します。時間は協定世界時 (UTC) でなければなりません。	2023-06-01T04:00:00Z
MaxResults	integer	任意	ページングクエリの 1 ページあたりの最大値。このパラメーターを指定すると、クエリに `MaxResults` と `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	次のクエリのトークン。NextToken が空の場合、これ以上結果はありません。	AAAAAdDWBF2****
ResourceEvents	array<object>	イベントのリスト。
	object
EventType	string	イベントタイプ。有効な値: Notification SystemException Alert	Alert
EventName	string	イベント名。有効な値: NoSnapshot: データ保護 BurstIOTriggered: バースト I/O CostOptimizationNeeded: コスト最適化 DiskSpecNotMatchedWithInstance: インスタンスとディスクの仕様の不一致 DiskIONo4kAligned: 非 4K アラインメント読み取り/書き込み DiskIOHang: ディスク IOHang の発生 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	イベントの開始時刻。この値はミリ秒単位のタイムスタンプです。	1684204822000
Description	string	イベントの説明。	コスト最適化のために 4296 のプロビジョニング済み IOPS を購入できます。過去 7 日間の使用状況に基づき、コストは 16% 削減されると推定されます
RecommendAction	string	イベント発生後の推奨操作。有効な値: ModifyDiskSpec: ディスク仕様の変更 CreateSnapshot: スナップショットの作成 ResizeDisk: ディスク容量の拡張 AdjustProvision: プロビジョニング済みのパフォーマンスの調整 ModifyInstanceSpec: インスタンスの仕様の変更	AdjustProvision
RecommendParams	string	イベント発生後の推奨操作のパラメーター。	4296
EventLevel	string	イベントレベル。有効な値: INFO WARN CRITICAL	INFO
EndTime	string	イベントの終了時間。この値はミリ秒単位のタイムスタンプです。	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": "可通过购买4296预配置IOPS以获得成本优化，根据您过往7天使用情况，预计成本可以下降16%。",
      "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.

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

変更履歴

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