Class StewardshipExchangeResource
java.lang.Object
org.odpi.openmetadata.accessservices.assetmanager.server.spring.StewardshipExchangeResource
@RestController
@RequestMapping("/servers/{serverName}/open-metadata/access-services/asset-manager/users/{userId}")
public class StewardshipExchangeResource
extends Object
The StewardshipExchangeResource provides part of the server-side implementation of the Asset Manager Open Metadata
Assess Service (OMAS). This interface provides the ability to add governance related classifications and relationship to elements.
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionaddAssetOrigin
(String serverName, String userId, String assetGUID, boolean forLineage, boolean forDuplicateProcessing, ClassificationRequestBody requestBody) Add or replace the origin classification for an asset.addElementToSubjectArea
(String serverName, String userId, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, ClassificationRequestBody requestBody) Classify the element to assert that the definitions it represents are part of a subject area definition.addGovernanceDefinitionToElement
(String serverName, String userId, String definitionGUID, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, RelationshipRequestBody requestBody) Link a governance definition to an element using the GovernedBy relationship.addOwnership
(String serverName, String userId, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, ClassificationRequestBody requestBody) Add or replace the ownership classification for an element.addSecurityTags
(String serverName, String userId, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, ClassificationRequestBody requestBody) Add or replace the security tags for an element.clearAssetOrigin
(String serverName, String userId, String assetGUID, boolean forLineage, boolean forDuplicateProcessing, ClassificationRequestBody requestBody) Remove the origin classification from an asset.clearConfidenceClassification
(String serverName, String userId, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, ClassificationRequestBody requestBody) Remove the confidence classification from the element.clearConfidentialityClassification
(String serverName, String userId, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, ClassificationRequestBody requestBody) Remove the confidence classification from the element.clearCriticalityClassification
(String serverName, String userId, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, ClassificationRequestBody requestBody) Remove the criticality classification from the element.clearDataFieldClassification
(String serverName, String userId, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, ClassificationRequestBody requestBody) Remove the data field classification from the element.clearOwnership
(String serverName, String userId, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, ClassificationRequestBody requestBody) Remove the ownership classification from an element.clearRetentionClassification
(String serverName, String userId, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, ClassificationRequestBody requestBody) Remove the retention classification from the element.clearSemanticAssignment
(String serverName, String userId, String elementGUID, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, EffectiveTimeQueryRequestBody requestBody) Remove a semantic assignment relationship between an element and its glossary term.getAssetsByOrigin
(String serverName, String userId, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, FindByPropertiesRequestBody requestBody) Return information about the assets from a specific origin.getDataFieldClassifiedElements
(String serverName, String userId, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, FindByPropertiesRequestBody requestBody) Return information about the elements classified with the data field classification.getElementsSourceFrom
(String serverName, String userId, String elementGUID, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, EffectiveTimeQueryRequestBody requestBody) Retrieve the elements linked via a "SourceFrom" relationship to the requested element.getGovernedByDefinitions
(String serverName, String userId, String elementGUID, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, EffectiveTimeQueryRequestBody requestBody) Retrieve the elements linked via a "GovernedBy" relationship to the requested governance definition.getGovernedElements
(String serverName, String userId, String governanceDefinitionGUID, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, EffectiveTimeQueryRequestBody requestBody) Retrieve the governance definitions linked via a "GovernedBy" relationship to the requested element.getMeanings
(String serverName, String userId, String elementGUID, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, EffectiveTimeQueryRequestBody requestBody) Retrieve the glossary terms linked via a "SemanticAssignment" relationship to the requested element.getMembersOfSubjectArea
(String serverName, String userId, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, FindByPropertiesRequestBody requestBody) Return information about the elements classified with the security tags classification.getSemanticAssignees
(String serverName, String userId, String glossaryTermGUID, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, EffectiveTimeQueryRequestBody requestBody) Retrieve the glossary terms linked via a "SemanticAssignment" relationship to the requested element.getSourceElements
(String serverName, String userId, String elementGUID, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, EffectiveTimeQueryRequestBody requestBody) Retrieve the elements linked via a "SourceFrom" relationship to the requested element.removeElementFromSubjectArea
(String serverName, String userId, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, ClassificationRequestBody requestBody) Remove the subject area designation from the identified element.removeGovernanceDefinitionFromElement
(String serverName, String userId, String definitionGUID, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, EffectiveTimeQueryRequestBody requestBody) Remove the GovernedBy relationship between a governance definition and an element.removeSecurityTags
(String serverName, String userId, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, ClassificationRequestBody requestBody) Remove the security tags classification from an element.setConfidenceClassification
(String serverName, String userId, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, ClassificationRequestBody requestBody) Classify/reclassify the element (typically an asset) to indicate the level of confidence that the organization has that the data is complete, accurate and up-to-date.setConfidentialityClassification
(String serverName, String userId, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, ClassificationRequestBody requestBody) Classify/reclassify the element (typically a data field, schema attribute or glossary term) to indicate the level of confidentiality that any data associated with the element should be given.setCriticalityClassification
(String serverName, String userId, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, ClassificationRequestBody requestBody) Classify/reclassify the element (typically an asset) to indicate how critical the element (or associated resource) is to the organization.setDataFieldClassification
(String serverName, String userId, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, ClassificationRequestBody requestBody) Classify the element to indicate that it describes a data field and supply properties that describe the characteristics of the data values found within.setRetentionClassification
(String serverName, String userId, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, ClassificationRequestBody requestBody) Classify/reclassify the element (typically an asset) to indicate how long the element (or associated resource) is to be retained by the organization.setupSemanticAssignment
(String serverName, String userId, String elementGUID, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, RelationshipRequestBody requestBody) Create a semantic assignment relationship between a glossary term and an element (normally a schema attribute, data field or asset).
-
Constructor Details
-
StewardshipExchangeResource
public StewardshipExchangeResource()Default constructor
-
-
Method Details
-
setDataFieldClassification
@PostMapping(path="/elements/{elementGUID}/data-field") public VoidResponse setDataFieldClassification(@PathVariable String serverName, @PathVariable String userId, @PathVariable String elementGUID, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) ClassificationRequestBody requestBody) Classify the element to indicate that it describes a data field and supply properties that describe the characteristics of the data values found within.- Parameters:
serverName
- name of the server instance to connect touserId
- calling userelementGUID
- unique identifier of the metadata element to classifyforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for the request- Returns:
- void or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
clearDataFieldClassification
@PostMapping(path="/elements/{elementGUID}/data-field/remove") public VoidResponse clearDataFieldClassification(@PathVariable String serverName, @PathVariable String userId, @PathVariable String elementGUID, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) ClassificationRequestBody requestBody) Remove the data field classification from the element.- Parameters:
serverName
- name of the server instance to connect touserId
- calling userelementGUID
- unique identifier of the metadata element to unclassifyforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for the request- Returns:
- void or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
getDataFieldClassifiedElements
@PostMapping(path="/elements/by-data-field") public ElementStubsResponse getDataFieldClassifiedElements(@PathVariable String serverName, @PathVariable String userId, @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) FindByPropertiesRequestBody requestBody) Return information about the elements classified with the data field classification.- Parameters:
serverName
- name of the server instance to connect touserId
- calling userstartFrom
- 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
-
setConfidenceClassification
@PostMapping(path="/elements/{elementGUID}/confidence") public VoidResponse setConfidenceClassification(@PathVariable String serverName, @PathVariable String userId, @PathVariable String elementGUID, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) ClassificationRequestBody requestBody) Classify/reclassify the element (typically an asset) to indicate the level of confidence that the organization has that the data is complete, accurate and up-to-date. The level of confidence is expressed by the levelIdentifier property.- Parameters:
serverName
- name of the server instance to connect touserId
- calling userelementGUID
- unique identifier of the metadata element to classifyforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for the request- Returns:
- void or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
clearConfidenceClassification
@PostMapping(path="/elements/{elementGUID}/confidence/remove") public VoidResponse clearConfidenceClassification(@PathVariable String serverName, @PathVariable String userId, @PathVariable String elementGUID, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) ClassificationRequestBody requestBody) Remove the confidence classification from the element. This normally occurs when the organization has lost track of the level of confidence to assign to the element.- Parameters:
serverName
- name of the server instance to connect touserId
- calling userelementGUID
- unique identifier of the metadata element to unclassifyforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for the request- Returns:
- void or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
setCriticalityClassification
@PostMapping(path="/elements/{elementGUID}/criticality") public VoidResponse setCriticalityClassification(@PathVariable String serverName, @PathVariable String userId, @PathVariable String elementGUID, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) ClassificationRequestBody requestBody) Classify/reclassify the element (typically an asset) to indicate how critical the element (or associated resource) is to the organization. The level of criticality is expressed by the levelIdentifier property.- Parameters:
serverName
- name of the server instance to connect touserId
- calling userelementGUID
- unique identifier of the metadata element to classifyforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for the request- Returns:
- void or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
clearCriticalityClassification
@PostMapping(path="/elements/{elementGUID}/criticality/remove") public VoidResponse clearCriticalityClassification(@PathVariable String serverName, @PathVariable String userId, @PathVariable String elementGUID, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) ClassificationRequestBody requestBody) Remove the criticality classification from the element. This normally occurs when the organization has lost track of the level of criticality to assign to the element.- Parameters:
serverName
- name of the server instance to connect touserId
- calling userelementGUID
- unique identifier of the metadata element to unclassifyforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for the request- Returns:
- void or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
setConfidentialityClassification
@PostMapping(path="/elements/{elementGUID}/confidentiality") public VoidResponse setConfidentialityClassification(@PathVariable String serverName, @PathVariable String userId, @PathVariable String elementGUID, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) ClassificationRequestBody requestBody) Classify/reclassify the element (typically a data field, schema attribute or glossary term) to indicate the level of confidentiality that any data associated with the element should be given. If the classification is attached to a glossary term, the level of confidentiality is a suggestion for any element linked to the glossary term via the SemanticAssignment classification. The level of confidence is expressed by the levelIdentifier property.- Parameters:
serverName
- name of the server instance to connect touserId
- calling userelementGUID
- unique identifier of the metadata element to classifyforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for the request- Returns:
- void or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
clearConfidentialityClassification
@PostMapping(path="/elements/{elementGUID}/confidentiality/remove") public VoidResponse clearConfidentialityClassification(@PathVariable String serverName, @PathVariable String userId, @PathVariable String elementGUID, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) ClassificationRequestBody requestBody) Remove the confidence classification from the element. This normally occurs when the organization has lost track of the level of confidentiality to assign to the element.- Parameters:
serverName
- name of the server instance to connect touserId
- calling userelementGUID
- unique identifier of the metadata element to unclassifyforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for the request- Returns:
- void or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
setRetentionClassification
@PostMapping(path="/elements/{elementGUID}/retention") public VoidResponse setRetentionClassification(@PathVariable String serverName, @PathVariable String userId, @PathVariable String elementGUID, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) ClassificationRequestBody requestBody) Classify/reclassify the element (typically an asset) to indicate how long the element (or associated resource) is to be retained by the organization. The policy to apply to the element/resource is captured by the retentionBasis property. The dates after which the element/resource is archived and then deleted are specified in the archiveAfter and deleteAfter properties respectively.- Parameters:
serverName
- name of the server instance to connect touserId
- calling userelementGUID
- unique identifier of the metadata element to classifyforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for the request- Returns:
- void or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
clearRetentionClassification
@PostMapping(path="/elements/{elementGUID}/retention/remove") public VoidResponse clearRetentionClassification(@PathVariable String serverName, @PathVariable String userId, @PathVariable String elementGUID, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) ClassificationRequestBody requestBody) Remove the retention classification from the element. This normally occurs when the organization has lost track of, or no longer needs to track the retention period to assign to the element.- Parameters:
serverName
- name of the server instance to connect touserId
- calling userelementGUID
- unique identifier of the metadata element to declassifyforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for the request- Returns:
- void or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
addSecurityTags
@PostMapping(path="/elements/{elementGUID}/security-tags") public VoidResponse addSecurityTags(@PathVariable String serverName, @PathVariable String userId, @PathVariable String elementGUID, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) ClassificationRequestBody requestBody) Add or replace the security tags for an element.- Parameters:
serverName
- name of the server instance to connect touserId
- calling userelementGUID
- unique identifier of element to attach toforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- list of security labels and properties- Returns:
- void or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
removeSecurityTags
@PostMapping(path="/elements/{elementGUID}/security-tags/remove") public VoidResponse removeSecurityTags(@PathVariable String serverName, @PathVariable String userId, @PathVariable String elementGUID, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) ClassificationRequestBody requestBody) Remove the security tags classification from an element.- Parameters:
serverName
- name of the server instance to connect touserId
- calling userelementGUID
- unique identifier of elementforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- null request body- Returns:
- void or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
addOwnership
@PostMapping(path="/elements/{elementGUID}/ownership") public VoidResponse addOwnership(@PathVariable String serverName, @PathVariable String userId, @PathVariable String elementGUID, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) ClassificationRequestBody requestBody) Add or replace the ownership classification for an element.- Parameters:
serverName
- name of the server instance to connect touserId
- calling userelementGUID
- element to link it to - its type must inherit from Referenceable.forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for classification request- Returns:
- void or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
clearOwnership
@PostMapping(path="/elements/{elementGUID}/ownership/remove") public VoidResponse clearOwnership(@PathVariable String serverName, @PathVariable String userId, @PathVariable String elementGUID, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) ClassificationRequestBody requestBody) Remove the ownership classification from an element.- Parameters:
serverName
- name of the server instance to connect touserId
- calling userelementGUID
- element where the classification needs to be removed.forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for classification request- Returns:
- void or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
addAssetOrigin
@PostMapping(path="/assets/{assetGUID}/origin") public VoidResponse addAssetOrigin(@PathVariable String serverName, @PathVariable String userId, @PathVariable String assetGUID, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) ClassificationRequestBody requestBody) Add or replace the origin classification for an asset.- Parameters:
serverName
- name of the server instance to connect touserId
- calling userassetGUID
- element to link it to - its type must inherit from Asset.forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for classification request- Returns:
- void or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
clearAssetOrigin
@PostMapping(path="/assets/{assetGUID}/origin/remove") public VoidResponse clearAssetOrigin(@PathVariable String serverName, @PathVariable String userId, @PathVariable String assetGUID, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) ClassificationRequestBody requestBody) Remove the origin classification from an asset.- Parameters:
serverName
- name of the server instance to connect touserId
- calling userassetGUID
- element where the classification needs to be removed.forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for classification request- Returns:
- void or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
getAssetsByOrigin
@PostMapping(path="/asset/by-origin") public AssetElementsResponse getAssetsByOrigin(@PathVariable String serverName, @PathVariable String userId, @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) FindByPropertiesRequestBody requestBody) Return information about the assets from a specific origin.- Parameters:
serverName
- name of the server instance to connect touserId
- calling userstartFrom
- 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
-
addElementToSubjectArea
@PostMapping(path="/elements/{elementGUID}/subject-area-member") public VoidResponse addElementToSubjectArea(@PathVariable String serverName, @PathVariable String userId, @PathVariable String elementGUID, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) ClassificationRequestBody requestBody) Classify the element to assert that the definitions it represents are part of a subject area definition.- Parameters:
serverName
- name of the server instance to connect touserId
- calling userelementGUID
- unique identifier of the metadata element to updateforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for classification request- Returns:
- void or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
removeElementFromSubjectArea
@PostMapping(path="/elements/{elementGUID}/subject-area-member/remove") public VoidResponse removeElementFromSubjectArea(@PathVariable String serverName, @PathVariable String userId, @PathVariable String elementGUID, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) ClassificationRequestBody requestBody) Remove the subject area designation from the identified element.- Parameters:
serverName
- name of the server instance to connect touserId
- calling userelementGUID
- unique identifier of the metadata element to updateforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for classification request- Returns:
- void 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 ElementStubsResponse getMembersOfSubjectArea(@PathVariable String serverName, @PathVariable String userId, @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) FindByPropertiesRequestBody requestBody) Return information about the elements classified with the security tags classification.- Parameters:
serverName
- name of the server instance to connect touserId
- calling userstartFrom
- 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
-
setupSemanticAssignment
@PostMapping(path="/elements/{elementGUID}/semantic-assignment/terms/{glossaryTermGUID}") public VoidResponse setupSemanticAssignment(@PathVariable String serverName, @PathVariable String userId, @PathVariable String elementGUID, @PathVariable String glossaryTermGUID, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) RelationshipRequestBody requestBody) Create a semantic assignment relationship between a glossary term and an element (normally a schema attribute, data field or asset). This relationship indicates that the data associated with the element meaning matches the description in the glossary term.- Parameters:
serverName
- name of the server instance to connect touserId
- calling userelementGUID
- unique identifier of the element that is being assigned to the glossary termglossaryTermGUID
- unique identifier of the glossary term that provides the meaningforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for relationship request- Returns:
- void or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
clearSemanticAssignment
@PostMapping(path="/elements/{elementGUID}/semantic-assignment/terms/{glossaryTermGUID}/remove") public VoidResponse clearSemanticAssignment(@PathVariable String serverName, @PathVariable String userId, @PathVariable String elementGUID, @PathVariable String glossaryTermGUID, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) EffectiveTimeQueryRequestBody requestBody) Remove a semantic assignment relationship between an element and its glossary term.- Parameters:
serverName
- name of the server instance to connect touserId
- calling userelementGUID
- unique identifier of the element that is being assigned to the glossary termglossaryTermGUID
- unique identifier of the glossary term that provides the meaningforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for relationship request- Returns:
- void 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 GlossaryTermElementsResponse getMeanings(@PathVariable String serverName, @PathVariable String userId, @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) EffectiveTimeQueryRequestBody requestBody) Retrieve the glossary terms linked via a "SemanticAssignment" relationship to the requested element.- Parameters:
serverName
- name of the server instance to connect touserId
- calling userelementGUID
- 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 RelatedElementsResponse getSemanticAssignees(@PathVariable String serverName, @PathVariable String userId, @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) EffectiveTimeQueryRequestBody requestBody) Retrieve the glossary terms linked via a "SemanticAssignment" relationship to the requested element.- Parameters:
serverName
- name of the server instance to connect touserId
- calling userglossaryTermGUID
- 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
-
addGovernanceDefinitionToElement
@PostMapping(path="/elements/{elementGUID}/governed-by/definition/{definitionGUID}") public VoidResponse addGovernanceDefinitionToElement(@PathVariable String serverName, @PathVariable String userId, @PathVariable String definitionGUID, @PathVariable String elementGUID, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) RelationshipRequestBody requestBody) Link a governance definition to an element using the GovernedBy relationship.- Parameters:
serverName
- name of the server instance to connect touserId
- calling userdefinitionGUID
- identifier of the governance definition to linkelementGUID
- unique identifier of the metadata element to linkforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for relationship request- Returns:
- void or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem
-
removeGovernanceDefinitionFromElement
@PostMapping(path="/elements/{elementGUID}/governed-by/definition/{definitionGUID}/remove") public VoidResponse removeGovernanceDefinitionFromElement(@PathVariable String serverName, @PathVariable String userId, @PathVariable String definitionGUID, @PathVariable String elementGUID, @RequestParam(required=false,defaultValue="false") boolean forLineage, @RequestParam(required=false,defaultValue="false") boolean forDuplicateProcessing, @RequestBody(required=false) EffectiveTimeQueryRequestBody requestBody) Remove the GovernedBy relationship between a governance definition and an element.- Parameters:
serverName
- name of the server instance to connect touserId
- calling userdefinitionGUID
- identifier of the governance definition to linkelementGUID
- unique identifier of the metadata element to updateforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?requestBody
- properties for relationship request- Returns:
- void 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 RelatedElementsResponse getGovernedElements(@PathVariable String serverName, @PathVariable String userId, @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) EffectiveTimeQueryRequestBody requestBody) Retrieve the governance definitions linked via a "GovernedBy" relationship to the requested element.- Parameters:
serverName
- name of the server instance to connect touserId
- calling usergovernanceDefinitionGUID
- 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 GovernanceDefinitionsResponse getGovernedByDefinitions(@PathVariable String serverName, @PathVariable String userId, @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) EffectiveTimeQueryRequestBody requestBody) Retrieve the elements linked via a "GovernedBy" relationship to the requested governance definition.- Parameters:
serverName
- name of the server instance to connect touserId
- calling userelementGUID
- 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/sourced-from/{elementGUID}") public RelatedElementsResponse getSourceElements(@PathVariable String serverName, @PathVariable String userId, @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) EffectiveTimeQueryRequestBody 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 touserId
- calling userelementGUID
- 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
-
getElementsSourceFrom
@PostMapping(path="/elements/{elementGUID}/sourced-from") public RelatedElementsResponse getElementsSourceFrom(@PathVariable String serverName, @PathVariable String userId, @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) EffectiveTimeQueryRequestBody requestBody) Retrieve the elements linked via a "SourceFrom" 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 touserId
- calling userelementGUID
- 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
-