全部产品
Search
文档中心

混合云备份 HBR:UpdatePolicyV2 - 修改策略

更新时间:Mar 17, 2023

修改一个策略。

接口说明

策略的修改,将对所有绑定的数据源生效,请谨慎操作。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
PolicyIdstring

策略ID。

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

策略名称。

每天备份 + 异地备份
PolicyDescriptionstring

策略描述。

每天早上10点备份一次,异地备份到上海。
Rulesarray

策略规则列表。

object

策略规则。

RuleIdstring

规则ID。

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

规则类型,每一个策略需要至少有一个BACKUP类型规则,有且仅有一个TRANSITION类型规则:

  • BACKUP:备份规则。
  • TRANSITION:生命周期规则。
  • REPLICATION:复制规则。
BACKUP
Schedulestring

仅当RuleType取值为BACKUP时,需要配置该参数。备份定时设置。可选格式:I|{startTime}|{interval}。表示从{startTime}开始每隔{interval}的时间执行一次备份任务。不会补偿已过去时间的备份任务。如果上一次备份任务没有完成,不会触发下一次备份任务。例如I|1631685600|P1D表示从2021-09-15 14:00:00开始每隔一天备份一次。

  • startTime:备份起始时间,UNIX时间,单位为秒。
  • interval: ISO8601时间间隔。例如:PT1H表示间隔一小时。P1D表示间隔一天。
I|1648647166|P1D
BackupTypestring

仅当RuleType取值为BACKUP时,需要配置该参数。备份类型。取值为COMPLETE,表示全量备份。

COMPLETE
Retentionlong

仅当RuleType取值为TRANSITIONREPLICATION时,需要配置该参数。

  • RuleType取值为TRANSITION:备份保留时间,最小值为1,单位为天。
  • RuleType取值为REPLICATION:异地备份保留时间,最小值为1,单位为天。
7
ReplicationRegionIdstring

仅当RuleType取值为REPLICATION时,需要配置该参数。复制的目标地域ID。

cn-shanghai
ArchiveDayslong

仅当RuleType取值为TRANSITION时,需要配置该参数。备份转为归档的时间,单位为天。

90
ColdArchiveDayslong

仅当RuleType取值为TRANSITION时,需要配置该参数。备份转为冷归档的时间,单位为天。

365
RetentionRulesarray

仅当RuleType取值为TRANSITION时,需要配置该参数。特殊保留规则。

object

特殊保留规则。

AdvancedRetentionTypestring

特殊保留规则类型:

  • WEEKLY:每周的备份
  • MONTHLY:每月的备份
  • YEARLY:每年的备份
YEARLY
WhichSnapshotlong

针对第几个备份生效,当前仅支持第1个备份,值为1。

1
Retentionlong

备份的特殊保留时间,最小值为1,单位为天。

365

返回参数

名称类型描述示例值
object

UpdatePolicyResponse

Successboolean

请求是否成功。

  • true:成功。
  • false:失败。
true
Codestring

返回码,200表示成功。

200
Messagestring

返回信息描述,成功一般返回successful,错误时会返回相应错误信息。

successful
RequestIdstring

请求ID。

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

示例

正常返回示例

JSON格式

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

错误码

访问错误中心查看更多错误码。