Compartilhar via


Virtual Machine Scale Set Rolling Upgrades - Get Latest

Obtém o status da atualização sem interrupção do conjunto de dimensionamento de máquinas virtuais mais recente.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/rollingUpgrades/latest?api-version=2024-07-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

RollingUpgradeStatusInfo

OKEY

Other Status Codes

CloudError

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

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

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

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

VirtualMachineScaleSetRollingUpgrade_GetLatest_MaximumSet_Gen
VirtualMachineScaleSetRollingUpgrade_GetLatest_MinimumSet_Gen

VirtualMachineScaleSetRollingUpgrade_GetLatest_MaximumSet_Gen

Solicitação de exemplo

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

Resposta de exemplo

{
  "properties": {
    "policy": {
      "maxBatchInstancePercent": 49,
      "maxUnhealthyInstancePercent": 81,
      "maxUnhealthyUpgradedInstancePercent": 98,
      "pauseTimeBetweenBatches": "aaaaaaaaaaaaaaa",
      "enableCrossZoneUpgrade": true,
      "prioritizeUnhealthyInstances": true,
      "rollbackFailedInstancesOnPolicyBreach": true,
      "maxSurge": true
    },
    "runningStatus": {
      "code": "RollingForward",
      "startTime": "2021-11-30T13:06:23.362Z",
      "lastAction": "Start",
      "lastActionTime": "2021-11-30T13:06:23.362Z"
    },
    "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"
    }
  },
  "id": "aaaaaaaaaa",
  "name": "aaaaaaaaaaaaaaaaaaa",
  "type": "aaaaaaaaaaaaaaaaaaaaa",
  "location": "aaaaaa",
  "tags": {
    "key8533": "aaaaaaaaaaaaaaaaaaaaaaaa"
  }
}

VirtualMachineScaleSetRollingUpgrade_GetLatest_MinimumSet_Gen

Solicitação de exemplo

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

Resposta de exemplo

{
  "location": "aaaaaa",
  "id": "aaaaaaaaaa"
}

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.

InnerError

Detalhes do erro interno.

RollingUpgradeActionType

A última ação executada na atualização sem interrupção.

RollingUpgradePolicy

Os parâmetros de configuração usados durante a execução de uma atualização sem interrupção.

RollingUpgradeProgressInfo

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

RollingUpgradeRunningStatus

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

RollingUpgradeStatusCode

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

RollingUpgradeStatusInfo

O status da atualização sem interrupção do conjunto de dimensionamento de máquinas virtuais mais recente.

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.

InnerError

Detalhes do erro interno.

Nome Tipo Description
errordetail

string

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

exceptiontype

string

O tipo de exceção.

RollingUpgradeActionType

A última ação executada na atualização sem interrupção.

Nome Tipo Description
Cancel

string

Start

string

RollingUpgradePolicy

Os parâmetros de configuração usados durante a execução de uma atualização sem interrupção.

Nome Tipo Description
enableCrossZoneUpgrade

boolean

Permitir que o VMSS ignore os limites do AZ ao construir lotes de atualização. Leve em consideração o Domínio de Atualização e maxBatchInstancePercent para determinar o tamanho do lote.

maxBatchInstancePercent

integer

A porcentagem máxima do total de instâncias de máquina virtual que serão atualizadas simultaneamente pela atualização sem interrupção em um lote. Como isso é um máximo, instâncias não íntegras em lotes anteriores ou futuros podem fazer com que o percentual de instâncias em um lote diminua para garantir maior confiabilidade. O valor padrão para esse parâmetro é 20%.

maxSurge

boolean

Crie novas máquinas virtuais para atualizar o conjunto de dimensionamento, em vez de atualizar as máquinas virtuais existentes. As máquinas virtuais existentes serão excluídas depois que as novas máquinas virtuais forem criadas para cada lote.

maxUnhealthyInstancePercent

integer

O percentual máximo do total de instâncias de máquina virtual no conjunto de dimensionamento que pode ser simultaneamente não íntegro, seja como resultado da atualização ou por ser encontrado em um estado não íntegro pelas verificações de integridade da máquina virtual antes que a atualização sem interrupção seja anulada. Essa restrição será verificada antes de iniciar qualquer lote. O valor padrão para esse parâmetro é 20%.

maxUnhealthyUpgradedInstancePercent

integer

O percentual máximo de instâncias de máquina virtual atualizadas que podem ser encontradas em um estado não íntegro. Essa verificação ocorrerá depois que cada lote for atualizado. Se esse percentual for excedido, a atualização sem interrupção será anulada. O valor padrão para esse parâmetro é 20%.

pauseTimeBetweenBatches

string

O tempo de espera entre concluir a atualização de todas as máquinas virtuais em um lote e iniciar o próximo lote. A duração do tempo deve ser especificada no formato ISO 8601. O valor padrão é PT0S (0 segundos).

prioritizeUnhealthyInstances

boolean

Atualize todas as instâncias não íntegras em um conjunto de dimensionamento antes de qualquer instância íntegra.

rollbackFailedInstancesOnPolicyBreach

boolean

Reverter instâncias com falha para o modelo anterior se a política de Atualização Sem Interrupção for violada.

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.

RollingUpgradeRunningStatus

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

Nome Tipo Description
code

RollingUpgradeStatusCode

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

lastAction

RollingUpgradeActionType

A última ação executada na atualização sem interrupção.

lastActionTime

string

Hora da última ação da atualização.

startTime

string

Hora de início da atualização.

RollingUpgradeStatusCode

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

Nome Tipo Description
Cancelled

string

Completed

string

Faulted

string

RollingForward

string

RollingUpgradeStatusInfo

O status da atualização sem interrupção do conjunto de dimensionamento de máquinas virtuais mais recente.

Nome Tipo Description
id

string

ID do recurso

location

string

Local do recurso

name

string

Nome do recurso

properties.error

ApiError

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

properties.policy

RollingUpgradePolicy

As políticas de atualização sem interrupção aplicadas a essa atualização.

properties.progress

RollingUpgradeProgressInfo

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

properties.runningStatus

RollingUpgradeRunningStatus

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

tags

object

Marcas de recurso

type

string

Tipo de recurso