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

Class UserIdentityResource

java.lang.Object
org.odpi.openmetadata.accessservices.communityprofile.server.spring.UserIdentityResource
@RestController @RequestMapping("/servers/{serverName}/open-metadata/access-services/community-profile/users/{userId}") public class UserIdentityResource extends Object
UserIdentityResource provides the APIs for maintaining user identities and their relationships with profiles.

  • Constructor Summary

    Constructors
    Constructor
    Description
    UserIdentityResource()
     

  • Method Summary

    Modifier and Type
    Method
    Description
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    addIdentityToProfile(String serverName, String userId, String userIdentityGUID, String profileGUID, org.odpi.openmetadata.accessservices.communityprofile.rest.RelationshipRequestBody requestBody)
    Link a user identity to a profile.
    org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse
    createUserIdentity(String serverName, String userId, org.odpi.openmetadata.accessservices.communityprofile.rest.ReferenceableRequestBody requestBody)
    Create a UserIdentity.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    deleteUserIdentity(String serverName, String userId, String userIdentityGUID, org.odpi.openmetadata.accessservices.communityprofile.rest.ExternalSourceRequestBody requestBody)
    Remove a user identity object.
    org.odpi.openmetadata.accessservices.communityprofile.rest.UserIdentityListResponse
    findUserIdentities(String serverName, String userId, int startFrom, int pageSize, org.odpi.openmetadata.commonservices.ffdc.rest.SearchStringRequestBody requestBody)
    Retrieve the list of user identity metadata elements that contain the search string.
    org.odpi.openmetadata.accessservices.communityprofile.rest.UserIdentityListResponse
    getUserIdentitiesByName(String serverName, String userId, int startFrom, int pageSize, org.odpi.openmetadata.commonservices.ffdc.rest.NameRequestBody requestBody)
    Retrieve the list of user identity metadata elements with a matching qualified name.
    org.odpi.openmetadata.accessservices.communityprofile.rest.UserIdentityResponse
    getUserIdentityByGUID(String serverName, String userId, String userIdentityGUID)
    Retrieve the userIdentity metadata element with the supplied unique identifier.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    removeIdentityFromProfile(String serverName, String userId, String userIdentityGUID, String profileGUID, org.odpi.openmetadata.accessservices.communityprofile.rest.ExternalSourceRequestBody requestBody)
    Remove a user identity object.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    updateIdentityProfile(String serverName, String userId, String userIdentityGUID, String profileGUID, boolean isMergeUpdate, org.odpi.openmetadata.accessservices.communityprofile.rest.RelationshipRequestBody requestBody)
    Link a user identity to a profile.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    updateUserIdentity(String serverName, String userId, String userIdentityGUID, boolean isMergeUpdate, org.odpi.openmetadata.accessservices.communityprofile.rest.ReferenceableRequestBody requestBody)
    Update a UserIdentity.

    Methods inherited from class java.lang.Object

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

  • Constructor Details

    • UserIdentityResource

      public UserIdentityResource()

  • Method Details

    • createUserIdentity

      @PostMapping(path="/user-identities") public org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse createUserIdentity(@PathVariable String serverName, @PathVariable String userId, @RequestBody org.odpi.openmetadata.accessservices.communityprofile.rest.ReferenceableRequestBody requestBody)
      Create a UserIdentity. This is not connected to a profile.
      Parameters:
      serverName - name of target server
      userId - the name of the calling user.
      requestBody - userId for the new userIdentity.
      Returns:
      guid or InvalidParameterException - one of the parameters is invalid or PropertyServerException - there is a problem retrieving information from the property server(s) or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

    • updateUserIdentity

      @PostMapping(path="/user-identities/{userIdentityGUID}") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse updateUserIdentity(@PathVariable String serverName, @PathVariable String userId, @PathVariable String userIdentityGUID, @RequestParam boolean isMergeUpdate, @RequestBody org.odpi.openmetadata.accessservices.communityprofile.rest.ReferenceableRequestBody requestBody)
      Update a UserIdentity.
      Parameters:
      serverName - name of target server
      userId - the name of the calling user
      userIdentityGUID - unique identifier of the UserIdentity
      isMergeUpdate - should the supplied properties be overlaid on the existing properties (true) or replace them (false)
      requestBody - updated properties for the new userIdentity
      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.

    • deleteUserIdentity

      @PostMapping(path="/user-identities/{userIdentityGUID}/delete") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse deleteUserIdentity(@PathVariable String serverName, @PathVariable String userId, @PathVariable String userIdentityGUID, @RequestBody(required=false) org.odpi.openmetadata.accessservices.communityprofile.rest.ExternalSourceRequestBody requestBody)
      Remove a user identity object. This will fail if a profile would be left without an associated user identity.
      Parameters:
      serverName - name of target server
      userId - the name of the calling user.
      userIdentityGUID - unique identifier of the UserIdentity
      requestBody - external source identifiers
      Returns:
      void or InvalidParameterException - one of the parameters is invalid or PropertyServerException - there is a problem retrieving information from the property server(s) or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

    • addIdentityToProfile

      @PostMapping(path="/user-identities/{userIdentityGUID}/profiles/{profileGUID}/link") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse addIdentityToProfile(@PathVariable String serverName, @PathVariable String userId, @PathVariable String userIdentityGUID, @PathVariable String profileGUID, @RequestBody(required=false) org.odpi.openmetadata.accessservices.communityprofile.rest.RelationshipRequestBody requestBody)
      Link a user identity to a profile. This will fail if the user identity is already connected to a profile.
      Parameters:
      serverName - name of target server
      userId - the name of the calling user.
      userIdentityGUID - unique identifier of the UserIdentity
      profileGUID - the profile to add the identity to.
      requestBody - external source identifiers
      Returns:
      void or InvalidParameterException - one of the parameters is invalid or PropertyServerException - there is a problem retrieving information from the property server(s) or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

    • updateIdentityProfile

      @PostMapping(path="/user-identities/{userIdentityGUID}/profiles/{profileGUID}/link/update") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse updateIdentityProfile(@PathVariable String serverName, @PathVariable String userId, @PathVariable String userIdentityGUID, @PathVariable String profileGUID, @RequestParam boolean isMergeUpdate, @RequestBody(required=false) org.odpi.openmetadata.accessservices.communityprofile.rest.RelationshipRequestBody requestBody)
      Link a user identity to a profile. This will fail if the user identity is already connected to a profile.
      Parameters:
      serverName - name of target server
      userId - the name of the calling user.
      userIdentityGUID - unique identifier of the UserIdentity
      profileGUID - the profile to add the identity to.
      isMergeUpdate - should the supplied properties be overlaid on the existing properties (true) or replace them (false)
      requestBody - external source identifiers
      Returns:
      void or InvalidParameterException - one of the parameters is invalid or PropertyServerException - there is a problem retrieving information from the property server(s) or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

    • removeIdentityFromProfile

      @PostMapping(path="/user-identities/{userIdentityGUID}/profiles/{profileGUID}/unlink") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse removeIdentityFromProfile(@PathVariable String serverName, @PathVariable String userId, @PathVariable String userIdentityGUID, @PathVariable String profileGUID, @RequestBody(required=false) org.odpi.openmetadata.accessservices.communityprofile.rest.ExternalSourceRequestBody requestBody)
      Remove a user identity object. This will fail if the profile would be left without an associated user identity.
      Parameters:
      serverName - name of target server
      userId - the name of the calling user.
      userIdentityGUID - unique identifier of the UserIdentity
      profileGUID - the profile to add the identity to.
      requestBody - external source identifiers
      Returns:
      void or InvalidParameterException - one of the parameters is invalid or PropertyServerException - there is a problem retrieving information from the property server(s) or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

    • findUserIdentities

      @PostMapping(path="/user-identities/by-search-string") public org.odpi.openmetadata.accessservices.communityprofile.rest.UserIdentityListResponse findUserIdentities(@PathVariable String serverName, @PathVariable String userId, @RequestParam int startFrom, @RequestParam int pageSize, @RequestBody org.odpi.openmetadata.commonservices.ffdc.rest.SearchStringRequestBody requestBody)
      Retrieve the list of user identity metadata elements that contain the search string. The search string is treated as a regular expression.
      Parameters:
      serverName - name of target server
      userId - calling user
      startFrom - paging start point
      pageSize - maximum results that can be returned
      requestBody - 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)

    • getUserIdentitiesByName

      @PostMapping(path="/user-identities/by-name") public org.odpi.openmetadata.accessservices.communityprofile.rest.UserIdentityListResponse getUserIdentitiesByName(@PathVariable String serverName, @PathVariable String userId, @RequestParam int startFrom, @RequestParam int pageSize, @RequestBody org.odpi.openmetadata.commonservices.ffdc.rest.NameRequestBody requestBody)
      Retrieve the list of user identity metadata elements with a matching qualified name. There are no wildcards supported on this request.
      Parameters:
      serverName - name of target server
      userId - calling user
      startFrom - paging start point
      pageSize - maximum results that can be returned
      requestBody - name to search for
      Returns:
      list of matching metadata elements 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)

    • getUserIdentityByGUID

      @GetMapping(path="/user-identities/{userIdentityGUID}") public org.odpi.openmetadata.accessservices.communityprofile.rest.UserIdentityResponse getUserIdentityByGUID(@PathVariable String serverName, @PathVariable String userId, @PathVariable String userIdentityGUID)
      Retrieve the userIdentity metadata element with the supplied unique identifier.
      Parameters:
      serverName - name of target server
      userId - calling user
      userIdentityGUID - unique identifier of the requested metadata element
      Returns:
      matching metadata element 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)