

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

# DescribeDBClusterSnapshots
<a name="API_DescribeDBClusterSnapshots"></a>

傳回叢集快照的相關資訊。此 API 操作支援分頁。

## 請求參數
<a name="API_DescribeDBClusterSnapshots_RequestParameters"></a>

 如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。

 ** DBClusterIdentifier **   
要擷取叢集快照清單的叢集 ID。此參數無法與 `DBClusterSnapshotIdentifier` 參數搭配使用。此參數不區分大小寫。  
限制條件：  
+ 如果提供， 必須符合現有 的識別符`DBCluster`。
類型：字串  
必要：否

 ** DBClusterSnapshotIdentifier **   
要描述的特定叢集快照識別符。此參數無法與 `DBClusterIdentifier` 參數搭配使用。此值會以小寫字母字串的形式儲存。  
限制條件：  
+ 如果提供， 必須符合現有 的識別符`DBClusterSnapshot`。
+ 如果這是用於自動快照的識別符，也必須指定 `SnapshotType` 參數。
類型：字串  
必要：否

 **Filters.Filter.N**   
目前不支援此參數。  
類型：[Filter](API_Filter.md) 物件陣列  
必要：否

 ** IncludePublic **   
設定為 `true`以包含公開且可由任何 複製或還原的手動叢集快照 AWS 帳戶，否則為 `false`。預設值為 `false`。  
類型：布林值  
必要：否

 ** IncludeShared **   
設定為 `true` 以包含來自其他 的共用手動叢集快照 AWS 帳戶 ，該快照 AWS 帳戶 已獲得複製或還原的許可，否則為 `false`。預設值為 `false`。  
類型：布林值  
必要：否

 ** Marker **   
前一個請求提供的選用分頁字符。若指定此參數，則回應只會包含超過標記的記錄，直到 `MaxRecords` 指定的值為止。  
類型：字串  
必要：否

 ** MaxRecords **   
 要在回應中包含的記錄數量上限。如果存在的記錄超過指定的`MaxRecords`值，回應中會包含分頁字符 （標記），以便擷取剩餘的結果。  
預設：100  
限制條件：最小 20，最大 100。  
類型：整數  
必要：否

 ** SnapshotType **   
要傳回的叢集快照類型。您可以指定下列其中一個值：  
+  `automated` - 傳回 Amazon DocumentDB 為 自動建立的所有叢集快照 AWS 帳戶。
+  `manual` - 傳回您為 手動建立的所有叢集快照 AWS 帳戶。
+  `shared` - 傳回已與 共用的所有手動叢集快照 AWS 帳戶。
+  `public` - 傳回已標示為公有的所有叢集快照。
如果您未指定`SnapshotType`值，則會傳回自動和手動叢集快照。您可以將 `IncludeShared` 參數設定為 ，以包含共用叢集快照與這些結果`true`。您可以將 參數設定為 ，`IncludePublic`將公有叢集快照包含這些結果`true`。  
`IncludeShared` 和 `IncludePublic` 參數不適用於值為 `SnapshotType` 的 `manual` 或 `automated`。當 `SnapshotType` 設為 `shared` 時，不適用 `IncludePublic` 參數。當 `SnapshotType` 設為 `public` 時，不適用 `IncludeShared` 參數。  
類型：字串  
必要：否

## 回應元素
<a name="API_DescribeDBClusterSnapshots_ResponseElements"></a>

服務會傳回下列元素。

 **DBClusterSnapshots.DBClusterSnapshot.N**   
提供叢集快照的清單。  
類型：[DBClusterSnapshot](API_DBClusterSnapshot.md) 物件陣列

 ** Marker **   
前一個請求提供的選用分頁字符。若指定此參數，則回應只會包含超過標記的記錄，直到 `MaxRecords` 指定的值為止。  
類型：字串

## 錯誤
<a name="API_DescribeDBClusterSnapshots_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。

 ** DBClusterSnapshotNotFoundFault **   
 `DBClusterSnapshotIdentifier` 不會參考現有的叢集快照。  
HTTP 狀態碼：404

## 另請參閱
<a name="API_DescribeDBClusterSnapshots_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/DescribeDBClusterSnapshots) 
+  [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/DescribeDBClusterSnapshots) 
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DescribeDBClusterSnapshots) 
+  [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/DescribeDBClusterSnapshots) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DescribeDBClusterSnapshots) 
+  [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DescribeDBClusterSnapshots) 
+  [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/DescribeDBClusterSnapshots) 
+  [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/DescribeDBClusterSnapshots) 
+  [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/DescribeDBClusterSnapshots) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DescribeDBClusterSnapshots) 