Migrar uma instância entre zonas - : Central de Documentação do Alibaba Cloud

Chame a operação MigrateToOtherZone para migrar uma instância entre zonas.

Os pré-requisitos para esta operação variam conforme o mecanismo de banco de dados da instância. Para mais informações, consulte os seguintes tópicos:

Nota

Esta operação permite migrar uma instância apenas entre zonas pertencentes à mesma região. Por exemplo, não é possível migrar uma instância de uma zona na região China (Hangzhou) para uma zona na região China (Qingdao).

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 de solicitação

Parameter	Type	Required	Example	Description
Action	String	Yes	MigrateToOtherZone	A operação a ser executada. Defina o valor como MigrateToOtherZone.
DBInstanceId	String	Yes	rm-uf6wjk5xxxxxxxxxx	O ID da instância. Chame a operação DescribeDBInstances para consultar o ID da instância.
VPCId	String	No	vpc-xxxxxxx	O ID da virtual private cloud (VPC) à qual a instância pertence. Não altere a VPC da instância. Especifique este parâmetro quando a instância estiver em uma VPC. Caso a instância execute SQL Server, é possível alterar a VPC da instância.
ZoneId	String	Yes	cn-hangzhou-b	O ID da zona de destino. Chame a operação DescribeRegions para consultar o ID da zona.
EffectiveTime	String	No	Immediate	O momento em que a alteração deve entrar em vigor. Valores válidos: Immediately: A alteração entra em vigor imediatamente. Este é o valor padrão. MaintainTime: A alteração entra em vigor durante a janela de manutenção especificada. Para mais informações, consulte ModifyDBInstanceMaintainTime. ScheduleTime: A alteração entra em vigor no horário especificado por você. Nota Se você definir este parâmetro como ScheduleTime, será necessário especificar o parâmetro SwitchTime.
VSwitchId	String	No	vsw-uf6adz52c2pxxxxxxx	O ID do vSwitch da instância. Especifique este parâmetro quando a instância estiver em uma VPC. Chame a operação DescribeVSwitches para consultar o ID do vSwitch. Se a instância executar PostgreSQL ou SQL Server e tiver uma zona secundária especificada, informe vários IDs de vSwitch, cada um correspondendo a uma zona. Separe os IDs de vSwitch com vírgulas (,).
Category	String	No	HighAvailability	A edição do RDS da instância. Valores válidos: Basic: RDS Basic Edition HighAvailability: RDS High-availability Edition AlwaysOn: RDS Cluster Edition Finance: RDS Enterprise Edition
ZoneIdSlave1	String	No	cn-hangzhou-c	A zona da instância secundária. Nota Especifique este parâmetro quando a instância não executar o RDS Basic Edition.
ZoneIdSlave2	String	No	cn-hangzhou-d	A zona da instância de logger. Nota Especifique este parâmetro apenas quando a instância executar o RDS Enterprise Edition.
SwitchTime	String	No	2021-12-14T15:15:15Z	O horário em que a alteração deve entrar em vigor. Especifique o horário no padrão ISO 8601, no formato aaaa-MM-ddTHH:mm:ssZ. O horário deve estar em UTC. Nota Este parâmetro é usado em conjunto com o parâmetro EffectiveTime. Especifique este parâmetro apenas quando o parâmetro EffectiveTime estiver definido como ScheduleTime.
IsModifySpec	String	No	true	Define se as especificações da instância serão alteradas durante a migração. Valores válidos: true: Altera as especificações da instância durante a migração. Se você definir este parâmetro como true, especifique pelo menos um dos parâmetros DBInstanceClass ou DBInstanceStorage. false: Não altera as especificações da instância durante a migração. Este é o valor padrão. Nota Este parâmetro é válido apenas para instâncias que executam MySQL.
DBInstanceClass	String	No	mysql.x4.xlarge.2	O novo tipo de instância. É possível alterar o tipo da instância, mas não o tipo de armazenamento. Se você definir o parâmetro IsModifySpec como true, especifique pelo menos um dos parâmetros DBInstanceClass ou DBInstanceStorage. Para mais informações sobre tipos de instância, consulte Tipos de instância primária do ApsaraDB RDS for MySQL.
DBInstanceStorage	Long	No	500	A nova capacidade de armazenamento da instância. Se você definir o parâmetro IsModifySpec como true, especifique pelo menos um dos parâmetros DBInstanceStorage ou DBInstanceClass. Unidade: GB. O intervalo de capacidade de armazenamento disponível varia conforme o tipo da instância. Para mais informações, consulte Tipos de instância primária do ApsaraDB RDS for MySQL.

Parâmetros de resposta

Parameter	Type	Example	Description
RequestId	String	65BDA532-28AF-4122-AA39-B382721EEE64	O ID da solicitação.
DBInstanceId	String	rm-uf6wjk5xxxxxxxxxx	O ID da instância.
OrderId	Long	213341575990728	O ID do pedido. Este parâmetro é retornado apenas quando a instância executa MySQL.

Exemplos

Exemplos de solicitações

Exemplos de respostas de sucesso

Formato JSON

HTTP/1.1 200 OK

Códigos de erro

HTTP status code	Error code	Error message	Description
400	RenewChange.Exist	The Current InstanceId existed renewChange order in RDS.	Mensagem de erro retornada porque as especificações da instância estão sendo alteradas. Aguarde a conclusão da alteração e tente novamente.
400	InvalidMigrateModifyClassOrStorage	Specified parameter DBInstanceClass or Storage is invalid.	Mensagem de erro retornada porque o valor do parâmetro DBInstanceClass ou DBInstanceStorage é inválido.
400	EngineNotSupported	Engine specified cannot be supported the operation.	Mensagem de erro retornada porque esta operação não é suportada pelo mecanismo de banco de dados da instância. Atualize a versão secundária do mecanismo da instância e tente novamente.
400	IncorrectDBInstanceLockMode.ValueNotSupported	The Current DB instance lock mode does not support this operation.	Mensagem de erro retornada porque esta operação não é suportada quando a instância está no modo de bloqueio.
400	InvalidZoneId.NotNull	The parameter ZoneId must not be null or auto	Mensagem de erro retornada porque o valor do parâmetro ZoneId é nulo ou auto.
400	InvalidZoneId.NotEqual	The parameter ZoneId is the same as the previous one	Mensagem de erro retornada porque a zona de destino é igual à zona de origem.
400	IncorrectDBInstanceType	Current DB instance type does not support this operation.	Mensagem de erro retornada porque esta operação não é suportada no estado atual da instância.
400	InsufficientResourceCapacityCheck	There is insufficient capacity available for the requested instance with precheck.	Mensagem de erro retornada porque a instância especificada não possui armazenamento suficiente e falhou na execução simulada.
400	SSLInstanceNotSupportThisOperation	The instance opened SSL, upgrade is not this operation	Mensagem de erro retornada porque esta operação não é suportada para uma instância com o recurso de criptografia SSL ativado.
400	BYOLInstanceNotSupportThisOperation	The BYOL instance is not supported this operation	Mensagem de erro retornada porque esta operação não é suportada para uma instância que usa Bring Your Own License (BYOL).
400	BYOKInstanceNotSupportThisOperation	The BYOK instance is not supported this operation	Mensagem de erro retornada porque a operação não é suportada para uma instância com criptografia de disco ativada.
400	ADInstanceNotSupportThisOperation	The AD instance is not supported this operation	Mensagem de erro retornada porque esta operação não é suportada para uma instância adicionada a um domínio Active Directory (AD).
400	TDEInstanceNotSupportThisOperation	The instance opened TDE, this operation is not supported	Mensagem de erro retornada porque esta operação não é suportada para uma instância com o recurso Transparent Data Encryption (TDE) ativado.
400	InstanceIsSnapshotBackupNotSupportThisOperation	The instance backup method is snapshot backup, this operation is not supported	Mensagem de erro retornada porque esta operação não é suportada para uma instância com o recurso de backup via snapshot ativado.
400	InstanceHasReadOnlyInstanceNotSupportThisOperation	The instance has read-only instance or is read-only instance, this operation is not supported	Mensagem de erro retornada porque esta operação não é suportada para uma instância somente leitura ou para uma instância à qual instâncias somente leitura estão anexadas.
400	VswitchIpExhausted	No available ip in the specified vswitch.	Mensagem de erro retornada porque o vSwitch especificado não possui endereços IP disponíveis.
400	OperationDenied.MasterDBInstanceState	The operation is not permitted due to status of master instance.	Mensagem de erro retornada porque a configuração da instância somente leitura está sendo alterada. Nesse caso, não é possível executar esta operação na instância primária. Aguarde a conclusão da alteração na instância somente leitura e tente novamente.
400	InvalidShareInstance.NotSupport	The share dbInstance is not support.	Mensagem de erro retornada porque instâncias compartilhadas não são suportadas.
400	InvalidZoneIdSlave1.Missing	The parameter ZoneIdSlave1 must be specified.	Mensagem de erro retornada porque o ID da zona da instância secundária está vazio.
400	MigrateAlreadyExistsFault	The rds instance already has a given vpc migrate task.	Mensagem de erro retornada porque já existe uma tarefa de migração de VPC criada para a instância.
400	InvalidInstanceKind.NotSupport	The instance kind does not support this operation.	Mensagem de erro retornada porque esta operação não é suportada pela configuração da instância.
400	MissingCategory	The instance is missing a category parameter.	Mensagem de erro retornada porque o parâmetro Category não foi especificado para a instância.
400	InvalidInstanceNodeType.NotFound	The specified NodeType is not found.	Mensagem de erro retornada porque o parâmetro NodeType não foi especificado. Especifique o parâmetro.
400	EngineVersionNotSupported	EngineVersion specified cannot be replicate with the source DB Instance.	Mensagem de erro retornada porque a versão do mecanismo de banco de dados não suporta a clonagem de instâncias.
400	CommodityCodeNotFound	CommodityCodeNotFound	Mensagem de erro retornada porque o valor do parâmetro CommodityCode é inválido. Insira um valor válido e tente novamente.
403	OperationDenied.OutofUsage	The resource is out of usage.	Mensagem de erro retornada porque a zona especificada não oferece recursos suficientes. Selecione outra zona.
403	IncorrectEffectiveTime	The specified EffectiveTime params is not valid.	Mensagem de erro retornada porque o valor do parâmetro EffectiveTime é inválido.
403	InvalidTempInstance.NotSupport	The temp db Instance is not support.	Mensagem de erro retornada porque a instância está bloqueada.
403	OperationDenied.LockMode	The operation is not permitted due to instance being locked.	Mensagem de erro retornada porque esta operação não é suportada quando a instância está bloqueada. Verifique se a capacidade de armazenamento da instância foi esgotada ou se a instância expirou. Se o armazenamento estiver esgotado, altere as especificações da instância para expandir a capacidade, aguarde o desbloqueio e tente novamente. Se a instância tiver expirado, renove-a, aguarde o desbloqueio e tente novamente.
403	ClassicNetworkType.NotSupport	The Classic instance network create is not support.	Mensagem de erro retornada porque não é possível criar instâncias do tipo de rede clássica. Crie uma instância de outro tipo de rede.
403	InstanceNetworkTypeNotFoundFault	The specified DBInstanceNetworkType is not found.	Mensagem de erro retornada porque a instância falhou na verificação do tipo de rede. O tipo de rede da instância não existe.
403	ProprietaryCloud.NotSupported	The proprietary cloud not supported.	Mensagem de erro retornada porque o Apsara Stack não é suportado.
403	MigrateAlreadyReadWriteSplitExistsFault	The rds instance already has a given vpc migrate task.	Mensagem de erro retornada porque já existe uma tarefa de migração de VPC criada para a instância.
403	InvalidRegionAvzNotFound	Specified user does not find the region and avz.	Mensagem de erro retornada porque o usuário especificado não consegue encontrar a região ou a zona da instância.
403	ZoneIdNotSupported	The zone ID is not supported.	Mensagem de erro retornada porque a zona especificada pelo parâmetro ZoneId não é suportada.
403	InvalidVpcInfo.NotFound	Specified VPC info does not exist.	Mensagem de erro retornada porque a VPC especificada não existe.
404	InvalidDBInstanceName.NotFound	The database instance does not exist.	Mensagem de erro retornada porque o nome da instância não foi encontrado. Verifique se o nome está correto.
404	IncorrectVswitchId	The specified parameter VSwitchId is not valid.	Mensagem de erro retornada porque o valor do parâmetro VSwitchId é inválido.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.