本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
CreateReplicationConfiguration
建立複製組態，將現有EFS檔案系統複製到新的唯讀檔案系統。如需詳細資訊，請參閱 Amazon EFS使用者指南中的 Amazon EFS 複寫。複寫組態指定以下内容：
-
來源檔案系統 — 您要複製的EFS檔案系統。在現有複寫組態中，來源檔案系統不能為目的地檔案系統。
-
AWS 區域 — 建 AWS 區域 立目標檔案系統的位置。Amazon EFS 複寫 AWS 區域 在所有可EFS用. 必須啟用區域。如需詳細資訊，請參閱《 AWS 一般參考參考指南》 AWS 區域中的〈管理〉。
-
目的地檔案系統組態：複寫來源檔案系統的目的地檔案系統組態。在複寫組態中只能作爲目的地檔案系統。
複寫組態的參數包括：
-
檔案系統 ID：複寫的目的地檔案系統 ID。如果未提供任何 ID，則EFS會使用預設設定建立新的檔案系統。對於現有檔案系統，必須停用檔案系統的複寫覆寫保護。如需詳細資訊，請參閱複寫至現有檔案系統。
-
可用區域：如果您希望目的地檔案系統使用單區域儲存，則必須指定可在其中建立檔案系統的可用區域。如需詳細資訊，請參閱 Amazon EFS 使用者指南中的EFS檔案系統類型。
-
加密：所有目的地檔案系統都會在啟用靜態加密的情況下建立。您可以指定用來加密目的檔案系統的 AWS Key Management Service (AWS KMS) 金鑰。如果您未指定KMS金鑰，則會使用 Amazon EFS 的服務管理KMS金鑰。
注意
建立檔案系統之後，您無法變更KMS金鑰。
-
對於新目的地檔案系統，預設會設定下列屬性：
-
效能模式-目的地檔案系統的效能模式與來源檔案系統的效能模式相符，除非目的檔案系統使用EFS單一區域儲存體。在這種情況下，會使用「一般用途效能」模式。無法變更效能模式。
-
輸送量模式：目的地檔案系統的輸送量模式匹配來源檔案系統的輸送量模式。建立檔案系統之後，您可以修改輸送量模式。
-
生命週期管理 — 未在目標檔案系統上啟用生命週期管理。建立目的地檔案系統之後，您可以啟用生命週期管理。
-
自動備份：在目的地檔案系統上啟用自動每日備份。建立檔案系統之後，您可以變更此設定。
如需詳細資訊，請參閱 Amazon EFS使用者指南中的 Amazon EFS 複寫。
請求語法
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"
}
]
}URI請求參數
請求使用下列URI參數。
- SourceFileSystemId
-
指定您要複寫的 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
-
目的地組態物件陣列。僅支援一個目的地組態物件。
類型：DestinationToCreate 物件陣列
必要：是
回應語法
HTTP/1.1 200
Content-type: application/json
{
"CreationTime": number,
"Destinations": [
{
"FileSystemId": "string",
"LastReplicatedTimestamp": number,
"Region": "string",
"Status": "string"
}
],
"OriginalSourceFileSystemArn": "string",
"SourceFileSystemArn": "string",
"SourceFileSystemId": "string",
"SourceFileSystemRegion": "string"
}回應元素
如果動作成功，服務會傳回 HTTP 200 回應。
服務會以JSON格式傳回下列資料。
- CreationTime
-
說明建立複寫組態的時間。
類型：Timestamp
- Destinations
-
目的地物件陣列。僅支援一個目的地物件。
類型：Destination 物件陣列
- OriginalSourceFileSystemArn
-
複寫組態中原始來源EFS檔案系統的 Amazon 資源名稱 (ARN)。
類型：字串
- SourceFileSystemArn
-
複寫組態中目前來源檔案系統的 Amazon 資源名稱 (ARN)。
類型：字串
- SourceFileSystemId
-
正在複寫之來源 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})$ - SourceFileSystemRegion
-
來源EFS檔案系統所在的。 AWS 區域
類型：字串
長度限制：長度下限為 1。長度上限為 64。
模式：
^[a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-{0,1}[0-9]{0,1}$
錯誤
- BadRequest
-
如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。
HTTP狀態碼:
- ConflictException
-
如果複寫中的來源檔案系統已加密，但目的地檔案系統未加密，則傳回。
HTTP狀態碼:4
- FileSystemLimitExceeded
-
如果 AWS 帳戶 已經建立了每個帳戶允許的最大檔案系統數，則傳回此選項。
HTTP狀態碼:4
- FileSystemNotFound
-
如果請求者中不存在指定的
FileSystemIdAWS 帳戶值，則返回。HTTP狀態碼:
- IncorrectFileSystemLifeCycleState
-
如果檔案系統的生命週期狀態不是「可用」，則傳回。
HTTP狀態碼:4
- InsufficientThroughputCapacity
-
如果沒有足夠容量佈建其他輸送量，則傳回。當您嘗試以佈建輸送量模式建立檔案系統、嘗試增加現有檔案系統的佈建輸送量，或嘗試將現有檔案系統從「爆增輸送量」變更為「佈建輸送量」模式時，系統可能會傳回此值。請稍後再試。
HTTP狀態碼:5
- InternalServerError
-
如果伺服器端發生錯誤，則傳回。
HTTP狀態碼:5
- ReplicationNotFound
-
如果指定的檔案系統沒有複寫組態，則傳回。
HTTP狀態碼:
- ThroughputLimitExceeded
-
如果因為已達到 1024 MB 的輸送量限制而無法變更輸送量模式或佈建輸送量縂量，則傳回。
HTTP狀態碼:
- UnsupportedAvailabilityZone
-
如果所請求的 Amazon EFS 功能在指定的可用區域中不可用，則傳回。
HTTP狀態碼:
- ValidationException
-
如果提出請求的 AWS Backup 服務不可用，則返回。 AWS 區域
HTTP狀態碼:
另請參閱
如需有關API在其中一種特定語言中使用此功能的詳細資訊 AWS SDKs，請參閱下列內容：
