NetApp ONTAP NAS icon

NetApp ONTAP NAS

Manage NetApp ONTAP CIFS shares, NFS exports, and NAS protocols

Actions27

CIFS Share → Get Many

AI-generated

Summary

Retrieve multiple CIFS (SMB) shares from a NetApp ONTAP cluster with optional filtering and field selection.

Inputs

  • Cluster Host (required) — The hostname or IP address of the ONTAP cluster management LIF.
  • Port — HTTPS port for the ONTAP REST API, default is 443.
  • Filters — Filters to narrow down the CIFS shares retrieved, including an API filter string to specify ONTAP API query parameters, a 'Return All' boolean to fetch all shares or limit results, and a numeric limit when not returning all.
  • Options — Additional options including a comma-separated list of fields to include in the response (use '*' to include all fields).

Output shape

a list of CIFS share objects as JSON

By default, returns all CIFS shares matching the optional filters. If 'Return All' is false, respects the 'Limit' for maximum number of shares retrieved. Supports API filtering expressions. The response data is the raw record objects from the '/protocols/cifs/shares' ONTAP REST API endpoint.

Examples

Example 1: Get all CIFS shares on a cluster without filters

Specify required Cluster Host and Port, leave filters empty with 'Return All' checked, optionally specify fields or leave default.

Example 2: Get up to 50 CIFS shares with a specific state using API Filters

Set Cluster Host and Port, specify API Filters such as 'state=online', uncheck 'Return All', and set Limit to 50.

Links

Discussion