本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
CreateReplicationConfiguration
建立複寫組態，將現有 EFS 檔案系統複寫到新的只讀檔案系統中。如需詳細資訊，請參閱《Amazon EFS 使用者指南》中的 Amazon EFS 複寫。複寫組態指定以下内容：
-
來源檔案系統：您要複寫的 EFS 檔案系統。在現有複寫組態中，來源檔案系統不能為目的地檔案系統。
-
AWS 區域 — 建 AWS 區域 立目標檔案系統的位置。所有可使用 EFS 的部分都 AWS 區域 可以使用 Amazon 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 Resource Name (ARN)。
類型：字串
- SourceFileSystemArn
-
複寫組態中當前來源檔案系統的 Amazon Resource Name (ARN)。
類型：字串
- SourceFileSystemId
-
要複寫的來源 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})$ - 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 狀態碼：400
- ConflictException
-
如果複寫中的來源檔案系統已加密，但目的地檔案系統未加密，則傳回。
HTTP 狀態碼：409
- FileSystemLimitExceeded
-
如果 AWS 帳戶 已經建立了每個帳戶允許的最大檔案系統數，則傳回。
HTTP 狀態碼：403
- FileSystemNotFound
-
如果請求者中不存在指定的
FileSystemIdAWS 帳戶值，則返回。HTTP 狀態碼：404
- IncorrectFileSystemLifeCycleState
-
如果檔案系統的生命週期狀態不是「可用」，則傳回。
HTTP 狀態碼：409
- InsufficientThroughputCapacity
-
如果沒有足夠容量佈建其他輸送量，則傳回。當您嘗試以佈建輸送量模式建立檔案系統、嘗試增加現有檔案系統的佈建輸送量，或嘗試將現有檔案系統從「爆增輸送量」變更為「佈建輸送量」模式時，系統可能會傳回此值。請稍後再試。
HTTP 狀態碼：503
- InternalServerError
-
如果在伺服器端發生錯誤，則傳回。
HTTP 狀態碼：500
- ReplicationNotFound
-
如果指定的檔案系統沒有複寫組態，則傳回。
HTTP 狀態碼：404
- ThroughputLimitExceeded
-
如果因為已達到 1024 MiB/s 的輸送量限制而無法變更輸送量模式或佈建輸送量縂量，則傳回。
HTTP 狀態碼：400
- UnsupportedAvailabilityZone
-
如果請求的 Amazon EFS 功能在指定的可用區域中不可用，則傳回。
HTTP 狀態碼：400
- ValidationException
-
如果提出請求的 AWS Backup 服務不可用，則返回。 AWS 區域
HTTP 狀態碼：400
另請參閱
如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊，請參閱下列內容：
