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 one portal you can use regardless of region, luis.azure.cn.

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 chinaeast2 authoring region and publish it to the chinaeast2 region, the app will run in that region.

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 China

Global region Authoring API region Publishing & querying region
API region name		 Endpoint URL format
China chinaeast2
luis.azure.cn		 China East 2
chinaeast2		 https://chinaeast2.api.cognitive.azure.cn/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.

Next steps

Prebuilt entities reference