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

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

调试

您可以在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 取值为 OSS 时，表示备份某个 prefix，如果不指定，则表示备份整个 Bucket 根目录。当 SourceType 取值为ECS_FILE或 File 时，表示备份的文件目录，如果不指定，则表示备份全部目录。	backup/
Include	string	否	仅当 SourceType 取值为ECS_FILE或 File 时，需要配置该参数。表示要进行备份的文件类型，这些类型的所有文件都备份。最多支持 255 个字符。	[\".doc\",\".xltm\"]
Exclude	string	否	仅当 SourceType 取值为ECS_FILE或 File 时，需要配置该参数。表示不需要进行备份的文件类型，该类型的所有文件都不备份。最多支持 255 个字符。	[\".doc\",\".xltm\"]
SpeedLimit	string	否	仅当 SourceType 取值为ECS_FILE或 File 时，需要配置该参数。表示备份流量控制。格式为`{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	否	仅当 AppConsistent 为 true 时，需要配置该参数。创建应用一致性快照需要配置的 RAM 角色名称。	AliyunECSInstanceForHbrRole
PreScriptPath	string	否	仅当 AppConsistent 为 true 时，需要配置该参数。创建应用一致性快照前执行的冻结脚本路径。	/tmp/prescript.sh
PostScriptPath	string	否	仅当 AppConsistent 为 true 时，需要配置该参数。创建应用一致性快照后执行的解冻脚本路径。	/tmp/postscript.sh
EnableFsFreeze	boolean	否	仅当 AppConsistent 为 true 时，需要配置该参数。是否在创建应用一致性快照前使用 Linux 的 FsFreeze 机制确保文件系统处于只读一致性。默认为 true。	true
TimeoutInSeconds	long	否	仅当 AppConsistent 为 true 时，需要配置该参数。IO 冻结超时时间。默认为 30 秒。	30
EnableWriters	boolean	否	仅当 AppConsistent 为 true 时，需要配置该参数。是否设置应用一致性快照： 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	long	否	备份分片大小（文件数）。	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"
}

错误码

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

变更历史

变更时间	变更内容概要	操作
2024-11-13	API 内部配置变更，不影响调用	查看变更详情
2024-03-13	OpenAPI 入参发生变更	查看变更详情
2024-01-05	API 内部配置变更，不影响调用	查看变更详情
2023-10-17	API 内部配置变更，不影响调用	查看变更详情
2023-08-16	API 内部配置变更，不影响调用	查看变更详情
2023-03-29	API 内部配置变更，不影响调用	查看变更详情