你当前正在访问 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 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
resource
|
path | True |
string |
资源组的名称。 |
subscription
|
path | True |
string |
唯一标识 azure 订阅Microsoft的订阅凭据。 订阅 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 Flow
类型:
oauth2
流向:
implicit
授权 URL:
https://login.microsoftonline.com/common/oauth2/authorize
作用域
名称 | 说明 |
---|---|
user_impersonation | 模拟用户帐户 |
示例
Virtual |
Virtual |
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
示例请求
示例响应
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 才支持此临时磁盘重置映像参数。 |