How to retrieve APH UUID via NSX API in VMware NSX
search cancel

How to retrieve APH UUID via NSX API in VMware NSX

book

Article ID: 449828

calendar_today

Updated On:

Products

VMware NSX

Issue/Introduction

KB 373270 describes a procedure to obtain the APH (Appliance Proxy Hub) UUID by accessing /etc/vmware/nsx-appl-proxy/appl-proxy-public-cfg.json with root privileges.
However, if root account access is unavailable on the NSX Manager appliance, this file cannot be read directly.
This article provides an alternative method to retrieve the APH UUID (Node ID) using the NSX REST API (with admin credentials).

Environment

VMware NSX 4.2.x

Resolution

The node_id (APH UUID) of connected peer nodes can be identified by executing the following API request against each NSX Manager node:
Note: To obtain the APH UUIDs for all nodes in the cluster, this API request executed against each NSX Manager node individually.

GET https://<NSX-Manager-FQDN-or-IP>/api/v1/messaging/cluster-connection/status
{
    "results": [
        {
            "address": "ssl://<Peer-Node-1-IP/FQDN>:***",
            "conn_status": "Connected",
            "node_id": "########-####-####-####-############", <===== APH UUID of Peer Node 1
            "node_type": "APPLIANCE_PROXY_HUB"
        },
        {
            "address": "ssl://<Peer-Node-2-IP/FQDN>:***",
            "conn_status": "Connected",
            "node_id": "########-####-####-####-############", <===== APH UUID of Peer Node 2
            "node_type": "APPLIANCE_PROXY_HUB"
        }
    ]
}

Additional Information

Verify Appliance Proxy Hub on all NSX Manager Nodes are Connected
After replacing APH-TN or APH-AR certificates, connections between Manager nodes or between GM and LM are disconnected