本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
DescribeDBInstances
傳回佈建的 Amazon 文件資料庫執行個體的相關資訊。此 API 支援分頁。
請求參數
如需所有動作的一般參數資訊,請參閱《Common Parameters》。
- DBInstanceIdentifier
-
用戶提供的實例標識符。如果指定此參數,則只會傳回來自特定執行個體的資訊。此參數不區分大小寫。
約束:
-
如果提供,則必須與現有的識別碼相符
DBInstance
。
類型:字串
必要:否
-
- 篩選器. N
-
指定要描述之一或多個執行個體的篩選器。
支援的篩選條件:
-
db-cluster-id
-接受叢集識別碼和叢集 Amazon 資源名稱 (ARN)。結果清單僅包含與這些 ARN 識別之叢集相關聯之執行個體的相關資訊。 -
db-instance-id
-接受執行個體識別碼和執行個體 ARN。結果清單僅包含這些 ARN 所識別之實例的相關資訊。
類型:Filter 物件陣列
必要:否
-
- Marker
-
前一個請求提供的選用分頁字符。若指定此參數,則回應只會包含超過標記的記錄,直到
MaxRecords
指定的值為止。類型:字串
必要:否
- MaxRecords
-
要在回應中包含的記錄數量上限。如果存在的記錄多於指定
MaxRecords
值,則響應中包含分頁令牌(標記),以便可以檢索剩餘的結果。預設:100
限制條件:最小 20,最大 100。
類型:整數
必要:否
回應元素
服務會傳回下列元素。
- 數據庫實例. N
-
一或多個執行個體的詳細資訊。
類型:DBInstance 物件陣列
- Marker
-
前一個請求提供的選用分頁字符。若指定此參數,則回應只會包含超過標記的記錄,直到
MaxRecords
指定的值為止。類型:字串
錯誤
如需所有動作常見錯誤的資訊,請參閱常見錯誤。
- DBInstanceNotFound
-
DBInstanceIdentifier
不會參考現有的執行個體。HTTP 狀態碼:404
另請參閱
如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊,請參閱下列內容: