Update a Database
put
/api/database/Databases/{id}
Updates the properties of the database that matches the specified ID.
Request
Path Parameters
-
id(required): integer(int32)
The database ID.Example:
1
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object
-
DatabaseName: string
The database display name.
To avoid confusion with numeric IDs, the name value cannot be integers only or integers prefixed with the + or - symbols only. It must contain letters or other characters. For example, 1234, +1234, and -1234 are not valid, but US1234, US+1234 and US_1234 are.Example:Primary Graph Database on someone.example.com
-
DBHost: string
The database FQDN host name.Example:
someone.example.com
-
DBName: string
The database schema name.Example:
Graph
-
DBPort: integer
The database port. The default is 3306.Example:
7687
-
DBType: string
The database type used in the connection string. The possible values are:
- mysql: MySQL. This is the default.
- Sybase: MS SQL Server/Sybase
- Neo4j: Neo4j Graph Database
- influxDB: InfluxDB Metric Database
Example:Neo4j
-
Description: string
The description of the database.Example:
Graph database
-
FailoverTypeID: integer
The failover type ID. Either 1 for a primary database or 2 for a backup or redundant database.Example:
1
-
Password: string
The new database login password.
-
ShardID: integer
The database shard ID.Example:
1
-
StatusID: integer
The database status ID. Either 0 (disabled) or 1 (enabled).Example:
1
-
Timeout: integer
The database connection timeout value in seconds. The default is 30.Example:
30
-
Username: string
The database login username.Example:
Response
Supported Media Types
- application/json
200 Response
Successful operation
Root Schema : schema
Match All
Show Source
-
object
SuccessfulUpdateOperation
The response body for a successful update operation.
-
object
type
Nested Schema : SuccessfulUpdateOperation
Type:
object
The response body for a successful update operation.
Show Source
-
message: string
The response message.Example:
Updated record
-
success: boolean
Whether the operation was a success (true) or a failure (false).Example:
true
Nested Schema : type
Type:
Show Source
object
-
data: array
data
The properties of the updated database.
-
total: integer
The total number of results regardless of paging.Example:
1
Nested Schema : databaseDatabasesRead
Type:
Show Source
object
-
DatabaseID: integer
The database ID for individual CRUD operations.Example:
1002
-
DatabaseName: string
The database display name.Example:
Primary Graph Database on someone.example.com
-
DBHost: string
The database FQDN host name.Example:
someone.example.com
-
DBName: string
The database schema name.Example:
Graph
-
DBPort: integer
The database port. The default is 3306.Example:
7687
-
DBType: string
The database type used in the connection string. The possible values are:
- mysql: MySQL. This is the default.
- Sybase: MS SQL Server/Sybase
- Neo4j: Neo4j Graph Database
- influxDB: InfluxDB Metric Database
Example:Neo4j
-
Description: string
The description of the database.Example:
Graph database
-
FailoverTypeID: integer
The failover type ID. Either 1 for a primary database or 2 for a backup or redundant database.Example:
1
-
IsAssure1Database:
Whether the database is a Unified Assurance database (1) or not (0). If the database name is Assure1, Event, Graph, Metric, or Vision, then it is a Unified Assurance database.Example:
1
-
ShardID: integer
The database shard ID.Example:
1
-
State: string
The state.Example:
Loading...
-
StateIcon: string
The state icon.Example:
barSpinner.gif
-
Status: string
Allowed Values:
[ "Enabled", "Disabled" ]
The status.Example:Enabled
-
StatusIcon: string
Allowed Values:
[ "OrbGreen.png", "OrbRed.png" ]
The status icon.Example:OrbGreen.png
-
StatusID: integer
The database status ID. Either 0 (disabled) or 1 (enabled).Example:
1
-
Timeout: integer
The database connection timeout value in seconds. The default is 30.Example:
30
-
Username: string
The database login username.Example:
Default Response
Failed operation
Root Schema : schema
Type:
Show Source
object
-
errors: array
errors
The list of errors reported. Validation errors will be keyed by record field.
-
message: string
The response message.Example:
Exception thrown
-
success: boolean
Whether the operation was a success (true) or a failure (false).Example:
false
Nested Schema : errors
Type:
array
The list of errors reported. Validation errors will be keyed by record field.
Show Source
-
Array of:
object items
An error.
Nested Schema : items
Type:
object
An error.