How to set Azure webapp default document to sub directory endpoint

Question

I deployed a webapi to an Azure webapp. I would like the default document to be the Swagger Index.html. From AzureCLI I updated the default document

az webapp update -g [resourceGroup] -n [appname] --add siteConfig.defaultDocuments swagger\index.html

and verified it was updated from in the portat but az webapp show indicates the defaultDocuments value is null.

Any ideas on how to set the default document and why there is a difference from the portal and Azure Cli?

Answer 1

@Anonymous Thank for reaching out to Microsoft Q&A, apologize for the inconvenience caused on this.

To reproduce this behavior, I have created a sample webapp (running with .NET 6 as runtime on windows app service plan) using the cmdlet az webapp update cmdlet we have set the default document to swagger/index.html and using the below cmdlet

We can see the current default document is set to swagger/index.html only as shown below

az webapp show -g <resourcegroupname> -n <webappname> --query siteConfig.defaultDocuments

Also, when we route to the default URL of the web app, we can see the content of index.html in the browser as well.

As mentioned in this documentation if your app uses modules that route based on URL instead of serving static content then there is no need for setting the default documents.

Feel free to reach back to me if you have any further queries on this.