zededa_skill

Overview

This skill provides a complete ZEDEDA edge management API client implemented in Python. It surfaces 473 endpoints across 11 service domains to manage edge nodes, applications, clusters, storage, networking, Kubernetes, diagnostics, and IAM. It includes Bearer token authentication, structured logging, and retry logic for reliable automation.

How this skill works

The skill wraps ZEDEDA REST endpoints into Python service classes and a CLI script that calls service commands. Configure the ZEDEDA_API_TOKEN and optional base URL, then run commands via the provided script or instantiate service classes in your code to call any endpoint. Errors use custom types and logs sanitize sensitive tokens.

When to use it

• Automate provisioning, monitoring, and lifecycle operations for ZEDEDA-managed edge nodes.
• Integrate ZEDEDA management into CI/CD pipelines or remote orchestration tooling.
• Query diagnostics, events, and metrics for troubleshooting device or cluster issues.
• Manage application bundles, instances, images, and storage policies programmatically.
• Perform bulk jobs or scripted cluster and network configuration changes.

Best practices

• Store ZEDEDA_API_TOKEN in a secure secret store and avoid embedding tokens in code.
• Set ZEDEDA_BASE_URL only if you use a non-default deployment or testing instance.
• Use the CLI for quick ad-hoc tasks and the service classes for reusable automation.
• Handle ZededaAuthError and other specific exceptions to implement retries and alerts.
• Sanitize or redact logs that may include resource identifiers in shared environments.

Example use cases

• List all edge devices and export a filtered inventory to a CMDB.
• Trigger a base OS upgrade job across a fleet using the job service bulk API.
• Deploy an application bundle and stream instance logs for deployment validation.
• Query device metrics and cloud health to drive alerting and remediation workflows.
• Automate user and role provisioning for enterprise onboarding through the user service.