本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
DescribeReplicationConfigurations
擷取特定檔案系統的複寫組態。如果未指定檔案系統, AWS 區域 則會擷取 AWS 帳戶 中 的所有複寫組態。
請求語法
GET /2015-02-01/file-systems/replication-configurations?FileSystemId=FileSystemId&MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
URI 請求參數
請求會使用下列 URI 參數。
- FileSystemId
-
您可以提供特定檔案系統的 ID,來擷取特定檔案系統的複寫組態。對於跨帳戶、跨區域複寫,帳戶只能描述自己區域中檔案系統的複寫組態。
長度限制:長度上限為 128。
模式:
^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$ - MaxResults
-
(選用) 若要限制傳回在回應中的物件數目,您可以指定
MaxItems參數。預設值為 100.有效範圍:最小值為 1。
- NextToken
-
如果是分頁回應,那麽將會出現
NextToken。您可以在後續請求中使用NextToken來擷取下一頁輸出。長度限制:長度下限為 1。長度上限為 128。
模式:
.+
請求主體
請求沒有請求主體。
回應語法
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"Replications": [
{
"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 格式的資料。
- NextToken
-
您可以在後續請求中使用先前回應裏的
NextToken來擷取下一頁的存取點描述。類型:字串
長度限制:長度下限為 1。長度上限為 128。
模式:
.+ - Replications
-
傳回的複寫組態集合。
錯誤
- BadRequest
-
如果請求格式錯誤或包含錯誤,例如無效的參數值或缺少必要參數,則傳回。
- ErrorCode
-
錯誤代碼是一個字串,專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。
- Message
-
錯誤訊息包含錯誤狀況的一般英文描述,目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時,會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密,而且經過適當的國際化,所以很可能會忽略錯誤訊息。
HTTP 狀態碼:400
- FileSystemNotFound
-
如果指定的
FileSystemId值不存在於請求者的 中,則傳回 AWS 帳戶。- ErrorCode
-
錯誤代碼是一個字串,專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。
- Message
-
錯誤訊息包含錯誤狀況的一般英文描述,目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時,會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密,而且經過適當的國際化,所以很可能會忽略錯誤訊息。
HTTP 狀態碼:404
- InternalServerError
-
如果伺服器端發生錯誤,則傳回。
- ErrorCode
-
錯誤代碼是一個字串,專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。
- Message
-
錯誤訊息包含錯誤狀況的一般英文描述,目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時,會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密,而且經過適當的國際化,所以很可能會忽略錯誤訊息。
HTTP 狀態碼:500
- ReplicationNotFound
-
如果指定的檔案系統沒有複寫組態,則傳回。
- ErrorCode
-
ReplicationNotFound
- Message
-
錯誤訊息包含錯誤狀況的一般英文描述,目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時,會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密,而且經過適當的國際化,所以很可能會忽略錯誤訊息。
HTTP 狀態碼:404
- ValidationException
-
如果在提出請求 AWS 區域 的 中無法使用 AWS Backup 服務,則傳回。
- ErrorCode
-
錯誤代碼是一個字串,專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。
- Message
-
錯誤訊息包含錯誤狀況的一般英文描述,目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時,會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密,而且經過適當的國際化,所以很可能會忽略錯誤訊息。
HTTP 狀態碼:400
另請參閱
如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊,請參閱下列內容: