您现在访问的是微软AZURE全球版技术文档网站,若需要访问由世纪互联运营的MICROSOFT AZURE中国区技术文档网站,请访问 https://docs.azure.cn.

Virtual Machine Extensions - Create Or Update

用于创建或更新扩展的操作。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/extensions/{vmExtensionName}?api-version=2020-12-01

URI 参数

Name In Required Type Description
resourceGroupName
path True
  • string

资源组的名称。

subscriptionId
path True
  • string

唯一标识 Microsoft Azure 订阅的订阅凭据。 此订阅 ID 是每个服务调用的 URI 的一部分。

vmExtensionName
path True
  • string

虚拟机扩展的名称。

vmName
path True
  • string

应在其中创建或更新扩展的虚拟机的名称。

api-version
query True
  • string

客户端 Api 版本。

请求正文

Name Required Type Description
location True
  • string

资源位置

properties.autoUpgradeMinorVersion
  • boolean

指示扩展是否应使用较新的次要版本(如果在部署时可用)。 但是,在部署后,扩展将不会升级次要版本,除非重新部署,即使此属性设置为 true。

properties.enableAutomaticUpgrade
  • boolean

指示扩展插件是否应由平台自动升级(如果有新的扩展版本可用)。

properties.forceUpdateTag
  • string

扩展处理程序应如何强制更新,即使扩展配置未更改也是如此。

properties.instanceView

虚拟机扩展实例视图。

properties.protectedSettings
  • object

扩展可以包含 protectedSettings 或 protectedSettingsFromKeyVault,或者根本不包含受保护的设置。

properties.publisher
  • string

扩展处理程序发行者的名称。

properties.settings
  • object

扩展的 Json 格式公共设置。

properties.type
  • string

指定扩展的类型;例如 "CustomScriptExtension"。

properties.typeHandlerVersion
  • string

指定脚本处理程序的版本。

tags
  • object

资源标记

响应

Name Type Description
200 OK

确定

201 Created

创建

安全性

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation 模拟用户帐户

定义

InstanceViewStatus

实例视图状态。

StatusLevelTypes

级别代码。

VirtualMachineExtension

描述虚拟机扩展。

VirtualMachineExtensionInstanceView

虚拟机扩展的实例视图。

InstanceViewStatus

实例视图状态。

Name Type Description
code
  • string

状态代码。

displayStatus
  • string

状态的可本地化的简短标签。

level

级别代码。

message
  • string

详细的状态消息,包括警报和错误消息。

time
  • string

状态的时间。

StatusLevelTypes

级别代码。

Name Type Description
Error
  • string
Info
  • string
Warning
  • string

VirtualMachineExtension

描述虚拟机扩展。

Name Type Description
id
  • string

资源 Id

location
  • string

资源位置

name
  • string

资源名称

properties.autoUpgradeMinorVersion
  • boolean

指示扩展是否应使用较新的次要版本(如果在部署时可用)。 但是,在部署后,扩展将不会升级次要版本,除非重新部署,即使此属性设置为 true。

properties.enableAutomaticUpgrade
  • boolean

指示扩展插件是否应由平台自动升级(如果有新的扩展版本可用)。

properties.forceUpdateTag
  • string

扩展处理程序应如何强制更新,即使扩展配置未更改也是如此。

properties.instanceView

虚拟机扩展实例视图。

properties.protectedSettings
  • object

扩展可以包含 protectedSettings 或 protectedSettingsFromKeyVault,或者根本不包含受保护的设置。

properties.provisioningState
  • string

预配状态,只出现在响应中。

properties.publisher
  • string

扩展处理程序发行者的名称。

properties.settings
  • object

扩展的 Json 格式公共设置。

properties.type
  • string

指定扩展的类型;例如 "CustomScriptExtension"。

properties.typeHandlerVersion
  • string

指定脚本处理程序的版本。

tags
  • object

资源标记

type
  • string

资源类型

VirtualMachineExtensionInstanceView

虚拟机扩展的实例视图。

Name Type Description
name
  • string

虚拟机扩展名称。

statuses

资源状态信息。

substatuses

资源状态信息。

type
  • string

指定扩展的类型;例如 "CustomScriptExtension"。

typeHandlerVersion
  • string

指定脚本处理程序的版本。