Good morning team,
With 1.53.0 we're releasing these new operations which can streamline your telemetry gathering. If you are using getDeviceSwitchPortsStatuses at any scale, iterating over the devices in your organization, then these new operations, designed for specific use cases, will help you get more done in fewer API calls.
getOrganizationSwitchPortsClientsOverviewByDevice: List the number of clients for all switchports with at least one online client in an organization. If you're reporting on per-port client counts, then this operation meets that need.
getOrganizationSwitchPortsOverview: Returns the counts of all active ports for the requested timespan, grouped by speed. An active port is a port that at any point during the timeframe is observed to be connected to a responsive device and isn't configured to be disabled. The number of inactive ports, and the total number of ports are also provided. If you are reporting on overall port count utilization, then this operation meets that need without iterating over devices or networks.
getOrganizationSwitchPortsTopologyDiscoveryByDevice: List most recently seen LLDP/CDP discovery and topology information per switch port in an organization. If you're collecting discovery telemetry across all of your switches, this operation has you covered.
getOrganizationSwitchPortsStatusesBySwitch: Retrieve all of the per-port statuses across switches in an organization. If you're wondering which ports might have errors, warnings, spanning tree information, or whether they're uplinks, allocating PoE, or using SecurePort, this operation has you covered.
