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/ Visualização do histórico de alterações de parâmetros

Atualizado em 2024-09-29 GMT+08:00

Ver PDF

Visualização do histórico de alterações de parâmetros

Função

Essa API é usada para visualizar o histórico de alterações de parâmetros. Antes de chamar essa API:

Saiba como autorizá-la e autenticá-la.
Obtenha a região e o ponto de extremidade necessários.

URI

GET /v3/{project_id}/configurations/{configuration_id}/modify-history

**Tabela 1** Parâmetros de URI
Parâmetro	Obrigatório	Tipo	Descrição
project_id	Sim	String	ID do projeto de um locatário numa região. Para obter esse valor, consulte Obtenção de um ID de projeto.
configuration_id	Sim	String	ID do modelo de parâmetro. Para obter esse valor, consulte Consulta de detalhes de uma instância de BD. Depois que a solicitação é processada, o valor de configuration_id no corpo da resposta é o valor de configuration_id.

**Tabela 2** Parâmetros de consulta
Parâmetro	Obrigatório	Tipo	Descrição
offset	Não	Integer	Deslocamento do índice. Se offset for definido como N, a consulta de recursos será iniciada a partir da parte N+1 dos dados. O valor é 0 por padrão, indicando que a consulta começa a partir da primeira parte dos dados. O valor não pode ser um número negativo.
limit	Não	Integer	Número de registros a serem consultados. O valor padrão é 100. O valor deve ser um número inteiro positivo. O valor mínimo é 1 e o valor máximo é 100.

Parâmetros de solicitação

**Tabela 3** 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

Parâmetros de resposta

Código de status: 200

**Tabela 4** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
total_count	Integer	Número total de registros.
histories	Array of ParamGroupHistoryResponse objects	Histórico de alterações do modelo de parâmetro.

**Tabela 5** ParamGroupHistoryResponse
Parâmetro	Tipo	Descrição
parameter_name	String	Nome do parâmetro.
old_value	String	Valor do parâmetro anterior.
new_value	String	Novo valor de parâmetro.
update_result	String	Resultado da atualização.
is_applied	Boolean	Se o modelo alterado é aplicado. true: aplicado. false: não aplicado
updated	String	Hora em que o modelo foi modificado. O formato é aaaa-mm-ddThh:mm:ssZ. T é o separador entre o calendário e a notação horária do tempo. Z indica o deslocamento do fuso horário. Por exemplo, se o deslocamento de fuso horário for de uma hora, o valor de Z será +0100.
applied	String	Hora em que o modelo foi aplicado. O formato é aaaa-mm-ddThh:mm:ssZ. T é o separador entre o calendário e a notação horária do tempo. Z indica o deslocamento do fuso horário. Por exemplo, se o deslocamento de fuso horário for de uma hora, o valor de Z será +0100.

Código de status: 400

**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.

Código de status: 500

**Tabela 7** 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

Consulta do histórico de alterações de um modelo de parâmetro

GET https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/configurations/7625c6a12d884be1891c61d921e0e114pr07/modify-history

Exemplo de resposta

Código de status: 200

Bem-sucedido.

{
  "total_count" : 2,
  "histories" : [ {
    "parameter_name" : "binlog_rows_query_log_events",
    "old_value" : false,
    "new_value" : true,
    "update_result" : "SUCCESS",
    "is_applied" : true,
    "updated" : "2023-07-10T02:14:28+0000",
    "applied" : "2023-07-10T02:14:28+0000"
  }, {
    "parameter_name" : "block_encryption_mode",
    "old_value" : "aes-256-cbc",
    "new_value" : "aes-128-cfb1",
    "update_result" : "SUCCESS",
    "is_applied" : true,
    "updated" : "2023-07-10T02:14:28+0000",
    "applied" : "2023-07-10T02:14:28+0000"
  } ]
}