date-dimension

Migrate a Date dataset to the custom date dimension

Migrate the Date datasets in your project from the urn:gooddata:date and urn:custom:date date dimension to the urn:custom_v2:date date dimension. For more information about the date dimensions, see Custom Calendars - Self Service.

You can migrate all datasets in the project at once or only a specific dataset.

NOTE: When migrating the datasets, do not perform other tasks (especially data loading) at the same time because it may cause data inconsistency.

post/gdc/md/{project_id}/datedimension/upgrade

Request

  • Base URL
    https://secure.gooddata.com
  • Auth
    none declared

Path parameters

project_idstring required

The ID of the project that the Date dataset belongs to.

Request body

Example request

{
  "upgrade": {
    "dateDatasets": {
      "upgrade": "all"
    }
  }
}

Response

The datasets have not been migrated. Possible reasons:

  • The datasets are not set to the urn:gooddata:date and urn:custom:date date dimension and cannot be migrated.

  • The datasets are already set to the urn:custom_v2:date date dimension.

Example response

{
  "wTaskStatus": {
    "poll": "/gdc/md/{project_id}/tasks/{task_id}/status",
    "messages": [
      {
        "error": {
          "errorClass": "BadRequestError",
          "trace": "BadRequestError occured in ErrorClass at line 123",
          "message": "Invalid request payload %s",
          "component": "default",
          "errorId": "error123",
          "errorCode": "gdc702",
          "parameters": [
            "{\"payload\": \"invalid\"}"
          ]
        }
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.