Skip to content

az resource create install site extension example is incorrect #32698

@DanielStout5

Description

@DanielStout5

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

Labels

ARMaz resource/group/lock/tag/deployment/policy/managementapp/account management-groupAuto-AssignAuto assign by botAzure CLI TeamThe command of the issue is owned by Azure CLI teamDocumentationcustomer-reportedIssues 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 that

Type

No type

Projects

No projects

Relationships

None yet

Development

No branches or pull requests

Issue actions