本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 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)。 * EFS *
**注意**  
建立檔案系統後，您無法變更 KMS 金鑰或效能模式。
+ 如果您想要複寫到與來源檔案系統位於相同帳戶中的現有檔案系統，則需要提供要複寫的檔案系統的 ID 或 Amazon Resource Name (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 會使用預設 KMS 金鑰 `/aws/elasticfilesystem` 為 Amazon EFS 的提供服務。此 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>
來源帳戶中 IAM 角色的 Amazon Resource Name (ARN)，允許 Amazon EFS 代其執行複寫。這是相同帳戶複寫的選用項目，跨帳戶複寫則為必要項目。  
類型：字串  
長度限制：長度上限為 2048。  
模式：`arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`  
必要：否

## 另請參閱
<a name="API_DestinationToCreate_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DestinationToCreate) 
+  [AWS 適用於 Java V2 的開發套件](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DestinationToCreate) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DestinationToCreate)