Tüm Ürünler
Search
Belge Merkezi

:ListInstances

Son Güncelleme:Oct 04, 2026

Veritabanı örneklerine ilişkin bilgileri 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 işlem örnek kodlarını dinamik olarak oluşturur.

İstek parametreleri

Parametre Tür Zorunlu Örnek Açıklama
Action String Evet ListInstances

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

Tid Long Hayır 3***

Kiracı kimliği (ID). Kiracı kimliğini almak için GetUserActiveTenant işlemini çağırabilirsiniz.

SearchKey String Hayır test

Veritabanı örneklerini aramak için kullanılan anahtar kelime.

DbType String Hayır MySQL

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

EnvType String Hayır product

Veritabanı örneğinin ait olduğu ortam türü. Geçerli değerler:

  • product: üretim ortamı
  • dev: geliştirme ortamı
  • pre: ön sürüm ortamı
  • test: test ortamı
  • sit: sistem entegrasyon testi (SIT) ortamı
  • uat: kullanıcı kabul testi (UAT) ortamı
  • pet: stres testi ortamı
  • stag: hazırlık ortamı
InstanceSource String Hayır RDS

Veritabanı örneğinin kaynağı. Geçerli değerler:

  • PUBLIC_OWN: İnternet üzerinde dağıtılan kendi kendine yönetilen bir veritabanı örneği
  • RDS: bir ApsaraDB RDS örneği
  • ECS_OWN: Elastic Compute Service (ECS) örneğinde dağıtılan kendi kendine yönetilen bir veritabanı
  • VPC_IDC: sanal özel cloud (VPC) üzerinden bağlı bir veri merkezinde dağıtılan kendi kendine yönetilen bir veritabanı örneği
NetType String Hayır VPC

Veritabanı örneğinin ağ türü. Geçerli değerler:

  • CLASSIC: klasik ağ
  • VPC: VPC
InstanceState String Hayır NORMAL

Veritabanı örneğinin durumu. Geçerli değerler:

  • NORMAL: normal
  • DISABLE: devre dışı
PageNumber Integer Hayır 1

Döndürülecek sayfanın numarası.

PageSize Integer Hayır 50

Her sayfada döndürülecek giriş sayısı. Sayı 100'ü aşamaz.

Yanıt parametreleri

Parametre Tür Örnek Açıklama
TotalCount Long 1

Döndürülen toplam veritabanı örneği sayısı.

RequestId String B4B07137-F6AE-4756-8474-7F92BB6C4E04

İsteğin kimliği (ID).

ErrorCode String UnknownError

İstek başarısız olursa döndürülen hata kodu.

ErrorMessage String UnknownError

İstek başarısız olursa döndürülen hata mesajı.

InstanceList Array of Instance

Döndürülen veritabanı örneklerine ilişkin bilgiler.

Instance
VpcId String vpc-o6wrloqsdqc9io3mg****

Veritabanı örneğinin ait olduğu VPC'nin kimliği (ID).

DatabaseUser String dbUser

Veritabanında oturum açmak için kullanılan hesap.

DbaId String 31****

Veritabanı örneği için veritabanı yöneticisinin (DBA) kimliği (ID).

UseDsql Integer 1

Veritabanı örneği için çapraz veritabanı sorgu özelliğinin etkin olup olmadığını gösterir. Geçerli değerler:

  • 0: devre dışı
  • 1: etkin
Port Integer 3306

Veritabanı örneğine bağlanmak için kullanılan bağlantı noktası numarası.

EcsInstanceId String 150****

Veritabanı örneğinin dağıtıldığı ECS örneğinin kimliği (ID).

EnvType String product

Veritabanı örneğinin ait olduğu ortam türü. Geçerli değerler:

  • product: üretim ortamı
  • dev: geliştirme ortamı
  • pre: ön sürüm ortamı
  • test: test ortamı
  • sit: SIT ortamı
  • uat: UAT ortamı
  • pet: stres testi ortamı
  • stag: hazırlık ortamı
Sid String test

Veritabanı örneğinin sistem kimliği (SID).

OwnerIdList Array of String 123453

Veritabanı örneği sahiplerinin kimlikleri (ID'ler).

SafeRuleId String 1

Veritabanı örneği için güvenlik kuralı kümesinin kimliği (ID).

OwnerNameList Array of String yuyang_test

Veritabanı örneği sahiplerinin takma adları.

DbaNickName String dbaName

Veritabanı örneği DBA'sının takma adı.

QueryTimeout Integer 60

Veritabanı örneğinde veri sorgulama için zaman aşımı süresi.

InstanceSource String RDS

Veritabanı örneğinin kaynağı.

Host String ****.mysql.rds.aliyuncs.com

Veritabanı örneğine bağlanmak için kullanılan ana bilgisayar adresi.

State String NORMAL

Veritabanı örneğinin durumu.

DataLinkName String dblink_test

Veritabanı örneği için veritabanı bağlantısının adı.

ExportTimeout Integer 86400

Veritabanı örneğinden veri dışa aktarma için zaman aşımı süresi.

InstanceId String 150***

Veritabanı örneğinin kimliği (ID).

InstanceType String mysql

Veritabanı örneğinin türü.

DatabasePassword String ******

Veritabanında oturum açmak için kullanılan parola.

InstanceAlias String test

Veritabanı örneğinin takma adı.

DdlOnline Integer 1

Veritabanı örneği için kilitsiz şema değişikliği özelliğinin etkin olup olmadığını gösterir.

EcsRegion String cn-hangzhou

Veritabanı örneğinin bulunduğu bölgenin kimliği (ID).

StandardGroup Object

Veritabanı örneğinin kontrol modu.

GroupName String test

Kontrol moduna karşılık gelen güvenlik kuralı kümesinin adı.

GroupMode String COMMON

Kontrol modunun türü. Geçerli değerler:

  • COMMON: Güvenlik İş Birliği
  • NONE_CONTROL: Esnek Yönetim
  • STABLE: Kararlı Değişiklik
SellSitd Boolean true

Veritabanı örneği için hassas veri koruma özelliğinin etkin olup olmadığını gösterir. Geçerli değerler:

  • true: etkin
  • false: devre dışı
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 istekler

http(s)://dms-enterprise.aliyuncs.com/?Action=ListInstances
&Tid=3***
&SearchKey=test
&DbType=MySQL
&EnvType=product
&InstanceSource=RDS
&NetType=VPC
&InstanceState=NORMAL
&PageNumber=1
&PageSize=50
&Common request parameters

Başarılı yanıt örnekleri

XML biçimi

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

<ListInstancesResponse>
    <TotalCount>1</TotalCount>
    <RequestId>B4B07137-F6AE-4756-8474-7F92BB6C4E04</RequestId>
    <InstanceList>
        <VpcId>vpc-o6wrloqsdqc9io3mg****</VpcId>
        <DatabaseUser>dbUser</DatabaseUser>
        <DbaId>31****</DbaId>
        <UseDsql>1</UseDsql>
        <Port>3306</Port>
        <EcsInstanceId>150****</EcsInstanceId>
        <EnvType>product</EnvType>
        <Sid>test</Sid>
        <OwnerIdList>123453</OwnerIdList>
        <SafeRuleId>1</SafeRuleId>
        <OwnerNameList>yuyang_test</OwnerNameList>
        <DbaNickName>dbaName</DbaNickName>
        <QueryTimeout>60</QueryTimeout>
        <InstanceSource>RDS</InstanceSource>
        <Host>****.mysql.rds.aliyuncs.com</Host>
        <State>NORMAL</State>
        <DataLinkName>dblink_test</DataLinkName>
        <ExportTimeout>86400</ExportTimeout>
        <InstanceId>150***</InstanceId>
        <InstanceType>mysql</InstanceType>
        <DatabasePassword>******</DatabasePassword>
        <InstanceAlias>test</InstanceAlias>
        <DdlOnline>1</DdlOnline>
        <EcsRegion>cn-hangzhou</EcsRegion>
        <StandardGroup>
            <GroupName>test</GroupName>
            <GroupMode>COMMON</GroupMode>
        </StandardGroup>
        <SellSitd>true</SellSitd>
    </InstanceList>
    <Success>true</Success>
</ListInstancesResponse>

JSON biçimi

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

{
  "TotalCount" : 1,
  "RequestId" : "B4B07137-F6AE-4756-8474-7F92BB6C4E04",
  "InstanceList" : [ {
    "VpcId" : "vpc-o6wrloqsdqc9io3mg****",
    "DatabaseUser" : "dbUser",
    "DbaId" : "31****",
    "UseDsql" : 1,
    "Port" : 3306,
    "EcsInstanceId" : "150****",
    "EnvType" : "product",
    "Sid" : "test",
    "OwnerIdList" : [ "123453" ],
    "SafeRuleId" : "1",
    "OwnerNameList" : [ "yuyang_test" ],
    "DbaNickName" : "dbaName",
    "QueryTimeout" : 60,
    "InstanceSource" : "RDS",
    "Host" : "****.mysql.rds.aliyuncs.com",
    "State" : "NORMAL",
    "DataLinkName" : "dblink_test",
    "ExportTimeout" : 86400,
    "InstanceId" : "150***",
    "InstanceType" : "mysql",
    "DatabasePassword" : "******",
    "InstanceAlias" : "test",
    "DdlOnline" : 1,
    "EcsRegion" : "cn-hangzhou",
    "StandardGroup" : {
      "GroupName" : "test",
      "GroupMode" : "COMMON"
    },
    "SellSitd" : true
  } ],
  "Success" : true
}

Hata kodları

Hata kodlarının listesi için bkz. Hizmet hata kodları.