Tüm Ürünler
Search
Belge Merkezi

:ListDatabases

Son Güncelleme:Oct 04, 2026

Belirtilen bir örnekteki veritabanlarının ayrıntılı bilgilerini sorgulamak için bu işlemi çağırabilirsiniz.

Hata Ayıklama

OpenAPI Explorer imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer içinde çağırmanızı öneririz. API işlemlerini aramak, API işlemlerini çağırmak ve dinamik olarak SDK örnek kodu oluşturmak için OpenAPI Explorer'ı kullanabilirsiniz.

İstek parametreleri

Parametre Tür Gerekli Örnek Açıklama
Action String Evet ListDatabases

Gerçekleştirmek istediğiniz işlem. Değeri ListDatabases olarak ayarlayın.

InstanceId String Evet 1

ListInstances işlemi tarafından döndürülen örnek ID'sinden alınması gereken örnek kimliği. Bu değerin bir RDS örneğinin kimliği olmadığından emin olun.

PageNumber Integer Evet 1

Döndürülen sayfanın sayfa numarası.

Tid Long Evet -1

Kiracının kimliği.

Not Kiracı kimliği, profil resminizin üzerine imleci getirdiğinizde görüntülenen kiracı kimliğinden alınır. Daha fazla bilgi için bkz. Kiracı bilgilerini görüntüleyin .
PageSize Integer Hayır 10

Her sayfada döndürülecek giriş sayısı.

Yanıt parametreleri

Parametre Tür Örnek yanıt Açıklama
DatabaseList Array of Database

Bir veritabanına ilişkin ayrıntılar.

Database
CatalogName String 1

Veritabanının katalog adı.

DatabaseId String 1

Veritabanının kimliği.

DbType String mysql

Veritabanı örneğinin türü.

DbaId String 1

Veritabanı yöneticisinin (DBA) kimliği.

DbaName String dba_user

DBA'nın takma adı.

Encoding String utf-8

Veritabanının kodlama biçimi.

EnvType String dev

Veritabanının ait olduğu ortamın türü.

Host String xxx.xxx.xxx.xxx

Veritabanının ait olduğu örneğin uç noktası.

InstanceId String 1

Veritabanının ait olduğu örneğin kimliği.

OwnerIdList List 1

Bir veritabanı sahibinin kimliği.

OwnerNameList List owner_name

Bir veritabanı sahibinin takma adı.

Port Integer 3306

Veritabanının ait olduğu örneğin bağlantı noktası.

SchemaName String test

Veritabanının adı.

SearchName String test@xxx.xxx.xxx.xxx:3306

Veritabanının sorgu adı.

Sid String test

Veritabanının ait olduğu örneğin sistem kimliği (SID).

State String NORMAL

Veritabanının durumu. Geçerli değerler:

  • NORMAL: Veritabanı normal durumdadır.
  • DISABLE: Veritabanı devre dışı bırakılmıştır.
  • OFFLINE: Veritabanı çevrimdışı duruma getirilmiştir.
  • NOT_EXIST: Veritabanı mevcut değildir.
ErrorCode String UnknownError

Hata kodları.

ErrorMessage String UnknownError

Başarısızlığa ilişkin hata mesajı.

RequestId String 5541CDA6-F674-435C-81BD-40C2FB926CE3

İsteğin kimliği.

Success Boolean true

Çağrının başarılı olup olmadığını gösterir.

TotalCount Long 1

Örnekteki veritabanı sayısı.

Örnekler

Örnek istek


     http(s)://[Endpoint]/? Action=ListDatabases &InstanceId=1 &PageNumber=1 &Tid=-1 &<common request parameters> 
   

Örnek başarılı yanıtlar

XML biçimi


     <TotalCount> 1 </TotalCount> <RequestId> 5541CDA6-F674-435C-81BD-40C2FB926CE3 </RequestId> <Success> true </Success> <DatabaseList> <Database> <Encoding> utf8 </Encoding> <Host> pc-xxx.rwlb.rds.aliyuncs.com </Host> <InstanceId> 24710 </InstanceId> <DbType> polardb </DbType> <EnvType> product </EnvType> <OwnerIdList> <OwnerIds> 88653 </OwnerIds> </OwnerIdList> <DbaId> 104442 </DbaId> <OwnerNameList> <OwnerNames> dmstest </OwnerNames> </OwnerNameList> <Port> 3306 </Port> <DatabaseId> 116366 </DatabaseId> <State> NORMAL </State> <SearchName> xxx_test@pc-xxx.rwlb.rds.aliyuncs.com:3306 [xxx_test] </SearchName> <DbaName> xxx [account] </DbaName> <SchemaName> xxx_test </SchemaName> </Database> </DatabaseList> 
   

JSON


     {"TotalCount": 1, "RequestId": "5541CDA6-F674-435C-81BD-40C2FB926CE3", "Success": true, "DatabaseList": { "Database": [ { "Encoding": "utf8", "Host": "pc-xxx.rwlb.rds.aliyuncs.com", "InstanceId": 24710, "DbType": "polardb", "EnvType": "product", "OwnerIdList": { " OwnerIds ": [ 88653 ] }, " DbaId ": 104442, " OwnerNameList ": { " OwnerNames ": [ " dmstest " ] }, " Port ": 3306, " DatabaseId ": 116366," State ": " NORMAL ", " SearchName ": 3306" xxx_test@pc-xxx.rwlb.rds.aliyuncs.com: [xxx_xxtest] "DbaName": "xxx [Ram user]", "SchemaName": "xxx_test" } ] } } 
   

Hata kodları

Hata kodları hakkında daha fazla bilgi için bkz. hata merkezi.