首页 云备份 开发参考 API参考 API目录 备份策略 UpdatePolicyBinding - 修改策略与数据源关联

UpdatePolicyBinding - 修改策略与数据源关联

更新时间: 2026-03-04 16:05:25

修改策略与数据源的关联关系。

调试

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

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

hbr:UpdatePolicyBinding

update

*全部资源

*

请求参数

名称

类型

必填

描述

示例值

PolicyId

string

策略 ID。

po-000************ky9

DataSourceId

string

数据源 ID。

i-bp1************dtv

SourceType

string

数据源类型,取值范围:

  • UDM_ECS:表示 ECS 整机备份

UDM_ECS

PolicyBindingDescription

string

绑定策略描述。

po-000************5xx-i-2ze************nw4

Disabled

boolean

策略对该数据源是否暂停生效。

  • true:暂停

  • false:未暂停

true

Source

string

根据 SourceType 取值表示不同的含义,SourceType 为

  • OSS:表示备份某个 prefix,如果不指定,则表示备份整个 Bucket 根目录,仅支持单个 prefix。如果要备份/backup,则填写/backup

  • ECS_FILE:表示备份的文件目录,如果不指定,则表示备份全部目录,支持同时指定多个目录。如果要备份路径/a 和路径/b 下的文件,则填写["/a", "/b"]。

  • File:表示备份的文件目录,如果不指定,则表示备份全部目录,支持同时指定多个目录。如果要备份/a 目录和/b 目录下的文件,则填写["/a", "/b"]。

  • COMMON_FILE_SYSTEM:必填,表示备份路径,支持同时指定多个路径。如果要备份/a 路径和/b 路径,则填写["/a", "/b"],如果要备份根路径则填写["/"]。

  • COMMON_NAS:必填,表示备份路径,仅支持单个路径。如果要备份/a 路径则填写["/a"],如果要备份根路径则填写["/"]

  • OTS:表示备份的数据表列表,如果不指定,则表示备份全部数据表。支持同时指定多个数据表。如果要备份数据表 a 和数据表 b,则填写["a", "b"]。

backup/

Include

string

SourceType 取值为ECS_FILEFileNASCOMMON_NASCOMMON_FILE_SYSTEM时,可以配置该参数。表示要进行备份的文件类型,这些类型的所有文件都备份。最多支持 255 个字符。

[\"*.doc\",\"*.xltm\"]

Exclude

string

SourceType 取值为ECS_FILEFileNASCOMMON_NASCOMMON_FILE_SYSTEM时,可以配置该参数。表示要进行备份的文件类型,这些类型的所有文件都备份。最多支持 255 个字符。

[\"*.doc\",\"*.xltm\"]

SpeedLimit

string

仅当 SourceType 取值为ECS_FILEFile 时,需要配置该参数。表示备份流量控制。格式为{start}{end}{bandwidth}。多个流量控制配置使用分隔,并且配置时间不允许有重叠。

  • start:起始小时。

  • end:结束小时。

  • bandwidth:限制速率,单位 KB/s。

0:24:5120

AdvancedOptions

object

高级选项。

UdmDetail

object

ECS 整机备份详情。

ExcludeDiskIdList

array

不需要保护的云盘 ID 列表。当 DiskIdList 不为空时,将忽略该参数。

string

不需要保护的云盘 ID。

d-bp1************apo

DiskIdList

array

需要保护的云盘 ID 列表。保护所有云盘时,该值为空。

string

需要保护的云盘 ID。

d-bp1************apo

SnapshotGroup

boolean

是否创建快照一致性组。仅云盘类型全部为 ESSD 时,支持创建快照一致性组。

true

AppConsistent

boolean

是否创建应用一致性。仅云盘类型全部为 ESSD 时,支持创建快照应用一致性。

false

RamRoleName

string

仅当 AppConsistenttrue 时,需要配置该参数。创建应用一致性快照需要配置的 RAM 角色名称。

AliyunECSInstanceForHbrRole

PreScriptPath

string

仅当 AppConsistenttrue 时,需要配置该参数。创建应用一致性快照前执行的冻结脚本路径。

/tmp/prescript.sh

PostScriptPath

string

仅当 AppConsistenttrue 时,需要配置该参数。创建应用一致性快照后执行的解冻脚本路径。

/tmp/postscript.sh

EnableFsFreeze

boolean

仅当 AppConsistenttrue 时,需要配置该参数。是否在创建应用一致性快照前使用 Linux 的 FsFreeze 机制确保文件系统处于只读一致性。默认为 true。

true

TimeoutInSeconds

integer

仅当 AppConsistenttrue 时,需要配置该参数。IO 冻结超时时间。默认为 30 秒。

30

EnableWriters

boolean

仅当 AppConsistenttrue 时,需要配置该参数。是否设置应用一致性快照:

  • true:创建应用一致性快照

  • false:创建文件系统一致性快照

默认为 true。

true

OssDetail

object

OSS 备份详情。

InventoryId

string

OSS 清单名称,该值不为空时将使用 OSS 清单用于性能调优。

  • 建议备份 1 亿以上 OSS 对象采用清单提升增量性能,由清单文件产生的存储费用由 OSS 服务单独收取。

  • OSS 清单文件生成需要时间,在 OSS 清单文件生成完成之前可能会备份失败,可以等待下个周期执行。

30663060

InventoryCleanupPolicy

string

备份后是否删除清单文件。仅当使用 OSS 清单时有效。支持:

  • NO_CLEANUP:不删除。

  • DELETE_CURRENT:删除当前文件。

  • DELETE_CURRENT_AND_PREVIOUS:删除所有文件。

NO_CLEANUP

IgnoreArchiveObject

boolean

不在任务统计和失败文件列表中提示归档型对象

true

CommonFileSystemDetail

object

大规模文件系统备份详情。

FullOnIncrementFail

boolean

增量备份失败时是否转为全量备份。取值:

  • true:失败时转为全量备份。

  • false:失败时不转为全量备份。

true

FetchSliceSize

integer

备份分片大小(文件数)。

100000

返回参数

名称

类型

描述

示例值

object

UpdatePolicyBindingResponse

Success

boolean

请求是否成功。

  • true 表示成功。

  • false 表示失败。

true

Code

string

返回码,200 表示成功。

200

Message

string

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

successful

RequestId

string

请求 ID。

B6F24C46-54B9-519B-9AB8-A8988D705E67

示例

正常返回示例

JSON格式

{
  "Success": true,
  "Code": "200",
  "Message": "successful",
  "RequestId": "B6F24C46-54B9-519B-9AB8-A8988D705E67"
}

错误码

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

变更历史

更多信息,参考变更详情

上一篇: DeletePolicyBinding - 删除策略与数据源关联 下一篇: DescribePolicyBindings - 查询绑定策略列表
阿里云首页 云备份 相关技术圈