Azure / Azure/azure-cli

Expand Azure CLI documentation for az storage account create and update ...

Open
#27,884 5 comments 0 reactions 2 assignees Claimed by @calvinhzy View on GitHub
act-codegen-extensibility-squad Auto-Assign Azure CLI Team customer-reported feature-request Storage
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

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.