기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# DescribeDBClusterSnapshots
클러스터 스냅샷에 대한 정보를 반환합니다. API 작업은 페이지 매김을 지원합니다.
## 요청 파라미터
모든 작업에 공통되는 파라미터에 대한 내용은 [공통 파라미터](CommonParameters.md)를 참조하십시오.
** DBClusterIdentifier **
클러스터 스냅샷의 목록을 검색할 클러스터의 ID. 이 파라미터는 `DBClusterSnapshotIdentifier` 파라미터와 함께 사용할 수 없습니다. 이 파라미터는 대소문자를 구분하지 않습니다.
제약 조건:
+ 제공된 경우 기존 `DBCluster`의 식별자와 일치해야 합니다.
유형: 문자열
필수 항목 여부: 아니요
** DBClusterSnapshotIdentifier **
설명할 특정 클러스터 스냅샷 식별자. 이 파라미터는 `DBClusterIdentifier` 파라미터와 함께 사용할 수 없습니다. 이 값은 소문자 문자열로 저장됩니다.
제약 조건:
+ 제공된 경우 기존 `DBClusterSnapshot`의 식별자와 일치해야 합니다.
+ 이 식별자가 자동화된 스냅샷의 식별자인 경우, `SnapshotType` 파라미터도 지정해야 합니다.
유형: 문자열
필수 항목 여부: 아니요
**Filters.Filter.N**
현재 지원되지 않는 파라미터입니다.
타입: [Filter](API_Filter.md)객체 배열
필수: 아니요
** IncludePublic **
퍼블릭인 수동 클러스터 스냅샷을 포함`true`하려면를 로 설정하고 AWS 계정, 그렇지 않으면에서 복사하거나 복원할 수 있습니다`false`. 기본값은 `false`입니다.
유형: 부울
필수 항목 여부: 아니요
** IncludeShared **
복사 또는 복원 권한이 AWS 계정 부여된 다른의 공유 수동 클러스터 스냅샷 AWS 계정 을 포함`true`하려면 로 설정하고, 그렇지 않으면 로 설정합니다`false`. 기본값은 `false`입니다.
유형: 부울
필수 항목 여부: 아니요
** Marker **
이전의 요청에서 제공된 선택적 페이지 매김 토큰입니다. 이 파라미터를 지정한 경우, 마커 이후부터 `MaxRecords`에 지정된 값까지의 레코드만 응답에 포함됩니다.
유형: 문자열
필수 항목 여부: 아니요
** MaxRecords **
응답에 포함되는 최대 레코드 수입니다. 지정된 `MaxRecords` 값보다 레코드 수가 많으면 페이지 매김 토큰(마커)을 응답에 포함시켜 나머지 결과를 검색할 수 있도록 합니다.
기본값: 100
제약: 최소 20, 최대 100입니다.
유형: 정수
필수 항목 여부: 아니요
** SnapshotType **
반환되는 클러스터 스냅샷의 유형. 다음 값 중 하나를 지정할 수 있습니다.
+ `automated` - Amazon DocumentDB가 AWS 계정를 위해 자동으로 생성한 모든 클러스터 스냅샷을 반환합니다.
+ `manual` - AWS 계정를 위해 수동으로 생성한 모든 클러스터 스냅샷을 반환합니다.
+ `shared` - AWS 계정에 공유된 모든 수동 클러스터 스냅샷을 반환합니다.
+ `public` - 퍼블릭으로 표시된 클러스터 스냅샷을 모두 반환합니다.
`SnapshotType` 값을 지정하지 않으면 자동 및 수동 클러스터 스냅샷이 모두 반환됩니다. `IncludeShared` 파라미터를 `true`로 설정하여 이러한 결과에 공유 클러스터 스냅샷을 포함시킬 수 있습니다. `IncludePublic` 파라미터를 `true`로 설정하여 이러한 결과에 퍼블릭 클러스터 스냅샷을 포함시킬 수 있습니다.
`SnapshotType` 값이 `manual` 또는 `automated`인 경우 `IncludeShared` 및 `IncludePublic` 파라미터는 적용되지 않습니다. `SnapshotType`이 `shared`로 설정된 경우 `IncludePublic` 파라미터는 적용되지 않습니다. `SnapshotType`이 `public`로 설정된 경우 `IncludeShared` 파라미터는 적용되지 않습니다.
유형: 문자열
필수 항목 여부: 아니요
## 응답 요소
서비스에서 반환되는 요소는 다음과 같습니다.
**DBClusterSnapshots.DBClusterSnapshot.N**
클러스터 스냅샷의 목록을 제공합니다.
타입: [DBClusterSnapshot](API_DBClusterSnapshot.md)객체 배열
** Marker **
이전의 요청에서 제공된 선택적 페이지 매김 토큰입니다. 이 파라미터를 지정한 경우, 마커 이후부터 `MaxRecords`에 지정된 값까지의 레코드만 응답에 포함됩니다.
유형: 문자열
## 오류
모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하십시오.
** DBClusterSnapshotNotFoundFault **
`DBClusterSnapshotIdentifier`은 기존 클러스터 스냅샷을 참조하지 않습니다.
HTTP 상태 코드: 404
## 참고
언어별 AWS SDKs
+ [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 SDK for C\$1\$1](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DescribeDBClusterSnapshots)
+ [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DescribeDBClusterSnapshots)