HPE GreenLake Locations service

The HPE GreenLake Locations service allows you to assign and manage device service delivery information. Service delivery information includes device location and support contact information:

  • Device location—A physical address associated with each device instance on the HPE GreenLake platform.
  • Support contact information—A name, email address, and optionally a phone number associated with each device instance.

HPE GreenLake for Locations is a RESTful API for creating and managing location services. The API initiates any locations service operation or task available through the HPE GreenLake platform UI. HPE GreenLake platform uses the collected information to automate service delivery and to create automated support cases.

Features

  • Create locations with addresses and service delivery contact information.
  • Assign a primary contact for a device.
  • Access audit logs for the locations service.
  • Location validation to ensure that the location and related details are still correct.
  • Manage tags for a specific location or workspace.
  • Retrieve a location using latitude and longitude.

What's new

July 2024

The Locations APIs have been updated to a stable v1 version, and the documentation has been updated to refer to the v1 versions. Further, the new locations/v1/address/revgeocode API was added.

For more information, see the changelog.

Deprecated

The following APIs are being deprecated and removed on their end-of-life date. Use the replacement APIs.

API Deprecated endpoint Deprecation date Replacement endpoint
List all locations GET /locations/v1beta1/locations 2024-12-19 GET /locations/v1/locations
Retrieve a location GET /locations/v1beta1/locations/{id} 2024-12-19 GET /locations/v1/locations/{id}
Get tags for a workspace GET /locations/v1beta1/locations/tags 2024-12-19 GET /locations/v1/locations/tags
Retrieve tags for a location GET /locations/v1beta1/locations/tags/{id} 2024-12-19 GET /locations/v1/locations/tags/{id}
Create a location POST /locations/v1beta1/locations 2024-12-19 POST /locations/v1/locations
Update a location PATCH /locations/v1beta1/locations/{id} 2024-12-19 PATCH /locations/v1/locations/{id}
Delete a location DELETE /locations/v1beta1/locations/{id} 2024-12-19 DELETE /locations/v1/locations/{id}
Manage a location PATCH /locations/v1beta1/locations/update/{id} 2024-12-19 PATCH /locations/v1/locations/update/{id}
Create or delete a tag PATCH /locations/v1beta1/locations/tags 2024-12-19 PATCH /locations/v1/locations/tags

Related documentation