编辑受监控规则访问权限
您可通过此方法根据特定PHASR规则生成的建议，限制或允许对行为配置文件的访问。
该选项将自动应用建议中的操作，并对选定目标限制或允许访问推荐资产。
每个PHASR建议包含已完成学习阶段的行为配置文件。行为配置文件是用户与其设备的配对。单个用户可能拥有多台设备，因此不同建议可能包含相同用户但不同设备。
发起请求的用户必须具有该ID所属公司的网络管理员权限。
参数
|
名称 |
描述 |
包含于请求中 |
类型 |
取值 |
|---|---|---|---|---|
|
|
规则所属公司的ID。 |
可选 |
字符串 |
默认值：请求所用API密钥关联的公司ID。 |
|
|
推荐所依据规则的ID。 |
必填 |
整数 |
无额外要求。 |
|
|
对指定行为档案要执行的操作。 |
必填 |
整数 |
可选值：
|
|
|
要应用指定规则生成推荐的行为档案ID列表。 |
必填 |
字符串数组 |
行为档案ID由
|
|
|
指定行为配置文件的类型。 |
可选 |
整数 |
可选值：
|
通用参数
这些是公共参数，适用于所有公共API方法。
|
参数 |
描述 |
包含在请求中 |
类型 |
取值 |
|---|---|---|---|---|
|
|
此参数为请求添加标识符，将其与对应响应关联。 目标方在响应中返回相同值，便于调用追踪。 |
必填 |
字符串 |
无额外要求 |
|
|
用于发送请求的方法名称。 |
必填 |
字符串 |
必须是有效的方法名称。 |
|
|
请求和响应所使用的JSON-RPC版本。 |
必填 |
整数 |
可选值：
|
|
|
包含请求配置的对象。 |
必填 |
对象 |
无额外要求。 |
返回值
|
属性 |
类型 |
描述 |
|---|---|---|
|
|
字符串数组 |
请求成功修改的行为配置文件的ID列表。 |
|
|
字符串数组 |
因已被限制而无法再次限制的行为配置文件ID列表。 |
|
|
字符串数组 |
因已被允许而无法再次允许的行为配置文件ID列表 |
|
|
对象数组 |
因非已受限或已允许问题导致无法更新的行为配置文件错误对象列表 行为配置文件根据请求失败原因分组。每个对象包含说明失败原因的消息及该原因导致失败的所有对象。 |
对象
错误信息
|
属性 |
类型 |
描述 |
|---|---|---|
|
|
字符串数组 |
因特定原因导致操作失败的配置文件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拼接构成。"
}
]
}
}