How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Zededa EdgeDiagnostics API

The EdgeDiagnostics API from Zededa — 12 operation(s) for edgediagnostics.

Zededa EdgeDiagnostics API is one of 35 APIs that Zededa publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include EdgeDiagnostics. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 13 operations across 12 paths, and defines 133 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against a single base URL, /api.

13 operations 12 paths 133 schemas 12 GET1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://zedcontrol.zededa.net/api
Authentication
API Key
License
Terms of Service
Resource Areas
1

Authentication & Security 1

Zededa EdgeDiagnostics API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (BearerToken). By default, every request must be authenticated.

  • BearerToken — Bearer token for user session

Paths & Operations 13

Across 12 paths, the API surfaces 13 operations — 12 GET, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

EdgeDiagnostics 13
GET
/v1/devices/id/{id}/config
Get current Device twin configuration
EdgeDiagnostics_GetDeviceTwinConfig 2 params → 200400401403404500504default
PUT
/v1/devices/id/{id}/config
Re-generate device configuration
EdgeDiagnostics_RegenDeviceConfig 2 params → 200400401403404500504default
GET
/v1/devices/id/{id}/config/bootstrap
Get bootstrap Device twin configuration
EdgeDiagnostics_GetDeviceTwinBootstrapConfig 2 params → 200400401403404405500504
GET
/v1/devices/id/{id}/config/next
Get next Device twin configuration
EdgeDiagnostics_GetDeviceTwinNextConfig 2 params → 200400401403404500504default
GET
/v1/devices/id/{id}/config/offline
Get offline Device twin configuration
EdgeDiagnostics_GetDeviceTwinOfflineNextConfig 2 params → 200400401403404500504default
GET
/v1/devices/name/{name}/config
Get current Device twin configuration
EdgeDiagnostics_GetDeviceTwinConfigByName 2 params → 200400401403404500504default
GET
/v1/devices/name/{name}/config/bootstrap
Get bootstrap Device twin configuration
EdgeDiagnostics_GetDeviceTwinBootstrapConfigByName 2 params → 200400401403404405500504
GET
/v1/devices/name/{name}/config/next
Get next Device twin configuration
EdgeDiagnostics_GetDeviceTwinNextConfigByName 2 params → 200400401403404500504default
GET
/v1/devices/name/{name}/config/offline
Get offline Device twin configuration
EdgeDiagnostics_GetDeviceTwinOfflineConfigByName 2 params → 200400401403404500504default
GET
/v1/events
Get events timeline
EdgeDiagnostics_GetEventsTimeline 4 params → 200400401403500504default
GET
/v1/events/timeSeries/{mType}
Get resource usage timeline
EdgeDiagnostics_GetResourceMetricsTimeline 9 params → 200400401403500504default
GET
/v1/events/topUsers
Get top users
EdgeDiagnostics_GetTopUsers2 1 param → 200400401403500504default
GET
/v1/timeSeries/{mType}
Get resource usage timeline
EdgeDiagnostics_GetResourceMetricsTimeline2 9 params → 200400401403500504default

Schemas 133

The contract defines 133 schemas that model the data the API accepts and returns. The most detailed are configEdgeDevConfig (37 properties), configVmConfig (26 properties), configAppInstanceConfig (24 properties), configNetworkInstanceConfig (16 properties). Each schema is shown below with its type and property counts.

commonCipherContext
object
6 properties
configVmBootMode
string
commonProxyConfig
object
6 properties
commonCellularIPType
string
The IP addressing type to use for a given attach or default bearer. - CELLULARIPTYPEUNSPECIFIED: IP type is not specified. When unspecified, EVE will not enfor…
eveconfigExternalOpaqueBinaryBlob
object
4 properties
commonZnetStaticDNSEntry
object
2 properties
commonDhcpOptionsIgnore
object
DhcpOptionsIgnore specifies which DHCP-provided options should be ignored by the device, allowing static configuration to override DHCP where applicable. Curre…
4 properties
configDeviceOpsCmd
object
Device Operational Commands Semantic For rebooting device, command=Reset, counter = counter+delta, desiredState = on For poweroff device, command=Reset, counte…
3 properties
configPhysicalIO
object
10 properties
configEveBinaryArtifact
object
7 properties
configWifiConfig
object
7 properties
configNetworkInstanceOpaqueConfig
object
Network Instance Opaque config. In future we might add more fields here but idea is here. This is service specific configuration.
3 properties
EventQueryResponseItem
object
Event query response item payload
14 properties
configFormat
string
configPhyIOUsagePolicy
object
1 property
configVfList
object
2 properties
ZsrvResponse
object
15 properties
evecommonRadioAccessTechnology
string
- RADIOACCESSTECHNOLOGYGSM: Global System for Mobile Communications (2G). - RADIOACCESSTECHNOLOGYUMTS: Universal Mobile Telecommunications System (3G). - RADIO…
configAdapter
object
Adapter bundles corresponding to a subset of what is in ZioBundle When used by a NetworkInstanceConfig the name is the logicallabel for the network adapter.
4 properties
configACEDirection
string
configNetworkInstanceLispConfig
object
7 properties
configVlanAccessPort
object
VLAN Access Port config applied to physical port(s) attached to a Switch Network Instance.
2 properties
commonPhyIoType
string
EventQueryResponse
object
Event query response request payload
3 properties 2 required
configEncryptedExternalOpaqueBinaryBlob
object
1 property
configWirelessConfig
object
3 properties
configCellularAccessPoint
object
CellularAccessPoint contains config parameters for connecting to a cellular network.
11 properties
configDiskConfig
object
3 properties
EventTopUsersResp
object
1 property
ZsrvErrorCode
string
- zMsgErrorNone: common validation errors - IncompleteData: message had fields that weren't filled in - InvalidData: message contained the field that wasn't ex…
configLOCConfig
object
2 properties
commonNetworkType
string
configConfigItem
object
Timers and other per-device policy which relates to the interaction with zedcloud. Note that the timers are randomized on the device to avoid synchronization w…
2 properties
configSignatureInfo
object
XXX this will be deprecated when all deployed instances of EVE no longer expect it. 5.6.X depend on it. 5.7.1 does not.
3 properties
configEVE_PATCH_ENVELOPE_ACTION
string
configBaseOS
object
4 properties
configEVE_OPAQUE_OBJECT_CATEGORY
string
configVolumeRef
object
3 properties
configZNetworkOpaqueConfigType
string
configVolumeContentOriginType
string
configACEMatch
object
2 properties
evecommonDiskDescription
object
3 properties
configVolumeAccessProtocols
string
protobufAny
object
2 properties
ZcOpsType
string
configDriveType
string
- HDDEMPTY: this type is allocate the empty disk of maxsizebytes specified
configMetaDataType
string
ZcOpsStatus
string
- OPSSTATUSPENDING: In rare cases, system may not start operation when it was requested. Client will be notified that operation is PENDING - OPSSTATUSONGOING:…
configDiskConfigType
string
configBondMode
string
A bonding mode specifies the policy indicating how bonding slaves are used during network transmission. - BONDMODEUNSPECIFIED: BONDMODEUNSPECIFIED : if bonding…
eveconfigSnapshotType
string
configDsType
string
configSnapshotDesc
object
2 properties
configZNetworkInstType
string
eveconfigEdgeNodeCluster
object
9 properties
EventTopUsersData
object
2 properties
configCellularConnectivityProbe
object
CellularConnectivityProbe is used to periodically check the connectivity status of a cellular network by probing a remote endpoint. Whenever the probe fails, t…
3 properties
configAppInstanceConfig
object
The complete configuration for an Application Instance When changing key fields such as the drives/volumeRefs or the number of interfaces, the controller is re…
24 properties
configInstanceOpsCmd
object
2 properties
commonHashAlgorithm
string
configVmMode
string
For now we need to tell the device which virtualization mode to use. Later we might use a single one for all VMs (on any particular ISA). If we end up keeping…
configDevDebugAccessPolicy
object
1 property
configEvePatchEnvelope
object
7 properties
configUUIDandVersion
object
2 properties
commonKeyExchangeScheme
string
configZcServicePoint
object
3 properties
configNetworkInstanceConfig
object
16 properties
eveconfigIPRoute
object
6 properties
WifiConfigcryptoblock
object
2 properties
configNetworkConfig
object
7 properties
configDisksConfig
object
For example to use stripe of two pairs of mirrored disks we should define DisksConfig without disks with arraytype DISKSARRAYTYPERAID0 with two children with p…
3 properties
LastKnownStatus
object
3 properties
evecommonCellularAuthProtocol
string
CellularAuthProtocol defines the authentication protocol used for cellular connection. - CELLULARAUTHPROTOCOLNONE: No authentication. - CELLULARAUTHPROTOCOLPAP…
commonDHCPType
string
configBaseOSConfig
object
5 properties
MetricQueryResponse
object
5 properties
configVmConfig
object
26 properties
configArpMonitor
object
ArpMonitor : ARP-based link monitoring parameters. Defined for BondAdapter.
2 properties
commonWiFiKeyScheme
string
commonConnectivityProbe
object
Configuration for user-defined connectivity-testing probe.
2 properties
commonipspec
object
9 properties
configDisksArrayType
string
configVolume
object
The Volume describes a storage volume which should exist on the device. This can currently either be blank or created from a ContentTree If maxSizeBytes is zer…
10 properties
EventSource
string
- EVENTSOURCEUNSPECIFIED: Default - EVENTSOURCESYSTEM: Event is generated as a result of status change reported by edge node / application - EVENTSOURCEUSER: E…
configContentTree
object
12 properties
commonConnectivityProbeMethod
string
User-defined method to use to determine the connectivity status. - CONNECTIVITYPROBEMETHODUNSPECIFIED: Connectivity probing method is not specified and therefo…
LocalOperatorConsoleBlob
object
3 properties
configTarget
string
configMIIMonitor
object
MIIMonitor : MII link monitoring parameters. Defined for BondAdapter.
3 properties
configDatastoreConfig
object
9 properties
configAppDebugAccessPolicy
object
1 property
configAppRuntimeType
string
AppRuntimeType - to indicate the types of Application Deployment For instance, the need to gather of docker container metrics and logs from the agent inside ap…
eveconfigInlineOpaqueBase64Data
object
3 properties
googlerpcStatus
object
3 properties
configLacpRate
string
Option specifying the rate in which EVE will ask LACP link partners to transmit LACPDU packets in 802.3ad mode. - LACPRATEUNSPECIFIED: Default LACP rate is Slo…
configEncryptedInlineOpaqueBase64Data
object
1 property
configACEAction
object
7 properties
commonProxyServer
object
3 properties
MetricQueryResponseItem
object
2 properties
configPortProbe
object
Configuration for port connectivity probe.
3 properties
configEthVF
object
3 properties
configSpanningTreeProtocol
object
Configuration for the Spanning Tree Protocol (STP), which is run for switch network instance when the port label matches multiple network ports.
1 property
configACE
object
5 properties
configDrive
object
6 properties
configCellularConfig
object
5 properties
ZsrvError
object
3 properties
configSystemAdapter
object
systemAdapters are higher-level IP-ready network endpoints. systemAdapters give all the required bits to turn the physical IOs and intermediate L2 objects into…
10 properties
configEdgeDevConfig
object
This is the response to a GET /api/v1/edgeDevice/config The EdgeDevConfig message carries all of the device's configuration from the controller to the device.…
37 properties
configBondAdapter
object
BondAdapter aggregates multiple PhysicalIOs into one adapter for redundancy and load-spreading purposes.
7 properties
Summary
object
Summary is used to store the Summary details
3 properties
Cursor
object
Cursor helps in filtering the various list response like edge-app bundle list, model list, bundle list etc.
5 properties
MetricThreshold
object
2 properties
configVlanAdapter
object
VlanAdapter represents a single VLAN sub-interface. The parent, which is referenced by lowerlayername, should be either PhysicalIO or BondAdapter.
4 properties
configExternalEndPointPolicy
object
1 property
ConfigServiceResp
object
12 properties
commonPhyIoMemberUsage
string
PhyIoMemberUsage - Indicates how each adaptor must be used by Eve. - PhyIoUsageMgmtAndApps: Used by both management and apps. - PhyIoUsageShared: Shared by mul…
commonEncryptionScheme
string
ObjectType
string
configVolumeContentOrigin
object
2 properties
eveconfigClusterType
string
commonCipherBlock
object
4 properties
configAddressType
string
configSnapshotConfig
object
4 properties
eveconfigImage
object
7 properties
configPatchEnvelopeRef
object
2 properties
commonProbeEndpoint
object
Address of a remote endpoint to probe in order to determine connectivity status.
2 properties
evecommonWirelessType
string
LocalOperatorConsoleBlobList
object
2 properties
configZcServiceType
string
configNetworkAdapter
object
13 properties
commonproxyProto
string
configEdgeViewConfig
object
6 properties
commonipRange
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

zededa-edgediagnostics-api-openapi.yml Raw ↑

Other APIs Zededa publishes across the network.

Zededa AppProfileService API
Zededa ArtifactManager API
Zededa AssetGroupService API
Zededa BulkJobOps API
Zededa CertificateEnrollmentProfileConfiguration API
Zededa CloudDiagnostics API
Zededa ClusterGroups API
Zededa ClusterStatus API
Zededa DatastoreConfiguration API
Zededa EdgeApplicationConfiguration API
Zededa EdgeApplicationInstanceConfiguration API
Zededa EdgeApplicationInstanceStatus API
Where this information came from

This is an independent, third-party profile of Zededa EdgeDiagnostics 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.