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.
Atualizado em 2023-05-05 GMT+08:00

Aplicação de um modelo de parâmetro

Função

Esta API é usada para aplicar um modelo de parâmetro a uma ou mais instâncias de banco de dados.

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

Restrições

  • Os seguintes mecanismos de banco de dados são suportados: MySQL, Microsoft SQL Server, e PostgreSQL.

URI

  • Formato de URI

    PUT /v3/{project_id}/configurations/{config_id}/apply

  • Exemplo

    https://rds.ap-southeast-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/configurations/463b4b58-d0e8-4e2b-9560-5dea4552fde9/apply

  • Descrição do parâmetro
    Tabela 1 Descrição do parâmetro

    Nome

    Obrigatório

    Descrição

    project_id

    Sim

    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.

    config_id

    Sim

    ID do modelo de parâmetro.

Solicitação

  • Descrição do parâmetro
    Tabela 2 Descrição do parâmetro

    Nome

    Obrigatório

    Tipo

    Descrição

    instance_ids

    Sim

    Array of strings

    IDs de instância.

  • Exemplo de solicitação
{
	"instance_ids": ["73ea2bf70c73497f89ee0ad4ee008aa2in01", "fe5f5a07539c431181fc78220713aebein01"]
}

Resposta

  • Resposta normal
    Tabela 3 Descrição do parâmetro

    Nome

    Tipo

    Descrição

    configuration_id

    String

    ID do modelo de parâmetro.

    configuration_name

    String

    Nome do modelo de parâmetro.

    apply_results

    Array of objects

    Resultado da aplicação do modelo de parâmetro.

    Para mais detalhes, consulte Tabela 4.

    success

    Boolean

    Se o modelo de parâmetro é aplicado a todas as instâncias de banco de dados solicitadas com sucesso.

    • true: o modelo de parâmetro foi aplicado com sucesso a todas as instâncias de banco de dados solicitadas.
    • false: o modelo de parâmetro falhou ao ser aplicado a uma ou mais instâncias de banco de dados solicitadas.
    Tabela 4 Descrição da estrutura de dados do campo apply_results

    Nome

    Tipo

    Descrição

    instance_id

    String

    ID da instância.

    instance_name

    String

    Nome da instância.

    restart_required

    Boolean

    Se uma reinicialização é necessária.

    • true: uma reinicialização é necessária.
    • false: uma reinicialização não é necessária.

    success

    Boolean

    Se o modelo de parâmetro é aplicado à instância de banco de dados com sucesso.

    • true: a aplicação foi bem sucedida.
    • false: a aplicação falhou.
  • Exemplo de resposta normal
    {
    	"configuration_id": "cf49bbd7d2384878bc3808733c9e9d8bpr01",
    	"configuration_name": "paramsGroup-bcf9",
    	"apply_results": [{
    		"instance_id": "fe5f5a07539c431181fc78220713aebein01",
    		"instance_name": "zyy1",
    		"restart_required": false,
    		"success": false
    	}, {
    		"instance_id": "73ea2bf70c73497f89ee0ad4ee008aa2in01",
    		"instance_name": "zyy2",
    		"restart_required": false,
    		"success": false
    	}],
    	"success": false
    }
  • Resposta anormal

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

Código de status

Código de erro

Para mais detalhes, consulte Códigos de erro.