Partilhar via


Virtual Machine Scale Sets - Get OS Upgrade History

Obtém uma lista de atualizações do sistema operacional em uma instância de conjunto de escala de VM.

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

Parâmetros do URI

Name Em Necessá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. O ID da assinatura faz parte do URI de cada chamada de serviço.

vmScaleSetName
path True

string

O nome do conjunto de escala de VM.

api-version
query True

string

Versão da API do cliente.

Respostas

Name Tipo Description
200 OK

VirtualMachineScaleSetListOSUpgradeHistory

OK

Other Status Codes

CloudError

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

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation personificar a sua conta de utilizador

Exemplos

VirtualMachineScaleSet_GetOSUpgradeHistory_MaximumSet_Gen
VirtualMachineScaleSet_GetOSUpgradeHistory_MinimumSet_Gen

VirtualMachineScaleSet_GetOSUpgradeHistory_MaximumSet_Gen

Pedido de amostra

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

Resposta da amostra

{
  "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

Pedido de amostra

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

Resposta da amostra

{
  "value": [
    {}
  ]
}

Definições

Name Description
ApiError

Erro de api.

ApiErrorBase

Base de erro da 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 de mercado ou imagens de máquina virtual. Esse elemento é necessário quando você deseja usar uma imagem de plataforma, imagem de mercado ou imagem de máquina virtual, mas não é usado em outras operações de criação. NOTA: O editor e a oferta de referência de imagem só podem ser definidos quando cria o conjunto de escalas.

InnerError

Detalhes do erro interno.

RollbackStatusInfo

Informações sobre 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

Escala da máquina virtual Definir resposta de operação do histórico de atualização do sistema operacional.

UpgradeOperationHistoricalStatusInfoProperties

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

UpgradeOperationHistoryStatus

Informações sobre o estado atual de execução 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 de respostas de operação do Histórico de Atualização do Conjunto de Dimensionamento de Máquinas Virtuais.

ApiError

Erro de api.

Name Tipo Description
code

string

O código de erro.

details

ApiErrorBase[]

Os detalhes do erro Api

innererror

InnerError

O erro interno da Api

message

string

A mensagem de erro.

target

string

O alvo do erro específico.

ApiErrorBase

Base de erro da api.

Name Tipo Description
code

string

O código de erro.

message

string

A mensagem de erro.

target

string

O alvo do erro específico.

CloudError

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

Name 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 de mercado ou imagens de máquina virtual. Esse elemento é necessário quando você deseja usar uma imagem de plataforma, imagem de mercado ou imagem de máquina virtual, mas não é usado em outras operações de criação. NOTA: O editor e a oferta de referência de imagem só podem ser definidos quando cria o conjunto de escalas.

Name Tipo Description
communityGalleryImageId

string

Especificada a id exclusiva da imagem da galeria da comunidade para implantação de vm. Isso pode ser obtido na chamada GET da galeria da galeria da comunidade.

exactVersion

string

Especifica em números decimais, a versão da imagem da plataforma ou da imagem do mercado usada para criar a máquina virtual. Este campo só de leitura difere de «versão», apenas se o valor especificado no campo «versão» for «mais recente».

id

string

ID do recurso

offer

string

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

publisher

string

A editora de imagens.

sharedGalleryImageId

string

Especificada a id exclusiva da imagem da galeria compartilhada para implantação de vm. Isso pode ser obtido na chamada GET da imagem compartilhada da galeria.

sku

string

A imagem SKU.

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 'mais recente'. 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 se você usar 'mais recente', 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. Por favor, não use o campo 'versão' para a implantação da imagem da galeria, a imagem da galeria deve sempre 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.

Name 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 reversão em instâncias de VM com falha após uma operação de atualização do sistema operacional.

Name Tipo Description
failedRolledbackInstanceCount

integer

O número de instâncias que não conseguiram reverter.

rollbackError

ApiError

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

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.

Name Tipo Description
failedInstanceCount

integer

O número de instâncias que não puderam ser 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

Escala da máquina virtual Definir resposta de operação do histórico de atualização do sistema operacional.

Name 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áquina Virtual.

Name Tipo Description
error

ApiError

Detalhes do erro para esta atualização, se houver.

progress

RollingUpgradeProgressInfo

Contagens das VMs em cada estado.

rollbackInfo

RollbackStatusInfo

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

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 da imagem

UpgradeOperationHistoryStatus

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

Name 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

Name Tipo Description
Platform

string

Unknown

string

User

string

UpgradeState

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

Name Tipo Description
Cancelled

string

Completed

string

Faulted

string

RollingForward

string

VirtualMachineScaleSetListOSUpgradeHistory

Lista de respostas de operação do Histórico de Atualização do Conjunto de Dimensionamento de Máquinas Virtuais.

Name Tipo Description
nextLink

string

O uri para buscar a próxima página do Histórico de Atualização do SO. 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 da máquina virtual.