调用API创建勒索病毒防护策略-云安全中心-阿里云-云安全中心(Security Center)-阿里云帮助中心

创建服务器勒索病毒防护策略。

调试

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

调试

授权信息

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

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

yundun-sas:CreateBackupPolicy

create

*BackupPolicy

acs:yundun-sas:{#regionId}:{#accountId}:backuppolicy/*

无

请求参数

名称	类型	必填	描述	示例值
Name	string	是	设置要创建的防护策略的名称。	ServerBackUpPolicy01
Policy	object	是	IsDefault：要新建的防护策略的类型。取值： 1：推荐策略 0：自定义策略 Include：要防护的文件类型。防护全部文件类型时，该参数设置为[]。 Source：要防护的服务器目录。需要防护全部目录时，该参数设置为[]。 ExcludeSystemPath：设置是否排除指定目录。要排除该参数设置为 true，不排除则无需设置该参数。 Exclude：设置指定的防护目录地址。不设置指定防护目录地址时，该参数设置为[]。 Schedule：设置数据备份任务的执行时间和执行间隔。建议指定在业务低峰期非整点。设置示例如下：例 1：I\|1583216092\|P21D 表示数据备份开始时间为 2020-03-03 14:14:52，备份策略执行间隔为 3 周。例 2：I\|1583216092\|PT24H 表示数据备份开始时间为 2020-03-03 14:14:52，备份策略执行间隔为 24 小时。 Retention：设置备份数据保留时间，单位为天。7 表示 1 周，365 表示 1 年，-1 表示永久。 SpeedLimiter：设置备份网络带宽限制。例如：0:24:30720 表示 0~24 时备份网络带宽限制为 30 MByte/s。 UseVss：是否启用 VSS（Windows）功能。取值： true：启用 false：不启用说明 VSS（Windows）功能仅为 Windows 系统开启，开启后会有效降低因进程占用导致的个别文件备份失败的问题，建议开启。启用该功能后，将不支持 exFAT 和 FAT32 磁盘格式的文件备份。	"{"IsDefault":1,"Include":[],"Source":[],"Schedule":"I\|1648061040\|PT24H","Retention":7,"SpeedLimiter":"","ExcludeSystemPath":true,"Exclude":["/bin/","/usr/bin/","/sbin/","/boot/","/proc/","/sys/","/srv/","/lib/","/selinux/","/usr/sbin/","/run/","/lib32/","/lib64/","/lost+found/","/var/lib/kubelet/","/var/lib/ntp/proc","/var/lib/container","Windows","Python27","Program Files (x86)","Program Files","Boot","$RECYCLE.BIN","System Volume Information","Users\Administrator\NTUSER.DAT","ProgramData","pagefile.sys","Users\Default\NTUSER.DAT","Users\Administrator\ntuser.*"],"UseVss":true}"
PolicyVersion	string	是	防护策略的版本。固定取值2.0.0。	2.0.0
PolicyRegionId	string	否	非阿里云服务器所在的地域 ID。说明您可以调用 DescribeSupportRegion 接口查看防勒索支持的地域，然后根据您的非阿里云服务器所在的地域就近选择防勒索支持的地域。	ch-hangzhou
UuidList	array	否	指定需要防护的服务器 UUID 集合。	["3bb30859-b3b5-4f28-868f-b0892c98**", "3bb30859-b3b5-4f28-868f-b0892c98**"]
	string	否	要防护的服务器的 UUID 列表。多个 UUID 之间使用半角逗号（,）隔开。说明您可调用 DescribeCloudCenterInstances 接口获取服务器的 UUID。当 SelectType 为ALL_MACHINE时该参数无效。	3bb30859-b3b5-4f28-868f-b0892c98****
ServerType	string	否	服务器类型。取值： ALIYUN：阿里云服务器 OUT_CLOUD：非阿里云服务器 TRIPARTITE：轻量应用服务器	ALIYUN
SelectType	string	否	覆盖资产方式。取值： ALL_MACHINE：全部资产说明若需要覆盖该类型所有资产时，该属性值为ALL_MACHINE，UuidList 无效。同一个服务器类型只能存在一条覆盖全部资产的策略。枚举值： ALL_MACHINE : 全部资产	ALL_MACHINE

返回参数

名称	类型	描述	示例值
	object	创建勒索病毒防护策略返回数据。
RequestId	string	本次调用请求的 ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。	24A20733-10A0-4AF6-BE6B-E3322413BB68
BackupPolicy	object	防护策略信息。
Id	string	防勒索防护策略编号。	1301575
Status	string	策略状态。取值： enabled：开启防护。 disabled：关闭防护。说明创建后默认是开启防护。	enabled

示例

正常返回示例

JSON格式

{
  "RequestId": "24A20733-10A0-4AF6-BE6B-E3322413BB68",
  "BackupPolicy": {
    "Id": "1301575",
    "Status": "enabled"
  }
}

错误码

HTTP status code	错误码	错误信息	描述
400	AgentNotOnline	The agent not online.	客户端不在线不支持操作，请保持客户端在线后再进行操作。
400	AntiRansomwareCapacityUseUp	anti ransomware capacity use up	防勒索容量不足，请前往购买页面进行扩容。
400	DataExists	data exist	数据已存在，请检查您的请求参数
400	ServerTypeAllAssetPolicyExist	The policy for all asset of this server type already exists.	当前类型下已存在覆盖全部资产的策略，请勿重复配置。
500	ServerError	ServerError	服务故障，请稍后重试！
403	NoPermission	caller has no permission	当前操作未被授权，请联系主账号在RAM控制台进行授权后再执行操作。

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

变更历史

更多信息，参考变更详情。