Get usage csv by projectHrn

You can retrieve the usage in csv format using the projectHrn, as shown here.

Request

This example uses hrn:here:authorization::myorganization:project/my-project-0000 as the projectHrn.

Parameters

realmId required string [ 5 .. 30 ] characters
Example: org123456789
Your org ID.
startTime
required
string
Example: startTime=yyyy-MM-dd'T'HH:mm:ss
Start date for history search.
endTime
required
string
Example: endTime=yyyy-MM-dd'T'HH:mm:ss
End date for history search.
projectHrn string less than or equal to 256 characters
Example: projectHrn=hrn:here:authorization::myrealm:project/my-project-0000
The HRN which identifies the project.

Header parameters

X-Request-ID string
User-provided token that can be used to trace a request or a group of requests sent to the service.
X-Correlation-ID
required
string
Auto-generated ID, which uniquely identifies the request, available in the response. When contacting the support with an inquiry regarding a specific request, provide the value of this header; This will help troubleshooting the issue.
    GET https://usage.bam.api.here.com/v2/usage/realms/org123456789/csv?startDate=2021-07-01T10:39:51&endDate=2021-08-30T10:39:51&projectHrn=hrn%3Ahere%3Aauthorization%3A%3Amyrealm%3Aproject%2Fmy-project-0000

Response: HTTP 200 OK

The response in csv format lists the following columns:

  • Date and time (usageDateTime): The date and time that the usage occurred.
  • Org ID (realmId): The unique identifier for a end-customer's organization and partner organization associated with Org Name.
  • Category (category): The HERE product category, such as pipelines, data, etc.
  • App Id (appId): The unique identifier of a registered app.
  • Item (featureId): The feature ID.
  • Subscription ID (billingSubscriptionId): A unique identifier for your subscription to HERE. A subscription is the customer owned, technical instance of a product (no pricing etc. details). It is created to provision the purchased product and to report usage to the underlying billing system.
  • Resource ID (resourceHrn): Details provided for the type of usage.
  • Item description (name): A name for the item.
  • Unit (valueDriver): The unit which is billable, for example GB.
  • Project ID (projectHrn): (Optional) A unique identifier to manage work and resources that can be applied.
  • Billing Tag (billingTag): a unique string used for combining expenses.
  • Usage amount (billableValue): How much billable usage has accrued.

For partners, an additional column is added in the csv output. The additional column is the name of the organization, orgName.

results matching ""

    No results matching ""