Class ConnectionMakerRESTServices
java.lang.Object
org.odpi.openmetadata.tokencontroller.TokenController
org.odpi.openmetadata.viewservices.connectionmaker.server.ConnectionMakerRESTServices
The ConnectionMakerRESTServices provides the server-side implementation of the Connection Maker Open Metadata
View Service (OMVS). This interface provides access to a person's profile, roles and network.
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptioncreateConnection
(String serverName, String viewServiceURLMarker, NewElementRequestBody requestBody) Create a connection.createConnectionFromTemplate
(String serverName, String viewServiceURLMarker, TemplateRequestBody requestBody) Create a new metadata element to represent a connection using an existing metadata element as a template.createConnectorType
(String serverName, String viewServiceURLMarker, NewElementRequestBody requestBody) Create a connectorType.createConnectorTypeFromTemplate
(String serverName, String viewServiceURLMarker, TemplateRequestBody requestBody) Create a new metadata element to represent a connectorType using an existing metadata element as a template.createEndpoint
(String serverName, String viewServiceURLMarker, NewElementRequestBody requestBody) Create a endpoint.createEndpointFromTemplate
(String serverName, String viewServiceURLMarker, TemplateRequestBody requestBody) Create a new metadata element to represent a endpoint using an existing metadata element as a template.deleteConnection
(String serverName, String viewServiceURLMarker, String connectionGUID, boolean cascadedDelete, MetadataSourceRequestBody requestBody) Delete a connection.deleteConnectorType
(String serverName, String viewServiceURLMarker, String connectorTypeGUID, boolean cascadedDelete, MetadataSourceRequestBody requestBody) Delete a connectorType.deleteEndpoint
(String serverName, String viewServiceURLMarker, String endpointGUID, boolean cascadedDelete, MetadataSourceRequestBody requestBody) Delete a endpoint.detachAssetFromConnection
(String serverName, String viewServiceURLMarker, String assetGUID, String itProfileGUID, MetadataSourceRequestBody requestBody) Detach an asset from an IT profile.detachITProfileRoleFromProfile
(String serverName, String viewServiceURLMarker, String itProfileRoleGUID, String itProfileGUID, MetadataSourceRequestBody requestBody) Detach an IT profile role from an IT profile.detachLocationFromProfile
(String serverName, String viewServiceURLMarker, String connectionGUID, String locationGUID, MetadataSourceRequestBody requestBody) Detach a connection from a location.detachPeerPerson
(String serverName, String viewServiceURLMarker, String personOneGUID, String personTwoGUID, MetadataSourceRequestBody requestBody) Detach a person profile from one of its peers.detachPersonRoleFromProfile
(String serverName, String viewServiceURLMarker, String personRoleGUID, String personProfileGUID, MetadataSourceRequestBody requestBody) Detach a team role from a team profile.detachProfileIdentity
(String serverName, String viewServiceURLMarker, String endpointGUID, String profileGUID, MetadataSourceRequestBody requestBody) Detach a connection from a endpoint.detachTeamFromLeadershipRole
(String serverName, String viewServiceURLMarker, String teamGUID, String personRoleGUID, MetadataSourceRequestBody requestBody) Detach a team profile from its leadership role.detachTeamFromMembershipRole
(String serverName, String viewServiceURLMarker, String teamGUID, String personRoleGUID, MetadataSourceRequestBody requestBody) Detach a team profile from its membership role.detachTeamRoleFromProfile
(String serverName, String viewServiceURLMarker, String teamRoleGUID, String teamProfileGUID, MetadataSourceRequestBody requestBody) Detach a team role from a team profile.detachTeamStructure
(String serverName, String viewServiceURLMarker, String superTeamGUID, String subteamGUID, MetadataSourceRequestBody requestBody) Detach a super team from a subteam.findConnections
(String serverName, String viewServiceURLMarker, boolean startsWith, boolean endsWith, boolean ignoreCase, int startFrom, int pageSize, FilterRequestBody requestBody) Retrieve the list of connection metadata elements that contain the search string.findConnectorTypes
(String serverName, String viewServiceURLMarker, boolean startsWith, boolean endsWith, boolean ignoreCase, int startFrom, int pageSize, FilterRequestBody requestBody) Retrieve the list of connectorType metadata elements that contain the search string.findEndpoints
(String serverName, String viewServiceURLMarker, boolean startsWith, boolean endsWith, boolean ignoreCase, int startFrom, int pageSize, FilterRequestBody requestBody) Retrieve the list of endpoint metadata elements that contain the search string.getConnectionByGUID
(String serverName, String viewServiceURLMarker, String connectionGUID, AnyTimeRequestBody requestBody) Retrieve the list of connection metadata elements that contain the search string.getConnectionsByName
(String serverName, String viewServiceURLMarker, int startFrom, int pageSize, FilterRequestBody requestBody) Retrieve the list of connection metadata elements that contain the search string.getConnectorTypeByGUID
(String serverName, String viewServiceURLMarker, String connectorTypeGUID, AnyTimeRequestBody requestBody) Retrieve the list of connectorType metadata elements that contain the search string.getConnectorTypesByName
(String serverName, String viewServiceURLMarker, int startFrom, int pageSize, FilterRequestBody requestBody) Retrieve the list of connectorType metadata elements that contain the search string.getEndpointByGUID
(String serverName, String viewServiceURLMarker, String endpointGUID, AnyTimeRequestBody requestBody) Retrieve the list of endpoint metadata elements that contain the search string.getEndpointsByName
(String serverName, String viewServiceURLMarker, int startFrom, int pageSize, FilterRequestBody requestBody) Retrieve the list of endpoint metadata elements that contain the search string.linkAssetToConnection
(String serverName, String viewServiceURLMarker, String assetGUID, String itProfileGUID, RelationshipRequestBody requestBody) Attach an asset to an IT profile.linkConnectionToAsset
(String serverName, String viewServiceURLMarker, String connectionGUID, String locationGUID, RelationshipRequestBody requestBody) Attach a profile to a location.linkIdentityToProfile
(String serverName, String viewServiceURLMarker, String endpointGUID, String profileGUID, RelationshipRequestBody requestBody) Attach a profile to a endpoint.linkITProfileRoleToProfile
(String serverName, String viewServiceURLMarker, String itProfileRoleGUID, String itProfileGUID, RelationshipRequestBody requestBody) Attach an IT profile role to an IT profile.linkPeerPerson
(String serverName, String viewServiceURLMarker, String personOneGUID, String personTwoGUID, RelationshipRequestBody requestBody) Attach a person profile to one of its peers.linkPersonRoleToProfile
(String serverName, String viewServiceURLMarker, String personRoleGUID, String personProfileGUID, RelationshipRequestBody requestBody) Attach a team role to a team profile.linkTeamRoleToProfile
(String serverName, String viewServiceURLMarker, String teamRoleGUID, String teamProfileGUID, RelationshipRequestBody requestBody) Attach a team role to a team profile.linkTeamStructure
(String serverName, String viewServiceURLMarker, String superTeamGUID, String subteamGUID, RelationshipRequestBody requestBody) Attach a super team to a subteam.linkTeamToLeadershipRole
(String serverName, String viewServiceURLMarker, String teamGUID, String personRoleGUID, RelationshipRequestBody requestBody) Attach a team to its leadership role.linkTeamToMembershipRole
(String serverName, String viewServiceURLMarker, String teamGUID, String personRoleGUID, RelationshipRequestBody requestBody) Attach a team to its membership role.updateConnection
(String serverName, String viewServiceURLMarker, String connectionGUID, boolean replaceAllProperties, UpdateElementRequestBody requestBody) Update the properties of a connection.updateConnectorType
(String serverName, String viewServiceURLMarker, String connectorTypeGUID, boolean replaceAllProperties, UpdateElementRequestBody requestBody) Update the properties of a connectorType.updateEndpoint
(String serverName, String viewServiceURLMarker, String endpointGUID, boolean replaceAllProperties, UpdateElementRequestBody requestBody) Update the properties of a endpoint.Methods inherited from class org.odpi.openmetadata.tokencontroller.TokenController
getUser
-
Constructor Details
-
ConnectionMakerRESTServices
public ConnectionMakerRESTServices()Default constructor
-
-
Method Details
-
createConnection
public GUIDResponse createConnection(String serverName, String viewServiceURLMarker, NewElementRequestBody requestBody) Create a connection.- Parameters:
serverName
- name of called server.viewServiceURLMarker
- view service URL markerrequestBody
- properties for the connection.- Returns:
- unique identifier of the newly created element InvalidParameterException one of the parameters is invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
createConnectionFromTemplate
public GUIDResponse createConnectionFromTemplate(String serverName, String viewServiceURLMarker, TemplateRequestBody requestBody) Create a new metadata element to represent a connection using an existing metadata element as a template. The template defines additional classifications and relationships that should be added to the new element.- Parameters:
serverName
- calling userviewServiceURLMarker
- view service URL markerrequestBody
- properties that override the template- Returns:
- unique identifier of the new metadata element InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)
-
updateConnection
public VoidResponse updateConnection(String serverName, String viewServiceURLMarker, String connectionGUID, boolean replaceAllProperties, UpdateElementRequestBody requestBody) Update the properties of a connection.- Parameters:
serverName
- name of called server.viewServiceURLMarker
- view service URL markerconnectionGUID
- unique identifier of the connection (returned from create)replaceAllProperties
- 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
- properties for the new element.- Returns:
- void or InvalidParameterException one of the parameters is invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
linkConnectionToAsset
public VoidResponse linkConnectionToAsset(String serverName, String viewServiceURLMarker, String connectionGUID, String locationGUID, RelationshipRequestBody requestBody) Attach a profile to a location.- Parameters:
serverName
- name of called serverviewServiceURLMarker
- view service URL markerconnectionGUID
- unique identifier of the connectionlocationGUID
- unique identifier of the locationrequestBody
- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
detachLocationFromProfile
public VoidResponse detachLocationFromProfile(String serverName, String viewServiceURLMarker, String connectionGUID, String locationGUID, MetadataSourceRequestBody requestBody) Detach a connection from a location.- Parameters:
serverName
- name of called serverviewServiceURLMarker
- view service URL markerconnectionGUID
- unique identifier of the connectionlocationGUID
- unique identifier of the locationrequestBody
- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
linkPeerPerson
public VoidResponse linkPeerPerson(String serverName, String viewServiceURLMarker, String personOneGUID, String personTwoGUID, RelationshipRequestBody requestBody) Attach a person profile to one of its peers.- Parameters:
serverName
- name of called serverviewServiceURLMarker
- view service URL markerpersonOneGUID
- unique identifier of the first connectionpersonTwoGUID
- unique identifier of the second connectionrequestBody
- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
detachPeerPerson
public VoidResponse detachPeerPerson(String serverName, String viewServiceURLMarker, String personOneGUID, String personTwoGUID, MetadataSourceRequestBody requestBody) Detach a person profile from one of its peers.- Parameters:
serverName
- name of called serverviewServiceURLMarker
- view service URL markerpersonOneGUID
- unique identifier of the first person profilepersonTwoGUID
- unique identifier of the second person profilerequestBody
- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
linkTeamStructure
public VoidResponse linkTeamStructure(String serverName, String viewServiceURLMarker, String superTeamGUID, String subteamGUID, RelationshipRequestBody requestBody) Attach a super team to a subteam.- Parameters:
serverName
- name of called serverviewServiceURLMarker
- view service URL markersuperTeamGUID
- unique identifier of the super teamsubteamGUID
- unique identifier of the subteamrequestBody
- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
detachTeamStructure
public VoidResponse detachTeamStructure(String serverName, String viewServiceURLMarker, String superTeamGUID, String subteamGUID, MetadataSourceRequestBody requestBody) Detach a super team from a subteam.- Parameters:
serverName
- name of called serverviewServiceURLMarker
- view service URL markersuperTeamGUID
- unique identifier of the super teamsubteamGUID
- unique identifier of the subteamrequestBody
- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
linkAssetToConnection
public VoidResponse linkAssetToConnection(String serverName, String viewServiceURLMarker, String assetGUID, String itProfileGUID, RelationshipRequestBody requestBody) Attach an asset to an IT profile.- Parameters:
serverName
- name of called serverviewServiceURLMarker
- view service URL markerassetGUID
- unique identifier of the assetitProfileGUID
- unique identifier of the IT profilerequestBody
- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
detachAssetFromConnection
public VoidResponse detachAssetFromConnection(String serverName, String viewServiceURLMarker, String assetGUID, String itProfileGUID, MetadataSourceRequestBody requestBody) Detach an asset from an IT profile.- Parameters:
serverName
- name of called serverviewServiceURLMarker
- view service URL markerassetGUID
- unique identifier of the assetitProfileGUID
- unique identifier of the IT profilerequestBody
- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
linkTeamToMembershipRole
public VoidResponse linkTeamToMembershipRole(String serverName, String viewServiceURLMarker, String teamGUID, String personRoleGUID, RelationshipRequestBody requestBody) Attach a team to its membership role.- Parameters:
serverName
- name of called serverviewServiceURLMarker
- view service URL markerteamGUID
- unique identifier of the teampersonRoleGUID
- unique identifier of the associated person rolerequestBody
- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
detachTeamFromMembershipRole
public VoidResponse detachTeamFromMembershipRole(String serverName, String viewServiceURLMarker, String teamGUID, String personRoleGUID, MetadataSourceRequestBody requestBody) Detach a team profile from its membership role.- Parameters:
serverName
- name of called serverviewServiceURLMarker
- view service URL markerteamGUID
- unique identifier of the teampersonRoleGUID
- unique identifier of the associated person rolerequestBody
- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
linkTeamToLeadershipRole
public VoidResponse linkTeamToLeadershipRole(String serverName, String viewServiceURLMarker, String teamGUID, String personRoleGUID, RelationshipRequestBody requestBody) Attach a team to its leadership role.- Parameters:
serverName
- name of called serverviewServiceURLMarker
- view service URL markerteamGUID
- unique identifier of the teampersonRoleGUID
- unique identifier of the associated person rolerequestBody
- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
detachTeamFromLeadershipRole
public VoidResponse detachTeamFromLeadershipRole(String serverName, String viewServiceURLMarker, String teamGUID, String personRoleGUID, MetadataSourceRequestBody requestBody) Detach a team profile from its leadership role.- Parameters:
serverName
- name of called serverviewServiceURLMarker
- view service URL markerteamGUID
- unique identifier of the teampersonRoleGUID
- unique identifier of the associated person rolerequestBody
- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
deleteConnection
public VoidResponse deleteConnection(String serverName, String viewServiceURLMarker, String connectionGUID, boolean cascadedDelete, MetadataSourceRequestBody requestBody) Delete a connection.- Parameters:
serverName
- name of called serverviewServiceURLMarker
- view service URL markerconnectionGUID
- unique identifier of the element to deletecascadedDelete
- ca connections be deleted if data fields are attached?requestBody
- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
getConnectionsByName
public ConnectionsResponse getConnectionsByName(String serverName, String viewServiceURLMarker, int startFrom, int pageSize, FilterRequestBody requestBody) Retrieve the list of connection metadata elements that contain the search string.- Parameters:
serverName
- name of the service to route the request toviewServiceURLMarker
- view service URL markerstartFrom
- paging start pointpageSize
- maximum results that can be returnedrequestBody
- string to find in the properties- Returns:
- list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)
-
getConnectionByGUID
public ConnectionResponse getConnectionByGUID(String serverName, String viewServiceURLMarker, String connectionGUID, AnyTimeRequestBody requestBody) Retrieve the list of connection metadata elements that contain the search string.- Parameters:
serverName
- name of the service to route the request toviewServiceURLMarker
- view service URL markerconnectionGUID
- unique identifier of the required elementrequestBody
- string to find in the properties- Returns:
- list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)
-
findConnections
public ConnectionsResponse findConnections(String serverName, String viewServiceURLMarker, boolean startsWith, boolean endsWith, boolean ignoreCase, int startFrom, int pageSize, FilterRequestBody requestBody) Retrieve the list of connection metadata elements that contain the search string.- Parameters:
serverName
- name of the service to route the request toviewServiceURLMarker
- view service URL markerstartsWith
- does the value start with the supplied string?endsWith
- does the value end with the supplied string?ignoreCase
- should the search ignore case?startFrom
- paging start pointpageSize
- maximum results that can be returnedrequestBody
- string to find in the properties- Returns:
- list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)
-
createConnectorType
public GUIDResponse createConnectorType(String serverName, String viewServiceURLMarker, NewElementRequestBody requestBody) Create a connectorType.- Parameters:
serverName
- name of called server.viewServiceURLMarker
- view service URL markerrequestBody
- properties for the connectorType.- Returns:
- unique identifier of the newly created element InvalidParameterException one of the parameters is invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
createConnectorTypeFromTemplate
public GUIDResponse createConnectorTypeFromTemplate(String serverName, String viewServiceURLMarker, TemplateRequestBody requestBody) Create a new metadata element to represent a connectorType using an existing metadata element as a template. The template defines additional classifications and relationships that should be added to the new element.- Parameters:
serverName
- calling userviewServiceURLMarker
- view service URL markerrequestBody
- properties that override the template- Returns:
- unique identifier of the new metadata element InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)
-
updateConnectorType
public VoidResponse updateConnectorType(String serverName, String viewServiceURLMarker, String connectorTypeGUID, boolean replaceAllProperties, UpdateElementRequestBody requestBody) Update the properties of a connectorType.- Parameters:
serverName
- name of called server.viewServiceURLMarker
- view service URL markerconnectorTypeGUID
- unique identifier of the connectorType (returned from create)replaceAllProperties
- 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
- properties for the new element.- Returns:
- void or InvalidParameterException one of the parameters is invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
linkPersonRoleToProfile
public VoidResponse linkPersonRoleToProfile(String serverName, String viewServiceURLMarker, String personRoleGUID, String personProfileGUID, RelationshipRequestBody requestBody) Attach a team role to a team profile.- Parameters:
serverName
- name of called serverviewServiceURLMarker
- view service URL markerpersonRoleGUID
- unique identifier of the person rolepersonProfileGUID
- unique identifier of the person profilerequestBody
- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
detachPersonRoleFromProfile
public VoidResponse detachPersonRoleFromProfile(String serverName, String viewServiceURLMarker, String personRoleGUID, String personProfileGUID, MetadataSourceRequestBody requestBody) Detach a team role from a team profile.- Parameters:
serverName
- name of called serverviewServiceURLMarker
- view service URL markerpersonRoleGUID
- unique identifier of the person rolepersonProfileGUID
- unique identifier of the person profilerequestBody
- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
linkTeamRoleToProfile
public VoidResponse linkTeamRoleToProfile(String serverName, String viewServiceURLMarker, String teamRoleGUID, String teamProfileGUID, RelationshipRequestBody requestBody) Attach a team role to a team profile.- Parameters:
serverName
- name of called serverviewServiceURLMarker
- view service URL markerteamRoleGUID
- unique identifier of the team roleteamProfileGUID
- unique identifier of the team profilerequestBody
- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
detachTeamRoleFromProfile
public VoidResponse detachTeamRoleFromProfile(String serverName, String viewServiceURLMarker, String teamRoleGUID, String teamProfileGUID, MetadataSourceRequestBody requestBody) Detach a team role from a team profile.- Parameters:
serverName
- name of called serverviewServiceURLMarker
- view service URL markerteamRoleGUID
- unique identifier of the team roleteamProfileGUID
- unique identifier of the team profilerequestBody
- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
linkITProfileRoleToProfile
public VoidResponse linkITProfileRoleToProfile(String serverName, String viewServiceURLMarker, String itProfileRoleGUID, String itProfileGUID, RelationshipRequestBody requestBody) Attach an IT profile role to an IT profile.- Parameters:
serverName
- name of called serverviewServiceURLMarker
- view service URL markeritProfileRoleGUID
- unique identifier of the IT profile roleitProfileGUID
- unique identifier of the IT profilerequestBody
- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
detachITProfileRoleFromProfile
public VoidResponse detachITProfileRoleFromProfile(String serverName, String viewServiceURLMarker, String itProfileRoleGUID, String itProfileGUID, MetadataSourceRequestBody requestBody) Detach an IT profile role from an IT profile.- Parameters:
serverName
- name of called serverviewServiceURLMarker
- view service URL markeritProfileRoleGUID
- unique identifier of the IT profile roleitProfileGUID
- unique identifier of the IT profilerequestBody
- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
deleteConnectorType
public VoidResponse deleteConnectorType(String serverName, String viewServiceURLMarker, String connectorTypeGUID, boolean cascadedDelete, MetadataSourceRequestBody requestBody) Delete a connectorType.- Parameters:
serverName
- name of called serverviewServiceURLMarker
- view service URL markerconnectorTypeGUID
- unique identifier of the element to deletecascadedDelete
- ca connectorTypes be deleted if data fields are attached?requestBody
- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
getConnectorTypesByName
public ConnectorTypesResponse getConnectorTypesByName(String serverName, String viewServiceURLMarker, int startFrom, int pageSize, FilterRequestBody requestBody) Retrieve the list of connectorType metadata elements that contain the search string.- Parameters:
serverName
- name of the service to route the request toviewServiceURLMarker
- view service URL markerstartFrom
- paging start pointpageSize
- maximum results that can be returnedrequestBody
- string to find in the properties- Returns:
- list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)
-
getConnectorTypeByGUID
public ConnectorTypeResponse getConnectorTypeByGUID(String serverName, String viewServiceURLMarker, String connectorTypeGUID, AnyTimeRequestBody requestBody) Retrieve the list of connectorType metadata elements that contain the search string.- Parameters:
serverName
- name of the service to route the request toviewServiceURLMarker
- view service URL markerconnectorTypeGUID
- unique identifier of the required elementrequestBody
- string to find in the properties- Returns:
- list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)
-
findConnectorTypes
public ConnectorTypesResponse findConnectorTypes(String serverName, String viewServiceURLMarker, boolean startsWith, boolean endsWith, boolean ignoreCase, int startFrom, int pageSize, FilterRequestBody requestBody) Retrieve the list of connectorType metadata elements that contain the search string.- Parameters:
serverName
- name of the service to route the request toviewServiceURLMarker
- view service URL markerstartsWith
- does the value start with the supplied string?endsWith
- does the value end with the supplied string?ignoreCase
- should the search ignore case?startFrom
- paging start pointpageSize
- maximum results that can be returnedrequestBody
- string to find in the properties- Returns:
- list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)
-
createEndpoint
public GUIDResponse createEndpoint(String serverName, String viewServiceURLMarker, NewElementRequestBody requestBody) Create a endpoint.- Parameters:
serverName
- name of called server.viewServiceURLMarker
- view service URL markerrequestBody
- properties for the endpoint.- Returns:
- unique identifier of the newly created element InvalidParameterException one of the parameters is invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
createEndpointFromTemplate
public GUIDResponse createEndpointFromTemplate(String serverName, String viewServiceURLMarker, TemplateRequestBody requestBody) Create a new metadata element to represent a endpoint using an existing metadata element as a template. The template defines additional classifications and relationships that should be added to the new element.- Parameters:
serverName
- calling userviewServiceURLMarker
- view service URL markerrequestBody
- properties that override the template- Returns:
- unique identifier of the new metadata element InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)
-
updateEndpoint
public VoidResponse updateEndpoint(String serverName, String viewServiceURLMarker, String endpointGUID, boolean replaceAllProperties, UpdateElementRequestBody requestBody) Update the properties of a endpoint.- Parameters:
serverName
- name of called server.viewServiceURLMarker
- view service URL markerendpointGUID
- unique identifier of the endpoint (returned from create)replaceAllProperties
- 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
- properties for the new element.- Returns:
- void or InvalidParameterException one of the parameters is invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
linkIdentityToProfile
public VoidResponse linkIdentityToProfile(String serverName, String viewServiceURLMarker, String endpointGUID, String profileGUID, RelationshipRequestBody requestBody) Attach a profile to a endpoint.- Parameters:
serverName
- name of called serverviewServiceURLMarker
- view service URL markerendpointGUID
- unique identifier of the parentprofileGUID
- unique identifier of the connectionrequestBody
- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
detachProfileIdentity
public VoidResponse detachProfileIdentity(String serverName, String viewServiceURLMarker, String endpointGUID, String profileGUID, MetadataSourceRequestBody requestBody) Detach a connection from a endpoint.- Parameters:
serverName
- name of called serverviewServiceURLMarker
- view service URL markerendpointGUID
- unique identifier of the parent connectionprofileGUID
- unique identifier of the nested connectionrequestBody
- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
deleteEndpoint
public VoidResponse deleteEndpoint(String serverName, String viewServiceURLMarker, String endpointGUID, boolean cascadedDelete, MetadataSourceRequestBody requestBody) Delete a endpoint.- Parameters:
serverName
- name of called serverviewServiceURLMarker
- view service URL markerendpointGUID
- unique identifier of the element to deletecascadedDelete
- can endpoints be deleted if data fields are attached?requestBody
- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
getEndpointsByName
public EndpointsResponse getEndpointsByName(String serverName, String viewServiceURLMarker, int startFrom, int pageSize, FilterRequestBody requestBody) Retrieve the list of endpoint metadata elements that contain the search string.- Parameters:
serverName
- name of the service to route the request toviewServiceURLMarker
- view service URL markerstartFrom
- paging start pointpageSize
- maximum results that can be returnedrequestBody
- string to find in the properties- Returns:
- list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)
-
getEndpointByGUID
public EndpointResponse getEndpointByGUID(String serverName, String viewServiceURLMarker, String endpointGUID, AnyTimeRequestBody requestBody) Retrieve the list of endpoint metadata elements that contain the search string.- Parameters:
serverName
- name of the service to route the request toviewServiceURLMarker
- view service URL markerendpointGUID
- unique identifier of the required elementrequestBody
- string to find in the properties- Returns:
- list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)
-
findEndpoints
public EndpointsResponse findEndpoints(String serverName, String viewServiceURLMarker, boolean startsWith, boolean endsWith, boolean ignoreCase, int startFrom, int pageSize, FilterRequestBody requestBody) Retrieve the list of endpoint metadata elements that contain the search string.- Parameters:
serverName
- name of the service to route the request toviewServiceURLMarker
- view service URL markerstartsWith
- does the value start with the supplied string?endsWith
- does the value end with the supplied string?ignoreCase
- should the search ignore case?startFrom
- paging start pointpageSize
- maximum results that can be returnedrequestBody
- string to find in the properties- Returns:
- list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)
-