Alterar o tipo de rede de uma instância ApsaraDB RDS - : Central de Documentação do Alibaba Cloud

Pré-requisitos

A instância deve usar o tipo de rede clássica.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar esta ferramenta para chamar a operação. O OpenAPI Explorer também gera dinamicamente códigos de exemplo para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	ModifyDBInstanceNetworkType	Operação a ser executada. Defina o valor como ModifyDBInstanceNetworkType.
DBInstanceId	String	Sim	rm-uf6wjk5xxxxxxx	ID da instância.
RetainClassic	String	Não	True	Defina se o endpoint de rede clássica será mantido. Valores válidos: True: mantém o endpoint de rede clássica. False: não mantém o endpoint de rede clássica. Valor padrão: False.
ClassicExpiredDays	String	Não	7	Número de dias para manter o endpoint de rede clássica. Valores válidos: 1 a 120. Valor padrão: 7. Nota Se você definir RetainClassic como True, especifique também este parâmetro.
InstanceNetworkType	String	Sim	VPC	Tipo de rede após a modificação. O valor é fixo em VPC.
ReadWriteSplittingClassicExpiredDays	Integer	Não	7	Número de dias para manter o endpoint de divisão de leitura e escrita da rede clássica. Valores válidos: 1 a 120. Valor padrão: 7. Nota Este parâmetro só tem efeito quando existe um endpoint de divisão de leitura e escrita da rede clássica e RetainClassic está definido como True.
VPCId	String	Não	vpc-uf6f7l4fg90xxxxxx	ID da VPC.
VSwitchId	String	Não	vsw-uf6adz52c2pxxxxx	ID do vSwitch. Este parâmetro é obrigatório caso o parâmetro VPCId seja especificado.
PrivateIpAddress	String	Não	172.10.40.25	Endereço IP interno da instância. Deve estar dentro do bloco CIDR compatível com o vSwitch especificado. O ApsaraDB RDS atribui automaticamente um endereço IP interno à instância com base nos valores dos parâmetros VPCId e VSwitchId.
ReadWriteSplittingPrivateIpAddress	String	Não	192.168.0.22	Endereço IP interno correspondente ao endpoint de divisão de leitura e escrita da instância. Deve estar dentro do bloco CIDR compatível com o vSwitch especificado. O ApsaraDB RDS atribui automaticamente um endereço IP interno à instância com base nos valores dos parâmetros VPCId e VSwitchId. Nota Este parâmetro é válido apenas quando existe um endpoint de divisão de leitura e escrita da rede clássica.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	1AD222E9-E606-4A42-BF6D-8A4442913CEF	ID da solicitação.
TaskId	String	1025486523574	ID da tarefa.
ConnectionString	String	rm-bp1***.mysql.rds.aliyuncs.com	Endpoint usado para conectar-se à instância.

Exemplos

Exemplos de solicitações

http(s)://rds.aliyuncs.com/?Action=ModifyDBInstanceNetworkType
&DBInstanceId=rm-bp1*****************.mysql.rds.aliyuncs.com
&InstanceNetworkType=VPC
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<ModifyDBInstanceNetworkTypeResponse>
    <RequestId>9F0F1B7B-ED7A-5767-ADA5-46F31121E1D4</RequestId>
    <ConnectionString>rm-bp1*****************.mysql.rds.aliyuncs.com</ConnectionString>
</ModifyDBInstanceNetworkTypeResponse>

Formato JSON

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

{
  "RequestId" : "9F0F1B7B-ED7A-5767-ADA5-46F31121E1D4",
  "ConnectionString" : "rm-bp1*****************.mysql.rds.aliyuncs.com"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	NetTypeExists	Specified network type already exists.	Erro retornado porque o tipo de rede especificado é igual ao tipo de rede original da instância.
400	VswitchIpExhausted	Vswitch IP exhausted.	Erro retornado porque os endereços IP do vSwitch estão esgotados.
400	OperationDenied.Switch	The specified instance must not be switched to VPC.	Erro retornado porque a instância não oferece suporte a esta operação.
400	OperationDenied.DBInstanceNetType	Operation is denied by the network type of current database instance.	Erro retornado porque o tipo de rede da instância primária não oferece suporte a esta operação.
400	OperationDenied.DBInstanceStatus	Operation is denied by the current database instance status.	Erro retornado porque a operação não tem suporte no estado atual da instância.
403	OperationDenied.DBInstanceConnType	The current DB instance connection type does not support this operation.	Erro retornado porque o tipo de conexão de rede atual não oferece suporte a esta operação.

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