Pure Storage

Pure Storage Directories API

Important file system directories should be set up as managed directories. Managed directories can have policies attached to them. Managed directories differ from standard directories in that they provide space reporting and metrics.

Documentation GitHub OpenAPI

Documentation

https://code.purestorage.com/swagger

https://code.purestorage.com

https://static.pure1.purestorage.com/api-swagger/index.html

https://support.purestorage.com/Pure1/Pure1_Manage/Pure1_Manage_-_REST_API/Pure1_Manage_-_REST_API__Reference

Specifications

https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/openapi/pure-storage-directories-api-openapi.yml

Code Examples

https://github.com/PureStorage-OpenConnect/ansible-playbook-examples

https://github.com/PureStorage-OpenConnect/python-scripts

https://github.com/PureStorage-OpenConnect/sqlserver-scripts

https://github.com/PureStorage-OpenConnect/oracle-scripts

https://github.com/PureStorage-OpenConnect/VMware-Scripts

Schemas & Data

https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/json-schema/flasharray-rest-api-array-schema.json

https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/json-schema/flasharray-rest-api-volume-schema.json

https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/json-schema/flasharray-rest-api-host-schema.json

https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/json-structure/flasharray-rest-api-array-structure.json

https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/json-structure/flasharray-rest-api-volume-structure.json

https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/json-schema/flashblade-rest-api-file-system-schema.json

https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/json-schema/flashblade-rest-api-bucket-schema.json

https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/json-schema/flashblade-rest-api-array-schema.json

https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/json-structure/flashblade-rest-api-file-system-structure.json

https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/json-structure/flashblade-rest-api-bucket-structure.json

https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/json-schema/pure1-cloud-api-array-schema.json

https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/json-schema/pure1-cloud-api-metric-schema.json

https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/json-schema/pure1-cloud-api-alert-schema.json

https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/json-structure/pure1-cloud-api-array-structure.json

Other Resources

https://pypi.org/project/py-pure-client/

https://github.com/PureStorage-OpenConnect/PureStorage.Pure1

https://github.com/PureStorage-OpenConnect/powershell-toolkit-3

https://github.com/PureStorage-OpenConnect/rest-client

https://github.com/PureStorage-OpenConnect/terraform-provider-flash

https://github.com/PureStorage-OpenConnect/pure-fa-openmetrics-exporter

https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/json-ld/pure-storage-flasharray-rest-api-context.jsonld

https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/examples/flasharray-rest-api-volume-example.json

https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/examples/flasharray-rest-api-array-example.json

https://github.com/PureStorage-OpenConnect/flashblade-powershell

https://github.com/purestorage/purity_fb_python_client

https://github.com/PureStorage-OpenConnect/pure-fb-openmetrics-exporter

https://github.com/PureStorage-OpenConnect/flashblade-mcp-server

https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/json-ld/pure-storage-flashblade-rest-api-context.jsonld

https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/examples/flashblade-rest-api-file-system-example.json

https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/examples/flashblade-rest-api-bucket-example.json

https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/json-ld/pure-storage-pure1-cloud-api-context.jsonld

https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/examples/pure1-cloud-api-array-example.json

OpenAPI Specification

openapi: 3.0.1
info:
  title: FlashArray REST Active Directory Directories API
  version: '2.52'
  description: 'Active Directory configuration authenticates users for NFS using Kerberos or SMB using Kerberos

    or New Technology LAN Manager (NTLM). Active Directory is also used to authorize users by

    mapping identities across the NFS and SMB protocols by using LDAP queries.

    '
servers:
- url: /
tags:
- name: Directories
  description: 'Important file system directories should be set up as managed directories. Managed directories

    can have policies attached to them. Managed directories differ from standard directories in that

    they provide space reporting and metrics.

    '
paths:
  /api/2.52/directories:
    get:
      tags:
      - Directories
      summary: Pure Storage List Directories
      description: 'Displays a list of directories, including those pending eradication.

        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Allow_errors'
      - $ref: '#/components/parameters/Context_names_get'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/components/parameters/Destroyed'
      - $ref: '#/components/parameters/File_system_ids'
      - $ref: '#/components/parameters/File_system_names'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Ids'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Names'
      - $ref: '#/components/parameters/Offset'
      - $ref: '#/components/parameters/Sort'
      - $ref: '#/components/parameters/Total_item_count'
      - $ref: '#/components/parameters/Total_only'
      - $ref: '#/components/parameters/Workload_ids'
      - $ref: '#/components/parameters/Workload_names'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DirectoryGetResponse'
        '207':
          description: 'Partial success. Some resources were returned, but there

            were also errors possibly preventing some resources from

            being returned.

            '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DirectoryGetResponse'
    post:
      tags:
      - Directories
      summary: Pure Storage Create or Copy Directory
      description: 'Creates a managed directory at the specified path.

        The managed directory name must consist of a file system name prefix and a managed directory

        name suffix (separated with ''&#58;''). The suffix must be between 1 and 63 characters

        (alphanumeric and ''-'') in length and begin and end with a letter or number.

        The suffix must include at least one letter or ''-''.

        Set `names` to create a managed directory with the specified full managed directory name,

        or set `file_system_names` or `file_system_ids` in the query parameters and `suffix` in

        the body parameters to create a managed directory in the specified file system with the

        specified suffix. These two options are exclusive.

        The `add_to_policy_names` and `add_to_policy_ids` query parameters specify a list of policy

        names or ids, respectively, that will be applied to the newly created managed directory.

        These parameters are mutually exclusive.

        The `with_default_protection` query parameter specifies whether to use the container

        default protection configuration for the managed directory.

        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Add_to_policy_ids_directory'
      - $ref: '#/components/parameters/Add_to_policy_names_directory'
      - $ref: '#/components/parameters/Context_names'
      - $ref: '#/components/parameters/File_system_ids'
      - $ref: '#/components/parameters/File_system_names'
      - $ref: '#/components/parameters/Ignore_usage'
      - $ref: '#/components/parameters/Names'
      - $ref: '#/components/parameters/With_default_protection_policy_directory'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DirectoryPost'
        required: true
        x-codegen-request-body-name: directory
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DirectoryResponse'
      x-codegen-request-body-name: directory
    delete:
      tags:
      - Directories
      summary: Pure Storage Delete Managed Directories
      description: 'Deletes one or more managed directories.

        To be deleted, a managed directory must be empty and not attached to any enabled export

        policies. Deleted managed directories cannot be recovered.

        The `ids` or `names` parameter is required, but cannot be set together.

        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Context_names'
      - $ref: '#/components/parameters/Ids'
      - $ref: '#/components/parameters/Names'
      responses:
        '200':
          description: OK
          content: {}
    patch:
      tags:
      - Directories
      summary: Pure Storage Modify a Managed Directory
      description: 'Modifies a managed directory.

        To rename a managed directory, set `name` to the new name.

        The `ids` or `names` parameter is required, but cannot be set together.

        The `name` or `directory_name` parameter is required.


        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Context_names'
      - $ref: '#/components/parameters/Ids'
      - $ref: '#/components/parameters/Names'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DirectoryPatch'
        required: true
        x-codegen-request-body-name: directory
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DirectoryResponse'
      x-codegen-request-body-name: directory
  /api/2.52/directories/groups:
    get:
      tags:
      - Directories
      summary: Pure Storage List Group with Content in Directories
      description: 'Displays a list of groups, that have content in specific directories.

        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Allow_errors'
      - $ref: '#/components/parameters/Context_names_get'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/components/parameters/File_system_ids'
      - $ref: '#/components/parameters/File_system_names'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Group_quota_gids'
      - $ref: '#/components/parameters/Group_names'
      - $ref: '#/components/parameters/Group_sids'
      - $ref: '#/components/parameters/Ids'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Names'
      - $ref: '#/components/parameters/Offset'
      - $ref: '#/components/parameters/Sort'
      - $ref: '#/components/parameters/Total_item_count'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DirectoriesGroupsGetResponse'
        '207':
          description: 'Partial success. Some resources were returned, but there

            were also errors possibly preventing some resources from

            being returned.

            '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DirectoriesGroupsGetResponse'
  /api/2.52/directories/locks/nlm-reclamations:
    post:
      tags:
      - Directories
      summary: Pure Storage Create NLM Reclamation
      description: 'Creates an NLM reclamation, which is a system-wide operation that affects all clients,

        so only one may be in progress at a time. Attempting to initiate reclamation while one is in

        progress will result in an error. When NLM reclamation is initiated, all NLM locks are deleted

        and client applications are notified that they can reacquire their locks within a grace period.

        '
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Context_names'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DirectoryLockNlmReclamationResponse'
  /api/2.52/directories/performance:
    get:
      tags:
      - Directories
      summary: Pure Storage List Directory Performance Data
      description: 'Displays real-time and historical performance data, real-time latency data, and average I/O

        sizes for each directory and as a total of all directories across the entire array.


        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Allow_errors'
      - $ref: '#/components/parameters/Context_names_get'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/components/parameters/Destroyed'
      - $ref: '#/components/parameters/History_end_time'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Ids'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Names'
      - $ref: '#/components/parameters/Offset'
      - $ref: '#/components/parameters/Perf_protocol_type'
      - $ref: '#/components/parameters/Perf_protocol_group'
      - $ref: '#/components/parameters/History_resolution'
      - $ref: '#/components/parameters/Sort'
      - $ref: '#/components/parameters/History_start_time'
      - $ref: '#/components/parameters/Total_item_count'
      - $ref: '#/components/parameters/Total_only'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DirectoryPerformanceGetResponse'
        '207':
          description: 'Partial success. Some resources were returned, but there

            were also errors possibly preventing some resources from

            being returned.

            '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DirectoryPerformanceGetResponse'
  /api/2.52/directories/policies:
    get:
      tags:
      - Directories
      summary: Pure Storage List Policies
      description: Displays a list of policies that are attached to directories.
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Allow_errors'
      - $ref: '#/components/parameters/Context_names_get'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/components/parameters/Destroyed'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Member_ids'
      - $ref: '#/components/parameters/Member_names'
      - $ref: '#/components/parameters/Offset'
      - $ref: '#/components/parameters/Policy_ids'
      - $ref: '#/components/parameters/Policy_names'
      - $ref: '#/components/parameters/Sort'
      - $ref: '#/components/parameters/Total_item_count'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyMemberGetResponse'
        '207':
          description: 'Partial success. Some resources were returned, but there

            were also errors possibly preventing some resources from

            being returned.

            '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyMemberGetResponse'
  /api/2.52/directories/policies/audit-file:
    get:
      tags:
      - Directories
      summary: Pure Storage List Audit Policies Attached to a Directory
      description: 'Displays a list of audit policies that are attached to directories.


        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Allow_errors'
      - $ref: '#/components/parameters/Context_names_get'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/components/parameters/Destroyed'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Member_ids'
      - $ref: '#/components/parameters/Member_names'
      - $ref: '#/components/parameters/Offset'
      - $ref: '#/components/parameters/Policy_ids'
      - $ref: '#/components/parameters/Policy_names'
      - $ref: '#/components/parameters/Sort'
      - $ref: '#/components/parameters/Total_item_count'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyMemberGetResponse'
        '207':
          description: 'Partial success. Some resources were returned, but there

            were also errors possibly preventing some resources from

            being returned.

            '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyMemberGetResponse'
    post:
      tags:
      - Directories
      summary: Pure Storage Create a Membership Between a Directory and One or More Audit Policies
      description: 'Creates a membership between a directory and one or more audit policies.

        Either the `member_ids` or `member_names` parameter is required, but they cannot

        be set together.


        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Context_names'
      - $ref: '#/components/parameters/Member_ids'
      - $ref: '#/components/parameters/Member_names'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DirectoryPolicyPost'
        required: true
        x-codegen-request-body-name: policies
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyMemberResponse'
      x-codegen-request-body-name: policies
    delete:
      tags:
      - Directories
      summary: Pure Storage Delete a Membership Between a Directory and One or More Audit Policies
      description: 'Deletes a membership between a directory and one or more audit policies.

        Either the `policy_ids` or `policy_names` parameter is required, but they cannot be

        set together.

        Either the `member_ids` or `member_names` parameter is required, but they cannot be

        set together.


        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Context_names'
      - $ref: '#/components/parameters/Member_ids'
      - $ref: '#/components/parameters/Member_names'
      - $ref: '#/components/parameters/Policy_ids'
      - $ref: '#/components/parameters/Policy_names'
      responses:
        '200':
          description: OK
          content: {}
  /api/2.52/directories/policies/autodir:
    get:
      tags:
      - Directories
      summary: Pure Storage List Auto Managed Directory Policies Attached to a Directory
      description: 'Displays a list of auto managed directory policies that are attached to directories.


        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Allow_errors'
      - $ref: '#/components/parameters/Context_names_get'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/components/parameters/Destroyed'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Member_ids'
      - $ref: '#/components/parameters/Member_names'
      - $ref: '#/components/parameters/Offset'
      - $ref: '#/components/parameters/Policy_ids'
      - $ref: '#/components/parameters/Policy_names'
      - $ref: '#/components/parameters/Sort'
      - $ref: '#/components/parameters/Total_item_count'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyMemberGetResponse'
        '207':
          description: 'Partial success. Some resources were returned, but there

            were also errors possibly preventing some resources from

            being returned.

            '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyMemberGetResponse'
    post:
      tags:
      - Directories
      summary: Pure Storage Create a Membership Between a Directory with One or More Auto Managed Directory Policies
      description: 'Creates a membership between a directory with one or more auto managed directory policies.

        The `member_ids` or `member_names` parameter is required, but they cannot be set together.


        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Context_names'
      - $ref: '#/components/parameters/Member_ids'
      - $ref: '#/components/parameters/Member_names'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DirectoryPolicyPost'
        required: true
        x-codegen-request-body-name: policies
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyMemberResponse'
      x-codegen-request-body-name: policies
    delete:
      tags:
      - Directories
      summary: Pure Storage Delete a Membership Between a Directory and One or More Auto Managed Directory Policies
      description: 'Deletes a membership between a directory with one or more auto managed directory policies.

        The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.

        The `member_ids` or `member_names` parameter is required, but they cannot be set together.


        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Context_names'
      - $ref: '#/components/parameters/Member_ids'
      - $ref: '#/components/parameters/Member_names'
      - $ref: '#/components/parameters/Policy_ids'
      - $ref: '#/components/parameters/Policy_names'
      responses:
        '200':
          description: OK
          content: {}
  /api/2.52/directories/policies/nfs:
    get:
      tags:
      - Directories
      summary: Pure Storage List NFS Policies Attached to a Directory
      description: 'Displays a list of NFS policies that are attached to directories.


        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Allow_errors'
      - $ref: '#/components/parameters/Context_names_get'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/components/parameters/Destroyed'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Member_ids'
      - $ref: '#/components/parameters/Member_names'
      - $ref: '#/components/parameters/Offset'
      - $ref: '#/components/parameters/Policy_ids'
      - $ref: '#/components/parameters/Policy_fqnames'
      - $ref: '#/components/parameters/Sort'
      - $ref: '#/components/parameters/Total_item_count'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyMemberExportGetResponse'
        '207':
          description: 'Partial success. Some resources were returned, but there

            were also errors possibly preventing some resources from

            being returned.

            '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyMemberExportGetResponse'
    post:
      tags:
      - Directories
      summary: Pure Storage Create a Membership Between a Directory and One or More NFS Policies
      description: 'Creates a membership between a directory and one or more NFS policies.

        The `member_ids` or `member_names` parameter is required but cannot be set together.


        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Context_names'
      - $ref: '#/components/parameters/Member_ids'
      - $ref: '#/components/parameters/Member_names'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DirectoryPolicyExportPost'
        required: true
        x-codegen-request-body-name: policies
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyMemberExportResponse'
      x-codegen-request-body-name: policies
    delete:
      tags:
      - Directories
      summary: Pure Storage Delete a Membership Between a Directory and One or More NFS Policies
      description: 'Deletes a membership between a directory and one or more NFS policies.

        The `policy_ids` or `policy_names` parameter is required, but cannot be set together.

        The `member_ids` or `member_names` parameter is required, but cannot be set together.


        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Context_names'
      - $ref: '#/components/parameters/Member_ids'
      - $ref: '#/components/parameters/Member_names'
      - $ref: '#/components/parameters/Policy_ids'
      - $ref: '#/components/parameters/Policy_fqnames'
      - $ref: '#/components/parameters/Server_ids'
      - $ref: '#/components/parameters/Server_fqnames'
      responses:
        '200':
          description: OK
          content: {}
  /api/2.52/directories/policies/quota:
    get:
      tags:
      - Directories
      summary: Pure Storage List Quota Policies Attached to a Directory
      description: Displays a list of quota policies that are attached to directories.
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Allow_errors'
      - $ref: '#/components/parameters/Context_names_get'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/components/parameters/Destroyed'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Member_ids'
      - $ref: '#/components/parameters/Member_names'
      - $ref: '#/components/parameters/Offset'
      - $ref: '#/components/parameters/Policy_ids'
      - $ref: '#/components/parameters/Policy_names'
      - $ref: '#/components/parameters/Sort'
      - $ref: '#/components/parameters/Total_item_count'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyMemberGetResponse'
        '207':
          description: 'Partial success. Some resources were returned, but there

            were also errors possibly preventing some resources from

            being returned.

            '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyMemberGetResponse'
    post:
      tags:
      - Directories
      summary: Pure Storage Create a Membership Between a Directory and One or More Quota Policies
      description: 'Creates a membership between a directory and one or more quota policies.

        The `member_ids` or `member_names` parameter is required, but cannot be set together.


        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Context_names'
      - $ref: '#/components/parameters/Ignore_usage'
      - $ref: '#/components/parameters/Member_ids'
      - $ref: '#/components/parameters/Member_names'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DirectoryPolicyPost'
        required: true
        x-codegen-request-body-name: policies
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyMemberResponse'
      x-codegen-request-body-name: policies
    delete:
      tags:
      - Directories
      summary: Pure Storage Delete a Membership Between a Directory and One or More Quota Policies
      description: 'Deletes a membership between a directory and one or more quota policies.

        The `policy_ids` or `policy_names` parameter is required, but cannot be set together.

        The `member_ids` or `member_names` parameter is required, but cannot be set together.


        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Context_names'
      - $ref: '#/components/parameters/Member_ids'
      - $ref: '#/components/parameters/Member_names'
      - $ref: '#/components/parameters/Policy_ids'
      - $ref: '#/components/parameters/Policy_names'
      responses:
        '200':
          description: OK
          content: {}
  /api/2.52/directories/policies/smb:
    get:
      tags:
      - Directories
      summary: Pure Storage List SMB Policies Attached to a Directory
      description: Displays a list of SMB policies that are attached to directories.
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Allow_errors'
      - $ref: '#/components/parameters/Context_names_get'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/components/parameters/Destroyed'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Member_ids'
      - $ref: '#/components/parameters/Member_names'
      - $ref: '#/components/parameters/Offset'
      - $ref: '#/components/parameters/Policy_ids'
      - $ref: '#/components/parameters/Policy_fqnames'
      - $ref: '#/components/parameters/Sort'
      - $ref: '#/components/parameters/Total_item_count'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyMemberExportGetResponse'
        '207':
          description: 'Partial success. Some resources were returned, but there

            were also errors possibly preventing some resources from

            being returned.

            '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyMemberExportGetResponse'
    post:
      tags:
      - Directories
      summary: Pure Storage Create a Membership Between a Directory and One or More SMB Policies
      description: 'Creates a membership between a directory and one or more SMB policies.

        The `member_ids` or `member_names` parameter is required, but cannot be set together.


        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Context_names'
      - $ref: '#/components/parameters/Member_ids'
      - $ref: '#/components/parameters/Member_names'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DirectoryPolicyExportPost'
        required: true
        x-codegen-request-body-name: policies
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyMemberExportResponse'
      x-codegen-request-body-name: policies
    delete:
      tags:
      - Directories
      summary: Pure Storage Delete a Membership Between a Directory and One or More SMB Policies
      description: 'Deletes a membership between a directory and one or more SMB policies.

        The `policy_ids` or `policy_names` parameter is required, but cannot be set together.

        The `member_ids` or `member_names` parameter is required, but cannot be set together.


        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Context_names'
      - $ref: '#/components/parameters/Member_ids'
      - $ref: '#/components/parameters/Member_names'
      - $ref: '#/components/parameters/Policy_ids'
      - $ref: '#/components/parameters/Policy_fqnames'
      - $ref: '#/components/parameters/Server_ids'
      - $ref: '#/components/parameters/Server_fqnames'
      responses:
        '200':
          description: OK
          content: {}
  /api/2.52/directories/policies/snapshot:
    get:
      tags:
      - Directories
      summary: Pure Storage List Snapshot Policies Attached to a Directory
      description: Displays a list of snapshot policies that are attached to directories.
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Allow_errors'
      - $ref: '#/components/parameters/Context_names_get'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/components/parameters/Destroyed'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Member_ids'
      - $ref: '#/components/parameters/Member_names'
      - $ref: '#/components/parameters/Offset'
      - $ref: '#/components/parameters/Policy_ids'
      - $ref: '#/components/parameters/Policy_names'
      - $ref: '#/components/parameters/Sort'
      - $ref: '#/components/parameters/Total_item_count'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyMemberGetResponse'
        '207':
          description: 'Partial success. Some resources were returned, but there

            were also errors possibly preventing some resources from

            being returned.

            '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyMemberGetResponse'
    post:
      tags:
      - Directories
      summary: Pure Storage Create a Membership Between a Directory with One or More Snapshot Policies
      description: 

# --- truncated at 32 KB (116 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/openapi/pure-storage-directories-api-openapi.yml