Policy > Networking > Connectivity > Segments > Ports

Get infra segment port by ID

Get detail information on an infra segment port by giving ID.
This API is available when using VMware Cloud (AWS, Dell-EMC, Outpost, Hyperscalers) or VMware NSX-T.

Request:

Method:
GET
URI Path(s):
/policy/api/v1/infra/segments/<segment-id>/ports/<port-id>
/policy/api/v1/global-infra/segments/<segment-id>/ports/<port-id>
Request Headers:
n/a
Query Parameters:
n/a
Request Body:
n/a

Example Request:

PUT https://<policy-mgr>/policy/api/v1/infra/segments/web-tier/ports/port1 { "address_bindings": [ { "ip_address":"1.1.1.1", "mac_address":"aa:bb:cc:dd:ee:ff" }, { "ip_address":"1.1.1.2", "mac_address":"aa:bb:cc:dd:ee:f1" } ], "tags": [ {"tag":"port-1 tag 1 from Policy","scope":"Policy"} ] }

Successful Response:

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

Example Response:

{ "resource_type": "SegmentPort", "id": "port1", "display_name": "port1", "path": "/infra/segments/web-tier/ports/port1", "relative_path": "port1", "parent_path": "/infra/segments/web-tier", "address_bindings": [ { "ip_address":"1.1.1.1", "mac_address":"aa:bb:cc:dd:ee:ff" "vlan_id": 0 }, { "ip_address":"1.1.1.2", "mac_address":"aa:bb:cc:dd:ee:f1" "vlan_id": 0 } ], "tags": [ { "tag":"port-1 tag 1 from Policy", "scope":"Policy" } ], "marked_for_delete": false, "_create_user": "admin", "_create_time": 1544503100539, "_last_modified_user": "admin", "_last_modified_time": 1544503100539, "_system_owned": true, "_protection": "NOT_PROTECTED", "_revision": 0 }

Required Permissions:

read

Feature:

policy_segment

Additional Errors: