Edit Service Endpoints for a Static Service Connection

After you create a service connection and select the service endpoints, you can edit the endpoint settings, request parameters, and the response for each endpoint in the Endpoints tab. Endpoints can be edited only for static service connections (identified by the Static service connection icon icon that appears in front of the service name).

If you edit an endpoint after you have created a type from it, you will need to manually edit the type to use any of the changes to the endpoint. A type created from an endpoint is not updated automatically when the endpoint is modified.

To edit a service endpoint:

  1. Open the Endpoints tab of a service connection.

    Description of service-connections-editortabs.bmp follows
    Description of the illustration service-connections-editortabs.bmp

    Tip:

    You can use the Replace button to update the service definitions of all selected endpoints with the latest definitions from the service. The Replace button is available when the service connection is registered via the Catalog or a service specification document. This capability is available for both OpenAPI3 style services as well as ADF Describe services:
    Description of service-connections-replace-endpoints.png follows
    Description of the illustration service-connections-replace-endpoints.png

    For static Integrations service connections, using the Replace button lets you update all endpoint definitions without manually creating a new connection and deleting the old one. When you see the confirmation dialog, click Replace to proceed.

  2. Click the endpoint you want to edit.

    For each endpoint, the editor provides tabs for editing the endpoint’s settings, the request sent to the endpoint, and the structure of the response.
    Description of service-connections-edit-endpoints.png follows
    Description of the illustration service-connections-edit-endpoints.png

    If your service connection was created from an OpenAPI3 specification that includes request and response examples specified in the example or examples keys, the examples will show up within the Request and Response tabs.

    The examples key takes precedence over example and if multiple examples exist, only one will be shown. If you created an example where one didn't exist (say, if you used the Test tab to send a request to the service and saved the response as an example), that's the example you'll see; otherwise, you'll see the first example in the examples key list.

  3. Click the service connection link in the breadcrumb to return to the list of service endpoints.