Modificar pesos de leitura e limiar de latência - : Central de Documentação do Alibaba Cloud

Antes de chamar esta operação, verifique se os seguintes requisitos são atendidos:

O recurso de proxy compartilhado está ativado para sua instância ApsaraDB RDS for MySQL.
O recurso de separação leitura/gravação está ativado para sua instância ApsaraDB RDS for MySQL.
A instância deve execute uma das seguintes versões de mecanismo de banco de dados e edições do RDS:
- MySQL 5.7 no RDS High-availability Edition (com SSDs locais)
- MySQL 5.6
- SQL Server no RDS Cluster Edition

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para maior comodidade, recomendamos chamar esta operação no OpenAPI Explorer, que gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de requisição

Parameter	Type	Required	Example	Description
Action	String	Yes	ModifyReadWriteSplittingConnection	A operação a ser executada. Defina o valor como ModifyReadWriteSplittingConnection.
DBInstanceId	String	Yes	rm-uf6wjk5xxxxxxx	O ID da instância primária.
ConnectionStringPrefix	String	No	rm-m5xxxxxxxxrw.mysql.rds.aliyuncs.com	O prefixo do endpoint de separação leitura/gravação. O prefixo deve ser exclusivo, pode ter até 30 caracteres e aceita letras minúsculas e hifens (-). Deve começar com uma letra minúscula. Nota Por padrão, o prefixo é composto pelo nome da instância primária seguido das letras rw.
Port	String	No	3306	A porta associada ao endpoint de separação leitura/gravação.
MaxDelayTime	String	No	12	O limiar de latência permitido pelo link de separação leitura/gravação. Unidade: segundos. Quando a latência em uma instância somente leitura ultrapassa o limiar especificado, o ApsaraDB RDS deixa de rotear requisições de leitura para essa instância. Se este parâmetro não for especificado, o valor padrão é mantido. Nota Se a instância primária executa SQL Server 2017 no RDS Cluster Edition, o parâmetro MaxDelayTime não é compatível. Especifique ao menos um dos seguintes parâmetros: MaxDelayTime e DistributionType.
DistributionType	String	No	Standard	O método de atribuição de pesos de leitura. Valores válidos: Standard: o ApsaraDB RDS atribui automaticamente um peso de leitura a cada instância com base nas especificações da instância. Custom: atribua manualmente um peso de leitura a cada instância. Nota Especifique ao menos um dos seguintes parâmetros: MaxDelayTime e DistributionType.
Weight	String	No	{"rm-bp1**********":800,"master":400,"slave":400}	Os pesos de leitura da instância primária e de suas instâncias somente leitura. O peso de leitura deve ser múltiplo de 100 e não pode exceder 10000. Formato para instâncias RDS: `{"<Read-only instance ID>":<Weight>,"master":<Weight>,"slave":<Weight>}` Formato para instâncias ApsaraDB MyBase: `[{"instanceName":"<Primary instance ID>","weight":<Weight>,"role":"master"},{"instanceName":"<Primary instance ID>","weight":<Weight>,"role":"slave"},{"instanceName":"<Read-only instance ID>","weight":<Weight>,"role":"master"}]` Nota Este parâmetro é obrigatório quando o parâmetro DistributionType está definido como Custom. Este parâmetro é ignorado quando o parâmetro DistributionType está definido como Standard.

Parâmetros de resposta

Parameter	Type	Example	Description
RequestId	String	5A77D650-27A1-4E08-AD9E-59008EDB6927	O ID da requisição.

Exemplos

Exemplos de requisição

http(s)://rds.aliyuncs.com/?Action=ModifyReadWriteSplittingConnection
&DistributionType=Standard
&DBInstanceId=rm-uf6wjk5xxxxxxx
&<Common request parameters>

Exemplo de resposta bem-sucedida

XML format

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

<?xml version="1.0" encoding="UTF-8" ?>
<ModifyReadWriteSplittingConnectionResponse>
	<RequestID>5A77D650-27A1-4E08-AD9E-59008EDB6927</RequestID>
</ModifyReadWriteSplittingConnectionResponse>

JSON format

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

{
  "RequestID" : "5A77D650-27A1-4E08-AD9E-59008EDB6927"
}

Códigos de erro

HTTP status code	Error code	Error message	Description
400	ReadUniformNetTypeNotExists	The specified uniform read only network type does not exist.	O tipo de rede unificado especificado para as instâncias somente leitura não foi encontrado.
400	ReadDBInstance.NotFound	The Current DB Instance has not read-only instance.	Nenhuma instância somente leitura está associada à instância.
403	ReadDBInstance.NotFound	The current database instance does not contain any read only instance.	Nenhuma instância somente leitura está vinculada à instância.

Para obter a lista de códigos de erro, acesse o API Error Center.