你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Virtual Machines - Assess Patches
评估 VM 上的修补程序。
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/assessPatches?api-version=2024-07-01
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
resource
|
path | True |
string |
资源组的名称。 |
subscription
|
path | True |
string |
唯一标识 azure 订阅Microsoft的订阅凭据。 订阅 ID 构成了每个服务调用的 URI 的一部分。 |
vm
|
path | True |
string |
虚拟机的名称。 |
api-version
|
query | True |
string |
客户端 API 版本。 |
响应
名称 | 类型 | 说明 |
---|---|---|
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 | 模拟用户帐户 |
示例
Assess patch state of a virtual machine.
示例请求
示例响应
{
"status": "Succeeded",
"assessmentActivityId": "68f8b292-dfc2-4646-9781-33cc88631968",
"rebootPending": true,
"criticalAndSecurityPatchCount": 1,
"otherPatchCount": 2,
"startDateTime": "2020-04-24T21:02:04.2556154Z",
"availablePatches": [
{
"patchId": "35428702-5784-4ba4-a6e0-5222258b5411",
"name": "Definition Update for Windows Defender Antivirus - KB2267602 (Definition 1.279.1373.0)",
"version": "",
"kbId": "2267602",
"classifications": [
"Definition Updates"
],
"rebootBehavior": "NeverReboots",
"activityId": "68f8b292-dfc2-4646-9781-33cc88631968",
"publishedDate": "2018-11-07T00:00:00Z",
"lastModifiedDateTime": "2020-04-24T21:18:45.2830263Z",
"assessmentState": "Available"
},
{
"patchId": "39f9cdd1-795c-4d0e-8c0a-73ab3f31746d",
"name": "Windows Malicious Software Removal Tool x64 - October 2018 (KB890830)",
"version": "",
"kbId": "890830",
"classifications": [
"Update Rollups"
],
"rebootBehavior": "CanRequestReboot",
"activityId": "68f8b292-dfc2-4646-9781-33cc88631968",
"publishedDate": "2018-11-07T00:00:00Z",
"lastModifiedDateTime": "2020-04-24T21:18:45.2830263Z",
"assessmentState": "Available"
}
],
"error": null
}
Location: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/westus/operations/{operationId}&monitor=true&api-version=2024-07-01
定义
名称 | 说明 |
---|---|
Api |
Api 错误。 |
Api |
Api 错误基数。 |
Cloud |
来自计算服务的错误响应。 |
Inner |
内部错误详细信息。 |
Patch |
描述给定修补程序的可用性。 |
Patch |
操作的总体成功或失败状态。 在操作完成之前,它将保持“InProgress”。 此时,它将变为“Unknown”、“Failed”、“Succeeded”或“CompletedWithWarnings”。 |
Virtual |
描述 AssessPatches 结果的属性。 |
Virtual |
检测到的修补程序列表可用于安装。 |
VMGuest |
描述修补程序的重新启动要求。 |
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 |
异常类型。 |
PatchAssessmentState
描述给定修补程序的可用性。
名称 | 类型 | 说明 |
---|---|---|
Available |
string |
|
Unknown |
string |
PatchOperationStatus
操作的总体成功或失败状态。 在操作完成之前,它将保持“InProgress”。 此时,它将变为“Unknown”、“Failed”、“Succeeded”或“CompletedWithWarnings”。
名称 | 类型 | 说明 |
---|---|---|
CompletedWithWarnings |
string |
|
Failed |
string |
|
InProgress |
string |
|
Succeeded |
string |
|
Unknown |
string |
VirtualMachineAssessPatchesResult
描述 AssessPatches 结果的属性。
名称 | 类型 | 说明 |
---|---|---|
assessmentActivityId |
string |
生成此结果的操作的活动 ID。 它用于跨 CRP 和扩展日志关联。 |
availablePatches |
检测到的修补程序列表可用于安装。 |
|
criticalAndSecurityPatchCount |
integer |
检测到为可用但尚未安装的关键或安全修补程序的数量。 |
error |
执行操作期间遇到的错误。 详细信息数组包含它们的列表。 |
|
otherPatchCount |
integer |
排除关键和安全性的所有可用修补程序的数量。 |
rebootPending |
boolean |
VM 的总体重启状态。 当部分安装的修补程序需要重新启动才能完成安装,但尚未重新启动时,情况将属实。 |
startDateTime |
string |
操作开始时的 UTC 时间戳。 |
status |
操作的总体成功或失败状态。 在操作完成之前,它将保持“InProgress”。 此时,它将变为“Unknown”、“Failed”、“Succeeded”或“CompletedWithWarnings”。 |
VirtualMachineSoftwarePatchProperties
检测到的修补程序列表可用于安装。
名称 | 类型 | 说明 |
---|---|---|
activityId |
string |
生成此结果的操作的活动 ID。 它用于跨 CRP 和扩展日志关联。 |
assessmentState |
描述给定修补程序的可用性。 |
|
classifications |
string[] |
修补程序的分类(s)由修补程序发布者提供。 |
kbId |
string |
修补程序的 KBID。 仅适用于 Windows 修补程序。 |
lastModifiedDateTime |
string |
上次更新此修补程序记录的 UTC 时间戳。 |
name |
string |
修补程序的友好名称。 |
patchId |
string |
修补程序的唯一标识符。 |
publishedDate |
string |
存储库发布此修补程序时的 UTC 时间戳。 |
rebootBehavior |
描述修补程序的重新启动要求。 |
|
version |
string |
修补程序的版本号。 此属性仅适用于 Linux 修补程序。 |
VMGuestPatchRebootBehavior
描述修补程序的重新启动要求。
名称 | 类型 | 说明 |
---|---|---|
AlwaysRequiresReboot |
string |
|
CanRequestReboot |
string |
|
NeverReboots |
string |
|
Unknown |
string |