本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
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
-
如果請求者中不存在指定的
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 SDK 中使用此 API 的詳細資訊,請參閱下列內容: