Skip to main content

ON PREMISES SOLUTIONS

assignPolicy

This method assigns a policy to a list of endpoints or containers.

Note

The method uses the default view type. For VMWare integrations it is Hosts and Clusters view. For Citrix XenServer integrations it is Server view. If you are using other views, you must include in targetIds the IDs of the target endpoints and containers.

Services

This method requires you to place the {service} name in the API URL. The allowed services are:

  • computers, for "Computers and Virtual Machines"

  • virtualmachines, for "Virtual Machines"

For example, the request URL for the virtual machines service is:

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

Parameters

Parameter

Type

Optional

Description

targetIds

Array

No

A list with the IDs of the policy targets. The target ID can designate an endpoint or a container.

inheritFromAbove

Boolean

Yes

A boolean specifying whether the given targets shoud inherit the policy of the parent container. Targets without a parent container receive the default policy. Use this parameter only in conjuction with the targetIds parameter. By default, the parameter is set to True.

policyId

String

Yes

A string specifying the ID of the policy to be assigned. When this parameter is missing the inheritFromAbove parameter must be set to True.

forcePolicyInheritance

Boolean

Yes

A boolean specifying whether the policy should be assigned to child entities of the given targets. By default, the parameter is set to False.

Return value

This method returns a Boolean which is True, when the policy was successfully assigned to one or more targets. The policy is not assigned to targets that have enforced policy.

Example

Request:

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

Response:

  {
      "id": "787b5e36-89a8-4353-88b9-6b7a32e9c87f",
      "jsonrpc":"2.0",
      "result": True
  }