Logically deletes a single dimension, identified by its externally-provided name.
As a result of this operation, all data stored within this dimension, including the
structure of its aspects, attributes, etc., will immediately become inaccessible.
This is a privileged operation.
There is an alternate resource
available for accessing a dimension by its system-provided ID.
Path Elements
name
string
|
The string name of the dimension to be deleted.
|
Example
1
Request:
Response:
HTTP/1.1
204
NO CONTENT
Error
Example
- does not exist
Request:
Response:
HTTP/1.1
404
NOT FOUND
{
"errorID" : "DIM-001001",
"errorMessage": "Sorry, the requested dimension 'CITY' does not exist.",
"requestID" : "DIM-0800200c9a66"
}
Error
Example
- concurrent operations
Request:
Response:
HTTP/1.1
409
CONFLICT
{
"errorID" : "DIM-001010",
"errorMessage": "This operation could not be completed because the dimension was modified by another operation.",
"requestID" : "DIM-0800200c9a66"
}