云數(shù)據(jù)庫GaussDB如何查詢數(shù)據(jù)庫列表？
功能介紹
查詢GaussDB指定實例中的數(shù)據(jù)庫列表。
調(diào)用接口前，您需要了解API 認證鑒權(quán)。
調(diào)用接口前，您需要提前獲取到地區(qū)和終端節(jié)點，即下文中的Endpoint值。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
請求消息
無。
URI
URI格式:GET https://{Endpoint}/v3/{project_id}/instances/{instance_id}/databases
URI樣例:https://gaussdb-opengauss.cn-north-4.myhuaweicloud.com/v3/054b61972980d4552f0bc00ac8d3f5cd/instances/{instance_id}/databases
GaussDB查詢數(shù)據(jù)庫列表的參數(shù)說明
參數(shù)
是否必選
參數(shù)類型
描述
project_id
是
String
項目ID。
instance_id
是
String
實例ID。
offset
否
Integer
偏移量表示從此偏移量開始查詢, offset大于等于0，默認0。
limit
否
Integer
每頁顯示的條目數(shù)量,取值范圍[1, 100]，默認10。
GaussDB查詢數(shù)據(jù)庫列表的響應(yīng)消息-參數(shù)說明
以下為正常響應(yīng)要素說明，異常響應(yīng)請參見異常請求結(jié)果。
參數(shù)
參數(shù)類型
描述
databases
Array of objects
列表中每個元素表示一個數(shù)據(jù)庫。詳情參見下面表格，databases字段數(shù)據(jù)結(jié)構(gòu)說明。
total_count
Integer
總記錄數(shù)。
GaussDB查詢數(shù)據(jù)庫列表的響應(yīng)消息-databases字段數(shù)據(jù)結(jié)構(gòu)說明
參數(shù)
參數(shù)類型
描述
name
String
數(shù)據(jù)庫名稱。
owner
String
數(shù)據(jù)庫所屬用戶。
character_set
String
數(shù)據(jù)庫使用的字符集，例如UTF8。
collate_set
String
數(shù)據(jù)庫排序集，例如en_US.UTF-8等。
size
String
數(shù)據(jù)庫大小。