Pure Storage

Pure Storage Buckets API

Manages the creation, attributes, and deletion of buckets on the array.

GitHub OpenAPI

Operations 30

GET /api/2.52/buckets Pure Storage GET Buckets
POST /api/2.52/buckets Pure Storage POST Buckets
DELETE /api/2.52/buckets Pure Storage DELETE Buckets
PATCH /api/2.52/buckets Pure Storage PATCH Buckets
GET /api/2.52/buckets/space Pure Storage List Bucket Space Information
GET /api/2.52/buckets/performance Pure Storage List Bucket Performance Data
GET /api/2.26/bucket-audit-filter-actions Pure Storage GET Bucket-audit-filter-actions
GET /api/2.26/buckets Pure Storage GET Buckets
POST /api/2.26/buckets Pure Storage POST Buckets
DELETE /api/2.26/buckets Pure Storage DELETE Buckets
PATCH /api/2.26/buckets Pure Storage PATCH Buckets
GET /api/2.26/buckets/audit-filters Pure Storage GET Buckets/audit-filters
POST /api/2.26/buckets/audit-filters Pure Storage POST Buckets/audit-filters
DELETE /api/2.26/buckets/audit-filters Pure Storage DELETE Buckets/audit-filters
PATCH /api/2.26/buckets/audit-filters Pure Storage PATCH Buckets/audit-filters
GET /api/2.26/buckets/cross-origin-resource-sharing-policies Pure Storage GET Buckets/cross-origin-resource-sharing-policies
POST /api/2.26/buckets/cross-origin-resource-sharing-policies Pure Storage POST Buckets/cross-origin-resource-sharing-policies
DELETE /api/2.26/buckets/cross-origin-resource-sharing-policies Pure Storage DELETE Buckets/cross-origin-resource-sharing-policies
GET /api/2.26/buckets/cross-origin-resource-sharing-policies/rules Pure Storage GET Buckets/cross-origin-resource-sharing-policies/rules
POST /api/2.26/buckets/cross-origin-resource-sharing-policies/rules Pure Storage POST Buckets/cross-origin-resource-sharing-policies/rules
DELETE /api/2.26/buckets/cross-origin-resource-sharing-policies/rules Pure Storage DELETE Buckets/cross-origin-resource-sharing-policies/rules
GET /api/2.26/buckets/performance Pure Storage GET Buckets/performance
GET /api/2.26/buckets/bucket-access-policies Pure Storage GET Buckets/bucket-access-policies
POST /api/2.26/buckets/bucket-access-policies Pure Storage POST Buckets/bucket-access-policies
DELETE /api/2.26/buckets/bucket-access-policies Pure Storage DELETE Buckets/bucket-access-policies
GET /api/2.26/buckets/bucket-access-policies/rules Pure Storage GET Buckets/bucket-access-policies/rules
POST /api/2.26/buckets/bucket-access-policies/rules Pure Storage POST Buckets/bucket-access-policies/rules
DELETE /api/2.26/buckets/bucket-access-policies/rules Pure Storage DELETE Buckets/bucket-access-policies/rules
GET /api/2.26/buckets/s3-specific-performance Pure Storage GET Buckets/s3-specific-performance
GET /api/1.5/buckets Pure Storage Get Buckets

Documentation

📖
APIReference
https://code.purestorage.com/swagger
📖
Documentation
https://code.purestorage.com
📖
APIReference
https://static.pure1.purestorage.com/api-swagger/index.html
📖
Documentation
https://support.purestorage.com/Pure1/Pure1_Manage/Pure1_Manage_-_REST_API/Pure1_Manage_-_REST_API__Reference

Specifications

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

Code Examples

💻
CodeExamples
https://github.com/PureStorage-OpenConnect/ansible-playbook-examples
💻
CodeExamples
https://github.com/PureStorage-OpenConnect/python-scripts
💻
CodeExamples
https://github.com/PureStorage-OpenConnect/sqlserver-scripts
💻
CodeExamples
https://github.com/PureStorage-OpenConnect/oracle-scripts
💻
CodeExamples
https://github.com/PureStorage-OpenConnect/VMware-Scripts

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/json-schema/flasharray-rest-api-volume-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/json-schema/flasharray-rest-api-host-schema.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/json-structure/flasharray-rest-api-volume-structure.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/json-schema/flashblade-rest-api-file-system-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/json-schema/flashblade-rest-api-bucket-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/json-schema/flashblade-rest-api-array-schema.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/json-structure/flashblade-rest-api-file-system-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/json-structure/flashblade-rest-api-bucket-structure.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/json-schema/pure1-cloud-api-array-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/json-schema/pure1-cloud-api-metric-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/json-schema/pure1-cloud-api-alert-schema.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/json-structure/pure1-cloud-api-array-structure.json

Other Resources

🔗
SDKs
https://pypi.org/project/py-pure-client/
🔗
SDKs
https://github.com/PureStorage-OpenConnect/PureStorage.Pure1
🔗
SDKs
https://github.com/PureStorage-OpenConnect/powershell-toolkit-3
🔗
SDKs
https://github.com/PureStorage-OpenConnect/rest-client
🔗
Integrations
https://github.com/PureStorage-OpenConnect/terraform-provider-flash
🔗
Integrations
https://github.com/PureStorage-OpenConnect/pure-fa-openmetrics-exporter
🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/json-ld/pure-storage-flasharray-rest-api-context.jsonld
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/examples/flasharray-rest-api-volume-example.json
🔗
SDKs
https://github.com/PureStorage-OpenConnect/flashblade-powershell
🔗
SDKs
https://github.com/purestorage/purity_fb_python_client
🔗
Integrations
https://github.com/PureStorage-OpenConnect/pure-fb-openmetrics-exporter
🔗
Tools
https://github.com/PureStorage-OpenConnect/flashblade-mcp-server
🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/json-ld/pure-storage-flashblade-rest-api-context.jsonld
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/examples/flashblade-rest-api-file-system-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/examples/flashblade-rest-api-bucket-example.json
🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/json-ld/pure-storage-pure1-cloud-api-context.jsonld
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/pure-storage/refs/heads/main/examples/pure1-cloud-api-array-example.json

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/pure-storage-buckets-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

pure-storage-buckets-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: FlashArray REST Active Directory Buckets 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: Buckets
  description: Manages the creation, attributes, and deletion of buckets on the array.
paths:
  /api/2.52/buckets:
    get:
      tags:
      - Buckets
      summary: Pure Storage GET Buckets
      description: List object store bucket attributes such as creation time and space usage.
      parameters:
      - $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/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'
      responses:
        '200':
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BucketGetResponse'
        '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/BucketGetResponse'
    post:
      tags:
      - Buckets
      summary: Pure Storage POST Buckets
      description: Create a new object store bucket.
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Context_names'
      - $ref: '#/components/parameters/Names_required'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_bucketPostBase'
        required: true
        x-codegen-request-body-name: bucket
      responses:
        '200':
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BucketResponse'
      x-codegen-request-body-name: bucket
    delete:
      tags:
      - Buckets
      summary: Pure Storage DELETE Buckets
      description: Delete object store buckets.
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Context_names'
      - $ref: '#/components/parameters/Ids'
      - $ref: '#/components/parameters/Names'
      responses:
        '200':
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content: {}
    patch:
      tags:
      - Buckets
      summary: Pure Storage PATCH Buckets
      description: Modify object store bucket attributes such as destroyed and versioning.
      parameters:
      - $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/_bucketPatchBase'
        required: true
        x-codegen-request-body-name: bucket
      responses:
        '200':
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BucketResponse'
      x-codegen-request-body-name: bucket
  /api/2.52/buckets/space:
    get:
      tags:
      - Buckets
      summary: Pure Storage List Bucket Space Information
      description: 'The monitoring interface or dataset that provides `physical storage`

        `consumption` data for each individual `bucket`.


        '
      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/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/ResourceBucketSpaceGetResponse'
        '207':
          description: 'The status indicating a partial success. While some `resources`

            were successfully returned, specific `errors` occurred during

            the operation that may have prevented the full set of

            requested data from being retrieved.

            '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceBucketSpaceGetResponse'
  /api/2.52/buckets/performance:
    get:
      x-pure-block-remote-execution: true
      tags:
      - Buckets
      summary: Pure Storage List Bucket Performance Data
      description: 'The monitoring interface that provides real-time and historical

        performance data, including `latency` and average `I/O` sizes.

        These metrics are available for each individual `bucket` and as

        an aggregate total for all buckets across the entire `array`.

        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $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/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/BucketPerformanceGetResponse'
  /api/2.26/bucket-audit-filter-actions:
    get:
      tags:
      - Buckets
      summary: Pure Storage GET Bucket-audit-filter-actions
      description: 'List valid actions for bucket audit filter. Each action is either a valid

        AWS S3 action (prefixed by `s3:`), special wildcard action (`s3:*`), or our

        custom group of actions (`s3:ReadOnly`, `s3:WriteOnly`). Each action, when

        included in a rule, may audit the action on the bucket.


        '
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Allow_errors'
      - $ref: '#/components/parameters/Context_names_get'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Names'
      - $ref: '#/components/parameters/Offset_2'
      - $ref: '#/components/parameters/Sort_2'
      responses:
        '200':
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BucketAuditFilterActionGetResponse'
        '207':
          description: 'Partial success. Some resources were returned, but there

            were also errors possibly preventing some resources from

            being returned.

            '
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BucketAuditFilterActionGetResponse'
  /api/2.26/buckets:
    get:
      tags:
      - Buckets
      summary: Pure Storage GET Buckets
      description: List object store bucket attributes such as creation time and space usage.
      parameters:
      - $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/Ids_2'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Names'
      - $ref: '#/components/parameters/Offset_2'
      - $ref: '#/components/parameters/Sort_2'
      - $ref: '#/components/parameters/Total_only'
      responses:
        '200':
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BucketGetResponse_2'
        '207':
          description: 'Partial success. Some resources were returned, but there

            were also errors possibly preventing some resources from

            being returned.

            '
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BucketGetResponse_2'
    post:
      tags:
      - Buckets
      summary: Pure Storage POST Buckets
      description: Create a new object store bucket.
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Context_names'
      - $ref: '#/components/parameters/Names_required_2'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BucketPost'
        required: true
        x-codegen-request-body-name: bucket
      responses:
        '200':
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BucketResponse'
      x-codegen-request-body-name: bucket
    delete:
      tags:
      - Buckets
      summary: Pure Storage DELETE Buckets
      description: Delete object store buckets.
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Context_names'
      - $ref: '#/components/parameters/Ids_2'
      - $ref: '#/components/parameters/Names'
      responses:
        '200':
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content: {}
    patch:
      tags:
      - Buckets
      summary: Pure Storage PATCH Buckets
      description: Modify object store bucket attributes such as destroyed and versioning.
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Cancel_storage_class_transition'
      - $ref: '#/components/parameters/Context_names'
      - $ref: '#/components/parameters/Ids_2'
      - $ref: '#/components/parameters/Ignore_usage'
      - $ref: '#/components/parameters/Names'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BucketPatch'
        required: true
        x-codegen-request-body-name: bucket
      responses:
        '200':
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BucketResponse'
      x-codegen-request-body-name: bucket
  /api/2.26/buckets/audit-filters:
    get:
      tags:
      - Buckets
      summary: Pure Storage GET Buckets/audit-filters
      description: 'List audit filters associated with the specified bucket.

        '
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Allow_errors'
      - $ref: '#/components/parameters/Bucket_ids'
      - $ref: '#/components/parameters/Bucket_names'
      - $ref: '#/components/parameters/Context_names_get'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Names'
      - $ref: '#/components/parameters/Offset_2'
      - $ref: '#/components/parameters/Sort_2'
      responses:
        '200':
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BucketAuditFilterGetResponse'
        '207':
          description: 'Partial success. Some resources were returned, but there

            were also errors possibly preventing some resources from

            being returned.

            '
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BucketAuditFilterGetResponse'
    post:
      tags:
      - Buckets
      summary: Pure Storage POST Buckets/audit-filters
      description: 'Create a new audit filter for the specified bucket.

        `names` query parameter is required.

        '
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Bucket_ids'
      - $ref: '#/components/parameters/Bucket_names'
      - $ref: '#/components/parameters/Context_names'
      - $ref: '#/components/parameters/Names_required_2'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BucketAuditFilterPost'
        required: true
        x-codegen-request-body-name: audit filter
      responses:
        '200':
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BucketAuditFilterResponse'
      x-codegen-request-body-name: audit filter
    delete:
      tags:
      - Buckets
      summary: Pure Storage DELETE Buckets/audit-filters
      description: 'Delete one or more audit filters associated with the specified bucket.

        `names` query parameter is required.

        '
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Bucket_ids'
      - $ref: '#/components/parameters/Bucket_names'
      - $ref: '#/components/parameters/Context_names'
      - $ref: '#/components/parameters/Names'
      responses:
        '200':
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content: {}
    patch:
      tags:
      - Buckets
      summary: Pure Storage PATCH Buckets/audit-filters
      description: 'Modify the audit filter associated with the specified bucket.

        `names` query parameter is required.

        '
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Bucket_ids'
      - $ref: '#/components/parameters/Bucket_names'
      - $ref: '#/components/parameters/Context_names'
      - $ref: '#/components/parameters/Names_required_2'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BucketAuditFilterPost'
        required: true
        x-codegen-request-body-name: audit filter
      responses:
        '200':
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BucketAuditFilterResponse'
      x-codegen-request-body-name: audit filter
  /api/2.26/buckets/cross-origin-resource-sharing-policies:
    get:
      tags:
      - Buckets
      summary: Pure Storage GET Buckets/cross-origin-resource-sharing-policies
      description: 'List cross origin resource sharing policy for the specified bucket and its attributes.

        Either `names` or `bucket_names`/`bucket_ids` query parameters can be used.

        '
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Allow_errors'
      - $ref: '#/components/parameters/Bucket_ids'
      - $ref: '#/components/parameters/Bucket_names'
      - $ref: '#/components/parameters/Context_names_get'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Names'
      - $ref: '#/components/parameters/Offset_2'
      - $ref: '#/components/parameters/Sort_2'
      responses:
        '200':
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CrossOriginResourceSharingPolicyGetResponse'
        '207':
          description: 'Partial success. Some resources were returned, but there

            were also errors possibly preventing some resources from

            being returned.

            '
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CrossOriginResourceSharingPolicyGetResponse'
    post:
      tags:
      - Buckets
      summary: Pure Storage POST Buckets/cross-origin-resource-sharing-policies
      description: 'Create a new cross origin resource sharing policy for the specified bucket.

        Policy''s name will be autogenerated by the system.

        '
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Bucket_ids'
      - $ref: '#/components/parameters/Bucket_names'
      - $ref: '#/components/parameters/Context_names'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CrossOriginResourceSharingPolicyPatch'
        required: false
        x-codegen-request-body-name: policy
      responses:
        '200':
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CrossOriginResourceSharingPolicyResponse'
      x-codegen-request-body-name: policy
    delete:
      tags:
      - Buckets
      summary: Pure Storage DELETE Buckets/cross-origin-resource-sharing-policies
      description: 'Delete a cross origin resource sharing policy of the specified bucket.

        Either `names` or `bucket_names`/`bucket_ids` query parameters can be used.

        '
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Bucket_ids'
      - $ref: '#/components/parameters/Bucket_names'
      - $ref: '#/components/parameters/Context_names'
      - $ref: '#/components/parameters/Names'
      responses:
        '200':
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content: {}
  /api/2.26/buckets/cross-origin-resource-sharing-policies/rules:
    get:
      tags:
      - Buckets
      summary: Pure Storage GET Buckets/cross-origin-resource-sharing-policies/rules
      description: 'List cross origin resource sharing policy rules for the specified bucket and their attributes.

        Either `policy_names` or `bucket_names` query parameters can be used.

        '
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Allow_errors'
      - $ref: '#/components/parameters/Bucket_ids'
      - $ref: '#/components/parameters/Bucket_names'
      - $ref: '#/components/parameters/Context_names_get'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Names'
      - $ref: '#/components/parameters/Offset_2'
      - $ref: '#/components/parameters/Policy_names'
      - $ref: '#/components/parameters/Sort_2'
      responses:
        '200':
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CrossOriginResourceSharingPolicyRuleGetResponse'
        '207':
          description: 'Partial success. Some resources were returned, but there

            were also errors possibly preventing some resources from

            being returned.

            '
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CrossOriginResourceSharingPolicyRuleGetResponse'
    post:
      tags:
      - Buckets
      summary: Pure Storage POST Buckets/cross-origin-resource-sharing-policies/rules
      description: 'Create a new cross origin resource sharing policy rule for the specified bucket.

        Either `policy_names` or `bucket_names` query parameters can be used.

        '
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Bucket_ids'
      - $ref: '#/components/parameters/Bucket_names'
      - $ref: '#/components/parameters/Context_names'
      - $ref: '#/components/parameters/Names_required_2'
      - $ref: '#/components/parameters/Policy_names'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CrossOriginResourceSharingPolicyRulePost'
        required: true
        x-codegen-request-body-name: rule
      responses:
        '200':
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CrossOriginResourceSharingPolicyRuleResponse'
      x-codegen-request-body-name: rule
    delete:
      tags:
      - Buckets
      summary: Pure Storage DELETE Buckets/cross-origin-resource-sharing-policies/rules
      description: 'Delete one or more cross origin resource sharing policy rules for the specified bucket.

        Either `policy_names` or `bucket_names` query parameters can be used.

        '
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Bucket_ids'
      - $ref: '#/components/parameters/Bucket_names'
      - $ref: '#/components/parameters/Context_names'
      - $ref: '#/components/parameters/Names'
      - $ref: '#/components/parameters/Policy_names'
      responses:
        '200':
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content: {}
  /api/2.26/buckets/performance:
    get:
      tags:
      - Buckets
      summary: Pure Storage GET Buckets/performance
      description: List performance metrics for a bucket.
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/components/parameters/End_time'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Ids_2'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Names'
      - $ref: '#/components/parameters/Offset_2'
      - $ref: '#/components/parameters/Resolution'
      - $ref: '#/components/parameters/Sort_2'
      - $ref: '#/components/parameters/Start_time'
      - $ref: '#/components/parameters/Total_only'
      responses:
        '200':
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BucketPerformanceGetResponse_2'
  /api/2.26/buckets/bucket-access-policies:
    get:
      tags:
      - Buckets
      summary: Pure Storage GET Buckets/bucket-access-policies
      description: 'List a policy for the specified bucket and its attributes. Either `names` or

        `bucket_names`/`bucket_ids` query parameters can be used.

        '
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Allow_errors'
      - $ref: '#/components/parameters/Bucket_ids'
      - $ref: '#/components/parameters/Bucket_names'
      - $ref: '#/components/parameters/Context_names_get'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Names'
      - $ref: '#/components/parameters/Offset_2'
      - $ref: '#/components/parameters/Sort_2'
      responses:
        '200':
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BucketAccessPolicyGetResponse'
        '207':
          description: 'Partial success. Some resources were returned, but there

            were also errors possibly preventing some resources from

            being returned.

            '
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BucketAccessPolicyGetResponse'
    post:
      tags:
      - Buckets
      summary: Pure Storage POST Buckets/bucket-access-policies
      description: 'Create a new policy for the specified bucket. Policy''s name will be autogenerated

        by the system.

        '
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Bucket_ids'
      - $ref: '#/components/parameters/Bucket_names'
      - $ref: '#/components/parameters/Context_names'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BucketAccessPolicyPost'
        required: false
        x-codegen-request-body-name: policy
      responses:
        '200':
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BucketAccessPolicyResponse'
      x-codegen-request-body-name: policy
    delete:
      tags:
      - Buckets
      summary: Pure Storage DELETE Buckets/bucket-access-policies
      description: 'Delete a bucket policy of the specified bucket. Either `names` or `bucket_names`/`bucket_ids`

        query parameters can be used.

        '
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Bucket_ids'
      - $ref: '#/components/parameters/Bucket_names'
      - $ref: '#/components/parameters/Context_names'
      - $ref: '#/components/parameters/Names'
      responses:
        '200':
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content: {}
  /api/2.26/buckets/bucket-access-policies/rules:
    get:
      tags:
      - Buckets
      summary: Pure Storage GET Buckets/bucket-access-policies/rules
      description: 'List bucket policy rules for the specified bucket and their attributes. Either `policy_names`

        or `bucket_names`/`bucket_ids` query parameters can be used.

        '
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Allow_errors'
      - $ref: '#/components/parameters/Bucket_ids'
      - $ref: '#/components/parameters/Bucket_names'
      - $ref: '#/components/parameters/Context_names_get'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/compone

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