Package org.odpi.openmetadata.commonservices.ocf.metadatamanagement.server.spring

Class ConnectedAssetResource

  • @RestController
@RequestMapping("/servers/{serverName}/open-metadata/common-services/{serviceURLName}/connected-asset/users/{userId}")
public class ConnectedAssetResource
extends Object
    The ConnectedAssetResource is the server-side implementation of the REST services needed to populate the Open Connector Framework (OCF) Connected Asset Properties.

    • Constructor Detail

      • ConnectedAssetResource

        public ConnectedAssetResource()
        Default constructor

    • Method Detail

      • getConnectionByGUID

        @GetMapping(path="/connections/{guid}")
public ConnectionResponse getConnectionByGUID​(@PathVariable
                                              String serverName,
                                              @PathVariable
                                              String serviceURLName,
                                              @PathVariable
                                              String userId,
                                              @PathVariable
                                              String guid)
        Returns the connection object corresponding to the supplied connection GUID.
        Parameters:
        serverName - name of the server instances for this request.
        serviceURLName - name of the service that created the connector that issued this request.
        userId - userId of user making request.
        guid - the unique id for the connection within the property server.
        Returns:
        connection object or InvalidParameterException one of the parameters is null or invalid or UnrecognizedConnectionGUIDException the supplied GUID is not recognized by the metadata repository or PropertyServerException there is a problem retrieving information from the property (metadata) server or UserNotAuthorizedException the requesting user is not authorized to issue this request.

      • getConnectionByName

        @GetMapping(path="/connections/by-name/{name}")
public ConnectionResponse getConnectionByName​(@PathVariable
                                              String serverName,
                                              @PathVariable
                                              String serviceURLName,
                                              @PathVariable
                                              String userId,
                                              @PathVariable
                                              String name)
        Returns the connection object corresponding to the supplied connection GUID.
        Parameters:
        serverName - name of the server instances for this request.
        serviceURLName - name of the service that created the connector that issued this request.
        userId - userId of user making request.
        name - the unique name for the connection within the property server.
        Returns:
        connection object or InvalidParameterException one of the parameters is null or invalid or UnrecognizedConnectionGUIDException the supplied GUID is not recognized by the metadata repository or PropertyServerException there is a problem retrieving information from the property (metadata) server or UserNotAuthorizedException the requesting user is not authorized to issue this request.

      • getConnectionForAsset

        @GetMapping(path="/assets/{assetGUID}/connection")
public ConnectionResponse getConnectionForAsset​(@PathVariable
                                                String serverName,
                                                @PathVariable
                                                String serviceURLName,
                                                @PathVariable
                                                String userId,
                                                @PathVariable
                                                String assetGUID)
        Returns the connection corresponding to the supplied asset GUID.
        Parameters:
        serverName - name of the server instances for this request
        serviceURLName - name of the service that created the connector that issued this request.
        userId - userId of user making request.
        assetGUID - the unique id for the asset within the metadata repository.
        Returns:
        connection object or InvalidParameterException one of the parameters is null or invalid or UnrecognizedConnectionNameException there is no connection defined for this name or PropertyServerException there is a problem retrieving information from the property (metadata) server or UserNotAuthorizedException the requesting user is not authorized to issue this request.

      • getAssetForConnectionGUID

        @GetMapping(path="/assets/by-connection/{connectionGUID}")
public GUIDResponse getAssetForConnectionGUID​(@PathVariable
                                              String serverName,
                                              @PathVariable
                                              String serviceURLName,
                                              @PathVariable
                                              String userId,
                                              @PathVariable
                                              String connectionGUID)
        Returns the unique identifier for the asset connected to the connection identified by the supplied guid.
        Parameters:
        serverName - String name of the server instances for this request.
        serviceURLName - String name of the service that created the connector that issued this request.
        userId - String the userId of the requesting user.
        connectionGUID - uniqueId for the connection.
        Returns:
        unique identifier of asset or InvalidParameterException one of the parameters is null or invalid or PropertyServerException there is a problem retrieving the connected asset properties from the property server or UnrecognizedConnectionGUIDException the supplied GUID is not recognized by the property server or NoConnectedAssetException there is no asset associated with this connection or UserNotAuthorizedException the requesting user is not authorized to issue this request.

      • getConnectedAssetSummary

        @GetMapping(path="/assets/{assetGUID}/via-connection/{connectionGUID}")
public AssetResponse getConnectedAssetSummary​(@PathVariable
                                              String serverName,
                                              @PathVariable
                                              String serviceURLName,
                                              @PathVariable
                                              String userId,
                                              @PathVariable
                                              String assetGUID,
                                              @PathVariable
                                              String connectionGUID)
        Returns the basic information about the asset. The connection guid allows the short description for the asset to be filled out.
        Parameters:
        serverName - String name of the server.
        serviceURLName - String name of the service that created the connector that issued this request.
        userId - String userId of user making request.
        assetGUID - String unique id for asset.
        connectionGUID - unique id for connection used to access asset.
        Returns:
        a bean with the basic properties about the asset or InvalidParameterException - the asset GUID is null or invalid or UnrecognizedAssetGUIDException - the asset GUID is not recognized by the property server or UnrecognizedConnectionGUIDException - the connection GUID is not recognized by the property server or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

      • getAssetSummary

        @GetMapping(path="/assets/{assetGUID}")
public AssetResponse getAssetSummary​(@PathVariable
                                     String serverName,
                                     @PathVariable
                                     String serviceURLName,
                                     @PathVariable
                                     String userId,
                                     @PathVariable
                                     String assetGUID)
        Returns the basic information about the asset.
        Parameters:
        serverName - String name of server instance to call.
        serviceURLName - String name of the service that created the connector that issued this request.
        userId - String userId of user making request.
        assetGUID - String unique id for asset.
        Returns:
        a bean with the basic properties about the asset or InvalidParameterException - the userId is null or invalid or UnrecognizedAssetGUIDException - the GUID is null or invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

      • getCertifications

        @GetMapping(path="/assets/{assetGUID}/certifications")
public CertificationsResponse getCertifications​(@PathVariable
                                                String serverName,
                                                @PathVariable
                                                String serviceURLName,
                                                @PathVariable
                                                String userId,
                                                @PathVariable
                                                String assetGUID,
                                                @RequestParam
                                                int elementStart,
                                                @RequestParam
                                                int maxElements)
        Returns the list of certifications for the asset.
        Parameters:
        serverName - String name of server instance to call.
        serviceURLName - String name of the service that created the connector that issued this request.
        userId - String userId of user making request.
        assetGUID - String unique id for asset.
        elementStart - int starting position for fist returned element.
        maxElements - int maximum number of elements to return on the call.
        Returns:
        a list of certifications or InvalidParameterException - the GUID is not recognized or the paging values are invalid or UnrecognizedAssetGUIDException - the GUID is null or invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

      • getAssetComments

        @GetMapping(path="/assets/{assetGUID}/comments")
public CommentsResponse getAssetComments​(@PathVariable
                                         String serverName,
                                         @PathVariable
                                         String serviceURLName,
                                         @PathVariable
                                         String userId,
                                         @PathVariable
                                         String assetGUID,
                                         @RequestParam
                                         int elementStart,
                                         @RequestParam
                                         int maxElements)
        Returns the list of comments for the asset.
        Parameters:
        serverName - String name of server instance to call.
        serviceURLName - String name of the service that created the connector that issued this request.
        userId - String userId of user making request.
        assetGUID - String unique id for asset.
        elementStart - int starting position for fist returned element.
        maxElements - int maximum number of elements to return on the call.
        Returns:
        a list of comments or InvalidParameterException - the GUID is not recognized or the paging values are invalid or UnrecognizedAssetGUIDException - the GUID is null or invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

      • getAssetCommentReplies

        @GetMapping(path="/assets/{assetGUID}/comments/{commentGUID}/replies")
public CommentsResponse getAssetCommentReplies​(@PathVariable
                                               String serverName,
                                               @PathVariable
                                               String serviceURLName,
                                               @PathVariable
                                               String userId,
                                               @PathVariable
                                               String assetGUID,
                                               @PathVariable
                                               String commentGUID,
                                               @RequestParam
                                               int elementStart,
                                               @RequestParam
                                               int maxElements)
        Returns the list of comments for the asset.
        Parameters:
        serverName - String name of server instance to call.
        serviceURLName - String name of the service that created the connector that issued this request.
        userId - String userId of user making request.
        assetGUID - String unique identifier for the linked asset.
        commentGUID - String unique id for the root comment.
        elementStart - int starting position for fist returned element.
        maxElements - int maximum number of elements to return on the call.
        Returns:
        a list of comments or InvalidParameterException - the GUID is not recognized or the paging values are invalid or UnrecognizedAssetGUIDException - the GUID is null or invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

      • getConnections

        @GetMapping(path="/assets/{assetGUID}/connections")
public ConnectionsResponse getConnections​(@PathVariable
                                          String serverName,
                                          @PathVariable
                                          String serviceURLName,
                                          @PathVariable
                                          String userId,
                                          @PathVariable
                                          String assetGUID,
                                          @RequestParam
                                          int elementStart,
                                          @RequestParam
                                          int maxElements)
        Returns the list of connections for the asset.
        Parameters:
        serverName - String name of server instance to call.
        serviceURLName - String name of the service that created the connector that issued this request.
        userId - String userId of user making request.
        assetGUID - String unique id for asset.
        elementStart - int starting position for fist returned element.
        maxElements - int maximum number of elements to return on the call.
        Returns:
        a list of connections or InvalidParameterException - the GUID is not recognized or the paging values are invalid or UnrecognizedAssetGUIDException - the GUID is null or invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

      • getExternalIdentifiers

        @GetMapping(path="/assets/{assetGUID}/external-identifiers")
public ExternalIdentifiersResponse getExternalIdentifiers​(@PathVariable
                                                          String serverName,
                                                          @PathVariable
                                                          String serviceURLName,
                                                          @PathVariable
                                                          String userId,
                                                          @PathVariable
                                                          String assetGUID,
                                                          @RequestParam
                                                          int elementStart,
                                                          @RequestParam
                                                          int maxElements)
        Returns the list of external identifiers for the asset.
        Parameters:
        serverName - String name of server instance to call.
        serviceURLName - String name of the service that created the connector that issued this request.
        userId - String userId of user making request.
        assetGUID - String unique id for asset.
        elementStart - int starting position for fist returned element.
        maxElements - int maximum number of elements to return on the call.
        Returns:
        a list of external identifiers or InvalidParameterException - the GUID is not recognized or the paging values are invalid or UnrecognizedAssetGUIDException - the GUID is null or invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

      • getExternalReferences

        @GetMapping(path="/assets/{assetGUID}/external-references")
public ExternalReferencesResponse getExternalReferences​(@PathVariable
                                                        String serverName,
                                                        @PathVariable
                                                        String serviceURLName,
                                                        @PathVariable
                                                        String userId,
                                                        @PathVariable
                                                        String assetGUID,
                                                        @RequestParam
                                                        int elementStart,
                                                        @RequestParam
                                                        int maxElements)
        Returns the list of external references for the asset.
        Parameters:
        serverName - String name of server instance to call.
        serviceURLName - String name of the service that created the connector that issued this request.
        userId - String userId of user making request.
        assetGUID - String unique id for asset.
        elementStart - int starting position for fist returned element.
        maxElements - int maximum number of elements to return on the call.
        Returns:
        a list of external references or InvalidParameterException - the GUID is not recognized or the paging values are invalid or UnrecognizedAssetGUIDException - the GUID is null or invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

      • getInformalTags

        @GetMapping(path="/assets/{assetGUID}/informal-tags")
public InformalTagsResponse getInformalTags​(@PathVariable
                                            String serverName,
                                            @PathVariable
                                            String serviceURLName,
                                            @PathVariable
                                            String userId,
                                            @PathVariable
                                            String assetGUID,
                                            @RequestParam
                                            int elementStart,
                                            @RequestParam
                                            int maxElements)
        Returns the list of informal tags for the asset.
        Parameters:
        serverName - String name of server instance to call.
        serviceURLName - String name of the service that created the connector that issued this request.
        userId - String userId of user making request.
        assetGUID - String unique id for asset.
        elementStart - int starting position for fist returned element.
        maxElements - int maximum number of elements to return on the call.
        Returns:
        a list of informal tags or InvalidParameterException - the GUID is not recognized or the paging values are invalid or UnrecognizedAssetGUIDException - the GUID is null or invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

      • getLicenses

        @GetMapping(path="/assets/{assetGUID}/licenses")
public LicensesResponse getLicenses​(@PathVariable
                                    String serverName,
                                    @PathVariable
                                    String serviceURLName,
                                    @PathVariable
                                    String userId,
                                    @PathVariable
                                    String assetGUID,
                                    @RequestParam
                                    int elementStart,
                                    @RequestParam
                                    int maxElements)
        Returns the list of licenses for the asset.
        Parameters:
        serverName - String name of server instance to call.
        serviceURLName - String name of the service that created the connector that issued this request.
        userId - String userId of user making request.
        assetGUID - String unique id for asset.
        elementStart - int starting position for fist returned element.
        maxElements - int maximum number of elements to return on the call.
        Returns:
        a list of informal tags or InvalidParameterException - the GUID is not recognized or the paging values are invalid or UnrecognizedAssetGUIDException - the GUID is null or invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

      • getLikes

        @GetMapping(path="/assets/{assetGUID}/likes")
public LikesResponse getLikes​(@PathVariable
                              String serverName,
                              @PathVariable
                              String serviceURLName,
                              @PathVariable
                              String userId,
                              @PathVariable
                              String assetGUID,
                              @RequestParam
                              int elementStart,
                              @RequestParam
                              int maxElements)
        Returns the list of likes for the asset.
        Parameters:
        serverName - String name of server instance to call.
        serviceURLName - String name of the service that created the connector that issued this request.
        userId - String userId of user making request.
        assetGUID - String unique id for asset.
        elementStart - int starting position for fist returned element.
        maxElements - int maximum number of elements to return on the call.
        Returns:
        a list of likes or InvalidParameterException - the GUID is not recognized or the paging values are invalid or UnrecognizedAssetGUIDException - the GUID is null or invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

      • getKnownLocations

        @GetMapping(path="/assets/{assetGUID}/known-locations")
public LocationsResponse getKnownLocations​(@PathVariable
                                           String serverName,
                                           @PathVariable
                                           String serviceURLName,
                                           @PathVariable
                                           String userId,
                                           @PathVariable
                                           String assetGUID,
                                           @RequestParam
                                           int elementStart,
                                           @RequestParam
                                           int maxElements)
        Returns the list of known locations for the asset.
        Parameters:
        serverName - String name of server instance to call.
        serviceURLName - String name of the service that created the connector that issued this request.
        userId - String userId of user making request.
        assetGUID - String unique id for asset.
        elementStart - int starting position for fist returned element.
        maxElements - int maximum number of elements to return on the call.
        Returns:
        a list of locations or InvalidParameterException - the GUID is not recognized or the paging values are invalid or UnrecognizedAssetGUIDException - the GUID is null or invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

      • getNoteLogs

        @GetMapping(path="/assets/{assetGUID}/note-logs")
public NoteLogsResponse getNoteLogs​(@PathVariable
                                    String serverName,
                                    @PathVariable
                                    String serviceURLName,
                                    @PathVariable
                                    String userId,
                                    @PathVariable
                                    String assetGUID,
                                    @RequestParam
                                    int elementStart,
                                    @RequestParam
                                    int maxElements)
        Returns the list of note logs for the asset.
        Parameters:
        serverName - String name of server instance to call.
        serviceURLName - String name of the service that created the connector that issued this request.
        userId - String userId of user making request.
        assetGUID - String unique id for asset.
        elementStart - int starting position for fist returned element.
        maxElements - int maximum number of elements to return on the call.
        Returns:
        a list of note logs or InvalidParameterException - the GUID is not recognized or the paging values are invalid or UnrecognizedAssetGUIDException - the GUID is null or invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

      • getNotes

        @GetMapping(path="/note-log/{noteLogGUID}/notes")
public NotesResponse getNotes​(@PathVariable
                              String serverName,
                              @PathVariable
                              String serviceURLName,
                              @PathVariable
                              String userId,
                              @PathVariable
                              String noteLogGUID,
                              @RequestParam
                              int elementStart,
                              @RequestParam
                              int maxElements)
        Returns the list of notes for the asset.
        Parameters:
        serverName - String name of server instance to call.
        serviceURLName - String name of the service that created the connector that issued this request.
        userId - String userId of user making request.
        noteLogGUID - String unique id for note log.
        elementStart - int starting position for fist returned element.
        maxElements - int maximum number of elements to return on the call.
        Returns:
        a list of notes or InvalidParameterException - the GUID is not recognized or the paging values are invalid or UnrecognizedAssetGUIDException - the GUID is null or invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

      • getRatings

        @GetMapping(path="/assets/{assetGUID}/ratings")
public RatingsResponse getRatings​(@PathVariable
                                  String serverName,
                                  @PathVariable
                                  String serviceURLName,
                                  @PathVariable
                                  String userId,
                                  @PathVariable
                                  String assetGUID,
                                  @RequestParam
                                  int elementStart,
                                  @RequestParam
                                  int maxElements)
        Returns the list of ratings for the asset.
        Parameters:
        serverName - String name of server instance to call.
        serviceURLName - String name of the service that created the connector that issued this request.
        userId - String userId of user making request.
        assetGUID - String unique id for asset.
        elementStart - int starting position for fist returned element.
        maxElements - int maximum number of elements to return on the call.
        Returns:
        a list of ratings or InvalidParameterException - the GUID is not recognized or the paging values are invalid or UnrecognizedAssetGUIDException - the GUID is null or invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

      • getRelatedAssets

        @GetMapping(path="/assets/{assetGUID}/related-assets")
public RelatedAssetsResponse getRelatedAssets​(@PathVariable
                                              String serverName,
                                              @PathVariable
                                              String serviceURLName,
                                              @PathVariable
                                              String userId,
                                              @PathVariable
                                              String assetGUID,
                                              @RequestParam
                                              int elementStart,
                                              @RequestParam
                                              int maxElements)
        Returns the list of related assets for the asset.
        Parameters:
        serverName - String name of server instance to call.
        serviceURLName - String name of the service that created the connector that issued this request.
        userId - String userId of user making request.
        assetGUID - String unique id for asset.
        elementStart - int starting position for fist returned element.
        maxElements - int maximum number of elements to return on the call.
        Returns:
        a list of related assets or InvalidParameterException - the GUID is not recognized or the paging values are invalid or UnrecognizedAssetGUIDException - the GUID is null or invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

      • getMoreInformation

        @GetMapping(path="/referenceables/{elementGUID}/more-information")
public MoreInformationResponse getMoreInformation​(@PathVariable
                                                  String serverName,
                                                  @PathVariable
                                                  String serviceURLName,
                                                  @PathVariable
                                                  String userId,
                                                  @PathVariable
                                                  String elementGUID,
                                                  @RequestParam
                                                  int elementStart,
                                                  @RequestParam
                                                  int maxElements)
        Returns the list of related Referenceables that provide more information for this asset, schema, ...
        Parameters:
        serverName - String name of server instance to call.
        serviceURLName - String name of the service that created the connector that issued this request.
        userId - String userId of user making request.
        elementGUID - String unique id for the element.
        elementStart - int starting position for fist returned element.
        maxElements - int maximum number of elements to return on the call.
        Returns:
        a list of related assets or InvalidParameterException - the GUID is not recognized or the paging values are invalid or UnrecognizedAssetGUIDException - the GUID is null or invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

      • getRelatedMediaReferences

        @GetMapping(path="/assets/{assetGUID}/related-media-references")
public RelatedMediaReferencesResponse getRelatedMediaReferences​(@PathVariable
                                                                String serverName,
                                                                @PathVariable
                                                                String serviceURLName,
                                                                @PathVariable
                                                                String userId,
                                                                @PathVariable
                                                                String assetGUID,
                                                                @RequestParam
                                                                int elementStart,
                                                                @RequestParam
                                                                int maxElements)
        Returns the list of related media references for the asset.
        Parameters:
        serverName - String name of server instance to call.
        serviceURLName - String name of the service that created the connector that issued this request.
        userId - String userId of user making request.
        assetGUID - String unique id for asset.
        elementStart - int starting position for fist returned element.
        maxElements - int maximum number of elements to return on the call.
        Returns:
        a list of related media references or InvalidParameterException - the GUID is not recognized or the paging values are invalid or UnrecognizedAssetGUIDException - the GUID is null or invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

      • getSchemaAttributes

        @GetMapping(path="/assets/schemas/{parentSchemaGUID}/schema-attributes")
public SchemaAttributesResponse getSchemaAttributes​(@PathVariable
                                                    String serverName,
                                                    @PathVariable
                                                    String serviceURLName,
                                                    @PathVariable
                                                    String userId,
                                                    @PathVariable
                                                    String parentSchemaGUID,
                                                    @RequestParam
                                                    int elementStart,
                                                    @RequestParam
                                                    int maxElements)
        Returns a list of schema attributes for a schema type.
        Parameters:
        serverName - String name of server instance to call.
        serviceURLName - String name of the service that created the connector that issued this request.
        userId - String userId of user making request.
        parentSchemaGUID - String unique id for containing schema type.
        elementStart - int starting position for fist returned element.
        maxElements - int maximum number of elements to return on the call.
        Returns:
        a schema attributes response or InvalidParameterException - the GUID is not recognized or the paging values are invalid or UnrecognizedGUIDException - the GUID is null or invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

      • getAPIOperations

        @GetMapping(path="/assets/schemas/apis/{parentSchemaTypeGUID}/api-operations")
public APIOperationsResponse getAPIOperations​(@PathVariable
                                              String serverName,
                                              @PathVariable
                                              String serviceURLName,
                                              @PathVariable
                                              String userId,
                                              @PathVariable
                                              String parentSchemaTypeGUID,
                                              @RequestParam
                                              int elementStart,
                                              @RequestParam
                                              int maxElements)
        Returns a list of api operations for a schema type.
        Parameters:
        serverName - String name of server instance to call.
        serviceURLName - String name of the service that created the connector that issued this request.
        userId - String userId of user making request.
        parentSchemaTypeGUID - String unique id for containing schema element.
        elementStart - int starting position for fist returned element.
        maxElements - int maximum number of elements to return on the call.
        Returns:
        a schema attributes response or InvalidParameterException - the GUID is not recognized or the paging values are invalid or UnrecognizedGUIDException - the GUID is null or invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.