首页 >配额中心 >API参考 >API目录 >配额告警 >GetQuotaAlarm - 查询配额用量告警详情

GetQuotaAlarm - 查询配额用量告警详情

调用GetQuotaAlarm接口查询目标配额告警详情。

接口说明

本文将提供一个示例,查询配额告警78d7e436-4b25-4897-84b5-d7b656bb****的详情。返回结果显示配额告警的详情,包括:告警ID、告警名称、告警创建时间、通知对象等。

调试

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

调试

授权信息

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

请求参数

名称类型必填描述示例值
AlarmIdstring

配额告警ID。

关于如何获取配额告警ID,请参见ListQuotaAlarms

78d7e436-4b25-4897-84b5-d7b656bb****

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

返回参数

名称类型描述示例值
object
RequestIdstring

请求ID。

81B9D511-F3DD-43B1-9A81-1795DDB52ADF
QuotaAlarmobject

配额告警详情。

ThresholdPercentnumber

配额告警阈值的百分比。

50
QuotaDimensionobject

配额维度。

{"regionId":"cn-hangzhou"}
CreateTimestring

配额告警创建时间。

2021-01-21T03:47:28Z
QuotaActionCodestring

配额ID。

q_security-groups
AlarmNamestring

配额告警名称。

安全组总数量上限
NotifyTargetstring

配额告警通知对象。

accountContact
QuotaUsagenumber

配额用量。

28
ThresholdTypestring

配额告警类型。取值:

  • used:配额已使用量告警。
  • usable:配额剩余可用量告警。
used
QuotaValuenumber

配额值。

804
AlarmIdstring

配额告警ID。

78d7e436-4b25-4897-84b5-d7b656bb****
Thresholdnumber

配额告警阈值的数值。

29
ProductCodestring

云服务名称缩写。

ecs
NotifyChannelsarray
string

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

  • sms:短信。

  • email:邮箱。

["sms", "email"]

示例

请求示例

http(s)://[Endpoint]/?Action=GetQuotaAlarm
&AlarmId=78d7e436-4b25-4897-84b5-d7b656bb****
&<公共请求参数>

正常返回示例

JSON格式

{
    "RequestId": "81B9D511-F3DD-43B1-9A81-1795DDB52ADF",
    "QuotaAlarm": {
        "AlarmId": "78d7e436-4b25-4897-84b5-d7b656bb****",
        "QuotaActionCode": "q_security-groups",
        "NotifyChannels": [
            "sms",
            "email"
        ],
        "QuotaValue": 804,
        "AlarmName": " 安全组总数量上限",
        "ProductCode": "ecs",
        "NotifyTarget": "accountContact",
        "CreateTime": "2021-01-21T03:47:28Z",
        "QuotaDimension": {
            "regionId": "cn-hangzhou"
        },
        "QuotaUsage": 28,
        "Threshold": 29,
        "ThresholdType": "used"
    }
}

XML格式

<GetQuotaAlarmResponse>
	<RequestId>81B9D511-F3DD-43B1-9A81-1795DDB52ADF</RequestId>
	<QuotaAlarm>
		<AlarmId>78d7e436-4b25-4897-84b5-d7b656bb****</AlarmId>
		<QuotaActionCode>q_security-groups</QuotaActionCode>
		<NotifyChannels>sms</NotifyChannels>
		<NotifyChannels>email</NotifyChannels>
		<QuotaValue>804</QuotaValue>
		<AlarmName> 安全组总数量上限</AlarmName>
		<ProductCode>ecs</ProductCode>
		<NotifyTarget>accountContact</NotifyTarget>
		<CreateTime>2021-01-21T03:47:28Z</CreateTime>
		<QuotaDimension>
			<regionId>cn-hangzhou</regionId>
		</QuotaDimension>
		<QuotaUsage>28</QuotaUsage>
		<Threshold>29</Threshold>
        <ThresholdType>used</ThresholdType>
	</QuotaAlarm>
</GetQuotaAlarmResponse>	

错误码

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

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