Tüm Ürünler
Search

Bu Ürün

    :Proxy uç noktası ayarlarını değiştirin

    Belge Merkezi

    :Proxy uç noktası ayarlarını değiştirin

    Son Güncelleme:Oct 03, 2026

    Bir örneğin proxy uç noktası ayarlarını değiştirmek için ModifyDBProxyEndpoint işlemini çağırabilirsiniz.

    ModifyDBProxyEndpoint işlemini çağırmadan önce örnek için veritabanı proxy özelliğini etkinleştirdiğinizden emin olun. Bunu yapmak için ModifyDBProxy işlemini çağırın.

    • ApsaraDB RDS for MySQL'nin ö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 örnek kodları dinamik olarak oluşturur.

    İstek parametreleri

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

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

    DBInstanceId String Evet rm-bp145737x5bi6****

    Örneğin ID'si. Örnek ID'sini sorgulamak için DescribeDBInstances işlemini çağırabilirsiniz.

    DBProxyEndpointId String Evet gos787jog2wk0y****

    Proxy uç noktasının ID'si. Proxy uç noktasının ID'sini sorgulamak için DescribeDBProxyEndpoint işlemini çağırabilirsiniz.

    Not
    • Örnek MySQL çalıştırıyorsa ve DbEndpointOperator parametresini Delete veya Modify olarak ayarlıyorsanız DBProxyEndpointId parametresini belirtmeniz gerekir.
    • Örnek PostgreSQL çalıştırıyorsa ve DbEndpointOperator parametresini Delete, Modify veya Create olarak ayarlıyorsanız DBProxyEndpointId parametresini belirtmeniz gerekir.
    ConfigDBProxyFeatures String Hayır ReadWriteSpliting:1;ConnectionPersist:0

    Proxy uç noktası için etkinleştirmek istediğiniz özellikler. Birden fazla özellik belirtiyorsanız özellikleri noktalı virgül (;) ile ayırın. Biçim: Feature 1:Status;Feature 2:Status;.... Son değerin sonuna noktalı virgül (;) eklemeyin.

    Geçerli özellik değerleri:

    • ReadWriteSpliting: okuma/yazma ayrımı
    • ConnectionPersist: bağlantı havuzlama
    • TransactionReadSqlRouteOptimizeStatus: işlem ayrımı

    Geçerli durum değerleri:

    • 1: etkin
    • 0: devre dışı
    Not Örnek PostgreSQL çalıştırıyorsa yalnızca ReadWriteSpliting ile belirtilen okuma/yazma ayrımı özelliğini etkinleştirebilirsiniz.
    RegionId String Hayır cn-hangzhou

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

    ReadOnlyInstanceMaxDelayTime String Hayır 30

    Okuma/yazma ayrımı için izin verilen maksimum gecikme süresi eşiği. Salt okunur bir örnekteki gecikme süresi belirttiğiniz eşiği aşarsa ApsaraDB RDS okuma isteklerini artık salt okunur örneğe iletmez. Bu parametreyi belirtmezseniz parametrenin orijinal değeri korunur. Birim: saniye. Geçerli değerler: 30 ile 3600 arasında. Varsayılan değer: 30.

    Not Bu parametreyi yalnızca okuma/yazma ayrımı özelliği etkinleştirildiğinde belirtmeniz gerekir.
    ReadOnlyInstanceDistributionType String Hayır Standard

    Okuma ağırlıklarını atamak için kullanılan ilke. Geçerli değerler:

    • Standard: ApsaraDB RDS örneklerin teknik özelliklerine göre okuma ağırlıklarını örneğe ve onun salt okunur örneklerine otomatik olarak atar.
    • Custom: Okuma ağırlıklarını örneğe ve onun salt okunur örneklerine manuel olarak atamanız gerekir.
    Not Bu parametreyi yalnızca okuma/yazma ayrımı özelliği etkinleştirildiğinde belirtmeniz gerekir.

    İzin atama ilkesi hakkında daha fazla bilgi için bkz. ApsaraDB RDS for MySQL örneklerinin gecikme süresi eşiklerini ve okuma ağırlıklarını değiştirin ve ApsaraDB RDS for PostgreSQL örneği için veritabanı proxy özelliğini etkinleştirin ve yapılandırın.

    ReadOnlyInstanceWeight String Hayır {"rm-uf6wjk5xxxx":"500","rr-tfhfgk5xxx":"200"...}

    Örneğin ve onun salt okunur örneklerinin okuma ağırlıkları. Okuma ağırlığı 100'ün katı olmalı ve 10000'i geçmemelidir. Biçimler:

    • Standart örnek: {"ID of the primary instance":"Weight","ID of the read-only instance":"Weight"...}

      Örnek: {"rm-uf6wjk5xxxx":"500","rr-tfhfgk5xxx":"200"...}

    • Küme örneği: {"ID of the read-only instance ID":"Weight","DBClusterNode":{"ID of the primary node":"Weight","ID of the secondary node ID":"Weight","ID of the secondary node ID":"Weight"...}}

      Örnek: {"rr-tfhfgk5xxx":"200","DBClusterNode":{"rn-2z****":"0","rn-2z****":"400","rn-2z****":"400"...}}
      Not Örnek RDS Cluster Edition çalıştırıyorsa DBClusterNode parametresi gereklidir. DBClusterNode parametresi birincil ve ikincil düğümlerin ID'lerini ve ağırlıklarını içeren bilgileri barındırır.
    DbEndpointOperator String Hayır Modify

    Gerçekleştirmek istediğiniz işlemin türü. Geçerli değerler:

    • Modify: Bir proxy uç noktasını değiştirin. Bu varsayılan değerdir.
    • Create: Bir proxy uç noktası oluşturun.
    • Delete: Bir proxy uç noktasını silin.
    DbEndpointAliases String Hayır test-proxy

    Proxy uç noktasının açıklaması.

    DbEndpointType String Hayır RWSplit

    Proxy uç noktasının türü. Bu ayrılmış bir parametredir. Bu parametreyi belirtmeniz gerekmez.

    DbEndpointReadWriteMode String Hayır ReadWrite

    Proxy uç noktasının okuma ve yazma nitelikleri. Geçerli değerler:

    • ReadWrite: Proxy uç noktası birincil örneğe bağlanır ve hem okuma hem de yazma isteklerini alabilir.
    • ReadOnly: Proxy uç noktası birincil örneğe bağlanmaz ve yalnızca okuma isteklerini alabilir. Bu varsayılan değerdir.
    Not
    • DbEndpointOperator parametresini Create olarak ayarlarsanız DbEndpointReadWriteMode parametresini de belirtmeniz gerekir.
    • Örnek MySQL çalıştırıyorsa ve bu parametrenin değerini ReadWrite'den ReadOnly'ye değiştirirseniz işlem ayrımı özelliği devre dışı bırakılır.
    DBProxyEngineType String Hayır normal

    Dahili bir parametredir. Bu parametreyi belirtmeniz gerekmez.

    Yanıt parametreleri

    Parametre

    Tür

    Örnek

    Açıklama

    RequestId

    String

    6B50D92C-1960-4D4F-A290-AFADD6B1A5C8

    İsteğin ID'si.

    Örnekler

    Örnek istekler

    http(s)://rds.aliyuncs.com/?Action=ModifyDBProxyEndpoint
&DBInstanceId=rm-bp145737x5bi6****
&DBProxyEndpointId=gos787jog2wk0y****
&ConfigDBProxyFeatures=ReadWriteSpliting:1;ConnectionPersist:1;
&ReadOnlyInstanceMaxDelayTime=30
&ReadOnlyInstanceDistributionType=Standard
&<Common request parameters>

    Örnek başarılı yanıtlar

    XML biçimi

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

<ModifyDBProxyEndpointResponse>
  <RequestId>6B50D92C-1960-4D4F-A290-AFADD6B1A5C8</RequestId>
</ModifyDBProxyEndpointResponse>

    JSON biçimi

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

{
  "RequestId" : "6B50D92C-1960-4D4F-A290-AFADD6B1A5C8"
}

    Hata kodları

    HTTP durum kodu

    Hata kodu

    Hata mesajı

    Açıklama

    400

    InvalidVpcInstanceId

    The specified VPC instance ID is invalid.

    Belirttiğiniz VPC ID'si geçersiz olduğu için döndürülen hata mesajı.

    400

    InvalidEndPoint.Format

    The specified EndPoint is not valid.

    DBProxyEndpointId parametresi boş olduğu veya DBProxyEndpointId parametresiyle belirtilen proxy uç noktası bulunamadığı için döndürülen hata mesajı.

    400

    InvalidEndpointType.Format

    The specified EndpointType is invalid.

    EndpointType parametresinin değeri geçersiz olduğu için döndürülen hata mesajı.

    400

    IncorrectDBInstanceNetType

    The current database instance network type does not support the operation.

    Örneğin ağ türü bu işlemi desteklemediği için döndürülen hata mesajı.

    400

    EndpointNum.Error

    The number of endpoint is invalid.

    Yapılandırdığınız proxy uç noktalarının sayısı gereksinimleri karşılamadığı için döndürülen hata mesajı.

    400

    EndpointTypeOperation.NotSupport

    The endpoint type does not support the operation.

    Belirtilen proxy uç noktası türü bu işlemi desteklemediği için döndürülen hata mesajı.

    400

    InvalidDBInstanceName

    Specified parameter DBInstanceName is not valid.

    DBInstanceName parametresinin değeri geçersiz olduğu için döndürülen hata mesajı. Değerin null veya boş dize olup olmadığını kontrol edin.

    400

    ClusterEndpoint.StatusNotValid

    The cluster endpoint status is invalid.

    Proxy uç noktasının durumu geçersiz olduğu için döndürülen hata mesajı.

    403

    MaxScaleLevel.NotSupport

    The current maxscale ins_num does not support this operation.

    Veritabanı proxy teknik özellikleri bu işlemi desteklemediği için döndürülen hata mesajı.

    403

    ReadDBInstance.NotFound

    The current database instance does not contain any read only instance.

    Örnek üzerinde hiçbir salt okunur örnek bulunmadığı için döndürülen hata mesajı.

    403

    IncorrectKindCode

    The current KindCode of the custins does not support the operation.

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

    403

    IncorrectDBInstanceState

    The current database instance state does not support the operation.

    Örneğin durumu bu işlemi desteklemediği için döndürülen hata mesajı. Örneğin Running durumunda olup olmadığını kontrol edin.

    404

    EndpointConfig.Invalid

    Please check the endpoint config parameter.

    Proxy uç noktası ayarları geçersiz olduğu için döndürülen hata mesajı. İlgili parametrelerin değerlerini kontrol edin.

    404

    Readins.NotFound

    The current instance does not contain any read only instance. The operation is not supported.

    Örnek üzerinde hiçbir salt okunur örnek bulunmadığı için döndürülen hata mesajı.

    404

    Endpoint.NotFound

    Specified endpoint is not found.

    Proxy uç noktasına bağlanmak için kullanılan bağlantı noktası bulunamadığı için döndürülen hata mesajı.

    404

    EndpointType.NotFound

    The specified endpoint type is not found.

    Belirttiğiniz proxy uç noktası türü sistem tarafından bilinmediği için döndürülen hata mesajı.

    404

    InvalidReadDBInstance.NotFound

    The specified read only database instance does not exist.

    Örnek üzerinde hiçbir salt okunur örnek bulunmadığı veya bazı istek parametrelerinin ayarlarının hatalı olduğu için döndürülen hata mesajı.

    404

    InvalidParam

    The specified Weight is invalid.

    Belirttiğiniz okuma ağırlıkları geçersiz olduğu için döndürülen hata mesajı.

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