Search the VMware Knowledge Base (KB)
View by Article ID

Process to change VXLAN port from 8472 to 4789 may fail or never complete (2149996)

  • 1 Ratings
Language Editions


The process may fail or never complete while changing the VXLAN port from 8472 to 4789 (standard port assigned by IANA).

: Starting with NSX 6.2.4, the default VXLAN port is 4789, the standard port assigned by IANA. In versions earlier to NSX 6.2.4, the default VXLAN UDP port number was 8472.


To resolve the issue, run the REST API calls to check the status of the job and resume the change.


  • Verify that the port for VXLAN is not blocked by a firewall.
  • Verify that host preparation is not running at the same time as the VXLAN port change.


  1. Check the status of the job by running GET REST API call.

    Method: GET
    URL:  https://NSXM-IP/api/2.0/vdn/config/vxlan/udp/port/taskStatus
    Sample Output: 
    <?xml version="1.0" encoding="UTF-8"?>

  2. Resume the job by running the POST REST API call.

    Method: POST
    URL: https://NSXM-IP/api/2.0/vdn/config/vxlan/udp/port/resume
    <?xml version="1.0" encoding="UTF-8"?>

For more information, see Change VXLAN Port.

See Also

Request a Product Feature

To request a new product feature or to provide feedback on a VMware product, please visit the Request a Product Feature page.


  • 1 Ratings

Did this article help you?
This article resolved my issue.
This article did not resolve my issue.
This article helped but additional information was required to resolve my issue.

What can we do to improve this information? (4000 or fewer characters)

Please enter the Captcha code before clicking Submit.
  • 1 Ratings