Pure Storage Certificates API

Purity//FA creates a self-signed certificate and private key when you start the system for the first time. You can use the default certificate, change the certificate attributes, create a new self-signed certificate, or import an SSL certificate signed by a certificate authority.

Operations 18

GET /api/2.52/certificates Pure Storage List Certificate Attributes
POST /api/2.52/certificates Pure Storage Create Certificate
DELETE /api/2.52/certificates Pure Storage Delete Certificate
PATCH /api/2.52/certificates Pure Storage Modify Certificates
GET /api/2.52/certificates/certificate-groups Pure Storage List Certificates and Certificate-groups
POST /api/2.52/certificates/certificate-groups Pure Storage Create Certificates Orcertificate-groups
DELETE /api/2.52/certificates/certificate-groups Pure Storage Deletes Certificates/certificate-groups
GET /api/2.52/certificates/uses Pure Storage List Certificates Uses
POST /api/2.52/certificates/certificate-signing-requests Pure Storage Create Certificate-signing-requests
GET /api/2.26/certificates Pure Storage GET Certificates
POST /api/2.26/certificates Pure Storage POST Certificates
DELETE /api/2.26/certificates Pure Storage DELETE Certificates
PATCH /api/2.26/certificates Pure Storage PATCH Certificates
GET /api/2.26/certificates/certificate-groups Pure Storage GET Certificates/certificate-groups
POST /api/2.26/certificates/certificate-groups Pure Storage POST Certificates/certificate-groups
DELETE /api/2.26/certificates/certificate-groups Pure Storage DELETE Certificates/certificate-groups
POST /api/2.26/certificates/certificate-signing-requests Pure Storage Create Certificate-signing-requests
GET /api/2.26/certificates/uses Pure Storage GET Certificates/uses

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-certificates-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-certificates-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: FlashArray REST Active Directory Certificates 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: Certificates
  description: 'Purity//FA creates a self-signed certificate and private key when you start the system for the

    first time. You can use the default certificate, change the certificate attributes, create a new

    self-signed certificate, or import an SSL certificate signed by a certificate authority.

    '
paths:
  /api/2.52/certificates:
    get:
      tags:
      - Certificates
      summary: Pure Storage List Certificate Attributes
      description: 'Displays certificate attributes.

        '
      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'
      - $ref: '#/components/parameters/Total_item_count'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CertificateGetResponse'
    post:
      tags:
      - Certificates
      summary: Pure Storage Create Certificate
      description: 'Creates a certificate object and specifies the valid time period and organization

        details of the certificate. A certificate can be imported or manually configured.

        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Names'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CertificatePost'
        required: true
        x-codegen-request-body-name: certificate
      responses:
        '200':
          description: Returns the newly created certificate object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CertificateResponse'
      x-codegen-request-body-name: certificate
    delete:
      tags:
      - Certificates
      summary: Pure Storage Delete Certificate
      description: 'Deletes a specific certificate object.

        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Ids'
      - $ref: '#/components/parameters/Names'
      responses:
        '200':
          description: OK
          content: {}
    patch:
      tags:
      - Certificates
      summary: Pure Storage Modify Certificates
      description: 'Modifies certificate attributes. Modifying self-signed certificate attributes

        replaces the existing certificate with a new one, generated by Purity//FA,

        using the specified attributes.

        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Generate_new_key'
      - $ref: '#/components/parameters/Ids'
      - $ref: '#/components/parameters/Names'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CertificatePost'
        required: true
        x-codegen-request-body-name: certificate
      responses:
        '200':
          description: Returns the newly updated certificate object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CertificateResponse'
      x-codegen-request-body-name: certificate
  /api/2.52/certificates/certificate-groups:
    get:
      tags:
      - Certificates
      summary: Pure Storage List Certificates and Certificate-groups
      description: 'Lists membership associations between groups and certificates.

        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Certificate_group_ids'
      - $ref: '#/components/parameters/Certificate_group_names'
      - $ref: '#/components/parameters/Certificate_ids'
      - $ref: '#/components/parameters/Certificate_names'
      - $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/CertificateCertificateGroupGetResponse'
    post:
      tags:
      - Certificates
      summary: Pure Storage Create Certificates Orcertificate-groups
      description: 'Creates one or more certificates to one or more certificate groups.

        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Certificate_group_ids'
      - $ref: '#/components/parameters/Certificate_group_names'
      - $ref: '#/components/parameters/Certificate_ids'
      - $ref: '#/components/parameters/Certificate_names'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CertificateCertificateGroupResponse'
    delete:
      tags:
      - Certificates
      summary: Pure Storage Deletes Certificates/certificate-groups
      description: 'Deletes one or more certificates from one or more certificate groups.

        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Certificate_group_ids'
      - $ref: '#/components/parameters/Certificate_group_names'
      - $ref: '#/components/parameters/Certificate_ids'
      - $ref: '#/components/parameters/Certificate_names'
      responses:
        '200':
          description: OK
          content: {}
  /api/2.52/certificates/uses:
    get:
      tags:
      - Certificates
      summary: Pure Storage List Certificates Uses
      description: 'Displays the usage and associations of certificates.

        '
      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'
      - $ref: '#/components/parameters/Total_item_count'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CertificateUseGetResponse'
  /api/2.52/certificates/certificate-signing-requests:
    post:
      tags:
      - Certificates
      summary: Pure Storage Create Certificate-signing-requests
      description: 'Creates a certificate signing request using a specified certificate and parameters.

        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CertificateSigningRequestPost'
        required: true
        x-codegen-request-body-name: certificate
      responses:
        '200':
          description: Returns the newly created certificate object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CertificateSigningRequestResponse'
      x-codegen-request-body-name: certificate
  /api/2.26/certificates:
    get:
      tags:
      - Certificates
      summary: Pure Storage GET Certificates
      description: List array certificates and their attributes.
      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/CertificateGetResponse'
    post:
      tags:
      - Certificates
      summary: Pure Storage POST Certificates
      description: 'Either upload a CA certificate to the array, upload a new appliance certificate with

        a private key, or generate a new self-signed certificate with a new private key and

        the specified attributes.

        '
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Names'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CertificatePost_2'
        required: true
        x-codegen-request-body-name: certificate
      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/CertificateResponse_2'
      x-codegen-request-body-name: certificate
    delete:
      tags:
      - Certificates
      summary: Pure Storage DELETE Certificates
      description: Delete a CA certificate from the array.
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $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:
      - Certificates
      summary: Pure Storage PATCH Certificates
      description: 'Modify SSL certificate attributes such as importing a new certificate

        and private key, or change intermediate certificate chains.

        Alternatively, generate a new self-signed certificate with specified properties

        to overwrite an existing certificate, and optionally generate a new private key.

        '
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Generate_new_key'
      - $ref: '#/components/parameters/Ids_2'
      - $ref: '#/components/parameters/Names'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CertificatePatch'
        required: true
        x-codegen-request-body-name: certificate
      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/CertificateResponse_2'
      x-codegen-request-body-name: certificate
  /api/2.26/certificates/certificate-groups:
    get:
      tags:
      - Certificates
      summary: Pure Storage GET Certificates/certificate-groups
      description: List membership associations between groups and certificates.
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Certificate_group_ids'
      - $ref: '#/components/parameters/Certificate_group_names'
      - $ref: '#/components/parameters/Certificate_ids'
      - $ref: '#/components/parameters/Certificate_names_2'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Limit'
      - $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/CertificateCertificateGroupGetResp'
    post:
      tags:
      - Certificates
      summary: Pure Storage POST Certificates/certificate-groups
      description: Add one or more certificates to one or more certificate groups.
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Certificate_group_ids'
      - $ref: '#/components/parameters/Certificate_group_names'
      - $ref: '#/components/parameters/Certificate_ids'
      - $ref: '#/components/parameters/Certificate_names_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/CertificateCertificateGroupResponse_2'
    delete:
      tags:
      - Certificates
      summary: Pure Storage DELETE Certificates/certificate-groups
      description: Remove one or more certificates from one or more certificate groups.
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Certificate_group_ids'
      - $ref: '#/components/parameters/Certificate_group_names'
      - $ref: '#/components/parameters/Certificate_ids'
      - $ref: '#/components/parameters/Certificate_names_2'
      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/certificates/certificate-signing-requests:
    post:
      tags:
      - Certificates
      summary: Pure Storage Create Certificate-signing-requests
      description: 'Creates a certificate signing request using a specified certificate and parameters.

        '
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CertificateSigningRequestPost_2'
        required: true
        x-codegen-request-body-name: certificate
      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/CertificateSigningRequestResponse_2'
      x-codegen-request-body-name: certificate
  /api/2.26/certificates/uses:
    get:
      tags:
      - Certificates
      summary: Pure Storage GET Certificates/uses
      description: List how certificates are being used and by what.
      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/CertificateUseGetResponse'
components:
  schemas:
    CertificateSigningRequest_2:
      description: 'SSL certificate managed by Purity.

        '
      type: object
      properties:
        certificate_signing_request:
          description: 'The text of a new certificate signing request.

            '
          type: string
    _fixedReference_2:
      allOf:
      - $ref: '#/components/schemas/_fixedReferenceWithoutType'
      - type: object
        properties:
          resource_type:
            description: 'Type of the object (full name of the endpoint).

              Valid values are the unique part of the resource''s REST endpoint.

              For example, a reference to a file system would have a

              `resource_type` of `file-systems`.

              '
            type: string
            readOnly: true
    CertificateUseGetResponse:
      allOf:
      - $ref: '#/components/schemas/PageInfo'
      - type: object
        properties:
          items:
            description: A list of certificate use objects.
            type: array
            items:
              $ref: '#/components/schemas/CertificateUse'
    CertificateResponse:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/Certificate'
    _referenceWithType:
      allOf:
      - $ref: '#/components/schemas/_reference'
      - type: object
        properties:
          resource_type:
            description: 'Type of the object (full name of the endpoint).

              Valid values are `hosts`, `host-groups`, `network-interfaces`, `pods`,

              `ports`, `pod-replica-links`, `subnets`, `volumes`, `volume-snapshots`,

              `volume-groups`, `directories`, `policies/nfs`, `policies/smb`, and

              `policies/snapshot`, etc.

              '
            type: string
      x-aliases:
      - _reference
    Member:
      type: object
      properties:
        group:
          description: 'A reference to a group object that has the referenced member object

            as a member.

            '
          title: Reference
          allOf:
          - $ref: '#/components/schemas/_reference_2'
        member:
          description: 'A reference to an object that is a member of the referenced group.

            '
          title: Reference
          allOf:
          - $ref: '#/components/schemas/_reference_2'
    _fixedReferenceWithoutType:
      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
    CertificateSigningRequestPost:
      description: SSL Certificate managed by Purity//FA.
      type: object
      properties:
        certificate:
          $ref: '#/components/schemas/_referenceNoId'
        common_name:
          description: The common name field listed in the certificate.
          type: string
          example: Pure Storage Inc.
        country:
          description: Two-letter country (ISO) code listed in the certificate.
          type: string
          example: CA
        email:
          description: The email field listed in the certificate.
          type: string
          example: tcrisp@veridiandynamics.com
        locality:
          description: The locality field listed in the certificate.
          type: string
          example: Toronto
        organization:
          description: The organization field listed in the certificate.
          type: string
          example: Veridian Dynamics
        organizational_unit:
          description: The organizational unit field listed in the certificate.
          type: string
          example: Research & Development
        state:
          description: The state/province field listed in the certificate.
          type: string
          example: Ontario
        subject_alternative_names:
          description: 'The alternative names that are secured by this certificate.

            Alternative names include IP addresses, DNS names, or URIs.

            '
          type: array
          items:
            type: string
            example: otherdnsname.mydomain.com
    _realmsReference:
      type: object
      properties:
        realms:
          description: 'Reference to the realms this resource belongs to.

            The value is set to empty array when the resource

            lives outside of a realm.

            '
          type: array
          readOnly: true
          items:
            $ref: '#/components/schemas/_fixedReference_2'
    _reference:
      type: object
      properties:
        id:
          description: 'A globally unique, system-generated ID.

            The ID cannot be modified.

            '
          type: string
        name:
          description: 'The resource name, such as volume name, pod name,

            snapshot name, and so on.

            '
          type: string
      x-aliases:
      - _referenceWithoutType
    CertificateSigningRequestPost_2:
      description: A request to create a CSR for a Purity//FB certificate object.
      type: object
      properties:
        certificate:
          description: 'The certificate object whose private key will be used for generating the CSR,

            and whose certificate will be overwritten if the CSR is signed and

            imported back into FlashBlade.

            '
          title: Reference
          allOf:
          - $ref: '#/components/schemas/_reference_2'
        common_name:
          description: The common name field to be listed in the certificate.
          type: string
          example: Pure Storage Inc.
        country:
          description: Two-letter country (ISO) code to be listed in the certificate.
          type: string
          example: CA
        email:
          description: The email field to be listed in the certificate.
          type: string
          example: tcrisp@veridiandynamics.com
        locality:
          description: The locality field to be listed in the certificate.
          type: string
          example: Toronto
        organization:
          description: The organization field to be listed in the certificate.
          type: string
          example: Veridian Dynamics
        organizational_unit:
          description: The organizational unit field to be listed in the certificate.
          type: string
          example: Research & Development
        state:
          description: The state/province field to be listed in the certificate.
          type: string
          example: Ontario
        subject_alternative_names:
          description: 'The alternative names that are secured by this certificate.

            Alternative names may be IP addresses, DNS names, or URIs.

            Specifying these will encode them in the certificate signing

            request; however, it is the decision of the signing authority

            as to whether or not they will be honored or ignored.

            '
          type: array
          items:
            type: string
            example: otherdnsname.mydomain.com
    _reference_2:
      type: object
      properties:
        id:
          description: 'A globally unique, system-generated ID.

            The ID cannot be modified.

            '
          type: string
        name:
          description: 'The resource name,

            such as volume name, pod name, snapshot name, and so on.

            '
          type: string
        resource_type:
          description: 'Type of the object (full name of the endpoint).

            Valid values are `hosts`, `host-groups`, `network-interfaces`, `pods`,

            `ports`, `pod-replica-links`, `subnets`, `volumes`, `volume-snapshots`,

            `volume-groups`, `directories`, `policies/nfs`, `policies/smb`, and

            `policies/snapshot`, etc.

            '
          type: string
          readOnly: true
      x-aliases:
      - _referenceWithFixedType
    CertificatePatch:
      allOf:
      - $ref: '#/components/schemas/_certificateBase_2'
      - type: object
        properties:
          days:
            description: 'The number of days that the self-signed certificate is valid. Defaults to 3650.

              This field can only be specified when creating a new self-signed certificate.

              '
            type: integer
            format: int32
            example: 3650
          passphrase:
            description: 'The passphrase used to encrypt `private_key`.

              This field can only be specified when importing a certificate and key pair.

              '
            type: string
          private_key:
            description: 'The text of the private key.

              This field can only be specified when importing a certificate and key pair.

              '
            type: string
    _certificateBase:
      description: SSL certificate managed by Purity.
      type: object
      properties:
        certificate:
          description: 'The text of the certificate.

            '
          type: string
        certificate_type:
          description: 'The type of certificate. Values include `appliance` and `external`.

            Certificates of type `appliance` are used by the array to verify

            its identity to clients. Certificates of type `external` are used

            by the array to identify external servers to which it is configured

            to communicate.

            '
          type: string
          readOnly: true
        common_name:
          description: 'The common name field listed in the certificate.

            '
          type: string
          example: Pure Storage Inc.
        country:
          description: 'Two-letter country (ISO) code listed in the certificate.

            '
          type: string
          example: CA
        email:
          description: 'The email field listed in the certificate.

            '
          type: string
          example: tcrisp@veridiandynamics.com
        intermediate_certificate:
          description: 'The text of the intermediate certificate chains.

            '
          type: string
        issued_by:
          description: 'The party that issued the certificate.

            '
          type: string
          readOnly: true
          example: Symantec, Inc.
        issued_to:
          description: 'The party to whom the certificate is issued.

            '
          type: string
          readOnly: true
          example: Pure Storage, Inc.
        key_algorithm:
          description: 'The key algorithm used to generate the certificate.

            This field can only be specified when creating a new self-signed certificate.

            Defaults to rsa if not specified. Valid values when creating a new self-signed

            certificate only include `rsa`, `ec`, `ed448` and `ed25519`.

            '
          type: string
          example: rsa
        key_size:
          description: 'The size (in bits) of the private key for the certificate. Default is 2048 bits

            for `rsa` key_algorithm, 256 for `ec` and `ed25519`. The `ed448` default key

            size is 456. This field can only be specified when creating a new self-signed

            certificate.

            '
          type: integer
          format: int32
          example: 2048
        locality:
          description: 'The locality field listed in the certificate.

            '
          type: string
          example: Toronto
        organization:
          description: 'The organization field listed in the certificate.

            '
          type: string
          example: Veridian Dynamics
        organizational_unit:
          description: 'The organizational unit field listed in the certificate.

            '
          type: string
          example: Research & Development
        state:
          description: 'The state/province field listed in the certificate.

            '
          type: string
          example: Ontario
        status:
          description: 'The type of certificate. Valid values are `self-signed` and `imported`.

            '
          type: string
          readOnly: true
        subject_alternative_names:
          description: 'The alternative names that are secured by this certificate.

            Alternative names may be IP addresses, DNS names, or URIs.

            '
          type: array
          items:
            type: string
            example: otherdnsname.mydomain.com
        valid_from:
          description: 'The date when the certificate starts being valid.

            '
          type: integer
          format: int64
          readOnly: true
          example: 1491070899
        valid_to:
          description: 'The date when the certificate stops being valid.

            '
          type: integer
          format: int64
          readOnly: true
          example: 1524248499
    _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
    CertificateSigningRequestResponse_2:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/CertificateSigningRequest_2'
          description: A list of certificate signing request objects.
    _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
    CertificateGetResponse:
      allOf:
      - $ref: '#/components/schemas/PageInfo'
      - $ref: '#/components/schemas/CertificateResponse'
    CertificateSigningRequestResponse:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/CertificateSigningRequest'
    CertificateSigningRequest:
      description: 'SSL certificate managed 

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