Skip to main content

How to Extract Edge Details via Postman API

Stephanie R.
Updated

This guide will walk you through the process of extracting the details of your NSX Edges using Postman API.

 

Requirements

 

Background

  • GET is used to retrieve information from the given server using a given URI (Uniform Resource Identifier). When the GET request is used only data is retrieved.

  • POST is used to send data to the server, i.e. uploading a file or transferring some data to any kind of web form.

  • PUT is used for replacing the new data with existing data at the target resource.

 

Instructions

Adding or modifying user rights

From the OVHcloud Control Panel:

  1. Click Hosted Private Cloud from the top navigation menu.
  2. Click VMware in the left-hand navigation menu.
  3. Select your environment.
  4. Click Users.

edgedetails01.png

Create a user, or modify an existing user, to have the rights listed below.

  • Token Validator: No
  • IP: Yes
  • Failover IP: Yes
  • Status: Enabled

To modify the rights of an existing user, click the ... button in the user's row and select Edit.

edgedetails02.png

 

Once the correct rights have been established, click the ... button in the user's row and select View/Edit the rights for each DC.

edgedetails03.png

Check that the user has the rights listed below.

  • vSphere access: Read/Write
  • Add resources: Yes
  • Access to the VM Network: Operator
  • Access to the V(X)LANs: Administrator

If you need to modify existing rights, click the ... button in the user's row and select Modify rights.

edgedetails04.png

 

Retrieving Edge details using Postman API

NOTE: Make sure to have your Edge ID(s) on hand.

edgedetails06.png

 

From the Postman API interface, under the Authorization tab Type select Basic Auth and type your Username and Password to access NSX Edge details.

edgedetails05.png

 

Select GET and use the following syntax to display all the details of that Edge.

https://nsx.pcc-xxx-xxx-xxx-xxx.ovh.us/api/4.0/edges/<your edge ID>/

edgedetails07.png

 

If you do not have access to the vSphere web client and do not know the Edge ID but remember the Edge name, you can use the step below to find the Edge IDs.

Select GET and use the following syntax to display a list of Edges as well as their Edge IDs and Edge names.

https://nsx.pcc-xxx-xxx-xxx-xxx.ovh.us/api/4.0/edges/

edgedetails08*.png

 

Select GET and use the following syntax to display IPsec VPN tunnel details.

https://nsx.pcc-xxx-xxx-xxx-xxx.ovh.us/api/4.0/edges/<your edge ID>/ipsec/config

edgedetails09*.png

 

Select GET and use the following syntax to display NAT rules.

https://nsx.pcc-xxx-xxx-xxx-xxx.ovh.us/api/4.0/edges/<your edge ID>/nat/config

edgedetails10*.png

 

Select GET and use the following syntax to display Firewall rules.

https://nsx.pcc-xxx-xxx-xxx-xxx.ovh.us/api/4.0/edges/<your edge ID>/firewall/config

edgedetails11*.png

 

Go further

To see more options for your specific requirements, see VMware's NSX API guide.

Related articles