

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

# DestinationToCreate
<a name="API_DestinationToCreate"></a>

복제 구성의 새로운 또는 기존 대상 파일 시스템을 설명합니다.
+ 새 파일 시스템으로 복제하려면 대상 파일 시스템의 File System ID를 지정하지 마세요. Amazon EFS는 새롭고 빈 파일 시스템을 생성합니다. One Zone 스토리지를 위해 파일 시스템을 생성할 가용 영역을 지정합니다. 기본 KMS 키 이외의 AWS Key Management Service 키를 사용하려면 지정합니다. 자세한 내용은 *Amazon EFS 사용 설명서*의 [새 Amazon EFS 파일 시스템으로 복제 구성](https://docs.aws.amazon.com/efs/latest/ug/create-replication.html)을 참조하세요.
**참고**  
파일 시스템 생성 후에는 KMS 키나 성능 모드를 변경할 수 없습니다.
+ 소스 파일 시스템과 동일한 계정에 있는 기존 파일 시스템으로 복제하려면, 복제 대상 파일 시스템의 ID 또는 Amazon 리소스 이름(ARN)을 제공해야 합니다. 파일 시스템의 복제 덮어쓰기 보호 기능을 비활성화해야 합니다. 자세한 내용은 *Amazon EFS 사용 설명서*의 [기존 파일 시스템에 복제](https://docs.aws.amazon.com/efs/latest/ug/efs-replication#replicate-existing-destination)를 참조하세요.
+ 파일 시스템을 소스 파일 시스템과 다른 계정에 있는 파일 시스템으로 복제하는 경우(교차 계정 복제) 파일 시스템의 ARN과 Amazon EFS가 대상 계정에서 복제를 수행할 수 있도록 허용하는 IAM 역할을 제공해야 합니다. 파일 시스템의 복제 덮어쓰기 보호 기능을 비활성화해야 합니다. 자세한 내용을 알아보려면 *Amazon EFS 사용 설명서*의 [AWS 계정 간 복제](https://docs.aws.amazon.com/efs/latest/ug/cross-account-replication.html)를 참조하세요.

## 내용
<a name="API_DestinationToCreate_Contents"></a>

 ** AvailabilityZoneName **   <a name="efs-Type-DestinationToCreate-AvailabilityZoneName"></a>
One Zone 스토리지를 사용하는 파일 시스템을 생성하려면 대상 파일 시스템을 생성할 가용 영역 이름을 지정합니다.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
패턴: `.+`   
필수 여부: 아니요

 ** FileSystemId **   <a name="efs-Type-DestinationToCreate-FileSystemId"></a>
대상에 사용할 파일 시스템의 ID 또는 ARN입니다. 교차 계정 복제의 경우 ARN이어야 합니다. 파일 시스템의 복제 덮어쓰기 보호를 비활성화해야 합니다. ID 또는 ARN을 지정하지 않으면 새 파일 시스템이 생성됩니다.  
기존 파일 시스템에 대한 복제를 처음 구성할 때 Amazon EFS는 원본 파일 시스템의 데이터와 일치하도록 대상 파일 시스템에 데이터를 쓰거나 대상 파일 시스템에서 기존 데이터를 제거합니다. 대상 파일 시스템의 데이터를 변경하지 않으려면 대신 새 파일 시스템에 복제해야 합니다. 자세한 내용은 [https://docs.aws.amazon.com/efs/latest/ug/create-replication.html](https://docs.aws.amazon.com/efs/latest/ug/create-replication.html) 섹션을 참조하세요.
유형: 문자열  
길이 제약: 최대 길이는 128입니다.  
패턴: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`   
필수 여부: 아니요

 ** KmsKeyId **   <a name="efs-Type-DestinationToCreate-KmsKeyId"></a>
대상 파일 시스템을 암호화하는 데 사용할 AWS Key Management Service(AWS KMS) 키를 지정합니다. KMS 키를 지정하지 않으면 Amazon EFS에서는 Amazon EFS, `/aws/elasticfilesystem`의 기본 KMS 키를 사용합니다. 이 ID는 다음 형식 중 하나에 해당할 수 있습니다.  
+ 키 ID - 키의 고유 식별자입니다(예: `1234abcd-12ab-34cd-56ef-1234567890ab`).
+ ARN - 키의 ARN입니다. 예: `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
+ 키 별칭 - 키에 대해 이전에 생성된 표시 이름입니다(예: `alias/projectKey1`).
+ 키 별칭 ARN - 키 별칭의 ARN입니다(예: `arn:aws:kms:us-west-2:444455556666:alias/projectKey1`).
유형: 문자열  
길이 제약: 최대 길이 2048.  
패턴: `^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|mrk-[0-9a-f]{32}|alias/[a-zA-Z0-9/_-]+|(arn:aws[-a-z]*:kms:[a-z0-9-]+:\d{12}:((key/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})|(key/mrk-[0-9a-f]{32})|(alias/[a-zA-Z0-9/_-]+))))$`   
필수 여부: 아니요

 ** Region **   <a name="efs-Type-DestinationToCreate-Region"></a>
리전 스토리지를 사용하는 파일 시스템을 생성하려면 대상 파일 시스템을 생성할 AWS 리전을 지정하세요. 소스 파일 시스템을 소유한 AWS 계정에 대해 리전을 활성화해야 합니다. 자세한 내용은 * AWS 일반 참조 안내서*의 [AWS 리전 관리](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable) 섹션을 참조하십시오.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
패턴: `^[a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-{0,1}[0-9]{0,1}$`   
필수 여부: 아니요

 ** RoleArn **   <a name="efs-Type-DestinationToCreate-RoleArn"></a>
Amazon EFS가 대신 복제를 수행할 수 있도록 허용하는 소스 계정의 IAM 역할의 Amazon 리소스 이름(ARN)입니다. 이는 동일한 계정 복제의 경우 선택 사항이고 교차 계정 복제에는 필요합니다.  
유형: 문자열  
길이 제약: 최대 길이 2048.  
패턴: `arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`   
필수 여부: 아니요

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

언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DestinationToCreate) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DestinationToCreate) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DestinationToCreate) 