DELETE /reference_data/tables/{name}/{outer_key}/{inner_key}
Remove a value from a reference table.
Remove a value from a reference table.
MIME Type |
---|
application/json |
Parameter | Type | Optionality | Data Type | MIME Type | Description |
---|---|---|---|---|---|
name |
path |
Required |
String |
text/plain |
Required - The name of the reference table to remove a value from |
namespace |
query |
Optional |
String |
text/plain |
- Either SHARED or TENANT, default is SHARED. |
outer_key |
path |
Required |
String |
text/plain |
Required - The outer key of the value to remove |
inner_key |
path |
Required |
String |
text/plain |
Required - The inner key of the value to remove |
value |
query |
Required |
String |
text/plain |
Required - The value to remove from the reference table. Note: Date values must be represented in milliseconds since the Unix Epoch January 1st 1970. |
domain_id |
query |
Optional |
Number (Integer) |
text/plain |
Optional - This allows the domain id for the value to be specified. If null, the shared domain will be used. |
fields |
query |
Optional |
String |
text/plain |
Optional - Use this parameter to specify which fields you would like to get back in the response. Fields that are not named are excluded. Specify subfields in brackets and multiple fields in the same object are separated by commas. |
HTTP Response Code | Unique Code | Description |
---|---|---|
200 |
The reference table had had a value removed |
|
404 |
1002 |
The reference table does not exist |
404 |
1003 |
The record does not exist in the reference table |
404 |
1011 |
Domain not found |
422 |
1005 |
A request parameter is not valid |
422 |
1012 |
The namespace value of SHARED was expected |
422 |
1014 |
The domain_id parameter must be specified |
500 |
1020 |
An error occurred while attempting to remove the reference table value |
Response Description
Information about the reference table that had an element removed. This returns information about table but not the contained data.
Response Sample
{
"collection_id": 42,
"creation_time": 42,
"element_type": "String <one of: ALN, NUM, IP, PORT, ALNIC, DATE>",
"key_label": "String",
"key_name_types": {
"String": "String <one of: ALN, NUM, IP, PORT, ALNIC, DATE>"
},
"name": "String",
"namespace": "String <one of: PRIVATE, SHARED, TENANT>",
"number_of_elements": 42,
"time_to_live": "String",
"timeout_type": "String <one of: UNKNOWN, FIRST_SEEN, LAST_SEEN>"
}