Todos os produtos
Search
Central de documentação

ApsaraDB for MongoDB:MigrateAvailableZone

Última atualização: Oct 12, 2026

Migra a zona de uma instância do MongoDB.

Descrição da operação

  • A operação MigrateAvailableZone não oferece suporte a instâncias standalone. É aplicável a instâncias ativas de disco em nuvem e instâncias de disco local.

  • O recurso de criptografia transparente de dados (TDE) não está ativado para a instância.

  • A zona de destino e a zona atual da instância estão na mesma região.

  • Se a instância estiver implantada em uma VPC, certifique-se de que um vSwitch foi criado na zona de destino antes de migrar a zona. Para obter mais informações, consulte Criar um vSwitch.

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 Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

DBInstanceId

string

Sim

O ID da instância.

Nota

Se o tipo de rede da instância for VPC, você também deve especificar o parâmetro Vswitch.

dds-bp1ece71ff2f****

ZoneId

string

Sim

O ID da zona de destino.

Nota
  • A zona de destino e a zona atual da instância estão na mesma região.

  • Você pode chamar a operação DescribeRegions para consultar os IDs das zonas.

cn-hangzhou-b

Vswitch

string

Não

O ID do vSwitch na zona de destino.

Nota

Este parâmetro é obrigatório quando o tipo de rede da instância é VPC.

vsw-bp1buy0h9myt5i9e7****

EffectiveTime

string

Não

O horário de entrada em vigor para a migração da zona. A instância deve estar ativa. Valores válidos:

  • Immediately: Entra em vigor imediatamente.

  • MaintainTime: Entra em vigor 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 1.

cn-hangzhou-h

HiddenZoneId

string

Não

O ID da zona secundária de destino 2.

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. O tipo de instância especificado não suporta esta operação.
400 IncorrectMasterDBInstanceState The Master instance state does not support this operation.
400 NetworkTypeNotSupport The network type does not support this operation. Este tipo de rede não suporta esta operação.
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. O parâmetro VSwitchId não pode estar vazio quando a instância atual é uma instância conectada à VPC.
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. A zona de destino não pode ser igual à zona de origem.
400 MigrateDBInstanceError Error in migrating available area or changing your vpc network. Please submit the work order for processing. Ocorreu um erro ao migrar a zona ou alterar a VPC. Abra um ticket.
400 MinorVersionNotSupport Instance's MinorVersion is not supported for this API. Esta API não suporta a MinorVersion da instância.
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.