Partilhar via


Virtual Machine Scale Set Rolling Upgrades - Get Latest

Obtém o status da atualização contínua mais recente do conjunto de escala de máquina virtual.

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

RollingUpgradeStatusInfo

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

VirtualMachineScaleSetRollingUpgrade_GetLatest_MaximumSet_Gen
VirtualMachineScaleSetRollingUpgrade_GetLatest_MinimumSet_Gen

VirtualMachineScaleSetRollingUpgrade_GetLatest_MaximumSet_Gen

Pedido de amostra

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

Resposta da amostra

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

Pedido de amostra

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

Resposta da amostra

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

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.

InnerError

Detalhes do erro interno.

RollingUpgradeActionType

A última ação executada na atualização contínua.

RollingUpgradePolicy

Os parâmetros de configuração usados durante a execução de uma atualização contínua.

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 atual de execução da atualização geral.

RollingUpgradeStatusCode

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

RollingUpgradeStatusInfo

O status da atualização contínua mais recente do conjunto de dimensionamento de máquina virtual.

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.

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.

RollingUpgradeActionType

A última ação executada na atualização contínua.

Name Tipo Description
Cancel

string

Start

string

RollingUpgradePolicy

Os parâmetros de configuração usados durante a execução de uma atualização contínua.

Name Tipo Description
enableCrossZoneUpgrade

boolean

Permita que o VMSS ignore os limites 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 é máximo, instâncias não íntegras em lotes anteriores ou futuros podem fazer com que a porcentagem 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 escala, em vez de atualizar as máquinas virtuais existentes. As máquinas virtuais existentes serão excluídas assim que as novas máquinas virtuais forem criadas para cada lote.

maxUnhealthyInstancePercent

integer

A porcentagem máxima do total de instâncias de máquina virtual no conjunto de escala que pode estar simultaneamente não íntegra, seja como resultado de ser atualizada ou por ser encontrada em um estado não íntegro pelas verificações de integridade da máquina virtual antes que a atualização contínua seja abortada. Esta restrição será verificada antes de iniciar qualquer lote. O valor padrão para esse parâmetro é 20%.

maxUnhealthyUpgradedInstancePercent

integer

A porcentagem máxima de instâncias de máquina virtual atualizadas que podem ser encontradas em um estado não íntegro. Essa verificação acontecerá depois que cada lote for atualizado. Se essa porcentagem for excedida, a atualização contínua será anulada. O valor padrão para esse parâmetro é 20%.

pauseTimeBetweenBatches

string

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

prioritizeUnhealthyInstances

boolean

Atualize todas as instâncias não íntegras em um conjunto de escala antes de quaisquer instâncias íntegras.

rollbackFailedInstancesOnPolicyBreach

boolean

Reversão de instâncias com falha para o modelo anterior se a política de Atualização Contínua for violada.

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.

RollingUpgradeRunningStatus

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

Name Tipo Description
code

RollingUpgradeStatusCode

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

lastAction

RollingUpgradeActionType

A última ação executada na atualização contínua.

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.

Name Tipo Description
Cancelled

string

Completed

string

Faulted

string

RollingForward

string

RollingUpgradeStatusInfo

O status da atualização contínua mais recente do conjunto de dimensionamento de máquina virtual.

Name Tipo Description
id

string

ID do recurso

location

string

Localização do recurso

name

string

Nome do recurso

properties.error

ApiError

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

properties.policy

RollingUpgradePolicy

As políticas de atualização contínua 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 atual de execução da atualização geral.

tags

object

Tags de recursos

type

string

Tipo de recurso