GetProhibitedPolicy - 查询禁用软件策略详情-办公安全平台(SASE)-阿里云帮助中心

查询指定软件禁用策略的详情。

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
PolicyId	string	是	软件禁用策略 ID。取值来源： ListProhibitedPolicies ：批量查询软件禁用策略。 CreateProhibitedPolicy ：创建软件禁用策略。	pid-7da5ea4192c1****

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	Id of the request	E966413B-7538-5332-99B4-C3DA016B9453
Policy	object	软件禁用策略详情。
SoftwareIds	array<object>	该策略直接管控的禁用软件集合。
	object	禁用软件。
SoftwareId	string	禁用软件 ID。	swb-050216aafaae****
IsDefault	boolean	该禁用软件是否为系统内置禁用软件。取值： true：系统内置禁用软件，所有阿里云账号共享，不支持修改和删除。 false：当前阿里云账号下的自定义禁用软件。	false
TagIds	array	该策略管控的禁用软件标签 ID 集合。
	string	禁用软件标签 ID。	tag-d3f64e8bdd4a****
UserGroupIds	array	该策略生效的用户组 ID 集合。
	string	用户组 ID。	usergroup-9d4f2a7b3c1e****
Name	string	软件禁用策略名称。	PolicyC
PolicyId	string	软件禁用策略 ID。	pid-36ee4a5869f3****
Description	string	软件禁用策略描述。	completed
PromptCh	string	终端弹窗的中文提示内容。	该软件已被企业安全策略禁止运行，如需使用请提交报备申请。
PromptEn	string	终端弹窗的英文提示内容。	This software is blocked by your enterprise security policy.
PolicyType	string	处置动作。取值： Ban：禁止运行并在终端弹窗提醒终端用户。 BanSilent：禁止运行且不提醒终端用户，静默阻断。 Warn：仅在终端弹窗提醒终端用户，不阻断软件运行。枚举值： BanSilent : 禁止运行并弹窗提醒 Ban : 禁止运行且不提醒 Warn : 仅弹窗提醒	Ban
Whitelist	array	例外用户名列表。
	string	用户名。	王先生
Priority	integer	策略优先级。取值范围：0~99，数值越小优先级越高。	1
ObjectType	string	管控对象类型。取值： App：按禁用软件管控，管控对象由 SoftwareIds 指定。 Tag：按禁用软件标签管控，管控对象由 TagIds 指定，标签内的全部禁用软件均被管控。枚举值： App : 按禁用软件管控 Tag : 按禁用软件标签管控	App
Enabled	boolean	策略是否启用。取值： true：启用，策略会下发到终端并生效。 false：停用，策略保留配置但不下发到终端。	true
MatchMode	string	策略匹配目标类型。取值： UserGroupAll：关联全体用户。 UserGroupNormal：关联部分用户组。枚举值： UserGroupNormal : 部分用户组生效 UserGroupAll : 全员生效	UserGroupNormal
CreateTime	string	软件禁用策略的创建时间，格式为 yyyy-MM-dd HH:mm:ss，使用 UTC+8 时区。	2021-07-29 11:26:02
AllowReport	boolean	是否允许终端用户对该策略发起报备申请。取值： true：允许报备，终端弹窗提供报备入口。 false：不允许报备。	false
ForceKill	boolean	是否强制结束已运行的软件进程。取值： true：终端在命中策略时立即结束该软件正在运行的进程。 false：不结束已运行的进程，仅阻止后续启动。	false
TitleCh	string	终端弹窗的中文标题。	软件禁用提醒
TitleEn	string	终端弹窗的英文标题。	Software Blocked
MainButtonTextCh	string	终端弹窗主按钮的中文文案。	前往报备
MainButtonTextEn	string	终端弹窗主按钮的英文文案。	Report
MinorButtonTextCh	string	终端弹窗次按钮的中文文案。	我知道了
MinorButtonTextEn	string	终端弹窗次按钮的英文文案。	I know
ReportProcessId	string	该策略已绑定的报备审批流程 ID。未绑定审批流程时返回空字符串，此时终端用户提交的报备申请由 IT 管理员兜底审批。审批流程通过 AttachPolicy2ApprovalProcess 绑定、 DetachPolicy2ApprovalProcess 解绑。取值来源： ListApprovalProcesses ：批量查询审批流程。	approval-process-6c2f8a1b7d3e****

示例

正常返回示例

JSON格式

{
  "RequestId": "E966413B-7538-5332-99B4-C3DA016B9453",
  "Policy": {
    "SoftwareIds": [
      {
        "SoftwareId": "swb-050216aafaae****",
        "IsDefault": false
      }
    ],
    "TagIds": [
      "tag-d3f64e8bdd4a****\n"
    ],
    "UserGroupIds": [
      "usergroup-9d4f2a7b3c1e****"
    ],
    "Name": "PolicyC",
    "PolicyId": "pid-36ee4a5869f3****",
    "Description": "completed",
    "PromptCh": "该软件已被企业安全策略禁止运行，如需使用请提交报备申请。",
    "PromptEn": "This software is blocked by your enterprise security policy.",
    "PolicyType": "Ban",
    "Whitelist": [
      "王先生"
    ],
    "Priority": 1,
    "ObjectType": "App",
    "Enabled": true,
    "MatchMode": "UserGroupNormal",
    "CreateTime": "2021-07-29 11:26:02",
    "AllowReport": false,
    "ForceKill": false,
    "TitleCh": "软件禁用提醒",
    "TitleEn": "Software Blocked",
    "MainButtonTextCh": "前往报备",
    "MainButtonTextEn": "Report",
    "MinorButtonTextCh": "我知道了",
    "MinorButtonTextEn": "I know",
    "ReportProcessId": "approval-process-6c2f8a1b7d3e****"
  }
}

错误码

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

变更历史

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