Delete a layer

Deleting a layer removes one or more layers from a catalog. You may want to delete a layer to reorganize your data within the HERE platform. You may also want to delete a layer to manage your data cost by removing layers you no longer need. Other ways of managing data cost include deleting catalogs, deleting partitions, and managing data deletion using the layer's Time-To-Live (TTL) setting.

You can delete volatile, stream, index, object store and interactive map layers. You cannot delete versioned layers. HERE platform does not allow deleting versioned layers because deleting a versioned layer would break the data dependency chain inside the catalog and also dependencies outside the catalog.

For example, one reason HERE platform does not allow deletion of versioned layers is to protect map compilation use cases where versioned layers have input or output dependencies on one another. Removal of a versioned layer would potentially prevent you from recomputing derived maps based on a fixed version of the catalog.

This procedure deletes a layer using the config service. For complete information on using the config service, see the API Reference.

1. Obtain an authorization token. For instructions, see the Identity & Access Management Guide.
2. Use the API Lookup service to get the API endpoint for the config API of the catalog for the layer you want to delete. For instructions, see the API Lookup Developer's Guide.

3. Delete the layer using this request:

   DELETE /catalogs/<catalogHrn>/layers/<layerId> HTTP/1.1
   Host: <Hostname for the config API from the API Lookup Service>
   Authorization: Bearer <Authorization Token>
   

4. The request returns 202 Accepted. The body of the response contains the element href which contains a URL where you can get the status of the layer deletion process. For example:

    {
      "title": "Layer Deletion",
      "href": "https://config.data.api.platform.here.com/config/v1/status/da167243-13cd-1312-1b72-2z5d2dea7460",
      "type": "urn:olp-types:status"
    }
   

   Use the GET method with the URL in the href field of the response to get the status of the deletion. The request returns 202 Accepted and the status is in the response body. For example:

    {
      "status": "pending",
      "steps": [
        {
          "name": "delete_layer:validation",
          "state": "Completed"
        },
        {
          "name": "delete_layer:metadata",
          "state": "Completed"
        },
        {
          "name": "delete_layer:catalog_publishing",
          "state": "In progress"
        },
        {
          "name": "delete_layer:layers",
          "state": "Not started"
        },
        {
          "name": "delete_layer:database",
          "state": "Not started"
        },
        {
          "name": "delete_layer:backups",
          "state": "Not started"
        },
        {
          "name": "delete_layer:cache",
          "state": "Not started"
        }
      ]
    }
   

5. Once the layer is deleted, the URL will return 200 OK with the response body:

   {
    "status": "success"
   }
   

For complete information on using the config service, see the API Reference.