Policy >
Inventory
>
Groups
>
Groups
Add or Remove IP Addresses from/to a Group
It will add or remove the specified IP Addresses from a given expression of a group.
This API is available when using VMware Cloud (AWS, Dell-EMC, Outpost, Hyperscalers) or VMware NSX-T.
Request:
Method:
POST
URI Path(s):
/policy/api/v1/infra/domains/<domain-id>/groups/<group-id>/ip-address-expressions/<expression-id>
Request Headers:
n/a
Query Parameters:
GroupMemberActionParameters
+
GroupMemberActionParameters
(
schema
)
Name
Description
Type
Notes
action
Add or Remove group members.
Action parameter determines whether to add or remove the group members.
string
Required
Enum: add, remove
Request Body:
IPAddressList
+
IPAddressList
(
schema
)
Name
Description
Type
Notes
ip_addresses
Array of IP addresses
The array contains IP addresses.
array of
IPElement
Required
Minimum items: 1
Maximum items: 4000
Example Request:
POST /infra/domains/default/groups/IPGroup/ip-address-expressions/ipaddressexp?action=add { "ip_addresses": [ "10.110.9.4-10.110.9.10", "10.110.9.3/24" ] } POST /infra/domains/default/groups/IPGroup/ip-address-expressions/ipaddressexp?action=remove { "ip_addresses": [ "10.110.9.4-10.110.9.10", "10.110.9.3/24" ] }
Successful Response:
Response Code:
200 OK
Response Headers:
n/a
Response Body:
n/a
Example Response:
200 OK
Required Permissions:
crud
Feature:
policy_grouping
Additional Errors:
404 Not Found
301 Moved Permanently
307 Temporary Redirect
400 Bad Request
403 Forbidden
409 Conflict
500 Internal Server Error
503 Service Unavailable