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