本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
CreateReplicationConfiguration
建立複寫組態至新的或現有的 EFS 檔案系統。如需詳細資訊，請參閱《Amazon EFS 使用者指南》中的 Amazon EFS 複寫。複寫組態指定以下内容：
-
來源檔案系統 – 您要複寫的 EFS 檔案系統。
-
目的地檔案系統 – 來源檔案系統複寫的目標檔案系統。在複寫組態中只能作爲目的地檔案系統。
注意
檔案系統只是複寫組態的一部分。
複寫組態的目的地參數取決於您是複寫到新的檔案系統還是現有的檔案系統，以及您是否跨檔案系統複寫 AWS 帳戶。如需更多資訊，請參閱DestinationToCreate。
這項操作需要 elasticfilesystem:CreateReplicationConfiguration 動作的許可。此外，根據您複寫檔案系統的方式，還需要其他許可。如需詳細資訊，請參閱《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",
"RoleArn": "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,
"OwnerId": "string",
"Region": "string",
"RoleArn": "string",
"Status": "string",
"StatusMessage": "string"
}
],
"OriginalSourceFileSystemArn": "string",
"SourceFileSystemArn": "string",
"SourceFileSystemId": "string",
"SourceFileSystemOwnerId": "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})$ - SourceFileSystemOwnerId
-
來源檔案系統所在的 AWS 帳戶 的 ID。
類型：字串
長度限制：長度上限為 14。
模式：
^(\d{12})|(\d{4}-\d{4}-\d{4})$ - SourceFileSystemRegion
-
AWS 區域 來源 EFS 檔案系統所在的 。
類型：字串
長度限制：長度下限為 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
-
如果指定的
FileSystemId值不存在於請求者的 中，則傳回 AWS 帳戶。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 SDKs中使用此 API 的詳細資訊，請參閱下列內容：
