本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
DescribeEvents
返回过去 14 天与实例、安全组、快照和数据库参数组相关的事件。对于特定的数据库实例、安全组、快照或参数组,特定于它们的事件可以通过提供名称作为参数来获取。默认情况下,返回过去一小时的事件。
请求参数
有关所有操作的通用参数的信息,请参阅通用参数。
- Duration
-
从中检索事件的分钟数。
默认值:60
类型:整数
必需:否
- EndTime
-
要检索事件的时间段的结束,以 ISO 8601 格式指定。
示例:2009-07-08T18:00Z
类型:时间戳
必需:否
- EventCategories.EventCategory.N
-
触发事件通知订阅的通知的事件类别列表。
类型:字符串数组
必需:否
- Filters.Filter.N
-
当前不支持此参数。
类型:Filter 对象数组
必需:否
- Marker
-
由之前的请求提供的可选分页标记。如果指定此参数,则响应仅包含标记之外的记录,最大数量为
MaxRecords
指定的值。类型:字符串
必需:否
- MaxRecords
-
包括在响应中的最大记录数。如果存在的记录数超过了指定的
MaxRecords
值,则在响应中包含分页记号(标记),以便检索剩余的结果。默认值:100
约束:最低为 20,最高为 100。
类型:整数
必需:否
- SourceIdentifier
-
为其返回事件的事件源的标识符。如果未指定,则响应中包含所有源。
约束:
-
如果提供了
SourceIdentifier
,则也必须提供SourceType
。 -
如果源类型是
DBInstance
,则必须提供DBInstanceIdentifier
。 -
如果源类型是
DBSecurityGroup
,则必须提供DBSecurityGroupName
。 -
如果源类型是
DBParameterGroup
,则必须提供DBParameterGroupName
。 -
如果源类型是
DBSnapshot
,则必须提供DBSnapshotIdentifier
。 -
不能以连字符结束或包含两个连续连字符。
类型:字符串
必需:否
-
- SourceType
-
要从中检索事件的事件源。如果未指定值,则返回所有事件。
类型:字符串
有效值:
db-instance | db-parameter-group | db-security-group | db-snapshot | db-cluster | db-cluster-snapshot
必需:否
- StartTime
-
要检索事件的时间段的开始,以 ISO 8601 格式指定。
示例:2009-07-08T18:00Z
类型:时间戳
必需:否
响应元素
服务返回以下元素。
- Events.Event.N
-
有关一个或多个事件的详细信息。
类型:Event 对象数组
- Marker
-
由之前的请求提供的可选分页标记。如果指定此参数,则响应仅包含标记之外的记录,最大数量为
MaxRecords
指定的值。类型:字符串
错误
有关所有操作的常见错误的信息,请参阅常见错误。
另请参阅
有关在特定语言的 AWS SDK 中使用此 API 的更多信息,请参阅以下内容: