Todos os produtos
Search
Central de documentação

:Modifique o período de retenção de logs do SQL Explorer

Última atualização: Jun 26, 2026

Use a operação ModifySQLCollectorRetention para alterar o período de retenção de backup de logs permitido pelo recurso SQL Explorer em uma instância.

O recurso SQL Explorer deve estar ativado na instância.

A instância deve executar o MySQL. Para mais informações, consulte Usar o recurso SQL Explorer e Audit em uma instância ApsaraDB RDS for MySQL.

Nota

Ao reduzir o período de retenção de backup de logs, os arquivos de backup armazenados por um tempo superior ao novo período especificado são excluídos imediatamente.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. Essa ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro Tipo Obrigatório Exemplo Descrição
Action String Sim ModifySQLCollectorRetention

Operação a ser executada. Defina o valor como ModifySQLCollectorRetention.

DBInstanceId String Sim rm-uf6wjk5xxxxxxx

ID da instância.

ConfigValue String Sim 365

Período de retenção de backup de logs permitido pelo recurso SQL Explorer na instância. Valores válidos:

  • 30: 30 dias
  • 180: 180 dias
  • 365: um ano
  • 1095: três anos
  • 1825: cinco anos
ResourceGroupId String Não rg-acfmyxxxx

ID do grupo de recursos.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

21383BB3-3845-4628-B422-B4FB5C83DEBD

ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://rds.aliyuncs.com/?Action=ModifySQLCollectorRetention
&DBInstanceId=rm-uf6wjk5xxxxxxx
&ConfigValue=365
&ResourceGroupId=rg-acfmyxxxx
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifySQLCollectorRetentionResponse>
    <RequestId>21383BB3-3845-4628-B422-B4FB5C83DEBD</RequestId>
</ModifySQLCollectorRetentionResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "21383BB3-3845-4628-B422-B4FB5C83DEBD"
}

Códigos de erro

HttpCode

Código de erro

Mensagem de erro

Descrição

400

InvalidConfigValue

The ConfigValue is not valid.

Retorna essa mensagem quando a configuração do parâmetro especificado é inválida.

400

IncorrectSQLLogActiveStatus

Current DB instance SQL log active status does not support this operation.

Retorna essa mensagem quando o recurso SQL Explorer está desativado e não permite a operação.

400

InvalidSqlRetention.Malformed

Specified sql retention is not valid.

Retorna essa mensagem quando o período de retenção de logs especificado é inválido.

400

IncorrectSQLLogVersion

Current DB instance SQL log version does not support this operation.

Retorna essa mensagem quando a versão do SQL Explorer da instância atual não oferece suporte à operação.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.