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

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

DescribeEvents

返回过去 14 天与实例、安全组、快照和数据库参数组相关的事件。您可通过提供名称作为参数来获取特定于特定于它们的事件、安全组、快照或参数组。默认情况下,返回过去一小时的事件。

请求参数

有关所有操作通用的参数的信息,请参阅常见参数.

Duration

从中检索事件的分钟数。

默认值:60

类型: 整数

:必需 否

EndTime

要检索事件的时间段的结束,以 ISO 8601 格式指定。

例如:2009-07-08T 18:00 Z

类型: 时间戳

:必需 否

事件类别。事件类别 .n

触发事件通知订阅的通知的事件类别列表。

类型: 字符串数组

:必需 否

过滤器。过滤器 .N

当前不支持此参数。

类型: 数组 Filter objects

:必需 否

Marker

由之前的请求提供的可选分页标记。如果指定此参数,则响应仅包含标记之外的记录,最大数量为 MaxRecords 指定的值。

类型: String

:必需 否

MaxRecords

包括在响应中的最大记录数。如果存在的记录多于指定的MaxRecords值,则在响应中包含分页记号(标记),以便检索剩余的结果。

默认值:100

约束:最低为 20,最高为 100。

类型: 整数

:必需 否

SourceIdentifier

为其返回事件的事件源的标识符。如果未指定,则响应中包含所有源。

约束:

  • 如果SourceIdentifier已提供,SourceType还必须提供。

  • 如果源类型是DBInstance,aDBInstanceIdentifier必须提供。

  • 如果源类型是DBSecurityGroup,aDBSecurityGroupName必须提供。

  • 如果源类型是DBParameterGroup,aDBParameterGroupName必须提供。

  • 如果源类型是DBSnapshot,aDBSnapshotIdentifier必须提供。

  • 不能以连字符结束或包含两个连续连字符。

类型: String

:必需 否

SourceType

要从中检索事件的事件源。如果未指定值,则返回所有事件。

类型: String

有效值: db-instance | db-parameter-group | db-security-group | db-snapshot | db-cluster | db-cluster-snapshot

:必需 否

StartTime

要检索事件的时间段的开始,以 ISO 8601 格式指定。

例如:2009-07-08T 18:00 Z

类型: 时间戳

:必需 否

响应元素

服务返回以下元素。

事件。事件。N

有关一个或多个事件的详细信息。

类型: 数组 Event objects

Marker

由之前的请求提供的可选分页标记。如果指定此参数,则响应仅包含标记之外的记录,最大数量为 MaxRecords 指定的值。

类型: String

Errors

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

另请参阅

有关在特定语言的Amazon软件开发工具包中使用此 API 的更多信息,请参阅以下内容: