Mist API Reference
Mist Automation Guide
HomeSDKsAPI ReferenceContext Plugin
SitesDevicesWiredVirtual Chassis

changeSiteSwitchVcPortMode

POST
/api/v1/sites/{site_id}/devices/{device_id}/set_vc_port_mode

Change VCP port mode

Some switch model allows changing VCP port behaviors, e.g. - use them as regular network ports - change vcp protocol Note, this command will reboot the switch

Authorization

Authorization<token>

Preferred authentication method for automation and integrations. Send the API token in the HTTP Authorization header.

Format: Authorization: Token {apitoken}

Notes:

  • An API token generated for a specific admin has the same privileges as that admin
  • An API token is automatically removed if it is not used for more than 90 days
  • SSO admins cannot generate admin API tokens. Use organization API tokens when scoped Org/Site privileges are needed.

In: header

Path Parameters

site_id*string
Formatuuid
device_id*string
Formatuuid

Request Body

application/json

Request Body

Request to change the Virtual Chassis port mode on a switch

mode?vc_port_mode

Virtual Chassis port mode to apply. enum: network, vcp-higig, vcp-hgoe.

Value in

  • "network"
  • "vcp-higig"
  • "vcp-hgoe"

Response Body

curl -X POST "https://example.com/api/v1/sites/000000ab-00ab-00ab-00ab-0000000000ab/devices/000000ab-00ab-00ab-00ab-0000000000ab/set_vc_port_mode" \  -H "Content-Type: application/json" \  -d '{    "mode": "network"  }'
Empty

updateSiteLocalSwitchPortConfig PUT

API Calls to add port config local overrides. This can be used by Switch Port Operators or Helpdesk administrators to change a Switch Port configuration without having to change the switch configuration. The local overrides configured for the switchports with `no_local_overwrite`==`true` won't be applied to the switch configuration. > NOTE: > > When using the API Call, it is required to put send all overrides in the PUT request Payload, even the existing once. > > The current overrides can be retrieved with the API Call [Get Site Device](/api/mist/sites/sites-devices/getSiteDevice). The local overrides will show up separately from the `port_config` in the `local_port_config` so it can be easily identified (and cleared)

convertSiteVirtualChassisToVirtualMac POST

Converts an FPC0-based VC to a Virtualmac VC, removing the limitation where the device ID must change whenever FPC0 is renumbered or removed. HTTP400 Error possible reasons: - The device is not an OC device - Virtualmac VC is disabled in the Org Knob settings - The VC is already a Virtualmac VC - The VC is currently disconnected - The device is standalone - A new FPC0 exists with its own device config, causing ambiguity.