Andreas Hilbig
b56255ffaa
This commit introduces a comprehensive set of GraphQL query and mutation samples based on the official Zabbix 7.4 API documentation, along with testing and automation improvements. Changes: - Documentation: - Added 21 GraphQL sample files in docs/queries/from_zabbix_docs/ covering various Zabbix API operations. - Updated docs/howtos/cookbook.md with a new recipe for executing these documentation samples. - AI & MCP: - Added mcp/operations/importHostGroups.graphql to enable host group import via MCP tools. - Testing: - Added src/test/zabbix_docs_samples.test.ts to automatically validate all documentation samples against the GraphQL schema. |
||
|---|---|---|
| .. | ||
| from_zabbix_docs | ||
| README.md | ||
| sample_all_devices_query.graphql | ||
| sample_all_host_groups_query.graphql | ||
| sample_all_hosts_query.graphql | ||
| sample_all_template_groups_query.graphql | ||
| sample_delete_template_groups_mutation.graphql | ||
| sample_delete_templates_mutation.graphql | ||
| sample_export_user_rights_query.graphql | ||
| sample_import_distance_tracker_template.graphql | ||
| sample_import_host_groups_mutation.graphql | ||
| sample_import_host_template_groups_mutation.graphql | ||
| sample_import_hosts_mutation.graphql | ||
| sample_import_permissions_template_groups_mutation.graphql | ||
| sample_import_templates_mutation.graphql | ||
| sample_import_user_rights_mutation.graphql | ||
| sample_templates_query.graphql | ||
Sample Queries & Mutations
This directory contains practical examples of GraphQL operations for the Zabbix GraphQL API. You can use these as templates for your own automation or integration tasks.
📁 Available Samples
🖥️ Hosts
- Query All Hosts: Retrieve basic host information and inventory.
- Import Hosts: Create or update multiple hosts with tags and group assignments.
- Query All Devices: Query specialized devices using the
allDevicesquery.
📄 Templates
- Query Templates: List available templates and their items.
- Import Templates: Create or update complex templates with item definitions and preprocessing.
- Import Distance Tracker Template: Example of importing a template for a schema extension.
- Delete Templates: Remove templates by ID or name pattern.
📂 Template Groups
- Import Host Template Groups: Create groups specifically for host templates.
- Import Permissions Template Groups: Create groups for the permission system.
- Delete Template Groups: Remove template groups by ID or name pattern.
🔐 User Rights
- Export User Rights: Export existing user roles and groups for auditing or migration.
- Import User Rights: Provision user roles and group permissions at scale.
🍳 Related Recipes
For step-by-step guides on how to use these operations in common scenarios, see the Cookbook.