Todos os produtos
Search
Central de documentação

Hologres:UpdateScheduledBackupConfig

Última atualização: Jun 28, 2026

Configura uma política de backup para uma instância. Você pode definir uma programação semanal para realizar o backup de uma instância em dias específicos, como toda segunda, quarta e sexta-feira às 20:00:00. Você também pode especificar o número de backups concluídos a serem retidos. O sistema exclui automaticamente os backups expirados.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Sintaxe da solicitação

POST /api/v1/backups/scheduledConfig HTTP/1.1

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

RegionId

string

Não

O ID da região.

cn-beijing

body

object

Não

O corpo da solicitação.

instanceId

string

Não

O ID da instância.

hgprecn-cn-zvp25ysxxxx

enabled

boolean

Não

Especifica se os backups agendados devem ser ativados. Defina este parâmetro como true para ativar os backups agendados ou false para desativá-los.

true

week

string

Não

Especifica os dias da semana em que o backup deve ser realizado. Separe vários dias com vírgulas. Por exemplo, para realizar backups na segunda, quarta e sexta-feira, defina este parâmetro como 1,3,5.

1,3,5

hour

integer

Não

A hora de início do backup. Este horário de início se aplica a todos os dias especificados. Por exemplo, se você definir week como 1,3,5 e hour como 20, um backup será iniciado às 20:00:00 toda segunda, quarta e sexta-feira.

20

dataKeepQuantity

integer

Não

O número de backups agendados a serem retidos. Por exemplo, se você definir este parâmetro como 3, o sistema reterá os três backups mais recentes e excluirá automaticamente os mais antigos.

3

dstRegion

string

Não

A região de destino para o backup. Este parâmetro se aplica apenas a backups remotos e permite a recuperação de desastres entre regiões. Por exemplo, você pode fazer backup de uma instância da China (Hangzhou) para a China (Beijing).

cn-beijing

zoneId

string

Não

A zona de disponibilidade de destino para o backup. Este parâmetro se aplica apenas a backups remotos.

cn-beijing-i

manualDataKeepQuantity

integer

Não

O número de backups manuais a serem retidos. Os backups manuais e automáticos são armazenados separadamente e possuem políticas de retenção independentes.

3

scheduleType

string

Não

O tipo de backup. Este parâmetro é obrigatório apenas para backups remotos.

Valores válidos:

  • periodical :

    Backup agendado.

  • remote :

    Backup remoto.

remote

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Os dados retornados pela operação.

RequestId

string

O ID da solicitação.

69221013-D303-5046-91A7-A0BE2BC2E7D7

Data

boolean

Indica se a configuração foi bem-sucedida. Um valor true indica sucesso e false indica falha.

True

Success

boolean

Indica se a solicitação foi bem-sucedida.

True

ErrorCode

string

O código de erro retornado se a solicitação falhar.

null

ErrorMessage

string

A mensagem de erro retornada se a solicitação falhar.

null

HttpStatusCode

string

O código de status HTTP.

200

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "69221013-D303-5046-91A7-A0BE2BC2E7D7",
  "Data": true,
  "Success": true,
  "ErrorCode": "null",
  "ErrorMessage": "null",
  "HttpStatusCode": "200"
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.