跳至主内容

分配策略

使用此方法可将策略分配给一个或多个终端节点。该方法适用于所有终端类型（包括容器）。已强制执行策略的目标不会分配新策略。

注意

该方法使用默认视图类型。对于VMWare集成，默认视图为 主机和集群 视图。对于Citrix XenServer集成，默认视图为 服务器 视图。若使用其他视图，则必须在 目标ID 中指定目标终端节点和容器的ID。

服务

此方法要求将 {服务} 名称置于API URL中。允许的服务包括：

  • 计算机 （适用于"计算机与虚拟机"）

  • 虚拟机 ，对应“虚拟机”

例如， 虚拟机 服务的请求URL为： 

https://YOUR-HOSTNAME/api/v1.0/jsonrpc/network/virtualmachines

参数

参数

描述

是否包含在请求中

类型

取值

targetIds

需要分配策略的目标端点ID。

必填

字符串数组

无额外要求。

inheritFromAbove

若设为 true ，目标端点将继承父容器的策略。若特定端点无父容器或父容器未分配策略，则将应用默认策略。

当请求中包含 policyId 或 forcePolicyInheritance 时不可使用此参数。

可选

布尔值

默认值： true .

policyId

要分配的策略ID。

若请求中未包含该参数，则 inheritFromAbove 必须在请求中存在且设置为 true .

可选

字符串

无额外要求。

forcePolicyInheritance

若为 true ，则该策略将同时分配给所选目标的所有子端点。

使用此参数时， policyId 必须包含在请求中。

可选

布尔值

默认值： false .

返回值

属性

类型

描述

result

布尔值

表示操作是否成功以及策略是否成功分配给一个或多个目标。

示例

请求 

{
      "params": {
          "targetIds": [
              "56728d66b1a43de92c7****",
              "69738d66b1a43de92c71****"
          ],
          "inheritFromAbove": false,
          "policyId": "55828d66b1a43de92c71****",
          "forcePolicyInheritance": true
      },
      "jsonrpc": "2.0",
      "method": "assignPolicy",
      "id": "787b5e36-89a8-4353-88b9-6b7a32e9c87f"
 }

响应 

{
     "id": "787b5e36-89a8-4353-88b9-6b7a32e9c87f",
     "jsonrpc":"2.0",
     "result": true
 }
本节内容 :