기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# CopyClusterSnapshot
<a name="API_elastic_CopyClusterSnapshot"></a>

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

## Request Syntax
<a name="API_elastic_CopyClusterSnapshot_RequestSyntax"></a>

```
POST /cluster-snapshot/snapshotArn/copy HTTP/1.1
Content-type: application/json

{
   "copyTags": boolean,
   "kmsKeyId": "string",
   "tags": { 
      "string" : "string" 
   },
   "targetSnapshotName": "string"
}
```

## URI 요청 파라미터
<a name="API_elastic_CopyClusterSnapshot_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [snapshotArn](#API_elastic_CopyClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-request-uri-snapshotArn"></a>
탄력적 클러스터 스냅샷의 Amazon 리소스 이름(ARN) 식별자.  
필수 항목 여부: 예

## 요청 본문
<a name="API_elastic_CopyClusterSnapshot_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [targetSnapshotName](#API_elastic_CopyClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-request-targetSnapshotName"></a>
소스 클러스터 스냅샷에서 생성할 새 탄력적 클러스터 스냅샷의 식별자입니다. 이 파라미터는 대소문자를 구분하지 않습니다.  
제약 조건:  
+ 1\$163자의 문자, 숫자 또는 하이픈으로 구성되어야 합니다.
+ 첫 자는 문자여야 합니다.
+ 하이픈으로 끝나거나 하이픈이 2개 연속으로 포함되어서는 안 됩니다.
예시: `elastic-cluster-snapshot-5`   
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이 63.  
필수 항목 여부: 예

 ** [copyTags](#API_elastic_CopyClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-request-copyTags"></a>
원본 클러스터 스냅샷의 모든 태그를 대상 탄력적 클러스터 스냅샷으로 복사하려면 `true`로 설정합니다. 기본값은 `false`입니다.  
유형: 부울  
필수 항목 여부: 아니요

 ** [kmsKeyId](#API_elastic_CopyClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-request-kmsKeyId"></a>
암호화된 탄력적 클러스터 스냅샷의 AWS KMS 키 ID입니다. AWS KMS 키 ID는 Amazon 리소스 이름(ARN), AWS KMS 키 식별자 또는 AWS KMS 암호화 키의 AWS KMS 키 별칭입니다.  
 AWS 계정에서 암호화된 탄력적 클러스터 스냅샷을 복사하는 경우의 값을 지정`KmsKeyId`하여 새 AWS S KMS 암호화 키로 복사본을 암호화할 수 있습니다. `KmsKeyId` 값을 지정하지 않으면 탄력적 클러스터 스냅샷의 사본을 원본 탄력적 스냅샷과 동일한 `AWS` KMS 키로 암호화합니다.  
암호화되지 않은 탄력적 클러스터 스냅샷의 복사하고 `KmsKeyId` 파라미터에 대한 값을 지정하려고 시도하면 오류가 반환됩니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [tags](#API_elastic_CopyClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-request-tags"></a>
탄력적 클러스터 스냅샷에 할당할 태그입니다.  
유형: 문자열 간 맵  
키 길이 제약 조건: 최소 길이는 1. 최대 길이 128.  
키 패턴: `(?!aws:)[a-zA-Z+-=._:/]+`   
값 길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 256입니다.  
필수 여부: 아니요

## 응답 구문
<a name="API_elastic_CopyClusterSnapshot_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "snapshot": { 
      "adminUserName": "string",
      "clusterArn": "string",
      "clusterCreationTime": "string",
      "kmsKeyId": "string",
      "snapshotArn": "string",
      "snapshotCreationTime": "string",
      "snapshotName": "string",
      "snapshotType": "string",
      "status": "string",
      "subnetIds": [ "string" ],
      "vpcSecurityGroupIds": [ "string" ]
   }
}
```

## 응답 요소
<a name="API_elastic_CopyClusterSnapshot_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [snapshot](#API_elastic_CopyClusterSnapshot_ResponseSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-response-snapshot"></a>
특정 탄력적 클러스터 스냅샷에 대한 정보를 반환합니다.  
타입: [ClusterSnapshot](API_elastic_ClusterSnapshot.md) 객체

## 오류
<a name="API_elastic_CopyClusterSnapshot_Errors"></a>

모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하십시오.

 ** AccessDeniedException **   
작업을 수행할 권한이 충분하지 않을 때 발생하는 예외.    
 ** message **   
액세스가 거부된 이유를 설명하는 오류 메시지입니다.
HTTP 상태 코드: 403

 ** ConflictException **   
액세스 충돌이 발생했습니다.    
 ** resourceId **   
액세스 충돌이 발생한 리소스의 ID입니다.  
 ** resourceType **   
액세스 충돌이 발생한 리소스의 유형입니다.
HTTP 상태 코드: 409

 ** InternalServerException **   
내부 서버 오류가 발생했습니다.  
HTTP 상태 코드: 500

 ** ResourceNotFoundException **   
지정된 리소스를 찾을 수 없습니다.    
 ** message **   
실패를 설명하는 오류 메시지입니다.  
 ** resourceId **   
찾을 수 없는 리소스의 ID입니다.  
 ** resourceType **   
찾을 수 없는 리소스 유형입니다.
HTTP 상태 코드: 404

 ** ServiceQuotaExceededException **   
작업에 대한 서비스 할당량을 초과했습니다.  
HTTP 상태 코드: 402

 ** ThrottlingException **   
요청 조절로 인해 요청이 거부되면 ThrottlingException이 발생합니다.    
 ** retryAfterSeconds **   
작업을 재시도하기 전에 대기하는 시간(초)입니다.
HTTP 상태 코드: 429

 ** ValidationException **   
유효성 검사 예외를 정의하는 구조.    
 ** fieldList **   
유효성 검사 예외가 발생한 필드의 목록입니다.  
 ** message **   
유효성 검사 예외를 설명하는 오류 메시지입니다.  
 ** reason **   
검증 예외가 발생한 이유입니다(`unknownOperation`, `cannotParse`, `fieldValidationFailed` 또는 `other` 중 하나).
HTTP 상태 코드: 400

## 참고
<a name="API_elastic_CopyClusterSnapshot_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/CopyClusterSnapshot)