SimpliVity Cluster Groups API

A set of omnistack_clusters that are able to perform backup and restore operations between each other

Operations 2

GET /cluster_groups Retrieves all cluster_groups #
POST /cluster_groups/{clusterGroupId}/rename Renames the specified cluster_group #

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/simplivity-cluster-groups-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

simplivity-cluster-groups-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  description: This API enables the programmatic management of key components of an HPE SimpliVity configuration.
  version: '1.25'
  title: HPE OmniStack REST Cluster Groups API
  contact:
    name: Hewlett Packard Enterprise
  license:
    name: HPE OmniStack REST API
servers:
- url: https://localhost
tags:
- name: cluster groups
  description: A set of omnistack_clusters that are able to perform backup and restore operations between each other
paths:
  /cluster_groups:
    get:
      tags:
      - cluster groups
      summary: Retrieves all cluster_groups
      operationId: listClusterGroups
      parameters:
      - name: id
        in: query
        description: 'The unique identifier (UID) of the cluster_groups to return


          Accepts: Single value, comma-separated list'
        required: false
        schema:
          type: string
      - name: name
        in: query
        description: 'The name of the cluster_groups to return


          Accepts: Single value, comma-separated list, pattern using one or more asterisk characters as a wildcard'
        required: false
        schema:
          type: string
      - name: fields
        in: query
        description: "A comma-separated list of fields to include in the returned objects\n\n Default: Returns all fields"
        required: false
        schema:
          type: string
      - name: limit
        in: query
        description: 'A positive integer that represents the maximum number of results to return


          Default: 500'
        required: false
        schema:
          type: integer
          format: int32
          default: 500
      - name: offset
        in: query
        description: 'A positive integer that directs the service to start returning the <offset value> instance, up to the limit


          Default: 0'
        required: false
        schema:
          type: integer
          format: int32
          default: 0
      - name: case
        in: query
        description: 'An indicator that specifies if the filter and sort results use a case-sensitive or insensitive manner


          Valid values: sensitive or insensitive


          Default: sensitive'
        required: false
        schema:
          type: string
          enum:
          - sensitive
          - insensitive
          default: sensitive
      - name: sort
        in: query
        description: The name of the field where the sort occurs
        required: false
        schema:
          type: string
      - name: order
        in: query
        description: 'The sort order preference


          Valid values: ascending or descending


          Default: descending'
        required: false
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/vnd.simplivity.v1.19+json:
              schema:
                $ref: '#/components/schemas/clusterGroup'
            application/vnd.simplivity.v1.23+json:
              schema:
                $ref: '#/components/schemas/clusterGroup'
            application/json:
              schema:
                $ref: '#/components/schemas/clusterGroup'
            application/vnd.simplivity.v1.9+json:
              schema:
                $ref: '#/components/schemas/clusterGroup'
            application/vnd.simplivity.v1.18+json:
              schema:
                $ref: '#/components/schemas/clusterGroup'
            application/vnd.simplivity.v1.13+json:
              schema:
                $ref: '#/components/schemas/clusterGroup'
            application/vnd.simplivity.v1.16+json:
              schema:
                $ref: '#/components/schemas/clusterGroup'
            application/vnd.simplivity.v1.24+json:
              schema:
                $ref: '#/components/schemas/clusterGroup'
            application/vnd.simplivity.v1.7+json:
              schema:
                $ref: '#/components/schemas/clusterGroup'
            application/vnd.simplivity.v1.14+json:
              schema:
                $ref: '#/components/schemas/clusterGroup'
            application/vnd.simplivity.v1.11+json:
              schema:
                $ref: '#/components/schemas/clusterGroup'
            application/vnd.simplivity.v1.17+json:
              schema:
                $ref: '#/components/schemas/clusterGroup'
            application/vnd.simplivity.v1.21+json:
              schema:
                $ref: '#/components/schemas/clusterGroup'
            application/vnd.simplivity.v1.22+json:
              schema:
                $ref: '#/components/schemas/clusterGroup'
            application/vnd.simplivity.v1.10+json:
              schema:
                $ref: '#/components/schemas/clusterGroup'
            application/vnd.simplivity.v1.8+json:
              schema:
                $ref: '#/components/schemas/clusterGroup'
            application/vnd.simplivity.v1.15+json:
              schema:
                $ref: '#/components/schemas/clusterGroup'
            application/vnd.simplivity.v1.25+json:
              schema:
                $ref: '#/components/schemas/clusterGroup'
            application/vnd.simplivity.v1.12+json:
              schema:
                $ref: '#/components/schemas/clusterGroup'
            application/vnd.simplivity.v1.20+json:
              schema:
                $ref: '#/components/schemas/clusterGroup'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
  /cluster_groups/{clusterGroupId}/rename:
    post:
      tags:
      - cluster groups
      summary: Renames the specified cluster_group
      operationId: renameClusterGroup
      parameters:
      - name: clusterGroupId
        in: path
        description: The unique identifier (UID) of the cluster_group
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/vnd.simplivity.v1.19+json:
              schema:
                $ref: '#/components/schemas/TaskMO'
            application/vnd.simplivity.v1.23+json:
              schema:
                $ref: '#/components/schemas/TaskMO'
            application/json:
              schema:
                $ref: '#/components/schemas/TaskMO'
            application/vnd.simplivity.v1.9+json:
              schema:
                $ref: '#/components/schemas/TaskMO'
            application/vnd.simplivity.v1.18+json:
              schema:
                $ref: '#/components/schemas/TaskMO'
            application/vnd.simplivity.v1.13+json:
              schema:
                $ref: '#/components/schemas/TaskMO'
            application/vnd.simplivity.v1.16+json:
              schema:
                $ref: '#/components/schemas/TaskMO'
            application/vnd.simplivity.v1.24+json:
              schema:
                $ref: '#/components/schemas/TaskMO'
            application/vnd.simplivity.v1.7+json:
              schema:
                $ref: '#/components/schemas/TaskMO'
            application/vnd.simplivity.v1.14+json:
              schema:
                $ref: '#/components/schemas/TaskMO'
            application/vnd.simplivity.v1.11+json:
              schema:
                $ref: '#/components/schemas/TaskMO'
            application/vnd.simplivity.v1.17+json:
              schema:
                $ref: '#/components/schemas/TaskMO'
            application/vnd.simplivity.v1.21+json:
              schema:
                $ref: '#/components/schemas/TaskMO'
            application/vnd.simplivity.v1.22+json:
              schema:
                $ref: '#/components/schemas/TaskMO'
            application/vnd.simplivity.v1.10+json:
              schema:
                $ref: '#/components/schemas/TaskMO'
            application/vnd.simplivity.v1.8+json:
              schema:
                $ref: '#/components/schemas/TaskMO'
            application/vnd.simplivity.v1.15+json:
              schema:
                $ref: '#/components/schemas/TaskMO'
            application/vnd.simplivity.v1.25+json:
              schema:
                $ref: '#/components/schemas/TaskMO'
            application/vnd.simplivity.v1.12+json:
              schema:
                $ref: '#/components/schemas/TaskMO'
            application/vnd.simplivity.v1.20+json:
              schema:
                $ref: '#/components/schemas/TaskMO'
        '201':
          description: Created
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      requestBody:
        content:
          application/vnd.simplivity.v1.19+json:
            schema:
              $ref: '#/components/schemas/rename_cluster_group'
          application/vnd.simplivity.v1.23+json:
            schema:
              $ref: '#/components/schemas/rename_cluster_group'
          application/vnd.simplivity.v1.9+json:
            schema:
              $ref: '#/components/schemas/rename_cluster_group'
          application/vnd.simplivity.v1.18+json:
            schema:
              $ref: '#/components/schemas/rename_cluster_group'
          application/vnd.simplivity.v1.13+json:
            schema:
              $ref: '#/components/schemas/rename_cluster_group'
          application/vnd.simplivity.v1.16+json:
            schema:
              $ref: '#/components/schemas/rename_cluster_group'
          application/vnd.simplivity.v1.24+json:
            schema:
              $ref: '#/components/schemas/rename_cluster_group'
          application/vnd.simplivity.v1.7+json:
            schema:
              $ref: '#/components/schemas/rename_cluster_group'
          application/vnd.simplivity.v1.14+json:
            schema:
              $ref: '#/components/schemas/rename_cluster_group'
          application/vnd.simplivity.v1.11+json:
            schema:
              $ref: '#/components/schemas/rename_cluster_group'
          application/vnd.simplivity.v1.17+json:
            schema:
              $ref: '#/components/schemas/rename_cluster_group'
          application/vnd.simplivity.v1.21+json:
            schema:
              $ref: '#/components/schemas/rename_cluster_group'
          application/vnd.simplivity.v1.22+json:
            schema:
              $ref: '#/components/schemas/rename_cluster_group'
          application/vnd.simplivity.v1.10+json:
            schema:
              $ref: '#/components/schemas/rename_cluster_group'
          application/vnd.simplivity.v1.8+json:
            schema:
              $ref: '#/components/schemas/rename_cluster_group'
          application/vnd.simplivity.v1.15+json:
            schema:
              $ref: '#/components/schemas/rename_cluster_group'
          application/vnd.simplivity.v1.25+json:
            schema:
              $ref: '#/components/schemas/rename_cluster_group'
          application/vnd.simplivity.v1.12+json:
            schema:
              $ref: '#/components/schemas/rename_cluster_group'
          application/vnd.simplivity.v1.20+json:
            schema:
              $ref: '#/components/schemas/rename_cluster_group'
        description: 'cluster_group_name: The new name for the cluster_group'
        required: true
components:
  schemas:
    rename_cluster_group:
      type: object
      required:
      - cluster_group_name
      properties:
        id:
          type: string
        revision:
          type: integer
          format: int32
        cluster_group_name:
          type: string
          description: The new name for the cluster_group
      description: Renames the specified cluster_group
    TaskMO:
      type: object
      required:
      - affected_objects
      - end_time
      - id
      - start_time
      - state
      properties:
        affected_objects:
          type: array
          description: For a completed task, the unique identifiers (UIDs) and types of the objects affected by the operation
          items:
            $ref: '#/components/schemas/AffectedObjectMO'
        end_time:
          type: string
          description: The time the task finished, expressed in ISO-8601 form, based on Coordinated Universal Time (UTC)
        error_code:
          type: integer
          format: int32
          description: The error code returned if a task failed
        error_message:
          type: string
          description: The error message returned if a task fails
        id:
          type: string
          description: The unique identifier (UID) of the task
        start_time:
          type: string
          description: The time the task started, expressed in ISO-8601 form, based on Coordinated Universal Time (UTC)
        state:
          type: string
          description: The current state of the task object
          enum:
          - IN_PROGRESS
          - COMPLETED
          - FAILED
      description: A task that was created as a result of an operation performed on the system
    clusterGroup:
      type: object
      required:
      - clusters
      - id
      - name
      properties:
        clusters:
          type: array
          description: The unique identifiers (UIDs) of the omnistack_clusters that are defined in the cluster_group
          items:
            type: string
        id:
          type: string
          description: The unique identifier (UID) of the cluster_group
        name:
          type: string
          description: The name of the cluster_group
      description: A cluster_group
    AffectedObjectMO:
      type: object
      required:
      - object_id
      - object_type
      properties:
        object_id:
          type: string
          description: The unique identifier (UID) of the object affected by the completed task
        object_type:
          type: string
          description: The type of the object affected by the completed task (virtual_machine, datastore, omnistack_cluster, backup, host, policy, rule)
  securitySchemes:
    OAuth2:
      type: oauth2
      flows:
        password:
          scopes:
            read: Grants read access
            write: Grants write access
          tokenUrl: /oauth/token