你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Virtual Machine Scale Sets - Reimage

对于具有临时 OS 磁盘的虚拟机,虚拟机重置为初始状态的 VM 规模集中的一个或多个虚拟机(升级操作系统)(升级操作系统)。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/reimage?api-version=2024-07-01

URI 参数

名称 必需 类型 说明
resourceGroupName
path True

string

资源组的名称。

subscriptionId
path True

string

唯一标识 azure 订阅Microsoft的订阅凭据。 订阅 ID 构成了每个服务调用的 URI 的一部分。

vmScaleSetName
path True

string

VM 规模集的名称。

api-version
query True

string

客户端 API 版本。

请求正文

名称 类型 说明
exactVersion

string

以十进制数指定,OS 磁盘应重新映像到的版本。 如果未提供确切版本,OS 磁盘将重新映像到现有版本的 OS 磁盘。

forceUpdateOSDiskForEphemeral

boolean

强制更新虚拟机规模集 VM 的临时 OS 磁盘的参数

instanceIds

string[]

虚拟机规模集实例 ID。 省略虚拟机规模集实例 ID 将导致对虚拟机规模集中的所有虚拟机执行操作。

osProfile

OSProfileProvisioningData

指定重新映像非临时 OS 磁盘所需的信息。

tempDisk

boolean

指定是否重置临时磁盘的映像。 默认值:false。 注意:只有具有临时 OS 磁盘的 VM/VMSS 才支持此临时磁盘重置映像参数。

响应

名称 类型 说明
200 OK

还行

202 Accepted

接受

Other Status Codes

CloudError

描述操作失败的原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称 说明
user_impersonation 模拟用户帐户

示例

VirtualMachineScaleSet_Reimage_MaximumSet_Gen
VirtualMachineScaleSet_Reimage_MinimumSet_Gen

VirtualMachineScaleSet_Reimage_MaximumSet_Gen

示例请求

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaaaaaaaaaa/reimage?api-version=2024-07-01

{
  "instanceIds": [
    "aaaaaaaaaa"
  ],
  "forceUpdateOSDiskForEphemeral": true,
  "tempDisk": true
}

示例响应

location: https://foo.com/operationstatus

VirtualMachineScaleSet_Reimage_MinimumSet_Gen

示例请求

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaaaaaaaaaaaa/reimage?api-version=2024-07-01

示例响应

location: https://foo.com/operationstatus

定义

名称 说明
ApiError

Api 错误。

ApiErrorBase

Api 错误基数。

CloudError

来自计算服务的错误响应。

InnerError

内部错误详细信息。

OSProfileProvisioningData

重新映像非临时虚拟机的其他参数。

VirtualMachineScaleSetReimageParameters

介绍虚拟机规模集 VM 重置映像参数。

ApiError

Api 错误。

名称 类型 说明
code

string

错误代码。

details

ApiErrorBase[]

API 错误详细信息

innererror

InnerError

Api 内部错误

message

string

错误消息。

target

string

特定错误的目标。

ApiErrorBase

Api 错误基数。

名称 类型 说明
code

string

错误代码。

message

string

错误消息。

target

string

特定错误的目标。

CloudError

来自计算服务的错误响应。

名称 类型 说明
error

ApiError

Api 错误。

InnerError

内部错误详细信息。

名称 类型 说明
errordetail

string

内部错误消息或异常转储。

exceptiontype

string

异常类型。

OSProfileProvisioningData

重新映像非临时虚拟机的其他参数。

名称 类型 说明
adminPassword

string

指定管理员帐户的密码。

最小长度(Windows): 8 个字符

最小长度(Linux): 6 个字符

最大长度(Windows): 123 个字符

最大长度(Linux): 72 个字符

复杂性要求:需要满足以下 4 个条件中的 3 个
字符数较低
具有大写字符
包含数字
具有特殊字符(正则表达式匹配 [\W_])

不允许的值:“abc@123”、“P@$$w 0rd”、“P@ssw0rd”、“P@ssword123”、“Pa$$word”、“pass@word1”、“Password!”、“Password1”、“Password22”、“iloveyou!”

若要重置密码,请参阅 如何在 Windows VM 中重置远程桌面服务或其登录密码

有关重置根密码,请参阅 使用 VMAccess 扩展 管理用户、SSH 并检查或修复 Azure Linux VM 上的磁盘

customData

string

指定自定义数据的 base-64 编码字符串。 base-64 编码字符串将解码为作为虚拟机上的文件保存的二进制数组。 二进制数组的最大长度为 65535 字节。 注意:不要在 customData 属性中传递任何机密或密码。 创建 VM 后,无法更新此属性。 属性 customData 将传递给要另存为文件的 VM,有关详细信息,请参阅 Azure VM 上的自定义数据。 如果对 Linux VM 使用 cloud-init,请参阅 使用 cloud-init 在创建期间自定义 Linux VM

VirtualMachineScaleSetReimageParameters

介绍虚拟机规模集 VM 重置映像参数。

名称 类型 说明
exactVersion

string

以十进制数指定,OS 磁盘应重新映像到的版本。 如果未提供确切版本,OS 磁盘将重新映像到现有版本的 OS 磁盘。

forceUpdateOSDiskForEphemeral

boolean

强制更新虚拟机规模集 VM 的临时 OS 磁盘的参数

instanceIds

string[]

虚拟机规模集实例 ID。 省略虚拟机规模集实例 ID 将导致对虚拟机规模集中的所有虚拟机执行操作。

osProfile

OSProfileProvisioningData

指定重新映像非临时 OS 磁盘所需的信息。

tempDisk

boolean

指定是否重置临时磁盘的映像。 默认值:false。 注意:只有具有临时 OS 磁盘的 VM/VMSS 才支持此临时磁盘重置映像参数。