HPE Greenlake For Storage Fleet REST APIs (1.0.0)

HPE Greenlake For Storage Fleet REST APIs

Download OpenAPI description

storage-fleet-api.json

storage-fleet-api.yaml

Overview

License

HPE End User License Agreement

Servers

https://eu1.data.cloud.hpe.com/

https://us1.data.cloud.hpe.com/

https://jp1.data.cloud.hpe.com/

Mock server

https://developer.greenlake.hpe.com/_mock/docs/greenlake/services/storage-fleet/public/openapi/storage-fleet-latest/v1/storage-fleet-api/

certificates

The Certificate API provides endpoints for managing and configuring certificates.

Operations

controllers

The controllers API allows the management of controller fleet.

Operations

enclosures

The Enclosure API provides endpoints for managing and configuring enclosures.

Operations

encryption

The encryption API allows the actions on encryption.

Operations

jbofioms

The JBOF IOM API provides endpoints for managing and configuring JBOF IOMs.

Operations

Get all JBOF IOMs of a HPE Alletra Storage MP X10000 system

Request

Get all JBOF IOMs of a HPE Alletra Storage MP X10000 system

Security

bearer

Path

systemIdstringrequired

ID of the storage system

Example: 2a0df0fe6f7dc7bb16000000000000000000004817

Query

limitinteger[ 0 .. 5000 ]

Number of items to return at a time

Default 100

Example: limit=10

offsetinteger[ 0 .. 100000 ]

The offset of the first item in the collection to return

Default 0

Example: offset=5

selectstring

Query to select only the required parameters, separated by . if nested

Example: select=id

filterstring

Lucene query to filter JBOF IOMs by Key.

Example: filter=id eq 2a0df0fe6f7dc7bb16000000000000000000004007

sortstring

Data query to sort JBOF IOM resource by Key.

Example: sort=id desc

curl -i -X GET \
  https://eu1.data.cloud.hpe.com/storage-fleet/v1/devtype7-storage-systems/2a0df0fe6f7dc7bb16000000000000000000004817/jbofioms \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Success

Bodyapplication/json

itemsArray of objectsrequired

items[].idstringrequired

Identifier of the Storage system JBOF IOM. Filter, Sort

Example: "default.jbofiom-0"

items[].typestringrequired

Type of the resource.

Example: "jbofiom"

items[].apiVersionstring or null

API version of the resource.

Example: "sc.hpe.com/v1"

items[].associatedLinksArray of objects or null or null(homefleetAssociatedLinks)

items[].clusterIdstring or null

The unique identifier of the resource to which the JBOF IOM belongs.

Example: "123abcd4-5e67-890f-g123-4hi5j67kl8m9"

items[].clusterRefstring or null

The URI of the resource to which the JBOF IOM belongs.

Example: "/api/sc.hpe.com/v1/default/jbofioms/jbofiom-0"

items[].commonResourceAttributesobject or null(commonResourceAttrs)

items[].customerIdstring or null

Customer ID for the Storage system JBOF IOM. Filter, Sort

Example: "ab1c23456d78901e23fghijk456lm7no"

items[].enclosureIdstring or null

Unique ID of the enclosure that contains this JBOF IOM.

Example: "123abcd4-5e67-890f-g123-4hi5j67kl8m9"

items[].enclosureRefstring or null

The URI of the enclosure to which the JBOF IOM belongs.

Example: "/api/sc.hpe.com/v1/default/jbofiom-1/Enclosure"

items[].enclosureSerialNumberstring or null

Serial number of the enclosure that contains this JBOF IOM. Filter

Example: "1AB234C5D6"

items[].generationinteger or null(int64)

Generation. Filter, Sort

Example: 1692945579

items[].ipAddressesArray of strings or null

List of IP Addresses.

items[].kindstring or null

Kind of the resource.

Example: "Jbofiom"

items[].locationstring or null

location of the resource in enclosure.

Example: "0"

items[].partNumberstring or null

The part number of the JBOF IOM. Filter

Example: ""

items[].resourceUristring or null(homefleetResourceUri)

items[].serialNumberstring or null

The serial number of the JBOF IOM. Filter, Sort

Example: "AB1234C5D6"

items[].statusobject or null(HomefleetJbofIomStatus)

items[].systemIdstring or null

Identifier of the Storage system to which the JBOF IOM belongs. Filter, Sort

Example: "1AB234CDEF"

countintegerrequired

Number of items in this response.

offsetintegerrequired

The offset query parameter from the request.

totalinteger

Total number of items matching the filter parameter in the request.

Response

application/json

{
  "items": [
    { … }
  ],
  "count": 0,
  "offset": 0,
  "total": 0
}

Get JBOF IOM of a HPE Alletra Storage MP X10000 system identified by jbofIomID

Request

Get JBOF IOM of a HPE Alletra Storage MP X10000 system identified by jbofIomID

Security

bearer

Path

systemIdstringrequired

ID of the storage system

Example: 2a0df0fe6f7dc7bb16000000000000000000004817

jbofiomIdstringrequired

Identifier of JBOF IOM. A 42 digit hexadecimal number.

Example: 2a0df0fe6f7dc7bb16000000000000000000004007

Query

selectstring

Query to select only the required parameters, separated by . if nested

Example: select=id

curl -i -X GET \
  https://eu1.data.cloud.hpe.com/storage-fleet/v1/devtype7-storage-systems/2a0df0fe6f7dc7bb16000000000000000000004817/jbofioms/2a0df0fe6f7dc7bb16000000000000000000004007 \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Success

Bodyapplication/json

object or null(HomefleetJbofIomDetail)

Response

application/json

{
  "customerId": "ab1c23456d78901e23fghijk456lm7no",
  "enclosureSerialNumber": "1AB234C5D6",
  "generation": 1692945579,
  "id": "default.jbofiom-0",
  "partNumber": "",
  "serialNumber": "AB1234C5D6",
  "systemId": "1AB234CDEF",
  "apiVersion": "sc.hpe.com/v1",
  "associatedLinks": [
    { … }
  ],
  "clusterId": "123abcd4-5e67-890f-g123-4hi5j67kl8m9",
  "clusterRef": "/api/sc.hpe.com/v1/default/jbofioms/jbofiom-0",
  "commonResourceAttributes": {
    "cloudState": "CONNECTED",
    "errCode": "E01",
    "errMessage": "This storage system is not actively monitored in the cloud portal. Data Services Cloud Console proactively disabled monitoring and management of storage system with serial number {systemId} for sending excessive cloud events or for not responding to requests."
  },
  "enclosureId": "123abcd4-5e67-890f-g123-4hi5j67kl8m9",
  "enclosureRef": "/api/sc.hpe.com/v1/default/jbofiom-1/Enclosure",
  "ipAddresses": [
    "string"
  ],
  "kind": "Jbofiom",
  "location": "0",
  "resourceUri": "/storage-fleet/v1/devtype7-storage-systems/4UN042PTDW",
  "status": {
    "conditions": [ … ],
    "faultLedState": "Off",
    "healthLedState": "Off",
    "lastModifiedTime": "2023-08-24T07:14:33Z",
    "locatorLedState": "Off",
    "nics": [ … ],
    "observedGeneration": 3,
    "operationalState": "Offline",
    "pingsOutstanding": 3,
    "powerState": "Off",
    "ready": true,
    "sevenSegmentDisplay": 0
  },
  "type": "jbofiom"
}

Edit settings of a HPE Alletra Storage MP X10000 system JBOF IOM identified by jbofIomID

Request

Edit settings of a HPE Alletra Storage MP X10000 system JBOF IOM identified by jbofIomID

Security

bearer

Path

systemIdstringrequired

ID of the storage system

Example: 2a0df0fe6f7dc7bb16000000000000000000004817

jbofiomIdstringrequired

Identifier of JBOF IOM. A 42 digit hexadecimal number.

Example: 2a0df0fe6f7dc7bb16000000000000000000004007

Bodyapplication/jsonrequired

locatorLedStatestring

To display target Locator LED state of the JBOF IOM. Possible values are "On" or "Off".

Example: "On"

powerStatestring

To power on or off the IOM. Possible values are "On" or "Off".

Example: "On"

sevenSegmentDisplayinteger or null(Uint32)

The value to display on the three digit seven segment display. Valid range of values is 0 - 999.

Example: 900

curl -i -X PUT \
  https://eu1.data.cloud.hpe.com/storage-fleet/v1/devtype7-storage-systems/2a0df0fe6f7dc7bb16000000000000000000004817/jbofioms/2a0df0fe6f7dc7bb16000000000000000000004007 \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{}'

Responses

Accepted

Headers

Locationstring

This contains the URI of the task used to monitor the request

Bodyapplication/json

taskUristringrequired

Task URI which can be used to monitor the status of the operation.

Example: "/rest/vega/v1/tasks/4969a568-6fed-4915-bcd5-e4566a75e00c"

messagestring

Task Message.

Example: "Successfully submitted"

statusstring

Status of the task.

Example: "SUBMITTED"

Response

application/json

{
  "message": "Successfully submitted",
  "status": "SUBMITTED",
  "taskUri": "/rest/vega/v1/tasks/4969a568-6fed-4915-bcd5-e4566a75e00c"
}

migrations

The Migrations API allows the management of data migration from source storage systems.

object-notification-clients

The Object Notification Client API provides endpoints for managing and configuring object notification clients.

Operations

ports

The ports API allows the management of ports.

Operations

shelves

The shelves API allows the management of shelves.

Operations

storage-nodes

The Storage Node API provides endpoints for managing and configuring storage nodes.

Operations

storage-systems

The storage-systems API allows the management of storage device.

Operations

switches

The Switch API provides endpoints for managing and configuring switches.

Operations

system-settings

The System Settings API allows the monitoring of System settings for the device.

Operations

vvolscs

Operations

HPE Greenlake For Storage Fleet REST APIs (1.0.0)

certificates

controllers

enclosures

encryption

jbofioms

Get all JBOF IOMs of a HPE Alletra Storage MP X10000 system

Request

Responses

Was this helpful?

Get JBOF IOM of a HPE Alletra Storage MP X10000 system identified by jbofIomID

Request

Responses

Was this helpful?

Edit settings of a HPE Alletra Storage MP X10000 system JBOF IOM identified by jbofIomID

Request

Responses

Was this helpful?

migrations

object-notification-clients

ports

shelves

storage-nodes

storage-systems

switches

system-settings

vvolscs