Azure / Azure/azure-cli

Remove common token replacement

Open
#18,154 1 comment 0 reactions 1 assignee Claimed by @jiasli View on GitHub
feature-request rest
Dominant language
Python
Stars
4.6k
Forks
3.5k
Avg merge
3d 2h
Merged PRs (30d)
60

Description

Under [Required Parameters](https://docs.microsoft.com/en-us/cli/azure/reference-index?view=azure-cli-latest#az_rest-required-parameters)

> Common token {subscriptionId} will be replaced with the current subscription ID specified by az account set

is inaccurate. Running `az rest --method get --url https://management.azure.com/subscriptions/{subscriptionId}/resources?api-version=2019-07-01 --url-parameters \$top=3` results in the error `az rest: 'utputformat' is not a valid value for '--output'.`

This error was mentioned in Azure/azure-cli#8778 meaning the curly braces causes the error. It should be removed to alleviate confusion and that the reader must replace {subscriptionId} with their subscription id.

---
#### Document Details

⚠ *Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.*

* ID: eeedb9a7-2aed-6727-4cfb-1515809d676e
* Version Independent ID: 2c83180d-22ad-db42-e2eb-f27f11977963
* Content: [az](https://docs.microsoft.com/en-us/cli/azure/reference-index?view=azure-cli-latest)
* Content Source: [latest/docs-ref-autogen/reference-index.yml](https://github.com/MicrosoftDocs/azure-docs-cli/blob/master/latest/docs-ref-autogen/reference-index.yml)
* GitHub Login: @rloutlaw
* Microsoft Alias: **routlaw**

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.