Class ClassificationManagerRESTServices
java.lang.Object
org.odpi.openmetadata.tokencontroller.TokenController
org.odpi.openmetadata.viewservices.classificationmanager.server.ClassificationManagerRESTServices
The ClassificationManagerRESTServices provides the implementation of the Classification ManagerOpen Metadata View Service (OMVS).
This interface provides view interfaces for infrastructure and ops users.
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionaddElementToSubjectArea
(String serverName, 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 elementGUID, String definitionGUID, boolean forLineage, boolean forDuplicateProcessing, RelationshipRequestBody requestBody) Link a governance definition to an element using the GovernedBy relationship.addOwnership
(String serverName, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, ClassificationRequestBody requestBody) Add or replace the ownership classification for an element.addScopeToElement
(String serverName, String elementGUID, String scopeGUID, boolean forLineage, boolean forDuplicateProcessing, RelationshipRequestBody requestBody) Link a scope to an element using the ScopedBy relationship.addSecurityTags
(String serverName, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, ClassificationRequestBody requestBody) Add or replace the security tags for an element.addStakeholderToElement
(String serverName, String elementGUID, String stakeholderGUID, boolean forLineage, boolean forDuplicateProcessing, RelationshipRequestBody requestBody) Link a stakeholder to an element using the Stakeholder relationship.certifyElement
(String serverName, String elementGUID, String certificationTypeGUID, RelationshipRequestBody requestBody) Link an element to a certification type and include details of the certification in the relationship properties.clearConfidenceClassification
(String serverName, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, MetadataSourceRequestBody requestBody) Remove the confidence classification from the element.clearConfidentialityClassification
(String serverName, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, MetadataSourceRequestBody requestBody) Remove the confidence classification from the element.clearCriticalityClassification
(String serverName, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, MetadataSourceRequestBody requestBody) Remove the criticality classification from the element.clearOwnership
(String serverName, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, MetadataSourceRequestBody requestBody) Remove the ownership classification from an element.clearRetentionClassification
(String serverName, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, MetadataSourceRequestBody requestBody) Remove the retention classification from the element.clearSecurityTags
(String serverName, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, MetadataSourceRequestBody requestBody) Remove the security tags classification from an element.clearSemanticAssignment
(String serverName, String elementGUID, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, MetadataSourceRequestBody requestBody) Remove a semantic assignment relationship between an element and its glossary term.decertifyElement
(String serverName, String certificationGUID, MetadataSourceRequestBody requestBody) Remove the certification for an element.licenseElement
(String serverName, String elementGUID, String licenseTypeGUID, RelationshipRequestBody requestBody) Link an element to a license type and include details of the license in the relationship properties.removeElementFromSubjectArea
(String serverName, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, MetadataSourceRequestBody requestBody) Remove the subject area designation from the identified element.removeGovernanceDefinitionFromElement
(String serverName, String elementGUID, String definitionGUID, boolean forLineage, boolean forDuplicateProcessing, MetadataSourceRequestBody requestBody) Remove the GovernedBy relationship between a governance definition and an element.removeScopeFromElement
(String serverName, String elementGUID, String scopeGUID, boolean forLineage, boolean forDuplicateProcessing, MetadataSourceRequestBody requestBody) Remove the ScopedBy relationship between a scope and an element.removeStakeholderFromElement
(String serverName, String elementGUID, String stakeholderGUID, boolean forLineage, boolean forDuplicateProcessing, MetadataSourceRequestBody requestBody) Remove the Stakeholder relationship between a stakeholder (typically Actor) and an element.setConfidenceClassification
(String serverName, 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 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 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.setRetentionClassification
(String serverName, 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 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).unlicenseElement
(String serverName, String licenseGUID, MetadataSourceRequestBody requestBody) Remove the license for an element.updateCertification
(String serverName, String certificationGUID, boolean replaceAllProperties, RelationshipRequestBody requestBody) Update the properties of a certification.updateLicense
(String serverName, String licenseGUID, boolean replaceAllProperties, RelationshipRequestBody requestBody) Update the properties of a license.Methods inherited from class org.odpi.openmetadata.tokencontroller.TokenController
getUser
-
Constructor Details
-
ClassificationManagerRESTServices
public ClassificationManagerRESTServices()Default constructor
-
-
Method Details
-
setConfidenceClassification
public VoidResponse setConfidenceClassification(String serverName, 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. The level of confidence is expressed by the levelIdentifier property.- Parameters:
serverName
- name of the server instance to connect toelementGUID
- 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
public VoidResponse clearConfidenceClassification(String serverName, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, MetadataSourceRequestBody 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 toelementGUID
- 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
-
setCriticalityClassification
public VoidResponse setCriticalityClassification(String serverName, 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. The level of criticality is expressed by the levelIdentifier property.- Parameters:
serverName
- name of the server instance to connect toelementGUID
- 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
public VoidResponse clearCriticalityClassification(String serverName, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, MetadataSourceRequestBody 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 toelementGUID
- 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
-
setConfidentialityClassification
public VoidResponse setConfidentialityClassification(String serverName, 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. 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 toelementGUID
- 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
public VoidResponse clearConfidentialityClassification(String serverName, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, MetadataSourceRequestBody 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 toelementGUID
- 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
-
setRetentionClassification
public VoidResponse setRetentionClassification(String serverName, 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. 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 toelementGUID
- 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
public VoidResponse clearRetentionClassification(String serverName, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, MetadataSourceRequestBody 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 toelementGUID
- 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
public VoidResponse addSecurityTags(String serverName, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, ClassificationRequestBody requestBody) Add or replace the security tags for an element.- Parameters:
serverName
- name of the server instance to connect toelementGUID
- 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
-
clearSecurityTags
public VoidResponse clearSecurityTags(String serverName, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, MetadataSourceRequestBody requestBody) Remove the security tags classification from an element.- Parameters:
serverName
- name of the server instance to connect toelementGUID
- unique identifier of elementforLineage
- 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
-
addOwnership
public VoidResponse addOwnership(String serverName, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, ClassificationRequestBody requestBody) Add or replace the ownership classification for an element.- Parameters:
serverName
- name of the server instance to connect toelementGUID
- 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
public VoidResponse clearOwnership(String serverName, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, MetadataSourceRequestBody requestBody) Remove the ownership classification from an element.- Parameters:
serverName
- name of the server instance to connect toelementGUID
- element where the classification needs to be cleared from.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
-
addElementToSubjectArea
public VoidResponse addElementToSubjectArea(String serverName, 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.- Parameters:
serverName
- name of the server instance to connect toelementGUID
- 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
public VoidResponse removeElementFromSubjectArea(String serverName, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, MetadataSourceRequestBody requestBody) Remove the subject area designation from the identified element.- Parameters:
serverName
- name of the server instance to connect toelementGUID
- 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
-
setupSemanticAssignment
public VoidResponse setupSemanticAssignment(String serverName, 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). 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 toelementGUID
- 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
public VoidResponse clearSemanticAssignment(String serverName, String elementGUID, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, MetadataSourceRequestBody requestBody) Remove a semantic assignment relationship between an element and its glossary term.- Parameters:
serverName
- name of the server instance to connect toelementGUID
- unique identifier of the element that is being assigned to the glossary termglossaryTermGUID
- unique identifier of the glossary term that provides the meaningrequestBody
- 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
-
addGovernanceDefinitionToElement
public VoidResponse addGovernanceDefinitionToElement(String serverName, String elementGUID, String definitionGUID, boolean forLineage, boolean forDuplicateProcessing, RelationshipRequestBody requestBody) Link a governance definition to an element using the GovernedBy relationship.- Parameters:
serverName
- name of the server instance to connect toelementGUID
- unique identifier of the metadata element to linkdefinitionGUID
- identifier of the governance definition to linkrequestBody
- 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
public VoidResponse removeGovernanceDefinitionFromElement(String serverName, String elementGUID, String definitionGUID, boolean forLineage, boolean forDuplicateProcessing, MetadataSourceRequestBody requestBody) Remove the GovernedBy relationship between a governance definition and an element.- Parameters:
serverName
- name of the server instance to connect toelementGUID
- unique identifier of the metadata element to updatedefinitionGUID
- identifier of the governance definition to linkrequestBody
- 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
-
addStakeholderToElement
public VoidResponse addStakeholderToElement(String serverName, String elementGUID, String stakeholderGUID, boolean forLineage, boolean forDuplicateProcessing, RelationshipRequestBody requestBody) Link a stakeholder to an element using the Stakeholder relationship.- Parameters:
serverName
- name of the server instance to connect toelementGUID
- unique identifier of the metadata element to linkstakeholderGUID
- identifier of the governance definition to linkrequestBody
- 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
-
removeStakeholderFromElement
public VoidResponse removeStakeholderFromElement(String serverName, String elementGUID, String stakeholderGUID, boolean forLineage, boolean forDuplicateProcessing, MetadataSourceRequestBody requestBody) Remove the Stakeholder relationship between a stakeholder (typically Actor) and an element.- Parameters:
serverName
- name of the server instance to connect toelementGUID
- unique identifier of the metadata element to updatestakeholderGUID
- identifier of the governance definition to linkrequestBody
- 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
-
addScopeToElement
public VoidResponse addScopeToElement(String serverName, String elementGUID, String scopeGUID, boolean forLineage, boolean forDuplicateProcessing, RelationshipRequestBody requestBody) Link a scope to an element using the ScopedBy relationship.- Parameters:
serverName
- name of the server instance to connect toelementGUID
- unique identifier of the metadata element to linkscopeGUID
- identifier of the scope to linkrequestBody
- 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
-
removeScopeFromElement
public VoidResponse removeScopeFromElement(String serverName, String elementGUID, String scopeGUID, boolean forLineage, boolean forDuplicateProcessing, MetadataSourceRequestBody requestBody) Remove the ScopedBy relationship between a scope and an element.- Parameters:
serverName
- name of the server instance to connect toelementGUID
- unique identifier of the metadata element to updatescopeGUID
- identifier of the scope to linkrequestBody
- 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
-
licenseElement
public GUIDResponse licenseElement(String serverName, String elementGUID, String licenseTypeGUID, RelationshipRequestBody requestBody) Link an element to a license type and include details of the license in the relationship properties.- Parameters:
serverName
- name of the server instance to connect toelementGUID
- unique identifier of the element being licensedlicenseTypeGUID
- unique identifier for the license typerequestBody
- the properties of the license- Returns:
- guid or InvalidParameterException one of the properties is invalid PropertyServerException problem accessing property server UserNotAuthorizedException security access problem
-
updateLicense
public VoidResponse updateLicense(String serverName, String licenseGUID, boolean replaceAllProperties, RelationshipRequestBody requestBody) Update the properties of a license. Remember to include the licenseId in the properties if the element has multiple licenses for the same license type.- Parameters:
serverName
- name of the server instance to connect tolicenseGUID
- unique identifier for the license typereplaceAllProperties
- flag to indicate whether to completely replace the existing properties with the new properties, or just update the individual properties specified on the request.requestBody
- the properties of the license- Returns:
- void or InvalidParameterException one of the properties is invalid PropertyServerException problem accessing property server UserNotAuthorizedException security access problem
-
unlicenseElement
public VoidResponse unlicenseElement(String serverName, String licenseGUID, MetadataSourceRequestBody requestBody) Remove the license for an element.- Parameters:
serverName
- name of the server instance to connect tolicenseGUID
- unique identifier for the license typerequestBody
- external source information.- Returns:
- void or InvalidParameterException one of the properties is invalid PropertyServerException problem accessing property server UserNotAuthorizedException security access problem
-
certifyElement
public GUIDResponse certifyElement(String serverName, String elementGUID, String certificationTypeGUID, RelationshipRequestBody requestBody) Link an element to a certification type and include details of the certification in the relationship properties.- Parameters:
serverName
- name of the server instance to connect toelementGUID
- unique identifier of the element being certifiedcertificationTypeGUID
- unique identifier for the certification typerequestBody
- the properties of the certification- Returns:
- guid or InvalidParameterException one of the properties is invalid PropertyServerException problem accessing property server UserNotAuthorizedException security access problem
-
updateCertification
public VoidResponse updateCertification(String serverName, String certificationGUID, boolean replaceAllProperties, RelationshipRequestBody requestBody) Update the properties of a certification. Remember to include the certificationId in the properties if the element has multiple certifications for the same certification type.- Parameters:
serverName
- name of the server instance to connect tocertificationGUID
- unique identifier for the certification typereplaceAllProperties
- flag to indicate whether to completely replace the existing properties with the new properties, or just update the individual properties specified on the request.requestBody
- the properties of the certification- Returns:
- void or InvalidParameterException one of the properties is invalid PropertyServerException problem accessing property server UserNotAuthorizedException security access problem
-
decertifyElement
public VoidResponse decertifyElement(String serverName, String certificationGUID, MetadataSourceRequestBody requestBody) Remove the certification for an element.- Parameters:
serverName
- name of the server instance to connect tocertificationGUID
- unique identifier for the certification typerequestBody
- external source information.- Returns:
- void or InvalidParameterException one of the properties is invalid PropertyServerException problem accessing property server UserNotAuthorizedException security access problem
-