Share via


Virtual Machine Scale Sets - Get OS Upgrade History

Obtém a lista de atualizações do sistema operacional em uma instância do conjunto de dimensionamento de VMs.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/osUpgradeHistory?api-version=2024-03-01

Parâmetros de URI

Nome Em Obrigatório Tipo Description
resourceGroupName
path True

string

O nome do grupo de recursos.

subscriptionId
path True

string

Credenciais de assinatura que identificam exclusivamente a assinatura do Microsoft Azure. A ID da assinatura faz parte do URI para cada chamada de serviço.

vmScaleSetName
path True

string

O nome do conjunto de dimensionamento da VM.

api-version
query True

string

Versão da API do cliente.

Respostas

Nome Tipo Description
200 OK

VirtualMachineScaleSetListOSUpgradeHistory

OK

Other Status Codes

CloudError

Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

VirtualMachineScaleSet_GetOSUpgradeHistory_MaximumSet_Gen
VirtualMachineScaleSet_GetOSUpgradeHistory_MinimumSet_Gen

VirtualMachineScaleSet_GetOSUpgradeHistory_MaximumSet_Gen

Sample Request

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaa/osUpgradeHistory?api-version=2024-03-01

Sample Response

{
  "value": [
    {
      "properties": {
        "runningStatus": {
          "code": "RollingForward",
          "startTime": "2021-11-30T13:05:40.442Z",
          "endTime": "2021-11-30T13:05:40.443Z"
        },
        "progress": {
          "successfulInstanceCount": 6,
          "failedInstanceCount": 25,
          "inProgressInstanceCount": 20,
          "pendingInstanceCount": 27
        },
        "error": {
          "details": [
            {
              "code": "aaaaaaaaaaaaaaaaaaaaaaaa",
              "target": "aaaa",
              "message": "aa"
            }
          ],
          "innererror": {
            "exceptiontype": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
            "errordetail": "aaaaaaaaaaaaaaaaaaaaaaaa"
          },
          "code": "aaaaaaa",
          "target": "aaaaaaa",
          "message": "aaaaaaaaa"
        },
        "startedBy": "Unknown",
        "targetImageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer",
          "exactVersion": "aaaaaaa",
          "sharedGalleryImageId": "aaaaaa",
          "id": "aaaaaaaaaaaaaaaaaaa"
        },
        "rollbackInfo": {
          "successfullyRolledbackInstanceCount": 12,
          "failedRolledbackInstanceCount": 2,
          "rollbackError": {
            "details": [
              {
                "code": "aaaaaaaaaaaaaaaaaaaaaaaa",
                "target": "aaaa",
                "message": "aa"
              }
            ],
            "innererror": {
              "exceptiontype": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
              "errordetail": "aaaaaaaaaaaaaaaaaaaaaaaa"
            },
            "code": "aaaaaaa",
            "target": "aaaaaaa",
            "message": "aaaaaaaaa"
          }
        }
      },
      "type": "aaaaaaaaaaaaaaaaaaa",
      "location": "aaaaaaaaaaaaa"
    }
  ],
  "nextLink": "aaaaaaaaa"
}

VirtualMachineScaleSet_GetOSUpgradeHistory_MinimumSet_Gen

Sample Request

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaaaaaaaaaa/osUpgradeHistory?api-version=2024-03-01

Sample Response

{
  "value": [
    {}
  ]
}

Definições

Nome Description
ApiError

Erro de API.

ApiErrorBase

Base de erros de API.

CloudError

Uma resposta de erro do serviço de computação.

ImageReference

Especifica informações sobre a imagem a ser usada. Você pode especificar informações sobre imagens de plataforma, imagens do marketplace ou imagens de máquina virtual. Esse elemento é necessário quando você deseja usar uma imagem de plataforma, uma imagem do marketplace ou uma imagem de máquina virtual, mas não é usado em outras operações de criação. OBSERVAÇÃO: a oferta e o editor de referência de imagem só podem ser definidos quando você cria o conjunto de dimensionamento.

InnerError

Detalhes do erro interno.

RollbackStatusInfo

Informações sobre a reversão em instâncias de VM com falha após uma operação de atualização do sistema operacional.

RollingUpgradeProgressInfo

Informações sobre o número de instâncias de máquina virtual em cada estado de atualização.

UpgradeOperationHistoricalStatusInfo

Resposta da operação histórico de atualização do sistema operacional do Conjunto de Dimensionamento de Máquinas Virtuais.

UpgradeOperationHistoricalStatusInfoProperties

Descreve cada atualização do sistema operacional no Conjunto de Dimensionamento de Máquinas Virtuais.

UpgradeOperationHistoryStatus

Informações sobre o estado de execução atual da atualização geral.

UpgradeOperationInvoker

Invocador da operação de atualização

UpgradeState

Código que indica o status atual da atualização.

VirtualMachineScaleSetListOSUpgradeHistory

Lista da resposta da operação histórico de atualização do sistema operacional do Conjunto de Dimensionamento de Máquinas Virtuais.

ApiError

Erro de API.

Nome Tipo Description
code

string

O código de erro.

details

ApiErrorBase[]

Os detalhes do erro da API

innererror

InnerError

O erro interno da API

message

string

A mensagem de erro.

target

string

O destino do erro específico.

ApiErrorBase

Base de erros de API.

Nome 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.

Nome Tipo Description
error

ApiError

Erro de API.

ImageReference

Especifica informações sobre a imagem a ser usada. Você pode especificar informações sobre imagens de plataforma, imagens do marketplace ou imagens de máquina virtual. Esse elemento é necessário quando você deseja usar uma imagem de plataforma, uma imagem do marketplace ou uma imagem de máquina virtual, mas não é usado em outras operações de criação. OBSERVAÇÃO: a oferta e o editor de referência de imagem só podem ser definidos quando você cria o conjunto de dimensionamento.

Nome Tipo Description
communityGalleryImageId

string

Especificada a ID exclusiva da imagem da galeria da comunidade para implantação de VM. Isso pode ser buscado na chamada GET da imagem da galeria da comunidade.

exactVersion

string

Especifica em números decimais, a versão da imagem da plataforma ou da imagem do marketplace usada para criar a máquina virtual. Esse campo somente leitura difere de 'version', somente se o valor especificado no campo 'version' for 'latest'.

id

string

ID do recurso

offer

string

Especifica a oferta da imagem da plataforma ou da imagem do marketplace usada para criar a máquina virtual.

publisher

string

O editor de imagens.

sharedGalleryImageId

string

Especificamos a ID exclusiva da imagem da galeria compartilhada para implantação de VM. Isso pode ser buscado na chamada GET da imagem da galeria compartilhada.

sku

string

A SKU da imagem.

version

string

Especifica a versão da imagem da plataforma ou da imagem do marketplace usada para criar a máquina virtual. Os formatos permitidos são Major.Minor.Build ou 'latest'. Major, Minor e Build são números decimais. Especifique 'mais recente' para usar a versão mais recente de uma imagem disponível no momento da implantação. Mesmo que você use 'latest', a imagem da VM não será atualizada automaticamente após o tempo de implantação, mesmo que uma nova versão fique disponível. Não use o campo 'version' para implantação de imagem da galeria, a imagem da galeria sempre deve usar o campo 'id' para implantação, para usar a versão 'mais recente' da imagem da galeria, basta definir '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageName}' no campo 'id' sem entrada de versão.

InnerError

Detalhes do erro interno.

Nome Tipo Description
errordetail

string

A mensagem de erro interna ou despejo de exceção.

exceptiontype

string

O tipo de exceção.

RollbackStatusInfo

Informações sobre a reversão em instâncias de VM com falha após uma operação de atualização do sistema operacional.

Nome Tipo Description
failedRolledbackInstanceCount

integer

O número de instâncias que falharam na reversão.

rollbackError

ApiError

Detalhes do erro se a reversão do sistema operacional falhou.

successfullyRolledbackInstanceCount

integer

O número de instâncias que foram revertidas com êxito.

RollingUpgradeProgressInfo

Informações sobre o número de instâncias de máquina virtual em cada estado de atualização.

Nome Tipo Description
failedInstanceCount

integer

O número de instâncias que não foram atualizadas com êxito.

inProgressInstanceCount

integer

O número de instâncias que estão sendo atualizadas no momento.

pendingInstanceCount

integer

O número de instâncias que ainda não começaram a ser atualizadas.

successfulInstanceCount

integer

O número de instâncias que foram atualizadas com êxito.

UpgradeOperationHistoricalStatusInfo

Resposta da operação histórico de atualização do sistema operacional do Conjunto de Dimensionamento de Máquinas Virtuais.

Nome Tipo Description
location

string

Localização do recurso

properties

UpgradeOperationHistoricalStatusInfoProperties

Informações sobre as propriedades da operação de atualização.

type

string

Tipo de recurso

UpgradeOperationHistoricalStatusInfoProperties

Descreve cada atualização do sistema operacional no Conjunto de Dimensionamento de Máquinas Virtuais.

Nome Tipo Description
error

ApiError

Detalhes do erro para essa atualização se houver algum.

progress

RollingUpgradeProgressInfo

Contagens das VMs em cada estado.

rollbackInfo

RollbackStatusInfo

Informações sobre a reversão do sistema operacional se executadas

runningStatus

UpgradeOperationHistoryStatus

Informações sobre o status geral da operação de atualização.

startedBy

UpgradeOperationInvoker

Invocador da operação de atualização

targetImageReference

ImageReference

Detalhes da Referência de Imagem

UpgradeOperationHistoryStatus

Informações sobre o estado de execução atual da atualização geral.

Nome Tipo Description
code

UpgradeState

Código que indica o status atual da atualização.

endTime

string

Hora de término da atualização.

startTime

string

Hora de início da atualização.

UpgradeOperationInvoker

Invocador da operação de atualização

Nome Tipo Description
Platform

string

Unknown

string

User

string

UpgradeState

Código que indica o status atual da atualização.

Nome Tipo Description
Cancelled

string

Completed

string

Faulted

string

RollingForward

string

VirtualMachineScaleSetListOSUpgradeHistory

Lista da resposta da operação histórico de atualização do sistema operacional do Conjunto de Dimensionamento de Máquinas Virtuais.

Nome Tipo Description
nextLink

string

O uri para buscar a próxima página do Histórico de Atualização do sistema operacional. Chame ListNext() com isso para buscar a próxima página do histórico de atualizações.

value

UpgradeOperationHistoricalStatusInfo[]

A lista de atualizações do sistema operacional executadas no conjunto de dimensionamento de máquinas virtuais.