Alternar entre endpoints internos e públicos - : Central de Documentação do Alibaba Cloud

Para economizar recursos de endpoint, use esta operação para alternar uma instância entre os endpoints internos e públicos. Após alterar o endpoint de conexão da instância, atualize as informações de endpoint no código da aplicação e reinicie-a.

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

A instância está conectada por meio do endpoint interno ou público.
A instância está no estado Running.
A instância não alternou entre endpoints internos e públicos 20 vezes nas últimas 24 horas.
A instância está na rede clássica.

Depuração

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

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	SwitchDBInstanceNetType	Operação a ser executada. Defina o valor como SwitchDBInstanceNetType.
ClientToken	String	Não	ETnLKlblzczshOTUbOCzxxxxxx	Token do cliente usado para garantir a idempotência da solicitação. Gere o valor com o cliente, mas garanta que seja único entre solicitações diferentes. O token aceita apenas caracteres ASCII e deve ter no máximo 64 caracteres.
DBInstanceId	String	Sim	rm-bp1**************	ID da instância.
ConnectionStringPrefix	String	Sim	new**********	Prefixo do endpoint personalizado. Deve ter de 8 a 64 caracteres, conter letras e dígitos e começar com letra minúscula. Um endpoint válido segue o formato: Prefixo.Mecanismo_de_banco_de_dados.rds.aliyuncs.com. Exemplo: test1234.mysql.rds.aliyuncs.com.
Port	String	Não	3306	Porta associada ao endpoint. Valores válidos: 3001 a 3999.
ConnectionStringType	String	Não	Normal	Tipo do endpoint. Valores válidos: Normal ReadWriteSplitting Por padrão, o sistema retorna ambos os tipos de endpoint.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
NewConnectionString	String	new.mysql.rds.aliyuncs.com	Endpoint usado para conectar-se à instância após a alternância.
RequestId	String	65BDA532-28AF-4122-AA39-B382721EEE64	ID da solicitação.
OldConnectionString	String	rm-bp1****.mysql.rds.aliyuncs.com	Endpoint usado para conectar-se à instância antes da alternância.

Exemplos

Exemplos de solicitações

http(s)://rds.aliyuncs.com/?Action=SwitchDBInstanceNetType
&DBInstanceId=rm-uf6wjk5xxxxxxx
&ConnectionStringPrefix=rm-xxxxxx
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<SwitchDBInstanceNetTypeResponse>
    <RequestId>94D5FC3C-1314-5883-9127-61D2105515AF</RequestId>
    <OldConnectionString>rm-bp1qp11x5**************.rds.aliyuncs.com</OldConnectionString>
    <NewConnectionString>new**********.rds.aliyuncs.com</NewConnectionString>
</SwitchDBInstanceNetTypeResponse>

Formato JSON

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

{
  "RequestId" : "94D5FC3C-1314-5883-9127-61D2105515AF",
  "OldConnectionString" : "rm-bp1qp11x5**************.rds.aliyuncs.com",
  "NewConnectionString" : "new**********.rds.aliyuncs.com"
}

Códigos de erro

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