Jump to: navigation, search

Trove/ConfigurationParameters

< Trove
Revision as of 20:23, 18 February 2014 by Cp16net (talk | contribs) (API Details)

Overview

Configuration Parameters need to be stored in the database and have a management api.

Database Model

Name Data Type Length Nullable Details
id * VARCHAR 36 False unique id of the parameter
name VARCHAR 256 False name of the configuration parameter
datastore_version_id * VARCHAR 36 False datastore version id that the parameter is assigned to
restart_required BOOLEAN x False determines if the parameter requires the datastore to be restarted
max INTEGER x True max size of the parameter used for validation
min INTEGER x True min size of the parameter used for validation
data_type VARCHAR 256 False data type of the parameter
deleted BOOLEAN x False standard field to store if parameter is deleted
deleted_at DATETIME x True standard field to store when parameter is deleted

{* Denotes a primary key}

API Details

New management api calls

Calls to Create/Alter/Purge configuration parameters for each datastore version.

Verb Resource Description
POST /mgmt/datastores/{datastore}/versions/{version}/parameters Create a parameter for the given datastore version
PUT /mgmt/datastores/{datastore}/versions/{version}/parameters/{key} Modify a parameter for the given datastore version
DELETE /mgmt/datastores/{datastore}/versions/{version}/parameters/{key} Delete a parameter for the given datastore version

Existing api calls

Calls to Read the configuration parameters for each datastore do not require any change.

Verb Resource Description
GET /datastores/{datastore}/versions/{version}/parameters List all parameters for the given datastore version
GET /datastores/versions/{version}/parameters Get a parameter for the given datastore version
GET /datastores/{datastore}/versions/{version}/parameters/{key} List all parameters for the given datastore version
GET /datastores/versions/{version}/parameters/{key} Get a parameter for the given datastore version