Cisco Catalyst 8000V Edge Software Installation And Configuration Guide

PDF

Install the VM using REST API

Updated: March 5, 2026

Want to summarize with AI?

Log in

Overview

Provides the steps to install the Cisco Catalyst 8000V VM using the Nutanix REST API.

Provides the steps to install the Cisco Catalyst 8000V VM using the Nutanix REST API.

This installation method involves installation using a REST client like Postman. To create a VM using the Nutanix REST API, send a POST request to the Prism Central VM endpoint with a JSON that defines the VM specifications. Follow these steps to perform this installation.

Before you begin

You must have access to a REST client such as Postman.

Procedure

1.

Log in to the Prism Central GUI.
2.

On the top right corner of the page, click the drop-down arrow.
3.

Choose REST API Explorer.
4.

Configure these parameters in a REST client like Postman.

  1. REST Endpoint: Provide the details for the REST endpoint.

  2. HTTP Method: Specify the method, for example, POST.

  3. Authentication: Use Basic Auth with your Prism Central username and password.

  4. Credentials: Provide the credentials used to log in to the Prism Central GUI.
5.

Provide the JSON body for creating a VM using the details specified in the table.

Parameter

Specification

Disks

Hard disk with 20GB capacity

CDROM for the ISO image

CDROM for the bootstrap configuration

Networks

To get the list of networks to use for creating interfaces for the VM, use this REST API endpoint with a GET call: https://{Nutanix-Cluster-Id}/api/nutanix/v2.0/networks

Sample JSON

{
  "description": "VM with CD-ROM referencing image",
  "memory_mb": 8196,
  "name": "c8kv-test",
  "num_vcpus": 4,
  "num_cores_per_vcpu": 1,
  "machine_type": "Q35",
  "boot": {
    "uefi_boot": true
  },
  "vm_nics": [
    {
      "network_uuid": "77979a04-861b-48bf-a790-4306953e1b17",
      "connect": true
    },
    {
      "network_uuid": "d5eee64d-8510-4485-814d-a479959e48f3",
      "connect": true
    }
  ],
  "vm_disks": [
    {
      "disk_address": {
        "device_bus": "SCSI",
        "device_index": 0
      },
      "is_cdrom": false,
      "vm_disk_create": {
        "size": 21474836480,
        "storage_container_uuid": "61a44dc6-ca9c-4507-ae89-82705046e3e7"
      }
    },
    {
      "disk_address": {
        "device_bus": "SATA",
        "device_index": 0
      },
      "is_cdrom": true,
      "vm_disk_clone": {
        "disk_address": {
          "device_bus": "SATA",
          "device_index": 0,
          "vmdisk_uuid": "624b05b2-3e97-48a4-8d63-f47f8d9c56bc"
        }
      }
    },
    {
      "disk_address": {
        "device_bus": "SATA",
        "device_index": 1
      },
      "is_cdrom": true,
      "vm_disk_clone": {
        "disk_address": {
          "device_bus": "SATA",
          "device_index": 1,
          "vmdisk_uuid": "35df40b3-f6a3-48f1-bb93-c22e4cbf9144"
        }
      }
    }
  ]
}

Verify VM creation

To check the status of the REST API call, ensure that:

  • the HTTP response status is 201 created, and

  • the response body has a task_uuid returned.

Verify the task status by sending a GET request to this REST API endpoint: https://{Nutanix-Cluster-URL}/api/nutanix/v3/tasks/{task_uuid}