org.odpi.openmetadata.accessservices.datamanager.client

Class APIManagerClient

java.lang.Object

org.odpi.openmetadata.accessservices.datamanager.client.SchemaManagerClient

org.odpi.openmetadata.accessservices.datamanager.client.APIManagerClient

All Implemented Interfaces:

APIManagerInterface, SchemaManagerInterface

public class APIManagerClient
extends SchemaManagerClient
implements APIManagerInterface

APIManagerClient is the client for managing apis from an Event Manager.

Constructor Summary

Constructors

Constructor and Description
APIManagerClient(String serverName, String serverPlatformURLRoot) Create a new client with no authentication embedded in the HTTP request.
APIManagerClient(String serverName, String serverPlatformURLRoot, AuditLog auditLog) Create a new client with no authentication embedded in the HTTP request.
APIManagerClient(String serverName, String serverPlatformURLRoot, DataManagerRESTClient restClient, int maxPageSize, AuditLog auditLog) Create a new client that is going to be used in an OMAG Server.
APIManagerClient(String serverName, String serverPlatformURLRoot, String userId, String password) Create a new client that passes userId and password in each HTTP request.
APIManagerClient(String serverName, String serverPlatformURLRoot, String userId, String password, AuditLog auditLog) Create a new client that passes userId and password in each HTTP request.

Method Summary

Modifier and Type	Method and Description
String	createAPI(String userId, String apiManagerGUID, String apiManagerName, boolean apiManagerIsHome, APIProperties apiProperties) Create a new metadata element to represent an API.
String	createAPIFromTemplate(String userId, String apiManagerGUID, String apiManagerName, boolean apiManagerIsHome, String templateGUID, TemplateProperties templateProperties) Create a new metadata element to represent an API using an existing metadata element as a template.
String	createAPIOperation(String userId, String apiManagerGUID, String apiManagerName, boolean apiManagerIsHome, String apiGUID, APIOperationProperties properties) Create a new metadata element to represent an API Operation.
String	createAPIOperationFromTemplate(String userId, String apiManagerGUID, String apiManagerName, boolean apiManagerIsHome, String templateGUID, String apiGUID, TemplateProperties templateProperties) Create a new metadata element to represent a API operation using an existing metadata element as a template.
String	createAPIParameterList(String userId, String apiManagerGUID, String apiManagerName, boolean apiManagerIsHome, String apiOperationGUID, APIParameterListType parameterListType, APIParameterListProperties properties) Create a new metadata element to represent an API Operation's Parameter list.
String	createAPIParameterListFromTemplate(String userId, String apiManagerGUID, String apiManagerName, boolean apiManagerIsHome, String templateGUID, String apiOperationGUID, APIParameterListType parameterListType, TemplateProperties templateProperties) Create a new metadata element to represent a an API Parameter List using an existing API Parameter List as a template.
List<APIOperationElement>	findAPIOperations(String userId, String searchString, int startFrom, int pageSize) Retrieve the list of API operation metadata elements that contain the search string.
List<APIParameterListElement>	findAPIParameterLists(String userId, String searchString, int startFrom, int pageSize) Retrieve the list of API Parameter List metadata elements that contain the search string.
List<APIElement>	findAPIs(String userId, String searchString, int startFrom, int pageSize) Retrieve the list of api metadata elements that contain the search string.
APIElement	getAPIByGUID(String userId, String guid) Retrieve the api metadata element with the supplied unique identifier.
APIOperationElement	getAPIOperationByGUID(String userId, String guid) Retrieve the API operation metadata element with the supplied unique identifier.
List<APIOperationElement>	getAPIOperationsByName(String userId, String name, int startFrom, int pageSize) Retrieve the list of API operation metadata elements with a matching qualified or display name.
APIParameterListElement	getAPIParameterListByGUID(String userId, String guid) Retrieve the API Parameter List metadata element with the supplied unique identifier.
List<APIParameterListElement>	getAPIParameterListsByName(String userId, String name, int startFrom, int pageSize) Retrieve the list of API Parameter List metadata elements with a matching qualified or display name.
List<APIElement>	getAPIsByName(String userId, String name, int startFrom, int pageSize) Retrieve the list of api metadata elements with a matching qualified or display name.
List<APIElement>	getAPIsForAPIManager(String userId, String apiManagerGUID, String apiManagerName, int startFrom, int pageSize) Retrieve the list of apis created by this caller.
List<APIOperationElement>	getOperationsForAPI(String userId, String apiGUID, int startFrom, int pageSize) Return the list of api-operations associated with an API.
List<APIParameterListElement>	getParameterListsForAPIOperation(String userId, String apiOperationGUID, int startFrom, int pageSize) Return the list of API Parameter Lists associated with an API Operation.
void	publishAPI(String userId, String apiGUID) Update the zones for the api asset so that it becomes visible to consumers.
void	removeAPI(String userId, String apiManagerGUID, String apiManagerName, String apiGUID, String qualifiedName) Remove the metadata element representing an API.
void	removeAPIOperation(String userId, String apiManagerGUID, String apiManagerName, String apiOperationGUID, String qualifiedName) Remove the metadata element representing a API operation.
void	removeAPIParameterList(String userId, String apiManagerGUID, String apiManagerName, String apiParameterListGUID, String qualifiedName) Remove an API Parameter List and all of its parameters.
void	updateAPI(String userId, String apiManagerGUID, String apiManagerName, String apiGUID, boolean isMergeUpdate, APIProperties apiProperties) Update the metadata element representing an API.
void	updateAPIOperation(String userId, String apiManagerGUID, String apiManagerName, String apiOperationGUID, boolean isMergeUpdate, APIOperationProperties properties) Update the metadata element representing a API operation.
void	updateAPIParameterList(String userId, String apiManagerGUID, String apiManagerName, String apiParameterListGUID, boolean isMergeUpdate, APIParameterListProperties properties) Update the metadata element representing an API Parameter List.
void	withdrawAPI(String userId, String apiGUID) Update the zones for the api asset so that it is no longer visible to consumers.

Methods inherited from class org.odpi.openmetadata.accessservices.datamanager.client.SchemaManagerClient

clearCalculatedValue, clearQueryTargetRelationship, clearSchemaType, createEnumSchemaType, createLiteralSchemaType, createMapSchemaType, createPrimitiveSchemaType, createSchemaAttribute, createSchemaAttributeFromTemplate, createSchemaTypeChoice, createSchemaTypeFromTemplate, createStructSchemaType, findSchemaAttributes, findSchemaType, findValidValueSet, getNestedAttributes, getSchemaAttributeByGUID, getSchemaAttributesByName, getSchemaTypeByGUID, getSchemaTypeByName, getSchemaTypeForElement, getSchemaTypeParent, getValidValueSetByName, removeSchemaAttribute, removeSchemaType, setupCalculatedValue, setupQueryTargetRelationship, setupSchemaType, updateQueryTargetRelationship, updateSchemaAttribute, updateSchemaType

Methods inherited from class java.lang.Object

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

Constructor Detail

APIManagerClient

public APIManagerClient(String serverName,
                        String serverPlatformURLRoot,
                        AuditLog auditLog)
                 throws InvalidParameterException

Create a new client with no authentication embedded in the HTTP request.

Parameters:

serverName - name of the server to connect to

serverPlatformURLRoot - the network address of the server running the OMAS REST servers

auditLog - logging destination

Throws:

InvalidParameterException - there is a problem creating the client-side components to issue any REST API calls.

APIManagerClient

public APIManagerClient(String serverName,
                        String serverPlatformURLRoot)
                 throws InvalidParameterException

Create a new client with no authentication embedded in the HTTP request.

Parameters:

serverName - name of the server to connect to

serverPlatformURLRoot - the network address of the server running the OMAS REST servers

Throws:

InvalidParameterException - there is a problem creating the client-side components to issue any REST API calls.

APIManagerClient

public APIManagerClient(String serverName,
                        String serverPlatformURLRoot,
                        String userId,
                        String password,
                        AuditLog auditLog)
                 throws InvalidParameterException

Create a new client that passes userId and password in each HTTP request. This is the userId/password of the calling server. The end user's userId is sent on each request.

Parameters:

serverName - name of the server to connect to

serverPlatformURLRoot - the network address of the server running the OMAS REST servers

userId - caller's userId embedded in all HTTP requests

password - caller's userId embedded in all HTTP requests

auditLog - logging destination

Throws:

InvalidParameterException - there is a problem creating the client-side components to issue any REST API calls.

APIManagerClient

public APIManagerClient(String serverName,
                        String serverPlatformURLRoot,
                        DataManagerRESTClient restClient,
                        int maxPageSize,
                        AuditLog auditLog)
                 throws InvalidParameterException

Create a new client that is going to be used in an OMAG Server.

Parameters:

serverName - name of the server to connect to

serverPlatformURLRoot - the network address of the server running the OMAS REST servers

restClient - client that issues the REST API calls

maxPageSize - maximum number of results supported by this server

auditLog - logging destination

Throws:

InvalidParameterException - there is a problem creating the client-side components to issue any REST API calls.

APIManagerClient

public APIManagerClient(String serverName,
                        String serverPlatformURLRoot,
                        String userId,
                        String password)
                 throws InvalidParameterException

Create a new client that passes userId and password in each HTTP request. This is the userId/password of the calling server. The end user's userId is sent on each request.

Parameters:

serverName - name of the server to connect to

serverPlatformURLRoot - the network address of the server running the OMAS REST servers

userId - caller's userId embedded in all HTTP requests

password - caller's userId embedded in all HTTP requests

Throws:

InvalidParameterException - there is a problem creating the client-side components to issue any REST API calls.

Method Detail

createAPI

public String createAPI(String userId,
                        String apiManagerGUID,
                        String apiManagerName,
                        boolean apiManagerIsHome,
                        APIProperties apiProperties)
                 throws InvalidParameterException,
                        UserNotAuthorizedException,
                        PropertyServerException

Create a new metadata element to represent an API.

Specified by:

createAPI in interface APIManagerInterface

Parameters:

userId - calling user

apiManagerGUID - unique identifier of software server capability representing the API manager

apiManagerName - unique name of software server capability representing the API manager

apiManagerIsHome - should the API be marked as owned by the API manager so others can not update?

apiProperties - properties to store

Returns:

unique identifier of the new metadata element

Throws:

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)

createAPIFromTemplate

public String createAPIFromTemplate(String userId,
                                    String apiManagerGUID,
                                    String apiManagerName,
                                    boolean apiManagerIsHome,
                                    String templateGUID,
                                    TemplateProperties templateProperties)
                             throws InvalidParameterException,
                                    UserNotAuthorizedException,
                                    PropertyServerException

Create a new metadata element to represent an API using an existing metadata element as a template.

Specified by:

createAPIFromTemplate in interface APIManagerInterface

Parameters:

userId - calling user

apiManagerGUID - unique identifier of software server capability representing the API manager

apiManagerName - unique name of software server capability representing the API manager

apiManagerIsHome - should the API be marked as owned by the API manager so others can not update?

templateGUID - unique identifier of the metadata element to copy

templateProperties - properties that override the template

Returns:

unique identifier of the new metadata element

Throws:

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)

updateAPI

public void updateAPI(String userId,
                      String apiManagerGUID,
                      String apiManagerName,
                      String apiGUID,
                      boolean isMergeUpdate,
                      APIProperties apiProperties)
               throws InvalidParameterException,
                      UserNotAuthorizedException,
                      PropertyServerException

Update the metadata element representing an API.

Specified by:

updateAPI in interface APIManagerInterface

Parameters:

userId - calling user

apiManagerGUID - unique identifier of software server capability representing the API manager

apiManagerName - unique name of software server capability representing the API manager

apiGUID - unique identifier of the metadata element to update

isMergeUpdate - are unspecified properties unchanged (true) or removed?

apiProperties - new properties for this element

Throws:

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)

publishAPI

public void publishAPI(String userId,
                       String apiGUID)
                throws InvalidParameterException,
                       UserNotAuthorizedException,
                       PropertyServerException

Update the zones for the api asset so that it becomes visible to consumers. (The zones are set to the list of zones in the publishedZones option configured for each instance of the Data Manager OMAS).

Specified by:

publishAPI in interface APIManagerInterface

Parameters:

userId - calling user

apiGUID - unique identifier of the metadata element to publish

Throws:

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)

withdrawAPI

public void withdrawAPI(String userId,
                        String apiGUID)
                 throws InvalidParameterException,
                        UserNotAuthorizedException,
                        PropertyServerException

Update the zones for the api asset so that it is no longer visible to consumers. (The zones are set to the list of zones in the defaultZones option configured for each instance of the Data Manager OMAS. This is the setting when the api is first created).

Specified by:

withdrawAPI in interface APIManagerInterface

Parameters:

userId - calling user

apiGUID - unique identifier of the metadata element to withdraw

Throws:

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)

removeAPI

public void removeAPI(String userId,
                      String apiManagerGUID,
                      String apiManagerName,
                      String apiGUID,
                      String qualifiedName)
               throws InvalidParameterException,
                      UserNotAuthorizedException,
                      PropertyServerException

Remove the metadata element representing an API.

Specified by:

removeAPI in interface APIManagerInterface

Parameters:

userId - calling user

apiManagerGUID - unique identifier of software server capability representing the API manager

apiManagerName - unique name of software server capability representing the API manager

apiGUID - unique identifier of the metadata element to remove

qualifiedName - unique name of the metadata element to remove

Throws:

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)

findAPIs

public List<APIElement> findAPIs(String userId,
                                 String searchString,
                                 int startFrom,
                                 int pageSize)
                          throws InvalidParameterException,
                                 UserNotAuthorizedException,
                                 PropertyServerException

Retrieve the list of api metadata elements that contain the search string. The search string is treated as a regular expression.

Specified by:

findAPIs in interface APIManagerInterface

Parameters:

userId - calling user

searchString - string to find in the properties

startFrom - paging start point

pageSize - maximum results that can be returned

Returns:

list of matching metadata elements

Throws:

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)

getAPIsByName

public List<APIElement> getAPIsByName(String userId,
                                      String name,
                                      int startFrom,
                                      int pageSize)
                               throws InvalidParameterException,
                                      UserNotAuthorizedException,
                                      PropertyServerException

Retrieve the list of api metadata elements with a matching qualified or display name. There are no wildcards supported on this request.

Specified by:

getAPIsByName in interface APIManagerInterface

Parameters:

userId - calling user

name - name to search for

startFrom - paging start point

pageSize - maximum results that can be returned

Returns:

list of matching metadata elements

Throws:

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)

getAPIsForAPIManager

public List<APIElement> getAPIsForAPIManager(String userId,
                                             String apiManagerGUID,
                                             String apiManagerName,
                                             int startFrom,
                                             int pageSize)
                                      throws InvalidParameterException,
                                             UserNotAuthorizedException,
                                             PropertyServerException

Retrieve the list of apis created by this caller.

Specified by:

getAPIsForAPIManager in interface APIManagerInterface

Parameters:

userId - calling user

apiManagerGUID - unique identifier of software server capability representing the api manager

apiManagerName - unique name of software server capability representing the api manager

startFrom - paging start point

pageSize - maximum results that can be returned

Returns:

list of matching metadata elements

Throws:

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)

getAPIByGUID

public APIElement getAPIByGUID(String userId,
                               String guid)
                        throws InvalidParameterException,
                               UserNotAuthorizedException,
                               PropertyServerException

Retrieve the api metadata element with the supplied unique identifier.

Specified by:

getAPIByGUID in interface APIManagerInterface

Parameters:

userId - calling user

guid - unique identifier of the requested metadata element

Returns:

matching metadata element

Throws:

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)

createAPIOperation

public String createAPIOperation(String userId,
                                 String apiManagerGUID,
                                 String apiManagerName,
                                 boolean apiManagerIsHome,
                                 String apiGUID,
                                 APIOperationProperties properties)
                          throws InvalidParameterException,
                                 UserNotAuthorizedException,
                                 PropertyServerException

Create a new metadata element to represent an API Operation.

Specified by:

createAPIOperation in interface APIManagerInterface

Parameters:

userId - calling user

apiManagerGUID - unique identifier of software server capability representing the API manager

apiManagerName - unique name of software server capability representing the API manager

apiManagerIsHome - should the API operation be marked as owned by the API manager so others can not update?

apiGUID - unique identifier of the api where the API operation is located

properties - properties about the API operation

Returns:

unique identifier of the new API operation

Throws:

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)

createAPIOperationFromTemplate

public String createAPIOperationFromTemplate(String userId,
                                             String apiManagerGUID,
                                             String apiManagerName,
                                             boolean apiManagerIsHome,
                                             String templateGUID,
                                             String apiGUID,
                                             TemplateProperties templateProperties)
                                      throws InvalidParameterException,
                                             UserNotAuthorizedException,
                                             PropertyServerException

Create a new metadata element to represent a API operation using an existing metadata element as a template.

Specified by:

createAPIOperationFromTemplate in interface APIManagerInterface

Parameters:

userId - calling user

apiManagerGUID - unique identifier of software server capability representing the API manager

apiManagerName - unique name of software server capability representing the API manager

apiManagerIsHome - should the API operation be marked as owned by the API manager so others can not update?

templateGUID - unique identifier of the metadata element to copy

apiGUID - unique identifier of the api where the API operation is located

templateProperties - properties that override the template

Returns:

unique identifier of the new API operation

Throws:

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)

updateAPIOperation

public void updateAPIOperation(String userId,
                               String apiManagerGUID,
                               String apiManagerName,
                               String apiOperationGUID,
                               boolean isMergeUpdate,
                               APIOperationProperties properties)
                        throws InvalidParameterException,
                               UserNotAuthorizedException,
                               PropertyServerException

Update the metadata element representing a API operation.

Specified by:

updateAPIOperation in interface APIManagerInterface

Parameters:

userId - calling user

apiManagerGUID - unique identifier of software server capability representing the API manager

apiManagerName - unique name of software server capability representing the API manager

apiOperationGUID - unique identifier of the metadata element to update

isMergeUpdate - are unspecified properties unchanged (true) or removed?

properties - new properties for the metadata element

Throws:

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)

removeAPIOperation

public void removeAPIOperation(String userId,
                               String apiManagerGUID,
                               String apiManagerName,
                               String apiOperationGUID,
                               String qualifiedName)
                        throws InvalidParameterException,
                               UserNotAuthorizedException,
                               PropertyServerException

Remove the metadata element representing a API operation.

Specified by:

removeAPIOperation in interface APIManagerInterface

Parameters:

userId - calling user

apiManagerGUID - unique identifier of software server capability representing the API manager

apiManagerName - unique name of software server capability representing the API manager

apiOperationGUID - unique identifier of the metadata element to remove

qualifiedName - unique name of the metadata element to remove

Throws:

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)

findAPIOperations

public List<APIOperationElement> findAPIOperations(String userId,
                                                   String searchString,
                                                   int startFrom,
                                                   int pageSize)
                                            throws InvalidParameterException,
                                                   UserNotAuthorizedException,
                                                   PropertyServerException

Retrieve the list of API operation metadata elements that contain the search string. The search string is treated as a regular expression.

Specified by:

findAPIOperations in interface APIManagerInterface

Parameters:

userId - calling user

searchString - string to find in the properties

startFrom - paging start point

pageSize - maximum results that can be returned

Returns:

list of matching metadata elements

Throws:

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)

getOperationsForAPI

public List<APIOperationElement> getOperationsForAPI(String userId,
                                                     String apiGUID,
                                                     int startFrom,
                                                     int pageSize)
                                              throws InvalidParameterException,
                                                     UserNotAuthorizedException,
                                                     PropertyServerException

Return the list of api-operations associated with an API.

Specified by:

getOperationsForAPI in interface APIManagerInterface

Parameters:

userId - calling user

apiGUID - unique identifier of the api to query

startFrom - paging start point

pageSize - maximum results that can be returned

Returns:

list of metadata elements describing the api-operations associated with the requested api

Throws:

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)

getAPIOperationsByName

public List<APIOperationElement> getAPIOperationsByName(String userId,
                                                        String name,
                                                        int startFrom,
                                                        int pageSize)
                                                 throws InvalidParameterException,
                                                        UserNotAuthorizedException,
                                                        PropertyServerException

Retrieve the list of API operation metadata elements with a matching qualified or display name. There are no wildcards supported on this request.

Specified by:

getAPIOperationsByName in interface APIManagerInterface

Parameters:

userId - calling user

name - name to search for

startFrom - paging start point

pageSize - maximum results that can be returned

Returns:

list of matching metadata elements

Throws:

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)

getAPIOperationByGUID

public APIOperationElement getAPIOperationByGUID(String userId,
                                                 String guid)
                                          throws InvalidParameterException,
                                                 UserNotAuthorizedException,
                                                 PropertyServerException

Retrieve the API operation metadata element with the supplied unique identifier.

Specified by:

getAPIOperationByGUID in interface APIManagerInterface

Parameters:

userId - calling user

guid - unique identifier of the requested metadata element

Returns:

requested metadata element

Throws:

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)

createAPIParameterList

public String createAPIParameterList(String userId,
                                     String apiManagerGUID,
                                     String apiManagerName,
                                     boolean apiManagerIsHome,
                                     String apiOperationGUID,
                                     APIParameterListType parameterListType,
                                     APIParameterListProperties properties)
                              throws InvalidParameterException,
                                     UserNotAuthorizedException,
                                     PropertyServerException

Create a new metadata element to represent an API Operation's Parameter list. This describes the structure of the payload supported by the API's operation. The structure of this API Operation is added using API Parameter schema attributes. These parameters can have a simple type or a nested structure.

Specified by:

createAPIParameterList in interface APIManagerInterface

Parameters:

userId - calling user

apiManagerGUID - unique identifier of software server capability representing the caller

apiManagerName - unique name of software server capability representing the caller

apiManagerIsHome - should the API operation be marked as owned by the API manager so others can not update?

apiOperationGUID - unique identifier of an APIOperation

parameterListType - is this is a header, request of response

properties - properties about the API parameter list

Returns:

unique identifier of the new API parameter list

Throws:

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)

createAPIParameterListFromTemplate

public String createAPIParameterListFromTemplate(String userId,
                                                 String apiManagerGUID,
                                                 String apiManagerName,
                                                 boolean apiManagerIsHome,
                                                 String templateGUID,
                                                 String apiOperationGUID,
                                                 APIParameterListType parameterListType,
                                                 TemplateProperties templateProperties)
                                          throws InvalidParameterException,
                                                 UserNotAuthorizedException,
                                                 PropertyServerException

Create a new metadata element to represent a an API Parameter List using an existing API Parameter List as a template.

Specified by:

createAPIParameterListFromTemplate in interface APIManagerInterface

Parameters:

userId - calling user

apiManagerGUID - unique identifier of software server capability representing the caller

apiManagerName - unique name of software server capability representing the caller

apiManagerIsHome - should the API operation be marked as owned by the API manager so others can not update?

templateGUID - unique identifier of the metadata element to copy

apiOperationGUID - unique identifier of the API Operation where the API Parameter List is located

parameterListType - is this is a header, request of response

templateProperties - properties that override the template

Returns:

unique identifier of the new API Parameter List

Throws:

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)

updateAPIParameterList

public void updateAPIParameterList(String userId,
                                   String apiManagerGUID,
                                   String apiManagerName,
                                   String apiParameterListGUID,
                                   boolean isMergeUpdate,
                                   APIParameterListProperties properties)
                            throws InvalidParameterException,
                                   UserNotAuthorizedException,
                                   PropertyServerException

Update the metadata element representing an API Parameter List.

Specified by:

updateAPIParameterList in interface APIManagerInterface

Parameters:

userId - calling user

apiManagerGUID - unique identifier of software server capability representing the caller

apiManagerName - unique name of software server capability representing the caller

apiParameterListGUID - unique identifier of the metadata element to update

isMergeUpdate - are unspecified properties unchanged (true) or removed?

properties - new properties for the metadata element

Throws:

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)

removeAPIParameterList

public void removeAPIParameterList(String userId,
                                   String apiManagerGUID,
                                   String apiManagerName,
                                   String apiParameterListGUID,
                                   String qualifiedName)
                            throws InvalidParameterException,
                                   UserNotAuthorizedException,
                                   PropertyServerException

Remove an API Parameter List and all of its parameters.

Specified by:

removeAPIParameterList in interface APIManagerInterface

Parameters:

userId - calling user

apiManagerGUID - unique identifier of software server capability representing the caller

apiManagerName - unique name of software server capability representing the caller

apiParameterListGUID - unique identifier of the metadata element to remove

qualifiedName - unique name of the metadata element to remove

Throws:

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)

findAPIParameterLists

public List<APIParameterListElement> findAPIParameterLists(String userId,
                                                           String searchString,
                                                           int startFrom,
                                                           int pageSize)
                                                    throws InvalidParameterException,
                                                           UserNotAuthorizedException,
                                                           PropertyServerException

Retrieve the list of API Parameter List metadata elements that contain the search string. The search string is treated as a regular expression.

Specified by:

findAPIParameterLists in interface APIManagerInterface

Parameters:

userId - calling user

searchString - string to find in the properties

startFrom - paging start point

pageSize - maximum results that can be returned

Returns:

list of matching metadata elements

Throws:

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)

getParameterListsForAPIOperation

public List<APIParameterListElement> getParameterListsForAPIOperation(String userId,
                                                                      String apiOperationGUID,
                                                                      int startFrom,
                                                                      int pageSize)
                                                               throws InvalidParameterException,
                                                                      UserNotAuthorizedException,
                                                                      PropertyServerException

Return the list of API Parameter Lists associated with an API Operation.

Specified by:

getParameterListsForAPIOperation in interface APIManagerInterface

Parameters:

userId - calling user

apiOperationGUID - unique identifier of the API Operation to query

startFrom - paging start point

pageSize - maximum results that can be returned

Returns:

list of metadata elements describing the API Parameter Lists associated with the requested API Operation

Throws:

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)

getAPIParameterListsByName

public List<APIParameterListElement> getAPIParameterListsByName(String userId,
                                                                String name,
                                                                int startFrom,
                                                                int pageSize)
                                                         throws InvalidParameterException,
                                                                UserNotAuthorizedException,
                                                                PropertyServerException

Retrieve the list of API Parameter List metadata elements with a matching qualified or display name. There are no wildcards supported on this request.

Specified by:

getAPIParameterListsByName in interface APIManagerInterface

Parameters:

userId - calling user

name - name to search for

startFrom - paging start point

pageSize - maximum results that can be returned

Returns:

list of matching metadata elements

Throws:

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)

getAPIParameterListByGUID

public APIParameterListElement getAPIParameterListByGUID(String userId,
                                                         String guid)
                                                  throws InvalidParameterException,
                                                         UserNotAuthorizedException,
                                                         PropertyServerException

Retrieve the API Parameter List metadata element with the supplied unique identifier.

Specified by:

getAPIParameterListByGUID in interface APIManagerInterface

Parameters:

userId - calling user

guid - unique identifier of the requested metadata element

Returns:

requested metadata element

Throws:

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)