Class DataDiscoveryRESTServices

java.lang.Object
org.odpi.openmetadata.tokencontroller.TokenController
org.odpi.openmetadata.viewservices.datadiscovery.server.DataDiscoveryRESTServices

public class DataDiscoveryRESTServices extends TokenController
The DataDiscoveryRESTServices provides the server-side implementation of the Data Discovery Open Metadata View Service (OMVS). This interface provides access to a person's profile, roles and network.
  • Constructor Details

    • DataDiscoveryRESTServices

      public DataDiscoveryRESTServices()
      Default constructor
  • Method Details

    • createAnnotation

      public GUIDResponse createAnnotation(String serverName, NewElementRequestBody requestBody)
      Create an annotation.
      Parameters:
      serverName - name of called server.
      requestBody - properties for the annotation.
      Returns:
      unique identifier of the newly created element InvalidParameterException one of the parameters is invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
    • createAnnotationFromTemplate

      public GUIDResponse createAnnotationFromTemplate(String serverName, TemplateRequestBody requestBody)
      Create a new metadata element to represent an annotation using an existing metadata element as a template. The template defines additional classifications and relationships that should be added to the new element.
      Parameters:
      serverName - calling user
      requestBody - properties that override the template
      Returns:
      unique identifier of the new metadata element InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)
    • updateAnnotation

      public VoidResponse updateAnnotation(String serverName, String annotationGUID, UpdateElementRequestBody requestBody)
      Update the properties of an annotation.
      Parameters:
      serverName - name of called server.
      annotationGUID - unique identifier of the annotation (returned from create)
      requestBody - properties for the new element.
      Returns:
      void or InvalidParameterException one of the parameters is invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
    • attachAnnotationToReport

      public VoidResponse attachAnnotationToReport(String serverName, String surveyReportGUID, String newAnnotationGUID, NewRelationshipRequestBody requestBody)
      Create a relationship that links a new annotation to its survey report. This relationship is typically established during the createAnnotation as the parent relationship. It is included for completeness.
      Parameters:
      serverName - name of called server
      surveyReportGUID - unique identifier of the report
      newAnnotationGUID - unique identifier of the annotation
      requestBody - description of the relationship.
      Returns:
      void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
    • detachAnnotationFromReport

      public VoidResponse detachAnnotationFromReport(String serverName, String surveyReportGUID, String newAnnotationGUID, DeleteRelationshipRequestBody requestBody)
      Detach an annotation from its report (ReportedAnnotation relationship).
      Parameters:
      serverName - name of called server
      surveyReportGUID - unique identifier of the report
      newAnnotationGUID - unique identifier of the annotation
      requestBody - description of the relationship.
      Returns:
      void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
    • linkAnnotationToDescribedElement

      public VoidResponse linkAnnotationToDescribedElement(String serverName, String elementGUID, String annotationGUID, NewRelationshipRequestBody requestBody)
      Attach an annotation to the element that it is describing (via AssociatedAnnotation relationship).
      Parameters:
      serverName - name of called server
      elementGUID - unique identifier of the described element
      annotationGUID - unique identifier of the annotation
      requestBody - description of the relationship.
      Returns:
      void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
    • detachAnnotationFromDescribedElement

      public VoidResponse detachAnnotationFromDescribedElement(String serverName, String elementGUID, String annotationGUID, DeleteRelationshipRequestBody requestBody)
      Detach an annotation from the element that it is describing (via AssociatedAnnotation relationship).
      Parameters:
      serverName - name of called server
      elementGUID - unique identifier of the described element
      annotationGUID - unique identifier of the annotation
      requestBody - description of the relationship.
      Returns:
      void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
    • linkAnnotationToItsPredecessor

      public VoidResponse linkAnnotationToItsPredecessor(String serverName, String previousAnnotationGUID, String newAnnotationGUID, NewRelationshipRequestBody requestBody)
      Attach an annotation to the equivalent annotation from the previous run of the survey.
      Parameters:
      serverName - name of called server
      previousAnnotationGUID - unique identifier of the annotation from the previous run of the survey
      newAnnotationGUID - unique identifier of the annotation from this run of the survey
      requestBody - description of the relationship.
      Returns:
      void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
    • detachAnnotationFromItsPredecessor

      public VoidResponse detachAnnotationFromItsPredecessor(String serverName, String previousAnnotationGUID, String newAnnotationGUID, DeleteRelationshipRequestBody requestBody)
      Detach an annotation from an annotation from the previous run of the survey.
      Parameters:
      serverName - name of called server
      previousAnnotationGUID - unique identifier of the annotation from the previous run of the survey
      newAnnotationGUID - unique identifier of the annotation from this run of the survey
      requestBody - description of the relationship.
      Returns:
      void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
    • linkDiscoveredSchemaType

      public VoidResponse linkDiscoveredSchemaType(String serverName, String annotationGUID, String schemaTypeGUID, NewRelationshipRequestBody requestBody)
      Attach a schema analysis annotation to a matching schema type.
      Parameters:
      serverName - name of called server
      annotationGUID - unique identifier of the annotation
      schemaTypeGUID - unique identifier of the schema type
      requestBody - description of the relationship.
      Returns:
      void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
    • detachDiscoveredSchemaType

      public VoidResponse detachDiscoveredSchemaType(String serverName, String annotationGUID, String schemaTypeGUID, DeleteRelationshipRequestBody requestBody)
      Detach a schema analysis annotation from a matching schema type.
      Parameters:
      serverName - name of called server
      annotationGUID - unique identifier of the annotation
      schemaTypeGUID - unique identifier of the schema type
      requestBody - description of the relationship.
      Returns:
      void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
    • linkResourceProfileData

      public VoidResponse linkResourceProfileData(String serverName, String annotationGUID, String assetGUID, NewRelationshipRequestBody requestBody)
      Attach a resource profile log annotation to an asset where the profile data is stored.
      Parameters:
      serverName - name of called server
      annotationGUID - unique identifier of the annotation
      assetGUID - unique identifier of the associated asset
      requestBody - description of the relationship.
      Returns:
      void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
    • detachResourceProfileData

      public VoidResponse detachResourceProfileData(String serverName, String annotationGUID, String assetGUID, DeleteRelationshipRequestBody requestBody)
      Detach a resource profile log annotation from an asset where the profile data is stored.
      Parameters:
      serverName - name of called server
      annotationGUID - unique identifier of the annotation
      assetGUID - unique identifier of the associated asset
      requestBody - description of the relationship.
      Returns:
      void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
    • linkDataClassMatch

      public VoidResponse linkDataClassMatch(String serverName, String annotationGUID, String dataClassGUID, NewRelationshipRequestBody requestBody)
      Attach a data class annotation to a data class.
      Parameters:
      serverName - name of called server
      annotationGUID - unique identifier of the annotation
      dataClassGUID - unique identifier of the associated data class
      requestBody - description of the relationship.
      Returns:
      void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
    • detachDataClassMatch

      public VoidResponse detachDataClassMatch(String serverName, String annotationGUID, String dataClassGUID, DeleteRelationshipRequestBody requestBody)
      Detach a data class annotation from a data class.
      Parameters:
      serverName - name of called server
      annotationGUID - unique identifier of the annotation
      dataClassGUID - unique identifier of the associated data class
      requestBody - description of the relationship.
      Returns:
      void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
    • linkRequestForActionTarget

      public VoidResponse linkRequestForActionTarget(String serverName, String annotationGUID, String elementGUID, NewRelationshipRequestBody requestBody)
      Attach a request for action annotation to the element that needs attention.
      Parameters:
      serverName - name of called server
      annotationGUID - unique identifier of the annotation
      elementGUID - unique identifier of the associated element
      requestBody - description of the relationship.
      Returns:
      void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
    • detachRequestForActionTarget

      public VoidResponse detachRequestForActionTarget(String serverName, String annotationGUID, String elementGUID, DeleteRelationshipRequestBody requestBody)
      Detach a request for action annotation from its intended target element.
      Parameters:
      serverName - name of called server
      annotationGUID - unique identifier of the annotation
      elementGUID - unique identifier of the associated element
      requestBody - description of the relationship.
      Returns:
      void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
    • deleteAnnotation

      public VoidResponse deleteAnnotation(String serverName, String annotationGUID, DeleteElementRequestBody requestBody)
      Delete an annotation.
      Parameters:
      serverName - name of called server
      annotationGUID - unique identifier of the element to delete
      requestBody - description of the relationship.
      Returns:
      void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
    • getAnnotationsByName

      public OpenMetadataRootElementsResponse getAnnotationsByName(String serverName, FilterRequestBody requestBody)
      Retrieve the list of annotation metadata elements that contain the search string.
      Parameters:
      serverName - name of the service to route the request to
      requestBody - string to find in the properties
      Returns:
      list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)
    • getAnnotationsByAnalysisStep

      public OpenMetadataRootElementsResponse getAnnotationsByAnalysisStep(String serverName, FilterRequestBody requestBody)
      Returns the list of annotations associated with a particular analysis step.
      Parameters:
      serverName - name of the service to route the request to
      requestBody - string to find in the properties
      Returns:
      list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)
    • getAnnotationsByAnnotationType

      public OpenMetadataRootElementsResponse getAnnotationsByAnnotationType(String serverName, FilterRequestBody requestBody)
      Returns the list of annotations with a particular annotation type property.
      Parameters:
      serverName - name of the service to route the request to
      requestBody - string to find in the properties
      Returns:
      list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)
    • getAnnotationsForElement

      public OpenMetadataRootElementsResponse getAnnotationsForElement(String serverName, String elementGUID, ResultsRequestBody requestBody)
      Returns the list of annotations that describe the supplied element (AssociatedAnnotation relationship).
      Parameters:
      serverName - name of the service to route the request to
      elementGUID - unique identifier of the starting element
      requestBody - string to find in the properties
      Returns:
      list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)
    • getNewAnnotations

      public OpenMetadataRootElementsResponse getNewAnnotations(String serverName, String surveyReportGUID, ResultsRequestBody requestBody)
      Returns the annotations created under the supplied survey report.
      Parameters:
      serverName - name of the service to route the request to
      surveyReportGUID - unique identifier of the starting element
      requestBody - string to find in the properties
      Returns:
      list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)
    • getAnnotationExtensions

      public OpenMetadataRootElementsResponse getAnnotationExtensions(String serverName, String annotationGUID, ResultsRequestBody requestBody)
      Returns the list of annotations that extend the supplied annotation (AnnotationExtension relationship).
      Parameters:
      serverName - name of the service to route the request to
      annotationGUID - unique identifier of the starting element
      requestBody - string to find in the properties
      Returns:
      list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)
    • getPreviousAnnotations

      public OpenMetadataRootElementsResponse getPreviousAnnotations(String serverName, String annotationGUID, ResultsRequestBody requestBody)
      Returns the list of annotations that are extended by the supplied annotation (AnnotationExtension relationship).
      Parameters:
      serverName - name of the service to route the request to
      annotationGUID - unique identifier of the starting element
      requestBody - string to find in the properties
      Returns:
      list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)
    • getAnnotationByGUID

      public OpenMetadataRootElementResponse getAnnotationByGUID(String serverName, String annotationGUID, GetRequestBody requestBody)
      Retrieve the list of annotation metadata elements that contain the search string.
      Parameters:
      serverName - name of the service to route the request to
      annotationGUID - unique identifier of the required element
      requestBody - string to find in the properties
      Returns:
      list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)
    • findAnnotations

      public OpenMetadataRootElementsResponse findAnnotations(String serverName, SearchStringRequestBody requestBody)
      Retrieve the list of annotation metadata elements that contain the search string.
      Parameters:
      serverName - name of the service to route the request to
      requestBody - string to find in the properties
      Returns:
      list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)