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 (indisponível em breve)/ Gerenciamento de backup/ Modificação da política de backup automatizado
Atualizado em 2024-09-29 GMT+08:00
Ver PDF
Compartilhar

Modificação da política de backup automatizado

Função

Essa API é usada para modificar a política de backup automatizado. Antes de chamar essa API:

Essa API estará indisponível em 31 de março de 2024. É aconselhável mudar as cargas de trabalho para a nova API (Modificação de uma política de backup automatizado) antes disso.

URI

  • Formato de URI

    PUT https://{endpoint}/mysql/v3/{project_id}/instances/{instance_id}/backups/policy/update

  • Exemplo

    PUT https://{endpoint}/mysql/v3/97b026aa9cc4417888c14c84a1ad9860/instances/c3ec2c6148ad4d71b1a8411a62df0d3cin07/backups/policy/update

  • Descrição do parâmetro
    Tabela 1 Descrição do parâmetro

    Nome

    Tipo

    Obrigatório

    Descrição

    project_id

    String

    Sim

    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

    String

    Não

    ID da instância de BD.

Solicitação

Tabela 2 Descrição do parâmetro

Nome

Tipo

Obrigatório

Descrição

backup_policy

object

Sim

Informações de política de backup.

Para mais detalhes, consulte Tabela 3.
Tabela 3 Descrição da estrutura de dados do campo backup_policy

Nome

Tipo

Obrigatório

Descrição

keep_days

Integer

Sim

Dias de retenção de backup.

O valor varia de 1 a 732.

start_time

String

Sim

Janela de tempo de backup. Os backups automatizados serão acionados durante a janela de tempo de backup.

O valor não pode ser vazio. Deve ser um valor válido no formato "hh:mm-HH:MM". A hora atual está no formato UTC.

  • O valor de HH deve ser 1 maior que o valor de hh.
  • Os valores de mm e MM devem ser os mesmos e devem ser definidos como 00.

Exemplo de valor:

  • 21:00-22:00

period

String

Sim

Configuração do ciclo de backup. Os dados serão automaticamente copiados nos dias selecionados a cada semana.

Intervalo de valores: o valor é um número separado por vírgulas (,), que indica os dias da semana.

Por exemplo, o valor 1,2,3,4 indica que o período de backup é segunda-feira, terça-feira, quarta-feira e quinta-feira.

retention_num_backup_level1

Integer

Não

Número de backups de nível 1 retidos. O valor padrão é 0. Este parâmetro é obrigatório quando a função de backup de nível 1 está ativada. Este parâmetro não está disponível quando a função de backup de nível 1 está desativada. Valor:

  • 0
  • 1
  • Exemplo de solicitação 
    {
	"backup_policy": {
		"keep_days": 7,
		"start_time": "19:00-20:00",
		"period": "1,2,3,4,5"
	}
}

Resposta

  • Resposta normal
    Tabela 4 Descrição do parâmetro

    Nome

    Tipo

    Descrição

    status

    String

    Status do backup. Valor:

    • BUILDING: modificação em andamento
    • COMPLETED: modificação concluída
    • FAILED: modificação falhou

    instance_id

    String

    ID da instância de BD.

    instance_name

    String

    Nome da instância de BD.
  • Exemplo de resposta normal 
    {
"status": "COMPLETED",
"instance_id": "ef25188419f941309882d2986b2210b9in07",
"instance_name": "gauss-fhc"
}

Código de status

Para mais detalhes, consulte Códigos de status.

Código de erro

Para mais detalhes, consulte Códigos de erro.

Tópico principal: Gerenciamento de backup