Azure / Azure/azure-cli

[Reference feedback]: az cosmosdb sql role definition | `--id` parameter value in example has wrong format

Open
#31,142 2 comments 0 reactions 0 assignees View on GitHub
act-codegen-extensibility-squad Auto-Assign CosmosDB needs-triage Service Attention
Dominant language
Python
Stars
4.6k
Forks
3.5k
Avg merge
3d 10h
Merged PRs (30d)
64

Description

### Type of issue

Other (describe below)

### Reference command name

az cosmosdb sql role definition

### Feedback

This GitHub issue is being created from UUF [#410071](https://dev.azure.com/msft-skilling/Content/_workitems/edit/410071).
*****************************************

### Request to engineering
Retest the examples for `show` and `list`. Is the `--id` parameter value accurate? Often an Azure resource has an ID that looks something like this: `/subscriptions/00000000-0000-0000-00000000/resourceGroups/myRGName`, and not just a single GUID. The customer is giving an example of `/sqlRoleDefinitions/00000000-0000-0000-0000-000000000001`.

![Image](https://github.com/user-attachments/assets/da7b5a1e-5589-42b8-b1b3-e08dfdaa6fa1)

*****************************************
### Verbatim:
The instructions are not correct for getting the roleDefinitionId. The example omits a portion of the roleDefinitionId, namely /sqlRoleDefinitions/00000000-0000-0000-0000-000000000001 - as given, the instruction produces an error saying that role definition Id must be a GUID.

### Verbatim Id:
5a900266-7906-f011-bae1-00224805cf23

### UUF Triage App Feedback URL:
https://aka.ms/UUFTriageApp-TEST?pageviewid=dca524d0-6530-3b71-9a3c-d428f68599cf

### Page URL

https://learn.microsoft.com/en-us/cli/azure/cosmosdb/sql/role/definition

### Content source URL

https://github.com/MicrosoftDocs/azure-docs-cli/blob/live/latest/docs-ref-autogen/cosmosdb/sql/role/definition.yml

### Author

_No response_

### Document Id

_No response_

Contributor guide

Open the contributing guide

Research direction

Start with docs-ref-autogen/cosmosdb/sql/role/definition.yml and the Azure CLI reference page for az cosmosdb sql role definition. Retest the show and list examples, focusing on whether --id should use the full /sqlRoleDefinitions/... value or only a GUID; done means the examples match the command's accepted format.

Written by the indexing model from the issue text.

Assessment

Tech stack
azure, python
Domain
cli, cloud, documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
38/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.