Tüm Ürünler
Search
Belge Merkezi

:Veritabanı proxy ayarlarını sorgulama

Son Güncelleme:Oct 03, 2026

Bir ApsaraDB RDS örneğinin veritabanı proxy ayarlarını sorgulamak için DescribeDBProxy API işlemini çağırabilirsiniz.

DescribeDBProxy API işlemini çağırmadan önce, örnek için veritabanı proxy özelliğini etkinleştirmek amacıyla ModifyDBProxy API işlemini çağırdığınızdan emin olun.

  • ApsaraDB RDS for MySQL'in özel proxy özelliği; okuma/yazma ayrımı ve kısa ömürlü bağlantı optimizasyonu gibi yetenekler sunar. Daha fazla bilgi için bkz. Veritabanı proxy'leri nelerdir?

  • ApsaraDB RDS for PostgreSQL'in veritabanı proxy özelliği okuma/yazma ayrımını destekler. Daha fazla bilgi için bkz. Veritabanı proxy'leri nelerdir?

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 kodunu dinamik olarak oluşturur.

İstek parametreleri

Parametre

Tür

Zorunlu

Örnek

Açıklama

Action

String

Evet

DescribeDBProxy

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

DBInstanceId

String

Evet

rm-bp1ja4f56s7us****

Örneğin ID değeri. Örnek ID değerini sorgulamak için DescribeDBInstances API işlemini çağırabilirsiniz.

RegionId

String

Hayır

cn-hangzhou

Örneğin bölge ID değeri. En güncel bölge listesini sorgulamak için DescribeRegions API işlemini çağırabilirsiniz.

DBProxyEngineType

String

Hayır

normal

Dahili bir parametredir. Bu parametreyi belirtmeniz gerekmez.

ResourceGroupId

String

Hayır

rg-acfmy*

Kaynak grubunun ID değeri.

Yanıt parametreleri

Parametre Tür Örnek Açıklama
DBProxyInstanceLatestMinorVersion String 1.13.12

Örnek için kullanılabilen en son proxy sürümü.

RequestId String 909A69EE-71C8-4417-A0B9-FF085407E1E3

İsteğin ID değeri.

DBProxyInstanceCurrentMinorVersion String 1.13.11

Örnek tarafından çalıştırılan proxy sürümü.

DBProxyInstanceNum Integer 1

Örnek üzerinde etkinleştirilen proxy sayısı.

DBProxyInstanceType String 2

Örnek üzerinde etkinleştirilen veritabanı proxy türü. Geçerli değerler:

  • 1: paylaşımlı proxy
  • 2: özel proxy
Not ApsaraDB RDS for PostgreSQL örnekleri yalnızca özel proxy'leri destekler.
DBProxyInstanceStatus String Running

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

  • Creating: Proxy örneği oluşturuluyor.
  • Running: Proxy örneği çalışıyor.
  • DBInstanceClassChanging: Proxy örneğinin teknik özellikleri değiştiriliyor.
  • Deleting: Proxy örneği siliniyor.
DBProxyServiceStatus String Startup

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

  • Startup: etkin
  • Shutdown: devre dışı
DBProxyInstanceName String gos787jog2wk0ye1****

Proxy örneğinin adı.

DBProxyInstanceSize String 4/8

Proxy örneğinin teknik özellikleri. Bu parametre yalnızca ApsaraDB RDS for PostgreSQL örnekleri için kullanılabilir.

Biçim: Çekirdek sayısı/Bellek kapasitesi. Örneğin, 4/8 değeri proxy örneğinin 4 çekirdeğe ve 8 GB belleğe sahip olduğunu gösterir.

DBProxyEngineType String normal

Dahili bir parametredir. Bu parametreyi belirtmeniz gerekmez.

DBProxyConnectStringItems Array of DBProxyConnectStringItems

Örnek için oluşturulan proxy uç noktası bilgilerini içeren bir dizi.

DBProxyConnectStringItems
DBProxyConnectStringNetWorkType String 2

Veritabanı proxy'sinin ağ türü. Geçerli değerler:

  • 0: İnternet
  • 1: klasik ağ
  • 2: sanal özel cloud (VPC)
DBProxyConnectStringNetType String InnerString

Proxy uç noktasının ağ türü. Geçerli değerler:

  • InnerString: dahili ağ
  • OuterString: İnternet
DBProxyVpcInstanceId String rm-bp145737x5****131161274792****

Proxy örneğinin ID değeri.

DBProxyEndpointName String gos787jog2wk0ye1****

Proxy uç noktasının ait olduğu proxy terminalinin adı.

DBProxyEndpointId String 20****

Proxy uç noktasının ait olduğu proxy terminalinin ID değeri.

DBProxyConnectStringPort String 3306

Proxy uç noktasıyla ilişkili bağlantı noktası numarası.

DBProxyConnectString String gos787jog2wk0ye1****-rw4rm.rwlb.rds.aliyuncs.com

Proxy terminalinin uç noktası.

DbProxyEndpointItems Array of DbProxyEndpointItems

Proxy terminali bilgilerini içeren bir dizi.

DbProxyEndpointItems
DbProxyEndpointAliases String proxy-test

Proxy terminalinin açıklaması.

DbProxyEndpointName String gos787jog2wk0ye1****

Proxy terminalinin ID değeri.

DbProxyEndpointType String RWSplit

Proxy terminalinin türü. Geçerli değerler:

  • RWSplit: varsayılan proxy terminali
  • Custom: özel proxy terminali
DbProxyReadWriteMode String ReadWrite

Proxy terminalinin okuma ve yazma nitelikleri.

  • ReadWrite: Proxy terminali okuma ve yazma isteklerini destekler.
  • ReadOnly: Proxy terminali yalnızca okuma isteklerini destekler.
ResourceGroupId String rg-acfmy*****

Kaynak grubunun ID değeri.

Örnekler

Örnek istekler

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

Örnek başarılı yanıt

XML biçimi

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

<DescribeDBProxyResponse>
    <DBProxyInstanceName>gos787jog2wk0ye1****</DBProxyInstanceName>
    <DBProxyInstanceCurrentMinorVersion>1.13.11</DBProxyInstanceCurrentMinorVersion>
    <DBProxyServiceStatus>Startup</DBProxyServiceStatus>
    <DBProxyInstanceNum>1</DBProxyInstanceNum>
    <DBProxyInstanceLatestMinorVersion>1.13.12</DBProxyInstanceLatestMinorVersion>
    <RequestId>909A69EE-71C8-4417-A0B9-FF085407E1E3</RequestId>
    <DbProxyEndpointItems>
        <DbProxyEndpointItems>
            <DbProxyEndpointName>gos787jog2wk0ye1****</DbProxyEndpointName>
            <DbProxyEndpointAliases>proxy-test</DbProxyEndpointAliases>
            <DbProxyEndpointType>RWSplit</DbProxyEndpointType>
            <DbProxyReadWriteMode>ReadWrite</DbProxyReadWriteMode>
        </DbProxyEndpointItems>
    </DbProxyEndpointItems>
    <DBProxyConnectStringItems>
        <DBProxyConnectStringItems>
            <DBProxyConnectString>gos787jog2wk0ye1****-rw4rm.rwlb.rds.aliyuncs.com</DBProxyConnectString>
            <DBProxyEndpointId>209090</DBProxyEndpointId>
            <DBProxyEndpointName>gos787jog2wk0ye1****</DBProxyEndpointName>
            <DBProxyConnectStringNetWorkType>2</DBProxyConnectStringNetWorkType>
            <DBProxyConnectStringNetType>InnerString</DBProxyConnectStringNetType>
            <DBProxyConnectStringPort>3306</DBProxyConnectStringPort>
            <DBProxyVpcInstanceId>rm-bp145737x5****131161274792****</DBProxyVpcInstanceId>
        </DBProxyConnectStringItems>
    </DBProxyConnectStringItems>
    <DBProxyInstanceStatus>Running</DBProxyInstanceStatus>
    <DBProxyInstanceType>2</DBProxyInstanceType>
</DescribeDBProxyResponse>

JSON biçimi

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

{
  "DBProxyInstanceName" : "gos787jog2wk0ye1****",
  "DBProxyInstanceCurrentMinorVersion" : "1.13.11",
  "DBProxyServiceStatus" : "Startup",
  "DBProxyInstanceNum" : 1,
  "DBProxyInstanceLatestMinorVersion" : "1.13.12",
  "RequestId" : "909A69EE-71C8-4417-A0B9-FF085407E1E3",
  "DbProxyEndpointItems" : {
    "DbProxyEndpointItems" : [ {
      "DbProxyEndpointName" : "gos787jog2wk0ye1****",
      "DbProxyEndpointAliases" : "proxy-test",
      "DbProxyEndpointType" : "RWSplit",
      "DbProxyReadWriteMode" : "ReadWrite"
    } ]
  },
  "DBProxyConnectStringItems" : {
    "DBProxyConnectStringItems" : [ {
      "DBProxyConnectString" : "gos787jog2wk0ye1****-rw4rm.rwlb.rds.aliyuncs.com",
      "DBProxyEndpointId" : 209090,
      "DBProxyEndpointName" : "gos787jog2wk0ye1****",
      "DBProxyConnectStringNetWorkType" : 2,
      "DBProxyConnectStringNetType" : "InnerString",
      "DBProxyConnectStringPort" : "3306",
      "DBProxyVpcInstanceId" : "rm-bp145737x5****131161274792****"
    } ]
  },
  "DBProxyInstanceStatus" : "Running",
  "DBProxyInstanceType" : "2"
}

Hata kodları

HTTP durum kodu

Hata kodu

Hata iletisi

Açıklama

400

InvalidDBInstanceName

Specified parameter DBInstanceName is not valid.

DBInstanceName parametresinin değeri geçersiz olduğundan hata döndürüldü. Değerin null veya boş bir dize olup olmadığını kontrol edin.

403

IncorrectKindCode

Current custins kindCode does not support this operation.

Örneğin yapılandırması bu işlemi desteklemediğinden hata döndürüldü. Örneğin yapılandırmasını kontrol edin.

403

IncorrectDBInstanceType

The database instance type does not support the operation.

Örnek üzerinde çalışan veritabanı altyapısı bu işlemi desteklemediğinden hata döndürüldü.

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