Skip to main content
Keystone

Get customer consumption details using the Digital Advisor REST API

Contributors netapp-shwetav

This API retrieves the current consumption details for all the subscriptions associated with the given customerID.

Request:

Method

GET

EndPoint

https://api.activeiq.netapp.com/v1/keystone/customer/consumption-details

Parameters

  • type: "customer"

  • id: <customer-id>

Headers

  • accept: application/json

  • authorizationToken: <access_key>

Response:
The API will respond with a JSON object containing a list of all the subscriptions with the current service usage metrics for the given customer. Here's an example response:

{
"result":  {
"returned_records": "string",
"records": [
{
"subscription":  {
"account_name": "string",
"number": "string",
"start_date": "string",
"end_date": "string"
},
"service_levels": [
{
"name": "string",
"committed_tib": "string",
"consumed_tib": "string",
"consumed_timestamp_utc": "string",
"burst_tib": "string",
"accrued_burst_tib": "string"
}
]
}
],
"request_id": "string",
"response_time": "string"
}
}

Status code: 200 – Successful request

Curl example:

curl -X 'GET' \ 'https://api.activeiq.netapp.com/v1/keystone/customer/consumption-details?type=customer&id=<customerID>' \ -H 'accept: application/json' \ -H 'authorizationToken: <access-key>'

Get the historical consumption details for a customer

This API retrieves the historical consumption details for all the subscriptions associated with the given customerID as per the time range specified.

Request:

Method

GET

EndPoint

https://api.activeiq.netapp.com/v1/keystone/customer/historical-consumption-details

Parameters

  • type: "customer"

  • id: <customer-id>

  • from_date_utc: <start date(in RFC3339 format)>

  • to_date_utc: <end date(in RFC3339 format)>

Headers

  • accept: application/json

  • authorizationToken: <access_key>

Response:

The API will respond with a JSON object containing a list of all the subscriptions with the historical service usage metrics for the given customer in the selected time range. Here's an example response:

{
"results":  {
"returned_records": 0,
"records": [
{
"subscription":  {
"account_name": "string",
"number": "string",
"start_date": "2023-08-24T14:15:22Z",
"end_date": "2023-08-24T14:15:22Z"
},
"service_levels": [
{
"name": "string",
"historical_consumption": [
{
"committed_tib": 0,
"consumed_tib": 0,
"timestamp_utc": "2023-08-24T14:15:22Z",
"burst_tib": 0,
"accrued_burst_tib": 0,
"is_invoiced": true
}
]
}
]
}
],
"request_parameters":  {
"from_date_utc": "2023-08-24",
"to_date_utc": "2023-08-24",
"customer_id": "string"
},
"request_id": "string",
"response_time": "string",
"customer":  {
"name": "string",
"id": "string"
}
}
}

Status code: 200 – Successful request

Curl example:

curl -X 'GET' \ 'https://api.activeiq-stg.netapp.com/v1/keystone/customer/historical-consumption-details? type=customer&id=<customerID>&from_date_utc=2023-08-24T14%3A15%3A22Z&t _date_utc=2023-08-24T14%3A15%3A22Z' \ -H 'accept: application/json' \ -H 'authorizationToken: <access-key>'