org.odpi.openmetadata.userinterfaces.adminservices.spring

Class UIOperationalServicesResource

java.lang.Object

org.odpi.openmetadata.userinterfaces.adminservices.spring.UIOperationalServicesResource

@RestController
 @RequestMapping(value="/open-metadata/ui-admin-services/users/{userId}/servers/{serverName}")
public class UIOperationalServicesResource
extends Object

UIOperationalServicesResource provides the REST API for controlling the start up, management and shutdown of services in the OMAG Server.

Constructor Summary

Constructors

Constructor and Description
UIOperationalServicesResource()

Method Summary

Modifier and Type	Method and Description
SuccessMessageResponse	activateWithStoredConfig(String userId, String serverName) Activate the open metadata and governance services using the stored configuration information.
SuccessMessageResponse	activateWithSuppliedConfig(String userId, String serverName, UIServerConfig configuration) Activate the open metadata and governance services using the supplied configuration document.
VoidResponse	deactivatePermanently(String userId, String serverName) Permanently deactivate any open metadata and governance services and unregister from any cohorts.
VoidResponse	deactivateTemporarily(String userId, String serverName) Temporarily deactivate any open metadata and governance services.
UIServerConfigResponse	getActiveConfiguration(String userId, String serverName) Return the configuration used for the current active instance of the server.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

UIOperationalServicesResource

public UIOperationalServicesResource()

Method Detail

activateWithStoredConfig

@RequestMapping(method=POST,
                path="/instance")
public SuccessMessageResponse activateWithStoredConfig(@PathVariable
                                                                                                                      String userId,
                                                                                                                      @PathVariable
                                                                                                                      String serverName)

Activate the open metadata and governance services using the stored configuration information.

Parameters:

userId - user that is issuing the request

serverName - local server name

Returns:

void response or OMAGNotAuthorizedException the supplied userId is not authorized to issue this command or OMAGInvalidParameterException the server name is invalid or OMAGConfigurationErrorException there is a problem using the supplied configuration.

activateWithSuppliedConfig

@RequestMapping(method=POST,
                path="/instance/configuration")
public SuccessMessageResponse activateWithSuppliedConfig(@PathVariable
                                                                                                                                      String userId,
                                                                                                                                      @PathVariable
                                                                                                                                      String serverName,
                                                                                                                                      @RequestBody
                                                                                                                                      UIServerConfig configuration)

Activate the open metadata and governance services using the supplied configuration document.

Parameters:

userId - user that is issuing the request

configuration - properties used to initialize the services

serverName - local server name

Returns:

void response or OMAGNotAuthorizedException the supplied userId is not authorized to issue this command or OMAGInvalidParameterException the server name is invalid or OMAGConfigurationErrorException there is a problem using the supplied configuration.

deactivateTemporarily

@RequestMapping(method=DELETE,
                path="/instance")
public VoidResponse deactivateTemporarily(@PathVariable
                                                                                                           String userId,
                                                                                                           @PathVariable
                                                                                                           String serverName)

Temporarily deactivate any open metadata and governance services.

Parameters:

userId - user that is issuing the request

serverName - local server name

Returns:

void response or OMAGNotAuthorizedException the supplied userId is not authorized to issue this command or OMAGInvalidParameterException the serverName is invalid.

deactivatePermanently

@RequestMapping(method=DELETE,
                path="")
public VoidResponse deactivatePermanently(@PathVariable
                                                                                                  String userId,
                                                                                                  @PathVariable
                                                                                                  String serverName)

Permanently deactivate any open metadata and governance services and unregister from any cohorts.

Parameters:

userId - user that is issuing the request

serverName - local server name

Returns:

void response or OMAGNotAuthorizedException the supplied userId is not authorized to issue this command or OMAGInvalidParameterException the serverName is invalid.

getActiveConfiguration

@RequestMapping(method=GET,
                path="/instance/configuration")
public UIServerConfigResponse getActiveConfiguration(@PathVariable
                                                                                                                                 String userId,
                                                                                                                                 @PathVariable
                                                                                                                                 String serverName)

Return the configuration used for the current active instance of the server. Null is returned if the server instance is not running.

Parameters:

userId - user that is issuing the request

serverName - local server name

Returns:

configuration properties used to initialize the server or null if not running or OMAGNotAuthorizedException the supplied userId is not authorized to issue this command or OMAGInvalidParameterException the server name is invalid or OMAGConfigurationErrorException there is a problem using the supplied configuration.