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 teamDocumentationact-identity-squadcustomer-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
No fields configured for issues without a type.

Projects

No projects

Relationships

None yet

Development

No branches or pull requests

Issue actions