CreatePolicyV2 - 创建策略 - 混合云备份 HBR

创建一个策略。

接口说明

备份策略记录了备份所需的信息。备份策略执行后会产生备份任务，记载备份进度与备份结果。如果备份任务成功，会产生一个备份快照。可以使用备份快照创建恢复任务。

一个备份策略支持多种数据源，目前仅支持ECS整机备份。
一个备份策略仅支持单个固定时间间隔的备份周期策略。
一个备份策略仅能向一个备份仓库进行备份。

调试

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

调试

授权信息

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

请求参数

名称	类型	必填	描述	示例值
PolicyName	string	否	策略名称。	每天本地备份 + 异地备份
PolicyDescription	string	否	策略描述。	每天早上10点备份一次，异地备份到上海。
Rules	array	否	策略规则列表。
	object	否	策略规则。
RuleType	string	是	规则类型，每一个策略需要至少有一个BACKUP类型规则，有且仅有一个TRANSITION类型规则： BACKUP：备份规则。 TRANSITION：生命周期规则。 REPLICATION：复制规则。	BACKUP
Schedule	string	否	仅当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
BackupType	string	否	仅当RuleType取值为BACKUP时，需要配置该参数。备份类型。取值为COMPLETE，表示全量备份。	COMPLETE
Retention	long	否	仅当RuleType取值为TRANSITION或REPLICATION时，需要配置该参数。 RuleType取值为TRANSITION：备份保留时间，最小值为1，单位为天。 RuleType取值为REPLICATION：异地备份保留时间，最小值为1，单位为天。	7
ReplicationRegionId	string	否	仅当RuleType取值为REPLICATION时，需要配置该参数。复制的目标地域ID。	cn-shanghai
RetentionRules	array	否	仅当RuleType取值为TRANSITION时，需要配置该参数。特殊保留规则。
	object	否	特殊保留规则。
AdvancedRetentionType	string	否	特殊保留规则类型： WEEKLY：每周的备份 MONTHLY：每月的备份 YEARLY：每年的备份	YEARLY
WhichSnapshot	long	否	针对第几个备份生效，当前仅支持第1个备份，值为1。	1
Retention	long	否	备份的特殊保留时间，最小值为1，单位为天。	730

返回参数

名称	类型	描述	示例值
	object	CreatePolicyResponse
Success	boolean	请求是否成功。 true：成功 false：失败	true
Code	string	返回码。200表示成功。	200
Message	string	返回信息描述，成功一般返回successful，错误时会返回相应错误信息。	successful
RequestId	string	请求ID。	EEC65C22-2152-5E31-8AD6-D6CBF1BFF49F
PolicyId	string	策略ID。	po-000000zemnuyx2li3y9y

示例

正常返回示例

JSON格式

{
  "Success": true,
  "Code": "200",
  "Message": "successful",
  "RequestId": "EEC65C22-2152-5E31-8AD6-D6CBF1BFF49F",
  "PolicyId": "po-000000zemnuyx2li3y9y"
}

错误码

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