Skip to main content
NetApp Knowledge Base

Why do root aggregates not show up in REST API calls?

Views:
61
Visibility:
Public
Votes:
2
Category:
ontap-9
Specialty:
core
Last Updated:

Applies to

  • ONTAP 9
  • REST API
  • Root aggregate

Answer

  • The REST API is designed to only expose non-root aggregates for all methods (GET, POST, PATCH, and DELETE) and non-remote aggregates in Metroclusters.
  • This design consideration was implemented to enforce best practices for managing root aggregates: The configuration or content of the root aggregates and volumes should not be modified: Rules governing node root volumes and root aggregates
  • However, REST endpoint /api/storage/aggregates is able to retrieve information of a root aggregate if the root-aggregate UUID is specified in the query:

    ::> set adv

    Warning: These advanced commands are potentially dangerous; use them only when directed to do so by NetApp personnel.
    Do you want to continue? {y|n}: y

    ::*> aggr show -root true -fields uuid
    aggregate uuid
    --------- ------------------------------------
    aggr0     bfcbd17c-492c-4205-a0da-e522eec3b908

    user@linux:~$ curl -s -k -u admin https://10.0.0.1/api/storage/aggregates/bfcbd17c-492c-4205-a0da-e522eec3b908
    Enter host password for user 'admin':
    {
      "uuid": "bfcbd17c-492c-4205-a0da-e522eec3b908",
      "name": "aggr0",
      "node": {
      ...

Additional Information

NA

NetApp provides no representations or warranties regarding the accuracy or reliability or serviceability of any information or recommendations provided in this publication or with respect to any results that may be obtained by the use of the information or observance of any recommendations provided herein. The information in this document is distributed AS IS and the use of this information or the implementation of any recommendations or techniques herein is a customer's responsibility and depends on the customer's ability to evaluate and integrate them into the customer's operational environment. This document and the information contained herein may be used solely in connection with the NetApp products discussed in this document.