CopyDBClusterSnapshot
클러스터의 스냅샷을 복사합니다.
공유된 수동 클러스터 스냅샷에서 클러스터 스냅샷을 복사하려면 SourceDBClusterSnapshotIdentifier가 공유된 클러스터 스냅샷의 Amazon 리소스 이름(ARN)이어야 합니다. 동일한 AWS 리전에서는 암호화 여부와 관계없이 공유 DB 클러스터 스냅샷만 복사할 수 있습니다.
복사 작업이 진행 중일 때 이를 취소하려면 해당 클러스터 스냅샷이 복사 상태에 있는 동안 TargetDBClusterSnapshotIdentifier에 의해 식별된 대상 클러스터 스냅샷을 삭제합니다.
요청 파라미터
모든 작업에 공통되는 파라미터에 관한 정보는 범용 파라미터를 참조하십시오.
- SourceDBClusterSnapshotIdentifier
-
복사할 클러스터 스냅샷의 식별자입니다. 이 파라미터는 대소문자를 구분하지 않습니다.
제약 조건:
-
사용 가능한 상태에서 유효한 클러스터 스냅샷을 지정해야 합니다.
-
소스 클러스터 스냅샷이 사본과 동일한 AWS 리전에 있는 경우 유효한 스냅샷 식별자를 지정합니다.
-
소스 클러스터 스냅샷이 다른 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 키 별칭입니다.
AWS 계정에서 암호화된 클러스터 스냅샷을 복사하는 경우,
KmsKeyId값을 지정하여 새 AWS KMS 암호화 키로 사본을 암호화할 수 있습니다.KmsKeyId값을 지정하지 않으면 클러스터 스냅샷의 사본을 원본 스냅샷과 동일한 AWS KMS 키로 암호화합니다.다른 AWS 계정에서 공유한 암호화된 클러스터 스냅샷을 복사하는 경우,
KmsKeyId값을 지정해야 합니다.암호화된 클러스터 스냅샷을 다른 AWS 리전에 복사하려면 대상 리전에서 클러스터 스냅샷의 사본을 암호화하는 데 사용할 AWS KMS 키 ID를
KmsKeyId로 설정합니다. AWS KMS 암호화 키는 해당 키를 만든 AWS 리전에 고유하며, 한 AWS 리전의 암호화 키를 다른 AWS 리전에서 사용할 수는 없습니다.암호화되지 않은 클러스터 스냅샷의 복사하고
KmsKeyId파라미터에 대한 값을 지정하려고 시도하면 오류가 반환됩니다.유형: 문자열
필수 여부: 아니요
- PreSignedUrl
-
복사할 원본 클러스터 스냅샷이 위치하는 AWS 리전에서
CopyDBClusterSnapshotAPI 작업에 대한 서명 버전 4 서명된 요청이 포함된 URL입니다. 다른 AWS 리전의 클러스터 스냅샷을 복사할 때는 이PreSignedUrl파라미터를 사용해야 합니다.AWSSDK 도구 또는 를 사용하는 경우
PreSignedUrl수동으로 지정하는 대신 지정SourceRegion(또는--source-regionAWS CLI) 할 수 있습니다. AWS CLISourceRegion을 지정하면 소스 AWS 리전에서 실행할 수 있는 작업에 대한 유효한 요청인 미리 서명된 URL이 자동으로 생성됩니다.미리 서명된 URL은 복사할 클러스터 스냅샷이 위치하는 원본 AWS 리전에서 실행할 수 있는
CopyDBClusterSnapshotAPI 작업에 대한 유효한 요청이어야 합니다. 미리 서명된 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객체 배열
필수 여부: 아니요
응답 요소
서비스에서 다음 요소를 반환합니다.
- DBClusterSnapshot
-
클러스터 스냅샷에 대한 세부 정보입니다.
타입: DBClusterSnapshot 객체
오류
모든 작업에 공통되는 오류에 대한 내용은 일반적인 오류 섹션을 참조하세요.
- DBClusterSnapshotAlreadyExistsFault
-
해당 식별자를 사용하는 클러스터 스냅샷이 이미 있습니다.
HTTP 상태 코드: 400
- DBClusterSnapshotNotFoundFault
-
DBClusterSnapshotIdentifier은 기존 클러스터 스냅샷을 참조하지 않습니다.HTTP 상태 코드: 404
- InvalidDBClusterSnapshotStateFault
-
제공된 값은 유효한 클러스터 스냅샷 상태가 아닙니다.
HTTP 상태 코드: 400
- InvalidDBClusterStateFault
-
클러스터가 유효한 상태가 아닙니다.
HTTP 상태 코드: 400
- KMSKeyNotAccessibleFault
-
AWS KMS 키에 액세스할 때 오류가 발생했습니다.
HTTP 상태 코드: 400
- SnapshotQuotaExceeded
-
요청으로 인해 허용된 스냅샷 수를 초과하게 됩니다.
HTTP 상태 코드: 400
참고
언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.