你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Virtual Machine Scale Sets - Reimage
重置映像 (升级操作系统) VM 规模集中没有临时 OS 磁盘的一个或多个虚拟机,对于具有临时 OS 磁盘的虚拟机,虚拟机将重置为初始状态。
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/reimage?api-version=2024-03-01
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
resource
|
path | True |
string |
资源组的名称。 |
subscription
|
path | True |
string |
唯一标识 Microsoft Azure 订阅的订阅凭据。 此订阅 ID 是每个服务调用的 URI 的一部分。 |
vm
|
path | True |
string |
VM 规模集的名称。 |
api-version
|
query | True |
string |
客户端 API 版本。 |
请求正文
名称 | 类型 | 说明 |
---|---|---|
exactVersion |
string |
以十进制数字指定 OS 磁盘应重置映像到的版本。 如果未提供确切版本,OS 磁盘将重置为 OS 磁盘的现有版本。 |
forceUpdateOSDiskForEphemeral |
boolean |
强制更新虚拟机规模集 VM 的临时 OS 磁盘的参数 |
instanceIds |
string[] |
虚拟机规模集实例 ID。 省略虚拟机规模集实例 ID 将导致在虚拟机规模集中的所有虚拟机上执行操作。 |
osProfile |
指定重置非临时 OS 磁盘映像所需的信息。 |
|
tempDisk |
boolean |
指定是否对临时磁盘重置映像。 默认值:false。 注意:只有具有临时 OS 磁盘的 VM/VMSS 才支持此临时磁盘重置映像参数。 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
确定 |
|
202 Accepted |
已接受 |
|
Other Status Codes |
描述操作失败原因的错误响应。 |
安全性
azure_auth
Azure Active Directory OAuth2 流
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
名称 | 说明 |
---|---|
user_impersonation | 模拟用户帐户 |
示例
Virtual |
Virtual |
VirtualMachineScaleSet_Reimage_MaximumSet_Gen
Sample Request
POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaaaaaaaaaa/reimage?api-version=2024-03-01
{
"instanceIds": [
"aaaaaaaaaa"
],
"forceUpdateOSDiskForEphemeral": true,
"tempDisk": true
}
Sample Response
location: https://foo.com/operationstatus
VirtualMachineScaleSet_Reimage_MinimumSet_Gen
Sample Request
POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaaaaaaaaaaaa/reimage?api-version=2024-03-01
Sample Response
location: https://foo.com/operationstatus
定义
名称 | 说明 |
---|---|
Api |
API 错误。 |
Api |
API 错误基。 |
Cloud |
来自计算服务的错误响应。 |
Inner |
内部错误详细信息。 |
OSProfile |
用于重置非临时虚拟机映像的其他参数。 |
Virtual |
介绍虚拟机规模集 VM 重置映像参数。 |
ApiError
API 错误。
名称 | 类型 | 说明 |
---|---|---|
code |
string |
错误代码。 |
details |
API 错误详细信息 |
|
innererror |
Api 内部错误 |
|
message |
string |
错误消息。 |
target |
string |
特定错误的目标。 |
ApiErrorBase
API 错误基。
名称 | 类型 | 说明 |
---|---|---|
code |
string |
错误代码。 |
message |
string |
错误消息。 |
target |
string |
特定错误的目标。 |
CloudError
来自计算服务的错误响应。
名称 | 类型 | 说明 |
---|---|---|
error |
API 错误。 |
InnerError
内部错误详细信息。
名称 | 类型 | 说明 |
---|---|---|
errordetail |
string |
内部错误消息或异常转储。 |
exceptiontype |
string |
异常类型。 |
OSProfileProvisioningData
用于重置非临时虚拟机映像的其他参数。
名称 | 类型 | 说明 |
---|---|---|
adminPassword |
string |
指定管理员帐户的密码。 |
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 |
指定重置非临时 OS 磁盘映像所需的信息。 |
|
tempDisk |
boolean |
指定是否对临时磁盘重置映像。 默认值:false。 注意:只有具有临时 OS 磁盘的 VM/VMSS 才支持此临时磁盘重置映像参数。 |