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 em um modelo de parâmetro
Atualizado em 2024-09-29 GMT+08:00
Ver PDF
Compartilhar

Modificação de parâmetros em um modelo de parâmetro

Função

Essa API é usada para modificar parâmetros em um modelo de parâmetro especificado, incluindo nomes, descrições e valores de parâmetros. Antes de chamar essa API:

Restrições

  • Esta API está disponível apenas para instâncias primárias/em espera (edição dedicada) do GaussDB(for MySQL).
  • Os modelos de parâmetros padrão não podem ser modificados.
  • O nome do modelo de parâmetro modificado deve ser diferente do nome de um modelo de parâmetro padrão.
  • Os valores dos parâmetros a serem modificados devem estar dentro do intervalo de valores padrão da versão do banco de dados especificada.

URI

PUT /v3/{project_id}/configurations/{configuration_id}

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.

configuration_id

Sim

String

ID do modelo de parâmetro.

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.

Se o corpo de resposta a seguir for retornado para chamar a API usada para obter um token de usuário, a solicitação será bem-sucedida.

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.

Valor:

  • en-us
  • zh-cn
Tabela 3 Parâmetros do corpo da solicitação

Parâmetro

Obrigatório

Tipo

Descrição

name

Não

String

Nome do modelo de parâmetro.

Valor:

O nome do modelo pode conter de 1 a 64 caracteres. Somente letras (diferenciam maiúsculas de minúsculas), dígitos, hifens (-), sublinhados (_) e pontos (.) são permitidos.

A descrição do modelo de parâmetro, o nome do parâmetro e o mapeamento do valor do parâmetro não podem estar vazios ao mesmo tempo.

description

Não

String

Descrição do modelo de parâmetro. O valor é deixado em branco por padrão.

Valor:

A descrição pode conter até 256 caracteres e não pode conter os caracteres de retorno de carro ou caracteres especiais (!<"='>&).

parameter_values

Não

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 o modelo de parâmetro.

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 em um modelo de parâmetro

PUT https://{endpoint}/v3/0549b4a43100d4f32f51c01c2fe4acdb/configurations/7a8d539ba30f43adaf1b16d08b1df4bdpr07
{
  "parameter_values" : {
    "max_user_connections" : "4"
  }
}

Exemplo de resposta

Código de status: 200

Bem-sucedido.

{
  "job_id" : "f6cb21fe-186a-4931-b20d-764ced1f1f6b"
}

Código de status

Para mais detalhes, consulte Códigos de status.

Código de erro

Para mais detalhes, consulte Códigos de erro.