翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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`  
必須: いいえ

**制限**  
返されるログイベントの最大数数。値を指定しない場合、最大値は 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"
  },
  ...
]
```

------