Pure1 Public REST API

REST API for the Pure1 SaaS fleet management platform. Provides cross-array reporting, telemetry, capacity and performance metrics, alerts, audits, sustainability data, support contracts, and subscription information across the entire Pure Storage fleet.

OpenAPI Specification

pure1-cloud-api-openapi.yml Raw ↑
openapi: 3.0.1
info:
  title: Pure1 Public REST API
  description: "Pure1 Public REST API, developed by [Pure Storage, Inc.](https://www.purestorage.com)\n \nThe Pure1 REST API 2.0 offers one single form of authentication: OAuth 2.0 via the [Token Exchange
    protocol](https://datatracker.ietf.org/doc/draft-ietf-oauth-token-exchange).\n\nOAuth 2.0 is an open protocol to allow secure authorization in a simple and standard method from web, mobile, desktop
    and background applications.\n\nNote that the [Authentication](#section/Authentication) section below mentions 'API Key' as the security scheme type. This is solely for the purpose of allowing testing
    this API with [Swagger UI](https://static.pure1.purestorage.com/api-swagger/index.html).\n\n[Knowledge base reference documentation](https://support.purestorage.com/Pure1/Pure1_Manage/Pure1_Manage_-_REST_API/Pure1_Manage_-_REST_API__Reference)"
  version: "1.5"
  x-logo:
    url:
      $ref: ../redoc/PS-LogoBase64-P1.txt
    backgroundColor: "#fff"
    altText: Pure Storage logo
servers:
- url: https://api-staging.pure1.purestorage.com/
security:
- AuthorizationHeader: []
tags:
- name: Authorization
  description: |
    Handles authorization access to other API endpoints through OAuth 2.0 Token Exchange.
- name: Alerts
  description: |
    Provides access to capacity, health, and hardware related array alerts.
- name: Arrays
  description: |
    Provides information about FlashArray and FlashBlade appliances.
- name: Audits
  description: |
    Provides access to CLI audit logs from FlashArray and FlashBlade appliances.
- name: Blades
  description: |
    Provides information about FlashBlade blades.
- name: Buckets
  description: |
    Provides information about FlashBlade buckets.
- name: Bucket Replica Links
  description: |
    Provides information about replica links between buckets.
- name: Controllers
  description: |
    Provides information about FlashArray controllers.
- name: Directories
  description: |
    Provides information about FlashArray directories.
- name: Drives
  description: |
    Provides information about FlashArray drives.
- name: File Systems
  description: |
    Provides information about FlashArray and FlashBlade file systems.
- name: File System Replica Links
  description: |
    Provides information about replica links between FlashBlade file systems.
- name: File System Snapshots
  description: |
    Provides information about FlashBlade file system snapshots.
- name: Hardware
  description: |
    Provides information about hardware components.
- name: Hardware Connectors
  description: |
    Provides information about FlashBlade hardware connectors.
- name: Invoices
  description: |
    Provides information about Pure1 subscription invoices.
- name: Metrics
  description: |
    Provides information about historical metrics for arrays, buckets, directories,
    file systems, pods, subscription licenses, and volumes.
- name: Network Interfaces
  description: |
    Provides information about network interfaces available on arrays.
- name: Object Store Accounts
  description: |
    Provides information about object store accounts.
- name: Pods
  description: |
    Provides information about FlashArray pods. A pod is the pairing
    of two arrays that replicate some volumes with each other.
- name: Pod Replica Links
  description: |
    Provides information about replica links between FlashArray pods.
- name: Policies
  description: |
    Provides information about FlashBlade policies and the members
    they apply to.
- name: Ports
  description: |
    Provides information about FlashArray ports.
- name: Protection Group Snapshots
  description: |
    Protection group snapshots capture the content of all volumes on the source array
    for the specified protection group at a single point in time.
    The snapshot is an immutable image of the volume data at that instance in time.
    The volumes are either direct members of the protection group or connected to
    any of its hosts or host groups within a protection group.
    Volumes are protected through protection group snapshots that are retained locally,
    replicated to other arrays or storage systems, or both.
    Protection group snapshots can be manually generated on demand or enabled to automatically
    generate at scheduled intervals.
    After a protection group snapshot has been taken,
    it is either stored on the local array or replicated over to a remote (target) array.
- name: Subscriptions
  description: |
    Provides information about Pure1 subscription offerings.
- name: Sustainability
  description: |
    Provides information about energy consumption and sustainability.
- name: Targets
  description: |
    Provides information about FlashBlade external replication targets.
- name: Volumes
  description: |
    Provides information about block storage volumes on FlashArray arrays.
- name: Volume Snapshots
  description: |+
    Provides information about snapshots of block storage volumes
    on FlashArray arrays.

paths:
  /oauth2/1.0/token:
    post:
      tags:
      - Authorization
      summary: Pure Storage Get Access Token
      description: |
        Exchanges an ID Token for an OAuth 2.0 access token.
      parameters:
      - name: X-Request-ID
        in: header
        description: |
          Supplied by client during request or generated by server.
        schema:
          type: string
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              required:
              - grant_type
              - subject_token
              - subject_token_type
              type: object
              properties:
                grant_type:
                  $ref: '#/components/schemas/OauthGrantType'
                subject_token:
                  $ref: '#/components/schemas/OauthSubjectToken'
                subject_token_type:
                  $ref: '#/components/schemas/OauthSubjectTokenType'
        required: true
      responses:
        "200":
          $ref: '#/components/responses/OauthToken200'
        "400":
          $ref: '#/components/responses/OauthToken400'
        "401":
          $ref: '#/components/responses/OauthToken401'
      security: []
  /api/1.5/alerts:
    get:
      tags:
      - Alerts
      summary: Pure Storage Get Alerts
      description: |
        Retrieves information about alerts generated by Pure1-monitored appliances.
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Ids'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Names'
      - $ref: '#/components/parameters/Offset'
      - $ref: '#/components/parameters/Sort'
      responses:
        "200":
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
            X-RateLimit-Remaining-second:
              description: |
                The number of requests remaining for the organization in that second.
              schema:
                type: integer
            X-RateLimit-Remaining-minute:
              description: |
                The number of requests remaining for the organization in that minute.
              schema:
                type: integer
            X-RateLimit-Limit-second:
              description: The number of requests available per second.
              schema:
                type: integer
            X-RateLimit-Limit-minute:
              description: The number of requests available per minute.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AlertsGetResponse'
        "400":
          $ref: '#/components/responses/Error400'
        "403":
          $ref: '#/components/responses/Error403'
        "404":
          $ref: '#/components/responses/Error404'
        "429":
          $ref: '#/components/responses/Error429'
        "500":
          $ref: '#/components/responses/Error500'
  /api/1.5/arrays:
    get:
      tags:
      - Arrays
      summary: Pure Storage Get Arrays
      description: |
        Retrieves information about FlashArray and FlashBlade storage appliances.
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Fqdns'
      - $ref: '#/components/parameters/Ids'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Names'
      - $ref: '#/components/parameters/Offset'
      - $ref: '#/components/parameters/Sort'
      responses:
        "200":
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
            X-RateLimit-Remaining-second:
              description: |
                The number of requests remaining for the organization in that second.
              schema:
                type: integer
            X-RateLimit-Remaining-minute:
              description: |
                The number of requests remaining for the organization in that minute.
              schema:
                type: integer
            X-RateLimit-Limit-second:
              description: The number of requests available per second.
              schema:
                type: integer
            X-RateLimit-Limit-minute:
              description: The number of requests available per minute.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArrayGetResponse'
        "400":
          $ref: '#/components/responses/Error400'
        "403":
          $ref: '#/components/responses/Error403'
        "404":
          $ref: '#/components/responses/Error404'
        "429":
          $ref: '#/components/responses/Error429'
        "500":
          $ref: '#/components/responses/Error500'
  /api/1.5/arrays/support-contracts:
    get:
      tags:
      - Arrays
      summary: Pure Storage Get Array Support Contracts
      description: |
        Retrieves the support contracts associated with arrays.
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Offset'
      - $ref: '#/components/parameters/Resource_fqdns'
      - $ref: '#/components/parameters/Resource_ids'
      - $ref: '#/components/parameters/Resource_names'
      - $ref: '#/components/parameters/Sort'
      responses:
        "200":
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
            X-RateLimit-Remaining-second:
              description: |
                The number of requests remaining for the organization in that second.
              schema:
                type: integer
            X-RateLimit-Remaining-minute:
              description: |
                The number of requests remaining for the organization in that minute.
              schema:
                type: integer
            X-RateLimit-Limit-second:
              description: The number of requests available per second.
              schema:
                type: integer
            X-RateLimit-Limit-minute:
              description: The number of requests available per minute.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SupportContractGetResponse'
        "400":
          $ref: '#/components/responses/Error400'
        "403":
          $ref: '#/components/responses/Error403'
        "404":
          $ref: '#/components/responses/Error404'
        "429":
          $ref: '#/components/responses/Error429'
        "500":
          $ref: '#/components/responses/Error500'
  /api/1.5/arrays/tags:
    get:
      tags:
      - Arrays
      summary: Pure Storage Get Array Tags
      description: |
        Retrieves the tags associated with specified arrays.
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Keys'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Namespaces'
      - $ref: '#/components/parameters/Offset'
      - $ref: '#/components/parameters/Resource_ids'
      - $ref: '#/components/parameters/Resource_names'
      responses:
        "200":
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
            X-RateLimit-Remaining-second:
              description: |
                The number of requests remaining for the organization in that second.
              schema:
                type: integer
            X-RateLimit-Remaining-minute:
              description: |
                The number of requests remaining for the organization in that minute.
              schema:
                type: integer
            X-RateLimit-Limit-second:
              description: The number of requests available per second.
              schema:
                type: integer
            X-RateLimit-Limit-minute:
              description: The number of requests available per minute.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TagGetResponse'
        "400":
          $ref: '#/components/responses/Error400'
        "403":
          $ref: '#/components/responses/Error403'
        "404":
          $ref: '#/components/responses/Error404'
        "429":
          $ref: '#/components/responses/Error429'
        "500":
          $ref: '#/components/responses/Error500'
    delete:
      tags:
      - Arrays
      summary: Pure Storage Delete Array Tags
      description: |
        Deletes array tags from Pure1.
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Keys'
      - $ref: '#/components/parameters/Namespaces'
      - $ref: '#/components/parameters/Resource_idsRequired'
      - $ref: '#/components/parameters/Resource_namesRequired'
      responses:
        "200":
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
            X-RateLimit-Remaining-second:
              description: |
                The number of requests remaining for the organization in that second.
              schema:
                type: integer
            X-RateLimit-Remaining-minute:
              description: |
                The number of requests remaining for the organization in that minute.
              schema:
                type: integer
            X-RateLimit-Limit-second:
              description: The number of requests available per second.
              schema:
                type: integer
            X-RateLimit-Limit-minute:
              description: The number of requests available per minute.
              schema:
                type: integer
          content: {}
        "400":
          $ref: '#/components/responses/Error400'
        "403":
          $ref: '#/components/responses/Error403'
        "404":
          $ref: '#/components/responses/Error404'
        "429":
          $ref: '#/components/responses/Error429'
        "500":
          $ref: '#/components/responses/Error500'
  /api/1.5/arrays/tags/batch:
    put:
      tags:
      - Arrays
      summary: |-
        Pure Storage Create or Update Array Tags
      description: |
        Creates or updates array tags contextual to Pure1 only.
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Namespaces'
      - $ref: '#/components/parameters/Resource_idsRequired'
      - $ref: '#/components/parameters/Resource_namesRequired'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TagBatchRequired'
      responses:
        "200":
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
            X-RateLimit-Remaining-second:
              description: |
                The number of requests remaining for the organization in that second.
              schema:
                type: integer
            X-RateLimit-Remaining-minute:
              description: |
                The number of requests remaining for the organization in that minute.
              schema:
                type: integer
            X-RateLimit-Limit-second:
              description: The number of requests available per second.
              schema:
                type: integer
            X-RateLimit-Limit-minute:
              description: The number of requests available per minute.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TagResponse'
        "400":
          $ref: '#/components/responses/Error400'
        "403":
          $ref: '#/components/responses/Error403'
        "404":
          $ref: '#/components/responses/Error404'
        "429":
          $ref: '#/components/responses/Error429'
        "500":
          $ref: '#/components/responses/Error500'
  /api/1.5/assessment/sustainability/arrays:
    get:
      tags:
      - Sustainability
      summary: Pure Storage Get Appliance Sustainability Information.
      description: |
        Retrieves information about FlashArray and FlashBlade size,
        power consumption, heat generation and its sustainability assessment.
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Fqdns'
      - $ref: '#/components/parameters/Ids'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Names'
      - $ref: '#/components/parameters/Offset'
      - $ref: '#/components/parameters/Sort'
      responses:
        "200":
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
            X-RateLimit-Remaining-second:
              description: |
                The number of requests remaining for the organization in that second.
              schema:
                type: integer
            X-RateLimit-Remaining-minute:
              description: |
                The number of requests remaining for the organization in that minute.
              schema:
                type: integer
            X-RateLimit-Limit-second:
              description: The number of requests available per second.
              schema:
                type: integer
            X-RateLimit-Limit-minute:
              description: The number of requests available per minute.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SustainabilityArrayGetResponse'
        "400":
          $ref: '#/components/responses/Error400'
        "403":
          $ref: '#/components/responses/Error403'
        "404":
          $ref: '#/components/responses/Error404'
        "429":
          $ref: '#/components/responses/Error429'
        "500":
          $ref: '#/components/responses/Error500'
  /api/1.5/assessment/sustainability/insights/arrays:
    get:
      tags:
      - Sustainability
      summary: Pure Storage Get Appliance Sustainability Insights Information.
      description: |
        Retrieves information about FlashArray and FlashBlade insights
        connected to sustainability assessment.
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Offset'
      - $ref: '#/components/parameters/Sort'
      responses:
        "200":
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
            X-RateLimit-Remaining-second:
              description: |
                The number of requests remaining for the organization in that second.
              schema:
                type: integer
            X-RateLimit-Remaining-minute:
              description: |
                The number of requests remaining for the organization in that minute.
              schema:
                type: integer
            X-RateLimit-Limit-second:
              description: The number of requests available per second.
              schema:
                type: integer
            X-RateLimit-Limit-minute:
              description: The number of requests available per minute.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SustainabilityInsightArrayGetResponse'
        "400":
          $ref: '#/components/responses/Error400'
        "403":
          $ref: '#/components/responses/Error403'
        "404":
          $ref: '#/components/responses/Error404'
        "429":
          $ref: '#/components/responses/Error429'
        "500":
          $ref: '#/components/responses/Error500'
  /api/1.5/audits:
    get:
      tags:
      - Audits
      summary: Pure Storage Get Audits
      description: |
        Retrieves audit objects.
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Ids'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Names'
      - $ref: '#/components/parameters/Offset'
      - $ref: '#/components/parameters/Sort'
      responses:
        "200":
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
            X-RateLimit-Remaining-second:
              description: |
                The number of requests remaining for the organization in that second.
              schema:
                type: integer
            X-RateLimit-Remaining-minute:
              description: |
                The number of requests remaining for the organization in that minute.
              schema:
                type: integer
            X-RateLimit-Limit-second:
              description: The number of requests available per second.
              schema:
                type: integer
            X-RateLimit-Limit-minute:
              description: The number of requests available per minute.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuditsGetResponse'
        "400":
          $ref: '#/components/responses/Error400'
        "403":
          $ref: '#/components/responses/Error403'
        "404":
          $ref: '#/components/responses/Error404'
        "429":
          $ref: '#/components/responses/Error429'
        "500":
          $ref: '#/components/responses/Error500'
  /api/1.5/blades:
    get:
      tags:
      - Blades
      summary: Pure Storage Get Blades
      description: |
        Retrieves information about FlashBlade blades.
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Ids'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Names'
      - $ref: '#/components/parameters/Offset'
      - $ref: '#/components/parameters/Sort'
      responses:
        "200":
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
            X-RateLimit-Remaining-second:
              description: |
                The number of requests remaining for the organization in that second.
              schema:
                type: integer
            X-RateLimit-Remaining-minute:
              description: |
                The number of requests remaining for the organization in that minute.
              schema:
                type: integer
            X-RateLimit-Limit-second:
              description: The number of requests available per second.
              schema:
                type: integer
            X-RateLimit-Limit-minute:
              description: The number of requests available per minute.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BladeGetResponse'
        "400":
          $ref: '#/components/responses/Error400'
        "403":
          $ref: '#/components/responses/Error403'
        "404":
          $ref: '#/components/responses/Error404'
        "429":
          $ref: '#/components/responses/Error429'
        "500":
          $ref: '#/components/responses/Error500'
  /api/1.5/buckets:
    get:
      tags:
      - Buckets
      summary: Pure Storage Get Buckets
      description: |
        Retrieves buckets.
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Ids'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Names'
      - $ref: '#/components/parameters/Offset'
      - $ref: '#/components/parameters/Sort'
      responses:
        "200":
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
            X-RateLimit-Remaining-second:
              description: |
                The number of requests remaining for the organization in that second.
              schema:
                type: integer
            X-RateLimit-Remaining-minute:
              description: |
                The number of requests remaining for the organization in that minute.
              schema:
                type: integer
            X-RateLimit-Limit-second:
              description: The number of requests available per second.
              schema:
                type: integer
            X-RateLimit-Limit-minute:
              description: The number of requests available per minute.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BucketGetResponse'
        "400":
          $ref: '#/components/responses/Error400'
        "403":
          $ref: '#/components/responses/Error403'
        "404":
          $ref: '#/components/responses/Error404'
        "429":
          $ref: '#/components/responses/Error429'
        "500":
          $ref: '#/components/responses/Error500'
  /api/1.5/bucket-replica-links:
    get:
      tags:
      - Bucket Replica Links
      summary: Pure Storage Get Bucket Replica Links
      description: |
        Retrieves information about bucket replica links.
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Ids'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Member_ids_plus'
      - $ref: '#/components/parameters/Member_names_plus'
      - $ref: '#/components/parameters/Offset'
      - $ref: '#/components/parameters/Sort'
      - $ref: '#/components/parameters/Source_ids_plus'
      - $ref: '#/components/parameters/Source_names_plus'
      - $ref: '#/components/parameters/Target_ids_plus'
      - $ref: '#/components/parameters/Target_names_plus'
      responses:
        "200":
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
            X-RateLimit-Remaining-second:
              description: |
                The number of requests remaining for the organization in that second.
              schema:
                type: integer
            X-RateLimit-Remaining-minute:
              description: |
                The number of requests remaining for the organization in that minute.
              schema:
                type: integer
            X-RateLimit-Limit-second:
              description: The number of requests available per second.
              schema:
                type: integer
            X-RateLimit-Limit-minute:
              description: The number of requests available per minute.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BucketReplicaLinkGetResponse'
        "400":
          $ref: '#/components/responses/Error400'
        "403":
          $ref: '#/components/responses/Error403'
        "404":
          $ref: '#/components/responses/Error404'
        "429":
          $ref: '#/components/responses/Error429'
        "500":
          $ref: '#/components/responses/Error500'
  /api/1.5/controllers:
    get:
      tags:
      - Controllers
      summary: Pure Storage Get Controllers
      description: |
        Retrieves information about controllers.
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Ids'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Names'
      - $ref: '#/components/parameters/Offset'
      - $ref: '#/components/parameters/Sort'
      responses:
        "200":
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
            X-RateLimit-Remaining-second:
              description: |
                The number o

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