Class ClassificationExplorerResource
java.lang.Object
org.odpi.openmetadata.viewservices.classificationexplorer.server.spring.ClassificationExplorerResource
@RestController
@RequestMapping("/servers/{serverName}/api/open-metadata/{urlMarker}")
public class ClassificationExplorerResource
extends Object
The ClassificationExplorerResource provides the Spring API endpoints of the Classification Explorer Open Metadata View Service (OMVS).
=
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionfindElementsByClassificationWithPropertyValue
(String serverName, String urlMarker, String classificationName, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, FindPropertyNamesProperties requestBody) Retrieve elements with the requested classification name and with the requested a value found in one of the classification's properties specified.findElementsByPropertyValue
(String serverName, String urlMarker, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, FindPropertyNamesProperties requestBody) Retrieve elements by a value found in one of the properties specified.findRelatedElementsWithPropertyValue
(String serverName, String urlMarker, String elementGUID, String relationshipTypeName, int startingAtEnd, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, FindPropertyNamesProperties requestBody) Retrieve elements linked via the requested relationship type name and with the relationship's properties specified.findRelationshipsWithPropertyValue
(String serverName, String urlMarker, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, FindPropertyNamesProperties requestBody) Retrieve relationships of the requested relationship type name and with the requested a value found in one of the relationship's properties specified.getAssetsByOrigin
(String serverName, String urlMarker, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, FindAssetOriginProperties requestBody) Return information about the assets from a specific origin.getConfidenceClassifiedElements
(String serverName, String urlMarker, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, LevelIdentifierQueryProperties requestBody) Return information about the elements classified with the confidence classification.getConfidentialityClassifiedElements
(String serverName, String urlMarker, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, LevelIdentifierQueryProperties requestBody) Return information about the elements classified with the confidentiality classification.getCriticalityClassifiedElements
(String serverName, String urlMarker, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, LevelIdentifierQueryProperties requestBody) Return information about the elements classified with the criticality classification.getDataFieldClassifiedElements
(String serverName, String urlMarker, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, DataFieldQueryProperties requestBody) Return information about the elements classified with the DataFieldValues classification.getElements
(String serverName, String urlMarker, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, FindProperties requestBody) Retrieve elements of the requested type name.getElementsByClassification
(String serverName, String urlMarker, String classificationName, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, FindProperties requestBody) Retrieve elements with the requested classification name.getElementsByClassificationWithPropertyValue
(String serverName, String urlMarker, String classificationName, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, FindPropertyNamesProperties requestBody) Retrieve elements with the requested classification name and with the requested a value found in one of the classification's properties specified.getElementsByPropertyValue
(String serverName, String urlMarker, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, FindPropertyNamesProperties requestBody) Retrieve elements by a value found in one of the properties specified.getElementsSourcedFrom
(String serverName, String urlMarker, String elementGUID, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, FindProperties requestBody) Retrieve the elements linked via a "SourcedFrom" relationship to the requested element.getGovernedByDefinitions
(String serverName, String urlMarker, String elementGUID, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, FindProperties requestBody) Retrieve the elements linked via a "GovernedBy" relationship to the requested governance definition.getGovernedElements
(String serverName, String urlMarker, String governanceDefinitionGUID, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, FindProperties requestBody) Retrieve the governance definitions linked via a "GovernedBy" relationship to the requested element.getMeanings
(String serverName, String urlMarker, String elementGUID, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, SemanticAssignmentQueryProperties requestBody) Retrieve the glossary terms linked via a "SemanticAssignment" relationship to the requested element.getMembersOfSubjectArea
(String serverName, String urlMarker, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, FindNameProperties requestBody) Return information about the elements classified with the subject area classification.getMetadataElementByGUID
(String serverName, String urlMarker, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, FindRequest requestBody) Retrieve the metadata element using its unique identifier.getMetadataElementByUniqueName
(String serverName, String urlMarker, boolean forLineage, boolean forDuplicateProcessing, FindPropertyNameProperties requestBody) Retrieve the metadata element using its unique name (typically the qualified name).getMetadataElementGUIDByUniqueName
(String serverName, String urlMarker, boolean forLineage, boolean forDuplicateProcessing, FindPropertyNameProperties requestBody) Retrieve the unique identifier of a metadata element using its unique name (typically the qualified name).getOwnersElements
(String serverName, String urlMarker, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, FindNameProperties requestBody) Return information about the elements classified with the ownership classification.getRelatedElements
(String serverName, String urlMarker, String elementGUID, int startingAtEnd, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, FindProperties requestBody) Retrieve related elements of any type name.getRelatedElements
(String serverName, String urlMarker, String elementGUID, String relationshipTypeName, int startingAtEnd, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, FindProperties requestBody) Retrieve related elements of the requested type name.getRelatedElementsWithPropertyValue
(String serverName, String urlMarker, String elementGUID, String relationshipTypeName, int startingAtEnd, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, FindPropertyNamesProperties requestBody) Retrieve elements linked via the requested relationship type name and with the requested value found in one of the relationship's properties specified.getRelationships
(String serverName, String urlMarker, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, FindProperties requestBody) Retrieve relationships of the requested relationship type name.getRelationshipsWithPropertyValue
(String serverName, String urlMarker, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, FindPropertyNamesProperties requestBody) Retrieve relationships of the requested relationship type name and with the requested a value found in one of the relationship's properties specified.getRetentionClassifiedElements
(String serverName, String urlMarker, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, LevelIdentifierQueryProperties requestBody) Return information about the elements classified with the retention classification.getSecurityTaggedElements
(String serverName, String urlMarker, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, SecurityTagQueryProperties requestBody) Return information about the elements classified with the security tags classification.getSemanticAssignees
(String serverName, String urlMarker, String glossaryTermGUID, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, SemanticAssignmentQueryProperties requestBody) Retrieve the elements linked via a "SemanticAssignment" relationship to the requested glossary term.getSourceElements
(String serverName, String urlMarker, String elementGUID, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, FindProperties requestBody) Retrieve the elements linked via a "SourceFrom" relationship to the requested element.retrieveInstanceForGUID
(String serverName, String urlMarker, String guid, boolean forLineage, boolean forDuplicateProcessing, ResultsRequestBody requestBody) Retrieve the header for the instance identified by the supplied unique identifier.
-
Constructor Details
-
ClassificationExplorerResource
public ClassificationExplorerResource()Default constructor
-
-
Method Details
-
getDataFieldClassifiedElements
@PostMapping(path="/elements/by-data-field") public MetadataElementSummariesResponse getDataFieldClassifiedElements(@PathVariable String serverName, @PathVariable String urlMarker, @RequestParam(required=false,defaultValue="0") int startFrom, @RequestParam(required=false,defaultValue="0") int pageSize, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) DataFieldQueryProperties requestBody) Return information about the elements classified with the DataFieldValues classification.- Parameters:
serverName
- name of the server instance to connect tourlMarker
- view service URL markerstartFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for the request- Returns:
- classified elements or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
getConfidenceClassifiedElements
@PostMapping(path="/elements/by-confidence") public MetadataElementSummariesResponse getConfidenceClassifiedElements(@PathVariable String serverName, @PathVariable String urlMarker, @RequestParam(required=false,defaultValue="0") int startFrom, @RequestParam(required=false,defaultValue="0") int pageSize, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) LevelIdentifierQueryProperties requestBody) Return information about the elements classified with the confidence classification.- Parameters:
serverName
- name of the server instance to connect tourlMarker
- view service URL markerstartFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for the request- Returns:
- classified elements or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
getCriticalityClassifiedElements
@PostMapping(path="/elements/by-criticality") public MetadataElementSummariesResponse getCriticalityClassifiedElements(@PathVariable String serverName, @PathVariable String urlMarker, @RequestParam(required=false,defaultValue="0") int startFrom, @RequestParam(required=false,defaultValue="0") int pageSize, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) LevelIdentifierQueryProperties requestBody) Return information about the elements classified with the criticality classification.- Parameters:
serverName
- name of the server instance to connect tourlMarker
- view service URL markerstartFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for the request- Returns:
- classified elements or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
getConfidentialityClassifiedElements
@PostMapping(path="/elements/by-confidentiality") public MetadataElementSummariesResponse getConfidentialityClassifiedElements(@PathVariable String serverName, @PathVariable String urlMarker, @RequestParam(required=false,defaultValue="0") int startFrom, @RequestParam(required=false,defaultValue="0") int pageSize, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) LevelIdentifierQueryProperties requestBody) Return information about the elements classified with the confidentiality classification.- Parameters:
serverName
- name of the server instance to connect tourlMarker
- view service URL markerstartFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for the request- Returns:
- classified elements or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
getRetentionClassifiedElements
@PostMapping(path="/elements/by-retention") public MetadataElementSummariesResponse getRetentionClassifiedElements(@PathVariable String serverName, @PathVariable String urlMarker, @RequestParam(required=false,defaultValue="0") int startFrom, @RequestParam(required=false,defaultValue="0") int pageSize, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) LevelIdentifierQueryProperties requestBody) Return information about the elements classified with the retention classification.- Parameters:
serverName
- name of the server instance to connect tourlMarker
- view service URL markerstartFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for the request- Returns:
- classified elements or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
getSecurityTaggedElements
@PostMapping(path="/elements/by-security-tags") public MetadataElementSummariesResponse getSecurityTaggedElements(@PathVariable String serverName, @PathVariable String urlMarker, @RequestParam(required=false,defaultValue="0") int startFrom, @RequestParam(required=false,defaultValue="0") int pageSize, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) SecurityTagQueryProperties requestBody) Return information about the elements classified with the security tags classification.- Parameters:
serverName
- name of the server instance to connect tourlMarker
- view service URL markerstartFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for the request- Returns:
- classified elements or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
getOwnersElements
@PostMapping(path="/elements/by-ownership") public MetadataElementSummariesResponse getOwnersElements(@PathVariable String serverName, @PathVariable String urlMarker, @RequestParam(required=false,defaultValue="0") int startFrom, @RequestParam(required=false,defaultValue="0") int pageSize, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) FindNameProperties requestBody) Return information about the elements classified with the ownership classification.- Parameters:
serverName
- name of the server instance to connect tourlMarker
- view service URL markerstartFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for the request- Returns:
- classified elements or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
getMembersOfSubjectArea
@PostMapping(path="/elements/by-subject-area-membership") public MetadataElementSummariesResponse getMembersOfSubjectArea(@PathVariable String serverName, @PathVariable String urlMarker, @RequestParam(required=false,defaultValue="0") int startFrom, @RequestParam(required=false,defaultValue="0") int pageSize, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) FindNameProperties requestBody) Return information about the elements classified with the subject area classification.- Parameters:
serverName
- name of the server instance to connect tourlMarker
- view service URL markerstartFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for the request- Returns:
- classified elements or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
getAssetsByOrigin
@PostMapping(path="/elements/by-asset-origin") public MetadataElementSummariesResponse getAssetsByOrigin(@PathVariable String serverName, @PathVariable String urlMarker, @RequestParam(required=false,defaultValue="0") int startFrom, @RequestParam(required=false,defaultValue="0") int pageSize, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) FindAssetOriginProperties requestBody) Return information about the assets from a specific origin.- Parameters:
serverName
- name of the server instance to connect tourlMarker
- view service URL markerstartFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for the request- Returns:
- classified elements or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
getMeanings
@PostMapping("/glossaries/terms/by-semantic-assignment/{elementGUID}") public RelatedMetadataElementSummariesResponse getMeanings(@PathVariable String serverName, @PathVariable String urlMarker, @PathVariable String elementGUID, @RequestParam(required=false,defaultValue="0") int startFrom, @RequestParam(required=false,defaultValue="0") int pageSize, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) SemanticAssignmentQueryProperties requestBody) Retrieve the glossary terms linked via a "SemanticAssignment" relationship to the requested element.- Parameters:
serverName
- name of the server instance to connect tourlMarker
- view service URL markerelementGUID
- unique identifier of the element that is being assigned to the glossary termstartFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for relationship request- Returns:
- linked elements or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
getSemanticAssignees
@PostMapping("/elements/by-semantic-assignment/{glossaryTermGUID}") public RelatedMetadataElementSummariesResponse getSemanticAssignees(@PathVariable String serverName, @PathVariable String urlMarker, @PathVariable String glossaryTermGUID, @RequestParam(required=false,defaultValue="0") int startFrom, @RequestParam(required=false,defaultValue="0") int pageSize, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) SemanticAssignmentQueryProperties requestBody) Retrieve the elements linked via a "SemanticAssignment" relationship to the requested glossary term.- Parameters:
serverName
- name of the server instance to connect tourlMarker
- view service URL markerglossaryTermGUID
- unique identifier of the glossary term that the returned elements are linked tostartFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for relationship request- Returns:
- linked elements or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
getGovernedElements
@PostMapping(path="/elements/governed-by/{governanceDefinitionGUID}") public RelatedMetadataElementSummariesResponse getGovernedElements(@PathVariable String serverName, @PathVariable String urlMarker, @PathVariable String governanceDefinitionGUID, @RequestParam(required=false,defaultValue="0") int startFrom, @RequestParam(required=false,defaultValue="0") int pageSize, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) FindProperties requestBody) Retrieve the governance definitions linked via a "GovernedBy" relationship to the requested element.- Parameters:
serverName
- name of the server instance to connect tourlMarker
- view service URL markergovernanceDefinitionGUID
- unique identifier of the governance definition that the returned elements are linked tostartFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for relationship request- Returns:
- linked elements or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
getGovernedByDefinitions
@PostMapping(path="/elements/{elementGUID}/governed-by") public RelatedMetadataElementSummariesResponse getGovernedByDefinitions(@PathVariable String serverName, @PathVariable String urlMarker, @PathVariable String elementGUID, @RequestParam(required=false,defaultValue="0") int startFrom, @RequestParam(required=false,defaultValue="0") int pageSize, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) FindProperties requestBody) Retrieve the elements linked via a "GovernedBy" relationship to the requested governance definition.- Parameters:
serverName
- name of the server instance to connect tourlMarker
- view service URL markerelementGUID
- unique identifier of the element that the returned elements are linked tostartFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for relationship request- Returns:
- linked elements or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
getSourceElements
@PostMapping(path="/elements/{elementGUID}/source") public RelatedMetadataElementSummariesResponse getSourceElements(@PathVariable String serverName, @PathVariable String urlMarker, @PathVariable String elementGUID, @RequestParam(required=false,defaultValue="0") int startFrom, @RequestParam(required=false,defaultValue="0") int pageSize, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) FindProperties requestBody) Retrieve the elements linked via a "SourceFrom" relationship to the requested element. The elements returned were used to create the requested element. Typically only one element is returned.- Parameters:
serverName
- name of the server instance to connect tourlMarker
- view service URL markerelementGUID
- unique identifier of the element that the returned elements are linked tostartFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for relationship request- Returns:
- linked elements or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
getElementsSourcedFrom
@PostMapping(path="/elements/{elementGUID}/sourced-from") public RelatedMetadataElementSummariesResponse getElementsSourcedFrom(@PathVariable String serverName, @PathVariable String urlMarker, @PathVariable String elementGUID, @RequestParam(required=false,defaultValue="0") int startFrom, @RequestParam(required=false,defaultValue="0") int pageSize, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) FindProperties requestBody) Retrieve the elements linked via a "SourcedFrom" relationship to the requested element. The elements returned were created using the requested element as a template.- Parameters:
serverName
- name of the server instance to connect tourlMarker
- view service URL markerelementGUID
- unique identifier of the element that the returned elements are linked tostartFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for relationship request- Returns:
- linked elements or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
getMetadataElementByGUID
@PostMapping(path="/elements/{elementGUID}") public MetadataElementSummaryResponse getMetadataElementByGUID(@PathVariable String serverName, @PathVariable String urlMarker, @PathVariable String elementGUID, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) FindRequest requestBody) Retrieve the metadata element using its unique identifier.- Parameters:
serverName
- name of server instance to route request tourlMarker
- view service URL markerelementGUID
- unique identifier for the metadata elementforLineage
- the retrieved element is for lineage processing so include archived elementsforDuplicateProcessing
- the retrieved element is for duplicate processing so do not combine results from known duplicates.requestBody
- only return the element if it is effective at this time. Null means anytime. Use "new Date()" for now.- Returns:
- metadata element properties or InvalidParameterException the unique identifier is null or not known. UserNotAuthorizedException the governance action service is not able to access the element PropertyServerException there is a problem accessing the metadata store
-
getMetadataElementByUniqueName
@PostMapping(path="/elements/by-unique-name") public MetadataElementSummaryResponse getMetadataElementByUniqueName(@PathVariable String serverName, @PathVariable String urlMarker, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) FindPropertyNameProperties requestBody) Retrieve the metadata element using its unique name (typically the qualified name).- Parameters:
serverName
- name of server instance to route request tourlMarker
- view service URL markerforLineage
- the retrieved element is for lineage processing so include archived elementsforDuplicateProcessing
- the retrieved element is for duplicate processing so do not combine results from known duplicates.requestBody
- unique name for the metadata element- Returns:
- metadata element properties or InvalidParameterException the unique identifier is null or not known. UserNotAuthorizedException the governance action service is not able to access the element PropertyServerException there is a problem accessing the metadata store
-
getMetadataElementGUIDByUniqueName
@PostMapping(path="/elements/guid-by-unique-name") public GUIDResponse getMetadataElementGUIDByUniqueName(@PathVariable String serverName, @PathVariable String urlMarker, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody FindPropertyNameProperties requestBody) Retrieve the unique identifier of a metadata element using its unique name (typically the qualified name).- Parameters:
serverName
- name of server instance to route request tourlMarker
- view service URL markerforLineage
- the retrieved element is for lineage processing so include archived elementsforDuplicateProcessing
- the retrieved element is for duplicate processing so do not combine results from known duplicates.requestBody
- unique name for the metadata element- Returns:
- metadata element unique identifier (guid) or InvalidParameterException the unique identifier is null or not known or UserNotAuthorizedException the governance action service is not able to access the element or PropertyServerException there is a problem accessing the metadata store
-
getElements
@PostMapping(path="/elements/by-type") public MetadataElementSummariesResponse getElements(@PathVariable String serverName, @PathVariable String urlMarker, @RequestParam(required=false,defaultValue="0") int startFrom, @RequestParam(required=false,defaultValue="0") int pageSize, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) FindProperties requestBody) Retrieve elements of the requested type name.- Parameters:
serverName
- name of the server instance to connect tourlMarker
- view service URL markerstartFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- open metadata type to search on- Returns:
- list of matching 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)
-
getElementsByPropertyValue
@PostMapping(path="/elements/by-exact-property-value") public MetadataElementSummariesResponse getElementsByPropertyValue(@PathVariable String serverName, @PathVariable String urlMarker, @RequestParam(required=false,defaultValue="0") int startFrom, @RequestParam(required=false,defaultValue="0") int pageSize, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) FindPropertyNamesProperties requestBody) Retrieve elements by a value found in one of the properties specified. The value must match exactly. An open metadata type name may be supplied to restrict the results.- Parameters:
serverName
- name of the server instance to connect tourlMarker
- view service URL markerrequestBody
- properties and optional open metadata type to search onstartFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?- Returns:
- list of matching 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)
-
findElementsByPropertyValue
@PostMapping(path="/elements/by-property-value-search") public MetadataElementSummariesResponse findElementsByPropertyValue(@PathVariable String serverName, @PathVariable String urlMarker, @RequestParam(required=false,defaultValue="0") int startFrom, @RequestParam(required=false,defaultValue="0") int pageSize, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) FindPropertyNamesProperties requestBody) Retrieve elements by a value found in one of the properties specified. The value must only be contained in the properties rather than needing to be an exact match. An open metadata type name may be supplied to restrict the results.- Parameters:
serverName
- name of the server instance to connect tourlMarker
- view service URL markerrequestBody
- properties and optional open metadata type to search onstartFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?- Returns:
- list of matching 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)
-
getElementsByClassification
@PostMapping(path="/elements/by-classification/{classificationName}") public MetadataElementSummariesResponse getElementsByClassification(@PathVariable String serverName, @PathVariable String urlMarker, @PathVariable String classificationName, @RequestParam(required=false,defaultValue="0") int startFrom, @RequestParam(required=false,defaultValue="0") int pageSize, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) FindProperties requestBody) Retrieve elements with the requested classification name. It is also possible to limit the results by specifying a type name for the elements that should be returned. If no type name is specified then any type of element may be returned.- Parameters:
serverName
- name of the server instance to connect tourlMarker
- view service URL markerclassificationName
- name of classificationstartFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- open metadata type to search on- Returns:
- list of matching 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)
-
getElementsByClassificationWithPropertyValue
@PostMapping(path="/elements/by-classification/{classificationName}/with-exact-property-value") public MetadataElementSummariesResponse getElementsByClassificationWithPropertyValue(@PathVariable String serverName, @PathVariable String urlMarker, @PathVariable String classificationName, @RequestParam(required=false,defaultValue="0") int startFrom, @RequestParam(required=false,defaultValue="0") int pageSize, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) FindPropertyNamesProperties requestBody) Retrieve elements with the requested classification name and with the requested a value found in one of the classification's properties specified. The value must match exactly. An open metadata type name may be supplied to restrict the types of elements returned.- Parameters:
serverName
- name of the server instance to connect tourlMarker
- view service URL markerclassificationName
- name of classificationrequestBody
- properties and optional open metadata type to search onstartFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?- Returns:
- list of matching 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)
-
findElementsByClassificationWithPropertyValue
@PostMapping(path="/elements/by-classification/{classificationName}/with-property-value-search") public MetadataElementSummariesResponse findElementsByClassificationWithPropertyValue(@PathVariable String serverName, @PathVariable String urlMarker, @PathVariable String classificationName, @RequestParam(required=false,defaultValue="0") int startFrom, @RequestParam(required=false,defaultValue="0") int pageSize, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) FindPropertyNamesProperties requestBody) Retrieve elements with the requested classification name and with the requested a value found in one of the classification's properties specified. The value must only be contained in the properties rather than needing to be an exact match. An open metadata type name may be supplied to restrict the results.- Parameters:
serverName
- name of the server instance to connect tourlMarker
- view service URL markerclassificationName
- name of classificationrequestBody
- properties and optional open metadata type to search onstartFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?- Returns:
- list of matching 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)
-
getRelatedElements
@PostMapping(path="/elements/{elementGUID}/by-relationship") public RelatedMetadataElementSummariesResponse getRelatedElements(@PathVariable String serverName, @PathVariable String urlMarker, @PathVariable String elementGUID, @RequestParam(required=false,defaultValue="0") int startingAtEnd, @RequestParam(required=false,defaultValue="0") int startFrom, @RequestParam(required=false,defaultValue="0") int pageSize, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) FindProperties requestBody) Retrieve related elements of any type name.- Parameters:
serverName
- name of the server instance to connect tourlMarker
- view service URL markerelementGUID
- unique identifier of the starting elementstartingAtEnd
- indicates which end to retrieve from (0 is "either end"; 1 is end1; 2 is end 2)startFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- open metadata type to search on- Returns:
- list of matching 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)
-
getRelatedElements
@PostMapping(path="/elements/{elementGUID}/by-relationship/{relationshipTypeName}") public RelatedMetadataElementSummariesResponse getRelatedElements(@PathVariable String serverName, @PathVariable String urlMarker, @PathVariable String elementGUID, @PathVariable String relationshipTypeName, @RequestParam(required=false,defaultValue="0") int startingAtEnd, @RequestParam(required=false,defaultValue="0") int startFrom, @RequestParam(required=false,defaultValue="0") int pageSize, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) FindProperties requestBody) Retrieve related elements of the requested type name.- Parameters:
serverName
- name of the server instance to connect tourlMarker
- view service URL markerelementGUID
- unique identifier of the starting elementrelationshipTypeName
- name of relationshipstartingAtEnd
- indicates which end to retrieve from (0 is "either end"; 1 is end1; 2 is end 2)startFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- open metadata type to search on- Returns:
- list of matching 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)
-
getRelatedElementsWithPropertyValue
@PostMapping(path="/elements/{elementGUID}/by-relationship/{relationshipTypeName}/with-exact-property-value") public RelatedMetadataElementSummariesResponse getRelatedElementsWithPropertyValue(@PathVariable String serverName, @PathVariable String urlMarker, @PathVariable String elementGUID, @PathVariable String relationshipTypeName, @RequestParam(required=false,defaultValue="0") int startingAtEnd, @RequestParam(required=false,defaultValue="0") int startFrom, @RequestParam(required=false,defaultValue="0") int pageSize, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) FindPropertyNamesProperties requestBody) Retrieve elements linked via the requested relationship type name and with the requested value found in one of the relationship's properties specified. The value must match exactly. An open metadata type name may be supplied to restrict the types of elements returned.- Parameters:
serverName
- name of the server instance to connect tourlMarker
- view service URL markerelementGUID
- unique identifier of the starting elementrelationshipTypeName
- name of relationshipstartingAtEnd
- indicates which end to retrieve from (0 is "either end"; 1 is end1; 2 is end 2)requestBody
- properties and optional open metadata type to search onstartFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?- Returns:
- list of matching 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)
-
findRelatedElementsWithPropertyValue
@PostMapping(path="/elements/{elementGUID}/by-relationship/{relationshipTypeName}/with-property-value-search") public RelatedMetadataElementSummariesResponse findRelatedElementsWithPropertyValue(@PathVariable String serverName, @PathVariable String urlMarker, @PathVariable String elementGUID, @PathVariable String relationshipTypeName, @RequestParam(required=false,defaultValue="0") int startingAtEnd, @RequestParam(required=false,defaultValue="0") int startFrom, @RequestParam(required=false,defaultValue="0") int pageSize, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) FindPropertyNamesProperties requestBody) Retrieve elements linked via the requested relationship type name and with the relationship's properties specified. The value must only be contained in the by a value found in one of the properties specified. The value must only be contained in the properties rather than needing to be an exact match. An open metadata type name may be supplied to restrict the results.- Parameters:
serverName
- name of the server instance to connect tourlMarker
- view service URL markerelementGUID
- unique identifier of the starting elementrelationshipTypeName
- name of relationshipstartingAtEnd
- indicates which end to retrieve from (0 is "either end"; 1 is end1; 2 is end 2)requestBody
- properties and optional open metadata type to search onstartFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?- Returns:
- list of matching 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)
-
getRelationships
@PostMapping(path="/relationships") public MetadataRelationshipSummariesResponse getRelationships(@PathVariable String serverName, @PathVariable String urlMarker, @RequestParam(required=false,defaultValue="0") int startFrom, @RequestParam(required=false,defaultValue="0") int pageSize, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) FindProperties requestBody) Retrieve relationships of the requested relationship type name.- Parameters:
serverName
- name of the server instance to connect tourlMarker
- view service URL markerstartFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- open metadata type to search on- Returns:
- list of matching 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)
-
getRelationshipsWithPropertyValue
@PostMapping(path="/relationships/with-exact-property-value") public MetadataRelationshipSummariesResponse getRelationshipsWithPropertyValue(@PathVariable String serverName, @PathVariable String urlMarker, @RequestParam(required=false,defaultValue="0") int startFrom, @RequestParam(required=false,defaultValue="0") int pageSize, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) FindPropertyNamesProperties requestBody) Retrieve relationships of the requested relationship type name and with the requested a value found in one of the relationship's properties specified. The value must match exactly.- Parameters:
serverName
- name of the server instance to connect tourlMarker
- view service URL markerrequestBody
- properties and optional open metadata type to search onstartFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?- Returns:
- list of matching 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)
-
findRelationshipsWithPropertyValue
@PostMapping(path="/relationships/with-property-value-search") public MetadataRelationshipSummariesResponse findRelationshipsWithPropertyValue(@PathVariable String serverName, @PathVariable String urlMarker, @RequestParam(required=false,defaultValue="0") int startFrom, @RequestParam(required=false,defaultValue="0") int pageSize, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) FindPropertyNamesProperties requestBody) Retrieve relationships of the requested relationship type name and with the requested a value found in one of the relationship's properties specified. The value must only be contained in the properties rather than needing to be an exact match.- Parameters:
serverName
- name of the server instance to connect tourlMarker
- view service URL markerrequestBody
- properties and optional open metadata type to search onstartFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?- Returns:
- list of matching 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)
-
retrieveInstanceForGUID
@PostMapping(path="/guids/{guid}") public ElementHeaderResponse retrieveInstanceForGUID(@PathVariable String serverName, @PathVariable String urlMarker, @PathVariable String guid, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) ResultsRequestBody requestBody) Retrieve the header for the instance identified by the supplied unique identifier. It may be an element (entity) or a relationship between elements.- Parameters:
serverName
- name of the server instance to connect tourlMarker
- view service URL markerguid
- identifier to use in the lookupforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?- Returns:
- list of matching 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)
-