Skip to main content
Digital Advisor API

Learn about Digital Advisor APIs

Contributors netapp-aoife
PDFs

NetApp Digital Advisor uses automation and artificial intelligence to analyze telemetry and product data. It provides predictive analytics for NetApp environments through API access to telemetry-driven insights and install base details. You can integrate these analytics into your workflows, dashboards, and NetApp inventory management systems.

Supported API platforms

Digital Advisor currently supports both GraphQL and REST APIs. However, Digital Advisor is transitioning from REST to GraphQL as its primary API platform to improve performance, flexibility, and scalability. Digital Advisor REST APIs will eventually be deprecated.

The transition will be phased, with a period of overlap between REST APIs and GraphQL APIs. A deprecation notice is published in the Digital Advisor API catalog for each deprecated REST API endpoint. You need to migrate that specific endpoint to GraphQL within six months.

To identify the REST APIs scheduled for deprecation from the Digital Advisor API catalog, navigate to API services > Browse > Deprecated APIs.

Caution Due to the phased deprecation of Digital Advisor REST APIs, NetApp strongly recommends that all new API integrations use the GraphQL-based API.

AutoSupport

AutoSupport is the telemetry service for NetApp products, periodically collecting health, configuration, status, and performance data from your storage environment. This data is transmitted to NetApp and forms the primary data source for the Digital Advisor.

AutoSupport data is system-generated and enabled by default on ONTAP and most other NetApp storage products. AutoSupport data provides benefits such as proactive identification of configuration issues, automated support case reporting and faster resolution, and support for self-service workflows. For more information on AutoSupport, see the AutoSupport documentation.

Benefits of using Digital Advisor APIs

Digital Advisor brings together business and support system data with configuration and AI-derived insights from AutoSupport telemetry data. Instead of siloed views or manual downloads, you can gain programmatic visibility across your NetApp data infrastructure, enabling faster action and smarter decisions.

You can use the Digital Advisor APIs to perform the following tasks across your NetApp environment:

  • NetApp inventory management:

    • Track all purchased systems to identify which systems are sending telemetry data. Automatically detects gaps in telemetry and automatic case generation.

    • View sites and contacts to understand where systems are deployed and identify the key contacts for each location.

    • Access the latest configuration details of a system according to its last check-in, this includes a wide range of available attributes, including software versions.

    • Analyze current and forecasted capacity and storage efficiency for ONTAP, E-Series, and StorageGRID systems.

    • Discover end-of-support dates for systems, shelves, and disks to proactively plan for tech refreshes.

    • Monitor policy variance requests (PVRs) for your NetApp inventory and their expiration.

    • Review contract details, including hardware and software contract dates and identifiers.

  • Support case management:

    • Determine which assets have open support cases and their current status.

    • Integrate support case data into your own systems for streamlined management.

  • Risk management:

    • Discover and monitor security, upgrade, best practice, configuration, community, and AI issues.

    • Receive actionable recommendations to prevent issues before they happen.

  • Sustainability and energy management:

    • Monitor actual and published power consumption, as well as projected power, heat, and carbon metrics.

  • Upgrade recommendations and history:

    • Track upgrade recommendations and history, including which systems were upgraded, when, and to what versions.

    • Retrieve recommendations on the next upgrade and readiness for upgrade across your NetApp inventory.

All of the data listed can be integrated into your in-house tools and processes through API-first workflows to help make managing your NetApp inventory easier.

Understand the Digital Advisor GraphQL API data query language

The GraphQL data query language has the following attributes:

  • A specification. The specification determines the validity of the schema on the API server. The schema determines the validity of client calls.

  • A strongly typed schema. The schema defines an API's type system and all object relationships.

  • An introspective schema. A client can query the schema for details about the schema.

  • Hierarchical fields. The shape of a GraphQL call mirrors the shape of the JSON data it returns. Nested fields let you query for and receive only the data you specify in a single round trip.

  • An application layer. GraphQL is not a storage model or a database query language. The "graph" refers to graph structures defined in the schema, where nodes define objects and edges define relationships between objects. The API navigates and returns data based on the schema definitions, independent of how the data is stored.

Learn about GraphQL API data object relationships

Learn about the GraphQL API schema to understand how data objects relate and exist within a hierarchy. The schema has the following elements:

  • Tailored data retrieval: Queries only the required fields, keeping responses concise and relevant.

  • Single endpoint simplicity: Accesses all Digital Advisor intelligence from a unified GraphQL endpoint.

  • Improved efficiency: Reduces the number of API calls in dashboards and automation pipelines.

  • Future-proof flexibility: Seamlessly adopts new insights with zero disruption as GraphQL schemas evolve.