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/ GaussDB(for MySQL)/ Referência de API/ APIs (recomendadas)/ Gerenciamento de modelo de parâmetro/ Modificação de parâmetros de uma instância de banco de dados especificada
Atualizado em 2024-09-29 GMT+08:00

Modificação de parâmetros de uma instância de banco de dados especificada

Função

Essa API é usada para modificar parâmetros de uma instância de banco de dados especificada. Antes de chamar essa API:

URI

PUT /v3/{project_id}/instances/{instance_id}/configurations

Tabela 1 Parâmetros de URI

Parâmetro

Obrigatório

Tipo

Descrição

project_id

Sim

String

ID do projeto de um locatário em uma região.

Para obter esse valor, consulte Obtenção de um ID de projeto.

instance_id

Sim

String

ID da instância, que é compatível com o formato UUID.

Parâmetros de solicitação

Tabela 2 Parâmetros de cabeçalho de solicitação

Parâmetro

Obrigatório

Tipo

Descrição

X-Auth-Token

Sim

String

Token do usuário.

Para obter o valor, chame a API para obtenção de um token de usuário.

Depois que a solicitação é processada, o valor de X-Subject-Token no cabeçalho da mensagem é o valor do token.

X-Language

Não

String

Tipo de linguagem da solicitação. O valor padrão é en-us. Intervalo de valores:

  • en-us
  • zh-cn

Content-Type

Sim

String

Tipo de conteúdo.

Valor: application/json

Tabela 3 Parâmetros do corpo da solicitação

Parâmetro

Obrigatório

Tipo

Descrição

parameter_values

Sim

Map<String,String>

Mapeamento entre nomes de parâmetros e valores de parâmetros. Você pode especificar valores de parâmetro com base em um modelo de parâmetro padrão. Se este parâmetro não for especificado, as informações do parâmetro original serão mantidas.

Parâmetros de resposta

Código de status: 200

Tabela 4 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

job_id

String

ID da tarefa para modificar os parâmetros de uma instância de banco de dados especificada.

restart_required

Boolean

Se a instância precisa ser reinicializada.

  • true: a instância precisa ser reinicializada.
  • false: a instância não precisa ser reinicializada.

Código de status: 400

Tabela 5 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error_code

String

Código de erro.

error_msg

String

Mensagem de erro.

Código de status: 500

Tabela 6 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error_code

String

Código de erro.

error_msg

String

Mensagem de erro.

Exemplo de solicitação

Modificação de parâmetros de uma instância de banco de dados especificada

PUT https://{endpoint}/v3/97b026aa9cc4417888c14c84a1ad9860/instances/3ef58db3986540d19f95151309368d34in07/configurations

{
  "parameter_values" : {
    "max_user_connections" : "100"
  }
}

Exemplo de resposta

Código de status: 200

Bem-sucedido.

{
  "job_id" : "e5d698a9-d8db-47d2-bf75-3c9018f72b6f",
  "restart_required" : false
}

Código de status

Código de status

Descrição

200

Bem-sucedido.

400

Erro do cliente.

500

Erro no servidor.

Código de erro

Para obter detalhes, consulte Códigos de erro.