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

# CopySnapshot
<a name="API_CopySnapshot"></a>

기존 스냅샷을 복사합니다.

## 구문 요청
<a name="API_CopySnapshot_RequestSyntax"></a>

```
{
   "KmsKeyId": "string",
   "SourceSnapshotName": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TargetBucket": "string",
   "TargetSnapshotName": "string"
}
```

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

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

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

 ** [KmsKeyId](#API_CopySnapshot_RequestSyntax) **   <a name="MemoryDB-CopySnapshot-request-KmsKeyId"></a>
대상 스냅샷을 암호화하는 데 사용되는 KMS 키의 ID입니다.  
유형: 문자열  
길이 제약: 최대 길이 2048.  
필수 여부: 아니요

 ** [SourceSnapshotName](#API_CopySnapshot_RequestSyntax) **   <a name="MemoryDB-CopySnapshot-request-SourceSnapshotName"></a>
복사본을 만들 기존 스냅샷의 이름입니다.  
유형: 문자열  
필수 항목 여부: 예

 ** [Tags](#API_CopySnapshot_RequestSyntax) **   <a name="MemoryDB-CopySnapshot-request-Tags"></a>
이 리소스에 추가할 태그 목록입니다. 태그는 키-값 쌍입니다. 태그 키에는 태그 값이 동반되어야 하지만 null은 허용됩니다.  
타입: [Tag](API_Tag.md)객체 배열  
배열 멤버: 최대 항목 수는 200개입니다.  
필수 여부: 아니요

 ** [TargetBucket](#API_CopySnapshot_RequestSyntax) **   <a name="MemoryDB-CopySnapshot-request-TargetBucket"></a>
스냅샷을 내보낼 Amazon S3 버킷입니다. 이 파라미터는 외부 액세스를 위해 스냅샷을 내보낼 때만 사용됩니다. 이 파라미터를 사용하여 스냅샷을 내보낼 때는 MemoryDB에 이 S3 버킷에 필요한 권한이 있는지 확인하십시오. 자세한 내용은 [2단계: Amazon S3 버킷에 MemoryDB 액세스 권한 부여](https://docs.aws.amazon.com/MemoryDB/latest/devguide/snapshots-exporting.html)를 참조하세요.  
유형: 문자열  
길이 제약: 최대 길이는 255입니다.  
패턴: `^[A-Za-z0-9._-]+$`   
필수 여부: 아니요

 ** [TargetSnapshotName](#API_CopySnapshot_RequestSyntax) **   <a name="MemoryDB-CopySnapshot-request-TargetSnapshotName"></a>
스냅샷 복사의 이름입니다. MemoryDB는 스냅샷 덮어쓰기를 허용하지 않으므로 이 이름은 해당 컨텍스트(내보낼 경우 MemoryDB 또는 Amazon S3 버킷) 내에서 고유해야 합니다. 이 값은 소문자 문자열로 저장됩니다.  
유형: 문자열  
필수 항목 여부: 예

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

```
{
   "Snapshot": { 
      "ARN": "string",
      "ClusterConfiguration": { 
         "Description": "string",
         "Engine": "string",
         "EngineVersion": "string",
         "MaintenanceWindow": "string",
         "MultiRegionClusterName": "string",
         "MultiRegionParameterGroupName": "string",
         "Name": "string",
         "NodeType": "string",
         "NumShards": number,
         "ParameterGroupName": "string",
         "Port": number,
         "Shards": [ 
            { 
               "Configuration": { 
                  "ReplicaCount": number,
                  "Slots": "string"
               },
               "Name": "string",
               "Size": "string",
               "SnapshotCreationTime": number
            }
         ],
         "SnapshotRetentionLimit": number,
         "SnapshotWindow": "string",
         "SubnetGroupName": "string",
         "TopicArn": "string",
         "VpcId": "string"
      },
      "DataTiering": "string",
      "KmsKeyId": "string",
      "Name": "string",
      "Source": "string",
      "Status": "string"
   }
}
```

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

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

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

 ** [Snapshot](#API_CopySnapshot_ResponseSyntax) **   <a name="MemoryDB-CopySnapshot-response-Snapshot"></a>
스냅샷이 생성된 시점을 기준으로 전체 클러스터의 사본을 나타냅니다.  
타입: [Snapshot](API_Snapshot.md) 객체

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

모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterCombinationException **   
  
HTTP 상태 코드: 400

 ** InvalidParameterValueException **   
  
HTTP 상태 코드: 400

 ** InvalidSnapshotStateFault **   
  
HTTP 상태 코드: 400

 ** ServiceLinkedRoleNotFoundFault **   
  
HTTP 상태 코드: 400

 ** SnapshotAlreadyExistsFault **   
  
HTTP 상태 코드: 400

 ** SnapshotNotFoundFault **   
  
HTTP 상태 코드: 400

 ** SnapshotQuotaExceededFault **   
  
HTTP 상태 코드: 400

 ** TagQuotaPerResourceExceeded **   
  
HTTP 상태 코드: 400

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

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