Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda> Relational Database Service> Referência de API> API v3 (recomendada)> Gerenciamento de instâncias de banco de dados> Alteração de uma instância de banco de dados única para instâncias de banco de dados primárias/em espera

Atualizado em 2023-05-05 GMT+08:00

Ver PDF

Alteração de uma instância de banco de dados única para instâncias de banco de dados primárias/em espera

Função

Esta API é usada para alterar uma única instância de banco de dados para instâncias de banco de dados primárias/em espera.

Antes de chamar uma API, você precisa entender a API em Autenticação.

Restrições

Instâncias de banco de dados únicas com determinadas especificações não podem ser alteradas para instâncias de banco de dados primárias/em espera.
As instâncias de banco de dados únicas do SQL Server que são cobradas anualmente/mensalmente e são criadas em uma DeC, não podem ser alteradas para instâncias de banco de dados primárias/em espera.

URI

Formato de URI
POST /v3/{project_id}/instances/{instance_id}/action

Descrição do parâmetro

**Tabela 1** Descrição do parâmetro
Nome	Obrigatório	Descrição
project_id	Sim	Especifica o ID do projeto de um locatário em uma região. Para obter detalhes sobre como obter o ID do projeto, consulte Obtenção de um ID de projeto.
instance_id	Sim	Especifica o ID da instância de banco de dados.

Solicitação

Descrição do parâmetro

**Tabela 2** Descrição do parâmetro
Nome	Obrigatório	Tipo	Descrição
single_to_ha	Sim	Object	Para mais detalhes, consulte Tabela 3.

**Tabela 3** Descrição da estrutura de dados do campo single_to_ha
Nome	Obrigatório	Tipo	Descrição
az_code_new_node	Sim	String	Especifica o código da AZ do nó da instância de banco de dados.
is_auto_pay	Não	Boolean	Especifica se o pedido será pago automaticamente. Este parâmetro só pode ser especificado quando o tipo de instância é alterado de única para primária/em espera. true: indica que o pedido será pago automaticamente. false (configuração padrão): indica que o pedido será pago manualmente.
ad_domain_info	Não	Object	Especifica informações de domínio do AD. Este parâmetro é obrigatório somente quando uma única instância configurada com o domínio do AD está sendo alterada para uma instância primária/em espera. Este parâmetro está disponível somente para o RDS for SQL Server. Para obter detalhes sobre a estrutura de campo, consulte Tabela 4.

**Tabela 4** Descrição da estrutura de dados do campo ADDomainInfo
Nome	Obrigatório	Tipo	Descrição
domain_admin_account_name	Sim	String	Nome da conta de administrador do domínio.
domain_admin_pwd	Sim	String	Senha do administrador do domínio.

Exemplo
POST https://rds.ap-southeast-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/action

Exemplo de solicitação

Alteração do tipo de instância de única para primária/em espera para instâncias de banco de dados do MySQL ou PostgreSQL cobradas na base de pagamento por uso:

{
	"single_to_ha": {
		"az_code_new_node": "az2xahz"
	}
}

Alteração do tipo de instância de única para primária/em espera para instâncias de banco de dados do MySQL ou PostgreSQL cobradas anualmente/mensalmente:

{
         "single_to_ha": {
                   "az_code_new_node": "az1xahz",
                   "is_auto_pay": true
         }
}

Alteração do tipo de instância de única para primária/em espera para instâncias de banco de dados do Microsoft SQL Server cobradas na base de pagamento por uso:

{
    "single_to_ha": {
        "az_code_new_node": "az2xahz",
        "ad_domain_info": {
            "dns_server_ip": "192.168.0.1",
            "domain_admin_account_name": "Administrator",
            "domain_admin_pwd": "password@123",
            "dc_domain_name": "test.com"
        }
    }
}

Alteração do tipo de instância de única para primária/em espera para instâncias de banco de dados do Microsoft SQL Server cobradas anualmente/mensalmente:

{
    "single_to_ha": {
        "az_code_new_node": "az2xahz",
        "is_auto_pay": true, 
        "ad_domain_info": {
            "dns_server_ip": "192.168.0.1",
            "domain_admin_account_name": "Administrator",
            "domain_admin_pwd": "password@123",
            "dc_domain_name": "test.com"
        }
    }
}

Resposta

Instâncias de banco de dados de pagamento por uso

Resposta normal

**Tabela 5** Descrição do parâmetro
Nome	Tipo	Descrição
job_id	String	Indica o ID do trabalho.

Exemplo de resposta normal

{
	"job_id": "2b414788a6004883a02390e2eb0ea227"
}

Resposta anormal
Para mais detalhes, consulte Resultados anormais da solicitação.

Instâncias de banco de dados anuais/mensais

Resposta normal

**Tabela 6** Descrição do parâmetro
Nome	Tipo	Descrição
order_id	String	Indica o ID do pedido.

Exemplo de resposta normal
```
{
	"order_id": "CS2009151216NO2U2"
}
```
Resposta anormal
Para mais detalhes, consulte Resultados anormais da solicitação.