Skip to main content

ZMS — Microsegmentation

~20 read-only tools that query the ZMS GraphQL API for microsegmentation data.

ZMS tools use a GraphQL endpoint (/zms/graphql). All tools are read-only (no mutations).

Domains

DomainTools
Agentszms_list_agents, zms_get_agent_connection_status_statistics, zms_get_agent_version_statistics
Agent Groupszms_list_agent_groups, zms_get_agent_group_totp_secrets
Resourceszms_list_resources, zms_get_resource_protection_status, zms_get_metadata
Resource Groupszms_list_resource_groups, zms_get_resource_group_members, zms_get_resource_group_protection_status
Policy Ruleszms_list_policy_rules, zms_list_default_policy_rules
App Zoneszms_list_app_zones
App Catalogzms_list_app_catalog
Nonceszms_list_nonces, zms_get_nonce
Tagszms_list_tag_namespaces, zms_list_tag_keys, zms_list_tag_values

Gotchas

  • customer_id is always required. Resolved automatically from ZSCALER_CUSTOMER_ID.
  • Tag hierarchy is three levels: namespace → key → value. Navigate top-down.
  • Resource groups have two types: ManagedResourceGroup (tag-based) and UnmanagedResourceGroup (CIDR/FQDN-based).
  • eyez_id is the unique identifier for agents, agent groups, and nonces — not a numeric ID.

Toolset

Single toolset: zms.

Full tool catalog

See Supported Tools — ZMS.