Package org.odpi.openmetadata.frameworkservices.gaf.server.spring

Class GovernanceConfigurationResource

java.lang.Object
org.odpi.openmetadata.frameworkservices.gaf.server.spring.GovernanceConfigurationResource
@RestController @RequestMapping("/servers/{serverName}/open-metadata/framework-services/{serviceURLMarker}/governance-configuration-service/users/{userId}") public class GovernanceConfigurationResource extends Object
EngineConfigurationResource provides the Spring wrapper for the Governance Engine Configuration Services

  • Constructor Summary

    Constructors
    Constructor
    Description
    GovernanceConfigurationResource()
     

  • Method Summary

    Modifier and Type
    Method
    Description
    org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse
    addCatalogTarget(String serverName, String serviceURLMarker, String userId, String integrationConnectorGUID, String metadataElementGUID, org.odpi.openmetadata.frameworks.governanceaction.properties.CatalogTargetProperties requestBody)
    Add a catalog target to an integration connector.
    org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse
    createGovernanceEngine(String serverName, String serviceURLMarker, String userId, String typeName, org.odpi.openmetadata.frameworkservices.gaf.rest.NewGovernanceEngineRequestBody requestBody)
    Create a new governance engine definition.
    org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse
    createGovernanceService(String serverName, String serviceURLMarker, String userId, String typeName, org.odpi.openmetadata.frameworkservices.gaf.rest.NewGovernanceServiceRequestBody requestBody)
    Create a governance service definition.
    org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse
    createIntegrationConnector(String serverName, String serviceURLMarker, String userId, org.odpi.openmetadata.frameworks.governanceaction.properties.IntegrationConnectorProperties requestBody)
    Create an integration connector definition.
    org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse
    createIntegrationGroup(String serverName, String serviceURLMarker, String userId, org.odpi.openmetadata.frameworks.governanceaction.properties.IntegrationGroupProperties requestBody)
    Create a new integration group definition.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    deleteGovernanceEngine(String serverName, String serviceURLMarker, String userId, String guid, org.odpi.openmetadata.commonservices.ffdc.rest.DeleteRequestBody requestBody)
    Remove the properties of the governance engine.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    deleteGovernanceService(String serverName, String serviceURLMarker, String userId, String guid, org.odpi.openmetadata.commonservices.ffdc.rest.DeleteRequestBody requestBody)
    Remove the properties of the governance service.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    deleteIntegrationConnector(String serverName, String serviceURLMarker, String userId, String guid, org.odpi.openmetadata.commonservices.ffdc.rest.DeleteRequestBody requestBody)
    Remove the properties of the integration connector.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    deleteIntegrationGroup(String serverName, String serviceURLMarker, String userId, String guid, org.odpi.openmetadata.commonservices.ffdc.rest.DeleteRequestBody requestBody)
    Remove the properties of the integration group.
    org.odpi.openmetadata.frameworkservices.gaf.rest.GovernanceEngineElementsResponse
    getAllGovernanceEngines(String serverName, String serviceURLMarker, String userId, int startingFrom, int maximumResults)
    Return the list of governance engine definitions that are stored.
    org.odpi.openmetadata.frameworkservices.gaf.rest.GovernanceServiceElementsResponse
    getAllGovernanceServices(String serverName, String serviceURLMarker, String userId, int startingFrom, int maximumResults)
    Return the list of governance services definitions that are stored.
    org.odpi.openmetadata.frameworkservices.gaf.rest.IntegrationConnectorElementsResponse
    getAllIntegrationConnectors(String serverName, String serviceURLMarker, String userId, int startingFrom, int maximumResults)
    Return the list of integration connectors definitions that are stored.
    org.odpi.openmetadata.frameworkservices.gaf.rest.IntegrationGroupElementsResponse
    getAllIntegrationGroups(String serverName, String serviceURLMarker, String userId, int startingFrom, int maximumResults)
    Return the list of integration group definitions that are stored.
    org.odpi.openmetadata.frameworkservices.gaf.rest.CatalogTargetResponse
    getCatalogTarget(String serverName, String serviceURLMarker, String userId, String relationshipGUID)
    Retrieve a specific catalog target associated with an integration connector.
    org.odpi.openmetadata.frameworkservices.gaf.rest.CatalogTargetsResponse
    getCatalogTargets(String serverName, String serviceURLMarker, String userId, String integrationConnectorGUID, int startingFrom, int maximumResults)
    Retrieve the details of the metadata elements identified as catalog targets with an integration connector.
    org.odpi.openmetadata.frameworkservices.gaf.rest.GovernanceEngineElementResponse
    getGovernanceEngineByGUID(String serverName, String serviceURLMarker, String userId, String guid)
    Return the properties from a governance engine definition.
    org.odpi.openmetadata.frameworkservices.gaf.rest.GovernanceEngineElementResponse
    getGovernanceEngineByName(String serverName, String serviceURLMarker, String userId, org.odpi.openmetadata.commonservices.ffdc.rest.NameRequestBody name)
    Return the properties from the named governance engine definition.
    org.odpi.openmetadata.frameworkservices.gaf.rest.GovernanceServiceElementResponse
    getGovernanceServiceByGUID(String serverName, String serviceURLMarker, String userId, String guid)
    Return the properties from a governance service definition.
    org.odpi.openmetadata.frameworkservices.gaf.rest.GovernanceServiceElementResponse
    getGovernanceServiceByName(String serverName, String serviceURLMarker, String userId, org.odpi.openmetadata.commonservices.ffdc.rest.NameRequestBody requestBody)
    Return the properties from a governance service definition.
    org.odpi.openmetadata.commonservices.ffdc.rest.GUIDListResponse
    getGovernanceServiceRegistrations(String serverName, String serviceURLMarker, String userId, String guid)
    Return the list of governance engines that a specific governance service is registered with.
    org.odpi.openmetadata.frameworkservices.gaf.rest.IntegrationConnectorElementResponse
    getIntegrationConnectorByGUID(String serverName, String serviceURLMarker, String userId, String guid)
    Return the properties from an integration connector definition.
    org.odpi.openmetadata.frameworkservices.gaf.rest.IntegrationConnectorElementResponse
    getIntegrationConnectorByName(String serverName, String serviceURLMarker, String userId, String name)
    Return the properties from an integration connector definition.
    org.odpi.openmetadata.commonservices.ffdc.rest.GUIDListResponse
    getIntegrationConnectorRegistrations(String serverName, String serviceURLMarker, String userId, String guid)
    Return the list of integration groups that a specific integration connector is registered with.
    org.odpi.openmetadata.frameworkservices.gaf.rest.IntegrationGroupElementResponse
    getIntegrationGroupByGUID(String serverName, String serviceURLMarker, String userId, String guid)
    Return the properties from an integration group definition.
    org.odpi.openmetadata.frameworkservices.gaf.rest.IntegrationGroupElementResponse
    getIntegrationGroupByName(String serverName, String serviceURLMarker, String userId, String name)
    Return the properties from an integration group definition.
    org.odpi.openmetadata.frameworkservices.gaf.rest.RegisteredGovernanceServiceResponse
    getRegisteredGovernanceService(String serverName, String serviceURLMarker, String userId, String governanceEngineGUID, String governanceServiceGUID)
    Retrieve a specific governance service registered with a governance engine.
    org.odpi.openmetadata.frameworkservices.gaf.rest.RegisteredGovernanceServicesResponse
    getRegisteredGovernanceServices(String serverName, String serviceURLMarker, String userId, String governanceEngineGUID, int startingFrom, int maximumResults)
    Retrieve the identifiers of the governance services registered with a governance engine.
    org.odpi.openmetadata.frameworkservices.gaf.rest.RegisteredIntegrationConnectorResponse
    getRegisteredIntegrationConnector(String serverName, String serviceURLMarker, String userId, String integrationGroupGUID, String integrationConnectorGUID)
    Retrieve a specific integration connector registered with an integration group.
    org.odpi.openmetadata.frameworkservices.gaf.rest.RegisteredIntegrationConnectorsResponse
    getRegisteredIntegrationConnectors(String serverName, String serviceURLMarker, String userId, String integrationGroupGUID, int startingFrom, int maximumResults)
    Retrieve the details of the integration connectors registered with an integration group.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    registerGovernanceServiceWithEngine(String serverName, String serviceURLMarker, String userId, String guid, org.odpi.openmetadata.frameworkservices.gaf.rest.GovernanceServiceRegistrationRequestBody requestBody)
    Register a governance service with a specific governance engine.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    registerIntegrationConnectorWithGroup(String serverName, String serviceURLMarker, String userId, String integrationGroupGUID, String integrationConnectorGUID, org.odpi.openmetadata.frameworks.governanceaction.properties.RegisteredIntegrationConnectorProperties requestBody)
    Register an integration connector with a specific integration group.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    removeCatalogTarget(String serverName, String serviceURLMarker, String userId, String relationshipGUID, org.odpi.openmetadata.commonservices.ffdc.rest.NullRequestBody requestBody)
    Unregister a catalog target from the integration connector.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    unregisterGovernanceServiceFromEngine(String serverName, String serviceURLMarker, String userId, String governanceEngineGUID, String governanceServiceGUID, org.odpi.openmetadata.commonservices.ffdc.rest.NullRequestBody requestBody)
    Unregister a governance service from the governance engine.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    unregisterIntegrationConnectorFromGroup(String serverName, String serviceURLMarker, String userId, String integrationGroupGUID, String integrationConnectorGUID, org.odpi.openmetadata.commonservices.ffdc.rest.NullRequestBody requestBody)
    Unregister an integration connector from the integration group.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    updateCatalogTarget(String serverName, String serviceURLMarker, String userId, String relationshipGUID, org.odpi.openmetadata.frameworks.governanceaction.properties.CatalogTargetProperties requestBody)
    Update a catalog target for an integration connector.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    updateGovernanceEngine(String serverName, String serviceURLMarker, String userId, String guid, org.odpi.openmetadata.frameworkservices.gaf.rest.UpdateGovernanceEngineRequestBody requestBody)
    Update the properties of an existing governance engine definition.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    updateGovernanceService(String serverName, String serviceURLMarker, String userId, String guid, org.odpi.openmetadata.frameworkservices.gaf.rest.UpdateGovernanceServiceRequestBody requestBody)
    Update the properties of an existing governance service definition.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    updateIntegrationConnector(String serverName, String serviceURLMarker, String userId, String guid, boolean isMergeUpdate, org.odpi.openmetadata.frameworks.governanceaction.properties.IntegrationConnectorProperties requestBody)
    Update the properties of an existing integration connector definition.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    updateIntegrationGroup(String serverName, String serviceURLMarker, String userId, String guid, boolean isMergeUpdate, org.odpi.openmetadata.frameworks.governanceaction.properties.IntegrationGroupProperties requestBody)
    Update the properties of an existing integration group definition.

    Methods inherited from class java.lang.Object

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

  • Constructor Details

    • GovernanceConfigurationResource

      public GovernanceConfigurationResource()

  • Method Details

    • createGovernanceEngine

      @PostMapping(path="/governance-engines/{typeName}") public org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse createGovernanceEngine(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @PathVariable String typeName, @RequestBody org.odpi.openmetadata.frameworkservices.gaf.rest.NewGovernanceEngineRequestBody requestBody)
      Create a new governance engine definition.
      Parameters:
      serverName - name of the service to route the request to
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user
      typeName - type of governance engine
      requestBody - containing: qualifiedName - unique name for the governance engine; displayName - display name for messages and user interfaces; description - description of the types of governance services that wil be associated with this governance engine.
      Returns:
      unique identifier (guid) of the governance engine definition or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the governance engine definition.

    • getGovernanceEngineByGUID

      @GetMapping(path="/governance-engines/{guid}") public org.odpi.openmetadata.frameworkservices.gaf.rest.GovernanceEngineElementResponse getGovernanceEngineByGUID(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @PathVariable String guid)
      Return the properties from a governance engine definition.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      guid - unique identifier (guid) of the governance engine definition.
      Returns:
      properties from the governance engine definition or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the governance engine definition.

    • getGovernanceEngineByName

      @PostMapping(path="/governance-engines/by-name") public org.odpi.openmetadata.frameworkservices.gaf.rest.GovernanceEngineElementResponse getGovernanceEngineByName(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @RequestBody org.odpi.openmetadata.commonservices.ffdc.rest.NameRequestBody name)
      Return the properties from the named governance engine definition.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      name - qualified name or display name (if unique).
      Returns:
      properties from the governance engine definition or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the governance engine definition.

    • getAllGovernanceEngines

      @GetMapping(path="/governance-engines") public org.odpi.openmetadata.frameworkservices.gaf.rest.GovernanceEngineElementsResponse getAllGovernanceEngines(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @RequestParam int startingFrom, @RequestParam int maximumResults)
      Return the list of governance engine definitions that are stored.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      startingFrom - initial position in the stored list.
      maximumResults - maximum number of definitions to return on this call.
      Returns:
      list of governance engine definitions or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the governance engine definition.

    • updateGovernanceEngine

      @PostMapping(path="/governance-engines/{guid}/update") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse updateGovernanceEngine(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @PathVariable String guid, @RequestBody org.odpi.openmetadata.frameworkservices.gaf.rest.UpdateGovernanceEngineRequestBody requestBody)
      Update the properties of an existing governance engine definition. Use the current value to keep a property value the same, or use the new value. Null means remove the property from the definition.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      guid - unique identifier of the governance engine - used to locate the definition.
      requestBody - containing the new properties of the governance engine.
      Returns:
      void or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the governance engine definition.

    • deleteGovernanceEngine

      @PostMapping(path="/governance-engines/{guid}/delete") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse deleteGovernanceEngine(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @PathVariable String guid, @RequestBody org.odpi.openmetadata.commonservices.ffdc.rest.DeleteRequestBody requestBody)
      Remove the properties of the governance engine. Both the guid and the qualified name is supplied to validate that the correct governance engine is being deleted.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      guid - unique identifier of the governance engine - used to locate the definition.
      requestBody - containing the unique name for the governance engine.
      Returns:
      void or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the governance engine definition.

    • createGovernanceService

      @PostMapping(path="/governance-services/types/{typeName}") public org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse createGovernanceService(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @PathVariable String typeName, @RequestBody org.odpi.openmetadata.frameworkservices.gaf.rest.NewGovernanceServiceRequestBody requestBody)
      Create a governance service definition. The same governance service can be associated with multiple governance engines.
      Parameters:
      serverName - name of the service to route the request to
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user
      typeName - type of governance service
      requestBody - containing: qualifiedName - unique name for the governance service; displayName - display name for the governance service; description - description of the analysis provided by the governance service; connection - connection to instantiate the governance service implementation.
      Returns:
      unique identifier of the governance service or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the governance engine definition.

    • getGovernanceServiceByGUID

      @GetMapping(path="/governance-services/{guid}") public org.odpi.openmetadata.frameworkservices.gaf.rest.GovernanceServiceElementResponse getGovernanceServiceByGUID(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @PathVariable String guid)
      Return the properties from a governance service definition.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      guid - unique identifier (guid) of the governance service definition.
      Returns:
      properties of the governance service or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the governance engine definition.

    • getGovernanceServiceByName

      @GetMapping(path="/governance-services/by-name") public org.odpi.openmetadata.frameworkservices.gaf.rest.GovernanceServiceElementResponse getGovernanceServiceByName(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @RequestBody org.odpi.openmetadata.commonservices.ffdc.rest.NameRequestBody requestBody)
      Return the properties from a governance service definition.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      requestBody - qualified name or display name (if unique).
      Returns:
      properties from the governance engine definition or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the governance engine definition.

    • getAllGovernanceServices

      @GetMapping(path="/governance-services") public org.odpi.openmetadata.frameworkservices.gaf.rest.GovernanceServiceElementsResponse getAllGovernanceServices(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @RequestParam int startingFrom, @RequestParam int maximumResults)
      Return the list of governance services definitions that are stored.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      startingFrom - initial position in the stored list.
      maximumResults - maximum number of definitions to return on this call.
      Returns:
      list of governance service definitions or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the governance engine definition.

    • getGovernanceServiceRegistrations

      @GetMapping(path="/governance-services/{guid}/registrations") public org.odpi.openmetadata.commonservices.ffdc.rest.GUIDListResponse getGovernanceServiceRegistrations(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @PathVariable String guid)
      Return the list of governance engines that a specific governance service is registered with.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      guid - governance service to search for.
      Returns:
      list of governance engine unique identifiers (guids) or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the governance engine definition.

    • updateGovernanceService

      @PostMapping(path="/governance-services/{guid}/update") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse updateGovernanceService(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @PathVariable String guid, @RequestBody org.odpi.openmetadata.frameworkservices.gaf.rest.UpdateGovernanceServiceRequestBody requestBody)
      Update the properties of an existing governance service definition. Use the current value to keep a property value the same, or use the new value. Null means remove the property from the definition.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      guid - unique identifier of the governance service - used to locate the definition.
      requestBody - containing the new parameters for the governance service.
      Returns:
      void or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the governance engine definition.

    • deleteGovernanceService

      @PostMapping(path="/governance-services/{guid}/delete") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse deleteGovernanceService(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @PathVariable String guid, @RequestBody org.odpi.openmetadata.commonservices.ffdc.rest.DeleteRequestBody requestBody)
      Remove the properties of the governance service. Both the guid and the qualified name is supplied to validate that the correct governance service is being deleted. The governance service is also unregistered from its governance engines.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      guid - unique identifier of the governance service - used to locate the definition.
      requestBody - containing the unique name for the governance service.
      Returns:
      void or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the governance engine definition.

    • registerGovernanceServiceWithEngine

      @PostMapping(path="/governance-engines/{guid}/governance-services") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse registerGovernanceServiceWithEngine(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @PathVariable String guid, @RequestBody org.odpi.openmetadata.frameworkservices.gaf.rest.GovernanceServiceRegistrationRequestBody requestBody)
      Register a governance service with a specific governance engine.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      guid - unique identifier of the governance engine.
      requestBody - containing: guid - unique identifier of the governance service; governanceRequestTypes - list of asset governance types that this governance service is able to process.
      Returns:
      void or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the governance engine definition.

    • getRegisteredGovernanceService

      @GetMapping(path="/governance-engines/{governanceEngineGUID}/governance-services/{governanceServiceGUID}") public org.odpi.openmetadata.frameworkservices.gaf.rest.RegisteredGovernanceServiceResponse getRegisteredGovernanceService(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @PathVariable String governanceEngineGUID, @PathVariable String governanceServiceGUID)
      Retrieve a specific governance service registered with a governance engine.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      governanceEngineGUID - unique identifier of the governance engine.
      governanceServiceGUID - unique identifier of the governance service.
      Returns:
      details of the governance service and the asset types it is registered for or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the governance engine definition.

    • getRegisteredGovernanceServices

      @GetMapping(path="/governance-engines/{governanceEngineGUID}/governance-services") public org.odpi.openmetadata.frameworkservices.gaf.rest.RegisteredGovernanceServicesResponse getRegisteredGovernanceServices(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @PathVariable String governanceEngineGUID, @RequestParam int startingFrom, @RequestParam int maximumResults)
      Retrieve the identifiers of the governance services registered with a governance engine.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      governanceEngineGUID - unique identifier of the governance engine.
      startingFrom - initial position in the stored list.
      maximumResults - maximum number of definitions to return on this call.
      Returns:
      list of unique identifiers or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the governance engine definition.

    • unregisterGovernanceServiceFromEngine

      @PostMapping(path="/governance-engines/{governanceEngineGUID}/governance-services/{governanceServiceGUID}/delete") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse unregisterGovernanceServiceFromEngine(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @PathVariable String governanceEngineGUID, @PathVariable String governanceServiceGUID, @RequestBody(required=false) org.odpi.openmetadata.commonservices.ffdc.rest.NullRequestBody requestBody)
      Unregister a governance service from the governance engine.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      governanceEngineGUID - unique identifier of the governance engine.
      governanceServiceGUID - unique identifier of the governance service.
      requestBody - null request body.
      Returns:
      void or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the governance engine definition.

    • createIntegrationGroup

      @PostMapping(path="/integration-groups/new") public org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse createIntegrationGroup(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @RequestBody org.odpi.openmetadata.frameworks.governanceaction.properties.IntegrationGroupProperties requestBody)
      Create a new integration group definition.
      Parameters:
      serverName - name of the service to route the request to
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user
      requestBody - containing properties of integration group.
      Returns:
      unique identifier (guid) of the integration group definition or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the integration group definition.

    • getIntegrationGroupByGUID

      @GetMapping(path="/integration-groups/{guid}") public org.odpi.openmetadata.frameworkservices.gaf.rest.IntegrationGroupElementResponse getIntegrationGroupByGUID(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @PathVariable String guid)
      Return the properties from an integration group definition.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      guid - unique identifier (guid) of the integration group definition.
      Returns:
      properties from the integration group definition or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the integration group definition.

    • getIntegrationGroupByName

      @GetMapping(path="/integration-groups/by-name/{name}") public org.odpi.openmetadata.frameworkservices.gaf.rest.IntegrationGroupElementResponse getIntegrationGroupByName(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @PathVariable String name)
      Return the properties from an integration group definition.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      name - qualified name or display name (if unique).
      Returns:
      properties from the integration group definition or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the integration group definition.

    • getAllIntegrationGroups

      @GetMapping(path="/integration-groups") public org.odpi.openmetadata.frameworkservices.gaf.rest.IntegrationGroupElementsResponse getAllIntegrationGroups(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @RequestParam int startingFrom, @RequestParam int maximumResults)
      Return the list of integration group definitions that are stored.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      startingFrom - initial position in the stored list.
      maximumResults - maximum number of definitions to return on this call.
      Returns:
      list of integration group definitions or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the integration group definition.

    • updateIntegrationGroup

      @PostMapping(path="/integration-groups/{guid}/update") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse updateIntegrationGroup(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @PathVariable String guid, @RequestParam boolean isMergeUpdate, @RequestBody org.odpi.openmetadata.frameworks.governanceaction.properties.IntegrationGroupProperties requestBody)
      Update the properties of an existing integration group definition. Use the current value to keep a property value the same, or use the new value. Null means remove the property from the definition.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      guid - unique identifier of the integration group - used to locate the definition.
      isMergeUpdate - should the supplied properties be merged with existing properties (true) only replacing the properties with matching names, or should the entire properties of the instance be replaced?
      requestBody - containing the new properties of the integration group.
      Returns:
      void or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the integration group definition.

    • deleteIntegrationGroup

      @PostMapping(path="/integration-groups/{guid}/delete") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse deleteIntegrationGroup(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @PathVariable String guid, @RequestBody org.odpi.openmetadata.commonservices.ffdc.rest.DeleteRequestBody requestBody)
      Remove the properties of the integration group. Both the guid and the qualified name is supplied to validate that the correct integration group is being deleted.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      guid - unique identifier of the integration group - used to locate the definition.
      requestBody - containing the unique name for the integration group.
      Returns:
      void or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the integration group definition.

    • createIntegrationConnector

      @PostMapping(path="/integration-connectors/new") public org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse createIntegrationConnector(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @RequestBody org.odpi.openmetadata.frameworks.governanceaction.properties.IntegrationConnectorProperties requestBody)
      Create an integration connector definition. The same integration connector can be associated with multiple integration groups.
      Parameters:
      serverName - name of the service to route the request to
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user
      requestBody - containing: qualifiedName - unique name for the integration connector; displayName - display name for the integration connector; description - description of the analysis provided by the integration connector; connection - connection to instantiate the integration connector implementation.
      Returns:
      unique identifier of the integration connector or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the integration group definition.

    • getIntegrationConnectorByGUID

      @GetMapping(path="/integration-connectors/{guid}") public org.odpi.openmetadata.frameworkservices.gaf.rest.IntegrationConnectorElementResponse getIntegrationConnectorByGUID(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @PathVariable String guid)
      Return the properties from an integration connector definition.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      guid - unique identifier (guid) of the integration connector definition.
      Returns:
      properties of the integration connector or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the integration group definition.

    • getIntegrationConnectorByName

      @GetMapping(path="/integration-connectors/by-name/{name}") public org.odpi.openmetadata.frameworkservices.gaf.rest.IntegrationConnectorElementResponse getIntegrationConnectorByName(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @PathVariable String name)
      Return the properties from an integration connector definition.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      name - qualified name or display name (if unique).
      Returns:
      properties from the integration group definition or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the integration group definition.

    • getAllIntegrationConnectors

      @GetMapping(path="/integration-connectors") public org.odpi.openmetadata.frameworkservices.gaf.rest.IntegrationConnectorElementsResponse getAllIntegrationConnectors(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @RequestParam int startingFrom, @RequestParam int maximumResults)
      Return the list of integration connectors definitions that are stored.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      startingFrom - initial position in the stored list.
      maximumResults - maximum number of definitions to return on this call.
      Returns:
      list of integration connector definitions or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the integration group definition.

    • getIntegrationConnectorRegistrations

      @GetMapping(path="/integration-connectors/{guid}/registrations") public org.odpi.openmetadata.commonservices.ffdc.rest.GUIDListResponse getIntegrationConnectorRegistrations(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @PathVariable String guid)
      Return the list of integration groups that a specific integration connector is registered with.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      guid - integration connector to search for.
      Returns:
      list of integration group unique identifiers (guids) or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the integration group definition.

    • updateIntegrationConnector

      @PostMapping(path="/integration-connectors/{guid}/update") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse updateIntegrationConnector(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @PathVariable String guid, @RequestParam boolean isMergeUpdate, @RequestBody org.odpi.openmetadata.frameworks.governanceaction.properties.IntegrationConnectorProperties requestBody)
      Update the properties of an existing integration connector definition.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      guid - unique identifier of the integration connector - used to locate the definition.
      isMergeUpdate - should the supplied properties be merged with existing properties (true) only replacing the properties with matching names, or should the entire properties of the instance be replaced?
      requestBody - containing the new parameters for the integration connector.
      Returns:
      void or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the integration group definition.

    • deleteIntegrationConnector

      @PostMapping(path="/integration-connectors/{guid}/delete") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse deleteIntegrationConnector(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @PathVariable String guid, @RequestBody org.odpi.openmetadata.commonservices.ffdc.rest.DeleteRequestBody requestBody)
      Remove the properties of the integration connector. Both the guid and the qualified name is supplied to validate that the correct integration connector is being deleted. The integration connector is also unregistered from its integration groups.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      guid - unique identifier of the integration connector - used to locate the definition.
      requestBody - containing the unique name for the integration connector.
      Returns:
      void or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the integration group definition.

    • registerIntegrationConnectorWithGroup

      @PostMapping(path="/integration-groups/{integrationGroupGUID}/integration-connectors/{integrationConnectorGUID}") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse registerIntegrationConnectorWithGroup(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @PathVariable String integrationGroupGUID, @PathVariable String integrationConnectorGUID, @RequestBody org.odpi.openmetadata.frameworks.governanceaction.properties.RegisteredIntegrationConnectorProperties requestBody)
      Register an integration connector with a specific integration group.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      integrationGroupGUID - unique identifier of the integration group.
      integrationConnectorGUID - unique identifier of the integration connector.
      requestBody - containing: integrationGroupGUID - unique identifier of the integration connector; governanceRequestTypes - list of asset governance types that this integration connector is able to process.
      Returns:
      void or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the integration group definition.

    • getRegisteredIntegrationConnector

      @GetMapping(path="/integration-groups/{integrationGroupGUID}/integration-connectors/{integrationConnectorGUID}") public org.odpi.openmetadata.frameworkservices.gaf.rest.RegisteredIntegrationConnectorResponse getRegisteredIntegrationConnector(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @PathVariable String integrationGroupGUID, @PathVariable String integrationConnectorGUID)
      Retrieve a specific integration connector registered with an integration group.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      integrationGroupGUID - unique identifier of the integration group.
      integrationConnectorGUID - unique identifier of the integration connector.
      Returns:
      details of the integration connector and the asset types it is registered for or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the integration group definition.

    • getRegisteredIntegrationConnectors

      @GetMapping(path="/integration-groups/{integrationGroupGUID}/integration-connectors") public org.odpi.openmetadata.frameworkservices.gaf.rest.RegisteredIntegrationConnectorsResponse getRegisteredIntegrationConnectors(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @PathVariable String integrationGroupGUID, @RequestParam int startingFrom, @RequestParam int maximumResults)
      Retrieve the details of the integration connectors registered with an integration group.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      integrationGroupGUID - unique identifier of the integration group.
      startingFrom - initial position in the stored list.
      maximumResults - maximum number of definitions to return on this call.
      Returns:
      list of unique identifiers or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the integration group definition.

    • unregisterIntegrationConnectorFromGroup

      @PostMapping(path="/integration-groups/{integrationGroupGUID}/integration-connectors/{integrationConnectorGUID}/delete") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse unregisterIntegrationConnectorFromGroup(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @PathVariable String integrationGroupGUID, @PathVariable String integrationConnectorGUID, @RequestBody(required=false) org.odpi.openmetadata.commonservices.ffdc.rest.NullRequestBody requestBody)
      Unregister an integration connector from the integration group.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      integrationGroupGUID - unique identifier of the integration group.
      integrationConnectorGUID - unique identifier of the integration connector.
      requestBody - null request body.
      Returns:
      void or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the integration group definition.

    • addCatalogTarget

      @PostMapping(path="/integration-connectors/{integrationConnectorGUID}/catalog-targets/{metadataElementGUID}") public org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse addCatalogTarget(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @PathVariable String integrationConnectorGUID, @PathVariable String metadataElementGUID, @RequestBody org.odpi.openmetadata.frameworks.governanceaction.properties.CatalogTargetProperties requestBody)
      Add a catalog target to an integration connector.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      integrationConnectorGUID - unique identifier of the integration service.
      metadataElementGUID - unique identifier of the metadata element that is a catalog target.
      requestBody - properties for the relationship.
      Returns:
      guid or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the catalog target definition.

    • updateCatalogTarget

      @PostMapping(path="/catalog-targets/{relationshipGUID}/update") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse updateCatalogTarget(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @PathVariable String relationshipGUID, @RequestBody org.odpi.openmetadata.frameworks.governanceaction.properties.CatalogTargetProperties requestBody)
      Update a catalog target for an integration connector.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      relationshipGUID - unique identifier of the metadata element that is a catalog target.
      requestBody - properties for the relationship.
      Returns:
      void or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the catalog target definition.

    • getCatalogTarget

      @GetMapping(path="/catalog-targets/{relationshipGUID}") public org.odpi.openmetadata.frameworkservices.gaf.rest.CatalogTargetResponse getCatalogTarget(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @PathVariable String relationshipGUID)
      Retrieve a specific catalog target associated with an integration connector.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      relationshipGUID - unique identifier of the relationship
      Returns:
      details of the governance service and the asset types it is registered for or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the integration connector definition.

    • getCatalogTargets

      @GetMapping(path="/integration-connectors/{integrationConnectorGUID}/catalog-targets") public org.odpi.openmetadata.frameworkservices.gaf.rest.CatalogTargetsResponse getCatalogTargets(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @PathVariable String integrationConnectorGUID, @RequestParam int startingFrom, @RequestParam int maximumResults)
      Retrieve the details of the metadata elements identified as catalog targets with an integration connector.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      integrationConnectorGUID - unique identifier of the integration connector.
      startingFrom - initial position in the stored list.
      maximumResults - maximum number of definitions to return on this call.
      Returns:
      list of unique identifiers or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the integration connector definition.

    • removeCatalogTarget

      @PostMapping(path="/catalog-targets/{relationshipGUID}/delete") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse removeCatalogTarget(@PathVariable String serverName, @PathVariable String serviceURLMarker, @PathVariable String userId, @PathVariable String relationshipGUID, @RequestBody org.odpi.openmetadata.commonservices.ffdc.rest.NullRequestBody requestBody)
      Unregister a catalog target from the integration connector.
      Parameters:
      serverName - name of the service to route the request to.
      serviceURLMarker - the identifier of the access service (for example asset-owner for the Asset Owner OMAS)
      userId - identifier of calling user.
      relationshipGUID - unique identifier of the relationship.
      requestBody - null request body.
      Returns:
      void or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem storing the integration connector definition.