Create a Broker Service
post
/api/broker/Services
Creates a new broker service.
The minimum required properties in the request body are:
The minimum required properties in the request body are:
- ServerID
- ClusterID
- PrimaryServiceID
- PackageName
- ServiceName
- ServiceProgram
- ServiceDescription
- StatusID
- FailoverType
- Privileged
- ApplicationConfig
Request
There are no request parameters for this operation.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object
-
ApplicationConfig: array
ApplicationConfig
The array of JSON objects with the configuration values for the service.
-
ClusterID: integer
The cluster ID specified for redundancy.Example:
0
-
FailoverType: integer
The failover type ID. Allowed Values:
- 0: Standalone
- 1: Primary
- 2: Backup
Example:0
-
PackageName: string
The package name.Example:
presentation-app
-
PrimaryServiceID: integer
The primary service ID specified for failover.Example:
0
-
Privileged: integer
Whether the process should be run as a privileged user (1) or not (0).Example:
0
-
ServerID: integer
The server ID specified for the service association.Example:
1
-
ServiceArguments: string
The optional service program arguments.Example:
--ssl-ca=/ssl/BundleCA.crt
-
ServiceDescription: string
The optional service human-readable description.Example:
This is an example description
-
ServiceName: string
The service reference 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:Data backup
-
ServiceProgram: string
The service program file location and name relative to the Unified Assurance install directory.Example:
/opt/assure1
-
StatusID: integer
The service status ID. Either 0 (disabled) or 1 (enabled).Example:
0
Nested Schema : ApplicationConfig
Type:
array
The array of JSON objects with the configuration values for the service.
Show Source
Nested Schema : items
Type:
Show Source
object
-
BrokerApplicationConfigName: string
The name of the configuration option.Example:
LogLevel
-
BrokerApplicationConfigTypeID: integer
The broker application configuration type ID.Example:
1
-
BrokerApplicationConfigValue: string
The value saved for the configuration option.Example:
Error
-
Required: boolean
Whether the configuration value can be left blank or not.Example:
0
Response
Supported Media Types
- application/json
200 Response
Successful operation
Root Schema : schema
Match All
Show Source
-
object
SuccessfulAddOperation
The response body for a successful add operation.
-
object
type
Nested Schema : SuccessfulAddOperation
Type:
object
The response body for a successful add operation.
Show Source
-
message: string
The response message.Example:
Added record
-
success: boolean
Whether the operation was a success (true) or a failure (false).Example:
true
Nested Schema : brokerServicesRead
Type:
Show Source
object
-
ApplicationConfig: array
ApplicationConfig
The array of JSON objects with the configuration values for the service.
-
BrokerServiceID: integer
The service ID.Example:
1
-
ClusterID: integer
The cluster ID specified for redundancy.Example:
0
-
Decouple: boolean
Allows for different combinations of primary/backup service pairings or pairing services across servers that are not tied togetherExample:
1
-
FailoverType: integer
The failover type ID. Allowed Values:
- 0: Standalone
- 1: Primary
- 2: Backup
Example:0
-
FailoverTypeName: string
The failover type name.Example:
Standalone
-
Last PID: integer
The last process ID of the running service.Example:
4404
-
PackageName: string
The package name.Example:
presentation-app
-
PrimaryServerID: integer
The database ID that identifies the primary server of the given server type (presentation, collection, database) in Assure1.Servers table.Example:
1
-
PrimaryServiceID: integer
The primary service ID specified for failover.Example:
0
-
PrimaryServiceServerID: integer
The server ID of the server primarily responsible for the service.Example:
1
-
Privileged: integer
Whether the process should be run as a privileged user (1) or not (0).Example:
0
-
ServerID: integer
The server ID to which the service belongs.Example:
1
-
ServerName: string
The server name.Example:
example.com
-
ServiceArguments: string
The optional service arguments.Example:
--ssl-ca=/ssl/BundleCA.crt
-
ServiceDescription: string
The optional service human-readable description.Example:
This is an example description
-
ServiceName: string
The service reference name.Example:
Data backup
-
ServiceProgram: string
The service program file location and the name relative to the Unified Assurance install directory.Example:
/opt/assure1
-
State: string
The service state.Example:
Running
-
StateIcon: string
The icon representing the service state.Example:
OrbGreenUp.png
-
Status: string
The status, based on the value of the StatusID property. When StatusID is 0, Status is Disabled. When StatusID is 1, Status is Enabled.Example:
Disabled
-
StatusIcon: string
The status image name based on the the statusID. If the statusID is 0, then the StatusIcon is OrbRed.png. If the statusID is 1, then the StatusIcon is OrbGreen.png.Example:
OrbRed.png
-
StatusID: integer
The server status ID. Either 0 (disabled) or 1 (enabled).Example:
0
Nested Schema : ApplicationConfig
Type:
array
The array of JSON objects with the configuration values for the service.
Show Source
Nested Schema : items
Type:
Show Source
object
-
BrokerApplicationConfigName: string
Name of the configuration option.Example:
LogLevel
-
BrokerApplicationConfigTypeID: integer
The broker application configuration type ID.Example:
1
-
BrokerApplicationConfigValue: string
The value saved for the configuration option.Example:
Error
-
Required: boolean
Whether the configuration value can be left blank or not.Example:
0
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.