Authoring and publishing regions and the associated keys

The region in which you publish your LUIS app corresponds to the region or location you specify in the Azure portal when you create an Azure LUIS endpoint key. When you publish an app, LUIS automatically generates an endpoint URL for the region associated with the key. To publish a LUIS app to more than one region, you need at least one key per region.

LUIS website

There are three LUIS websites, based on region. You must author and publish in the same region.

LUIS Region
www.luis.ai U.S.
not Europe
not Australia
au.luis.ai Australia
eu.luis.ai Europe

Regions and Azure resources

The app is published to all regions associated with the LUIS resources added in the LUIS portal. For example, for an app created on www.luis.ai, if you create a LUIS resource in westus and add it to the app as a resource, the app is published in that region.

Public apps

A public app is published in all regions so that a user with a region-based LUIS resource key can access the app in whichever region is associated with their resource key.

Publishing regions

LUIS apps created on https://www.luis.ai can be published to all endpoints except the European and Australian regions.

The authoring region app can only be published to a corresponding publish region. If your app is currently in the wrong authoring region, export the app, and import it into the correct authoring region for your publishing region.

Global region Authoring API region & authoring website Publishing & querying region
API region name
Endpoint URL format
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
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
*Australia australiaeast
au.luis.ai
Australia East
australiaeast
https://australiaeast.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
*Europe westeurope
eu.luis.ai
France Central
francecentral
https://francecentral.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
*Europe westeurope
eu.luis.ai
North Europe
northeurope
https://northeurope.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
*Europe westeurope
eu.luis.ai
West Europe
westeurope
https://westeurope.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
*Europe westeurope
eu.luis.ai
UK South
uksouth
https://uksouth.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
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

Publishing to Europe

To publish to the European regions, you create LUIS apps at https://eu.luis.ai only. If you attempt to publish anywhere else using a key in the Europe region, LUIS displays a warning message. Instead, use https://eu.luis.ai. LUIS apps created at https://eu.luis.ai don't automatically migrate to other regions. Export and then import the LUIS app in order to migrate it.

Publishing to Australia

To publish to the Australian regions, you create LUIS apps at https://au.luis.ai only. If you attempt to publish anywhere else using a key in the Australian region, LUIS displays a warning message. Instead, use https://au.luis.ai. LUIS apps created at https://au.luis.ai don't automatically migrate to other regions. Export and then import the LUIS app in order to migrate it.

Endpoints

LUIS currently has 2 endpoints: one for authoring and one for text analysis.

Purpose URL
Authoring https://{region}.api.cognitive.microsoft.com/luis/api/v2.0/apps/{appID}/
Text analysis (query prediction) https://{region}.api.cognitive.microsoft.com/luis/v2.0/apps/{appId}?q={q}[&timezoneOffset][&verbose][&spellCheck][&staging][&bing-spell-check-subscription-key][&log]

The following table explains the parameters, denoted with curly braces {}, in the previous table.

Parameter Purpose
region Azure region - authoring and publishing have different regions
appID LUIS app ID used in URL route and found on app dashboard
q utterance text sent from client application such as chat bot

Failover regions

Each region has a secondary region to fail over to. Europe fails over inside Europe and Australia fails over inside Australia.

Next steps