全部产品
Search

搜索本产品

    云服务器 ECS：DescribeEvents - 查询资源事件

    文档中心

    云服务器 ECS：DescribeEvents - 查询资源事件

    更新时间：Nov 12, 2024

    查询云盘风险事件。

    调试

    您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

    授权信息

    下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

    • 操作：是指具体的权限点。
    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：
      • 对于必选的资源类型，用背景高亮的方式表示。
      • 对于不支持资源级授权的操作，用全部资源表示。
    • 条件关键字：是指云产品自身定义的条件关键字。
    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
    操作访问级别资源类型条件关键字关联操作
    ebs:DescribeEventsnone
    • 全部资源
      *
      无
    		无

    请求参数

    名称类型必填描述示例值
    RegionIdstring是

    地域 ID。您可以调用 DescribeRegions 查询块存储数据洞察支持的地域列表。

    		cn-hangzhou
    EventNamestring否

    事件名称。取值范围：

    • NoSnapshot：数据保护
    • BurstIOTriggered：突发 IO
    • CostOptimizationNeeded：成本优化
    • DiskSpecNotMatchedWithInstance：实例与磁盘规格不匹配
    • DiskIONo4kAligned：非 4K 对齐读写
    • DiskIOHang：磁盘有 IOHang 发生
    • InstanceIOPSExceedInstanceMaxLimit：实例 IOPS 到达上限
    • InstanceBPSExceedInstanceMaxLimit：实例 BPS 到达上限
    • DiskIOPSExceedInstanceMaxLimit：磁盘 IOPS 到达实例上限
    • DiskBPSExceedInstanceMaxLimit：磁盘 BPS 到达实例上限
    • DiskIOPSExceedDiskMaxLimit：磁盘 IOPS 到达磁盘上限
    • DiskBPSExceedDiskMaxLimit：磁盘 BPS 到达磁盘上限
    		DiskIOHang
    ResourceIdstring否

    资源 ID。

    		d-bp67acfmxazb4p****
    ResourceTypestring否

    资源类型。取值范围：

    • disk：磁盘
    		disk
    Statusstring否

    事件状态。取值范围：

    • WillExecute：待处理
    • Executing：处理中
    • Executed：已处理
    • Ignore：已忽略
    • Expired：已过期
    • Deleted：已删除
    		WillExecute
    StartTimestring否

    事件开始时间点。按照 ISO8601 标准表示，并使用 UTC+0 时间，格式为 yyyy-MM-ddTHH:mm:ssZ。

    		2023-06-01T03:00:00Z
    EndTimestring否

    事件结束时间点。按照 ISO8601 标准表示，并使用 UTC+0 时间，格式为 yyyy-MM-ddTHH:mm:ssZ。

    		2023-06-01T04:00:00Z
    MaxResultsinteger否

    分页查询时每页的最大条目数。一旦设置该参数，即表示使用MaxResults与NextToken组合参数的查询方式。

    取值范围：1~100。

    默认值：10。

    		10
    NextTokenstring否

    查询凭证（Token），取值为上一次 API 调用返回的 NextToken 参数值。

    		AAAAAdDWBF2****

    返回参数

    名称类型描述示例值
    object

    Schema of Response

    RequestIdstring

    Id of the request

    		473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
    TotalCountinteger

    分页查询时的结果总条数。

    		1
    NextTokenstring

    下一个查询开始的 Token，NextToken 为空表示没有下一个。

    		AAAAAdDWBF2****
    ResourceEventsarray<object>

    事件列表。

    resourceEventobject
    EventTypestring

    事件类型。可能值：

    1. Notification
    2. SystemException
    3. Alert
    		Alert
    EventNamestring

    事件名称。可能值：

    • NoSnapshot：数据保护
    • BurstIOTriggered：突发 IO
    • CostOptimizationNeeded：成本优化
    • DiskSpecNotMatchedWithInstance：实例与磁盘规格不匹配
    • DiskIONo4kAligned：非 4K 对齐读写
    • DiskIOHang：磁盘有 IOHang 发生
    • InstanceIOPSExceedInstanceMaxLimit：实例 IOPS 到达上限
    • InstanceBPSExceedInstanceMaxLimit：实例 BPS 到达上限
    • DiskIOPSExceedInstanceMaxLimit：磁盘 IOPS 到达实例上限
    • DiskBPSExceedInstanceMaxLimit：磁盘 BPS 到达实例上限
    • DiskIOPSExceedDiskMaxLimit：磁盘 IOPS 到达磁盘上限
    • DiskBPSExceedDiskMaxLimit：磁盘 BPS 到达磁盘上限
    		DiskIOHang
    ResourceIdstring

    资源 ID。

    		d-bp67acfmxazb4p****
    ResourceTypestring

    资源类型。

    		disk
    Statusstring

    事件状态。可能值：

    1. WillExecute：待处理
    2. Executing：处理中
    3. Executed：已处理
    4. Ignore：已忽略
    5. Expired：已过期
    6. Deleted：已删除
    		WillExecute
    StartTimestring

    事件开始时间戳（毫秒级）。

    		1684204822000
    Descriptionstring

    事件描述。

    		可通过购买4296预配置IOPS以获得成本优化，根据您过往7天使用情况，预计成本可以下降16%。
    RecommendActionstring

    事件发生后的推荐操作。可能值：

    • ModifyDiskSpec：变配
    • CreateSnapshot：打快照
    • ResizeDisk：扩容
    • AdjustProvision：调节预配置等
    • ModifyInstanceSpec：实例变配
    		AdjustProvision
    RecommendParamsstring

    事件发生后的推荐操作的参数。

    		4296
    EventLevelstring

    事件级别，可能值：

    1. INFO
    2. WARN
    3. CRITICAL
    		INFO
    EndTimestring

    事件结束时间戳（毫秒级）。

    		1679538083000

    示例

    正常返回示例

    JSON格式

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

    错误码

    HTTP status code错误码错误信息描述
    400App.NumberExceedThe number of apps exceeded.app数量超过限制
    400DocumentConvertFailed.ExceedFileSizeLimitThe conversion has been failed, exceed file size limit.文档转换失败，文件大小超过系统限额。
    400Duplicate.TagKeyThe Tag.N.Key contain duplicate key.标签中存在重复的键，请保持键的唯一性。
    400IdempotentParameterMismatchThe specified parameter has changed while using an already used clientToken.如果您提供了一个已经使用过的ClientToken，但其他请求参数有变化。
    400InvalidDiskSize.NotSupportedThe specified parameter size is not valid.不支持的云盘大小
    400InvalidParameterThe parameter %s is invalid.参数错误
    400InvalidParameter.ConflictThe specified parameter %s and %s are not blank at the same time.参数冲突
    400InvalidParameter.EndTimeThe specified parameter EndTime is earlier than StartTime.参数 EndTime 早于 StartTime。
    400InvalidParameter.FormatSpecified parameter format is not valid.返回值格式不正确（Format 不支持）。返回格式支持 XML 与 JSON，默认为 XML。
    400InvalidParameter.TooManyDataQueriedToo many data queried.查询数据过多。
    403AliCroup2CloudUserCannotBuyNotInnerCommodityThere is no group cloud commodity label, and users within the group are not allowed to purchase.无集团上云商品标签，不允许集团内部用户购买。
    403ForbiddenUser is not authorized to operate.当前用户无权限对当前资源执行任何操作。请检查您的账号权限或者咨询您的主账号管理员。
    403Forbidden.ActionUser is not authorized to operate this action.当前用户无权限执行该操作。请检查您的账号权限或者咨询您的主账号管理员。
    403IncorrectDiskStatus.CreatingSnapshotA previous snapshot creation is in process.创建快照时有前序快照正在被创建
    403InvalidAccountStatus.NotEnoughBalanceYour account does not have enough balance.您的账户余额不足。
    403InvalidDiskCategory.NotSupportedThe specified disk category is not supported.当前操作不支持您指定的磁盘类型。请检查您的输入参数和API文档。
    404InvalidApi.NotFoundSpecified api is not found, please check your url and method.找不到指定的 API。请检查调用的 URL 和方法。您调用的 API 不存在。请检查 API 的名称是否正确，请注意确认大小写。
    404NoSuchResourceThe specified resource does not exist.指定的资源不存在。
    500InternalErrorThe request processing has failed due to some unknown error, exception or failure.内部错误。
    504RequestTimeoutThe request is timeout, please try again later.该请求超时，请稍后再重试。

    访问错误中心查看更多错误码。

    变更历史

    变更时间变更内容概要操作
    2024-08-19OpenAPI 错误码发生变更查看变更详情