你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Virtual Machine Scale Set VMs - Reimage
重置映像 (升级 VM 规模集中的特定虚拟机) 操作系统。
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/virtualMachines/{instanceId}/reimage?api-version=2024-03-01
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
instance
|
path | True |
string |
虚拟机的实例 ID。 |
resource
|
path | True |
string |
资源组的名称。 |
subscription
|
path | True |
string |
唯一标识 Microsoft Azure 订阅的订阅凭据。 此订阅 ID 是每个服务调用的 URI 的一部分。 |
vm
|
path | True |
string |
VM 规模集的名称。 |
api-version
|
query | True |
string |
客户端 API 版本。 |
请求正文
名称 | 类型 | 说明 |
---|---|---|
vmScaleSetVMReimageInput |
在 ScaleSet 中重置虚拟机映像的参数。 |
响应
名称 | 类型 | 说明 |
---|---|---|
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 |
VirtualMachineScaleSetVM_Reimage_MaximumSet_Gen
Sample Request
POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaa/virtualMachines/aaaaaaaaaaaaaaaaaaaaaaaaaaaaa/reimage?api-version=2024-03-01
{
"forceUpdateOSDiskForEphemeral": true,
"tempDisk": true
}
Sample Response
location: https://foo.com/operationstatus
VirtualMachineScaleSetVM_Reimage_MinimumSet_Gen
Sample Request
POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaa/virtualMachines/aaaaaaaaaaaaa/reimage?api-version=2024-03-01
Sample Response
location: https://foo.com/operationstatus
定义
名称 | 说明 |
---|---|
Api |
Api 错误。 |
Api |
Api 错误基。 |
Cloud |
来自计算服务的错误响应。 |
Inner |
内部错误详细信息。 |
OSProfile |
指定重新创建非临时 OS 磁盘映像所需的信息。 |
Virtual |
在 ScaleSet 中重置虚拟机映像的参数。 |
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
指定重新创建非临时 OS 磁盘映像所需的信息。
名称 | 类型 | 说明 |
---|---|---|
adminPassword |
string |
指定管理员帐户的密码。 |
customData |
string |
指定自定义数据的 Base-64 编码的字符串。 Base-64 编码的字符串将解码为一个二元数组并作为一个文件保存在虚拟机上。 该二元数组的最大长度为 65535 字节。 注意:请勿在 customData 属性中传递任何机密或密码。 创建 VM 后,无法更新此属性。 属性 customData 传递到 VM 以保存为文件,有关详细信息,请参阅 Azure VM 上的自定义数据。 如果对 Linux VM 使用 cloud-init,请参阅 在创建期间使用 cloud-init 自定义 Linux VM。 |
VirtualMachineScaleSetVMReimageParameters
在 ScaleSet 中重置虚拟机映像的参数。
名称 | 类型 | 说明 |
---|---|---|
exactVersion |
string |
以十进制数字指定 OS 磁盘应重新映像到的版本。 如果未提供确切版本,OS 磁盘将重新映像到 OS 磁盘的现有版本。 |
forceUpdateOSDiskForEphemeral |
boolean |
强制更新虚拟机规模集 VM 的临时 OS 磁盘的参数 |
osProfile |
指定重新创建非临时 OS 磁盘映像所需的信息。 |
|
tempDisk |
boolean |
指定是否重置临时磁盘映像。 默认值:false。 注意:此临时磁盘重置映像参数仅支持具有临时 OS 磁盘的 VM/VMSS。 |