Tüm Ürünler
Search
Belge Merkezi

:GetInstance

Son Güncelleme:Oct 04, 2026

Bir veritabanı örneğinin ayrıntılarını 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'ler için örnek kodu dinamik olarak oluşturur.

İstek parametreleri

Parametre

Tür

Zorunlu

Örnek

Açıklama

Action

String

Evet

GetInstance

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

Tid

Long

Evet

2***

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

Host

String

Evet

172.17.XXX.XXX

Veritabanı örneğinin uç noktası. Uç noktayı sorgulamak için ListInstances işlemini çağırabilirsiniz.

Port

Integer

Evet

5432

Veritabanı örneğine bağlanmak için kullanılan bağlantı noktası numarası. Bağlantı noktası numarasını sorgulamak için ListInstances işlemini çağırabilirsiniz.

Sid

String

Hayır

test

Veritabanı örneğinin sistem ID'si (SID). SID'yi sorgulamak için ListInstances işlemini çağırabilirsiniz.

Yanıt parametreleri

Parametre Tür Örnek Açıklama
RequestId String F6C80B69-3203-56AC-8021-18BA72A6F4E1

İsteğin ID'si.

Instance Object

Veritabanı örneğinin ayrıntıları.

VpcId String vpc-o6wrloqsdqc9io3mg****

Veritabanı örneğinin ait olduğu sanal özel bulut (VPC) ID'si.

DatabaseUser String dbuser

Veritabanı örneğinde oturum açmak için kullanılan hesap.

DbaId String 29****

Veritabanı örneğinin veritabanı yöneticisinin (DBA) ID'si.

UseDsql Integer 0

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

  • 0: Çapraz veritabanı sorgu özelliği devre dışı.
  • 1: Çapraz veritabanı sorgu özelliği etkin.
Port Integer 5432

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

EcsInstanceId String i-bp124ldpklqz59y3****

Veritabanı örneğinin dağıtıldığı Elastic Compute Service (ECS) örneğinin ID'si.

EnvType String test

Veritabanı örneğinin dağıtıldığı ortamın 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ı
Sid String test

Veritabanı örneğinin SID'si.

OwnerIdList Array of String 10****

Veritabanı örneğinin sahiplerinin ID'leri.

SafeRuleId String 3****

Veritabanı örneğinin güvenlik kuralı setinin ID'si.

OwnerNameList Array of String yang_test

Veritabanı örneğinin sahiplerinin takma adları.

DbaNickName String dbaname

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

QueryTimeout Integer 7200

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

InstanceSource String ECS_OWN

Veritabanı örneğinin kaynağı.

Host String 192.168.XXX.XXX

Veritabanı örneğine bağlanmak için kullanılan uç nokta.

State String NORMAL

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

  • NORMAL: Örnek normal.
  • DISABLE: Örnek devre dışı.
DataLinkName String test

Veritabanı örneğinin 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 188****

Örneğin ID'si.

InstanceType String postgresql

Veritabanı örneğinin türü.

DatabasePassword String ******

Veritabanı örneğinde oturum açmak için kullanılan parola.

InstanceAlias String Test

Veritabanı örneğinin takma adı.

DdlOnline Integer 0

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

EcsRegion String cn-beijing

Veritabanı örneğinin bulunduğu bölgenin ID'si.

StandardGroup Object

Veritabanı örneğinin kontrol modu.

GroupName String Flexible Management

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

GroupMode String NONE_CONTROL

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

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

Hassas veri koruma özelliğinin etkin olup olmadığını belirtir. Geçerli değerler:

  • true: Hassas veri koruma özelliği etkin.
  • false: Hassas veri koruma özelliği devre dışı.
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ı.

Success Boolean true

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

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

Örnekler

Örnek istekler

http(s)://dms-enterprise.aliyuncs.com/?Action=GetInstance
&Tid=1
&Host=172.17.XXX.XXX
&Port=5432
&Sid=test
&Common request parameters

Örnek başarılı yanıt

XML biçimi

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

<GetInstanceResponse>
    <RequestId>F6C80B69-3203-56AC-8021-18BA72A6F4E1</RequestId>
    <Instance>
        <Port>5432</Port>
        <DatabasePassword>******</DatabasePassword>
        <ExportTimeout>86400</ExportTimeout>
        <EnvType>test</EnvType>
        <DbaId>12****</DbaId>
        <InstanceAlias>Test</InstanceAlias>
        <EcsRegion>cn-beijing</EcsRegion>
        <InstanceType>postgresql</InstanceType>
        <QueryTimeout>7200</QueryTimeout>
        <DataLinkName>dbl_postgresql_2</DataLinkName>
        <SafeRuleId>3****</SafeRuleId>
        <SellSitd>false</SellSitd>
        <InstanceSource>ECS_OWN</InstanceSource>
        <StandardGroup>
            <GroupName>Flexible Management</GroupName>
            <GroupMode>NONE_CONTROL</GroupMode>
        </StandardGroup>
        <InstanceId>188****</InstanceId>
        <Host>172.17.XXX.XXX</Host>
        <DdlOnline>0</DdlOnline>
        <UseDsql>0</UseDsql>
        <EcsInstanceId>i-bp124ldpklqz59y3****</EcsInstanceId>
        <State>NORMAL</State>
        <DatabaseUser>postgres</DatabaseUser>
        <OwnerNameList>
            <OwnerNames>yang_test</OwnerNames>
        </OwnerNameList>
        <DbaNickName>dbaname</DbaNickName>
        <OwnerIdList>
            <OwnerIds>10****</OwnerIds>
        </OwnerIdList>
    </Instance>
    <Success>true</Success>
</GetInstanceResponse>

JSON biçimi

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

{
  "RequestId" : "F6C80B69-3203-56AC-8021-18BA72A6F4E1",
  "Instance" : {
    "Port" : 5432,
    "DatabasePassword" : "******",
    "ExportTimeout" : 86400,
    "EnvType" : "test",
    "DbaId" : "12****",
    "InstanceAlias" : "Test",
    "EcsRegion" : "cn-beijing",
    "InstanceType" : "postgresql",
    "QueryTimeout" : 7200,
    "DataLinkName" : "dbl_postgresql_2",
    "SafeRuleId" : "3****",
    "SellSitd" : false,
    "InstanceSource" : "ECS_OWN",
    "StandardGroup" : {
      "GroupName" : "Flexible Management",
      "GroupMode" : "NONE_CONTROL"
    },
    "InstanceId" : "188****",
    "Host" : "172.17.XXX.XXX",
    "DdlOnline" : 0,
    "UseDsql" : "0",
    "EcsInstanceId" : "i-bp124ldpklqz59y3****",
    "State" : "NORMAL",
    "DatabaseUser" : "postgres",
    "OwnerNameList" : {
      "OwnerNames" : [ "yang_test" ]
    },
    "DbaNickName" : "dbaname",
    "OwnerIdList" : {
      "OwnerIds" : [ "10****" ]
    }
  },
  "Success" : true
}

Hata kodları

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