Todos os produtos
Search
Central de documentação

Cloud Backup:UpdatePolicyV2

Última atualização: Aug 21, 2026

Modifica uma política.

Descrição da operação

As modificações em uma política entram em vigor em todas as fontes de dados associadas. Proceda com cautela.

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.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

PolicyId

string

Não

O ID da política.

po-000************viy

PolicyName

string

Não

O nome da política.

Backup diário + redundância geográfica

PolicyDescription

string

Não

A descrição da política.

Faça backup uma vez por dia às 10:00, com backup entre regiões para Xangai

Rules

array<object>

Não

A lista de regras da política.

array<object>

Não

A regra da política.

RuleId

string

Não

O ID da regra.

rule-000************rof

RuleType

string

Não

O tipo de regra. Cada política deve ter pelo menos uma regra BACKUP e exatamente uma regra TRANSITION. Valores válidos:

  • BACKUP: regra de backup.

  • TRANSITION: regra de ciclo de vida.

  • REPLICATION: regra de replicação.

BACKUP

Schedule

string

Não

Este parâmetro é necessário apenas quando RuleType está definido como BACKUP. As configurações de agendamento de backup. Formatos suportados:

  • I|{startTime}|{interval}: especifica que um trabalho de backup é executado no {interval} a partir do {startTime}. Exemplo: I|1631685600|P1D especifica que um trabalho de backup é executado uma vez por dia a partir de 2021-09-15 14:00:00.

    • startTime: a hora de início do backup. Este valor é um timestamp UNIX. Unidade: segundos.

    • interval: o intervalo de tempo ISO 8601. Exemplo: PT1H especifica um intervalo de uma hora. P1D especifica um intervalo de um dia.

  • C|{startTime}|{crontab}: especifica que um trabalho de backup é executado com base na expressão {crontab} a partir do {startTime}. Exemplo: C|1631685600|0 0 2 ? * 3,5,7 especifica que um trabalho de backup é executado às 02:00:00 de cada terça, quinta e sábado a partir de 2021-09-15 14:00:00.

    • startTime: a hora de início do backup. Este valor é um timestamp UNIX. Unidade: segundos.

    • crontab: a expressão crontab. Exemplo: 0 0 2 ? * 3,5,7 especifica cada terça, quinta e sábado às 02:00:00.

Trabalhos de backup para períodos de tempo decorridos não são compensados. Se o trabalho de backup anterior não for concluído, o próximo trabalho de backup não será acionado.

I|1648647166|P1D

BackupType

string

Não

Este parâmetro é necessário apenas quando RuleType está definido como BACKUP. O tipo de backup. Defina o valor como COMPLETE, que indica backup completo.

COMPLETE

Retention

integer

Não

Este parâmetro é necessário apenas quando RuleType está definido como TRANSITION ou REPLICATION.

  • Se RuleType estiver definido como TRANSITION: o período de retenção do backup. Valor mínimo: 1. Unidade: dias.

  • Se RuleType estiver definido como REPLICATION: o período de retenção do backup entre regiões. Valor mínimo: 1. Unidade: dias.

7

ReplicationRegionId

string

Não

Este parâmetro é necessário apenas quando RuleType está definido como REPLICATION. O ID da região de destino para replicação.

cn-shanghai

ArchiveDays

integer

Não

Este parâmetro é necessário apenas quando RuleType está definido como TRANSITION. O número de dias após os quais o backup é convertido para armazenamento de arquivamento. Unidade: dias.

90

ColdArchiveDays

integer

Não

Este parâmetro é necessário apenas quando RuleType está definido como TRANSITION. O número de dias após os quais o backup é convertido para armazenamento de arquivamento frio. Unidade: dias.

365

VaultId

string

Não

Este parâmetro é necessário apenas quando RuleType está definido como BACKUP. O ID do cofre de backup.

v-0001************aseg

RetentionRules

array<object>

Não

Este parâmetro é necessário apenas quando RuleType está definido como TRANSITION. As regras de retenção especiais.

object

Não

A regra de retenção especial.

AdvancedRetentionType

string

Não

O tipo da regra de retenção especial. Valores válidos:

  • WEEKLY: backup semanal.

  • MONTHLY: backup mensal.

  • YEARLY: backup anual.

YEARLY

WhichSnapshot

integer

Não

O backup ao qual a regra se aplica. Atualmente, apenas o primeiro backup é suportado. Defina o valor como 1.

1

Retention

integer

Não

O período de retenção especial do backup. Valor mínimo: 1. Unidade: dias.

365

KeepLatestSnapshots

integer

Não

Especifica se deve ser retida pelo menos uma versão de backup. Valores válidos:

  • 0: não reter.

  • 1: reter.

1

DataSourceFilters

array<object>

Não

Este parâmetro é necessário apenas quando RuleType está definido como TAG. As regras de filtro de fonte de dados.

object

Não

SourceType

string

Não

O tipo de fonte de dados. Valores válidos:

  • UDM_ECS: backup de instância ECS. Este tipo de fonte de dados é suportado apenas quando RuleType está definido como UDM_ECS_ONLY.

  • OSS: backup do OSS. Este tipo de fonte de dados é suportado apenas quando RuleType está definido como STANDARD.

  • NAS: backup do Alibaba Cloud NAS. Este tipo de fonte de dados é suportado apenas quando RuleType está definido como STANDARD.

  • ECS_FILE: ECS File Backup Essential Edition. Este tipo de fonte de dados é suportado apenas quando RuleType está definido como STANDARD.

  • OTS: backup do Tablestore. Este tipo de fonte de dados é suportado apenas quando RuleType está definido como STANDARD.

UDM_ECS

DataSourceIds deprecated

array

Não

Descontinuado.

deprecated

string

Não

Descontinuado.

Deprecated

TagFilters

array<object>

Não

Este parâmetro é necessário apenas quando RuleType está definido como TAG. As regras de filtro de tag de recurso.

object

Não

Key

string

Não

A chave da tag.

env

Value

string

Não

O valor da tag. Um valor vazio indica qualquer valor.

prod

Operator

string

Não

A regra de correspondência de tag. Valores válidos:

  • EQUAL: corresponde tanto à chave da tag quanto ao valor da tag.

  • NOT: corresponde à chave da tag, mas não ao valor da tag.

EQUAL

Immutable

boolean

Não

Este parâmetro é necessário apenas quando PolicyType está definido como UDM_ECS_ONLY e RuleType está definido como SECURITY. Especifica se o bloqueio de backup deve ser ativado.

true

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

UpdatePolicyResponse.

Success

boolean

Indica se a solicitação foi bem-sucedida. Valores válidos:

  • true: A solicitação foi bem-sucedida.

  • false: A solicitação falhou.

true

Code

string

O código de retorno. Um valor de 200 indica sucesso.

200

Message

string

A mensagem retornada. O valor "successful" é retornado para uma solicitação bem-sucedida. Uma mensagem de erro é retornada para uma solicitação com falha.

successful

RequestId

string

O ID da solicitação.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Exemplos

Resposta de sucesso

JSON formato

{
  "Success": true,
  "Code": "200",
  "Message": "successful",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

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.