本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # CreateReplicationConfiguration 建立複寫組態至新的或現有的 EFS 檔案系統。如需詳細資訊，請參閱《Amazon EFS 使用者指南》**中的 [Amazon EFS 複寫](https://docs.aws.amazon.com/efs/latest/ug/efs-replication.html)。複寫組態指定以下内容： + **來源檔案系統** – 您要複寫的 EFS 檔案系統。 + **目的地檔案系統** – 來源檔案系統複寫的目標檔案系統。在複寫組態中只能作爲目的地檔案系統。 **注意** 檔案系統只是複寫組態的一部分。 複寫組態的目的地參數取決於您是複寫到新的檔案系統還是現有的檔案系統，以及是否複寫 AWS 帳戶。如需詳細資訊，請參閱[DestinationToCreate](API_DestinationToCreate.md)。 這項操作需要 `elasticfilesystem:CreateReplicationConfiguration` 動作的許可。此外，根據您複寫檔案系統的方式，還需要其他許可。如需詳細資訊，請參閱《*Amazon EFS 使用者指南*》中的[複寫的必要許可](https://docs.aws.amazon.com/efs/latest/ug/efs-replication.html#efs-replication-permissions)。 ## 請求語法 ``` POST /2015-02-01/file-systems/SourceFileSystemId/replication-configuration HTTP/1.1 Content-type: application/json { "Destinations": [ { "AvailabilityZoneName": "string", "FileSystemId": "string", "KmsKeyId": "string", "Region": "string", "RoleArn": "string" } ] } ``` ## URI 請求參數 請求會使用下列 URI 參數。 ** [SourceFileSystemId](#API_CreateReplicationConfiguration_RequestSyntax) ** 指定您要複寫的 Amazon EFS 檔案系統。在另一個複寫組態中，此檔案系統已不能成爲來源或目的地檔案系統。 長度限制：長度上限為 128。 模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` 必要：是 ## 請求主體 請求接受採用 JSON 格式的下列資料。 ** [Destinations](#API_CreateReplicationConfiguration_RequestSyntax) ** 目的地組態物件陣列。僅支援一個目的地組態物件。 類型：[DestinationToCreate](API_DestinationToCreate.md) 物件陣列 必要：是 ## 回應語法 ``` HTTP/1.1 200 Content-type: application/json { "CreationTime": number, "Destinations": [ { "FileSystemId": "string", "LastReplicatedTimestamp": number, "OwnerId": "string", "Region": "string", "RoleArn": "string", "Status": "string", "StatusMessage": "string" } ], "OriginalSourceFileSystemArn": "string", "SourceFileSystemArn": "string", "SourceFileSystemId": "string", "SourceFileSystemOwnerId": "string", "SourceFileSystemRegion": "string" } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [CreationTime](#API_CreateReplicationConfiguration_ResponseSyntax) ** 說明建立複寫組態的時間。 類型：Timestamp ** [Destinations](#API_CreateReplicationConfiguration_ResponseSyntax) ** 目的地物件陣列。僅支援一個目的地物件。 類型：[Destination](API_Destination.md) 物件陣列 ** [OriginalSourceFileSystemArn](#API_CreateReplicationConfiguration_ResponseSyntax) ** 複寫組態中原始來源 EFS 檔案系統的 Amazon Resource Name (ARN)。 類型：字串 ** [SourceFileSystemArn](#API_CreateReplicationConfiguration_ResponseSyntax) ** 複寫組態中當前來源檔案系統的 Amazon Resource Name (ARN)。 類型：字串 ** [SourceFileSystemId](#API_CreateReplicationConfiguration_ResponseSyntax) ** 要複寫的來源 Amazon EFS 檔案系統 ID。 類型：字串 長度限制：長度上限為 128。 模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` ** [SourceFileSystemOwnerId](#API_CreateReplicationConfiguration_ResponseSyntax) ** 來源檔案系統所在的 AWS 帳戶 的 ID。 類型：字串 長度限制：長度上限為 14。 模式：`^(\d{12})|(\d{4}-\d{4}-\d{4})$` ** [SourceFileSystemRegion](#API_CreateReplicationConfiguration_ResponseSyntax) ** AWS 區域 來源 EFS 檔案系統所在的 。 類型：字串 長度限制：長度下限為 1。長度上限為 64。 模式：`^[a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-{0,1}[0-9]{0,1}$` ## 錯誤 ** BadRequest ** 如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** ConflictException ** 如果複寫中的來源檔案系統已加密，但目的地檔案系統未加密，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：409 ** FileSystemLimitExceeded ** 如果 AWS 帳戶 已建立每個帳戶允許的檔案系統數目上限，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：403 ** FileSystemNotFound ** 如果指定的`FileSystemId`值不存在於請求者的 中，則傳回 AWS 帳戶。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** IncorrectFileSystemLifeCycleState ** 如果檔案系統的生命週期狀態不是「可用」，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：409 ** InsufficientThroughputCapacity ** 如果沒有足夠容量佈建其他輸送量，則傳回。當您嘗試以佈建輸送量模式建立檔案系統、嘗試增加現有檔案系統的佈建輸送量，或嘗試將現有檔案系統從「爆增輸送量」變更為「佈建輸送量」模式時，系統可能會傳回此值。請稍後再試。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：503 ** InternalServerError ** 如果在伺服器端發生錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：500 ** ReplicationNotFound ** 如果指定的檔案系統沒有複寫組態，則傳回。 ** ErrorCode ** ReplicationNotFound ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** ThroughputLimitExceeded ** 如果因為已達到 1024 MiB/s 的輸送量限制而無法變更輸送量模式或佈建輸送量縂量，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** UnsupportedAvailabilityZone ** 如果請求的 Amazon EFS 功能在指定的可用區域中不可用，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** ValidationException ** 如果在提出請求 AWS 區域 的 中無法使用 AWS Backup 服務，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)