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

# listClusterLog直播
<a name="list-cluster-log-streams"></a>

检索与集群关联的日志流的列表。

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

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

```
GET /v3/clusters/{clusterName}/logstreams
{
  "filters": [ "string" ],
  "nextToken": "string",
  "region": "string"
}
```

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

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

**filters**  
筛选日志流。  
可接受的筛选器包括：  
+ private-dns-name：实例私有 DNS 名称的缩写形式（例如 ip-10-0-0-0-101）。
+ node-type：有效值：`HeadNode`。
类型：字符串数组，唯一  
格式：`Name=a,Values=1 Name=b,Values=2,3`  
必需：否

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

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

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

```
{
  "nextToken": "string",
  "logStreams": [
    {
      "logStreamName": "string",
      "creationTime": "2019-08-24T14:15:22Z",
      "firstEventTimestamp": "2019-08-24T14:15:22Z",
      "lastEventTimestamp": "2019-08-24T14:15:22Z",
      "lastIngestionTime": "2019-08-24T14:15:22Z",
      "uploadSequenceToken": "string",
      "logStreamArn": "string"
    }
  ]
}
```

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

**logStreams**  
日志流的列表。    
**creationTime**  
创建流的时间。  
类型：日期时间  
**firstEventTimestamp**  
流中第一个事件的时间。  
类型：日期时间  
**lastEventTimestamp**  
流中最后一个事件的时间。该 lastEventTime 值以最终一致性为基础进行更新。它通常会在摄取后不到一小时内更新，但在极少数情况下可能需要更长时间。  
类型：日期时间  
**lastIngestionTime**  
上次摄取时间。  
类型：日期时间  
**logStreamArn**  
日志流的 Amazon 资源名称 (ARN)。  
类型：字符串  
**logStreamName**  
日志流的名称。  
类型：字符串  
**uploadSequenceToken**  
序列令牌。  
类型：字符串

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

## 示例
<a name="list-cluster-log-streams-example"></a>

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

**请求**

```
$ list_cluster_log_streams(cluster_name_3x)
```

**200 响应**

```
{
  'log_streams': [
      {
        'creation_time': datetime.datetime(2022, 3, 30, 14, 7, 34, 354000, tzinfo=tzlocal()),
        'first_event_timestamp': datetime.datetime(2022, 3, 30, 14, 6, 41, 444000, tzinfo=tzlocal()),
        'last_event_timestamp': datetime.datetime(2022, 3, 30, 14, 25, 55, 462000, tzinfo=tzlocal()),
        'last_ingestion_time': datetime.datetime(2022, 3, 30, 14, 49, 50, 62000, tzinfo=tzlocal()),
        'log_stream_arn': 'arn:aws:logs:us-east-1:123456789012:log-group:/aws/parallelcluster/cluster_name_3x:log-stream:ip-192-0-2-26.i-abcdef01234567890.cfn-init',
        'log_stream_name': 'ip-192-0-2-26.i-abcdef01234567890.cfn-init',
         ...
        'upload_sequence_token': '####'
      },
      ...
   ]
}
```

------