本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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.555 Z
类型:Timestamp
必需:否
- MaxResults
-
包括在响应中的最大记录数。如果存在的记录多于指定MaxResults值,则在响应中包含一个标记,以便可以检索剩余的结果。
类型:整数
必需:否
- NextToken
-
如果记录总数超过的值,则传递一个可选参数MaxResults。如果返回 nextToken,则有更多结果可用。nextToken 的值是每个页面的唯一分页标记。使用返回的令牌再次拨打以检索下一页。所有所有其他参数所有其他参数保持所有其他参数不变
类型:字符串
必需:否
- SourceName
-
为其返回事件的事件源的标识符。未指定,则响应中未指定,则响应中未指定。
类型:字符串
必需:否
- SourceType
-
要从中检索事件的事件源。如果未指定值,则返回所有事件。
类型:字符串
有效值:
node | parameter-group | subnet-group | cluster | user | acl
必需:否
- StartTime
-
要检索事件的时间段的开始,以 ISO 8601 格式指定。示例:2017-03-30T07:03:49.555 Z
类型:Timestamp
必需:否
响应语法
{
"Events": [
{
"Date": number,
"Message": "string",
"SourceName": "string",
"SourceType": "string"
}
],
"NextToken": "string"
}
响应元素
如果此操作成功,则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回的以下数据。
错误
有关所有操作常见错误的信息,请参阅常见错误。
- InvalidParameterCombinationException
-
HTTP 状态代码:400
- InvalidParameterValueException
-
HTTP 状态代码:400
- ServiceLinkedRoleNotFoundFault
-
HTTP 状态代码:400
另请参阅
有关在特定语言的 Amazon 软件开发工具包中使用此 API 的更多信息,请参阅以下内容: