Replace set of group rules with a new one. Only Location and Network Device groups are supported.
Since Product Version: 3.0
Resource Information
Rate Limiting?
|
Yes
|
Sorting?
|
No
|
Paging?
|
No
|
Filtering?
|
No
|
Aggregation?
|
No
|
Response Formats
|
|
User Group
|
NBI Write
|
HTTP Methods
|
|
DevNet Discussions
Resource URL
/webacs/api/v1/op/groups/groupRules
Request Parameters
groupId
Long
|
query
|
RequiredId of the group. Either groupId or groupPath must be specified.
|
groupPath
String
|
query
|
RequiredFull path and name of the group. Either groupId or groupPath must be specified.
|
Request Payload Parameters
rules
GroupDeviceRule[]
|
|
criteria
String
|
Argument for the conditional operation. Required.
|
field
String
|
Field of Device to apply the conditional operation. Required.
Allowed values for location groups: "City", "City Division", "Country", "County", "Device Name", "DNS Name", "Location(sysLocation)", "Management Address", "Module Name", "Module Part Number", "Postal Code", "Serial Number", "State".
Allowed values for user defined groups: "Contact", "Description(sysDescr)", "Device Name", "DNS Name", "Location(sysLocation)", "Management Address", "Module Name", "Module Part Number", "Product Family", "Product Series", "Product Type", "Software Type", "Software Version".
To add dynamic rule on a user defined field pass the field name with the "UDF:" prefix.
|
matchCondition
MatchConditionEnum
|
Logical operator to chain multiple rules together. Required.
Allowed values:
AND
OR
|
operation
GroupDeviceRuleOperationEnum
|
Conditional operation to apply to the device field. Required.
Allowed values:
IS_EMPTY
IS_NOT_EMPTY
IS_TRUE
IS_FALSE
CONTAINS
NOT_CONTAINS
EQUALS
NOT_EQUALS
STARTS_WITH
ENDS_WITH
GREATER_THAN
LESS_THAN
GREATER_EQUALS
LESS_EQUALS
IN_RANGE
|
|
Sample Payloads
Sample payloads are for information only. They are automatically generated and the values included may not be representative of actual valid data values.
Sample XML Request Payload
https://localhost/webacs/api/v1/op/groups/groupRules?groupPath=Location/All Locations/groupName
<?xml version="1.0" ?>
<groupRulesDTO>
<rules>
<rule>
<criteria>String value</criteria>
<field>String value</field>
<matchCondition>AND</matchCondition>
<operation>IS_EMPTY</operation>
</rule>
</rules>
</groupRulesDTO>
Sample JSON Request Payload
https://localhost/webacs/api/v1/op/groups/groupRules.json?groupPath=Location/All Locations/groupName
{
"groupRulesDTO" : {
"rules" : {
"rule" : {
"criteria" : "String value",
"field" : "String value",
"matchCondition" : "AND",
"operation" : "IS_EMPTY"
}
}
}
}
Resource Information
Rate Limiting?
|
Yes
|
Sorting?
|
No
|
Paging?
|
No
|
Filtering?
|
No
|
Aggregation?
|
No
|
Response Formats
|
|
User Group
|
NBI Write
|
HTTP Methods
|
|
DevNet Discussions
Resource URL
/webacs/api/v2/op/groups/groupRules
Unmodified
This resource has not been modified since the previous API version.
Request Parameters
groupId
Long
|
query
|
RequiredId of the group. Either groupId or groupPath must be specified.
|
groupPath
String
|
query
|
RequiredFull path and name of the group. Either groupId or groupPath must be specified.
|
Request Payload Parameters
rules
GroupDeviceRule[]
|
|
criteria
String
|
Argument for the conditional operation. Required.
|
field
String
|
Field of Device to apply the conditional operation. Required.
Allowed values for location groups: "City", "City Division", "Country", "County", "Device Name", "DNS Name", "Location(sysLocation)", "Management Address", "Module Name", "Module Part Number", "Postal Code", "Serial Number", "State".
Allowed values for user defined groups: "Contact", "Description(sysDescr)", "Device Name", "DNS Name", "Location(sysLocation)", "Management Address", "Module Name", "Module Part Number", "Product Family", "Product Series", "Product Type", "Software Type", "Software Version".
To add dynamic rule on a user defined field pass the field name with the "UDF:" prefix.
|
matchCondition
MatchConditionEnum
|
Logical operator to chain multiple rules together. Required.
Allowed values:
AND
OR
|
operation
GroupDeviceRuleOperationEnum
|
Conditional operation to apply to the device field. Required.
Allowed values:
IS_EMPTY
IS_NOT_EMPTY
IS_TRUE
IS_FALSE
CONTAINS
NOT_CONTAINS
EQUALS
NOT_EQUALS
STARTS_WITH
ENDS_WITH
GREATER_THAN
LESS_THAN
GREATER_EQUALS
LESS_EQUALS
IN_RANGE
|
|
Sample Payloads
Sample payloads are for information only. They are automatically generated and the values included may not be representative of actual valid data values.
Sample XML Request Payload
https://localhost/webacs/api/v2/op/groups/groupRules?groupPath=Location/All Locations/groupName
<?xml version="1.0" ?>
<groupRulesDTO>
<rules>
<rule>
<criteria>String value</criteria>
<field>String value</field>
<matchCondition>AND</matchCondition>
<operation>IS_EMPTY</operation>
</rule>
</rules>
</groupRulesDTO>
Sample JSON Request Payload
https://localhost/webacs/api/v2/op/groups/groupRules.json?groupPath=Location/All Locations/groupName
{
"groupRulesDTO" : {
"rules" : {
"rule" : [ {
"criteria" : "String value",
"field" : "String value",
"matchCondition" : "AND",
"operation" : "IS_EMPTY"
} ]
}
}
}
Resource Information
Rate Limiting?
|
Yes
|
Sorting?
|
No
|
Paging?
|
No
|
Filtering?
|
No
|
Aggregation?
|
No
|
Response Formats
|
|
User Group
|
NBI Write
|
HTTP Methods
|
|
DevNet Discussions
Resource URL
/webacs/api/v3/op/groups/groupRules
Unmodified
This resource has not been modified since the previous API version.
Request Parameters
groupId
Long
|
query
|
RequiredId of the group. Either groupId or groupPath must be specified.
|
groupPath
String
|
query
|
RequiredFull path and name of the group. Either groupId or groupPath must be specified.
|
Request Payload Parameters
rules
GroupDeviceRule[]
|
|
criteria
String
|
Argument for the conditional operation. Required.
|
field
String
|
Field of Device to apply the conditional operation. Required.
Allowed values for location groups: "City", "City Division", "Country", "County", "Device Name", "DNS Name", "Location(sysLocation)", "Management Address", "Module Name", "Module Part Number", "Postal Code", "Serial Number", "State".
Allowed values for user defined groups: "Contact", "Description(sysDescr)", "Device Name", "DNS Name", "Location(sysLocation)", "Management Address", "Module Name", "Module Part Number", "Product Family", "Product Series", "Product Type", "Software Type", "Software Version".
To add dynamic rule on a user defined field pass the field name with the "UDF:" prefix.
|
matchCondition
MatchConditionEnum
|
Logical operator to chain multiple rules together. Required.
Allowed values:
AND
OR
|
operation
GroupDeviceRuleOperationEnum
|
Conditional operation to apply to the device field. Required.
Allowed values:
IS_EMPTY
IS_NOT_EMPTY
IS_TRUE
IS_FALSE
CONTAINS
NOT_CONTAINS
EQUALS
NOT_EQUALS
STARTS_WITH
ENDS_WITH
GREATER_THAN
LESS_THAN
GREATER_EQUALS
LESS_EQUALS
IN_RANGE
|
|
Sample Payloads
Sample payloads are for information only. They are automatically generated and the values included may not be representative of actual valid data values.
Sample XML Request Payload
https://localhost/webacs/api/v3/op/groups/groupRules?groupPath=Location/All Locations/groupName
<?xml version="1.0" ?>
<groupRulesDTO>
<rules>
<rule>
<criteria>String value</criteria>
<field>String value</field>
<matchCondition>AND</matchCondition>
<operation>IS_EMPTY</operation>
</rule>
<rule>
<criteria>String value</criteria>
<field>String value</field>
<matchCondition>AND</matchCondition>
<operation>IS_EMPTY</operation>
</rule>
</rules>
</groupRulesDTO>
Sample JSON Request Payload
https://localhost/webacs/api/v3/op/groups/groupRules.json?groupPath=Location/All Locations/groupName
{
"groupRulesDTO" : {
"rules" : {
"rule" : [ {
"criteria" : "String value",
"field" : "String value",
"matchCondition" : "AND",
"operation" : "IS_EMPTY"
}, {
"criteria" : "String value",
"field" : "String value",
"matchCondition" : "AND",
"operation" : "IS_EMPTY"
} ]
}
}
}