Tüm Ürünler
Search
Belge Merkezi

:SearchDatabase

Son Güncelleme:Oct 04, 2026

Veritabanı bilgilerini sorgular.

Hata Ayıklama

OpenAPI Explorer imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer üzerinden çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'lar için örnek kodları dinamik olarak oluşturur.

İstek parametreleri

Parameter Type Required Example Description
Action String Yes SearchDatabase

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

Tid Long Yes 3***

Kiracı ID'si. Kiracı ID'sini almak için GetUserActiveTenant işlemini çağırabilirsiniz.

SearchKey String Yes testdb

Veritabanlarını aramak için kullanılan anahtar sözcük.

PageNumber Integer Yes 1

Döndürülecek sayfa numarası.

PageSize Integer No 10

Her sayfada döndürülecek kayıt sayısı.

EnvType String No test

Veritabanının ait olduğu ortam türü. Daha fazla bilgi için bkz. Change the environment type of an instance.

SearchRange String No HAS_PERMSSION

İzinlere göre sorgu aralığı. Geçerli değerler:

  • HAS_PERMSSION: Mevcut kullanıcının izinlerinin bulunduğu veritabanlarını arar.
  • OWNER: Mevcut kullanıcının sahibi olduğu veritabanlarını arar.
  • MY_FOCUS: Mevcut kullanıcının takip ettiği veritabanlarını arar.
  • UNKNOWN: Tüm veritabanlarını arar.
SearchTarget String No SINGLE_DB

Veritabanı kategorisi. Geçerli değerler:

  • DB: Tekil veritabanı veya mantıksal veritabanı.
  • SINGLE_DB: Tekil veritabanı.
  • LOGIC_DB: Mantıksal veritabanı.
DbType String No MYSQL

Veritabanı türü. Bu parametrenin geçerli değerleri hakkında daha fazla bilgi için bkz. DbType parameter.

RegionId String No cn-hangzhou

Data Management (DMS) hizmetinin etkinleştirildiği bölgenin ID'si. Bu parametrenin geçerli değerleri hakkında daha fazla bilgi için bkz. RegionID parameter.

Yanıt parametreleri

Parameter Type Example Description
TotalCount Long 1

Döndürülen toplam kayıt sayısı.

RequestId String E0D21075-CD3E-4D98-8264-FD8AD04A63B6

İsteğin ID'si.

SearchDatabaseList Array of SearchDatabase

Veritabanı bilgileri.

SearchDatabase
DatabaseId String 2528****

Veritabanının ID'si.

Host String rm-xxxx.mysql.rds.aliyuncs.com

Veritabanının barındığı örneğin uç noktası.

DbaId String 10****

Veritabanı yöneticisi (DBA) rolünü üstlenen kullanıcının ID'si.

SchemaName String test

Veritabanının adı.

Logic Boolean false

Veritabanının mantıksal bir veritabanı olup olmadığını gösterir. Geçerli değerler:

  • true: Veritabanı mantıksal bir veritabanıdır.
  • false: Veritabanı mantıksal bir veritabanı değildir.
DatalinkName String datalink_name

Çapraz veritabanı sorguları için veri bağlantısının adı.

Port Integer 3306

Veritabanının barındığı örneğin bağlantı noktası numarası.

EnvType String test

Veritabanının ait olduğu ortam türü. Daha fazla bilgi için bkz. Change the environment type of an instance.

Sid String testSid

Veritabanının barındığı örneğin sistem ID'si (Sid).

OwnerIdList Array of String 1

Veritabanı sahiplerinin ID'leri.

Encoding String utf8

Veritabanının kodlama yöntemi.

DbType String mysql

Veritabanı türü.

OwnerNameList Array of String user1

Veritabanı sahiplerinin takma adları.

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

Veritabanını aramak için kullanılan ad.

Alias String test_rds

Veritabanının takma adı.

ErrorCode String UnknownError

Döndürülen hata kodu.

ErrorMessage String UnknownError

Döndürülen hata mesajı.

Success Boolean true

İsteğin başarılı olup olmadığını gösterir. Geçerli değerler:

  • true: İstek başarılı oldu.
  • false: İstek başarısız oldu.

Örnekler

Örnek istek

http(s)://dms-enterprise.aliyuncs.com/?Action=SearchDatabase
&Tid=3***
&SearchKey=testdb
&PageNumber=1
&PageSize=10
&EnvType=test
&SearchRange=HAS_PERMSSION
&SearchTarget=SINGLE_DB
&DbType=MYSQL
&<Common request parameters>

Örnek başarılı yanıt

XML biçimi

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

<SearchDatabaseResponse>
    <TotalCount>1</TotalCount>
    <RequestId>E0D21075-CD3E-4D98-8264-FD8AD04A63B6</RequestId>
    <SearchDatabaseList>
        <DatabaseId>2528****</DatabaseId>
        <Host>rm-xxxx.mysql.rds.aliyuncs.com</Host>
        <DbaId>10****</DbaId>
        <SchemaName>test</SchemaName>
        <Logic>false</Logic>
        <DatalinkName>datalink_name</DatalinkName>
        <Port>3306</Port>
        <EnvType>test</EnvType>
        <Sid>testSid</Sid>
        <OwnerIdList>1</OwnerIdList>
        <Encoding>utf8</Encoding>
        <DbType>mysql</DbType>
        <OwnerNameList>user1</OwnerNameList>
        <SearchName>test@xxx.xxx.xxx.xxx:3306</SearchName>
        <Alias>test_rds</Alias>
    </SearchDatabaseList>
    <Success>true</Success>
</SearchDatabaseResponse>

JSON biçimi

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

{
  "TotalCount" : 1,
  "RequestId" : "E0D21075-CD3E-4D98-8264-FD8AD04A63B6",
  "SearchDatabaseList" : [ {
    "DatabaseId" : "2528****",
    "Host" : "rm-xxxx.mysql.rds.aliyuncs.com",
    "DbaId" : "10****",
    "SchemaName" : "test",
    "Logic" : false,
    "DatalinkName" : "datalink_name",
    "Port" : 3306,
    "EnvType" : "test",
    "Sid" : "testSid",
    "OwnerIdList" : [ "1" ],
    "Encoding" : "utf8",
    "DbType" : "mysql",
    "OwnerNameList" : [ "user1" ],
    "SearchName" : "test@xxx.xxx.xxx.xxx:3306",
    "Alias" : "test_rds"
  } ],
  "Success" : true
}

Hata kodları

Hata kodlarının listesi için API Error Center adresini ziyaret edin.