Proxy uç noktası sorgulama - - Alibaba Cloud Dokümantasyon Merkezi

DescribeDBProxyEndpoint işlemini çağırmadan önce, örnek için veritabanı proxy özelliğini etkinleştirmek üzere ModifyDBProxy işleminin çağrıldığından emin olun.

ApsaraDB RDS for MySQL'in özel proxy özelliği, okuma/yazma ayrıştırma ve kısa ömürlü bağlantı optimizasyonu gibi yetenekler sağlar. Daha fazla bilgi için bkz. Veritabanı proxy'leri nelerdir?
ApsaraDB RDS for PostgreSQL'in veritabanı proxy özelliği okuma/yazma ayrıştırmayı 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'da ç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	DescribeDBProxyEndpoint	Gerçekleştirmek istediğiniz işlem. Değeri DescribeDBProxyEndpoint olarak belirtin.
DBInstanceId	String	Evet	rm-bp1ja4f56s7us****	Örneğin ID'si. Örneğin ID'sini sorgulamak için DescribeDBInstances işlemini çağırabilirsiniz.
DBProxyEndpointId	String	Hayır	keaxncrjluwu0gue****	Proxy uç noktasının ait olduğu proxy terminalinin adı. Proxy terminalinin adını sorgulamak için DescribeDBProxy işlemini çağırabilirsiniz.
DBProxyConnectString	String	Hayır	testproxy****.rwlb.rds.aliyuncs.com	Sorgulamak istediğiniz proxy uç noktası. Proxy uç noktasını sorgulamak için DescribeDBProxy işlemini çağırabilirsiniz.
RegionId	String	Evet	cn-hangzhou	Örneğin bölge ID'si. En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.
DBProxyEngineType	String	Hayır	normal	Dahili bir parametredir. Bu parametreyi belirtmeniz gerekmez.

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
DBProxyConnectStringNetType	String	InnerString	Proxy uç noktasının ağ türü. Geçerli değerler: InnerString: dahili ağ OuterString: İnternet
DBProxyFeatures	String	TransactionReadSqlRouteOptimizeStatus:1;ConnectionPersist:0;ReadWriteSpliting:1	Proxy terminalinin yapılandırması. Bu parametrenin değeri aşağıdaki alanlardan oluşan bir JSON dizesidir: TransactionReadSqlRouteOptimizeStatus: işlem ayrıştırma özelliğinin durumu. Geçerli değerler: 0 ve 1. 0 değeri özelliğin devre dışı bırakıldığını gösterir. 1 değeri özelliğin etkinleştirildiğini gösterir. ConnectionPersist: bağlantı havuzu özelliğinin durumu. Geçerli değerler: 0, 1 ve 2. 0 değeri bağlantı havuzu özelliğinin devre dışı bırakıldığını gösterir. 1 değeri oturum bağlantı havuzu özelliğinin etkinleştirildiğini gösterir. 2 değeri işlem bağlantı havuzu özelliğinin etkinleştirildiğini gösterir. ReadWriteSpliting: okuma/yazma ayrıştırma özelliğinin durumu. Geçerli değerler: 0 ve 1. 0 değeri özelliğin devre dışı bırakıldığını gösterir. 1 değeri özelliğin etkinleştirildiğini gösterir. PinPreparedStmt: yalnızca ApsaraDB RDS for PostgreSQL örnekleri için kullanılabilen dahili bir alan. Not Örnek PostgreSQL çalıştırıyorsa yalnızca ReadWriteSpliting alanının değerini değiştirebilirsiniz. TransactionReadSqlRouteOptimizeStatus ve PinPreparedStmt alanları varsayılan değerleri olan 1'e ayarlanır.
RequestId	String	847BA085-B377-4BFA-8267-F82345ECE1D2	İsteğin ID'si.
ReadOnlyInstanceWeight	String	[{\"Availability\":\"Available\",\"DBInstanceId\":\"rm-2z**\",\"DBInstanceType\":\"Master\",\"NodeId\":\"rn-t2\",\"NodeType\":\"Primary\",\"Weight\":0}, {\"Availability\":\"Available\",\"DBInstanceId\":\"rm-2z\",\"DBInstanceType\":\"Master\",\"NodeId\":\"rn-z9\",\"NodeType\":\"Secondary\",\"Weight\":400}, {\"Availability\":\"Available\",,\"DBInstanceId\":\"rm-2z\",\"DBInstanceType\":\"Master\",\"NodeId\":\"rn-1c**\",\"NodeType\":\"Secondary\",\"Weight\":400}]]	Örneğin ve salt okunur örneklerinin okuma ağırlıkları. Bu parametrenin değeri aşağıdaki alanlardan oluşan bir JSON dizesidir: DBInstanceId: örneğin ID'si. DBInstanceType: örneğin rolü. Geçerli değerler: Master ve ReadOnly. NodeID: örnek RDS Küme Sürümü çalıştırıyorsa birincil örnekteki birincil ve ikincil düğümlerin ID'leri. NodeType: örnek RDS Küme Sürümü çalıştırıyorsa düğüm türü. Geçerli değerler: Primary ve Secondary. Primary değeri birincil örnekteki birincil düğümü gösterir. Secondary değeri birincil örnekteki ikincil düğümü gösterir. Weight: örneğin okuma ağırlığı. Okuma ağırlığı 100 artışlarla artar ve 10000 değerini aşamaz.
ReadOnlyInstanceDistributionType	String	Standard	Okuma ağırlıklarının atanma yöntemi. Daha fazla bilgi için bkz. ApsaraDB RDS for MySQL örnekleri için gecikme süresi eşiğini ve okuma ağırlıklarını değiştirme. Geçerli değerler: Standard: ApsaraDB RDS, örneklerin teknik özelliklerine göre örneğe ve salt okunur örneklerine okuma ağırlıklarını otomatik olarak atar. Custom: Örneğe ve salt okunur örneklerine okuma ağırlıklarını manuel olarak atamanız gerekir.
ReadOnlyInstanceMaxDelayTime	String	30	Okuma/yazma ayrıştırma için izin verilen gecikme süresi eşiği. Bir salt okunur örnekteki gecikme süresi belirtilen eşiği aşarsa ApsaraDB RDS okuma isteklerini artık salt okunur örneğe iletmez.
DbProxyEndpointReadWriteMode	String	ReadWrite	Proxy terminalinin okuma ve yazma nitelikleri. Geçerli değerler: ReadWrite: Proxy terminali okuma ve yazma isteklerini destekler. ReadOnly: Proxy terminali yalnızca okuma isteklerini destekler.
DbProxyEndpointAliases	String	proxyterminal-test	Proxy terminalinin açıklaması.
DBProxyEndpointId	String	keaxncrjluwu0gue****	Proxy uç noktasının ID'si.
DBProxyConnectStringPort	String	3306	Proxy uç noktasıyla ilişkili bağlantı noktası numarası.
DBProxyConnectString	String	testproxy****.rwlb.rds.aliyuncs.com	Sorgulanan proxy uç noktası.
DBProxyEngineType	String	normal	Dahili bir parametredir. Bu parametreyi yok sayabilirsiniz.
EndpointConnectItems	Array of EndpointConnectItems		Proxy uç noktası bilgilerini içeren bir dizi.
EndpointConnectItems
DbProxyEndpointPort	String	3306	Proxy uç noktasıyla ilişkili bağlantı noktası numarası. Varsayılan değer: 3306.
DbProxyEndpointConnectString	String	testproxy****.rwlb.rds.aliyuncs.com	Sorgulanan proxy uç noktası.
DbProxyEndpointNetType	String	2	Proxy uç noktasının ağ türü. Geçerli değerler: 0: İnternet 1: klasik ağ 2: sanal private cloud (VPC)

Örnekler

Örnek istekler

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

Örnek başarılı yanıt

XML formatı

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

<DescribeDBProxyEndpointResponse>
    <DBProxyConnectStringNetType>InnerString</DBProxyConnectStringNetType>
    <DBProxyFeatures>TransactionReadSqlRouteOptimizeStatus:1;ConnectionPersist:0;ReadWriteSpliting:1</DBProxyFeatures>
    <RequestId>847BA085-B377-4BFA-8267-F82345ECE1D2</RequestId>
    <ReadOnlyInstanceWeight>[{\"Availability\":\"Available\",\"DBInstanceId\":\"rr-bp****\",\"DBInstanceType\":\"ReadOnly\",\"NodeId\":\"rr-bp****\",\"NodeType\":\"ReadOnly\",\"Weight\":400}, {\"Availability\":\"Available\",\"DBInstanceId\":\"rm-2z****\",\"DBInstanceType\":\"Master\",\"NodeId\":\"rm-2z****-instance-2\",\"NodeType\":\"Secondary\",\"Weight\":400}, {\"Availability\":\"Available\",\"DBInstanceId\":\"rm-2z****\",\"DBInstanceType\":\"Master\",\"NodeId\":\"rm-2z****-instance-3\",\"NodeType\":\"Secondary\",\"Weight\":400}, {\"Availability\":\"Available\",,\"DBInstanceId\":\"rm-2z****\",\"DBInstanceType\":\"Master\",\"NodeId\":\"rm-2z****-instance-1\",\"NodeType\":\"Primary\",\"Weight\":0}]]</ReadOnlyInstanceWeight>
    <ReadOnlyInstanceDistributionType>Standard</ReadOnlyInstanceDistributionType>
    <ReadOnlyInstanceMaxDelayTime>30</ReadOnlyInstanceMaxDelayTime>
    <DbProxyEndpointReadWriteMode>ReadWrite</DbProxyEndpointReadWriteMode>
    <DbProxyEndpointAliases>proxyterminal-test</DbProxyEndpointAliases>
    <DBProxyEndpointId>keaxncrjluwu0gue****</DBProxyEndpointId>
    <DBProxyConnectStringPort>3306</DBProxyConnectStringPort>
    <DBProxyConnectString>testproxy****.rwlb.rds.aliyuncs.com</DBProxyConnectString>
    <DBProxyEngineType>normal</DBProxyEngineType>
    <EndpointConnectItems>
        <DbProxyEndpointPort>3306</DbProxyEndpointPort>
        <DbProxyEndpointConnectString>testproxy****.rwlb.rds.aliyuncs.com</DbProxyEndpointConnectString>
        <DbProxyEndpointNetType>2</DbProxyEndpointNetType>
    </EndpointConnectItems>
</DescribeDBProxyEndpointResponse>

JSON formatı

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

{
  "DBProxyConnectStringNetType" : "InnerString",
  "DBProxyFeatures" : "TransactionReadSqlRouteOptimizeStatus:1;ConnectionPersist:0;ReadWriteSpliting:1",
  "RequestId" : "847BA085-B377-4BFA-8267-F82345ECE1D2",
  "ReadOnlyInstanceWeight" : "[{\\\"Availability\\\":\\\"Available\\\",\\\"DBInstanceId\\\":\\\"rr-bp****\\\",\\\"DBInstanceType\\\":\\\"ReadOnly\\\",\\\"NodeId\\\":\\\"rr-bp****\\\",\\\"NodeType\\\":\\\"ReadOnly\\\",\\\"Weight\\\":400}, {\\\"Availability\\\":\\\"Available\\\",\\\"DBInstanceId\\\":\\\"rm-2z****\\\",\\\"DBInstanceType\\\":\\\"Master\\\",\\\"NodeId\\\":\\\"rm-2z****-instance-2\\\",\\\"NodeType\\\":\\\"Secondary\\\",\\\"Weight\\\":400}, {\\\"Availability\\\":\\\"Available\\\",\\\"DBInstanceId\\\":\\\"rm-2z****\\\",\\\"DBInstanceType\\\":\\\"Master\\\",\\\"NodeId\\\":\\\"rm-2z****-instance-3\\\",\\\"NodeType\\\":\\\"Secondary\\\",\\\"Weight\\\":400}, {\\\"Availability\\\":\\\"Available\\\",,\\\"DBInstanceId\\\":\\\"rm-2z****\\\",\\\"DBInstanceType\\\":\\\"Master\\\",\\\"NodeId\\\":\\\"rm-2z****-instance-1\\\",\\\"NodeType\\\":\\\"Primary\\\",\\\"Weight\\\":0}]]",
  "ReadOnlyInstanceDistributionType" : "Standard",
  "ReadOnlyInstanceMaxDelayTime" : "30",
  "DbProxyEndpointReadWriteMode" : "ReadWrite",
  "DbProxyEndpointAliases" : "proxyterminal-test",
  "DBProxyEndpointId" : "keaxncrjluwu0gue****",
  "DBProxyConnectStringPort" : "3306",
  "DBProxyConnectString" : "testproxy****.rwlb.rds.aliyuncs.com",
  "DBProxyEngineType" : "normal",
  "EndpointConnectItems" : [ {
    "DbProxyEndpointPort" : "3306",
    "DbProxyEndpointConnectString" : "testproxy****.rwlb.rds.aliyuncs.com",
    "DbProxyEndpointNetType" : "2"
  } ]
}

Hata kodları

HTTP durum kodu	Hata kodu	Hata mesajı	Açıklama
400	InvalidEndPoint.Format	The specified EndPoint is not valid.	DBProxyEndpointId parametresi belirtilmediğinden veya DBProxyEndpointId parametresiyle belirtilen ID bulunamadığından dönen hata mesajı.
400	InvalidDBInstanceName	Specified parameter DBInstanceName is not valid.	DBInstanceName parametresinin değeri geçersiz olduğundan dönen hata mesajı. Değerin null veya boş bir dize olup olmadığını kontrol edin.
400	Endpoint.NotFound	The specified EndPoint is not valid.	Belirtilen proxy terminali mevcut olmadığından dönen hata mesajı.
403	IncorrectKindCode	The current KindCode of the custins does not support the operation.	Örneğin yapılandırması bu işlemi desteklemediğinden dönen hata mesajı. Birincil örneğin yapılandırmasını kontrol edin.
403	IncorrectDBInstanceType	The current database instance type does not support the operation.	Örneğin yapılandırması bu işlemi desteklemediğinden dönen hata mesajı.
404	Endpoint.NotFound	Specified endpoint is not found.	Belirttiğiniz bağlantı noktası numarası bulunamadığından dönen hata mesajı.

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