Cisco Intersight Ether API
The ether API from Cisco Intersight — 12 operation(s) for ether.
Cisco Intersight Ether API is one of 117 APIs that Cisco Intersight publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include ether. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, and rate-limit docs.
This API exposes 18 operations across 12 paths, and defines 119 schemas. It is described by OpenAPI 3.2.0, at version 1.0.11-20260807064027971.
Requests are made against a single base URL, https://{server}.
18 operations
12 paths
119 schemas
12 GET3 PATCH3 POST
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 3
Cisco Intersight Ether API declares
3 security schemes
for authenticating requests.
An API key is passed in the cookie as X-Starship-Token (cookieAuth).
It uses HTTP signature authentication (http_signature).
It supports OAuth 2.0 (oAuth2) using the authorizationCode and clientCredentials flows, exposing 3315 scopes.
cookieAuth— The authentication cookie obtained from a Single-Sign-On SAML assertion.http_signature— The 'HTTP signature' security scheme. Each HTTP request is cryptographically signed as specified in https://datatracker.ietf.org/doc/draft-cavage-http-signatur…oAuth2— The client uses the OAuth2 security scheme. To use OAuth2, a client application must be registered by creating a iam.AppRegistration resource. The user who cre…
Paths & Operations 18
Across 12 paths, the API surfaces 18 operations — 12 GET, 3 PATCH, 3 POST. Each is listed below with its method, path, parameters, and response codes.
ether 18
GET
/api/v1/ether/HostPorts
Read a 'ether.HostPort' resource.
GET
/api/v1/ether/HostPorts/{Moid}
Read a 'ether.HostPort' resource.
POST
/api/v1/ether/HostPorts/{Moid}
Update a 'ether.HostPort' resource.
PATCH
/api/v1/ether/HostPorts/{Moid}
Update a 'ether.HostPort' resource.
GET
/api/v1/ether/InterSwitchPorts
Read a 'ether.InterSwitchPort' resource.
GET
/api/v1/ether/InterSwitchPorts/{Moid}
Read a 'ether.InterSwitchPort' resource.
GET
/api/v1/ether/LanPorts
Read a 'ether.LanPort' resource.
GET
/api/v1/ether/LanPorts/{Moid}
Read a 'ether.LanPort' resource.
GET
/api/v1/ether/NetworkPorts
Read a 'ether.NetworkPort' resource.
GET
/api/v1/ether/NetworkPorts/{Moid}
Read a 'ether.NetworkPort' resource.
POST
/api/v1/ether/NetworkPorts/{Moid}
Update a 'ether.NetworkPort' resource.
PATCH
/api/v1/ether/NetworkPorts/{Moid}
Update a 'ether.NetworkPort' resource.
GET
/api/v1/ether/PhysicalPorts
Read a 'ether.PhysicalPort' resource.
GET
/api/v1/ether/PhysicalPorts/{Moid}
Read a 'ether.PhysicalPort' resource.
POST
/api/v1/ether/PhysicalPorts/{Moid}
Update a 'ether.PhysicalPort' resource.
PATCH
/api/v1/ether/PhysicalPorts/{Moid}
Update a 'ether.PhysicalPort' resource.
GET
/api/v1/ether/PortChannels
Read a 'ether.PortChannel' resource.
GET
/api/v1/ether/PortChannels/{Moid}
Read a 'ether.PortChannel' resource.
Schemas 119
The contract defines 119 schemas that model the data the API accepts and returns. Each schema is shown below with its type and property counts.
port.SubGroup.Relationship
A relationship to the 'port.SubGroup' resource, or the expanded 'port.SubGroup' resource, or the 'null' value.
network.VpcMember
Concrete class for VPC configured on a network device.
network.LicenseFile
Displays license information.
ether.LanPort.Response
The response body of a HTTP GET request for the 'ether.LanPort' resource. The value may be one of the following types. 1. When 'tag' is specified in the URL qu…
equipment.Fan
The equipment.Fan object represents an individual cooling fan within a larger piece of equipment, such as a fan module, chassis, or Fabric Extender (FEX). Purp…
network.LicenseFile.Relationship
A relationship to the 'network.LicenseFile' resource, or the expanded 'network.LicenseFile' resource, or the 'null' value.
equipment.Fex
The equipment.FEX object represents a Fabric Extender (FEX), a device that acts as a remote line card for a parent Fabric Interconnect. It multiplexes traffic…
fc.PortChannel
Fibre Channel (FC) port channels in a Fabric Interconnect are logical links that aggregate multiple physical Fibre Channel (FC) ports into a single virtual con…
ether.HostPort.Relationship
A relationship to the 'ether.HostPort' resource, or the expanded 'ether.HostPort' resource, or the 'null' value.
equipment.PsuControl
The equipment.PsuControl object represents the overall power state and redundancy configuration of the Power Supply Units (PSUs) within a chassis. Purpose The…
port.Group.Relationship
A relationship to the 'port.Group' resource, or the expanded 'port.Group' resource, or the 'null' value.
equipment.Chassis.Relationship
A relationship to the 'equipment.Chassis' resource, or the expanded 'equipment.Chassis' resource, or the 'null' value.
equipment.PsuControl.Relationship
A relationship to the 'equipment.PsuControl' resource, or the expanded 'equipment.PsuControl' resource, or the 'null' value.
fc.Neighbor
Concrete class for switch and N port virtualization neighbors present in various interfaces of a switch.
network.FcZoneInfo.Relationship
A relationship to the 'network.FcZoneInfo' resource, or the expanded 'network.FcZoneInfo' resource, or the 'null' value.
network.SupervisorCard
Concrete class for supervisor card.
ether.InterSwitchPort.Response
The response body of a HTTP GET request for the 'ether.InterSwitchPort' resource. The value may be one of the following types. 1. When 'tag' is specified in th…
fc.PhysicalPort.Relationship
A relationship to the 'fc.PhysicalPort' resource, or the expanded 'fc.PhysicalPort' resource, or the 'null' value.
equipment.ChassisOperationsDetails
The status of completed and in-progress chassis operations.
network.SecureRouter.Relationship
A relationship to the 'network.SecureRouter' resource, or the expanded 'network.SecureRouter' resource, or the 'null' value.
ether.InterSwitchPort
An Inter-Switch Port (ISP) represents the port which connects the two switches. In the context of Unified Edge, an ISP typically refers to the connection betwe…
equipment.Fru
The equipment.Fru object represents a Field-Replaceable Unit (FRU). It is a special object used to track the history and state changes of hardware components t…
equipment.FanControl
This represents the states of Fan equipment.
equipment.FanModule
The equipment.FanModule object represents a physical, often hot-swappable, module that houses one or more individual fans. These modules are key components for…
ether.MacsecOperData
Configuration information for the MacSecPolicy configured on an Ethernet uplink port or uplink port channel.
equipment.IoCard.Relationship
A relationship to the 'equipment.IoCard' resource, or the expanded 'equipment.IoCard' resource, or the 'null' value.
ether.HostPort.List
This resource list is returned as a response to a HTTP GET request that does not include a specific resource identifier.
ether.NetworkPort.List
This resource list is returned as a response to a HTTP GET request that does not include a specific resource identifier.
equipment.SwitchCard.Relationship
A relationship to the 'equipment.SwitchCard' resource, or the expanded 'equipment.SwitchCard' resource, or the 'null' value.
port.SubGroup
Holder for multiple ports within a portGroup. SubGroup represents a break-out port group on the Fabric Interconnect.
network.Vrf
Concrete class for virtual routing and forwarding.
port.MacBinding.Relationship
A relationship to the 'port.MacBinding' resource, or the expanded 'port.MacBinding' resource, or the 'null' value.
network.DiscoveredNeighbor.Relationship
A relationship to the 'network.DiscoveredNeighbor' resource, or the expanded 'network.DiscoveredNeighbor' resource, or the 'null' value.
port.InterfaceBase
Abstract Interface Base class for a virtual interface card/Fex Network Port.
fc.PhysicalPort
The physical interface on the Fabric Interconnect to which a Fibre Channel (FC) target can be connected to within a data center.
network.Vethernet.Relationship
A relationship to the 'network.Vethernet' resource, or the expanded 'network.Vethernet' resource, or the 'null' value.
ether.NetworkPort
The ether.NetworkPort object represents a network-facing port on a Fabric Extender (FEX) or I/O Module (IOM). These ports, also known as Network Interfaces (NI…
port.MacBinding
Establishes relationship between the ports and connected end points based on LLDP TLVs.
ether.PortChannel.Response
The response body of a HTTP GET request for the 'ether.PortChannel' resource. The value may be one of the following types. 1. When 'tag' is specified in the UR…
equipment.IoCard
The equipment.IoCard (IOM) object represents an I/O Module, a critical component in a blade chassis that multiplexes and forwards network traffic between the b…
network.FcZoneInfo
FC Zone information of a Fabric Interconnect.
network.DiscoveredNeighbor
L2 neighbor (LLDP and CDP) available on the switch.
ether.LanPort
The ether.LanPort object represents a physical LAN port on a networking router or switch.
equipment.Sensor
The equipment.Sensor object represents a hardware sensor on a network device that monitors a specific environmental or operational metric, such as temperature,…
network.Vethernet
Vethernet configured on a Fabric Interconnect.
network.SecureRouterInfo
Information about secure routers detected, discovered and configured.
equipment.ExpanderModule.Relationship
A relationship to the 'equipment.ExpanderModule' resource, or the expanded 'equipment.ExpanderModule' resource, or the 'null' value.
equipment.SwitchCard
The equipment.SwitchCard object represents a physical module, either fixed or removable, within a Fabric Interconnect or network switch. This can be a main sup…
ether.PhysicalPortBase.Relationship
A relationship to the 'ether.PhysicalPortBase' resource, or the expanded 'ether.PhysicalPortBase' resource, or the 'null' value.
ether.PhysicalPort.Relationship
A relationship to the 'ether.PhysicalPort' resource, or the expanded 'ether.PhysicalPort' resource, or the 'null' value.
port.Group
Holder for multiple ports. A switch card will have one or more port groups.
ether.InterSwitchPort.List
This resource list is returned as a response to a HTTP GET request that does not include a specific resource identifier.
ether.LanPort.List
This resource list is returned as a response to a HTTP GET request that does not include a specific resource identifier.
equipment.Psu
The equipment.Psu object represents a Power Supply Unit, a fundamental component responsible for providing electrical power to a server, chassis, or network sw…
network.VpcPeer
Concrete class for VPC peer configured on a network device.
ether.PhysicalPort
Physical ethernet port present on a FI.
equipment.SharedIoModule
The equipment.SharedIoModule object represents a shared I/O module (SIOM), which is an adapter-like component typically found in a System I/O Controller (SIOC)…
network.InterfaceList.Relationship
A relationship to the 'network.InterfaceList' resource, or the expanded 'network.InterfaceList' resource, or the 'null' value.
equipment.ChassisController.Relationship
A relationship to the 'equipment.ChassisController' resource, or the expanded 'equipment.ChassisController' resource, or the 'null' value.
ether.LanPort.Relationship
A relationship to the 'ether.LanPort' resource, or the expanded 'ether.LanPort' resource, or the 'null' value.
network.Dns.Relationship
A relationship to the 'network.Dns' resource, or the expanded 'network.Dns' resource, or the 'null' value.
equipment.LocatorLed.Relationship
A relationship to the 'equipment.LocatorLed' resource, or the expanded 'equipment.LocatorLed' resource, or the 'null' value.
ether.NetworkPort.Response
The response body of a HTTP GET request for the 'ether.NetworkPort' resource. The value may be one of the following types. 1. When 'tag' is specified in the UR…
fc.Neighbor.Relationship
A relationship to the 'fc.Neighbor' resource, or the expanded 'fc.Neighbor' resource, or the 'null' value.
network.FeatureControl
List of features available on a switch along with the index and admin state. These features will allow the user to perform certain set of actions on the switch…
ether.HostPort.Response
The response body of a HTTP GET request for the 'ether.HostPort' resource. The value may be one of the following types. 1. When 'tag' is specified in the URL q…
equipment.Chassis
The equipment.Chassis object represents a physical chassis, a modular enclosure that houses and provides power, cooling, and connectivity for multiple blade se…
network.VpcDomain
Concrete class for VPC domain configured on a network device. VPC (Virtual Port Channel) domain is used to connect two different switches logically to a single…
network.SecureRouter
A Cisco Secure Router inventoried and managed by Intersight.
equipment.IoCardBase
Abstract class for hif and nif ports collection that can be extended by chassis/febric extender.
equipment.Fex.Relationship
A relationship to the 'equipment.Fex' resource, or the expanded 'equipment.Fex' resource, or the 'null' value.
network.Vrf.Relationship
A relationship to the 'network.Vrf' resource, or the expanded 'network.Vrf' resource, or the 'null' value.
network.VpcDomain.Relationship
A relationship to the 'network.VpcDomain' resource, or the expanded 'network.VpcDomain' resource, or the 'null' value.
equipment.Sensor.Relationship
A relationship to the 'equipment.Sensor' resource, or the expanded 'equipment.Sensor' resource, or the 'null' value.
equipment.Fan.Relationship
A relationship to the 'equipment.Fan' resource, or the expanded 'equipment.Fan' resource, or the 'null' value.
equipment.RackEnclosure.Relationship
A relationship to the 'equipment.RackEnclosure' resource, or the expanded 'equipment.RackEnclosure' resource, or the 'null' value.
equipment.SharedIoModule.Relationship
A relationship to the 'equipment.SharedIoModule' resource, or the expanded 'equipment.SharedIoModule' resource, or the 'null' value.
ether.PhysicalPort.List
This resource list is returned as a response to a HTTP GET request that does not include a specific resource identifier.
ether.PortChannel.Relationship
A relationship to the 'ether.PortChannel' resource, or the expanded 'ether.PortChannel' resource, or the 'null' value.
network.Vfc
Vfc configured on a Fabric Interconnect.
equipment.FanControl.Relationship
A relationship to the 'equipment.FanControl' resource, or the expanded 'equipment.FanControl' resource, or the 'null' value.
port.InterfaceBase.Relationship
A relationship to the 'port.InterfaceBase' resource, or the expanded 'port.InterfaceBase' resource, or the 'null' value.
ether.PhysicalPortBase
Abstract class for ether physical port and host port.
equipment.Psu.Relationship
A relationship to the 'equipment.Psu' resource, or the expanded 'equipment.Psu' resource, or the 'null' value.
network.Element.Relationship
A relationship to the 'network.Element' resource, or the expanded 'network.Element' resource, or the 'null' value.
network.Dns
Concrete class for list of DNS servers configured on the nexus end point.
equipment.SystemIoController
The equipment.SystemIoController (SIOC) object represents an I/O controller on a chassis, specifically designed to provide the data path for Cisco S-Series sto…
fc.PortChannel.Relationship
A relationship to the 'fc.PortChannel' resource, or the expanded 'fc.PortChannel' resource, or the 'null' value.
equipment.IoCardBase.Relationship
A relationship to the 'equipment.IoCardBase' resource, or the expanded 'equipment.IoCardBase' resource, or the 'null' value.
ether.PortChannel.List
This resource list is returned as a response to a HTTP GET request that does not include a specific resource identifier.
equipment.FanModule.Relationship
A relationship to the 'equipment.FanModule' resource, or the expanded 'equipment.FanModule' resource, or the 'null' value.
equipment.SharedAdapterUnit.Relationship
A relationship to the 'equipment.SharedAdapterUnit' resource, or the expanded 'equipment.SharedAdapterUnit' resource, or the 'null' value.
network.SupervisorCard.Relationship
A relationship to the 'network.SupervisorCard' resource, or the expanded 'network.SupervisorCard' resource, or the 'null' value.
network.InterfaceList
List of interfaces available on the switch to describe the available port inventory information.
equipment.Base.Relationship
A relationship to the 'equipment.Base' resource, or the expanded 'equipment.Base' resource, or the 'null' value.
equipment.ChassisController
Chassis Controller represents the controller embedded within a network element that manages a chassis.
equipment.SharedAdapterUnit
The shared physical adapter present on the XFM module.
network.FeatureControl.Relationship
A relationship to the 'network.FeatureControl' resource, or the expanded 'network.FeatureControl' resource, or the 'null' value.
equipment.SystemIoController.Relationship
A relationship to the 'equipment.SystemIoController' resource, or the expanded 'equipment.SystemIoController' resource, or the 'null' value.
ether.PortChannel
Ethernet port channels in a Fabric Interconnect are logical interfaces created by aggregating multiple physical Ethernet ports. This configuration enhances ban…
network.Element
The Cisco UCS Fabric Interconnect module within a domain supporting a range of models including the 6400, 6500 series etc.
port.Physical
Abstract super class for all ports.
equipment.RackEnclosureSlot
The equipment.RackEnclosureSlot object represents a physical slot within a rack enclosure that is designed to hold a rack-mounted server. Purpose The main func…
console.ConsoleConfig
The console.ConsoleConfig object represents the configuration of a terminal console port on a network device. This provides inventory details for the asynchron…
console.ConsoleConfig.Relationship
A relationship to the 'console.ConsoleConfig' resource, or the expanded 'console.ConsoleConfig' resource, or the 'null' value.
equipment.Base
Abstract base class for all equipments which have a vendor /model / serial.
network.Vfc.Relationship
A relationship to the 'network.Vfc' resource, or the expanded 'network.Vfc' resource, or the 'null' value.
equipment.RackEnclosure
The equipment.RackEnclosure object represents a physical enclosure that houses multiple rack-mounted servers, providing shared infrastructure like power and co…
equipment.LocatorLed
The equipment.LocatorLed object represents the physical locator LED (Light Emitting Diode) on a piece of equipment, such as a server, chassis, or Fabric Interc…
ether.InterSwitchPort.Relationship
A relationship to the 'ether.InterSwitchPort' resource, or the expanded 'ether.InterSwitchPort' resource, or the 'null' value.
equipment.Fru.Relationship
A relationship to the 'equipment.Fru' resource, or the expanded 'equipment.Fru' resource, or the 'null' value.
equipment.RackEnclosureSlot.Relationship
A relationship to the 'equipment.RackEnclosureSlot' resource, or the expanded 'equipment.RackEnclosureSlot' resource, or the 'null' value.
ether.HostPort
The ether.HostPort object represents a host-facing physical port on an I/O Module (IOM) or Fabric Extender (FEX). These ports provide the physical connection f…
network.VpcPeer.Relationship
A relationship to the 'network.VpcPeer' resource, or the expanded 'network.VpcPeer' resource, or the 'null' value.
equipment.ExpanderModule
The equipment.ExpanderModule object represents a physical expander module installed within a chassis. These modules typically provide additional connectivity o…
network.VpcMember.Relationship
A relationship to the 'network.VpcMember' resource, or the expanded 'network.VpcMember' resource, or the 'null' value.
ether.PhysicalPort.Response
The response body of a HTTP GET request for the 'ether.PhysicalPort' resource. The value may be one of the following types. 1. When 'tag' is specified in the U…
network.VlanPortInfo
Vlan Port information of a Fabric Interconnect.
network.VlanPortInfo.Relationship
A relationship to the 'network.VlanPortInfo' resource, or the expanded 'network.VlanPortInfo' resource, or the 'null' value.
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Cisco Intersight 12
Other APIs Cisco Intersight publishes across the network.
Cisco Intersight Aaa API
Cisco Intersight Access API
Cisco Intersight Adapter API
Cisco Intersight Apiproxy API
Cisco Intersight Appliance API
Cisco Intersight Asset API
Cisco Intersight Auditd API
Cisco Intersight Bios API
Cisco Intersight Boot API
Cisco Intersight Bulk API
Cisco Intersight Capability API
Cisco Intersight Catalystsdwan API
#ether
Where this information came from
This is an independent, third-party profile of Cisco Intersight Ether API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.