编辑受监控规则访问权限
您可通过此方法基于特定PHASR规则生成的建议，限制或允许对行为配置文件的访问。
此选项将自动应用建议的操作，并对选定目标限制或允许访问推荐资产。
每个PHASR建议包含已完成学习阶段的行为配置文件。行为配置文件是用户与其设备的配对。单个用户可能拥有多台设备，因此不同建议可能包含相同用户但不同设备。
发起请求的用户须具备该ID所属公司的网络管理员权限。
参数
|
名称 |
描述 |
包含在请求中 |
类型 |
取值 |
|---|---|---|---|---|
|
|
规则所属公司的ID。 |
可选 |
字符串 |
默认值：请求所用API密钥关联的公司ID。 |
|
|
生成推荐所依据规则的ID。 |
必填 |
整数 |
无额外要求。 |
|
|
对指定行为档案执行的操作。 |
必填 |
整数 |
可选值：
|
|
|
需要应用指定规则生成推荐的行为配置文件ID列表。 |
必填 |
字符串数组 |
行为配置文件ID由用户
|
|
|
指定行为配置文件的类型。 |
可选 |
整数 |
可选值：
|
通用参数
这些是公共API方法通用的参数。
|
参数 |
描述 |
是否包含在请求中 |
类型 |
取值 |
|---|---|---|---|---|
|
|
该参数为请求添加标识符，将其与对应响应关联。 目标方在响应中返回相同值，便于调用追踪。 |
必填 |
字符串 |
无额外要求 |
|
|
用于发送请求的方法名称。 |
必填 |
字符串 |
必须是有效的方法名。 |
|
|
请求和响应所使用的JSON-RPC版本。 |
必填 |
整数 |
可选值：
|
|
|
包含请求配置的对象。 |
必填 |
对象 |
无额外要求。 |
返回值
|
属性 |
类型 |
描述 |
|---|---|---|
|
|
字符串数组 |
请求成功修改的行为特征文件ID列表。 |
|
|
字符串数组 |
因已被限制而无法再次限制的行为特征文件ID列表。 |
|
|
字符串数组 |
因已被允许而无法再次允许的行为特征文件ID列表。 |
|
|
对象数组 |
因非已限制/已允许问题导致更新失败的行为特征文件对应的错误对象列表。 行为特征文件根据请求失败原因分组。每个对象包含说明失败原因的消息，以及因该特定原因失败的所有对象。 |
对象
errors
|
属性 |
类型 |
描述 |
|---|---|---|
|
|
字符串数组 |
因特定原因导致操作失败的配置文件ID列表。 |
|
|
字符串 |
更新失败的原因说明。 |
示例
请求 :
{
"params": {
"companyId": "68306c15c9b5cb3e920ffe22",
"ruleId": 1,
"action": 0,
"targets": ["Local_S-1-5-21-2018264366-2484004464-1617746128-1001_68308694de453e6a039e1f6d6a7f1642-bdbc-810b-a42b-e04f2611c538-005056965bef",
"AD_S-1-5-21-4282359893-3999216301-2697700004-110862c11642-236f-e7bd-cf05-0f91f9346073-005056961e20",
"test123"],
"targetType":0
},
"jsonrpc": "2.0",
"method": "editMonitoredRulesAccess",
"id": "d4d50719-3215-455a-a329-086fe77f6d72"
}
响应 :
{
"id": "d4d50719-3215-455a-a329-086fe77f6d72",
"jsonrpc": "2.0",
"result": {
"updated_profiles": [
"AD_S-1-5-21-4282359893-3999216301-2697700004-110862c11642-236f-e7bd-cf05-0f91f9346073-005056961e20"
],
"already_restricted": [
"Local_S-1-5-21-2018264366-2484004464-1617746128-1001_68308694de453e6a039e1f6d6a7f1642-bdbc-810b-a42b-e04f2611c538-005056965bef"
],
"errors": [
{
"targets": [
"test123"
],
"message": "未找到配置文件ID。有效配置文件ID应由行为特征文件的identityId和resourceId拼接而成。"
}
]
}
}