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
- 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
- Normal
- Anormal
Para mais detalhes, consulte Códigos de status.
Código de erro
Para mais detalhes, consulte Códigos de erro.