調用DescribeDatabases介面查看執行個體下的資料庫資訊。

说明 如果請求參數錯誤，返回資料為空白。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

請求參數

名稱 類型 是否必選 樣本值 描述
Action String 是 DescribeDatabases

系統規定參數，取值：DescribeDatabases。

DBInstanceId String 是 rm-uf6wjk5xxxxxxx

執行個體ID。
DBName String 否 testDB01

資料庫名稱。
DBStatus String 否 Creating

資料庫狀態，取值：

  • Creating：建立中；
  • Running：使用中；
  • Deleting：刪除中。
PageSize Integer 否 30

每頁記錄數，取值：

  • 30；
  • 50；
  • 100。

預設值：30。
PageNumber Integer 否 1

頁碼，取值：大於0且不超過Integer的最大值。

預設值：1。

AccessKeyId String 否 LTAIfCxxxxxxx

阿里雲頒發給使用者的訪問服務所用的密鑰ID。

返回資料

名稱 類型 樣本值 描述
Databases

資料庫資訊列表。
DBName String testDB01

資料庫名稱。
DBInstanceId String rm-uf6wjk5xxxxxxx

資料庫所屬執行個體ID。
Engine String MySQL

資料庫執行個體類型。
DBStatus String Creating

資料庫狀態，取值：

  • Creating：建立中；
  • Running：使用中；
  • Deleting：刪除中。
CharacterSetName String utf8

字元集。
DBDescription String 測試資料庫

資料庫描述。
Accounts

擁有資料庫相關許可權的帳號資訊。
Account String test

帳號名稱。
AccountPrivilege String DMLOnly

帳號對該資料庫擁有的許可權。
AccountPrivilegeDetail String SELECT

帳號對該資料庫具有的許可權。
RequestId String 2603CA96-B17D-4903-BC04-61A2C829CD94

請求ID。

樣本

請求樣本


http(s)://rds.aliyuncs.com/?Action=DescribeDatabases
&DBInstanceId=rm-uf6wjk5xxxxxxx
&<公用請求參數>

正常返回樣本

XML 格式 

<DescribeDatabasesResponse>
	  <RequestId>2603CA96-B17D-4903-BC04-61A2C829CD94</RequestId>
	  <Databases>
		    <Database>
			      <Engine>MySQL</Engine>
			      <CharacterSetName>utf8</CharacterSetName>
			      <DBStatus>Creating</DBStatus>
			      <DBDescription></DBDescription>
			      <DBInstanceId>rdsaiiabnaiiabn</DBInstanceId>
			      <Accounts></Accounts>
			      <DBName>testdb</DBName>
		    </Database>
		    <Database>
			      <Engine>MySQL</Engine>
			      <CharacterSetName>gbk</CharacterSetName>
			      <DBStatus>Creating</DBStatus>
			      <DBDescription></DBDescription>
			      <DBInstanceId>rdsaiiabnaiiabn</DBInstanceId>
			      <Accounts></Accounts>
			      <DBName>testdb2</DBName>
		    </Database>
	  </Databases></DescribeDatabasesResponse>

JSON 格式 

{
	"Databases":{
		"Database":[
			{
				"Accounts":{
					" AccountPrivilegeInfo":[]
				},
				"DBStatus":"Creating",
				"DBInstanceId":"rdsaiiabnaiiabn",
				"DBDescription":"",
				"DBName":"testdb",
				"CharacterSetName":"utf8",
				"Engine":"MySQL"
			},
			{
				"Accounts":{
					" AccountPrivilegeInfo":[]
				},
				"DBStatus":"Creating",
				"DBInstanceId":"rdsaiiabnaiiabn",
				"DBDescription":"",
				"DBName":"testdb2",
				"CharacterSetName":"gbk",
				"Engine":"MySQL"
			}
		]
	},
	"RequestId":"2603CA96-B17D-4903-BC04-61A2C829CD94"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。