本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
DescribeEvents
返回与集群、安全组、和参数组相关的事件。对于特定的集群、安全组、或参数组,特定于它们的事件可以通过提供名称作为参数来获取。默认情况下,仅返回最近一小时内发生的事件;但是,如有必要,您可以检索最多 14 天内的事件。
请求语法
{
"Duration": number
,
"EndTime": number
,
"MaxResults": number
,
"NextToken": "string
",
"SourceName": "string
",
"SourceType": "string
",
"StartTime": number
}
请求参数
有关所有操作的通用参数的信息,请参阅通用参数。
请求接受采用 JSON 格式的以下数据。
- Duration
-
要检索事件的分钟数。
类型:整数
必需:否
- EndTime
-
要检索事件的时间段的结束,以 ISO 8601 格式指定。示例:2017-03-30T07:03:49.555Z
类型:时间戳
必需:否
- MaxResults
-
包括在响应中的最大记录数。如果存在的记录多于指定 MaxResults 值,则响应中会包含一个标记,以便可以检索剩余的结果。
类型:整数
必需:否
- NextToken
-
一个可选参数,用于在记录总数超过的值时传递 MaxResults。如果返回 nextToken,则会有更多可用结果。nextToken 的值是每个页面的唯一分页令牌。使用返回的令牌再次调用以检索下一页。保留所有其他参数不变。
类型:字符串
必需:否
- SourceName
-
为其返回事件的事件源的标识符。如果未指定,则响应中包含所有源。
类型:字符串
必需:否
- SourceType
-
要从中检索事件的事件源。如果未指定值,则返回所有事件。
类型:字符串
有效值:
node | parameter-group | subnet-group | cluster | user | acl
必需:否
- StartTime
-
要检索事件的时间段的开始,以 ISO 8601 格式指定。示例:2017-03-30T07:03:49.555Z
类型:时间戳
必需:否
响应语法
{
"Events": [
{
"Date": number,
"Message": "string",
"SourceName": "string",
"SourceType": "string"
}
],
"NextToken": "string"
}
响应元素
如果此操作成功,则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回以下数据。
错误
有关所有操作的常见错误的信息,请参阅常见错误。
- InvalidParameterCombinationException
-
HTTP 状态代码:400
- InvalidParameterValueException
-
HTTP 状态代码:400
- ServiceLinkedRoleNotFoundFault
-
HTTP 状态代码:400
另请参阅
有关在特定语言的 Amazon SDK 中使用此 API 的更多信息,请参阅以下内容: