Azure / Azure/azure-cli

[Reference feedback]: az storage share-rm delete behaviour

Open
#32,732 1 comment 0 reactions 1 assignee Assigned to @calvinhzy View on GitHub
act-codegen-extensibility-squad Auto-Assign Azure CLI Team Documentation needs-triage question Storage
Dominant language
Python
Stars
4.6k
Forks
3.5k
Avg merge
3d 2h
Merged PRs (30d)
60

Description

### Type of issue

Other (describe below)

### Reference command name

az storage share-rm delete

### Feedback

Hello team,

I'm not sure if this is a documentation issue or an unexpected behavior related to command **az storage share-rm delete** when used to delete snapshots.

Example:

| Resource type | Name |
| ------------- | ---- |
| Storage account | saname |
| File share | fsname |
| Snapshot | 2026-01-30T11:06:35.0000000Z |

If you run this command and the **snapshot does not exist**, you get an error:

```
az storage share-rm delete --include snapshots -g "rg" --storage-account "saname" --name "fsname" --snapshot "2026-01-30T11:06:35.0000000Z"

(ShareSnapshotNotFound) The specified share snapshot was not found.
RequestId: xxx
Time:2026-02-02T10:14:13.0557654Z
Code: ShareSnapshotNotFound
```

Which is expected as the snapshot no longer exist.

Now, if we pass an incorrect file share name (testfswrongname), the operation finish successfully without showing any error or output:

`az storage share-rm delete --include snapshots -g "rg" --storage-account "satestcasesnapshot" --name "testfswrongname" --snapshot "2026-01-30T11:06:35.0000000Z"`

This can be reproduced at will

This last behavior is consistent to what it is explained in the documentation for a **different command (az storage share delete)**, which states this:

https://learn.microsoft.com/en-us/cli/azure/storage/share?view=azure-cli-latest#az-storage-share-delete

_**If the share does not exist, the operation fails on the service. By default, the exception is swallowed by the client. To expose the exception, specify True for fail_not_exist.**_

This is not mentioned in the documentation of **az storage share-rm delete** and the command does not have the parameter --fail-not-exist:

https://learn.microsoft.com/en-us/cli/azure/storage/share-rm?view=azure-cli-latest#az-storage-share-rm-delete

Is it possible to update the documentation of **az storage share-rm delete** to mention this behavior? (or in the future, adding a similar feature like --fail-not-exist)

Thanks!

### Page URL

https://learn.microsoft.com/en-us/cli/azure/storage/share-rm?view=azure-cli-latest#az-storage-share-rm-delete

### Content source URL

_No response_

### Author

_No response_

### Document Id

_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.