기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# CopyDBClusterSnapshot
클러스터의 스냅샷을 복사합니다.
공유된 수동 클러스터 스냅샷에서 클러스터 스냅샷을 복사하려면 `SourceDBClusterSnapshotIdentifier`가 공유된 클러스터 스냅샷의 Amazon 리소스 이름(ARN)이어야 합니다. 동일한 AWS 리전에서는 암호화 여부와 관계없이 공유 DB 클러스터 스냅샷만 복사할 수 있습니다.
복사 작업이 진행 중일 때 이를 취소하려면 해당 클러스터 스냅샷이 *복사* 상태에 있는 동안 `TargetDBClusterSnapshotIdentifier`에 의해 식별된 대상 클러스터 스냅샷을 삭제합니다.
## 요청 파라미터
모든 작업에 공통되는 파라미터에 대한 내용은 [공통 파라미터](CommonParameters.md)를 참조하십시오.
** SourceDBClusterSnapshotIdentifier **
복사할 클러스터 스냅샷의 식별자입니다. 이 파라미터는 대소문자를 구분하지 않습니다.
제약 조건:
+ *사용 가능*한 상태에서 유효한 클러스터 스냅샷을 지정해야 합니다.
+ 소스 클러스터 스냅샷이 복사본 AWS 리전 과 동일한에 있는 경우 유효한 스냅샷 식별자를 지정합니다.
+ 소스 클러스터 스냅샷이 다른에 AWS 리전 있거나 다른 AWS 계정이 소유한 경우 스냅샷 ARN을 지정합니다.
예시: `my-cluster-snapshot1`
유형: 문자열
필수 항목 여부: 예
** TargetDBClusterSnapshotIdentifier **
소스 클러스터 스냅샷에서 생성할 새 클러스터 스냅샷의 식별자입니다. 이 파라미터는 대소문자를 구분하지 않습니다.
제약 조건:
+ 1\$163자의 문자, 숫자 또는 하이픈으로 구성되어야 합니다.
+ 첫 자는 문자여야 합니다.
+ 하이픈으로 끝나거나 하이픈이 2개 연속으로 포함되어서는 안 됩니다.
예시: `my-cluster-snapshot2`
유형: 문자열
필수 항목 여부: 예
** CopyTags **
원본 클러스터 스냅샷의 모든 태그를 대상 클러스터 스냅샷으로 복사하려면 `true`이고, 그렇지 않으면 `false`입니다. 기본값은 `false`입니다.
유형: 부울
필수 항목 여부: 아니요
** KmsKeyId **
암호화된 클러스터 스냅샷의 AWS KMS 키 ID입니다. 키 ID는 AWS KMS Amazon 리소스 이름(ARN), AWS KMS 키 식별자 또는 AWS KMS 암호화 AWS KMS 키의 키 별칭입니다.
에서 암호화된 클러스터 스냅샷을 복사 AWS 계정하는 경우의 값을 지정`KmsKeyId`하여 새 암호화 AWS KMS 키로 복사본을 암호화할 수 있습니다. 에 값을 지정하지 않으면 클러스터 스냅샷의 `KmsKeyId`사본이 소스 클러스터 스냅샷과 동일한 AWS KMS 키로 암호화됩니다.
다른에서 공유된 암호화된 클러스터 스냅샷을 복사 AWS 계정하는 경우에 대한 값을 지정해야 합니다`KmsKeyId`.
암호화된 클러스터 스냅샷을 다른에 복사하려면 대상 리전에서 클러스터 스냅샷의 사본을 암호화하는 데 사용할 AWS KMS 키 ID로 `KmsKeyId`를 AWS 리전설정합니다. AWS KMS 암호화 키는 생성된에 고유 AWS 리전 하며 한 AWS 리전 에서 다른 로 암호화 키를 사용할 수 없습니다 AWS 리전.
암호화되지 않은 클러스터 스냅샷의 복사하고 `KmsKeyId` 파라미터에 대한 값을 지정하려고 시도하면 오류가 반환됩니다.
유형: 문자열
필수 항목 여부: 아니요
** PreSignedUrl **
복사할 소스 클러스터 스냅샷이 포함된의 API 작업에 대한`CopyDBClusterSnapshot` 서명 버전 4 서명 요청이 AWS 리전 포함된 URL입니다. 다른 AWS 리전의 클러스터 스냅샷을 복사할 때는 이 `PreSignedUrl` 파라미터를 사용해야 합니다.
AWS SDK 도구 또는를 사용하는 경우 `PreSignedUrl` 수동으로 지정하는 대신를 지정할 수 있습니다`SourceRegion`(또는 `--source-region`의 AWS CLI경우 AWS CLI). `SourceRegion`을 지정하면 소스 AWS 리전에서 실행할 수 있는 작업에 대한 유효한 요청인 미리 서명된 URL이 자동으로 생성됩니다.
미리 서명된 URL은 복사할 클러스터 스냅샷이 포함된 소스에서 실행할 수 AWS 리전 있는 `CopyDBClusterSnapshot` API 작업에 대한 유효한 요청이어야 합니다. 미리 서명된 URL 요청은 다음 파라미터 값을 포함해야 합니다.
+ `SourceRegion`- 복사할 스냅샷이 포함된 지역의 ID.
+ `SourceDBClusterSnapshotIdentifier` – 복사할 암호화된 클러스터 스냅샷의 식별자입니다. 이 식별자는 소스 AWS 리전용 Amazon 리소스 이름(ARN) 형식이어야 합니다. 예를 들어, 암호화된 클러스터 스냅샷을 us-east-1 AWS 리전에서 복사하는 경우, `SourceDBClusterSnapshotIdentifier`는 다음과 같이 보입니다: `arn:aws:rds:us-east-1:12345678012:sample-cluster:sample-cluster-snapshot`.
+ `TargetDBClusterSnapshotIdentifier` – 생성할 새 클러스터 스냅샷의 식별자입니다. 이 파라미터는 대/소문자를 구분하지 않습니다.
유형: 문자열
필수 항목 여부: 아니요
**Tags.Tag.N**
새 클러스터 스냅샷에 할당할 태그입니다.
타입: [Tag](API_Tag.md)객체 배열
필수: 아니요
## 응답 요소
서비스에서 다음 요소를 반환합니다.
** DBClusterSnapshot **
클러스터 스냅샷에 대한 세부 정보입니다.
타입: [DBClusterSnapshot](API_DBClusterSnapshot.md) 객체
## 오류
모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.
** DBClusterSnapshotAlreadyExistsFault **
해당 식별자를 사용하는 클러스터 스냅샷이 이미 있습니다.
HTTP 상태 코드: 400
** DBClusterSnapshotNotFoundFault **
`DBClusterSnapshotIdentifier`은 기존 클러스터 스냅샷을 참조하지 않습니다.
HTTP 상태 코드: 404
** InvalidDBClusterSnapshotStateFault **
제공된 값은 유효한 클러스터 스냅샷 상태가 아닙니다.
HTTP 상태 코드: 400
** InvalidDBClusterStateFault **
클러스터가 유효한 상태가 아닙니다.
HTTP 상태 코드: 400
** KMSKeyNotAccessibleFault **
AWS KMS 키에 액세스할 때 오류가 발생했습니다.
HTTP 상태 코드: 400
** SnapshotQuotaExceeded **
요청으로 인해 허용된 스냅샷 수를 초과하게 됩니다.
HTTP 상태 코드: 400
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/CopyDBClusterSnapshot)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/CopyDBClusterSnapshot)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/CopyDBClusterSnapshot)
+ [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/CopyDBClusterSnapshot)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/CopyDBClusterSnapshot)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/CopyDBClusterSnapshot)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/CopyDBClusterSnapshot)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/CopyDBClusterSnapshot)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/CopyDBClusterSnapshot)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/CopyDBClusterSnapshot)