Use the renameEndpint command to change the specified endpoint's friendly name in the sphere.

When multiple endpoints at the same URL are given the same name in their respective WSDL definitions, giving them unique friendly names can make it easier to distinguish between them in future commands and in command output. You must provide the endpoint URL and a new friendly name. All other parameters are optional and are included only to help you distinguish the desired endpoint from others with the same URL.

See Resolving Discovery Issues, for a discussion of the use of this command in resolving discovery issues.

Command Syntax

btmcli renameEndpoint -e endpointUrl -fn friendlyName [-bn bindingName]
                      [-w wsdlUrl] [-n name] [-service serviceName] 
                      [-qname qname] [-V version] [-interfaceQName interfaceQName]
                      -s sphereUrl -l username:password
Name Long Name Description
-e -- The endpoint URL of a web service.
-bn -bindingName The binding for the endpoint. Used to disambiguate endpoint URLs with multiple bindings. For example: SOAP and HTTP
-w -wsdlUrl The URL of the WSDL file.
-n -name The existing friendly name of the endpoint to be renamed.
-service -- The friendly name of the service to which the renamed endpoint belongs.
-qname -- The qualified name of the service to which the renamed endpoint belongs.
-V -version The version of the service to which the renamed endpoint belongs. Use with the -service or -qname flags if needed.

Use the "-" string to represent the default, unnamed version.

-- -interfaceQName The qualified name of the interface the renamed endpoint implements.
-fn -friendlyName The new friendly name for the endpoint to be renamed.
-s -sphereUrl The URL of the sphere. http://hostname:port/btmcentral/sphere/

This flag is not required if you have set the AP_SPHERE_URL environment variable for your sphere.

-l -userLogin The username and password associated with the sphere, in the format: username:password. This set of credentials must belong to a user in the btmadmin role.

See Security Options in Accessing CLI Commands for information on furnishing login credentials.

You can encrypt passwords using the encryptPassword command.


The following example shows the renameEndpoint command used to rename CreditService to MyCreditService.

btmcli renameEndpoint -e http://jbujes:7001/bookmart/credit/CreditService
                      -fn MyCreditService
                      -s http://localhost:8080/btmcentral/sphere
                      -l admin:abracadabra