Policy > Networking > Connectivity > Segments > Segments

Create or update a segment

If segment with the segment-id is not already present, create a new segment.
If it already exists, update the segment with specified attributes.

Force parameter is required when workload connectivity is indirectly impacted
with the current update.
This API is available when using VMware Cloud (AWS, Dell-EMC, Outpost, Hyperscalers) or VMware NSX-T.

Request:

Method:
PATCH
URI Path(s):
/policy/api/v1/infra/segments/<segment-id>?force=true
Request Headers:
n/a
Query Parameters:
n/a
Request Body:
Segment+

Example Request:

PATCH https://<policy-mgr>/policy/api/v1/infra/segments/web-tier>?force=true { "display_name":"web-tier", "subnets": [ { "gateway_address": "40.1.1.1/16", "dhcp_ranges": [ "40.1.2.0/24" ] } ], "connectivity_path": "/infra/tier-1s/mgw" }

Successful Response:

Response Code:
200 OK
Response Headers:
n/a
Response Body:
n/a

Example Response:

200 OK

Required Permissions:

crud

Feature:

policy_segment

Additional Errors: