UpdatePolicyV2 - Cloud Backup: Central de Documentação do Alibaba Cloud

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

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

hbr:UpdatePolicyV2

update

*Todos os recursos.

*

Nenhuma

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.	Daily backup + cross-region backup
PolicyDescription	string	Não	A descrição da política.	Backs up data once a day at 10:00 AM, with cross-region backup to Shanghai.
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 conter 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 é obrigatório apenas quando RuleType é definido como BACKUP. O agendamento de backup. Formatos válidos: `I\|{startTime}\|{interval}`: executa um trabalho de backup em um intervalo de {interval} a partir de {startTime}. Por exemplo, `I\|1631685600\|P1D` indica que um backup é realizado todos os dias a partir de 15-09-2021 14:00:00. startTime: a hora de início do backup. É um carimbo de data/hora UNIX em segundos. interval: o intervalo de tempo ISO 8601. Por exemplo, `PT1H` indica um intervalo de uma hora e `P1D` indica um intervalo de um dia. `C\|{startTime}\|{crontab}`: executa um trabalho de backup com base na expressão {crontab} a partir de {startTime}. Por exemplo, `C\|1631685600\|0 0 2 ? * 3,5,7` indica que um backup é realizado às 02:00:00 de cada terça, quinta e sábado a partir de 15-09-2021 14:00:00. startTime: a hora de início do backup. É um carimbo de data/hora UNIX em segundos. crontab: a expressão crontab. Por exemplo, `0 0 2 ? * 3,5,7` indica 02:00:00 de cada terça, quinta e sábado. Os trabalhos de backup perdidos 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 é obrigatório apenas quando RuleType é definido como BACKUP. O tipo de backup. O valor COMPLETE indica um backup completo.	COMPLETE
Retention	integer	Não	Este parâmetro é obrigatório apenas quando RuleType é definido como TRANSITION ou REPLICATION. Se RuleType for definido como TRANSITION: o período de retenção dos backups. O valor mínimo é 1, em dias. Se RuleType for definido como REPLICATION: o período de retenção para backups entre regiões. O valor mínimo é 1, em dias.	7
ReplicationRegionId	string	Não	Este parâmetro é obrigatório apenas quando RuleType é definido como REPLICATION. O ID da região de destino para replicação.	cn-shanghai
ArchiveDays	integer	Não	Este parâmetro é obrigatório apenas quando RuleType é definido como TRANSITION. O número de dias após o qual os backups são transferidos para o armazenamento de arquivamento.	90
ColdArchiveDays	integer	Não	Este parâmetro é obrigatório apenas quando RuleType é definido como TRANSITION. O número de dias após o qual os backups são transferidos para o armazenamento de arquivamento frio.	365
VaultId	string	Não	Este parâmetro é obrigatório apenas quando RuleType é definido como BACKUP. O ID do cofre de backup.	v-0001************aseg
RetentionRules	array<object>	Não	Este parâmetro é obrigatório apenas quando RuleType é definido como TRANSITION. As regras especiais de retenção.
	object	Não	A regra especial de retenção.
AdvancedRetentionType	string	Não	O tipo da regra especial de retenção. Valores válidos: WEEKLY: backup semanal MONTHLY: backup mensal YEARLY: backup anual	YEARLY
WhichSnapshot	integer	Não	O número de sequência do snapshot ao qual a regra se aplica. Atualmente, apenas o primeiro snapshot é suportado. Defina o valor como 1.	1
Retention	integer	Não	O período especial de retenção do backup. O valor mínimo é 1, em 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 é obrigatório apenas quando RuleType é definido como TAG. As regras de filtragem de fonte de dados.
	array<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 é definido como UDM_ECS_ONLY. OSS: backup do OSS. Este tipo de fonte de dados é suportado apenas quando RuleType é definido como STANDARD. NAS: backup do NAS. Este tipo de fonte de dados é suportado apenas quando RuleType é definido como STANDARD. ECS_FILE: ECS File Backup Standard Edition. Este tipo de fonte de dados é suportado apenas quando RuleType é definido como STANDARD. OTS: backup do Tablestore. Este tipo de fonte de dados é suportado apenas quando RuleType é definido como STANDARD.	UDM_ECS
DataSourceIds `deprecated`	array	Não	[Deprecated] Este parâmetro foi descontinuado.
`deprecated`	string	Não	[Deprecated] Este parâmetro foi descontinuado.	Deprecated
AccountScope	string	Não	O escopo de contas ao qual a política se aplica.	SPECIFIED_ACCOUNT
Accounts	array<object>	Não	A lista de informações de conta nas condições de filtragem da fonte de dados.
	object	Não
CrossAccountType	string	Não	O tipo de associação de conta, que é usado para distinguir entre a conta atual e cenários de contas cruzadas.	CROSS_ACCOUNT_BY_RD
CrossAccountUserId	integer	Não	O ID da conta Alibaba Cloud da conta que possui os recursos a serem submetidos a backup.	1234567890123456
CrossAccountRoleName	string	Não	O nome da função RAM criada na conta que possui os recursos a serem submetidos a backup.	hbrcrossrole
TagFilters	array<object>	Não	Este parâmetro é obrigatório apenas quando RuleType é definido como TAG. As regras de filtragem de tags 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 tags. 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 é obrigatório apenas quando PolicyType é definido como UDM_ECS_ONLY e RuleType é 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. O valor 200 indica sucesso.	200
Message	string	A mensagem de retorno. Se a solicitação for bem-sucedida, "successful" será retornado. Se ocorrer um erro, a mensagem de erro correspondente será retornada.	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.