Use DescribeEvents to query threat events for disks - Elastic Compute Service - Alibaba Cloud - Elastic Compute Service

Queries cloud disk risk events.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

ebs:DescribeEvents

none

*All Resource

*

None

Request parameters

Parameter	Type	Required	Description	Example
RegionId	string	Yes	The region ID. You can call DescribeRegions to query the list of regions supported by EBS Lens.	cn-hangzhou
EventName	string	No	The event name. Valid values: NoSnapshot: data protection BurstIOTriggered: burst I/O CostOptimizationNeeded: cost optimization DiskSpecNotMatchedWithInstance: instance and disk specification mismatch DiskIONo4kAligned: non-4K aligned read/write DiskIOHang: disk IOHang occurred InstanceIOPSExceedInstanceMaxLimit: instance IOPS reached the upper limit InstanceBPSExceedInstanceMaxLimit: instance BPS reached the upper limit DiskIOPSExceedInstanceMaxLimit: disk IOPS reached the instance upper limit DiskBPSExceedInstanceMaxLimit: disk BPS reached the instance upper limit DiskIOPSExceedDiskMaxLimit: disk IOPS reached the disk upper limit DiskBPSExceedDiskMaxLimit: disk BPS reached the disk upper limit	DiskIOHang
ResourceId	string	No	The resource ID.	d-bp67acfmxazb4p****
ResourceType	string	No	The resource type. Valid values: disk: cloud disk	disk
Status	string	No	The event status. Valid values: WillExecute: pending Executing: processing Executed: processed Ignore: ignored Expired: expired Deleted: deleted	WillExecute
StartTime	string	No	The start time of the event. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.	2023-06-01T03:00:00Z
EndTime	string	No	The end time of the event. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.	2023-06-01T04:00:00Z
MaxResults	integer	No	The maximum number of entries per page for a paged query. If you specify this parameter, the `MaxResults` and `NextToken` parameters are used together for the query. Valid values: 1 to 100. Default value: 10.	10
NextToken	string	No	The pagination token. Set this parameter to the NextToken value returned in the previous API call.	AAAAAdDWBF2****
EventLevel	string	No	The event level. Valid values: INFO: Notification. WARN: Warning. CRITICAL: Critical.	WARN

Response elements

Element	Type	Description	Example
	object	Schema of Response
RequestId	string	Id of the request	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
TotalCount	integer	The total number of entries returned for the paged query.	1
NextToken	string	The token for the next query. If NextToken is empty, no more results exist.	AAAAAdDWBF2****
ResourceEvents	array<object>	The list of events.
	object
EventType	string	The event type. Valid values: Notification SystemException Alert	Alert
EventName	string	The event name. Valid values: NoSnapshot: data protection BurstIOTriggered: burst I/O CostOptimizationNeeded: cost optimization DiskSpecNotMatchedWithInstance: instance and disk specification mismatch DiskIONo4kAligned: non-4K aligned read/write DiskIOHang: disk IOHang occurred InstanceIOPSExceedInstanceMaxLimit: instance IOPS reached the upper limit InstanceBPSExceedInstanceMaxLimit: instance BPS reached the upper limit DiskIOPSExceedInstanceMaxLimit: disk IOPS reached the instance upper limit DiskBPSExceedInstanceMaxLimit: disk BPS reached the instance upper limit DiskIOPSExceedDiskMaxLimit: disk IOPS reached the disk upper limit DiskBPSExceedDiskMaxLimit: disk BPS reached the disk upper limit	DiskIOHang
ResourceId	string	The resource ID.	d-bp67acfmxazb4p****
ResourceType	string	The resource type.	disk
Status	string	The event status. Valid values: WillExecute: pending Executing: processing Executed: processed Ignore: ignored Expired: expired Deleted: deleted	WillExecute
StartTime	string	The start time of the event. This value is a timestamp in milliseconds.	1684204822000
Description	string	The event description.	You can purchase 4296 provisioned IOPS for cost optimization. Based on your usage over the past 7 days, costs are estimated to decrease by 16%
RecommendAction	string	The recommended action after the event occurs. Valid values: ModifyDiskSpec: change disk specifications CreateSnapshot: create a snapshot ResizeDisk: expand disk capacity AdjustProvision: adjust provisioned performance ModifyInstanceSpec: change instance specifications	AdjustProvision
RecommendParams	string	The parameters for the recommended action after the event occurs.	4296
EventLevel	string	The event level. Valid values: INFO WARN CRITICAL	INFO
EndTime	string	The end time of the event. This value is a timestamp in milliseconds.	1679538083000
ExtraAttributes	string	The additional properties. Possible fields: EcsInstanceId: the ID of the ECS instance to which the cloud disk is attached. Adapter: the mount point of the cloud disk.	{\"EcsInstanceId\":\"i-uf6dkn9qpcw6y94g7ag7\",\"Adapter\":\"hda\"}

Examples

Success response

JSON format

{
  "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\\\"}"
    }
  ]
}

Error codes

HTTP status code	Error code	Error message	Description
400	App.NumberExceed	The number of apps exceeded.
400	DocumentConvertFailed.ExceedFileSizeLimit	The conversion has been failed, exceed file size limit.	english description1
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.
400	IdempotentParameterMismatch	The specified parameter has changed while using an already used clientToken.	The request and a previous request contains the same client token but different parameters.
400	InvalidDiskSize.NotSupported	The specified parameter size is not valid.
400	InvalidParameter	The parameter %s is invalid.	The specified parameter value 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.	english description
400	InvalidParameter.TooManyDataQueried	Too many data queried.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	An internal error has occurred.
403	AliCroup2CloudUserCannotBuyNotInnerCommodity	There is no group cloud commodity label, and users within the group are not allowed to purchase.	There is no group cloud commodity label, and users within the group are not allowed to purchase.
403	Forbidden	User is not authorized to operate.	You are not authorized to manage the resource. Check the account permissions or contact the Alibaba Cloud account.
403	Forbidden.Action	User is not authorized to operate this action.	You are not authorized to perform this operation. Check the account permissions or contact the Alibaba Cloud account.
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.	The specified resource does not exist.
504	RequestTimeout	The request is timeout, please try again later.	The request has timed out. Try again later.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.