本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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

描述复制配置的新或现有的目标文件系统。
+ 如果要复制到新的文件系统，请不要为目标文件系统指定文件系统 ID。Amazon EFS 将创建新的空文件系统。对于单区存储，指定要在其中创建文件系统的可用区。要使用默认 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>
要创建使用单区存储的文件系统，请指定要在其中创建目标文件系统的可用区的名称。  
类型：字符串  
长度限制：长度下限为 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 的默认 KMS 密钥 `/aws/elasticfilesystem`。此 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)