Policy > Networking > Connectivity > Segments > Ports

Get Tier-1 segment port by ID

Get detail information on a Tier-1 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/global-infra/tier-1s/<tier-1-id>/segments/<segment-id>/ports/<port-id>
/policy/api/v1/infra/tier-1s/<tier-1-id>/segments/<segment-id>/ports/<port-id>
Request Headers:
n/a
Query Parameters:
n/a
Request Body:
n/a

Example Request:

GET https://<policy-mgr>/policy/api/v1/infra/tier-1s/cgw/segments/web-tier/ports/port1

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/tier-1s/cgw/segments/web-tier/ports/port1", "relative_path": "port1", "parent_path": "/infra/tier-1s/cgw/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: