本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# getClusterLogEvents
<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>

**事件**  
篩選的事件清單。    
**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"
  },
  ...
]
```

------