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, String delegatingUserId, Connection connection) Add an audit log destination that is defined by the supplied connection object.addCohortRegistration(String serverName, String cohortName, String delegatingUserId, Map<String, Object> additionalProperties) Enable registration of server to an open metadata repository cohort using the default topic structure (DEDICATED_TOPICS).addConsoleAuditLogDestination(String serverName, String delegatingUserId, List<String> supportedSeverities) Set up the console audit log for the server.addEventTopicAuditLogDestination(String serverName, String delegatingUserId, 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 delegatingUserId, String directoryName, List<String> supportedSeverities) Add an audit log destination that creates log records as JSON files in a shared directory.addPostgreSQLDatabaseAuditLogDestination(String serverName, String delegatingUserId, Map<String, Object> storageProperties) Add an audit log destination that creates log records as rows in a PostgreSQL Database Schema.addSLF4JAuditLogDestination(String serverName, String delegatingUserId, List<String> supportedSeverities) Add an audit log destination that creates slf4j records.addStartUpOpenMetadataArchiveFile(String serverName, String delegatingUserId, String fileName) Add a new open metadata archive to load at startup.clearAuditLogDestination(String serverName, String connectionName, String delegatingUserId) Delete an audit log destination that is identified with the supplied connection's name.clearAuditLogDestinations(String serverName, String delegatingUserId) Clears all audit log destinations for this server.clearCohortConfig(String serverName, String cohortName, String delegatingUserId) Unregister this server from an open metadata repository cohort.clearLocalRepositoryConfig(String serverName, String delegatingUserId) Remove all configuration for a local repository.clearOpenMetadataArchives(String serverName, String delegatingUserId) Clear the list of open metadata archives.getAuditLogDestinations(String serverName, String delegatingUserId) Set up the list of audit log destinations.getCohortConfig(String serverName, String cohortName, String delegatingUserId) Retrieve the registration of server to an open metadata repository cohort.getDedicatedCohortTopicNames(String serverName, String cohortName, String delegatingUserId) Retrieve the current topic name for the cohort.getLocalMetadataCollectionId(String serverName, String delegatingUserId) Return the local metadata collection id.getLocalMetadataCollectionName(String serverName, String delegatingUserId) Return the local metadata collection name.getLocalRepositoryConfig(String serverName, String delegatingUserId) Return the configuration for the local repository.getOpenMetadataArchives(String serverName, String delegatingUserId) Return the list of open metadata archives.overrideInstancesCohortTopicName(String serverName, String cohortName, String delegatingUserId, String topicName) Override the current name for the "instances" topic for the cohort.overrideRegistrationCohortTopicName(String serverName, String cohortName, String delegatingUserId, String topicName) Override the current name for the registration topic for the cohort.overrideTypesCohortTopicName(String serverName, String cohortName, String delegatingUserId, String topicName) Override the current name for the "types" topic for the cohort.resetRemoteCohortURL(String serverName, String delegatingUserId, URLRequestBody requestBody) Update the URL broadcast across the cohort to allow other members to issue queries to this repository.setAuditLogDestinations(String serverName, String delegatingUserId, List<Connection> auditLogDestinations) Set up the list of audit log destinations.setCohortConfig(String serverName, String cohortName, String delegatingUserId, CohortConfig cohortConfig) Set up the configuration properties for a cohort.setDefaultAuditLog(String serverName, String delegatingUserId, NullRequestBody requestBody) Set up the default audit log for the server.setInMemLocalRepository(String serverName, String delegatingUserId, NullRequestBody requestBody) Set up an in memory local repository.setLocalMetadataCollectionId(String serverName, String delegatingUserId, String metadataCollectionId) Set up the local metadata collection id.setLocalMetadataCollectionName(String serverName, String name, String delegatingUserId) Set up the local metadata collection name.setLocalRepositoryConfig(String serverName, String delegatingUserId, LocalRepositoryConfig localRepositoryConfig) Set up the configuration for the local repository.setNoRepositoryMode(String serverName, String delegatingUserId) Remove all configuration for a local repository.setOpenMetadataArchives(String serverName, String delegatingUserId, List<Connection> openMetadataArchives) Set up the list of open metadata archives.setPluginRepositoryConnection(String serverName, String delegatingUserId, 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, String delegatingUserId, Connection connection) Provide the connection to the local repository - used when the local repository mode is set to plugin repository.setPostgresLocalRepository(String serverName, String delegatingUserId, Map<String, Object> storageProperties) Set up a PostgreSQL database schema as the local repository.setReadOnlyLocalRepository(String serverName, String delegatingUserId) Set up a read only local repository.setRepositoryProxyConnection(String serverName, String delegatingUserId, 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, String delegatingUserId, Connection connection) Provide the connection to the local repository - used when the local repository mode is set to repository proxy.setRepositoryProxyEventMapper(String serverName, String delegatingUserId, String connectorProvider, String eventSource, Map<String, Object> additionalProperties) Provide the connection to a repository proxy's event mapper.setRepositoryProxyEventMapper(String serverName, String delegatingUserId, Connection connection) Provide the connection to a repository proxy's event mapper.updateAuditLogDestination(String serverName, String connectionName, String delegatingUserId, 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, @RequestParam(required=false) String delegatingUserId, @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.delegatingUserId- external userId making requestrequestBody- 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, @RequestParam(required=false) String delegatingUserId, @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.delegatingUserId- external userId making requestsupportedSeverities- 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, @RequestParam(required=false) String delegatingUserId, @RequestBody List<String> supportedSeverities) Add an audit log destination that creates slf4j records.- Parameters:
serverName- local server name.delegatingUserId- external userId making requestsupportedSeverities- 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 delegatingUserId, @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.delegatingUserId- external userId making requestdirectoryName- 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, @RequestParam(required=false) String delegatingUserId, @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.delegatingUserId- external userId making requeststorageProperties- 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 delegatingUserId, @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.delegatingUserId- external userId making requesttopicName- 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, @RequestParam(required=false) String delegatingUserId, @RequestBody Connection connection) Add an audit log destination that is defined by the supplied connection object.- Parameters:
serverName- local server name.delegatingUserId- external userId making requestconnection- 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, @RequestParam(required=false) String delegatingUserId, @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.delegatingUserId- external userId making requestconnectionName- 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, @RequestParam(required=false) String delegatingUserId) Delete an audit log destination that is identified with the supplied connection's name.- Parameters:
serverName- local server name.delegatingUserId- external userId making requestconnectionName- 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, @RequestParam(required=false) String delegatingUserId, @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.delegatingUserId- external userId making requestfileName- 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, @RequestParam(required=false) String delegatingUserId) 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.delegatingUserId- external userId making request- 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, @RequestParam(required=false) String delegatingUserId, @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.delegatingUserId- external userId making requestrequestBody- 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, @RequestParam(required=false) String delegatingUserId, @RequestBody(required=false) Map<String, Object> storageProperties) Set up a PostgreSQL database schema as the local repository.- Parameters:
serverName- local server name.delegatingUserId- external userId making requeststorageProperties- 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, @RequestParam(required=false) String delegatingUserId) Set up a read only local repository.- Parameters:
serverName- local server name.delegatingUserId- external userId making request- 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, @RequestParam(required=false) String delegatingUserId, @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.delegatingUserId- external userId making requestconnection- 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(required=false) String delegatingUserId, @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.delegatingUserId- external userId making requestconnectorProvider- 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, @RequestParam(required=false) String delegatingUserId, @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.delegatingUserId- external userId making requestconnection- 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(required=false) String delegatingUserId, @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.delegatingUserId- external userId making requestconnectorProvider- 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, @RequestParam(required=false) String delegatingUserId, @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.delegatingUserId- external userId making requestconnection- 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(required=false) String delegatingUserId, @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.delegatingUserId- external userId making requestconnectorProvider- 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, @RequestParam(required=false) String delegatingUserId) 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.delegatingUserId- external userId making request- 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, @RequestParam(required=false) String delegatingUserId) 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.delegatingUserId- external userId making requestname- 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, @RequestParam(required=false) String delegatingUserId) 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.delegatingUserId- external userId making request- 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, @RequestParam(required=false) String delegatingUserId, @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.delegatingUserId- external userId making requestmetadataCollectionId- 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, @RequestParam(required=false) String delegatingUserId, @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.delegatingUserId- external userId making requestcohortName- 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.
-
getCohortConfig
@GetMapping(path="/cohorts/{cohortName}") public CohortConfigResponse getCohortConfig(@PathVariable String serverName, @PathVariable String cohortName, @RequestParam(required=false) String delegatingUserId) 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.delegatingUserId- external userId making requestcohortName- 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.
-
getDedicatedCohortTopicNames
@GetMapping(path="/cohorts/{cohortName}/topic-names") public DedicatedTopicListResponse getDedicatedCohortTopicNames(@PathVariable String serverName, @PathVariable String cohortName, @RequestParam(required=false) String delegatingUserId) 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.delegatingUserId- external userId making requestcohortName- 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.
-
overrideRegistrationCohortTopicName
@PostMapping(path="/cohorts/{cohortName}/topic-name-override/registration") public VoidResponse overrideRegistrationCohortTopicName(@PathVariable String serverName, @PathVariable String cohortName, @RequestParam(required=false) String delegatingUserId, @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.delegatingUserId- external userId making requestcohortName- 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, @RequestParam(required=false) String delegatingUserId, @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.delegatingUserId- external userId making requestcohortName- 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, @RequestParam(required=false) String delegatingUserId, @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.delegatingUserId- external userId making requestcohortName- 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, @RequestParam(required=false) String delegatingUserId) Unregister this server from an open metadata repository cohort.- Parameters:
serverName- local server name.delegatingUserId- external userId making requestcohortName- 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, @RequestParam(required=false) String delegatingUserId, @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.delegatingUserId- external userId making requestauditLogDestinations- 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, @RequestParam(required=false) String delegatingUserId) 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.delegatingUserId- external userId making request- 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, @RequestParam(required=false) String delegatingUserId) Clears all audit log destinations for this server.- Parameters:
serverName- local server name.delegatingUserId- external userId making request- 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, @RequestParam(required=false) String delegatingUserId, @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.delegatingUserId- external userId making requestopenMetadataArchives- 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, @RequestParam(required=false) String delegatingUserId) 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.delegatingUserId- external userId making request- 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, @RequestParam(required=false) String delegatingUserId) 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.delegatingUserId- external userId making request- 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, @RequestParam(required=false) String delegatingUserId, @RequestBody LocalRepositoryConfig localRepositoryConfig) Set up the configuration for the local repository. This overrides the current values.- Parameters:
serverName- local server name.delegatingUserId- external userId making requestlocalRepositoryConfig- 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, @RequestParam(required=false) String delegatingUserId) Return the configuration for the local repository.- Parameters:
serverName- local server name.delegatingUserId- external userId making request- 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, @RequestParam(required=false) String delegatingUserId) 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.delegatingUserId- external userId making request- 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, @RequestParam(required=false) String delegatingUserId, @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.delegatingUserId- external userId making requestrequestBody- 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, @RequestParam(required=false) String delegatingUserId, @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 namedelegatingUserId- external userId making requestcohortName- 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.
-