NSX-T Data Center REST API

Create or update VPC Group

If a VPC group with the group-id is not already present, create a new VPC group.
If it already exists, update the VPC group.

Request:

Method:
PUT
URI Path(s):
/policy/api/v1/orgs/{org-id}/projects/{project-id}/vpcs/{vpc-id}/groups/{group-id}
Request Headers:
n/a
Query Parameters:
n/a
Request Body:
Group+

Example Request:

PUT https://<policy-mgr>/policy/api/v1/orgs/org-1/projects/project-1/vpcs/vpc-1/groups/group-1 { "display_name": "test-group-abc", "description": "Group description", "expression": [ { "resource_type": "NestedExpression", "expressions": [ { "member_type": "VirtualMachine", "value": "vm_1", "key": "Name", "operator": "CONTAINS", "resource_type": "Condition" }, { "resource_type": "ConjunctionOperator", "conjunction_operator": "AND" }, { "member_type": "VirtualMachine", "value": "London", "key": "Tag", "operator": "EQUALS", "resource_type": "Condition" } ], "tags": [ { "scope": "scope1", "tag": "webvm" } ] }, { "resource_type": "ConjunctionOperator", "conjunction_operator": "OR" }, { "resource_type": "IPAddressExpression", "ip_addresses": [ "10.112.10.1" ] }, { "resource_type": "ConjunctionOperator", "conjunction_operator": "OR" }, { "resource_type": "PathExpression", "paths": [ "/orgs/default/projects/project-1/vpcs/vpc-1/groups/default" ] } ] }

Successful Response:

Response Code:
200 OK
Response Headers:
Content-type: application/json
Response Body:
Group+

Example Response:

{ "expression": [ { "expressions": [ { "member_type": "VirtualMachine", "key": "Name", "operator": "CONTAINS", "value": "vm_1", "resource_type": "Condition", "id": "1b654423-ebc4-4e8a-b59b-5d9728fdff72", "path": "/orgs/default/projects/project-1/vpcs/vpc-1/groups/group-1/condition-expressions/1b654423-ebc4-4e8a-b59b-5d9728fdff72", "relative_path": "1b654423-ebc4-4e8a-b59b-5d9728fdff72", "parent_path": "/orgs/default/projects/project-1/vpcs/vpc-1/groups/group-1", "remote_path": "", "marked_for_delete": false, "overridden": false, "_protection": "NOT_PROTECTED" }, { "conjunction_operator": "AND", "resource_type": "ConjunctionOperator", "id": "0d1502ac-6a5a-4f96-96b1-7909cdd32723", "path": "/orgs/default/projects/project-1/vpcs/vpc-1/groups/group-1/conjunction-expressions/0d1502ac-6a5a-4f96-96b1-7909cdd32723", "relative_path": "0d1502ac-6a5a-4f96-96b1-7909cdd32723", "parent_path": "/orgs/default/projects/project-1/vpcs/vpc-1/groups/group-1", "remote_path": "", "marked_for_delete": false, "overridden": false, "_protection": "NOT_PROTECTED" }, { "member_type": "VirtualMachine", "key": "Tag", "operator": "EQUALS", "scope_operator": "EQUALS", "value": "London", "resource_type": "Condition", "id": "02dc8bec-3eff-4420-b7d0-1000d9cd05ca", "path": "/orgs/default/projects/project-1/vpcs/vpc-1/groups/group-1/condition-expressions/02dc8bec-3eff-4420-b7d0-1000d9cd05ca", "relative_path": "02dc8bec-3eff-4420-b7d0-1000d9cd05ca", "parent_path": "/orgs/default/projects/project-1/vpcs/vpc-1/groups/group-1", "remote_path": "", "marked_for_delete": false, "overridden": false, "_protection": "NOT_PROTECTED" } ], "resource_type": "NestedExpression", "id": "24771eae-a906-45cc-acd3-db55fb1be68f", "path": "/orgs/default/projects/project-1/vpcs/vpc-1/groups/group-1/nested-expressions/24771eae-a906-45cc-acd3-db55fb1be68f", "relative_path": "24771eae-a906-45cc-acd3-db55fb1be68f", "parent_path": "/orgs/default/projects/project-1/vpcs/vpc-1/groups/group-1", "remote_path": "", "marked_for_delete": false, "overridden": false, "_protection": "NOT_PROTECTED" }, { "conjunction_operator": "OR", "resource_type": "ConjunctionOperator", "id": "f0040999-5a89-407f-8249-1b9387736f3d", "path": "/orgs/default/projects/project-1/vpcs/vpc-1/groups/group-1/conjunction-expressions/f0040999-5a89-407f-8249-1b9387736f3d", "relative_path": "f0040999-5a89-407f-8249-1b9387736f3d", "parent_path": "/orgs/default/projects/project-1/vpcs/vpc-1/groups/group-1", "remote_path": "", "marked_for_delete": false, "overridden": false, "_protection": "NOT_PROTECTED" }, { "ip_addresses": [ "10.112.10.1" ], "resource_type": "IPAddressExpression", "id": "59b40c96-6e57-4dbb-a651-9747c1f3aea1", "path": "/orgs/default/projects/project-1/vpcs/vpc-1/groups/group-1/ip-address-expressions/59b40c96-6e57-4dbb-a651-9747c1f3aea1", "relative_path": "59b40c96-6e57-4dbb-a651-9747c1f3aea1", "parent_path": "/orgs/default/projects/project-1/vpcs/vpc-1/groups/group-1", "remote_path": "", "marked_for_delete": false, "overridden": false, "_protection": "NOT_PROTECTED" }, { "conjunction_operator": "OR", "resource_type": "ConjunctionOperator", "id": "5d007106-177c-4d44-a2b2-16ea10ac4793", "path": "/orgs/default/projects/project-1/vpcs/vpc-1/groups/group-1/conjunction-expressions/5d007106-177c-4d44-a2b2-16ea10ac4793", "relative_path": "5d007106-177c-4d44-a2b2-16ea10ac4793", "parent_path": "/orgs/default/projects/project-1/vpcs/vpc-1/groups/group-1", "remote_path": "", "marked_for_delete": false, "overridden": false, "_protection": "NOT_PROTECTED" }, { "paths": [ "/orgs/default/projects/project-1/vpcs/vpc-1/groups/default" ], "resource_type": "PathExpression", "id": "69f7658c-3242-406e-9d39-0ee087d58732", "path": "/orgs/default/projects/project-1/vpcs/vpc-1/groups/group-1/path-expressions/69f7658c-3242-406e-9d39-0ee087d58732", "relative_path": "69f7658c-3242-406e-9d39-0ee087d58732", "parent_path": "/orgs/default/projects/project-1/vpcs/vpc-1/groups/group-1", "remote_path": "", "marked_for_delete": false, "overridden": false, "_protection": "NOT_PROTECTED" } ], "extended_expression": [], "reference": false, "resource_type": "Group", "id": "group-1", "display_name": "test-group-abc", "description": "Group description", "path": "/orgs/default/projects/project-1/vpcs/vpc-1/groups/group-1", "relative_path": "group-1", "parent_path": "/orgs/default/projects/project-1/vpcs/vpc-1", "remote_path": "", "unique_id": "1eac0c26-91e0-4c7c-a167-8beaa81f2944", "realization_id": "1eac0c26-91e0-4c7c-a167-8beaa81f2944", "owner_id": "72c3b609-e8c1-4afd-996a-c62639b7c123", "origin_site_id": "72c3b609-e8c1-4afd-996a-c62639b7c123", "marked_for_delete": false, "overridden": false, "_system_owned": false, "_create_time": 1674110189790, "_create_user": "admin", "_last_modified_time": 1674113039077, "_last_modified_user": "admin", "_protection": "NOT_PROTECTED", "_revision": 0 }

Required Permissions:

crud

Feature:

policy_grouping

Additional Errors: