Endpoint Management

Use the Endpoint Management feature to add, remove and modify endpoints.

  1. In the navigator, under Manage > Service Bus, click Endpoints. The Manage Endpoints page appears.
  2. In the Add Endpoint tab, select the endpoint type you want to add. The available options are:
    • Address Endpoint - Defines the direct URL of the service
    • Default Endpoint - Defines additional configuration for the default target
    • WSDL Endpoint - Defines the WSDL, Service and Port
    • Fail-over Endpoint - Defines a list of endpoints that the service will try to connect to in case of a failure. This will take place in a round robin manner.
    • Load-Balance Group - Defines groups of�endpoints for replicated services.The incoming requests will be directed to these endpoints in a round robin manner. These endpoints automatically handle the fail-over cases as well.
    • Recipient List Group - Defines the list of endpoints a message will be routed to
    • Template Endpoint - Defines a template endpoint that can parameterfy endpoints
Selections for Endpoints

Figure 1: Selections for Endpoints

Adding an Address Endpoint

  1. In the Add Endpoint tab, click Address Endpoint. The Address Endpoint page appears with its default view.

  2. Figure 2: Configuring Address Endpoint

  3. In case, you want to configure Advanced Options, then click on Show Advanced Options drop down pane. Then the page with all the available Address Endpoint Options appears.

  4. Figure 3: Configuring Address Endpoint - Advanced Options

  5. Enter the required details in the fields. The following fields are specific to the Address Endpoint.
    • Name: The unique name for the endpoint
    • Address: The URL of the endpoint. You can test the availability of the given URL on the fly by just clicking the Test Address.
    • Format: The message format for the endpoint. The available values are:
      • Leave As-Is: No transformation is done to the outgoing message.
      • SOAP 1.1: Transforming message to SOAP 1.1
      • SOAP 1.2: Transforming message to SOAP 1.2
      • Plain Old XML (POX) - Transforming to plain old XML format
      • Representational State Transfer (REST/GET) - Transforming to HTTP Get Request
    • Optimize: Optimization for the message which transfers binary data.�The available values are:
      • Leave As-Is: No special Optimization. Keep the original message
      • SwA: Optimized as a SwA (SOAP with Attachment) message.
      • MTOM: Optimized as a MTOM (message transmission optimization mechanism)

Note : The rest of the fields are general to Address, HTTP, Default and WSDL endpoints. Common Field Descriptions.

Adding a Default Endpoint

  1. In the Add Endpoint tab, click Default Endpoint. The Default Endpoint page appears. You can switch to the advanced option by clicking on Show Advanced Options drop down pane.

    Figure 4: Configuring Default Endpoint

  2. Enter the required details in the fields. The Default Endpoint differ from the Addressing Endpoint only by the URL attribute.

    Note : The rest of the fields are general to Address, HTTP, Default and WSDL endpoints. Common Field Descriptions.

Adding a HTTP Endpoint

  1. In the Add Endpoint tab, click HTTP Endpoint. The HTTP Endpoint page appears with its default view.

  2. Figure 2: Configuring HTTP Endpoint

  3. In case, you want to configure Advanced Options, then click on Show Advanced Options drop down pane. Then the page with all the available HTTP Endpoint Options appears.

  4. Figure 3: Configuring HTTP Endpoint - Advanced Options

  5. Enter the required details in the fields. The following fields are specific to the HTTP Endpoint.
    • Name: The unique name for the endpoint
    • URI Template: The URL Template of the endpoint where template variables are placed inside curly braces with the prefix 'uri.var'. Example: http://wso2.com/{uri.var.pageId}/{uri.var.docId}.
    • Method: The HTTP Method to use. The available values are:
      • Leave As-Is: Incoming HTTP method is used.
      • GET: HTTP GET Method
      • POST: HTTP POST Method
      • PUT: HTTP PUT Method
      • DELETE: HTTP DELETE Method
      • HEAD: HTTP HEAD Method
      • OPTIONS: HTTP OPTIONS Method
      • PATCH: HTTP PATCH Method

Note : The rest of the fields are general to Address, HTTP, Default and WSDL endpoints. Common Field Descriptions.

Adding a WSDL Endpoint

  1. In the Add Endpoint list, click WSDL Endpoint. The WSDL Endpoint page appears.

    Figure 5: Configuring WSDL Endpoint

  2. Enter the required details in the fields. The following fields are specific to the WSDL Endpoint.�
    • Name: A unique name for the endpoint.
    • WSDL URI: The URI of the WSDL.
    • Service: The�service�selected from the available services for the WSDL.
    • Port: The port selected for the service specified in the above field. In a WSDL, an endpoint is bound to each port inside each service.

Note : The rest of the fields are general to Address, HTTP, Default and WSDL endpoints. Common Field Descriptions.

Adding a Fail-Over Endpoint

  1. In the Add Endpoint list, click Fail-Over Endpoint. The Fail-over Endpoint page appears.
  2. In the Endpoint Name field, enter a name for the endpoint.
  3. Click on Add Child of root. A menu with the available endpoints appears.

    Configuring Fail-over Endpoint

    Figure 6: Adding Fail-over Endpoint

  4. Click on the endpoint you want to add as a fail-over endpoint.A tab with the fields relevant to the selected endpoint appears.
  5. Enter the details and click Save & Close. The following screen-shot displays adding an Address endpoint to the fail-over endpoint list.

    Configuring Fail-over Endpoint

    Figure 7: Configuring Fail-over Endpoint

    You can add fail-over and load-balance endpoints interchangeably to as many levels as you want.

Adding a Load-Balance Group Endpoint

  1. In the Add Endpoint list, click Load Balance Group Endpoint. The Load Balance Group Endpoint page appears.
  2. Enter the required details in the fields. The following fields are specific to the Load-balance Group Endpoint.�
    • Endpoint Name: A unique name for the endpoint.
    • Session Management: A session management method from the load balancing group. The possible values are.
      • None: Session management is not used.
      • Transport: Session management is done on the transport level using HTTP cookies.
      • SOAP: Session management is done using SOAP sessions.
      • Client ID: Session management is done using an ID sent by the client.
    • Session Timeout(ms): Session timeout in milliseconds.

    Configuring Load balance Endpoint

    Figure 8: Configuring Load balance Group Endpoint

  3. Click on Add Child of root. A menu with the available endpoints appears.
  4. Click on the endpoint you want to add as a load-balance group endpoint.A tab with the fields relevant to the selected endpoint appears.
  5. Enter the details and click Save & Close. You can add as many endpoints as you need to the load balancing group.

Adding Template Endpoints

  1. In the Add Endpoint tab, click Template Endpoint. The Template Endpoint page appears with its default view.

  2. Figure 9: Configuring Template Endpoint

  3. Enter the required details in the fields. The following fields are specific to the Template Endpoint.
    • Name: The unique name for the template endpoint
    • Address: The URL of the template endpoint. If an endpoint part of a target template has an address element with $uri declared in it, then it will be populated with the value specified in this address field. As always you can test the availability of the given URL on the fly by just clicking the Test Address.
    • Target Template: Target template for this endpoint.
  4. In case, you want to add parameters to template Endpoints, then click on Add Parameters button. Then the page will be appear with the parameter table. You can add and delete parameter name/value pairs.

  5. Figure 9.1: Adding template Endpoint Parameters

Adding a Recipient List Endpoint

  1. In the Add Endpoint list, click Recipient List Endpoint. The Recipient List Endpoint page appears.
  2. In the Endpoint Name field, enter a name for the endpoint.
  3. Click on Add Child of root. A menu with the available endpoints appears.
  4. Click on the endpoint you want to add as a Recipient List endpoint.A tab with the fields relevant to the selected endpoint appears.
  5. Enter the details and click Save & Close. The following screen-shot displays adding an Address endpoint to the Recipient List endpoint list.

    Configuring Recipient List Endpoint

    Figure 10: Configuring Recipient List Endpoint

Adding Dynamic Endpoints

  1. To save an endpoint as a dynamic endpoint, click on Save In Registry which will display the dynamic endpoint Save As UI.
  2. Select either Governance Registry or Configuration Registry.
  3. Provide the key for the dynamic endpoint. This key will use as the path for the resource that will be added into Registry.

Figure 11: Adding a dynamic endpoint

Saved dynamic endpoint will be displayed as follows

Figure 11.1: Saved dynamic endpoint

Description of Fields Common to Address, HTTP, Default and WSDL Endpoints

Field Name Description
Suspend Error Codes A list of error codes. If these error codes are received from the endpoint, the endpoint will be suspended
Initial Duration (Millis) The duration that the endpoint is suspended for the�first time after the receiving the suspend error codes.
Max Duration (Millis) The maximum duration that the endpoint is suspended�after the receiving the suspend error codes.
Factor The duration to suspend can vary from the first time suspension to the subsequent time. The factor value decides the suspense duration variance between�subsequent suspensions.
On Timeout Error codes A list of error codes. If these error codes are received from the endpoint, the request will be subjected to a timeout.
Retry The number of re-tries�in�case of a timeout, caused by the above listed error codes.
Retry Delay(Millis) The delay between re-tries, in milli seconds.
Timeout Action The action to be done at a timeout situation. You can select from,
  • Never Timeout
  • Discard Message
  • Execute Fault Sequence
Timeout Duration (Mills) The duration in milli seconds before considering a request as timeout
WS-Addressing Adds WS-Addressing headers to the endpoint.
Separate Listener The listener to the response will be a separate transport stream from the caller
WS-Security Adds WS-Security features as described in a policy key (referring to a registry location).
WS-Reliable Messaging Adds WS-Reliable Messaging features as described in a policy key (referring to a registry location).
Non Retry Error Codes When a child endpoint of failover/loadbalance endpoint failed for a given error code, the request will not be send to the other child endpoints of failover/loadbalance endpoint. That means retry will not be happen with the rest of the child endpoints. This option is available only when endpoint is added as a child endpoint of failover/loadbalance endpoint

For more information please refer to the WSO2 library