Import Rule Members from a CSV file

This URL imports rule members from a CSV file.

Note

This API is applicable only for the following rule object types — IPv4 Endpoint, IPv4 Network, IPv6 Endpoint and IPv6 Network.

Follow these steps to upload a CSV file and import rule members from the file:

1. Enter the resource URL and navigate to Body → form-data.
2. In the first cell under the KEY column, hover the mouse cursor so you can see a drop-down. Select File from the drop-down. Name the key as ruleObjectMembersFile.
3. Select Files button appears for the newly added key under the VALUE column. Use this option to upload the CSV file.
4. Enter the CONTENT TYPE for this key as multipart/form-data.
5. Create a new Text key named roPropertiesJson. Enter json payload as the VALUE for this key.

   An example of payload to import IPv4 address list:

   {
      "RuleObjDef":  {
         "domain": 0, 
         "visibleToChild": true, 
         "description": "try", 
         "ruleobjId": 0, 
         "name": "test_SDK6", 
         "HostIPv4": {
            "hostIPv4AddressList": []         
         }, 
         "ruleobjType": "HOST_IPV_4"
      }
   } 

   Note

   If the ruleobjId is set to 0, a new rule object is created and all the entries are imported from the CSV file.

   Note

   If you are specifying an existing rule object's ID in ruleobjId, the specified rule object would be modified and the rule members will be appended or replaced based on the value set for importOption_id.

   An alternate method to import rule members to an existing rule object is demonstrated in Resource URL to import rule members to an existing rule object. You may refer to these steps for an easier way of importing rule members to specific rule object.

6. Enter the CONTENT TYPE for this key as application/json.

   The added keys appear in Postman as shown below:

   
   
   

Follow these steps to import rule members to an existing rule object. This is the recommended procedure to append or replace rule members from a CSV file into an existing rule object:

1. Enter the resource URL and navigate to Body → form-data.
2. In the first cell under the KEY column, hover the mouse cursor so you can see a drop-down. Select File from the drop-down. Name the key as ruleObjectMembersFile.
3. Select Files button appears for the newly added key under the VALUE column. Use this option to upload the CSV file.
4. Enter the CONTENT TYPE for this key as multipart/form-data.

   The added keys appear in Postman as shown below:

   
   
   

   Note

   If the importOption is set to 1, entries in the CSV file will be appended to the existing list of rule members. If the importOption is set to 2, entries in the CSV file will replace the existing list of rule members. When you append or replace the IP addresses, the Manager ignores any duplicate entries.