Solicitar um endpoint de divisão de leitura e escrita - : Central de Documentação do Alibaba Cloud

Se houver instâncias somente leitura vinculadas a uma instância primária do ApsaraDB RDS for SQL Server, utilize esta operação para solicitar um endpoint unificado de roteamento somente leitura para a instância primária. Após solicitar esse endpoint, os endpoints existentes da instância primária e de suas instâncias somente leitura permanecem válidos. Além disso, ainda é possível solicitar endpoints internos e públicos.

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

Caso a instância execute MySQL, ela deve usar um proxy compartilhado.
A instância precisa estar no estado Running.
Existem instâncias somente leitura vinculadas à instância primária.
Não há tarefas de migração do Data Transmission Service (DTS) em andamento na instância.
A instância executa uma das seguintes versões de banco de dados e edições do RDS:
- SQL Server (edição cluster)
- MySQL 5.7 no RDS High-availability Edition com SSDs locais
- MySQL 5.6

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos que você chame esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	AllocateReadWriteSplittingConnection	A operação a ser executada. Defina o valor como AllocateReadWriteSplittingConnection.
DBInstanceId	String	Sim	rm-uf6wjk5xxxxxxx	O ID da instância primária. Chame a operação DescribeDBInstances para consultar o ID da instância.
ConnectionStringPrefix	String	Não	rr-m5exxxxx-rw.mysql.rds.aliyuncs.com	O prefixo do endpoint de roteamento somente leitura. O prefixo deve ser único, ter no máximo 30 caracteres e conter apenas letras minúsculas e hifens (-). Deve começar com uma letra minúscula. Nota O prefixo padrão consiste no nome da instância primária seguido pelas letras rw.
Port	String	Não	1433	A porta associada ao endpoint de roteamento somente leitura. Valores válidos: 1000 a 5999. Valor padrão: 1433.
MaxDelayTime	String	Não	30	O limiar de latência permitido nas instâncias somente leitura. Valores válidos: 0 a 7200. Valor padrão: 30. Unidade: segundos. Nota Se a latência em uma instância somente leitura exceder o limiar especificado, o ApsaraDB RDS não encaminhará solicitações de leitura para essa instância.
NetType	String	Não	Intranet	O tipo de rede do endpoint de roteamento somente leitura. Valores válidos: Internet: Internet Intranet: rede interna Nota O valor padrão é Intranet. Certifique-se de que o tipo de rede do endpoint de roteamento somente leitura seja igual ao da instância primária.
DistributionType	String	Não	Standard	O método usado para atribuir pesos de leitura. Valores válidos: Standard: O ApsaraDB RDS atribui automaticamente pesos de leitura às instâncias primárias e somente leitura com base nas especificações dessas instâncias. Custom: É necessário atribuir manualmente um peso de leitura a cada instância.
Weight	String	Não	{"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 aumenta em incrementos de 100. O valor máximo é 10000. Para instâncias do ApsaraDB RDS, o valor deste parâmetro segue o formato: `{"<ID of the read-only instance >":<Weight>,"master":<Weight>,"slave":<Weight>}`. Para instâncias do ApsaraDB MyBase, o valor deste parâmetro segue o formato: `[{"instanceName":"<ID of the primary instance>","weight":<Weight>,"role":"master"},{"instanceName":"<ID of the primary instance>","weight":<Weight>,"role":"slave"},{"instanceName":"<ID of the read-only instance>","weight":<Weight>,"role":"master"}]` Nota Se você definir o parâmetro DistributionType como Custom, também deverá especificar este parâmetro. Se você definir o parâmetro DistributionType como Standard, este parâmetro será inválido.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	4C467B38-3910-447D-87BC-AC049166F216	O ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://rds.aliyuncs.com/?Action=AllocateReadWriteSplittingConnection
&DBInstanceId=rm-uf6wjk5xxxxxxx
&ConnectionStringPrefix=rr-m5exxxxx-rw.mysql.rds.aliyuncs.com
&Port=1433
&MaxDelayTime=30
&NetType=Intranet
&DistributionType=Standard
&Weight={"rm-bp1**********":800,"master":400,"slave":400}
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

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

<AllocateReadWriteSplittingConnectionResponse>
    <RequestId>4C467B38-3910-447D-87BC-AC049166F216</RequestId>
</AllocateReadWriteSplittingConnectionResponse>

Formato JSON

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

{
  "RequestId" : "4C467B38-3910-447D-87BC-AC049166F216"
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o Error Center.