Todos os produtos
Search
Central de documentação

ApsaraDB RDS:UpdateDBInstanceReplication

Última atualização: Jul 07, 2026

Atualiza o canal de replicação de uma instância de replicação nativa.

Descrição da operação

Motor suportado

RDS MySQL

Documentação relacionada

Importante Antes de chamar esta operação, leia a documentação relacionada para entender seus pré-requisitos e efeitos.
Instância de replicação nativa do RDS MySQL

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

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Sintaxe da solicitação

POST  HTTP/1.1

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

RegionId

string

Sim

O ID da região.

cn-hangzhou

DbInstanceId

string

Sim

O ID da instância.

rm-bp1234567890abcdef

ChannelName

string

Não

O nome do canal de replicação.

replication-channel-001

MasterHost

string

Não

O endereço do host do banco de dados master. Você pode especificar um endereço IP ou um nome de domínio.

192.168.1.100

MasterPort

integer

Não

O número da porta do banco de dados master. A porta típica para MySQL é 3306.

3306

MasterUser

string

Não

O nome de usuário do usuário de replicação no banco de dados master. Especifique este parâmetro somente se precisar atualizá-lo.

repl_user

MasterPassword

string

Não

A senha do usuário de replicação no banco de dados master. A senha deve ser codificada em Base64.

U2VjdXJlUGFzczEyMyE=

Operation

string

Sim

A operação a ser executada no canal de replicação.

Start

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

O objeto de resposta.

RequestId

string

O ID da solicitação.

17F57FEE-EA4F-4337-8D2E-9C23CAA63D74

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "17F57FEE-EA4F-4337-8D2E-9C23CAA63D74"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 InvalidReplicationChannelName.Forbid Specified replication channel name is forbidden (reserved for internal use). A tarefa de replicação especificada é apenas para uso interno.
400 InvalidReplicationChannel.Duplicate Specified replication channel already exists. A tarefa de replicação especificada já existe.
400 MissingReplicationParam Missing required parameters for replication operation: MasterHost, MasterPort, MasterUser, MasterPassword. Os parâmetros obrigatórios relacionados à replicação estão ausentes.
400 MissingOperationParam Missing required parameter: Operation. Falha ao atualizar a tarefa de replicação para a instância de replicação nativa: o parâmetro Operation está ausente.
400 InvalidOperation.NotSupport Specified operation is not supported. Supported operations: Stop, Start, Restart, Rebuild. O parâmetro Operation especificado não é suportado.
400 InvalidMasterPort.Format Specified MasterPort format is not valid. O parâmetro MasterPort especificado é inválido.
400 MissingRebuildParam Missing required parameters for rebuild operation: MasterHost, MasterPort, MasterUser, MasterPassword. A operação de reconstrução da tarefa de replicação não possui os parâmetros obrigatórios: nome de domínio de origem, porta de origem, usuário de origem ou senha de origem.
404 InvalidReplicationChannel.NotFound Specified replication channel does not exist. A tarefa de replicação especificada não existe.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.