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

# ListClusterSnapshots
<a name="API_elastic_ListClusterSnapshots"></a>

返回有关指定弹性集群的快照的信息。

## 请求语法
<a name="API_elastic_ListClusterSnapshots_RequestSyntax"></a>

```
GET /cluster-snapshots?clusterArn=clusterArn&maxResults=maxResults&nextToken=nextToken&snapshotType=snapshotType HTTP/1.1
```

## URI 请求参数
<a name="API_elastic_ListClusterSnapshots_RequestParameters"></a>

请求使用以下 URI 参数。

 ** [clusterArn](#API_elastic_ListClusterSnapshots_RequestSyntax) **   <a name="documentdb-elastic_ListClusterSnapshots-request-uri-clusterArn"></a>
弹性集群的 ARN 标识符。

 ** [maxResults](#API_elastic_ListClusterSnapshots_RequestSyntax) **   <a name="documentdb-elastic_ListClusterSnapshots-request-uri-maxResults"></a>
在响应中接收的弹性集群快照结果的最大数量。  
有效范围：最小值为 20。最大值为 100。

 ** [nextToken](#API_elastic_ListClusterSnapshots_RequestSyntax) **   <a name="documentdb-elastic_ListClusterSnapshots-request-uri-nextToken"></a>
由之前的请求提供的分页标记。如果指定此参数，则响应仅包含该标记之外的记录，最大数量为 `max-results` 指定的值。  
如果响应中没有更多数据，则不会返回 `nextToken`。

 ** [snapshotType](#API_elastic_ListClusterSnapshots_RequestSyntax) **   <a name="documentdb-elastic_ListClusterSnapshots-request-uri-snapshotType"></a>
要返回的集群快照的类型。可以指定以下值之一：  
+  `automated`-返回 Amazon DocumentDB 自动为您的 AWS 账户创建的所有集群快照。
+  `manual`-返回您为 AWS 账户手动创建的所有集群快照。

## 请求正文
<a name="API_elastic_ListClusterSnapshots_RequestBody"></a>

该请求没有请求正文。

## 响应语法
<a name="API_elastic_ListClusterSnapshots_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "nextToken": "string",
   "snapshots": [ 
      { 
         "clusterArn": "string",
         "snapshotArn": "string",
         "snapshotCreationTime": "string",
         "snapshotName": "string",
         "status": "string"
      }
   ]
}
```

## 响应元素
<a name="API_elastic_ListClusterSnapshots_ResponseElements"></a>

如果此操作成功，则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。

 ** [nextToken](#API_elastic_ListClusterSnapshots_ResponseSyntax) **   <a name="documentdb-elastic_ListClusterSnapshots-response-nextToken"></a>
由之前的请求提供的分页标记。如果指定此参数，则响应仅包含该标记之外的记录，最大数量为 `max-results` 指定的值。  
如果响应中没有更多数据，则不会返回 `nextToken`。  
类型：字符串

 ** [snapshots](#API_elastic_ListClusterSnapshots_ResponseSyntax) **   <a name="documentdb-elastic_ListClusterSnapshots-response-snapshots"></a>
指定弹性集群的快照列表。  
类型：[ClusterSnapshotInList](API_elastic_ClusterSnapshotInList.md) 对象数组

## 错误
<a name="API_elastic_ListClusterSnapshots_Errors"></a>

有关所有操作的常见错误的信息，请参阅[常见错误](CommonErrors.md)。

 ** AccessDeniedException **   
没有足够权限执行某操作时出现的异常。    
 ** message **   
一条解释访问被拒绝原因的错误消息。
HTTP 状态代码：403

 ** InternalServerException **   
出现内部服务器错误。  
HTTP 状态代码：500

 ** ThrottlingException **   
ThrottlingException 当由于请求限制而导致请求被拒绝时，将抛出。    
 ** retryAfterSeconds **   
重试操作之前等待的秒数。
HTTP 状态代码：429

 ** ValidationException **   
定义验证异常的结构。    
 ** fieldList **   
发生验证异常的字段列表。  
 ** message **   
一条描述验证异常的错误消息。  
 ** reason **   
发生验证异常的原因（`unknownOperation`、`cannotParse`、`fieldValidationFailed` 或 `other` 之一）。
HTTP 状态代码：400

## 另请参阅
<a name="API_elastic_ListClusterSnapshots_SeeAlso"></a>

有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容：
+  [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/docdb-elastic-2022-11-28/ListClusterSnapshots) 
+  [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-elastic-2022-11-28/ListClusterSnapshots) 
+  [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-elastic-2022-11-28/ListClusterSnapshots) 
+  [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-elastic-2022-11-28/ListClusterSnapshots) 
+  [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/ListClusterSnapshots) 
+  [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-elastic-2022-11-28/ListClusterSnapshots) 
+  [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-elastic-2022-11-28/ListClusterSnapshots) 
+  [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-elastic-2022-11-28/ListClusterSnapshots) 
+  [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/docdb-elastic-2022-11-28/ListClusterSnapshots) 
+  [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/ListClusterSnapshots)