기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
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
-
CopyDBClusterSnapshot
API 작업에 대한 서명 버전 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를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.