Kueri informasi tentang database - - Alibaba Cloud Documentation Center

Anda dapat memanggil operasi DescribeDatabases untuk mengkueri informasi tentang database dalam suatu instans.

Catatan Jika parameter permintaan yang ditentukan tidak valid, tidak ada informasi database yang dikembalikan.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

Parameter permintaan

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeDatabases	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeDatabases.
DBInstanceId	String	Yes	rm-uf6wjk5xxxxxxx	ID instans.
DBName	String	No	testDB01	Nama database.
DBStatus	String	No	Creating	Status database. Nilai yang valid: Creating Running Deleting
PageSize	Integer	No	30	Jumlah entri yang dikembalikan per halaman. Nilai yang valid: 30 50 100 Nilai default: 30.
PageNumber	Integer	No	1	Nomor halaman yang dikembalikan. Nilai yang valid: bilangan bulat positif bukan nol apa pun. Nilai default: 1.
ResourceGroupId	String	No	rg-acfmy*****	ID kelompok sumber daya.

Parameter respons

Parameter	Type	Example	Description
RequestId	String	2603CA96-B17D-4903-BC04-61A2C829CD94	ID permintaan.
Databases	Array of Database		Array yang berisi informasi tentang database.
Database
DBDescription	String	Test database	Deskripsi database.
DBStatus	String	Creating	Status database. Nilai yang valid: Creating Running Deleting
DBName	String	testDB01	Nama database.
DBInstanceId	String	rm-uf6wjk5xxxxxxx	ID instans tempat database tersebut berada.
Engine	String	MySQL	Database engine dari instans tempat database tersebut berada.
CharacterSetName	String	utf8	Nama set karakter.
Collate	String	C	Aturan pengurutan set karakter. Nilai contoh C merepresentasikan lokalisasi. Catatan Parameter ini hanya dikembalikan untuk instans yang menjalankan PostgreSQL.
Ctype	String	en_US.utf8	Tipe set karakter. Catatan Parameter ini hanya dikembalikan untuk instans yang menjalankan PostgreSQL.
ConnLimit	String	-1	Batas jumlah permintaan konkuren. Nilai -1 menunjukkan bahwa jumlah permintaan konkuren tidak dibatasi. Catatan Parameter ini hanya dikembalikan untuk instans yang menjalankan PostgreSQL.
Tablespace	String	pg_default	Ruang tabel database. Catatan Parameter ini hanya dikembalikan untuk instans yang menjalankan PostgreSQL.
ResourceGroupId	String	rg-acfmy*****	ID kelompok sumber daya.
Accounts	Array of AccountPrivilegeInfo		Array yang berisi detail akun. Setiap akun memiliki izin tertentu pada database.
AccountPrivilegeInfo
Account	String	test	Username akun.
AccountPrivilege	String	DMLOnly	Izin yang dimiliki akun pada database. Nilai yang valid: ReadWrite: izin baca dan tulis ReadOnly: izin read-only DMLOnly: izin DML-only DDLOnly: izin DDL-only
AccountPrivilegeDetail	String	SELECT	Detail izin yang dimiliki akun pada database.
PageNumber	Integer	1	Parameter cadangan.
PageSize	Integer	30	Parameter cadangan.
TotalCount	Integer	100	Total jumlah entri yang dikembalikan.

Contoh

Contoh permintaan

http(s)://rds.aliyuncs.com/?Action=DescribeDatabases
&DBInstanceId=rm-uf6wjk5xxxxxxx
&<Common request parameters>

Contoh respons sukses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<?xml version="1.0" encoding="UTF-8" ?>
<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 format

HTTP/1.1 200 OK
Content-Type:application/json

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

Kode kesalahan

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
400	Database.ConnectError	Database connect error. please check instance status and database processlist	Pesan kesalahan yang dikembalikan karena koneksi database tidak normal. Periksa status instans dan kolam koneksi database.
400	Database.QueryError	Query Db failed, please check input value and instance status	Pesan kesalahan yang dikembalikan karena gagal mengkueri database. Periksa parameter input dan status instans.

Untuk daftar kode kesalahan, kunjungi API Error Center.