Creating Endpoints


This topic describes techniques applicable to a Classic Machine Learning Web service.

When you create Web services that you sell forward to your customers, you need to provide trained models to each customer that are still linked to the experiment from which the Web service was created. In addition, any updates to the experiment should be applied selectively to an endpoint without overwriting the customizations.

To accomplish this, Azure Machine Learning allows you to create multiple endpoints for a deployed Web service. Each endpoint in the Web service is independently addressed, throttled, and managed. Each endpoint is a unique URL and authorization key that you can distribute to your customers.


Try Azure Machine Learning for free

No credit card or Azure subscription required. Get started now.

Adding endpoints to a Web service

There are three ways to add an endpoint to a Web service.

  • Programmatically
  • Through the Azure Machine Learning Web Services portal
  • Though the Azure classic portal

Once the endpoint is created, you can consume it through synchronous APIs, batch APIs, and excel worksheets. In addition to adding endpoints through this UI, you can also use the Endpoint Management APIs to programmatically add endpoints.


If you have added additional endpoints to the Web service, you cannot delete the default endpoint.

Adding an endpoint programmatically

You can add an endpoint to your Web service programmatically using the AddEndpoint sample code.

Adding an endpoint using the Azure Machine Learning Web Services portal

  1. In Machine Learning Studio, on the left navigation column, click Web Services.
  2. At the bottom of the Web service dashboard, click Manage endpoints. The Azure Machine Learning Web Services portal opens to the endpoints page for the Web service.
  3. Click New.
  4. Type a name and description for the new endpoint. Endpoint names must be 24 character or less in length, and must be made up of lower-case alphabets or numbers. Select the logging level and whether sample data is enabled. For more information on logging, see Enable logging for Machine Learning Web services.

Adding an endpoint using the Azure classic portal

  1. Sign in to the Azure classic portal, click Machine Learning in the left column. Click the workspace which contains the Web service in which you are interested.

    Navigate to workspace

  2. Click Web Services.

    Navigate to Web services

  3. Click the Web service you're interested in to see the list of available endpoints.

    Navigate to endpoint

  4. At the bottom of the page, click Add Endpoint. Type a name and description, ensure there are no other endpoints with the same name in this Web service. Leave the throttle level with its default value unless you have special requirements. To learn more about throttling, see Scaling API Endpoints.

    Create endpoint

Next Steps

How to consume an Azure Machine Learning Web service.