MigrateAvailableZone - ApsaraDB for MongoDB: Central de Documentação do Alibaba Cloud

Migra uma instância do ApsaraDB for MongoDB para uma zona específica.

Descrição da operação

Esta operação está disponível apenas para instâncias de conjunto de réplicas que executam MongoDB 4.2 ou anterior e instâncias de cluster fragmentado.
Se você solicitou um endpoint público para a instância do ApsaraDB for MongoDB, deve chamar a operação ReleasePublicNetworkAddress para liberar o endpoint público antes de chamar a operação MigrateAvailableZone.
A criptografia de dados transparente (TDE) está desativada para a instância do ApsaraDB for MongoDB.
A zona de origem e a zona de destino pertencem à mesma região.
Um vSwitch é criado na zona de destino. Este pré-requisito deve ser atendido se a instância residir em uma nuvem privada virtual (VPC). Para mais informações sobre como criar um vSwitch, consulte Trabalhar com vSwitches.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

dds:MigrateAvailableZone

update

*Instance

acs:dds:{#regionId}:{#accountId}:dbinstance/{#dbinstanceId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
DBInstanceId	string	Sim	O ID da instância. Nota Se a instância estiver implantada em uma VPC, você deve especificar o parâmetro Vswitch.	dds-bp1ece71ff2f****
ZoneId	string	Sim	O ID da zona de destino. Nota A zona de origem e a zona de destino pertencem à mesma região. Você pode chamar a operação DescribeRegions para consultar o ID da zona.	cn-hangzhou-b
Vswitch	string	Não	O ID do vSwitch na zona de destino. Nota Se a instância estiver implantada em uma VPC, você deve especificar este parâmetro.	vsw-bp1buy0h9myt5i9e7****
EffectiveTime	string	Não	O horário em que a instância é migrada para a zona de destino. Valores válidos: Immediately: A instância é migrada imediatamente para a zona de destino. MaintainTime: A instância é migrada para a zona de destino durante a janela de manutenção da instância. Valor padrão: Immediately.	Immediately
SecondaryZoneId	string	Não	O ID da zona secundária de destino.	cn-hangzhou-h
HiddenZoneId	string	Não	O ID da zona oculta de destino.	cn-shanghai-n

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	0FDDC511-7252-4A4A-ADDA-5CB1BF63****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "0FDDC511-7252-4A4A-ADDA-5CB1BF63****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidEffectiveTime.Malformed	Specified EffectiveTime is not valid.
400	InsType.NotSupport	Specified instance type dose not support this operation.	The specified instance type does not support this operation.
400	IncorrectMasterDBInstanceState	The Master instance state does not support this operation.
400	NetworkTypeNotSupport	The network type does not support this operation.	The network type does not support this operation.
400	OperationDenied.LockMode	The operation is not permitted when the instance locked.
400	InvalidIzNo.NotSupported	the Specified vpc Zone not supported.
400	IncorrectVswitchId	The specified parameter 'VSwitchId' is not valid.	When the current instance is a VPC instance, the VSwitchId parameter cannot be empty.
400	InvalidRegion_Zone_NotFound	Specified Region does not exist in RDS.
400	VPCERROR.ALLOCATE_ERROR	Cannot Allocate the require vpcInstances.
400	ProxyError	The request processing has failed due to some unknown error, exception or failure.
400	DbInsertError	Database insert error.
400	UnsupportedDBTdeStatus	Specified DB TDEStatus does not support this operation.
400	InvalidZoneParam	The target zone and source zone cannot be the same.	The destination zone cannot be the same as the original zone.
400	MigrateDBInstanceError	Error in migrating available area or changing your vpc network. Please submit the work order for processing.
400	MinorVersionNotSupport	Instance's MinorVersion is not supported for this API.	This API does not support MinorVersion of instances.
404	InvalidDbInstanceId.NotFound	Specified instance does not exist.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.