Virtual Machines - Install Patches
Instala patches na VM.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/installPatches?api-version=2024-03-01
Parâmetros do URI
Name | Em | Necessário | Tipo | Description |
---|---|---|---|---|
resource
|
path | True |
string |
O nome do grupo de recursos. |
subscription
|
path | True |
string |
Credenciais de subscrição que identificam exclusivamente a subscrição do Microsoft Azure. O ID da subscrição faz parte do URI para cada chamada de serviço. |
vm
|
path | True |
string |
O nome da máquina virtual. |
api-version
|
query | True |
string |
Versão da API do Cliente. |
Corpo do Pedido
Name | Tipo | Description |
---|---|---|
installPatchesInput |
Entrada para InstallPatches, conforme recebido diretamente pela API |
Respostas
Name | Tipo | Description |
---|---|---|
200 OK |
OK |
|
202 Accepted |
Aceite |
|
Other Status Codes |
Resposta de erro que descreve o motivo pela qual a operação falhou. |
Segurança
azure_auth
Fluxo OAuth2 do Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | representar a sua conta de utilizador |
Exemplos
Install patch state of a virtual machine.
Sample Request
POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroupName/providers/Microsoft.Compute/virtualMachines/myVMName/installPatches?api-version=2024-03-01
{
"maximumDuration": "PT4H",
"rebootSetting": "IfRequired",
"windowsParameters": {
"classificationsToInclude": [
"Critical",
"Security"
],
"maxPatchPublishDate": "2020-11-19T02:36:43.0539904+00:00"
}
}
Sample Response
{
"status": "Succeeded",
"installationActivityId": "68f8b292-dfc2-4646-9781-33cc88631968",
"rebootStatus": "Completed",
"maintenanceWindowExceeded": false,
"excludedPatchCount": 0,
"notSelectedPatchCount": 0,
"pendingPatchCount": 2,
"installedPatchCount": 3,
"failedPatchCount": 0,
"startDateTime": "2020-04-24T21:02:04.2556154Z",
"patches": [
{
"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"
],
"installationState": "Installed"
},
{
"patchId": "39f9cdd1-795c-4d0e-8c0a-73ab3f31746d",
"name": "Windows Malicious Software Removal Tool x64 - October 2018 (KB890830)",
"version": "",
"kbId": "890830",
"classifications": [
"Update Rollups"
],
"installationState": "Pending"
}
],
"error": null
}
Location: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/westus/operations/{operationId}&monitor=true&api-version=2024-03-01
Definições
Name | Description |
---|---|
Api |
Erro de API. |
Api |
Base de erros da API. |
Cloud |
Uma resposta de erro do serviço de Computação. |
Inner |
Detalhes do erro interno. |
Linux |
Entrada para InstallPatches numa VM do Linux, conforme recebido diretamente pela API |
Patch |
Os patches que foram instalados durante a operação. |
Patch |
O estado do patch após a conclusão da operação de instalação. |
Patch |
O estado geral de êxito ou falha da operação. Permanece "InProgress" até que a operação seja concluída. Nessa altura, tornar-se-á "Com Falhas", "Com Êxito", "Desconhecido" ou "CompletedWithWarnings". |
Virtual |
Entrada para InstallPatches, conforme recebido diretamente pela API |
Virtual |
O resumo do resultado de uma operação de instalação. |
VMGuest |
As classificações de atualização a selecionar ao instalar patches para Linux. |
VMGuest |
As classificações de atualização a selecionar ao instalar patches para o Windows. |
VMGuest |
Define quando é aceitável reiniciar uma VM durante uma operação de atualização de software. |
VMGuest |
O estado de reinício da VM após a conclusão da operação. |
Windows |
Entrada para InstallPatches numa VM do Windows, conforme recebido diretamente pela API |
ApiError
Erro de API.
Name | Tipo | Description |
---|---|---|
code |
string |
O código de erro. |
details |
Os detalhes do erro da API |
|
innererror |
O erro interno da API |
|
message |
string |
A mensagem de erro. |
target |
string |
O destino do erro específico. |
ApiErrorBase
Base de erros da API.
Name | Tipo | Description |
---|---|---|
code |
string |
O código de erro. |
message |
string |
A mensagem de erro. |
target |
string |
O destino do erro específico. |
CloudError
Uma resposta de erro do serviço de Computação.
Name | Tipo | Description |
---|---|---|
error |
Erro de API. |
InnerError
Detalhes do erro interno.
Name | Tipo | Description |
---|---|---|
errordetail |
string |
A mensagem de erro interna ou a informação de falha de sistema da exceção. |
exceptiontype |
string |
O tipo de exceção. |
LinuxParameters
Entrada para InstallPatches numa VM do Linux, conforme recebido diretamente pela API
Name | Tipo | Description |
---|---|---|
classificationsToInclude |
As classificações de atualização a selecionar ao instalar patches para Linux. |
|
maintenanceRunId |
string |
Isto é utilizado como um identificador de execução de manutenção para a Aplicação de Patches de Convidado de VM Automática no Linux. |
packageNameMasksToExclude |
string[] |
pacotes a excluir na operação de patch. Formato: packageName_packageVersion |
packageNameMasksToInclude |
string[] |
pacotes a incluir na operação de patch. Formato: packageName_packageVersion |
PatchInstallationDetail
Os patches que foram instalados durante a operação.
Name | Tipo | Description |
---|---|---|
classifications |
string[] |
As classificações do patch, conforme fornecido pelo fabricante do patch. |
installationState |
O estado do patch após a conclusão da operação de instalação. |
|
kbId |
string |
O KBID do patch. Aplica-se apenas a patches do Windows. |
name |
string |
O nome amigável do patch. |
patchId |
string |
Um identificador exclusivo para o patch. |
version |
string |
A cadeia de versão do pacote. Pode estar em conformidade com o Controlo de Versões Semântico. Aplica-se apenas ao Linux. |
PatchInstallationState
O estado do patch após a conclusão da operação de instalação.
Name | Tipo | Description |
---|---|---|
Excluded |
string |
|
Failed |
string |
|
Installed |
string |
|
NotSelected |
string |
|
Pending |
string |
|
Unknown |
string |
PatchOperationStatus
O estado geral de êxito ou falha da operação. Permanece "InProgress" até que a operação seja concluída. Nessa altura, tornar-se-á "Com Falhas", "Com Êxito", "Desconhecido" ou "CompletedWithWarnings".
Name | Tipo | Description |
---|---|---|
CompletedWithWarnings |
string |
|
Failed |
string |
|
InProgress |
string |
|
Succeeded |
string |
|
Unknown |
string |
VirtualMachineInstallPatchesParameters
Entrada para InstallPatches, conforme recebido diretamente pela API
Name | Tipo | Description |
---|---|---|
linuxParameters |
Entrada para InstallPatches numa VM do Linux, conforme recebido diretamente pela API |
|
maximumDuration |
string |
Especifica a quantidade máxima de tempo que a operação irá executar. Tem de ser uma cadeia de duração compatível com ISO 8601, como PT4H (4 horas) |
rebootSetting |
Define quando é aceitável reiniciar uma VM durante uma operação de atualização de software. |
|
windowsParameters |
Entrada para InstallPatches numa VM do Windows, conforme recebido diretamente pela API |
VirtualMachineInstallPatchesResult
O resumo do resultado de uma operação de instalação.
Name | Tipo | Description |
---|---|---|
error |
Os erros encontrados durante a execução da operação. A matriz de detalhes contém a lista dos mesmos. |
|
excludedPatchCount |
integer |
O número de patches que não foram instalados devido ao utilizador estar a bloquear a instalação. |
failedPatchCount |
integer |
O número de patches que não foi possível instalar devido a algum problema. Veja erros para obter detalhes. |
installationActivityId |
string |
O ID de atividade da operação que produziu este resultado. É utilizado para correlacionar entre registos de CRP e extensões. |
installedPatchCount |
integer |
O número de patches instalados com êxito. |
maintenanceWindowExceeded |
boolean |
Se a operação esgotou o tempo antes de concluir todas as ações pretendidas. |
notSelectedPatchCount |
integer |
O número de patches que foram detetados como disponíveis para instalação, mas não cumpriram os critérios da operação. |
patches |
Os patches que foram instalados durante a operação. |
|
pendingPatchCount |
integer |
O número de patches que foram identificados como cumprindo os critérios de instalação, mas não foram capazes de ser instalados. Normalmente, isto acontece quando maintenanceWindowExceeded == true. |
rebootStatus |
O estado de reinício da VM após a conclusão da operação. |
|
startDateTime |
string |
O carimbo de data/hora UTC quando a operação começou. |
status |
O estado geral de êxito ou falha da operação. Permanece "InProgress" até que a operação seja concluída. Nessa altura, tornar-se-á "Com Falhas", "Com Êxito", "Desconhecido" ou "CompletedWithWarnings". |
VMGuestPatchClassification_Linux
As classificações de atualização a selecionar ao instalar patches para Linux.
Name | Tipo | Description |
---|---|---|
Critical |
string |
|
Other |
string |
|
Security |
string |
VMGuestPatchClassification_Windows
As classificações de atualização a selecionar ao instalar patches para o Windows.
Name | Tipo | Description |
---|---|---|
Critical |
string |
|
Definition |
string |
|
FeaturePack |
string |
|
Security |
string |
|
ServicePack |
string |
|
Tools |
string |
|
UpdateRollUp |
string |
|
Updates |
string |
VMGuestPatchRebootSetting
Define quando é aceitável reiniciar uma VM durante uma operação de atualização de software.
Name | Tipo | Description |
---|---|---|
Always |
string |
|
IfRequired |
string |
|
Never |
string |
VMGuestPatchRebootStatus
O estado de reinício da VM após a conclusão da operação.
Name | Tipo | Description |
---|---|---|
Completed |
string |
|
Failed |
string |
|
NotNeeded |
string |
|
Required |
string |
|
Started |
string |
|
Unknown |
string |
WindowsParameters
Entrada para InstallPatches numa VM do Windows, conforme recebido diretamente pela API
Name | Tipo | Description |
---|---|---|
classificationsToInclude |
As classificações de atualização a selecionar ao instalar patches para o Windows. |
|
excludeKbsRequiringReboot |
boolean |
Filtra Kbs que não têm um InstallationRebootBehavior de "NeverReboots" quando está definido como verdadeiro. |
kbNumbersToExclude |
string[] |
Kbs a excluir na operação de patch |
kbNumbersToInclude |
string[] |
Kbs a incluir na operação de patch |
maxPatchPublishDate |
string |
Isto é utilizado para instalar patches que foram publicados em ou antes desta data máxima publicada. |