Expand Azure CLI documentation for az storage account create and update ...
- Dominant language
- Python
- Stars
- 4.6k
- Forks
- 3.5k
- Avg merge
- 3d 2h
- Merged PRs (30d)
- 60
Description
**Related command**
- az storage account create
**Is your feature request related to a problem? Please describe.**
Yes - the existing documentation was lacking and I spent several days trying to figure out how to accomplish a (simple) task before posting a question on StackOverflow.
**Describe the solution you'd like**
With regard to the **az storage account update** command:
I would like to see additional details added to the **--set** parameter. Specifically, the current documentation states:
> Update an object by specifying a property path and value to set. Example: --set property1.property2=.
> default value: []
As a newbie to Azure storage, reading the above only creates more questions, for example:
1. "Update an object" -- which object? I am **assuming** the storage account object?
2. "... specifying a property path and value to set" -- WHAT are the property names and their accepted values? Ideally a list of property names and valid values for each should be listed. Or provide a means of doing so.
By expanding the existing "description" of the parameter, it would be much clearer on what the **--set** parameter can in fact set
With regard to the **az storage account create** command:
The Azure documentation makes several references to using Microsoft Entra authorization to access resources and even suggests doing so rather than using access keys. I was assuming I would find a CLI command option on the az storagea ccount create command such as:
**--EnableMicrosoftEntra true**
... but behold - no such pararameter option exists -- instead, one must first create astorage account, and the modify it -- as per the answer posted on StackOverflow.
I hope these suggestions will be considered - it should help other "newbies" like myself.
**Describe alternatives you've considered**
Tried using Azure PowerShell -- but the documentation was lacking in that area as well.
**Additional context**
Please see my question as posted on StackOverflow: [https://stackoverflow.com/questions/77511961](https://stackoverflow.com/questions/77511961)
Contributor guide
Assessment
This issue has not been assessed yet.