Skip to content
/Subscriptions - v2beta1

HPE GreenLake APIs for Subscription Management (latest)

With the HPE GreenLake APIs for Subscription Management you can add subscriptions, unclaim subscriptions, get subscription information, and update auto-subscription settings for your HPE GreenLake workspace.

Download OpenAPI description
index.json
index.yaml
Languages
Servers
Url hostname

https://global.api.greenlake.hpe.com/

Mock server

https://developer.greenlake.hpe.com/_mock/docs/greenlake/services/subscription-management/public/openapi/nbapi-subscription/

Subscriptions - v1

Operations

Subscriptions - v2beta1

Operations

Unclaim subscriptions in bulk

Request

Unclaim subscriptions in bulk by passing one or more subscription IDs.

Note: You must have edit permission for the Devices and Subscription service to use this API.

You can unclaim up to 10 subscriptions in a single request. This endpoint provides an asynchronous response and always returns 202 Accepted if basic input validation is successful. The Location header in the response contains the URI to check the progress of the unclaim task. For details about the status fetch URL, see Get progress or status of async operations in subscriptions

Rate limits apply to this endpoint. If the threshold is exceeded, the API returns a 429 Too Many Requests response.

Security
Bearer
Bodyapplication/jsonrequired

Provide a list of subscription IDs to unclaim. The API endpoint supports unclaiming up to 10 subscriptions in a single request.
You can fetch the subscription IDs using the Get subscriptions of a workspace API.

itemsArray of objects(BulkUnclaimId)required

An array of subscription IDs.

items[].​idstringrequired

Subscription ID.

curl -i -X DELETE \
  https://global.api.greenlake.hpe.com/subscriptions/v2beta1/subscriptions/bulk \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "items": [
      {
        "id": "64343c3c-3016-4234-baee-765651aa4bb3"
      },
      {
        "id": "64343c3c-3016-4234-baee-765651aa4bb4"
      }
    ]
  }'

Responses

Request accepted

Headers
Locationstring

The URI of the accepted asynchronous operation resource.

Example: "/subscriptions/v1/async-operations/22d6fbfb-d253-4455-984a-356da827e5fc"
Bodyapplication/json
codeinteger(int32)required

Three digit HTTP status code.

statusstringrequired

Three digit HTTPS status code and message.

Enum"100 CONTINUE""101 SWITCHING_PROTOCOLS""102 PROCESSING"
transactionIdstringrequired
Response
application/json
{
  "code": 202,
  "status": "202 ACCEPTED",
  "transactionId": "5652cd26-d577-47cd-b075-8e94885a63ab"
}

Subscriptions - v1alpha1

Operations

Subscriptions - v1beta1

Operations

Auto Subscriptions settings - v1alpha1

Operations

Auto Subscriptions settings - v1

Operations