Pure Storage Alerts API

Alerts indicate significant events that occur on an array, including whenever a component degrades or the capacity threshold of the component is reached.

Operations 11

GET /api/2.52/alerts Pure Storage List Alerts
PATCH /api/2.52/alerts Pure Storage Modify Flagged State
GET /api/2.52/alerts/events Pure Storage List Alert Events
GET /api/2.52/alerts/rules Pure Storage List Custom Alert Rules
POST /api/2.52/alerts/rules Pure Storage Create a Custom Alert Rule
DELETE /api/2.52/alerts/rules Pure Storage Delete a Custom Alert Rule
PATCH /api/2.52/alerts/rules Pure Storage Modify a Custom Alert Rule
GET /api/2.52/alerts/rules/catalog Pure Storage List Available Customizable Alert Codes
GET /api/2.26/alerts Pure Storage GET Alerts
PATCH /api/2.26/alerts Pure Storage PATCH Alerts
GET /api/1.5/alerts Pure Storage Get Alerts

Documentation

Specifications

Code Examples

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-alerts-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.

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

OpenAPI Specification

pure-storage-alerts-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: FlashArray REST Active Directory Alerts 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: Alerts
  description: 'Alerts indicate significant events that occur on an array, including whenever a component

    degrades or the capacity threshold of the component is reached.

    '
paths:
  /api/2.52/alerts:
    get:
      tags:
      - Alerts
      summary: Pure Storage List Alerts
      description: Displays a list of alerts.
      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/Filter'
      - $ref: '#/components/parameters/Flagged'
      - $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/AlertGetResponse'
        '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/AlertGetResponse'
    patch:
      tags:
      - Alerts
      summary: Pure Storage Modify Flagged State
      description: Modifies one or more alerts and display updated information about these alerts.
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Ids'
      - $ref: '#/components/parameters/Names'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Alert'
        required: true
        x-codegen-request-body-name: alert
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AlertResponse'
      x-codegen-request-body-name: alert
  /api/2.52/alerts/events:
    get:
      tags:
      - Alerts
      summary: Pure Storage List Alert Events
      description: Displays a list of alert events.
      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/Filter'
      - $ref: '#/components/parameters/Flagged'
      - $ref: '#/components/parameters/IdsSemiRequired'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/NamesSemiRequired'
      - $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/AlertEventGetResponse'
        '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/AlertEventGetResponse'
  /api/2.52/alerts/rules:
    get:
      tags:
      - Alerts
      summary: Pure Storage List Custom Alert Rules
      description: 'Displays a list of custom alert rules.

        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Allow_errors'
      - $ref: '#/components/parameters/Alert_rules_code_list'
      - $ref: '#/components/parameters/Context_names_get'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Limit'
      - $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/AlertRulesGetResponse'
        '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/AlertRulesGetResponse'
    post:
      tags:
      - Alerts
      summary: Pure Storage Create a Custom Alert Rule
      description: 'Creates an alert rule with a custom value.

        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Alert_rules_code'
      - $ref: '#/components/parameters/Alert_rules_parameter'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AlertRules'
        required: true
        x-codegen-request-body-name: alert-rule
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AlertRulesResponse'
      x-codegen-request-body-name: alert-rule
    delete:
      tags:
      - Alerts
      summary: Pure Storage Delete a Custom Alert Rule
      description: 'Deletes a custom alert rule.

        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Alert_rules_code'
      - $ref: '#/components/parameters/Alert_rules_parameter'
      responses:
        '200':
          description: OK
          content: {}
    patch:
      tags:
      - Alerts
      summary: Pure Storage Modify a Custom Alert Rule
      description: 'Modifies a custom alert rule to a new value.

        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Alert_rules_code'
      - $ref: '#/components/parameters/Alert_rules_parameter'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AlertRules'
        required: true
        x-codegen-request-body-name: alert-rule
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AlertRulesResponse'
      x-codegen-request-body-name: alert-rule
  /api/2.52/alerts/rules/catalog:
    get:
      tags:
      - Alerts
      summary: Pure Storage List Available Customizable Alert Codes
      description: 'Displays a list of available customizable alert codes.

        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Allow_errors'
      - $ref: '#/components/parameters/Alert_rules_code_list'
      - $ref: '#/components/parameters/Context_names_get'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Limit'
      - $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/AlertRulesCatalogGetResponse'
        '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/AlertRulesCatalogGetResponse'
  /api/2.26/alerts:
    get:
      tags:
      - Alerts
      summary: Pure Storage GET Alerts
      description: 'Returns a list of alerts which have been generated by the array.


        '
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Continuation_token'
      - $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'
      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/AlertGetResponse_2'
    patch:
      tags:
      - Alerts
      summary: Pure Storage PATCH Alerts
      description: 'Make changes to an alert. This is currently limited to the alert''s `flagged` property.


        '
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Ids_2'
      - $ref: '#/components/parameters/Names'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Alert_2'
        required: true
        x-codegen-request-body-name: alerts-settings
      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/AlertResponse_2'
      x-codegen-request-body-name: alerts-settings
  /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_2'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Continuation_token_2'
      - $ref: '#/components/parameters/Filter_2'
      - $ref: '#/components/parameters/Ids_3'
      - $ref: '#/components/parameters/Limit_2'
      - $ref: '#/components/parameters/Names_2'
      - $ref: '#/components/parameters/Offset_3'
      - $ref: '#/components/parameters/Sort_3'
      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'
components:
  schemas:
    _fixedReference_2:
      type: object
      properties:
        id:
          description: The opaque and unique id of this resource.
          type: string
          readOnly: true
          example: 2a989a09-c851-4d52-9ec6-ab728b1c04db
        name:
          description: The name of this resource.
          type: string
          readOnly: true
          example: example_name
        resource_type:
          description: 'The type of this resource represented by the name of its REST endpoint.

            For example, "arrays", "network-interfaces", and "metrics".

            The value may be `null` if the resource is not represented.

            '
          type: string
          readOnly: true
          example: example_resource_type
      x-readOnly: true
    AlertResponse_2:
      type: object
      properties:
        items:
          description: A list of alert objects.
          type: array
          items:
            $ref: '#/components/schemas/Alert_2'
    _arrays:
      type: object
      properties:
        arrays:
          description: 'The list of arrays where this resource exists. Many resources are on a single array, but

            some resources, such as pods, can be shared across multiple arrays.

            '
          type: array
          readOnly: true
          items:
            $ref: '#/components/schemas/_fixedReferenceFqdn'
      x-readOnly: true
    _errorErrors:
      type: object
      properties:
        context:
          type: string
          example: Error with ...
        message:
          type: string
          example: Something was wrong
    AlertRulesResponse:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/AlertRules'
    AlertRulesCatalogResponse:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/AlertRulesCatalog'
    Alert_3:
      allOf:
      - $ref: '#/components/schemas/_arraysResource'
      - description: 'An alert from an array.

          '
        type: object
        properties:
          actual:
            description: Actual condition at the time of the alert.
            type: string
            example: empty
          category:
            description: 'Category of the alert. Valid values are `array`, `hardware`, and

              `software`.

              '
            type: string
            example: array
          closed:
            description: 'Time when the alert was closed, in milliseconds since UNIX epoch.

              '
            type: integer
            format: int64
            example: 1502729489760
          code:
            description: Code associated with the alert.
            type: integer
            example: 100
          component_name:
            description: Name of the component alerted about.
            type: string
            example: drive1
          component_type:
            description: Type of the component alerted about.
            type: string
            example: drive
          created:
            description: 'Time when the alert was created, in milliseconds since UNIX epoch.

              '
            type: integer
            format: int64
            example: 1502729489760
          description:
            description: Short description of the alert.
            type: string
            example: Some sort of failure.
          expected:
            description: Expected state/threshold under normal conditions.
            type: string
            example: healthy
          knowledge_base_url:
            description: URL of the relevant Knowledge Base page.
            type: string
            example: https://support.purestorage.com/
          notified:
            description: 'Time when the user was notified of the alert, in milliseconds since

              UNIX epoch.

              '
            type: integer
            format: int64
            example: 1502729489760
          origin:
            description: Origin of the alert. Valid values are `array` and `Pure1`.
            type: string
            example: array
          severity:
            description: 'Current severity level. Valid values are `info`, `warning`, `critical`,

              and `hidden`.

              '
            type: string
            example: critical
          state:
            description: 'Current state of the alert. Valid values are `open`, `closing`,

              and `closed`.

              '
            type: string
            example: open
          summary:
            description: Summary of the alert.
            type: string
            example: Test alert.
          updated:
            description: 'Time when the alert was last updated, in milliseconds since UNIX epoch.

              '
            type: integer
            format: int64
            example: 1502729489760
    AlertsGetResponse:
      allOf:
      - $ref: '#/components/schemas/PageInfo_3'
      - $ref: '#/components/schemas/AlertsResponse'
    AlertGetResponse_2:
      allOf:
      - $ref: '#/components/schemas/PageInfo_2'
      - $ref: '#/components/schemas/AlertResponse_2'
    _fixedReferenceFqdn:
      allOf:
      - $ref: '#/components/schemas/_fixedReference_2'
      - type: object
        properties:
          fqdn:
            description: 'The fully qualified domain name of the appliance when `resource_type` is `arrays`,

              `null` otherwise.

              '
            type: string
            readOnly: true
            example: example_name.dc1.example.com
    AlertRules:
      allOf:
      - $ref: '#/components/schemas/_context'
      - description: 'Custom rules for alerts.

          '
        type: object
        properties:
          code:
            description: 'The alert code that the rule applies to. Available alert codes

              for customization can be found in the alert rules catalog.

              '
            type: integer
            format: int32
            readOnly: true
            example: 25
          parameter:
            description: 'The parameter of the custom alert rule to modify. Values include `info` and `warning`.

              Available parameter values can be found in the alert rules catalog.

              '
            type: string
            readOnly: true
            example: info
          value:
            description: 'The value to use for the custom alert rule. Valid values for

              an alert code and parameter combination can be found in the alert rules catalog.

              '
            type: string
            example: '85'
    _builtIn:
      description: 'A built-in resource. Many are singletons predefined by Purity (e.g., support

        settings). Some correspond to a piece of software, like an app, or hardware,

        like a controller. Others are created by the system in response to some event

        (e.g., alerts, audit records).


        Typically, a user can''t create, delete or rename a built-in resource. A few

        can be created or deleted, but not renamed because the names are meaningful

        to Purity (e.g., VIFs).

        '
      type: object
      properties:
        id:
          description: 'A globally unique, system-generated ID.

            The ID cannot be modified and cannot refer to another resource.

            '
          type: string
          readOnly: true
        name:
          description: 'A locally unique, system-generated name. The name cannot be modified.

            '
          type: string
          readOnly: true
    _context:
      type: object
      properties:
        context:
          description: 'The context in which the operation was performed.


            Valid values include a reference to any array which is a member of the same fleet

            or to the fleet itself.


            Other parameters provided with the request, such as names of volumes or snapshots,

            are resolved relative to the provided `context`.

            '
          readOnly: true
          title: FixedReferenceWithType
          allOf:
          - $ref: '#/components/schemas/_fixedReferenceWithType'
    AlertEventResponse:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/AlertEvent'
    AlertEvent:
      allOf:
      - $ref: '#/components/schemas/_builtInResourceNoId'
      - $ref: '#/components/schemas/_context'
      - description: Alert timeline event.
        type: object
        properties:
          actual:
            description: Actual condition at the time the alert is created.
            type: string
            readOnly: true
            example: 95%
          alert:
            $ref: '#/components/schemas/_fixedReference'
          code:
            description: The parent alert number.
            type: integer
            format: int64
            readOnly: true
            example: 7
          component_name:
            description: The component type of the alert.
            type: string
            readOnly: true
            example: vm-tom
          component_type:
            description: The component name of the alert.
            type: string
            readOnly: true
            example: storage
          created:
            description: The time the parent alert was created.
            type: integer
            format: int64
            example: 1576275532434
          expected:
            description: Expected state and threshold under normal conditions.
            type: string
            readOnly: true
            example: 90%
          issue:
            description: Information about the alert cause.
            type: string
            readOnly: true
            example: boot drive overutilization
          knowledge_base_url:
            description: The knowledge base URL of the alert.
            type: string
            readOnly: true
            example: https://support.purestorage.com/?cid=Alert_0007
          severity:
            description: 'The severity level of the alert.

              Valid values include `info`, `warning`, `critical`, and `hidden`.

              '
            type: string
            readOnly: true
            example: critical
          state:
            description: 'The state of the alert.

              Valid values include `open`, `closing`, and `closed`.

              '
            type: string
            readOnly: true
            example: open
          summary:
            description: A summary of the alert.
            type: string
            readOnly: true
            example: boot drive overutilization
          time:
            description: The time the event occurred.
            type: integer
            format: int64
            readOnly: true
            example: 1578440491109
    Error:
      type: object
      properties:
        errors:
          description: The list of errors encountered.
          type: array
          items:
            $ref: '#/components/schemas/_errorErrors'
    _fixedReference:
      type: object
      properties:
        id:
          description: 'A globally unique, system-generated ID.

            The ID cannot be modified.

            '
          type: string
          readOnly: true
        name:
          description: 'The resource name, such as volume name, file system name,

            snapshot name, and so on.

            '
          type: string
          readOnly: true
      x-readOnly: true
      x-aliases:
      - _fixedReferenceWithoutType
    AlertResponse:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/Alert'
    AlertEventGetResponse:
      allOf:
      - $ref: '#/components/schemas/PageInfo'
      - $ref: '#/components/schemas/AlertEventResponse'
      - $ref: '#/components/schemas/_errorContextResponse'
    ErrorNoContext:
      type: object
      properties:
        message:
          type: string
          example: Something was wrong
    _errorcontextresponseErrors:
      type: object
      properties:
        context:
          description: 'Contains information relating to the cause of this error,

            or the name of the object that was being processed when the error was encountered.

            This may be `null` for more general errors.

            '
          type: string
        location_context:
          description: 'Contains information relating to the context in which the request was executing

            when the error occurred.

            For example, this may be the name of an array in the same fleet.

            This may be `null` for more general errors, or if no explicit `context` parameter

            was provided with the request.

            '
          title: FixedReferenceWithType
          allOf:
          - $ref: '#/components/schemas/_fixedReferenceWithType'
        message:
          description: A description of the error which occurred.
          type: string
          example: Resource does not exist.
      x-aliases:
      - _errorContextResponseErrors
    AlertsResponse:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/Alert_3'
    AlertRulesCatalogGetResponse:
      allOf:
      - $ref: '#/components/schemas/PageInfo'
      - $ref: '#/components/schemas/AlertRulesCatalogResponse'
      - $ref: '#/components/schemas/_errorContextResponse'
    _arraysResource:
      description: 'A built-in resource that exists on one or multiple arrays.

        '
      allOf:
      - $ref: '#/components/schemas/_resource'
      - $ref: '#/components/schemas/_arrays'
    AlertRulesGetResponse:
      allOf:
      - $ref: '#/components/schemas/PageInfo'
      - $ref: '#/components/schemas/AlertRulesResponse'
      - $ref: '#/components/schemas/_errorContextResponse'
    PageInfo_2:
      type: object
      properties:
        continuation_token:
          description: 'Continuation token that can be provided in the `continuation_token` query

            param to get the next page of data.

            If you use the `continuation_token` to page through data you

            are guaranteed to get all items exactly once regardless of

            how items are modified. If an item is added or deleted during

            the pagination then it may or may not be returned.

            The `continuation_token` is generated if the `limit` is less

            than the remaining number of items, and the default sort is used

            (no sort is specified).

            '
          type: string
        total_item_count:
          description: Total number of items after applying `filter` params.
          type: integer
          format: int32
    Alert_2:
      allOf:
      - $ref: '#/components/schemas/_builtIn_2'
      - type: object
        properties:
          action:
            description: The action of the alert.
            type: string
            readOnly: true
          code:
            description: Alert code.
            type: integer
            format: int64
            readOnly: true
          component_name:
            description: The component name of the alert.
            type: string
            readOnly: true
          component_type:
            description: The component type of the alert.
            type: string
            readOnly: true
          created:
            description: The creation timestamp of the alert.
            type: integer
            format: int64
            readOnly: true
          description:
            description: The description of the alert.
            type: string
            readOnly: true
          duration:
            description: The duration of the alert.
            type: integer
            format: int64
            readOnly: true
          flagged:
            description: Flagged state of the alert.
            type: boolean
          index:
            description: The unique index of the alert.
            type: integer
            format: int64
            readOnly: true
          knowledge_base_url:
            description: URL of the relevant Knowledge Base page.
            type: string
            readOnly: true
          notified:
            description: The last notification timestamp of the alert.
            type: integer
            format: int64
            readOnly: true
          severity:
            description: 'Severity of the alert.

              Valid values are `info`, `warning`, and `critical`.

              '
            type: string
            readOnly: true
          state:
            description: 'The current state of the alert.

              Valid values are `open`, `closing`, `closed`, and

              `waiting to downgrade`.

              '
            type: string
            readOnly: true
          summary:
            description: The summary of the alert.
            type: string
            readOnly: true
          updated:
            description: The last updated timestamp of the alert.
            type: integer
            format: int64
            readOnly: true
          variables:
            description: Key-value pairs of additional information of the alert.
            type: object
            readOnly: true
            additionalProperties:
              type: string
    AlertRulesCatalog:
      allOf:
      - $ref: '#/components/schemas/_context'
      - description: 'Available alerts for customization

          '
        type: object
        properties:
          allowed_values:
            description: 'The range of values allowed to set the custom alert rule to.

              '
            type: string
            example: Range 0-100 (must be equal to or lower than Warning Threshold)
          code:
            description: 'The alert code that the rule applies to.

              '
            type: integer
            format: int32
            example: 25
          default_value:
            description: 'The system default values for the alert code and parameter.

              '
            type: string
            example: 80%
          parameter:
            description: 'The parameter of the custom alert rule.

              '
            type: string
            example: info
          subject:
            description: 'The alert code description.

              '
            type: string
            example: Storage consumption has reached {percent_usage}% of usable capacity
    _errorContextResponse:
      type: object
      properties:
        errors:
          description: The list of errors encountered when attempting to perform an operation.
          type: array
          readOnly: true
          items:
            $ref: '#/components/schemas/_errorcontextresponseErrors'
    _builtInResourceNoId:
      description: 'A built-in resource. Many are singletons predefined by Purity (e.g., support

        settings). Some correspond to a piece of software, like an app, or hardware,

        like a controller. Others are created by the system in response to some event

        (e.g., alerts, audit records).


        Typically, a user can''t create, delete or rename a built-in resource. A few

        can be created or deleted, but not renamed because the names are meaningful

        to Purity (e.g., VIFs, file systems, file system

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