az storage (Core & Extension) | missing examples in reference content
- Dominant language
- Python
- Stars
- 4.6k
- Forks
- 3.5k
- Avg merge
- 3d 2h
- Merged PRs (30d)
- 60
Description
### 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 ...).
### Reference subgroups with no examples:
Note: The commands for these subgroups are in the second table (below).
| Group name | Reference count | Status | Prior 6 month PVs |
|-|-|-|-|
| az storage account task-assignment | 7 | GA | |
| az storage azcopy | 1 | GA | 4653 |
| az storage blob tag | 2 | Preview | 1222 |
| az storage container immutability-policy | 5 | GA | 5935 |
| az storage container metadata | 2 | GA | 844 |
| az storage container policy | 5 | GA | 1776 |
| az storage directory metadata | 2 | GA | 410 |
| az storage queue policy | 5 | Preview | 715 |
| az storage share metadata | 2 | GA | 358 |
| az storage share policy | 5 | GA | 1265 |
| az storage table | 6 | GA | 809 |
| az storage table policy | 5 | GA | 980 |
### Reference commands with no examples:
Note: Some of these command subgroups have at least one example. This table is a list of all `az storage` commands with no example.
| Reference name | Parameter count | is Create |
|-|-|-|
| [az storage account check-name](https://docs.microsoft.com/cli/azure/storage/account#az-storage-account-check-name) | 1 | |
| [az storage account management-policy delete](https://docs.microsoft.com/cli/azure/storage/account/management-policy#az-storage-account-management-policy-delete) | 2 | |
| [az storage account management-policy show](https://docs.microsoft.com/cli/azure/storage/account/management-policy#az-storage-account-management-policy-show) | 2 | |
| [az storage account task-assignment create](https://docs.microsoft.com/cli/azure/storage/account/task-assignment#az-storage-account-task-assignment-create) | 9 | **yes** |
| [az storage account task-assignment delete](https://docs.microsoft.com/cli/azure/storage/account/task-assignment#az-storage-account-task-assignment-delete) | 7 | |
| [az storage account task-assignment list](https://docs.microsoft.com/cli/azure/storage/account/task-assignment#az-storage-account-task-assignment-list) | 5 | |
| [az storage account task-assignment list-report](https://docs.microsoft.com/cli/azure/storage/account/task-assignment#az-storage-account-task-assignment-list-report) | 7 | |
| [az storage account task-assignment show](https://docs.microsoft.com/cli/azure/storage/account/task-assignment#az-storage-account-task-assignment-show) | 5 | |
| [az storage account task-assignment update](https://docs.microsoft.com/cli/azure/storage/account/task-assignment#az-storage-account-task-assignment-update) | 15 | |
| [az storage account task-assignment wait](https://docs.microsoft.com/cli/azure/storage/account/task-assignment#az-storage-account-task-assignment-wait) | 12 | |
| [az storage azcopy run-command](https://docs.microsoft.com/cli/azure/storage/azcopy#az-storage-azcopy-run-command) | 1 | |
| [az storage blob copy cancel](https://docs.microsoft.com/cli/azure/storage/blob/copy#az-storage-blob-copy-cancel) | 11 | |
| [az storage blob filter](https://docs.microsoft.com/cli/azure/storage/blob#az-storage-blob-filter) | 8 | |
| [az storage blob incremental-copy cancel](https://docs.microsoft.com/cli/azure/storage/blob/incremental-copy#az-storage-blob-incremental-copy-cancel) | 10 | |
| [az storage blob lease break](https://docs.microsoft.com/cli/azure/storage/blob/lease#az-storage-blob-lease-break) | 14 | |
| [az storage blob lease change](https://docs.microsoft.com/cli/azure/storage/blob/lease#az-storage-blob-lease-change) | 16 | |
| [az storage blob lease release](https://docs.microsoft.com/cli/azure/storage/blob/lease#az-storage-blob-lease-release) | 17 | |
| [az storage blob service-properties show](https://docs.microsoft.com/cli/azure/storage/blob/service-properties#az-storage-blob-service-properties-show) | 6 | |
| [az storage blob snapshot](https://docs.microsoft.com/cli/azure/storage/blob#az-storage-blob-snapshot) | 17 | |
| [az storage blob tag list](https://docs.microsoft.com/cli/azure/storage/blob/tag#az-storage-blob-tag-list) | 13 | |
| [az storage blob tag set](https://docs.microsoft.com/cli/azure/storage/blob/tag#az-storage-blob-tag-set) | 13 | |
| [az storage blob update](https://docs.microsoft.com/cli/azure/storage/blob#az-storage-blob-update) | 22 | |
| [az storage container immutability-policy create](https://docs.microsoft.com/cli/azure/storage/container/immutability-policy#az-storage-container-immutability-policy-create) | 7 | **yes** |
| [az storage container immutability-policy delete](https://docs.microsoft.com/cli/azure/storage/container/immutability-policy#az-storage-container-immutability-policy-delete) | 4 | |
| [az storage container immutability-policy extend](https://docs.microsoft.com/cli/azure/storage/container/immutability-policy#az-storage-container-immutability-policy-extend) | 7 | |
| [az storage container immutability-policy lock](https://docs.microsoft.com/cli/azure/storage/container/immutability-policy#az-storage-container-immutability-policy-lock) | 4 | |
| [az storage container immutability-policy show](https://docs.microsoft.com/cli/azure/storage/container/immutability-policy#az-storage-container-immutability-policy-show) | 4 | |
| [az storage container metadata show](https://docs.microsoft.com/cli/azure/storage/container/metadata#az-storage-container-metadata-show) | 9 | |
| [az storage container metadata update](https://docs.microsoft.com/cli/azure/storage/container/metadata#az-storage-container-metadata-update) | 12 | |
| [az storage container policy create](https://docs.microsoft.com/cli/azure/storage/container/policy#az-storage-container-policy-create) | 11 | **yes** |
| [az storage container policy delete](https://docs.microsoft.com/cli/azure/storage/container/policy#az-storage-container-policy-delete) | 8 | |
| [az storage container policy list](https://docs.microsoft.com/cli/azure/storage/container/policy#az-storage-container-policy-list) | 7 | |
| [az storage container policy show](https://docs.microsoft.com/cli/azure/storage/container/policy#az-storage-container-policy-show) | 8 | |
| [az storage container policy update](https://docs.microsoft.com/cli/azure/storage/container/policy#az-storage-container-policy-update) | 11 | |
| [az storage container set-permission](https://docs.microsoft.com/cli/azure/storage/container#az-storage-container-set-permission) | 11 | |
| [az storage container show](https://docs.microsoft.com/cli/azure/storage/container#az-storage-container-show) | 9 | |
| [az storage container show-permission](https://docs.microsoft.com/cli/azure/storage/container#az-storage-container-show-permission) | 8 | |
| [az storage cors add](https://docs.microsoft.com/cli/azure/storage/cors#az-storage-cors-add) | 11 | **yes** |
| [az storage directory create](https://docs.microsoft.com/cli/azure/storage/directory#az-storage-directory-create) | 14 | **yes** |
| [az storage directory delete](https://docs.microsoft.com/cli/azure/storage/directory#az-storage-directory-delete) | 13 | |
| [az storage directory metadata show](https://docs.microsoft.com/cli/azure/storage/directory/metadata#az-storage-directory-metadata-show) | 12 | |
| [az storage directory metadata update](https://docs.microsoft.com/cli/azure/storage/directory/metadata#az-storage-directory-metadata-update) | 13 | |
| [az storage directory show](https://docs.microsoft.com/cli/azure/storage/directory#az-storage-directory-show) | 12 | |
| [az storage entity delete](https://docs.microsoft.com/cli/azure/storage/entity#az-storage-entity-delete) | 10 | |
| [az storage entity merge](https://docs.microsoft.com/cli/azure/storage/entity#az-storage-entity-merge) | 9 | |
| [az storage entity replace](https://docs.microsoft.com/cli/azure/storage/entity#az-storage-entity-replace) | 9 | |
| [az storage entity show](https://docs.microsoft.com/cli/azure/storage/entity#az-storage-entity-show) | 10 | |
| [az storage file copy cancel](https://docs.microsoft.com/cli/azure/storage/file/copy#az-storage-file-copy-cancel) | 12 | |
| [az storage file delete](https://docs.microsoft.com/cli/azure/storage/file#az-storage-file-delete) | 11 | |
| [az storage file download](https://docs.microsoft.com/cli/azure/storage/file#az-storage-file-download) | 19 | |
| [az storage file resize](https://docs.microsoft.com/cli/azure/storage/file#az-storage-file-resize) | 9 | |
| [az storage fs directory metadata update](https://docs.microsoft.com/cli/azure/storage/fs/directory/metadata#az-storage-fs-directory-metadata-update) | 10 | |
| [az storage fs file metadata update](https://docs.microsoft.com/cli/azure/storage/fs/file/metadata#az-storage-fs-file-metadata-update) | 10 | |
| [az storage fs file set-expiry](https://docs.microsoft.com/cli/azure/storage/fs/file#az-storage-fs-file-set-expiry) | 11 | |
| [az storage fs metadata update](https://docs.microsoft.com/cli/azure/storage/fs/metadata#az-storage-fs-metadata-update) | 9 | |
| [az storage logging update](https://docs.microsoft.com/cli/azure/storage/logging#az-storage-logging-update) | 9 | |
| [az storage queue policy create](https://docs.microsoft.com/cli/azure/storage/queue/policy#az-storage-queue-policy-create) | 10 | **yes** |
| [az storage queue policy delete](https://docs.microsoft.com/cli/azure/storage/queue/policy#az-storage-queue-policy-delete) | 7 | |
| [az storage queue policy list](https://docs.microsoft.com/cli/azure/storage/queue/policy#az-storage-queue-policy-list) | 6 | |
| [az storage queue policy show](https://docs.microsoft.com/cli/azure/storage/queue/policy#az-storage-queue-policy-show) | 7 | |
| [az storage queue policy update](https://docs.microsoft.com/cli/azure/storage/queue/policy#az-storage-queue-policy-update) | 10 | |
| [az storage share delete](https://docs.microsoft.com/cli/azure/storage/share#az-storage-share-delete) | 12 | |
| [az storage share list](https://docs.microsoft.com/cli/azure/storage/share#az-storage-share-list) | 11 | |
| [az storage share metadata show](https://docs.microsoft.com/cli/azure/storage/share/metadata#az-storage-share-metadata-show) | 8 | |
| [az storage share metadata update](https://docs.microsoft.com/cli/azure/storage/share/metadata#az-storage-share-metadata-update) | 8 | |
| [az storage share policy create](https://docs.microsoft.com/cli/azure/storage/share/policy#az-storage-share-policy-create) | 10 | **yes** |
| [az storage share policy delete](https://docs.microsoft.com/cli/azure/storage/share/policy#az-storage-share-policy-delete) | 7 | |
| [az storage share policy list](https://docs.microsoft.com/cli/azure/storage/share/policy#az-storage-share-policy-list) | 6 | |
| [az storage share policy show](https://docs.microsoft.com/cli/azure/storage/share/policy#az-storage-share-policy-show) | 7 | |
| [az storage share policy update](https://docs.microsoft.com/cli/azure/storage/share/policy#az-storage-share-policy-update) | 10 | |
| [az storage share show](https://docs.microsoft.com/cli/azure/storage/share#az-storage-share-show) | 8 | |
| [az storage share snapshot](https://docs.microsoft.com/cli/azure/storage/share#az-storage-share-snapshot) | 9 | |
| [az storage share stats](https://docs.microsoft.com/cli/azure/storage/share#az-storage-share-stats) | 7 | |
| [az storage share update](https://docs.microsoft.com/cli/azure/storage/share#az-storage-share-update) | 8 | |
| [az storage table create](https://docs.microsoft.com/cli/azure/storage/table#az-storage-table-create) | 8 | **yes** |
| [az storage table delete](https://docs.microsoft.com/cli/azure/storage/table#az-storage-table-delete) | 8 | |
| [az storage table exists](https://docs.microsoft.com/cli/azure/storage/table#az-storage-table-exists) | 7 | |
| [az storage table generate-sas](https://docs.microsoft.com/cli/azure/storage/table#az-storage-table-generate-sas) | 16 | |
| [az storage table list](https://docs.microsoft.com/cli/azure/storage/table#az-storage-table-list) | 9 | |
| [az storage table policy create](https://docs.microsoft.com/cli/azure/storage/table/policy#az-storage-table-policy-create) | 10 | **yes** |
| [az storage table policy delete](https://docs.microsoft.com/cli/azure/storage/table/policy#az-storage-table-policy-delete) | 7 | |
| [az storage table policy list](https://docs.microsoft.com/cli/azure/storage/table/policy#az-storage-table-policy-list) | 6 | |
| [az storage table policy show](https://docs.microsoft.com/cli/azure/storage/table/policy#az-storage-table-policy-show) | 7 | |
| [az storage table policy update](https://docs.microsoft.com/cli/azure/storage/table/policy#az-storage-table-policy-update) | 10 | |
| [az storage table stats](https://docs.microsoft.com/cli/azure/storage/table#az-storage-table-stats) | 6 | |
### Related command
az storage
### Errors
n/a
### Issue script & Debug output
n/a
### Expected behavior
n/a
### Environment Summary
Azure CLI 2.62.0
### Additional context
_No response_
Contributor guide
Assessment
This issue has not been assessed yet.