Edit

Share via

Authoring and publishing regions and the associated keys

  • Article

Important

LUIS will be retired on October 1st 2025 and starting April 1st 2023 you will not be able to create new LUIS resources. We recommend migrating your LUIS applications to conversational language understanding to benefit from continued product support and multilingual capabilities.

LUIS authoring regions are supported by the LUIS portal. To publish a LUIS app to more than one region, you need at least one prediction key per region.

LUIS Authoring regions

Authoring regions are the regions where the application gets created and the training take place.

LUIS has the following authoring regions available with paired fail-over regions:

  • Australia east
  • West Europe
  • West US
  • Switzerland north

LUIS has one portal you can use regardless of region, www.luis.ai.

Publishing regions and Azure resources

Publishing regions are the regions where the application will be used in runtime. To use the application in a publishing region, you must create a resource in this region and assign your application to it. For example, if you create an app with the westus authoring region and publish it to the eastus and brazilsouth regions, the app will run in those two regions.

Public apps

A public app is published in all regions so that a user with a supported prediction resource can access the app in all regions.

Publishing regions are tied to authoring regions

When you first create our LUIS application, you're required to choose an authoring region. To use the application in runtime, you're required to create a resource in a publishing region.

Every authoring region has corresponding prediction regions that you can publish your application to, which are listed in the tables below. If your app is currently in the wrong authoring region, export the app, and import it into the correct authoring region to match the required publishing region.

Single data residency

Single data residency means that the data doesn't leave the boundaries of the region.

Note

  • Make sure to set log=false for V3 APIs to disable active learning. By default this value is false, to ensure that data does not leave the boundaries of the runtime region.
  • If log=true, data is returned to the authoring region for active learning.

Publishing to Europe

Global region Authoring API region Publishing & querying region
API region name		 Endpoint URL format
Europe westeurope France Central
francecentral		 https://francecentral.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
Europe westeurope North Europe
northeurope		 https://northeurope.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
Europe westeurope West Europe
westeurope		 https://westeurope.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
Europe westeurope UK South
uksouth		 https://uksouth.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
Europe westeurope Switzerland North
switzerlandnorth		 https://switzerlandnorth.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
Europe westeurope Norway East
norwayeast		 https://norwayeast.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY

Publishing to Australia

Global region Authoring API region Publishing & querying region
API region name		 Endpoint URL format
Australia australiaeast Australia East
australiaeast		 https://australiaeast.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY

Other publishing regions

Global region Authoring API region Publishing & querying region
API region name		 Endpoint URL format
Africa westus
www.luis.ai		 South Africa North
southafricanorth		 https://southafricanorth.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
Asia westus
www.luis.ai		 Central India
centralindia		 https://centralindia.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
Asia westus
www.luis.ai		 East Asia
eastasia		 https://eastasia.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
Asia westus
www.luis.ai		 Japan East
japaneast		 https://japaneast.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
Asia westus
www.luis.ai		 Japan West
japanwest		 https://japanwest.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
Asia westus
www.luis.ai		 Jio India West
jioindiawest		 https://jioindiawest.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
Asia westus
www.luis.ai		 Korea Central
koreacentral		 https://koreacentral.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
Asia westus
www.luis.ai		 Southeast Asia
southeastasia		 https://southeastasia.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
Asia westus
www.luis.ai		 North UAE
northuae		 https://northuae.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
North America westus
www.luis.ai		 Canada Central
canadacentral		 https://canadacentral.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
North America westus
www.luis.ai		 Central US
centralus		 https://centralus.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
North America westus
www.luis.ai		 East US
eastus		 https://eastus.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
North America westus
www.luis.ai		 East US 2
eastus2		 https://eastus2.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
North America westus
www.luis.ai		 North Central US
northcentralus		 https://northcentralus.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
North America westus
www.luis.ai		 South Central US
southcentralus		 https://southcentralus.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
North America westus
www.luis.ai		 West Central US
westcentralus		 https://westcentralus.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
North America westus
www.luis.ai		 West US
westus		 https://westus.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
North America westus
www.luis.ai		 West US 2
westus2		 https://westus2.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
North America westus
www.luis.ai		 West US 3
westus3		 https://westus3.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
South America westus
www.luis.ai		 Brazil South
brazilsouth		 https://brazilsouth.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY

Endpoints

Learn more about the authoring and prediction endpoints.

Failover regions

Each region has a secondary region to fail over to. Failover will only happen in the same geographical region.

Authoring regions have paired fail-over regions.

The following publishing regions do not have a failover region:

  • Brazil South
  • Southeast Asia

Next steps

Prebuilt entities reference