Policy >
Inventory
>
Groups
>
Groups
Add or Remove MAC Addresses from/to a Group
It will add or remove the specified MAC 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>/mac-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:
MACAddressList
+
MACAddressList
(
schema
)
Name
Description
Type
Notes
mac_addresses
Array of MAC addresses
The array contains MAC addresses.
array of
MACAddress
Required
Minimum items: 1
Maximum items: 4000
Example Request:
POST /infra/domains/default/groups/MACGroup/mac-address-expressions/macaddressexp?action=add { "mac_addresses": [ "00:0a:95:9d:68:16", "00:0a:95:9d:68:17" ] } POST /infra/domains/default/groups/MACGroup/mac-address-expressions/macaddressexp?action=remove { "mac_addresses": [ "00:0a:95:9d:68:16", "00:0a:95:9d:68:17" ] }
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