Azure / Azure/azure-cli

az account | missing examples in reference content

Open
#29,667 2 comments 0 reactions 2 assignees Claimed by @jiasli View on GitHub
act-identity-squad ARM Auto-Assign Azure CLI Team question Similar-Issue
Dominant language
Python
Stars
4.6k
Forks
3.5k
Avg merge
3d 2h
Merged PRs (30d)
60

Description

### Describe the bug

### Bug category:
**Missing information**

### Request:

The [Azure CLI reference guidelines](https://github.com/Azure/azure-cli/blob/dev/doc/reference_doc_guidelines.md#examples) specifiy at least two examples for each command. Please review the Azure CLI reference guidelines for [examples](https://github.com/Azure/azure-cli/blob/dev/doc/reference_doc_guidelines.md#examples) and [parameters](https://github.com/Azure/azure-cli/blob/dev/doc/reference_doc_guidelines.md#parameters) and add missing content to your source code.

If a parameter accepts JSON content, provide a JSON example in the parameter long or short summary, or in a separate code block.

### Issue summary:
Understanding that not all “create” commands directly generate Microsoft revenue, every “create” or “add” minimally make a revenue-producing Azure resource possible. Consequently, **create commands are the most important examples to add.** Of secondary importance are reference commands with complex parameters (JSON, YAML, URLs, complex Azure resource IDs, multi-valued lists, key:value pairs, conditional parameters, parameter pairs ...).

### Command list with no examples:

| Reference name | Parameter count | is Create |
|-|-|-|
| [az account accept-ownership-status](https://docs.microsoft.com/cli/azure/account#az-account-accept-ownership-status) | 1 | |
| [az account clear](https://docs.microsoft.com/cli/azure/account#az-account-clear) | 0 | |
| [az account create](https://docs.microsoft.com/cli/azure/account#az-account-create) | 6 | **yes** |
| [az account list](https://docs.microsoft.com/cli/azure/account#az-account-list) | 2 | |
| [az account list-locations](https://docs.microsoft.com/cli/azure/account#az-account-list-locations) | 1 | |
| [az account set](https://docs.microsoft.com/cli/azure/account#az-account-set) | 1 | |
| [az account show](https://docs.microsoft.com/cli/azure/account#az-account-show) | 1 | |

### Related command

az account

### Errors

n/a

### Issue script & Debug output

n/a

### Expected behavior

n/a

### Environment Summary

Azure CLI 2.63.0

### Additional context

_No response_

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.