search

Azure / azure-cli

Azure Command-Line Interface
MIT License
4.01k stars 2.98k forks source link

Customer feedback | az webapp | provide more information on parameter pairs and `--track-status` #29758

Open dbradish-microsoft opened 2 months ago

dbradish-microsoft commented 2 months ago

Describe the bug

This GitHub issue is being moved from UUF 292286.

Engineering request

Is this an example of a conditional parameter pair? Until we have a 3rd parameter group for "conditional", please complete the following:

  1. Add information in the short-summary property on parameter pairs, or any information that would make an "optional" parameter "required".
  2. Provide an example that uses --async and --track-status
  3. Add more complex examples to az webapp deploy. There are 15 parameters and only 2 examples. Please see the published reference guidelines for Azure CLI examples. For example, Provide at least one example for every parameter. A single example can use multiple parameters, but a parameter that doesn't appear within an example code block often shows no usage statistics in Azure CLI reporting.. Link to az webapp deploy

Customer feedback from UUF

Repo:

azure-docs-cli

Title: az webapp | Microsoft Learn

Verbatim: this exampleaz webapp deploy --resource-group ResourceGroup --name AppName --src-path SourcePath --type war --async trueI think you also need to set --track-status false , otherwise async wont work! please clarify in the examples!

Verbatim Id: c2bf2858-da4f-ef11-a317-000d3a5bc84f

Triaged By: v-ommikumar@microsoft.com

**Triaged Comment:

Live URL:** https://learn.microsoft.com/en-us/cli/azure/webapp

GitHub URL: https://github.com/MicrosoftDocs/azure-docs-cli/blob/live/2017-03-09-profile/docs-ref-autogen/webapp.yml

Related command

az webapp deploy

Errors

n/a

Issue script & Debug output

n/a

Expected behavior

n/a

Environment Summary

Based on the date of the customer verbatim, I'm guessing Azure CLI 2.62.0, 2017-03-09-profile

Additional context

No response

yonzhan commented 2 months ago

Thank you for opening this issue, we will look into it.

microsoft-github-policy-service[bot] commented 2 months ago

Thanks for the feedback! We are routing this to the appropriate team for follow-up. cc @AzureAppServiceCLI, @antcp.

btardif commented 2 months ago

@tulikac can you take a look?