Package org.odpi.openmetadata.accessservices.governanceprogram.server.spring

Class SubjectAreaResource

java.lang.Object
org.odpi.openmetadata.accessservices.governanceprogram.server.spring.SubjectAreaResource
@RestController @RequestMapping("/servers/{serverName}/open-metadata/access-services/governance-program/users/{userId}") public class SubjectAreaResource extends Object
The SubjectAreasResource provides a Spring based server-side REST API that supports the SubjectAreasInterface. It delegates each request to the SubjectAreaRESTServices.

  • Constructor Summary

    Constructors
    Constructor
    Description
    SubjectAreaResource()
    Default constructor

  • Method Summary

    Modifier and Type
    Method
    Description
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    addSubjectAreaMemberClassification(String serverName, String userId, String elementGUID, org.odpi.openmetadata.accessservices.governanceprogram.rest.ClassificationRequestBody requestBody)
    Add a subject area classification to a referenceable element.
    org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse
    createSubjectArea(String serverName, String userId, org.odpi.openmetadata.accessservices.governanceprogram.rest.ReferenceableRequestBody requestBody)
    Create a definition of a subject area.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    deleteSubjectArea(String serverName, String userId, String subjectAreaGUID, org.odpi.openmetadata.accessservices.governanceprogram.rest.ExternalSourceRequestBody requestBody)
    Remove the definition of a subject area.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    deleteSubjectAreaMemberClassification(String serverName, String userId, String elementGUID, org.odpi.openmetadata.accessservices.governanceprogram.rest.ExternalSourceRequestBody requestBody)
    Remove a subject area classification from a referenceable.
    org.odpi.openmetadata.accessservices.governanceprogram.rest.ElementStubListResponse
    getMembersOfSubjectArea(String serverName, String userId, String subjectAreaName, int startFrom, int pageSize)
    Return information about the contents of a subject area such as the glossaries, reference data sets and quality definitions.
    org.odpi.openmetadata.accessservices.governanceprogram.rest.SubjectAreaResponse
    getSubjectAreaByGUID(String serverName, String userId, String subjectAreaGUID)
    Return information about a specific subject area.
    org.odpi.openmetadata.accessservices.governanceprogram.rest.SubjectAreaResponse
    getSubjectAreaByName(String serverName, String userId, String qualifiedName)
    Return information about a specific subject area.
    org.odpi.openmetadata.accessservices.governanceprogram.rest.SubjectAreaDefinitionResponse
    getSubjectAreaDefinitionByGUID(String serverName, String userId, String subjectAreaGUID)
    Return information about a specific subject area and its linked governance definitions.
    org.odpi.openmetadata.accessservices.governanceprogram.rest.SubjectAreaListResponse
    getSubjectAreasForDomain(String serverName, String userId, int domainIdentifier, int startFrom, int pageSize)
    Return information about the defined subject areas.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    linkSubjectAreasInHierarchy(String serverName, String userId, String parentSubjectAreaGUID, String childSubjectAreaGUID, org.odpi.openmetadata.accessservices.governanceprogram.rest.RelationshipRequestBody requestBody)
    Link two related subject areas together as part of a hierarchy.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    linkSubjectAreaToGovernanceDefinition(String serverName, String userId, String subjectAreaGUID, String definitionGUID, org.odpi.openmetadata.accessservices.governanceprogram.rest.RelationshipRequestBody requestBody)
    Link a subject area to a governance definition that controls how the assets in the subject area should be governed.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    unlinkSubjectAreaFromGovernanceDefinition(String serverName, String userId, String subjectAreaGUID, String definitionGUID, org.odpi.openmetadata.accessservices.governanceprogram.rest.RelationshipRequestBody requestBody)
    Remove the link between a subject area and a governance definition.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    unlinkSubjectAreasInHierarchy(String serverName, String userId, String parentSubjectAreaGUID, String childSubjectAreaGUID, org.odpi.openmetadata.accessservices.governanceprogram.rest.RelationshipRequestBody requestBody)
    Remove the link between two subject areas in the subject area hierarchy.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    updateSubjectArea(String serverName, String userId, String subjectAreaGUID, boolean isMergeUpdate, org.odpi.openmetadata.accessservices.governanceprogram.rest.ReferenceableRequestBody requestBody)
    Update the definition of a subject area.

    Methods inherited from class java.lang.Object

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

  • Constructor Details

    • SubjectAreaResource

      public SubjectAreaResource()
      Default constructor

  • Method Details

    • createSubjectArea

      @PostMapping(path="/subject-areas") public org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse createSubjectArea(@PathVariable String serverName, @PathVariable String userId, @RequestBody org.odpi.openmetadata.accessservices.governanceprogram.rest.ReferenceableRequestBody requestBody)
      Create a definition of a subject area.
      Parameters:
      serverName - name of the server instance to connect to
      userId - calling user
      requestBody - properties to store
      Returns:
      unique identifier of the new subject area or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem

    • updateSubjectArea

      @PostMapping(path="/subject-areas/{subjectAreaGUID}") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse updateSubjectArea(@PathVariable String serverName, @PathVariable String userId, @PathVariable String subjectAreaGUID, @RequestParam boolean isMergeUpdate, @RequestBody org.odpi.openmetadata.accessservices.governanceprogram.rest.ReferenceableRequestBody requestBody)
      Update the definition of a subject area.
      Parameters:
      serverName - name of the server instance to connect to
      userId - calling user
      subjectAreaGUID - unique identifier of subject area
      isMergeUpdate - are unspecified properties unchanged (true) or replaced with null?
      requestBody - properties to change
      Returns:
      void or InvalidParameterException guid, qualifiedName or userId is null; qualifiedName is not unique; guid is not known PropertyServerException problem accessing property server UserNotAuthorizedException security access problem

    • deleteSubjectArea

      @PostMapping(path="/subject-areas/{subjectAreaGUID}/delete") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse deleteSubjectArea(@PathVariable String serverName, @PathVariable String userId, @PathVariable String subjectAreaGUID, @RequestBody(required=false) org.odpi.openmetadata.accessservices.governanceprogram.rest.ExternalSourceRequestBody requestBody)
      Remove the definition of a subject area.
      Parameters:
      serverName - name of the server instance to connect to
      userId - calling user
      subjectAreaGUID - unique identifier of subject area
      requestBody - external source requestBody
      Returns:
      void or InvalidParameterException guid or userId is null; guid is not known PropertyServerException problem accessing property server UserNotAuthorizedException security access problem

    • linkSubjectAreasInHierarchy

      @PostMapping(path="/subject-areas/{parentSubjectAreaGUID}/nested-subject-area/{childSubjectAreaGUID}/link") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse linkSubjectAreasInHierarchy(@PathVariable String serverName, @PathVariable String userId, @PathVariable String parentSubjectAreaGUID, @PathVariable String childSubjectAreaGUID, @RequestBody(required=false) org.odpi.openmetadata.accessservices.governanceprogram.rest.RelationshipRequestBody requestBody)
      Link two related subject areas together as part of a hierarchy. A subject area can only have one parent but many child subject areas.
      Parameters:
      serverName - name of the server instance to connect to
      userId - calling user
      parentSubjectAreaGUID - unique identifier of the parent subject area
      childSubjectAreaGUID - unique identifier of the child subject area
      requestBody - relationship requestBody
      Returns:
      void or InvalidParameterException one of the guids is null or not known PropertyServerException problem accessing property server UserNotAuthorizedException security access problem

    • unlinkSubjectAreasInHierarchy

      @PostMapping(path="/subject-areas/{parentSubjectAreaGUID}/nested-subject-area/{childSubjectAreaGUID}/unlink") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse unlinkSubjectAreasInHierarchy(@PathVariable String serverName, @PathVariable String userId, @PathVariable String parentSubjectAreaGUID, @PathVariable String childSubjectAreaGUID, @RequestBody(required=false) org.odpi.openmetadata.accessservices.governanceprogram.rest.RelationshipRequestBody requestBody)
      Remove the link between two subject areas in the subject area hierarchy.
      Parameters:
      serverName - name of the server instance to connect to
      userId - calling user
      parentSubjectAreaGUID - unique identifier of the parent subject area
      childSubjectAreaGUID - unique identifier of the child subject area
      requestBody - relationship requestBody
      Returns:
      void or InvalidParameterException one of the guids is null or not known PropertyServerException problem accessing property server UserNotAuthorizedException security access problem

    • linkSubjectAreaToGovernanceDefinition

      @PostMapping(path="/subject-areas/{subjectAreaGUID}/governed-by/{definitionGUID}/link") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse linkSubjectAreaToGovernanceDefinition(@PathVariable String serverName, @PathVariable String userId, @PathVariable String subjectAreaGUID, @PathVariable String definitionGUID, @RequestBody(required=false) org.odpi.openmetadata.accessservices.governanceprogram.rest.RelationshipRequestBody requestBody)
      Link a subject area to a governance definition that controls how the assets in the subject area should be governed.
      Parameters:
      serverName - name of the server instance to connect to
      userId - calling user
      subjectAreaGUID - unique identifier of the subject area
      definitionGUID - unique identifier of the governance definition
      requestBody - relationship requestBody
      Returns:
      void or InvalidParameterException one of the guids is null or not known PropertyServerException problem accessing property server UserNotAuthorizedException security access problem

    • unlinkSubjectAreaFromGovernanceDefinition

      @PostMapping(path="/subject-areas/{subjectAreaGUID}/governed-by/{definitionGUID}/unlink") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse unlinkSubjectAreaFromGovernanceDefinition(@PathVariable String serverName, @PathVariable String userId, @PathVariable String subjectAreaGUID, @PathVariable String definitionGUID, @RequestBody(required=false) org.odpi.openmetadata.accessservices.governanceprogram.rest.RelationshipRequestBody requestBody)
      Remove the link between a subject area and a governance definition.
      Parameters:
      serverName - name of the server instance to connect to
      userId - calling user
      subjectAreaGUID - unique identifier of the subject area
      definitionGUID - unique identifier of the governance definition
      requestBody - relationship requestBody
      Returns:
      void or InvalidParameterException one of the guids is null or not known PropertyServerException problem accessing property server UserNotAuthorizedException security access problem

    • getSubjectAreaByGUID

      @GetMapping(path="/subject-areas/{subjectAreaGUID}") public org.odpi.openmetadata.accessservices.governanceprogram.rest.SubjectAreaResponse getSubjectAreaByGUID(@PathVariable String serverName, @PathVariable String userId, @PathVariable String subjectAreaGUID)
      Return information about a specific subject area.
      Parameters:
      serverName - name of the server instance to connect to
      userId - calling user
      subjectAreaGUID - unique identifier for the subject area
      Returns:
      properties of the subject area or InvalidParameterException subjectAreaGUID or userId is null PropertyServerException problem accessing property server UserNotAuthorizedException security access problem

    • getSubjectAreaByName

      @GetMapping(path="/subject-areas/name/{qualifiedName}") public org.odpi.openmetadata.accessservices.governanceprogram.rest.SubjectAreaResponse getSubjectAreaByName(@PathVariable String serverName, @PathVariable String userId, @PathVariable String qualifiedName)
      Return information about a specific subject area.
      Parameters:
      serverName - name of the server instance to connect to
      userId - calling user
      qualifiedName - unique name for the subject area
      Returns:
      properties of the subject area or InvalidParameterException qualifiedName or userId is null PropertyServerException problem accessing property server UserNotAuthorizedException security access problem

    • getSubjectAreasForDomain

      @GetMapping(path="/subject-areas/for-domain") public org.odpi.openmetadata.accessservices.governanceprogram.rest.SubjectAreaListResponse getSubjectAreasForDomain(@PathVariable String serverName, @PathVariable String userId, @RequestParam int domainIdentifier, @RequestParam int startFrom, @RequestParam int pageSize)
      Return information about the defined subject areas.
      Parameters:
      serverName - name of the server instance to connect to
      userId - calling user
      domainIdentifier - identifier for the desired governance domain
      startFrom - paging start point
      pageSize - maximum results that can be returned
      Returns:
      properties of the subject area or InvalidParameterException qualifiedName or userId is null PropertyServerException problem accessing property server UserNotAuthorizedException security access problem

    • getSubjectAreaDefinitionByGUID

      @GetMapping(path="/subject-areas/{subjectAreaGUID}/with-definitions") public org.odpi.openmetadata.accessservices.governanceprogram.rest.SubjectAreaDefinitionResponse getSubjectAreaDefinitionByGUID(@PathVariable String serverName, @PathVariable String userId, @PathVariable String subjectAreaGUID)
      Return information about a specific subject area and its linked governance definitions.
      Parameters:
      serverName - name of the server instance to connect to
      userId - calling user
      subjectAreaGUID - unique identifier for the subject area
      Returns:
      properties of the subject area linked to the associated governance definitions or InvalidParameterException subjectAreaGUID or userId is null PropertyServerException problem accessing property server UserNotAuthorizedException security access problem

    • addSubjectAreaMemberClassification

      @PostMapping(path="/elements/{elementGUID}/subject-area") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse addSubjectAreaMemberClassification(@PathVariable String serverName, @PathVariable String userId, @PathVariable String elementGUID, @RequestBody org.odpi.openmetadata.accessservices.governanceprogram.rest.ClassificationRequestBody requestBody)
      Add a subject area classification to a referenceable element.
      Parameters:
      serverName - name of the server instance to connect to
      userId - calling user
      elementGUID - unique identifier for the element
      requestBody - identifier for a subject area
      Returns:
      void or InvalidParameterException qualifiedName or userId is null; qualifiedName is not unique PropertyServerException problem accessing property server UserNotAuthorizedException security access problem

    • deleteSubjectAreaMemberClassification

      @PostMapping(path="/elements/{elementGUID}/subject-area/delete") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse deleteSubjectAreaMemberClassification(@PathVariable String serverName, @PathVariable String userId, @PathVariable String elementGUID, @RequestBody org.odpi.openmetadata.accessservices.governanceprogram.rest.ExternalSourceRequestBody requestBody)
      Remove a subject area classification from a referenceable.
      Parameters:
      serverName - name of the server instance to connect to
      userId - calling user
      elementGUID - unique identifier for the element
      requestBody - external source request body
      Returns:
      void or InvalidParameterException guid or userId is null; guid is not known PropertyServerException problem accessing property server UserNotAuthorizedException security access problem

    • getMembersOfSubjectArea

      @GetMapping(path="/subject-areas/{subjectAreaName}/members") public org.odpi.openmetadata.accessservices.governanceprogram.rest.ElementStubListResponse getMembersOfSubjectArea(@PathVariable String serverName, @PathVariable String userId, @PathVariable String subjectAreaName, @RequestParam int startFrom, @RequestParam int pageSize)
      Return information about the contents of a subject area such as the glossaries, reference data sets and quality definitions.
      Parameters:
      serverName - name of the server instance to connect to
      userId - calling user
      subjectAreaName - unique identifier for the subject area
      startFrom - paging start point
      pageSize - maximum results that can be returned
      Returns:
      list of subject area members or InvalidParameterException qualifiedName or userId is null PropertyServerException problem accessing property server UserNotAuthorizedException security access problem