DescribeEvents - Amazon DocumentDB
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

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 指定的值。

类型:字符串

错误

有关所有操作返回的常见错误的信息,请参阅 常见错误

另请参阅

有关在特定语言的 Amazon SDK 中使用此 API 的更多信息,请参阅以下内容: