Nasuni

Nasuni Volumes API

The Volumes API from Nasuni — 52 operation(s) for volumes.

GitHub OpenAPI
Business capability
IT Infrastructure Management BC-600.50

Operations 76

GET /volumes/ List all volumes #
POST /volumes/ Create volume #
GET /volumes/{volume_guid}/ Get a volume #
PATCH /volumes/{volume_guid}/ Update volume #
GET /volumes/{volume_guid}/filers/ List filer specific settings of a volume #
GET /volumes/{volume_guid}/filers/{filer_serial}/ Get volume settings for a specific filer #
PATCH /volumes/{volume_guid}/filers/{filer_serial}/ Update the settings for a volume on a specific Filer #
GET /volumes/filers/shares/ List all shares across all volumes and filers #
GET /volumes/{volume_guid}/filers/shares/ List all shares of a volume #
GET /volumes/{volume_guid}/filers/{filer_serial}/shares/ List all shares of a volume on a specific filer #
POST /volumes/{volume_guid}/filers/{filer_serial}/shares/ Create share #
GET /volumes/{volume_guid}/filers/{filer_serial}/shares/{share_id}/ Get a share #
DELETE /volumes/{volume_guid}/filers/{filer_serial}/shares/{share_id}/ Delete a share #
PATCH /volumes/{volume_guid}/filers/{filer_serial}/shares/{share_id}/ Update share #
GET /volumes/filers/exports/ List all exports #
GET /volumes/{volume_guid}/filers/exports/ List all exports of a volume #
GET /volumes/{volume_guid}/filers/{filer_serial}/exports/ List exports of a volume for a specific filer #
POST /volumes/{volume_guid}/filers/{filer_serial}/exports/ Create export #
GET /volumes/{volume_guid}/filers/{filer_serial}/exports/{export_id}/ Get an export #
DELETE /volumes/{volume_guid}/filers/{filer_serial}/exports/{export_id}/ Delete export #
PATCH /volumes/{volume_guid}/filers/{filer_serial}/exports/{export_id}/ Update export #
GET /volumes/filers/ftp-directories/ List all FTP directories #
GET /volumes/{volume_guid}/filers/ftp-directories/ List all FTP directories of a volume #
GET /volumes/{volume_guid}/filers/{filer_serial}/ftp-directories/ List FTP directories of a volume for a specific filer #
GET /volumes/{volume_guid}/filers/{filer_serial}/ftp-directories/{ftpdir_id}/ Get a FTP directory #
GET /volumes/filer-connections/ List all volume connections #
GET /volumes/{volume_guid}/filer-connections/ List all volume connections for a specific volume #
GET /volumes/{volume_guid}/filer-connections/{filer_serial}/ Get a volume connection #
GET /volumes/filers/antivirus-violations/ List all antivirus violations #
GET /volumes/{volume_guid}/filers/antivirus-violations/ List all antivirus violations of a volume #
GET /volumes/{volume_guid}/filers/{filer_serial}/antivirus-violations/ List antivirus violations of a volume for a specific filer #
GET /volumes/{volume_guid}/filers/{filer_serial}/antivirus-violations/{antivirus_id}/ Get an antivirus violation #
DELETE /volumes/{volume_guid}/filers/{filer_serial}/antivirus-violations/{antivirus_id}/ Delete antivirus violation #
GET /volumes/{volume_guid}/filers/{filer_serial}/exports/{export_id}/nfs_host_options/ List NFS host options for an export #
POST /volumes/{volume_guid}/filers/{filer_serial}/exports/{export_id}/nfs_host_options/ Create NFS host option #
GET /volumes/{volume_guid}/filers/{filer_serial}/exports/{export_id}/nfs_host_options/{host_option_id}/ Get a host option for an export #
DELETE /volumes/{volume_guid}/filers/{filer_serial}/exports/{export_id}/nfs_host_options/{host_option_id}/ Delete host option #
PATCH /volumes/{volume_guid}/filers/{filer_serial}/exports/{export_id}/nfs_host_options/{host_option_id}/ Update an existing host option #
GET /volumes/folder-quotas/ List folder quotas #
GET /volumes/{volume_guid}/folder-quotas/ List folder quotas for a volume #
POST /volumes/{volume_guid}/folder-quotas/ Create folder quota #
GET /volumes/{volume_guid}/folder-quotas/{folder_quota_id}/ Get folder quota #
DELETE /volumes/{volume_guid}/folder-quotas/{folder_quota_id}/ Delete folder quota #
PATCH /volumes/{volume_guid}/folder-quotas/{folder_quota_id}/ Update folder quota #
GET /volumes/filers/snapshots/ List snapshot statuses #
GET /volumes/{volume_guid}/filers/snapshots/ List snapshot statuses for a volume #
GET /volumes/{volume_guid}/filers/{filer_serial}/snapshots/ List snapshot status for a volume and Filer #
POST /volumes/{volume_guid}/filers/{filer_serial}/snapshots/ Request snapshot for volume #
POST /volumes/{volume_guid}/global-lock-folders/ Enable global locking and its various modes on a specified path #
GET /volumes/filers/paths/ Get a list of all known paths #
GET /volumes/{volume_guid}/filers/paths/ Get a list of all known paths with a specific volume #
GET /volumes/{volume_guid}/filers/{filer_serial}/paths/ Get a list of all known paths with a specific volume and filer #
GET /volumes/{volume_guid}/filers/{filer_serial}/path/{path} Get info on a specific path #
POST /volumes/{volume_guid}/filers/{filer_serial}/path/{path} Refresh info about a given path #
POST /volumes/{volume_guid}/filers/{filer_serial}/cache-path/{path} Bring path into cache #
POST /volumes/{volume_guid}/filers/{filer_serial}/make-dir-path/ Try to make the given directory path #
GET /volumes/filers/pinned-folders/ Get a list of all pinned folders #
GET /volumes/{volume_guid}/filers/pinned-folders/ Get a list of all pinned folders in a volume #
GET /volumes/{volume_guid}/filers/{filer_serial}/pinned-folders/ Get a list of pinned folders in a volume for a specific filer #
POST /volumes/{volume_guid}/filers/{filer_serial}/pinned-folders/ Set pinning mode #
GET /volumes/{volume_guid}/filers/{filer_serial}/pinned-folder/{path} Get pinning status for the path #
DELETE /volumes/{volume_guid}/filers/{filer_serial}/pinned-folder/{path} Disable pinning mode on a folder #
GET /volumes/filers/auto-cached-folders/ Get a list of all auto cache enabled folders #
GET /volumes/{volume_guid}/filers/auto-cached-folders/ Get a list of all auto cache enabled folders in a volume #
GET /volumes/{volume_guid}/filers/{filer_serial}/auto-cached-folders/ List auto cache enabled folders for a volume on a filer #
POST /volumes/{volume_guid}/filers/{filer_serial}/auto-cached-folders/ Set auto caching mode #
GET /volumes/{volume_guid}/filers/{filer_serial}/auto-cached-folder/{path} Get auto cache folder status for a folder #
DELETE /volumes/{volume_guid}/filers/{filer_serial}/auto-cached-folder/{path} Disable auto cache mode on a folder #
DELETE /volumes/{volume_guid}/global-lock-folders/{path} Disable global locking on a specified path #
GET /volumes Get Volumes #
GET /volumes/{volume_id}/edges/{edge_id}/snapshots Get Snapshot Status #
POST /volumes/{volume_id}/edges/{edge_id}/snapshots Start Snapshot #
DELETE /volumes/{volume_id}/edges/{edge_id}/snapshots Cancel Snapshot #
GET /volumes/{volume_id} Get Volume #
GET /volumes/{volume_id}/details Get Volume Details #
GET /volumes/{volume_id}/capacity-history Get Volume Capacity History #

Documentation

📖
Documentation
https://docs.api.nasuni.com/api/nmc/v120/introduction/
📖
APIReference
https://docs.api.nasuni.com/api/nmc/v120/reference/overview/
📖
Documentation
https://docs.api.nasuni.com/api/portal/v0/introduction/
📖
APIReference
https://docs.api.nasuni.com/api/portal/v0/reference/overview/
📖
APIReference
https://docs.api.nasuni.com/api/gfa/reference/overview/
📖
Documentation
https://docs.nasuni.com/docs/nds-azure-api-overview
📖
Documentation
https://docs.nasuni.com/docs/nds-aws-api-overview

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/nasuni/refs/heads/main/openapi/nasuni-volumes-api-openapi.yml

Other Resources

🔗
ChangeLog
https://docs.api.nasuni.com/api/nmc/v120/versionhistory/
🔗
ChangeLog
https://docs.api.nasuni.com/api/portal/v0/versionhistory/

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/nasuni-volumes-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

nasuni-volumes-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Nasuni Volumes API
  version: '1.0'
  description: 'Operations tagged Volumes across 4 of this provider''s published API definitions: nasuni-nmc-v1-0-openapi.json, nasuni-nmc-v1-1-openapi.json, nasuni-nmc-v1-2-openapi.json, nasuni-portal-v0-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://hostname/api/v1
- url: https://hostname/api/v1.1
- url: https://hostname/api/v1.2
- url: https://am1.portal.api.nasuni.com
  description: Base URL for accounts assigned the US region.
- url: https://eu1.portal.api.nasuni.com
  description: Base URL for accounts assigned the EU region.
- url: https://ap1.portal.api.nasuni.com
  description: Base URL for accounts assigned the Asia-Pacific region.
tags:
- name: Volumes
paths:
  /volumes/:
    get:
      tags:
      - Volumes
      summary: List all volumes
      parameters:
      - name: limit
        in: query
        description: The maximum number of objects to return
        schema:
          maximum: 100
          minimum: 1
          type: integer
          default: 50
      - name: offset
        in: query
        description: The index of the first object to return
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                allOf:
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/Volume'
                - $ref: '#/components/schemas/Paging'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
      - AuthToken: []
      operationId: getVolumes
      x-operation-id-source: derived
    post:
      tags:
      - Volumes
      summary: Create volume
      requestBody:
        content:
          application/json:
            schema:
              allOf:
              - type: object
              - $ref: '#/components/schemas/Volume_2'
        required: true
      responses:
        '202':
          description: Accepted - Filer has been sent a message
          headers:
            Location:
              description: URL to the associated message
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-codegen-request-body-name: body
      security:
      - AuthToken: []
      operationId: postVolumes
      x-operation-id-source: derived
    servers:
    - url: https://hostname/api/v1
  /volumes/{volume_guid}/:
    get:
      tags:
      - Volumes
      summary: Get a volume
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Volume'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
      - AuthToken: []
      operationId: getVolumesByVolumeGuid
      x-operation-id-source: derived
    patch:
      tags:
      - Volumes
      summary: Update volume
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Volume_2'
        required: true
      responses:
        '202':
          description: Accepted - Filer has been sent a message
          headers:
            Location:
              description: URL to the associated message
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
        '400':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-codegen-request-body-name: body
      security:
      - AuthToken: []
      operationId: patchVolumesByVolumeGuid
      x-operation-id-source: derived
    servers:
    - url: https://hostname/api/v1
  /volumes/{volume_guid}/filers/:
    get:
      tags:
      - Volumes
      summary: List filer specific settings of a volume
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      - name: limit
        in: query
        description: The maximum number of objects to return
        schema:
          maximum: 100
          minimum: 1
          type: integer
          default: 50
      - name: offset
        in: query
        description: The index of the first object to return
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                allOf:
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/VolumeFilerSetting'
                - $ref: '#/components/schemas/Paging'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
      - AuthToken: []
      operationId: getVolumesByVolumeGuidFilers
      x-operation-id-source: derived
    servers:
    - url: https://hostname/api/v1
  /volumes/{volume_guid}/filers/{filer_serial}/:
    get:
      tags:
      - Volumes
      summary: Get volume settings for a specific filer
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      - name: filer_serial
        in: path
        description: Filer object identifier
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VolumeFilerSetting'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
      - AuthToken: []
      operationId: getVolumesByVolumeGuidFilersByFilerSerial
      x-operation-id-source: derived
    patch:
      tags:
      - Volumes
      summary: Update the settings for a volume on a specific Filer
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      - name: filer_serial
        in: path
        description: Filer object identifier
        required: true
        schema:
          type: string
      requestBody:
        description: Volume settings to update for a Filer
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VolumeFilerSetting_2'
        required: true
      responses:
        '202':
          description: Accepted - Filers volume has been sent a message
          headers:
            Location:
              description: URL to the associated message
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
        '400':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-codegen-request-body-name: body
      security:
      - AuthToken: []
      operationId: patchVolumesByVolumeGuidFilersByFilerSerial
      x-operation-id-source: derived
    servers:
    - url: https://hostname/api/v1
  /volumes/filers/shares/:
    get:
      tags:
      - Volumes
      summary: List all shares across all volumes and filers
      parameters:
      - name: limit
        in: query
        description: The maximum number of objects to return
        schema:
          maximum: 100
          minimum: 1
          type: integer
          default: 50
      - name: offset
        in: query
        description: The index of the first object to return
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                allOf:
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/Share'
                - $ref: '#/components/schemas/Paging'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
      - AuthToken: []
      operationId: getVolumesFilersShares
      x-operation-id-source: derived
    servers:
    - url: https://hostname/api/v1
  /volumes/{volume_guid}/filers/shares/:
    get:
      tags:
      - Volumes
      summary: List all shares of a volume
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      - name: limit
        in: query
        description: The maximum number of objects to return
        schema:
          maximum: 100
          minimum: 1
          type: integer
          default: 50
      - name: offset
        in: query
        description: The index of the first object to return
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                allOf:
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/Share'
                - $ref: '#/components/schemas/Paging'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
      - AuthToken: []
      operationId: getVolumesByVolumeGuidFilersShares
      x-operation-id-source: derived
    servers:
    - url: https://hostname/api/v1
  /volumes/{volume_guid}/filers/{filer_serial}/shares/:
    get:
      tags:
      - Volumes
      summary: List all shares of a volume on a specific filer
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      - name: filer_serial
        in: path
        description: Filer object identifier
        required: true
        schema:
          type: string
      - name: limit
        in: query
        description: The maximum number of objects to return
        schema:
          maximum: 100
          minimum: 1
          type: integer
          default: 50
      - name: offset
        in: query
        description: The index of the first object to return
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                allOf:
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/Share'
                - $ref: '#/components/schemas/Paging'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
      - AuthToken: []
      operationId: getVolumesByVolumeGuidFilersByFilerSerialShares
      x-operation-id-source: derived
    post:
      tags:
      - Volumes
      summary: Create share
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      - name: filer_serial
        in: path
        description: Filer object identifier
        required: true
        schema:
          type: string
      requestBody:
        description: The share to create.
        content:
          application/json:
            schema:
              allOf:
              - type: object
              - $ref: '#/components/schemas/Share_2'
        required: true
      responses:
        '202':
          description: Accepted - Filer has been sent a message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
        '400':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Permission denied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-codegen-request-body-name: body
      security:
      - AuthToken: []
      operationId: postVolumesByVolumeGuidFilersByFilerSerialShares
      x-operation-id-source: derived
    servers:
    - url: https://hostname/api/v1
  /volumes/{volume_guid}/filers/{filer_serial}/shares/{share_id}/:
    get:
      tags:
      - Volumes
      summary: Get a share
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      - name: filer_serial
        in: path
        description: Filer object identifier
        required: true
        schema:
          type: string
      - name: share_id
        in: path
        description: Share object identifier
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Share'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
      - AuthToken: []
      operationId: getVolumesByVolumeGuidFilersByFilerSerialSharesByShareId
      x-operation-id-source: derived
    delete:
      tags:
      - Volumes
      summary: Delete a share
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      - name: filer_serial
        in: path
        description: Filer object identifier
        required: true
        schema:
          type: string
      - name: share_id
        in: path
        description: Share object identifier
        required: true
        schema:
          type: string
      responses:
        '202':
          description: Accepted - Filer has been sent a message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Permission denied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - AuthToken: []
      operationId: deleteVolumesByVolumeGuidFilersByFilerSerialSharesByShareId
      x-operation-id-source: derived
    patch:
      tags:
      - Volumes
      summary: Update share
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      - name: filer_serial
        in: path
        description: Filer object identifier
        required: true
        schema:
          type: string
      - name: share_id
        in: path
        description: Share object identifier
        required: true
        schema:
          type: string
      requestBody:
        description: Share fields to update
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Share_2'
        required: true
      responses:
        '202':
          description: Accepted - Filer has been sent a message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
        '400':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Permission denied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-codegen-request-body-name: body
      security:
      - AuthToken: []
      operationId: patchVolumesByVolumeGuidFilersByFilerSerialSharesByShareId
      x-operation-id-source: derived
    servers:
    - url: https://hostname/api/v1
  /volumes/filers/exports/:
    get:
      tags:
      - Volumes
      summary: List all exports
      parameters:
      - name: limit
        in: query
        description: The maximum number of objects to return
        schema:
          maximum: 100
          minimum: 1
          type: integer
          default: 50
      - name: offset
        in: query
        description: The index of the first object to return
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                allOf:
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/Export'
                - $ref: '#/components/schemas/Paging'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
      - AuthToken: []
      operationId: getVolumesFilersExports
      x-operation-id-source: derived
    servers:
    - url: https://hostname/api/v1
  /volumes/{volume_guid}/filers/exports/:
    get:
      tags:
      - Volumes
      summary: List all exports of a volume
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      - name: limit
        in: query
        description: The maximum number of objects to return
        schema:
          maximum: 100
          minimum: 1
          type: integer
          default: 50
      - name: offset
        in: query
        description: The index of the first object to return
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                allOf:
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/Export'
                - $ref: '#/components/schemas/Paging'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
      - AuthToken: []
      operationId: getVolumesByVolumeGuidFilersExports
      x-operation-id-source: derived
    servers:
    - url: https://hostname/api/v1
  /volumes/{volume_guid}/filers/{filer_serial}/exports/:
    get:
      tags:
      - Volumes
      summary: List exports of a volume for a specific filer
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      - name: filer_serial
        in: path
        description: Filer object identifier
        required: true
        schema:
          type: string
      - name: limit
        in: query
        description: The maximum number of objects to return
        schema:
          maximum: 100
          minimum: 1
          type: integer
          default: 50
      - name: offset
        in: query
        description: The index of the first object to return
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                allOf:
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/Export'
                - $ref: '#/components/schemas/Paging'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
      - AuthToken: []
      operationId: getVolumesByVolumeGuidFilersByFilerSerialExports
      x-operation-id-source: derived
    post:
      tags:
      - Volumes
      summary: Create export
      description: Only available on NMC version 21.2 and higher.
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      - name: filer_serial
        in: path
        description: Filer object identifier
        required: true
        schema:
          type: string
      requestBody:
        description: The export to create.
        content:
          application/json:
            schema:
              allOf:
              - type: object
              - $ref: '#/components/schemas/Export_2'
        required: true
      responses:
        '202':
          description: Accepted - Filer has been sent a message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
        '400':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Permission denied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-codegen-request-body-name: body
      security:
      - AuthToken: []
      operationId: postVolumesByVolumeGuidFilersByFilerSerialExports
      x-operation-id-source: derived
    servers:
    - url: https://hostname/api/v1
  /volumes/{volume_guid}/filers/{filer_serial}/exports/{export_id}/:
    get:
      tags:
      - Volumes
      summary: Get an export
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      - name: filer_serial
        in: path
        description: Filer object identifier
        required: true
        schema:
          type: string
      - name: export_id
        in: path
        description: Export object identifier
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Export'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
      - AuthToken: []
      operationId: getVolumesByVolumeGuidFilersByFilerSerialExportsByExportId
      x-operation-id-source: derived
    delete:
      tags:
      - Volumes
      summary: Delete export
      description: Only available on NMC version 21.2 and higher.
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      - name: filer_serial
        in: path
        description: Filer object identifier
        required: true
        schema:
          type: string
      - name: export_id
        in: path
        description: Export object identifier
        required: true
        schema:
          type: string
      responses:
        '202':
          description: Accepted - Filer has been sent a message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
        '401':
          description: Authentication failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Permission denied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Request throttled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - AuthToken: []
      operationId: deleteVolumesByVolumeGuidFilersByFilerSerialExportsByExportId
      x-operation-id-source: derived
    patch:
      tags:
      - Volumes
      summary: Update export
      description: Only available on NMC version 21.2 and higher.
      parameters:
      - name: volume_guid
        in: path
        description: Volume identifier
        required: true
        schema:
          type: string
      - name: filer_serial
        in: path
        description: Filer object identifier
        required: true
        schema:
          type: string
      - name: export_id
        in: path
        description: Export object identifier
        required: true
        schema:
          type: string
      requestBody:
        description: Export fields to update
        content:

# --- truncated at 32 KB (299 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/nasuni/refs/heads/main/openapi/nasuni-volumes-api-openapi.yml