Renames a dimension by assigning a new external name.
As a result of this operation, the externally-provided name previously used will become
inaccessible and the name provided by this operation must be used in all future requests
that access the dimension
by name.
This is a privileged operation.
Path Elements
+dimension
string
|
The URI path to a specific dimension (whether
by ID or
by name).
|
Example
- rename dimension referenced by ID
Request:
BIG_CITIES
Response:
HTTP/1.1
204
NO CONTENT
Example
- rename dimension referenced by name
Request:
BIG_CITIES
Response:
HTTP/1.1
204
NO CONTENT
Error
Example
- blank or missing new name
Request:
Response:
HTTP/1.1
400
BAD REQUEST
{
"errorID" : "DIM-001011",
"errorMessage": "Sorry, when renaming a dimension the new name must not be missing or blank.",
"requestID" : "DIM-0800200c9a66"
}
Error
Example
- concurrent operations
Request:
BIG_CITIES
Response:
HTTP/1.1
409
CONFLICT
{
"errorID" : "DIM-001012",
"errorMessage": "Sorry, the dimension cannot be renamed 'BIG_CITIES' because
that name is already used. Please try again using a different name.",
"requestID" : "DIM-0800200c9a66"
}