首页 配额中心 API参考 API目录 配额告警 ListAlarmHistories - 查询配额用量告警历史记录

ListAlarmHistories - 查询配额用量告警历史记录

查询配额告警历史记录。

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称 类型 必填 描述 示例值
NextToken string

用来标记开始查询数据的位置。置空表示从头开始。

1
MaxResults integer

本次查询最大记录条数。

取值范围:1~200。默认值:30。

30
Keyword string

查询关键字。

数量
StartTime long

查询开始时间。

20201020
EndTime long

查询结束时间。

20201024
ProductCode string

云服务名称缩写。

说明 关于支持配额中心的云服务,请参见支持配额中心的云服务
ecs

关于公共请求参数的详情,请参见公共参数

返回参数

名称 类型 描述 示例值
object
TotalCount integer

本次请求返回的全部记录条数。

4
NextToken string

用来标记返回查询数据的位置。空表示数据已经查询完毕。

1
RequestId string

请求ID。

CB38DDF9-B1E0-48C1-9966-19C443C2841E
MaxResults integer

本次查询返回的最大记录条数。

4
AlarmHistories array

配额告警历史记录详情。

object
QuotaUsage number

已使用配额。

31
ThresholdPercent number

配额告警阈值的百分比。

80
CreateTime string

配额告警创建时间。

2021-01-24T09:20:09Z
QuotaActionCode string

配额ID。

q_security-groups
AlarmName string

配额告警名称。

安全组总数量上限
NotifyTarget string

配额告警通知对象。

accountContact
NotifyChannels array
string

配额告警通知渠道。取值:

  • sms:短信。

  • email:邮件。

["sms", "email"]
Threshold number

配额告警阈值的数值。

29
ProductCode string

云服务名称缩写。

ecs

示例

正常返回示例

JSON格式

{
  "TotalCount": 4,
  "NextToken": "1",
  "RequestId": "CB38DDF9-B1E0-48C1-9966-19C443C2841E",
  "MaxResults": 4,
  "AlarmHistories": [
    {
      "QuotaUsage": 31,
      "ThresholdPercent": 80,
      "CreateTime": "2021-01-24T09:20:09Z",
      "QuotaActionCode": "q_security-groups",
      "AlarmName": "安全组总数量上限",
      "NotifyTarget": "accountContact",
      "NotifyChannels": [
        "[\"sms\", \"email\"]"
      ],
      "Threshold": 29,
      "ProductCode": "ecs"
    }
  ]
}

错误码

Http code 错误码 错误信息 描述
400 InvalidStartTime Invalid StartTime 查询开始时间无效
400 InvalidEndTime Invalid EndTime 查询结束时间无效

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

阿里云首页 配额中心 相关技术圈