-
Notifications
You must be signed in to change notification settings - Fork 3.3k
Open
Labels
ARMaz resource/group/lock/tag/deployment/policy/managementapp/account management-groupaz resource/group/lock/tag/deployment/policy/managementapp/account management-groupAuto-AssignAuto assign by botAuto assign by botAzure CLI TeamThe command of the issue is owned by Azure CLI teamThe command of the issue is owned by Azure CLI teamDocumentationcustomer-reportedIssues that are reported by GitHub users external to the Azure organization.Issues that are reported by GitHub users external to the Azure organization.questionThe issue doesn't require a change to the product in order to be resolved. Most issues start as thatThe issue doesn't require a change to the product in order to be resolved. Most issues start as that
Milestone
Description
Describe the bug
From the docs is this example:
az resource create -g myRG --api-version "2018-02-01"
--name "{sitename+slot}/siteextensions/Contrast.NetCore.Azure.SiteExtension"
--resource-type Microsoft.Web/sites/siteextensions --is-full-object
--properties "{ \"id\": \"Contrast.NetCore.Azure.SiteExtension\", \"location\": \"West US\", \"version\": \"1.9.0\" }"
The correct example should be:
az resource create -g myRG --api-version "2018-02-01"
--name "{sitename+slot}/siteextensions/Contrast.NetCore.Azure.SiteExtension"
--resource-type Microsoft.Web/sites/siteextensions --is-full-object
--properties "{ \"location\": \"West US\", \"properties\": { \"version\": \"1.9.0\" }}"
The example in the docs will ignore the version specified in the properties JSON, because version is supposed to itself be nested under a "properties" object within the JSON. Specifying the id in the JSON is also unnecessary (the value won't be used)
Related command
az resource create
Errors
No error
Issue script & Debug output
No relevant debug
Expected behavior
Docs should provide correct examples
Environment Summary
azure-cli 2.82.0
core 2.82.0
telemetry 1.1.0
Dependencies:
msal 1.34.0b1
azure-mgmt-resource 23.3.0
Python (Windows) 3.13.9 (tags/v3.13.9:8183fa5, Oct 14 2025, 14:09:13) [MSC v.1944 64 bit (AMD64)]
Additional context
No response
Metadata
Metadata
Assignees
Labels
ARMaz resource/group/lock/tag/deployment/policy/managementapp/account management-groupaz resource/group/lock/tag/deployment/policy/managementapp/account management-groupAuto-AssignAuto assign by botAuto assign by botAzure CLI TeamThe command of the issue is owned by Azure CLI teamThe command of the issue is owned by Azure CLI teamDocumentationcustomer-reportedIssues that are reported by GitHub users external to the Azure organization.Issues that are reported by GitHub users external to the Azure organization.questionThe issue doesn't require a change to the product in order to be resolved. Most issues start as thatThe issue doesn't require a change to the product in order to be resolved. Most issues start as that