layout-3 layout-6 layout-1 layout-top
NVIDIA Docs Hubchevron_right NVIDIA Networkingchevron_right Networking Softwarechevron_right Management Softwarechevron_right

NVIDIA NetQ

layout-top layout-6 layout-1

Upgrade NVOS or Firmware

Use the REST API to upgrade NVOS or CPLD firmware on your switches. First, create a switch profile, then upload the image and track the progress of the upgrade.

Requirements

  • Download the NVOS or firmware image from the NVIDIA Enterprise Support Portal.
  • Only the admin or read-write user (rw-user) can perform the steps in this section.

Upgrade NVOS

You can upgrade NVOS at either the switch-level or domain-level. Switch-level operations are prioritized before domain-level operations.

  1. Authenticate your credentials by creating a switch profile. Make a POST request to the /v1/switch-profiles endpoint that contains your username and password. Copy the ProfileID from the response body.

  2. Upload the NVOS image by making a POST request to the /v1/images endpoint. After the image is successfully uploaded, the response body returns an ImageID.

  3. Make a POST request to the /v1/upgrade-switch endpoint; select switch-based NVOS upgrade and include the ProfileID and ImageID from the previous steps, in addition to the IP addresses of the switches you want to upgrade.

  4. If all initial validations succeed, the API returns an HTTP 202 Accepted response with a JSON body containing an operation ID. You can make a GET request to the /v1/operations/ endpoint to track the progress of the upgrade.

  1. Authenticate your credentials by creating a switch profile. Make a POST request to the /v1/switch-profiles endpoint that contains your username and password. Copy the ProfileID from the response body.

  2. Upload the NVOS image by making a POST request to the /v1/images endpoint. After the image is successfully uploaded, the response body returns an ImageID.

  3. Make a PATCH request to the /v1/domains/{id} endpoint to create an association between the profile ID from the first step and a given domain. The response body returns a DomainID.

  4. Make a POST request to the /v1/upgrade-switch endpoint; select domain-based NVOS upgrade and include the DomainID and ImageID from the previous steps.

  5. If all initial validations succeed, the API returns an HTTP 202 Accepted response with a JSON body containing an operation ID. You can make a GET request to the /v1/operations/ endpoint to track the progress of the upgrade.

Upgrade CPLD Firmware

You can upgrade firmware at either the switch-level or domain-level. Switch-level operations are prioritized before domain-level operations.

  1. Authenticate your credentials by creating a switch profile. Make a POST request to the /v1/switch-profiles endpoint that contains your username and password. Copy the ProfileID from the response body.

  2. Upload the firmware image by making a POST request to the /v1/images endpoint. After the image is successfully uploaded, the response body returns an ImageID.

  3. Make a POST request to the /v1/upgrade-switch endpoint; select switch-based CPLD firmware upgrade and include the ProfileID and ImageID from the previous steps, in addition to the IP addresses of the switches you want to upgrade.

  4. If all initial validations succeed, the API returns an HTTP 202 Accepted response with a JSON body containing an operation ID. You can make a GET request to the /v1/operations/ endpoint to track the progress of the upgrade.

  1. Authenticate your credentials by creating a switch profile. Make a POST request to the /v1/switch-profiles endpoint that contains your username and password. Copy the ProfileID from the response body.

  2. Upload the firmware image by making a POST request to the /v1/images endpoint. After the image is successfully uploaded, the response body returns an ImageID.

  3. Make a PATCH request to the /v1/domains/{id} endpoint to create an association between the profile ID from the first step and a given domain. The response body returns a DomainID.

  4. Make a POST request to the /v1/upgrade-switch endpoint; select domain-based CPLD firmware upgrade and include the DomainID and ImageID from the previous steps.

  5. If all initial validations succeed, the API returns an HTTP 202 Accepted response with a JSON body containing an operation ID. You can make a GET request to the /v1/operations/ endpoint to track the progress of the upgrade.

    Copyright © 2026  NVIDIA Corporation