Class ConfigRepositoryServicesResource
java.lang.Object
org.odpi.openmetadata.adminservices.spring.ConfigRepositoryServicesResource
@RestController
@RequestMapping("/open-metadata/admin-services/servers/{serverName}")
public class ConfigRepositoryServicesResource
extends Object
ConfigRepositoryServicesResource provides the configuration services for setting
up the repository services subsystems.
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionaddAuditLogDestination(String serverName, Connection connection) Add an audit log destination that is defined by the supplied connection object.addCohortRegistration(String serverName, String cohortName, Map<String, Object> additionalProperties) Enable registration of server to an open metadata repository cohort using the default topic structure (DEDICATED_TOPICS).addCohortRegistration(String serverName, String cohortName, CohortTopicStructure cohortTopicStructure, Map<String, Object> additionalProperties) Enable registration of server to an open metadata repository cohort using the topic pattern specified by cohortTopicStructure.addConsoleAuditLogDestination(String serverName, List<String> supportedSeverities) Set up the console audit log for the server.addEventTopicAuditLogDestination(String serverName, String topicName, List<String> supportedSeverities) Add an audit log destination that sends each log record as an event on the supplied event topic.addFileAuditLogDestination(String serverName, String directoryName, List<String> supportedSeverities) Add an audit log destination that creates log records as JSON files in a shared directory.addPostgreSQLDatabaseAuditLogDestination(String serverName, Map<String, Object> storageProperties) Add an audit log destination that creates log records as rows in a PostgreSQL Database Schema.addSLF4JAuditLogDestination(String serverName, List<String> supportedSeverities) Add an audit log destination that creates slf4j records.addStartUpOpenMetadataArchiveFile(String serverName, String fileName) Add a new open metadata archive to load at startup.clearAuditLogDestination(String serverName, String connectionName) Delete an audit log destination that is identified with the supplied connection's name.clearAuditLogDestinations(String serverName) Clears all audit log destinations for this server.clearCohortConfig(String serverName, String cohortName) Unregister this server from an open metadata repository cohort.clearLocalRepositoryConfig(String serverName) Remove all configuration for a local repository.clearOpenMetadataArchives(String serverName) Clear the list of open metadata archives.getAuditLogDestinations(String serverName) Set up the list of audit log destinations.getCohortConfig(String serverName, String cohortName) Retrieve the registration of server to an open metadata repository cohort.getCohortTopicName(String serverName, String cohortName) Retrieve the current topic name for the cohort.getDedicatedCohortTopicNames(String serverName, String cohortName) Retrieve the current topic name for the cohort.getLocalMetadataCollectionId(String serverName) Return the local metadata collection id.getLocalMetadataCollectionName(String serverName) Return the local metadata collection name.getLocalRepositoryConfig(String serverName) Return the configuration for the local repository.getOpenMetadataArchives(String serverName) Return the list of open metadata archives.overrideCohortTopicName(String serverName, String cohortName, String topicName) Override the current name for the single topic for the cohort.overrideInstancesCohortTopicName(String serverName, String cohortName, String topicName) Override the current name for the "instances" topic for the cohort.overrideRegistrationCohortTopicName(String serverName, String cohortName, String topicName) Override the current name for the registration topic for the cohort.overrideTypesCohortTopicName(String serverName, String cohortName, String topicName) Override the current name for the "types" topic for the cohort.resetRemoteCohortURL(String serverName, URLRequestBody requestBody) Update the URL broadcast across the cohort to allow other members to issue queries to this repository.setAuditLogDestinations(String serverName, List<Connection> auditLogDestinations) Set up the list of audit log destinations.setCohortConfig(String serverName, String cohortName, CohortConfig cohortConfig) Set up the configuration properties for a cohort.setDefaultAuditLog(String serverName, NullRequestBody requestBody) Set up the default audit log for the server.setInMemLocalRepository(String serverName, NullRequestBody requestBody) Set up an in memory local repository.setLocalMetadataCollectionId(String serverName, String metadataCollectionId) Set up the local metadata collection id.setLocalMetadataCollectionName(String serverName, String name) Set up the local metadata collection name.setLocalRepositoryConfig(String serverName, LocalRepositoryConfig localRepositoryConfig) Set up the configuration for the local repository.setNoRepositoryMode(String serverName) Remove all configuration for a local repository.setOpenMetadataArchives(String serverName, List<Connection> openMetadataArchives) Set up the list of open metadata archives.setPluginRepositoryConnection(String serverName, String connectorProvider, Map<String, Object> additionalProperties) Provide the connection to the local repository - used when the local repository mode is set to plugin repository.setPluginRepositoryConnection(String serverName, Connection connection) Provide the connection to the local repository - used when the local repository mode is set to plugin repository.setPostgresLocalRepository(String serverName, Map<String, Object> storageProperties) Set up a PostgreSQL database schema as the local repository.setReadOnlyLocalRepository(String serverName) Set up a read only local repository.setRepositoryProxyConnection(String serverName, String connectorProvider, Map<String, Object> additionalProperties) Provide the connection to the local repository - used when the local repository mode is set to repository proxy.setRepositoryProxyConnection(String serverName, Connection connection) Provide the connection to the local repository - used when the local repository mode is set to repository proxy.setRepositoryProxyEventMapper(String serverName, String connectorProvider, String eventSource, Map<String, Object> additionalProperties) Provide the connection to a repository proxy's event mapper.setRepositoryProxyEventMapper(String serverName, Connection connection) Provide the connection to a repository proxy's event mapper.updateAuditLogDestination(String serverName, String connectionName, Connection connection) Update an audit log destination that is identified with the supplied destination name with the supplied connection object.
-
Constructor Details
-
ConfigRepositoryServicesResource
public ConfigRepositoryServicesResource()
-
-
Method Details
-
setDefaultAuditLog
@PostMapping(path="/audit-log-destinations/default") public VoidResponse setDefaultAuditLog(@PathVariable String serverName, @RequestBody(required=false) NullRequestBody requestBody) Set up the default audit log for the server. This adds the console audit log destination.- Parameters:
serverName- local server name.requestBody- null request body- Returns:
- void response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName or localRepositoryMode parameter.
-
addConsoleAuditLogDestination
@PostMapping(path="/audit-log-destinations/console") public VoidResponse addConsoleAuditLogDestination(@PathVariable String serverName, @RequestBody List<String> supportedSeverities) Set up the console audit log for the server. This writes selected parts of the audit log record to stdout.- Parameters:
serverName- local server name.supportedSeverities- list of severities that should be logged to this destination (empty list means all)- Returns:
- void response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName or localRepositoryMode parameter.
-
addSLF4JAuditLogDestination
@PostMapping(path="/audit-log-destinations/slf4j") public VoidResponse addSLF4JAuditLogDestination(@PathVariable String serverName, @RequestBody List<String> supportedSeverities) Add an audit log destination that creates slf4j records.- Parameters:
serverName- local server name.supportedSeverities- list of severities that should be logged to this destination (empty list means all)- Returns:
- void response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName or localRepositoryMode parameter.
-
addFileAuditLogDestination
@PostMapping(path="/audit-log-destinations/files") public VoidResponse addFileAuditLogDestination(@PathVariable String serverName, @RequestParam(required=false) String directoryName, @RequestBody List<String> supportedSeverities) Add an audit log destination that creates log records as JSON files in a shared directory.- Parameters:
serverName- local server name.directoryName- name of directorysupportedSeverities- list of severities that should be logged to this destination (empty list means all)- Returns:
- void response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName or localRepositoryMode parameter.
-
addPostgreSQLDatabaseAuditLogDestination
@PostMapping(path="/audit-log-destinations/postgres") public VoidResponse addPostgreSQLDatabaseAuditLogDestination(@PathVariable String serverName, @RequestBody Map<String, Object> storageProperties) Add an audit log destination that creates log records as rows in a PostgreSQL Database Schema.- Parameters:
serverName- local server name.storageProperties- properties used to configure access to the database- Returns:
- void response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName.
-
addEventTopicAuditLogDestination
@PostMapping(path="/audit-log-destinations/event-topic") public VoidResponse addEventTopicAuditLogDestination(@PathVariable String serverName, @RequestParam(required=false) String topicName, @RequestBody List<String> supportedSeverities) Add an audit log destination that sends each log record as an event on the supplied event topic.- Parameters:
serverName- local server name.topicName- name of topicsupportedSeverities- list of severities that should be logged to this destination (empty list means all)- Returns:
- void response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName or localRepositoryMode parameter.
-
addAuditLogDestination
@PostMapping(path="/audit-log-destinations/connection") public VoidResponse addAuditLogDestination(@PathVariable String serverName, @RequestBody Connection connection) Add an audit log destination that is defined by the supplied connection object.- Parameters:
serverName- local server name.connection- connection object that defines the audit log destination- Returns:
- void response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName or localRepositoryMode parameter.
-
updateAuditLogDestination
@PostMapping(path="/audit-log-destinations/connection/{connectionName}") public VoidResponse updateAuditLogDestination(@PathVariable String serverName, @PathVariable String connectionName, @RequestBody Connection connection) Update an audit log destination that is identified with the supplied destination name with the supplied connection object.- Parameters:
serverName- local server name.connectionName- name of the audit log destination connection to be updatedconnection- connection object that defines the audit log destination- Returns:
- void response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName parameter.
-
clearAuditLogDestination
@DeleteMapping(path="/audit-log-destinations/connection/{connectionName}") public VoidResponse clearAuditLogDestination(@PathVariable String serverName, @PathVariable String connectionName) Delete an audit log destination that is identified with the supplied connection's name.- Parameters:
serverName- local server name.connectionName- qualified name of the audit log destination connection to be deleted.- Returns:
- void response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName.
-
addStartUpOpenMetadataArchiveFile
@PostMapping(path="/open-metadata-archives/file") public VoidResponse addStartUpOpenMetadataArchiveFile(@PathVariable String serverName, @RequestBody String fileName) Add a new open metadata archive to load at startup. This open metadata archive is a JSON file.- Parameters:
serverName- local server name.fileName- name of the open metadata archive file.- Returns:
- void response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName or fileName parameter.
-
setNoRepositoryMode
@DeleteMapping(path="/local-repository") public VoidResponse setNoRepositoryMode(@PathVariable String serverName) Remove all configuration for a local repository. The default is no local repository. This call can be used to remove subsequent local repository configuration.- Parameters:
serverName- local server name.- Returns:
- void response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName or localRepositoryMode parameter.
-
setInMemLocalRepository
@PostMapping(path="/local-repository/mode/in-memory-repository") public VoidResponse setInMemLocalRepository(@PathVariable String serverName, @RequestBody(required=false) NullRequestBody requestBody) Set up an in memory local repository. This repository uses hashmaps to store content. It is useful for demos, testing and POCs.- Parameters:
serverName- local server name.requestBody- null request body- Returns:
- void response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName or localRepositoryMode parameter.
-
setPostgresLocalRepository
@PostMapping(path="/local-repository/mode/postgres-repository") public VoidResponse setPostgresLocalRepository(@PathVariable String serverName, @RequestBody(required=false) Map<String, Object> storageProperties) Set up a PostgreSQL database schema as the local repository.- Parameters:
serverName- local server name.storageProperties- properties used to configure access to postgres- Returns:
- void response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or OMAGConfigurationErrorException the event bus has not been configured or InvalidParameterException invalid serverName or localRepositoryMode parameter.
-
setReadOnlyLocalRepository
@PostMapping(path="/local-repository/mode/read-only-repository") public VoidResponse setReadOnlyLocalRepository(@PathVariable String serverName) Set up a read only local repository.- Parameters:
serverName- local server name.- Returns:
- void response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or OMAGConfigurationErrorException the event bus has not been configured or InvalidParameterException invalid serverName or localRepositoryMode parameter.
-
setPluginRepositoryConnection
@PostMapping(path="/local-repository/mode/plugin-repository/connection") public VoidResponse setPluginRepositoryConnection(@PathVariable String serverName, @RequestBody Connection connection) Provide the connection to the local repository - used when the local repository mode is set to plugin repository.- Parameters:
serverName- local server name.connection- connection to the OMRS repository connector.- Returns:
- void response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName or repositoryProxyConnection parameter or OMAGConfigurationErrorException the local repository mode has not been set
-
setPluginRepositoryConnection
@PostMapping(path="/local-repository/mode/plugin-repository/details") public VoidResponse setPluginRepositoryConnection(@PathVariable String serverName, @RequestParam String connectorProvider, @RequestBody(required=false) Map<String, Object> additionalProperties) Provide the connection to the local repository - used when the local repository mode is set to plugin repository.- Parameters:
serverName- local server name.connectorProvider- connector provider class name to the OMRS repository connector.additionalProperties- additional parameters to pass to the repository connector- Returns:
- void response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName or repositoryProxyConnection parameter or OMAGConfigurationErrorException the local repository mode has not been set.
-
setRepositoryProxyConnection
@PostMapping(path="/local-repository/mode/repository-proxy/connection") public VoidResponse setRepositoryProxyConnection(@PathVariable String serverName, @RequestBody Connection connection) Provide the connection to the local repository - used when the local repository mode is set to repository proxy.- Parameters:
serverName- local server name.connection- connection to the OMRS repository connector.- Returns:
- void response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName or repositoryProxyConnection parameter or OMAGConfigurationErrorException the local repository mode has not been set
-
setRepositoryProxyConnection
@PostMapping(path="/local-repository/mode/repository-proxy/details") public VoidResponse setRepositoryProxyConnection(@PathVariable String serverName, @RequestParam String connectorProvider, @RequestBody(required=false) Map<String, Object> additionalProperties) Provide the connection to the local repository - used when the local repository mode is set to repository proxy.- Parameters:
serverName- local server name.connectorProvider- connector provider class name to the OMRS repository connector.additionalProperties- additional parameters to pass to the repository connector- Returns:
- void response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName or repositoryProxyConnection parameter or OMAGConfigurationErrorException the local repository mode has not been set.
-
setRepositoryProxyEventMapper
@PostMapping(path="/local-repository/event-mapper-connection") public VoidResponse setRepositoryProxyEventMapper(@PathVariable String serverName, @RequestBody Connection connection) Provide the connection to a repository proxy's event mapper. The default value is null which means no event mapper. An event mapper is needed if the local repository has additional APIs that can change the metadata in the repository without going through the open metadata and governance services.- Parameters:
serverName- local server name.connection- connection to the OMRS repository event mapper.- Returns:
- void response UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName or localRepositoryEventMapper parameter or OMAGConfigurationErrorException the local repository mode, or the event mapper has not been set
-
setRepositoryProxyEventMapper
@PostMapping(path="/local-repository/event-mapper-details") public VoidResponse setRepositoryProxyEventMapper(@PathVariable String serverName, @RequestParam String connectorProvider, @RequestParam String eventSource, @RequestBody(required=false) Map<String, Object> additionalProperties) Provide the connection to a repository proxy's event mapper. The default value is null which means no event mapper. An event mapper is needed if the local repository has additional APIs that can change the metadata in the repository without going through the open metadata and governance services.- Parameters:
serverName- local server name.connectorProvider- Java class name of the connector provider for the OMRS repository event mapper.eventSource- topic name or URL to the native event source.additionalProperties- additional properties for the event mapper connection- Returns:
- void response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName or localRepositoryEventMapper parameter or OMAGConfigurationErrorException the local repository mode has not been set.
-
getLocalMetadataCollectionName
@GetMapping(path="/local-repository/metadata-collection-name") public StringResponse getLocalMetadataCollectionName(@PathVariable String serverName) Return the local metadata collection name. If the local repository is not configured then the invalid parameter exception is returned.- Parameters:
serverName- local server name.- Returns:
- guid response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName or name parameter or OMAGConfigurationErrorException the event bus is not set.
-
setLocalMetadataCollectionName
@PostMapping(path="/local-repository/metadata-collection-name/{name}") public VoidResponse setLocalMetadataCollectionName(@PathVariable String serverName, @PathVariable String name) Set up the local metadata collection name. If this is not set then the default value is the local server name.- Parameters:
serverName- local server name.name- metadata collection name.- Returns:
- void response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName or name parameter or OMAGConfigurationErrorException the event bus is not set.
-
getLocalMetadataCollectionId
@GetMapping(path="/local-repository/metadata-collection-id") public GUIDResponse getLocalMetadataCollectionId(@PathVariable String serverName) Return the local metadata collection id. If the local repository is not configured then the invalid parameter exception is returned.- Parameters:
serverName- local server name.- Returns:
- guid response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName or name parameter or OMAGConfigurationErrorException the event bus is not set.
-
setLocalMetadataCollectionId
@PostMapping(path="/local-repository/metadata-collection-id") public VoidResponse setLocalMetadataCollectionId(@PathVariable String serverName, @RequestBody String metadataCollectionId) Set up the local metadata collection id. If the local repository is not configured then the invalid parameter exception is returned.- Parameters:
serverName- local server name.metadataCollectionId- new identifier for the local repository's metadata collection- Returns:
- void or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName or name parameter or OMAGConfigurationErrorException the event bus is not set.
-
addCohortRegistration
@PostMapping(path="/cohorts/{cohortName}") public VoidResponse addCohortRegistration(@PathVariable String serverName, @PathVariable String cohortName, @RequestBody(required=false) Map<String, Object> additionalProperties) Enable registration of server to an open metadata repository cohort using the default topic structure (DEDICATED_TOPICS). A cohort is a group of open metadata repositories that are sharing metadata. An OMAG server can connect to zero, one or more cohorts. Each cohort needs a unique name. The members of the cohort use a shared topic to exchange registration information and events related to the changes in their supported metadata types and instances. They are also able to query each other's metadata directly through REST calls.- Parameters:
serverName- local server name.cohortName- name of the cohort.additionalProperties- additional properties for the event bus connection- Returns:
- void response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName, cohortName or serviceMode parameter or OMAGConfigurationErrorException the event bus is not set.
-
addCohortRegistration
@PostMapping(path="/cohorts/{cohortName}/topic-structure/{cohortTopicStructure}") public VoidResponse addCohortRegistration(@PathVariable String serverName, @PathVariable String cohortName, @PathVariable CohortTopicStructure cohortTopicStructure, @RequestBody(required=false) Map<String, Object> additionalProperties) Enable registration of server to an open metadata repository cohort using the topic pattern specified by cohortTopicStructure. A cohort is a group of open metadata repositories that are sharing metadata. An OMAG server can connect to zero, one or more cohorts. Each cohort needs a unique name. The members of the cohort use a shared topic to exchange registration information and events related to the changes in their supported metadata types and instances. They are also able to query each other's metadata directly through REST calls.- Parameters:
serverName- local server name.cohortName- name of the cohort.cohortTopicStructure- the style of cohort topic set up to useadditionalProperties- additional properties for the event bus connection- Returns:
- void response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName, cohortName or serviceMode parameter or OMAGConfigurationErrorException the event bus is not set.
-
getCohortConfig
@GetMapping(path="/cohorts/{cohortName}") public CohortConfigResponse getCohortConfig(@PathVariable String serverName, @PathVariable String cohortName) Retrieve the registration of server to an open metadata repository cohort. This is a group of open metadata repositories that are sharing metadata. An OMAG server can connect to zero, one or more cohorts. Each cohort needs a unique name. The members of the cohort use a shared topic to exchange registration information and events related to the changes in their supported metadata types and instances. They are also able to query each other's metadata directly through REST calls.- Parameters:
serverName- local server name.cohortName- name of the cohort.- Returns:
- cohort config response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName, cohortName or serviceMode parameter or OMAGConfigurationErrorException the event bus is not set.
-
getCohortTopicName
@GetMapping(path="/cohorts/{cohortName}/topic-name") public StringResponse getCohortTopicName(@PathVariable String serverName, @PathVariable String cohortName) Retrieve the current topic name for the cohort. This call can only be made once the cohort is set up with enableCohortRegistration().- Parameters:
serverName- local server name.cohortName- name of the cohort.- Returns:
- string name or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName or cohortName parameter or OMAGConfigurationErrorException the cohort is not set up.
-
getDedicatedCohortTopicNames
@GetMapping(path="/cohorts/{cohortName}/dedicated-topic-names") public DedicatedTopicListResponse getDedicatedCohortTopicNames(@PathVariable String serverName, @PathVariable String cohortName) Retrieve the current topic name for the cohort. This call can only be made once the cohort is set up with enableCohortRegistration().- Parameters:
serverName- local server name.cohortName- name of the cohort.- Returns:
- List of topic names - registration first, then types and then instances or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName or cohortName parameter or OMAGConfigurationErrorException the cohort is not set up.
-
overrideCohortTopicName
@PostMapping(path="/cohorts/{cohortName}/topic-name-override") public VoidResponse overrideCohortTopicName(@PathVariable String serverName, @PathVariable String cohortName, @RequestBody String topicName) Override the current name for the single topic for the cohort. This call can only be made once the cohort is set up with enableCohortRegistration().- Parameters:
serverName- local server name.cohortName- name of the cohort.topicName- new name for the topic.- Returns:
- void or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName or cohortName parameter or OMAGConfigurationErrorException the cohort is not set up.
-
overrideRegistrationCohortTopicName
@PostMapping(path="/cohorts/{cohortName}/topic-name-override/registration") public VoidResponse overrideRegistrationCohortTopicName(@PathVariable String serverName, @PathVariable String cohortName, @RequestBody String topicName) Override the current name for the registration topic for the cohort. This call can only be made once the cohort is set up with enableCohortRegistration().- Parameters:
serverName- local server name.cohortName- name of the cohort.topicName- new name for the topic.- Returns:
- void or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName or cohortName parameter or OMAGConfigurationErrorException the cohort is not set up.
-
overrideTypesCohortTopicName
@PostMapping(path="/cohorts/{cohortName}/topic-name-override/types") public VoidResponse overrideTypesCohortTopicName(@PathVariable String serverName, @PathVariable String cohortName, @RequestBody String topicName) Override the current name for the "types" topic for the cohort. This call can only be made once the cohort is set up with enableCohortRegistration().- Parameters:
serverName- local server name.cohortName- name of the cohort.topicName- new name for the topic.- Returns:
- void or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName or cohortName parameter or OMAGConfigurationErrorException the cohort is not set up.
-
overrideInstancesCohortTopicName
@PostMapping(path="/cohorts/{cohortName}/topic-name-override/instances") public VoidResponse overrideInstancesCohortTopicName(@PathVariable String serverName, @PathVariable String cohortName, @RequestBody String topicName) Override the current name for the "instances" topic for the cohort. This call can only be made once the cohort is set up with enableCohortRegistration().- Parameters:
serverName- local server name.cohortName- name of the cohort.topicName- new name for the topic.- Returns:
- void or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName or cohortName parameter or OMAGConfigurationErrorException the cohort is not set up.
-
clearCohortConfig
@DeleteMapping(path="/cohorts/{cohortName}") public VoidResponse clearCohortConfig(@PathVariable String serverName, @PathVariable String cohortName) Unregister this server from an open metadata repository cohort.- Parameters:
serverName- local server name.cohortName- name of the cohort.- Returns:
- void response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName, cohortName or serviceMode parameter.
-
setAuditLogDestinations
@PostMapping(path="/audit-log-destinations") public VoidResponse setAuditLogDestinations(@PathVariable String serverName, @RequestBody List<Connection> auditLogDestinations) Set up the list of audit log destinations. These destinations are expressed as Connection objects to the connectors that will handle the audit log records.- Parameters:
serverName- local server name.auditLogDestinations- list of connection objects- Returns:
- void response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName.
-
getAuditLogDestinations
@GetMapping(path="/audit-log-destinations") public ConnectionListResponse getAuditLogDestinations(@PathVariable String serverName) Set up the list of audit log destinations. These destinations are expressed as Connection objects to the connectors that will handle the audit log records.- Parameters:
serverName- local server name.- Returns:
- connection list response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName.
-
clearAuditLogDestinations
@DeleteMapping(path="/audit-log-destinations") public VoidResponse clearAuditLogDestinations(@PathVariable String serverName) Clears all audit log destinations for this server.- Parameters:
serverName- local server name.- Returns:
- void response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName or localRepositoryMode parameter.
-
setOpenMetadataArchives
@PostMapping(path="/open-metadata-archives") public VoidResponse setOpenMetadataArchives(@PathVariable String serverName, @RequestBody List<Connection> openMetadataArchives) Set up the list of open metadata archives. These are open metadata types and instances that are loaded at repository start up.- Parameters:
serverName- local server name.openMetadataArchives- list of connection objects- Returns:
- void response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName.
-
getOpenMetadataArchives
@GetMapping(path="/open-metadata-archives") public ConnectionListResponse getOpenMetadataArchives(@PathVariable String serverName) Return the list of open metadata archives. These are open metadata types and instances that are loaded at repository start up.- Parameters:
serverName- local server name.- Returns:
- connection list response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName.
-
clearOpenMetadataArchives
@DeleteMapping(path="/open-metadata-archives") public VoidResponse clearOpenMetadataArchives(@PathVariable String serverName) Clear the list of open metadata archives. These are the open metadata types and instances that are loaded at repository start up.- Parameters:
serverName- local server name.- Returns:
- void response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName.
-
setLocalRepositoryConfig
@PostMapping(path="/local-repository/configuration") public VoidResponse setLocalRepositoryConfig(@PathVariable String serverName, @RequestBody LocalRepositoryConfig localRepositoryConfig) Set up the configuration for the local repository. This overrides the current values.- Parameters:
serverName- local server name.localRepositoryConfig- configuration properties for the local repository.- Returns:
- void response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName or localRepositoryConfig parameter.
-
getLocalRepositoryConfig
@GetMapping(path="/local-repository/configuration") public LocalRepositoryConfigResponse getLocalRepositoryConfig(@PathVariable String serverName) Return the configuration for the local repository.- Parameters:
serverName- local server name.- Returns:
- local repository response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName or localRepositoryConfig parameter.
-
clearLocalRepositoryConfig
@DeleteMapping(path="/local-repository/configuration") public VoidResponse clearLocalRepositoryConfig(@PathVariable String serverName) Remove all configuration for a local repository. The default is no local repository. This call can be used to remove subsequent local repository configuration.- Parameters:
serverName- local server name.- Returns:
- void response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName or localRepositoryMode parameter.
-
resetRemoteCohortURL
@PostMapping(path="/local-repository/configuration/remote-repository-connector-url") public VoidResponse resetRemoteCohortURL(@PathVariable String serverName, @RequestBody URLRequestBody requestBody) Update the URL broadcast across the cohort to allow other members to issue queries to this repository. This method is needed to reconfigure a server that has moved from one platform to another. Once the URL is updated, and the server restarted, it will broadcast its new URL to the rest of the cohort.- Parameters:
serverName- local server name.requestBody- String url.- Returns:
- void response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName or serverURLRoot parameter.
-
setCohortConfig
@PostMapping(path="/cohorts/{cohortName}/configuration") public VoidResponse setCohortConfig(@PathVariable String serverName, @PathVariable String cohortName, @RequestBody CohortConfig cohortConfig) Set up the configuration properties for a cohort. This may reconfigure an existing cohort or create a cohort. Use setCohortMode to delete a cohort.- Parameters:
serverName- local server namecohortName- name of the cohortcohortConfig- configuration for the cohort- Returns:
- void response or UserNotAuthorizedException the supplied userId is not authorized to issue this command or InvalidParameterException invalid serverName, cohortName or cohortConfig parameter.
-