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

# getClusterLog活动
<a name="get-cluster-log-events"></a>

检索与日志流关联的事件。

**Topics**
+ [请求语法](#get-cluster-log-events-request)
+ [请求正文](#get-cluster-log-events-request-body)
+ [响应语法](#get-cluster-log-events-response)
+ [响应正文](#get-cluster-log-events-response-body)
+ [示例](#get-cluster-log-events-example)

## 请求语法
<a name="get-cluster-log-events-request"></a>

```
GET /v3/clusters/{clusterName}/logstreams/{logStreamName}
{
  "endTime": datetime,
  "limit": float,
  "nextToken": "string",
  "region": "string",
  "startFromHead": boolean,
  "startTime": datetime
}
```

## 请求正文
<a name="get-cluster-log-events-request-body"></a>

**clusterName**  
集群的名称。  
类型：字符串。  
必需：是

**logStreamName**  
日志流的名称。  
类型：字符串。  
必需：是

**endTime**  
时间范围的结束，以 ISO 8601 格式表示。不包括时间戳等于或晚于该时间的事件。  
类型：日期时间  
格式：`2021-01-01T20:00:00Z`  
必需：否

**limit**  
返回的日志事件的最大数目。如果您不指定值，则最大值是响应大小为 1 MB 或最多 10,000 个日志事件中可以容纳的日志事件数。  
类型：浮点数  
必需：否

**nextToken**  
用于获取下一组结果的令牌。  
类型：字符串  
必需：否

**region**  
 AWS 区域 集群所在的。  
类型：字符串  
必需：否

**startFromHead**  
如果设置为 `true`，则最先返回最早的日志事件。如果值为 `false`，则最先返回最新的日志事件。默认值为 `false`。  
类型：布尔值  
必需：否

**startTime**  
时间范围的开始，以 ISO 8601 格式表示。包括时间戳等于或晚于该时间的事件。  
类型：日期时间  
格式：`2021-01-01T20:00:00Z`  
必需：否

## 响应语法
<a name="get-cluster-log-events-response"></a>

```
{
  "nextToken": "string",
  "prevToken": "string",
  "events": [
    {
      "timestamp": "2019-08-24T14:15:22Z",
      "message": "string"
    }
  ]
}
```

## 响应正文
<a name="get-cluster-log-events-response-body"></a>

**events**  
筛选的事件的列表。    
**message**  
事件消息。  
类型：字符串  
**timestamp**  
事件时间戳。  
类型：日期时间

**nextToken**  
用于检索下一组结果的令牌，没有更多结果时为 `null`。  
类型：字符串

**prevToken**  
一种标记，可用于检索前一组结果，`null`或者在没有其他结果时使用。  
类型：字符串

## 示例
<a name="get-cluster-log-events-example"></a>

------
#### [ Python ]

**请求**

```
$ get_cluster_log_events(cluster_name_3x, log_stream_name=ip-192-0-2-26.i-abcdef01234567890.cfn-init)
```

**200 响应**

```
"events": [
  {
    "message": "2022-09-22 16:40:15,127 [DEBUG] CloudFormation client initialized with endpoint https://cloudformation.us-east-1.amazonaws.com",
    "timestamp": "2022-09-22T16:40:15.127Z"
  },
  {
    "message": "2022-09-22 16:40:15,127 [DEBUG] Describing resource HeadNodeLaunchTemplate in stack cluster_name_3x",
    "timestamp": "2022-09-22T16:40:15.127Z"
  },
  ...
]
```

------