CopyDBClusterSnapshot

클러스터의 스냅샷을 복사합니다.

공유된 수동 클러스터 스냅샷에서 클러스터 스냅샷을 복사하려면 SourceDBClusterSnapshotIdentifier가 공유된 클러스터 스냅샷의 Amazon 리소스 이름(ARN)이어야 합니다. 동일한 AWS 리전에서는 암호화 여부와 관계없이 공유 DB 클러스터 스냅샷만 복사할 수 있습니다.

복사 작업이 진행 중일 때 이를 취소하려면 해당 클러스터 스냅샷이 복사 상태에 있는 동안 TargetDBClusterSnapshotIdentifier에 의해 식별된 대상 클러스터 스냅샷을 삭제합니다.

요청 파라미터

모든 작업에서 사용하는 파라미터에 대한 자세한 내용은 범용 파라미터를 참조하세요.

SourceDBClusterSnapshotIdentifier

복사할 클러스터 스냅샷의 식별자입니다. 이 파라미터는 대소문자를 구분하지 않습니다.

제약 조건:

• 사용 가능한 상태에서 유효한 시스템 스냅샷을 지정해야 합니다.

• 원본 스냅샷이 AWS 리전 사본과 동일한 경우 유효한 스냅샷 식별자를 지정하십시오.

• 원본 스냅샷이 복사본과 AWS 리전 다른 경우 유효한 클러스터 스냅샷 ARN을 지정하십시오.

예제: my-cluster-snapshot1

타입: 문자열

필수 항목 여부: 예

TargetDBClusterSnapshotIdentifier

소스 클러스터 스냅샷에서 생성할 새 클러스터 스냅샷의 식별자입니다. 이 파라미터는 대소문자를 구분하지 않습니다.

제약 조건:

• 1~63자의 문자, 숫자 또는 하이픈으로 구성되어야 합니다.

• 첫 자는 문자여야 합니다.

• 하이픈으로 끝나거나 하이픈이 2개 연속으로 이어져서는 안 됩니다.

예제: my-cluster-snapshot2

타입: 문자열

필수 항목 여부: 예

CopyTags

원본 클러스터 스냅샷의 모든 태그를 대상 클러스터 스냅샷으로 복사하려면 true이고, 그렇지 않으면 false입니다. 기본값은 false입니다.

타입: 부울

필수 항목 여부: 아니요

KmsKeyId

암호화된 클러스터 스냅샷의 AWS KMS 키 ID입니다. AWS KMS 키 ID는 Amazon 리소스 이름 (ARN), AWS KMS 키 식별자 또는 암호화 AWS KMS 키의 키 별칭입니다. AWS KMS

에서 암호화된 클러스터 스냅샷을 KmsKeyId 복사하는 경우 새 AWS KMS 암호화 키로 사본을 암호화할 값을 지정할 수 있습니다. AWS 계정값을 지정하지 않으면 클러스터 스냅샷의 사본이 원본 클러스터 스냅샷과 동일한 AWS KMS 키로 암호화됩니다. KmsKeyId

다른 AWS 계정사람과 공유된 암호화된 클러스터 스냅샷을 복사하는 경우 값을 지정해야 합니다KmsKeyId.

암호화된 클러스터 스냅샷을 다른 AWS 리전KmsKeyId 스냅샷으로 복사하려면 대상 지역의 클러스터 스냅샷 사본을 암호화하는 데 사용할 AWS KMS 키 ID를 설정하십시오. AWS KMS 암호화 키는 생성된 키에 따라 AWS 리전 다르며, 암호화 키는 다른 AWS 리전 AWS 리전키에 사용할 수 없습니다.

암호화되지 않은 클러스터 스냅샷의 복사하고 KmsKeyId 파라미터에 대한 값을 지정하려고 시도하면 오류가 반환됩니다.

타입: 문자열

필수사항: 아니요

PreSignedUrl

CopyDBClusterSnapshotAPI 작업에 대한 서명 버전 4 서명 요청이 포함된 URL입니다. 이 URL에는 복사할 소스 클러스터 스냅샷이 포함되어 있습니다. AWS 리전 다른 AWS 리전의 클러스터 스냅샷을 복사할 때는 이 PreSignedUrl 파라미터를 사용해야 합니다.

AWS SDK 도구 또는 를 사용하는 경우 PreSignedUrl 수동으로 지정하는 대신 지정 SourceRegion (또는 --source-region AWS CLI) 할 수 있습니다. AWS CLISourceRegion을 지정하면 소스 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객체 배열

필수: 아니요

Response Elements

서비스에서 반환되는 요소는 다음과 같습니다.

DBClusterSnapshot

클러스터 스냅샷에 대한 세부 정보입니다.

유형: DBClusterSnapshot객체

Errors

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하세요.

DBClusterSnapshotAlreadyExistsFault

해당 식별자를 사용하는 클러스터 스냅샷이 이미 있습니다.

HTTP 상태 코드: 400

DBClusterSnapshotNotFoundFault

DBClusterSnapshotIdentifier는 기존 클러스터 스냅샷을 참조하지 않습니다.

HTTP 상태 코드: 404

InvalidDBClusterSnapshotStateFault

제공된 값은 유효한 클러스터 스냅샷 상태가 아닙니다.

HTTP 상태 코드: 400

InvalidDBClusterStateFault

클러스터가 유효한 상태가 아닙니다.

HTTP 상태 코드: 400

KMSKeyNotAccessibleFault

AWS KMS 키에 액세스할 때 오류가 발생했습니다.

HTTP 상태 코드: 400

SnapshotQuotaExceeded

요청으로 인해 허용된 스냅샷 수를 초과하게 됩니다.

HTTP 상태 코드: 400

참고

언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.

• AWS Command Line Interface

• AWS SDK for .NET

• AWS SDK for C++

• AWS Go v2를 위한 SDK

• AWS Java V2용 SDK

• AWS V3용 SDK JavaScript

• AWS PHP V3용 SDK

• AWS Python용 SDK

• AWS 루비 V3용 SDK