Files
scylladb/api/api-doc/storage_proxy.json
Amnon Heiman c41ccb4ce4 API Adding the storage_proxy definition file
This adds the swagger definition file for the storage_proxy, it is based
on the StorageProxyMBean definition.

The following command where define:
get_total_hints
get_hinted_handoff_enabled
set_hinted_handoff_enabled
get_hinted_handoff_enabled_by_dc
set_hinted_handoff_enabled_by_dc_list
get_max_hint_window
set_max_hint_window
get_max_hints_in_progress
set_max_hints_in_progress
get_rpc_timeout
set_rpc_timeout
get_read_rpc_timeout
set_read_rpc_timeout
get_write_rpc_timeout
set_write_rpc_timeout
get_counter_write_rpc_timeout
set_counter_write_rpc_timeout
get_cas_contention_timeout
set_cas_contention_timeout
get_range_rpc_timeout
set_range_rpc_timeout
get_truncate_rpc_timeout
set_truncate_rpc_timeout
reload_trigger_classes
get_read_repair_attempted
get_read_repair_repaired_blocking
get_read_repair_repaired_background
get_schema_versions

Matricses are not added yet, the basic integration and naming
get_cas_read_timeouts was added under the URL:
/storage_proxy/metrics/
That will holds the related matricses.

Signed-off-by: Amnon Heiman <amnon@cloudius-systems.com>
2015-06-18 11:30:30 +03:00

569 lines
16 KiB
JSON

{
"apiVersion":"0.0.1",
"swaggerVersion":"1.2",
"basePath":"{{Protocol}}://{{Host}}",
"resourcePath":"/storage_proxy",
"produces":[
"application/json"
],
"apis":[
{
"path":"/storage_proxy/total_hints",
"operations":[
{
"method":"GET",
"summary":"Get total hints",
"type":"long",
"nickname":"get_total_hints",
"produces":[
"application/json"
],
"parameters":[
]
}
]
},
{
"path":"/storage_proxy/hinted_handoff_enabled",
"operations":[
{
"method":"GET",
"summary":"Return true if hinted handoff enabled",
"type":"boolean",
"nickname":"get_hinted_handoff_enabled",
"produces":[
"application/json"
],
"parameters":[
]
},
{
"method":"POST",
"summary":"Set hinted handoff status",
"type":"void",
"nickname":"set_hinted_handoff_enabled",
"produces":[
"application/json"
],
"parameters":[
{
"name":"enable",
"description":"Set to true to enable hinted handoff",
"required":true,
"allowMultiple":false,
"type":"boolean",
"paramType":"query"
}
]
}
]
},
{
"path":"/storage_proxy/hinted_handoff_enabled_by_dc",
"operations":[
{
"method":"GET",
"summary":"Get the hinted handoff enabled by dc",
"type":"array",
"items":{
"type":"mapper_list"
},
"nickname":"get_hinted_handoff_enabled_by_dc",
"produces":[
"application/json"
],
"parameters":[
]
},
{
"method":"POST",
"summary":"Set the hinted handoff enabled by dc",
"type":"void",
"nickname":"set_hinted_handoff_enabled_by_dc_list",
"produces":[
"application/json"
],
"parameters":[
{
"name":"dcs",
"description":"The dcs to enable in the CSV format",
"required":true,
"allowMultiple":false,
"type":"string",
"paramType":"query"
}
]
}
]
},
{
"path":"/storage_proxy/max_hint_window",
"operations":[
{
"method":"GET",
"summary":"Get the max hint window",
"type":"int",
"nickname":"get_max_hint_window",
"produces":[
"application/json"
],
"parameters":[
]
},
{
"method":"POST",
"summary":"Set the max hint window",
"type":"void",
"nickname":"set_max_hint_window",
"produces":[
"application/json"
],
"parameters":[
{
"name":"ms",
"description":"max hint window in ms",
"required":true,
"allowMultiple":false,
"type":"int",
"paramType":"query"
}
]
}
]
},
{
"path":"/storage_proxy/max_hints_in_progress",
"operations":[
{
"method":"GET",
"summary":"Get max hints in progress",
"type":"int",
"nickname":"get_max_hints_in_progress",
"produces":[
"application/json"
],
"parameters":[
]
},
{
"method":"POST",
"summary":"Set max hints in progress",
"type":"void",
"nickname":"set_max_hints_in_progress",
"produces":[
"application/json"
],
"parameters":[
{
"name":"qs",
"description":"max hints in progress",
"required":true,
"allowMultiple":false,
"type":"int",
"paramType":"query"
}
]
}
]
},
{
"path":"/storage_proxy/hints_in_progress",
"operations":[
{
"method":"GET",
"summary":"get hints in progress",
"type":"int",
"nickname":"get_hints_in_progress",
"produces":[
"application/json"
],
"parameters":[
]
}
]
},
{
"path":"/storage_proxy/rpc_timeout",
"operations":[
{
"method":"GET",
"summary":"Get the RPC timeout",
"type":"long",
"nickname":"get_rpc_timeout",
"produces":[
"application/json"
],
"parameters":[
]
},
{
"method":"POST",
"summary":"Set the RPC timeout",
"type":"void",
"nickname":"set_rpc_timeout",
"produces":[
"application/json"
],
"parameters":[
{
"name":"timeout",
"description":"Timeout in millis",
"required":true,
"allowMultiple":false,
"type":"long",
"paramType":"query"
}
]
}
]
},
{
"path":"/storage_proxy/read_rpc_timeout",
"operations":[
{
"method":"GET",
"summary":"Get the read RPC timeout",
"type":"long",
"nickname":"get_read_rpc_timeout",
"produces":[
"application/json"
],
"parameters":[
]
},
{
"method":"POST",
"summary":"Set the read RPC timeout",
"type":"void",
"nickname":"set_read_rpc_timeout",
"produces":[
"application/json"
],
"parameters":[
{
"name":"timeout",
"description":"timeout_in_millis",
"required":true,
"allowMultiple":false,
"type":"long",
"paramType":"query"
}
]
}
]
},
{
"path":"/storage_proxy/write_rpc_timeout",
"operations":[
{
"method":"GET",
"summary":"Get the write RPC timeout",
"type":"long",
"nickname":"get_write_rpc_timeout",
"produces":[
"application/json"
],
"parameters":[
]
},
{
"method":"POST",
"summary":"Set the write RPC timeout",
"type":"void",
"nickname":"set_write_rpc_timeout",
"produces":[
"application/json"
],
"parameters":[
{
"name":"timeout",
"description":"timeout in millisecond",
"required":true,
"allowMultiple":false,
"type":"long",
"paramType":"query"
}
]
}
]
},
{
"path":"/storage_proxy/counter_write_rpc_timeout",
"operations":[
{
"method":"GET",
"summary":"Get counter write rpc timeout",
"type":"long",
"nickname":"get_counter_write_rpc_timeout",
"produces":[
"application/json"
],
"parameters":[
]
},
{
"method":"POST",
"summary":"Set counter write rpc timeout",
"type":"void",
"nickname":"set_counter_write_rpc_timeout",
"produces":[
"application/json"
],
"parameters":[
{
"name":"timeout",
"description":"timeout in millisecond",
"required":true,
"allowMultiple":false,
"type":"long",
"paramType":"query"
}
]
}
]
},
{
"path":"/storage_proxy/cas_contention_timeout",
"operations":[
{
"method":"GET",
"summary":"Get CAS contention timeout",
"type":"long",
"nickname":"get_cas_contention_timeout",
"produces":[
"application/json"
],
"parameters":[
]
},
{
"method":"POST",
"summary":"Set CAS contention timeout",
"type":"void",
"nickname":"set_cas_contention_timeout",
"produces":[
"application/json"
],
"parameters":[
{
"name":"timeout",
"description":"timeout in millisecond",
"required":true,
"allowMultiple":false,
"type":"long",
"paramType":"query"
}
]
}
]
},
{
"path":"/storage_proxy/range_rpc_timeout",
"operations":[
{
"method":"GET",
"summary":"Get range rpc timeout",
"type":"long",
"nickname":"get_range_rpc_timeout",
"produces":[
"application/json"
],
"parameters":[
]
},
{
"method":"POST",
"summary":"Set range rpc timeout",
"type":"void",
"nickname":"set_range_rpc_timeout",
"produces":[
"application/json"
],
"parameters":[
{
"name":"timeout",
"description":"timeout in millisecond",
"required":true,
"allowMultiple":false,
"type":"long",
"paramType":"query"
}
]
}
]
},
{
"path":"/storage_proxy/truncate_rpc_timeout",
"operations":[
{
"method":"GET",
"summary":"Get truncate rpc timeout",
"type":"long",
"nickname":"get_truncate_rpc_timeout",
"produces":[
"application/json"
],
"parameters":[
]
},
{
"method":"POST",
"summary":"Set truncate rpc timeout",
"type":"void",
"nickname":"set_truncate_rpc_timeout",
"produces":[
"application/json"
],
"parameters":[
{
"name":"timeout",
"description":"timeout in millisecond",
"required":true,
"allowMultiple":false,
"type":"long",
"paramType":"query"
}
]
}
]
},
{
"path":"/storage_proxy/reload_trigger_classes",
"operations":[
{
"method":"POST",
"summary":"Reload trigger classes",
"type":"void",
"nickname":"reload_trigger_classes",
"produces":[
"application/json"
],
"parameters":[
]
}
]
},
{
"path":"/storage_proxy/read_repair_attempted",
"operations":[
{
"method":"GET",
"summary":"Get read repair attempted",
"type":"long",
"nickname":"get_read_repair_attempted",
"produces":[
"application/json"
],
"parameters":[
]
}
]
},
{
"path":"/storage_proxy/read_repair_repaired_blocking",
"operations":[
{
"method":"GET",
"summary":"Get read repair repaired blocking",
"type":"long",
"nickname":"get_read_repair_repaired_blocking",
"produces":[
"application/json"
],
"parameters":[
]
}
]
},
{
"path":"/storage_proxy/read_repair_repaired_background",
"operations":[
{
"method":"GET",
"summary":"Get read repair repaired background",
"type":"long",
"nickname":"get_read_repair_repaired_background",
"produces":[
"application/json"
],
"parameters":[
]
}
]
},
{
"path":"/storage_proxy/schema_versions",
"operations":[
{
"method":"GET",
"summary":"Get a map of the schema versions",
"type":"array",
"items":{
"type":"mapper_list"
},
"nickname":"get_schema_versions",
"produces":[
"application/json"
],
"parameters":[
]
}
]
},
{
"path":"/storage_proxy/metrics/cas_read/timeouts",
"operations":[
{
"method":"GET",
"summary":"Get CAS read timeout",
"type":"long",
"nickname":"get_cas_read_timeouts",
"produces":[
"application/json"
],
"parameters":[
]
}
]
}
],
"models":{
"mapper_list":{
"id":"mapper_list",
"description":"Holds a key value which is a list",
"properties":{
"key":{
"type":"string",
"description":"The key"
},
"value":{
"type":"array",
"items":{
"type":"string"
},
"description":"The value"
}
}
}
}
}