Policy > Networking > Connectivity > Segments > Segments

Associated URIs:

API Description API Path

List all segments under infra


Paginated list of all segments under infra.
GET /policy/api/v1/infra/segments
GET /policy/api/v1/global-infra/segments

Delete infra segment


Delete infra segment
DELETE /policy/api/v1/infra/segments/<segment-id>

Force delete infra segment


Force delete bypasses validations during segment deletion. This may result in an inconsistent connectivity.
DELETE /policy/api/v1/infra/segments/<segment-id>?force=true

Read infra segment


Read infra segment
GET /policy/api/v1/infra/segments/<segment-id>
GET /policy/api/v1/global-infra/segments/<segment-id>

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.
PATCH /policy/api/v1/infra/segments/<segment-id>?force=true

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.
PATCH /policy/api/v1/infra/segments/<segment-id>

Create or update a infra segment


If segment with the segment-id is not already present, create a new segment.
If it already exists, replace the segment with this object.
PUT /policy/api/v1/infra/segments/<segment-id>

Create or update a infra segment


If segment with the segment-id is not already present, create a new segment.
If it already exists, replace the segment with this object.

Force parameter is required when workload connectivity is indirectly impacted
with the current replacement.
PUT /policy/api/v1/infra/segments/<segment-id>?force=true