调用UpdateBackupPlan更新一个备份计划。

请求参数

名称 类型 是否必选 示例值 描述
Action String UpdateBackupPlan

系统规定参数。取值:UpdateBackupPlan

PlanId String plan-20211***735

备份计划ID。

PlanName String planname

备份计划名称。

Schedule String I|1602673264|P1D

备份策略。可选格式:I|{startTime}|{interval}。表示从{startTime}开始每隔{interval}的时间执行一次备份任务。不会补偿已过去时间的备份任务。如果上一次备份任务没有完成,不会触发下一次备份任务。例如I|1631685600|P1D表示从2021-09-15 14:00:00开始每隔一天备份一次。

  • startTime:备份起始时间,UNIX时间,单位秒。
  • interval: ISO8601时间间隔。例如:PT1H表示间隔一小时。P1D表示间隔一天。
Retention Long 7

备份保留天数,最小值为1天。

Prefix String oss-prefix

仅当SourceType取值为OSS时,需要配置该参数。表示备份前缀。指定后,仅备份前缀相匹配的对象。

VaultId String v-0006******q

备份仓库ID。

SourceType String ECS_FILE

数据源类型,取值范围:

  • ECS_FILE:表示备份ECS文件
  • OSS:表示备份阿里云OSS
  • NAS:表示备份阿里云NAS
SpeedLimit String 0:24:5120

仅当SourceType取值为ECS_FILE时,需要配置该参数。表示备份流量控制。流量控制可以帮助您在业务高峰期,控制备份文件的流量,以免影响正常业务。格式为{start}|{end}|{bandwidth}。多个流量控制配置使用|分隔,并且配置时间不允许有重叠。

  • start:起始小时
  • end:结束小时
  • bandwidth:限制速率,单位KB/s。
Include String ["/home/alice/*.pdf", "/home/bob/*.txt"]

仅当SourceType取值为ECS_FILE时,需要配置该参数。表示需要备份的路径,该路径下所有文件都备份。最多支持255个字符。

Exclude String ["/var", "/proc"]

仅当SourceType取值为ECS_FILE时,需要配置该参数。表示不需要进行备份的路径,该路径下所有文件都不备份。最多支持255个字符。

Options String {"UseVSS":false}

仅当SourceType取值为ECS_FILE时,需要配置该参数。表示是否使用Windows系统VSS定义备份路径。

  • 此功能仅支持Windows类型ECS实例。
  • 如果备份源中有数据更改,需要确保备份数据与源数据的一致时,才可配置为["UseVSS":true]
  • 选择使用VSS后,不支持多个文件目录同时备份。
UpdatePaths Boolean false

当备份路径为空时,是否更新备份路径。

  • true表示按照该接口中定义路径更新备份路径。
  • false表示不更新备份路径,按照创建备份计划时路径继续备份。
Path.N String ["/home"]

备份路径。最多65536个字符。

备份路径规则如下:

  • 无通配符(*)的情况下,可以输入8行路径。
  • 使用通配符(*)时,只能输入1行路径,支持形如/*/*的通配符。
  • 每行只支持绝对路径。
  • 使用VSS时,不支持多个路径、UNC路径、通配符、排除文件。
  • 使用UNC时,不支持VSS、通配符、排除文件。当备份源包含UNC路径时,将不会对Windows ACL进行备份。

返回数据

名称 类型 示例值 描述
Code String 200

返回码,200表示成功。

Message String successful

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

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。

Success Boolean true

请求是否成功。

  • true表示成功。
  • false表示失败。

示例

请求示例

http(s)://[Endpoint]/?Action=UpdateBackupPlan
&PlanId=plan-20211***735
&PlanName=planname
&Schedule=I|1602673264|P1D
&Retention=7
&Prefix=oss-prefix
&VaultId=v-0006******q
&SourceType=ECS_FILE
&SpeedLimit=0:24:5120
&Include=["/home/alice/*.pdf", "/home/bob/*.txt"]
&Exclude=["/var", "/proc"]
&Options={"UseVSS":false}
&UpdatePaths=false
&Path=["[\"/home\"]"]
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<UpdateBackupPlanResponse>
    <Code>200</Code>
    <Message>successful</Message>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <Success>true</Success>
</UpdateBackupPlanResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

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