Compartir a través de


Virtual Machine Scale Set Rolling Upgrades - Get Latest

Obtiene el estado de la actualización gradual del conjunto de escalado de máquinas virtuales más reciente.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
resourceGroupName
path True

string

Nombre del grupo de recursos.

subscriptionId
path True

string

Credenciales de suscripción que identifican de forma única la suscripción de Microsoft Azure. El identificador de suscripción forma parte del URI de cada llamada de servicio.

vmScaleSetName
path True

string

Nombre del conjunto de escalado de máquinas virtuales.

api-version
query True

string

Versión de api de cliente.

Respuestas

Nombre Tipo Description
200 OK

RollingUpgradeStatusInfo

De acuerdo

Other Status Codes

CloudError

Respuesta de error que describe por qué se produjo un error en la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantar la cuenta de usuario

Ejemplos

VirtualMachineScaleSetRollingUpgrade_GetLatest_MaximumSet_Gen
VirtualMachineScaleSetRollingUpgrade_GetLatest_MinimumSet_Gen

VirtualMachineScaleSetRollingUpgrade_GetLatest_MaximumSet_Gen

Solicitud de ejemplo

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

Respuesta de muestra

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

Solicitud de ejemplo

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

Respuesta de muestra

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

Definiciones

Nombre Description
ApiError

Error de API.

ApiErrorBase

Base de errores de api.

CloudError

Respuesta de error del servicio Compute.

InnerError

Detalles del error interno.

RollingUpgradeActionType

La última acción realizada en la actualización gradual.

RollingUpgradePolicy

Los parámetros de configuración usados al realizar una actualización gradual.

RollingUpgradeProgressInfo

Información sobre el número de instancias de máquina virtual en cada estado de actualización.

RollingUpgradeRunningStatus

Información sobre el estado de ejecución actual de la actualización general.

RollingUpgradeStatusCode

Código que indica el estado actual de la actualización.

RollingUpgradeStatusInfo

Estado de la actualización gradual del conjunto de escalado de máquinas virtuales más reciente.

ApiError

Error de API.

Nombre Tipo Description
code

string

Código de error.

details

ApiErrorBase[]

Detalles del error de api

innererror

InnerError

Error interno de api

message

string

Mensaje de error.

target

string

Destino del error concreto.

ApiErrorBase

Base de errores de api.

Nombre Tipo Description
code

string

Código de error.

message

string

Mensaje de error.

target

string

Destino del error concreto.

CloudError

Respuesta de error del servicio Compute.

Nombre Tipo Description
error

ApiError

Error de API.

InnerError

Detalles del error interno.

Nombre Tipo Description
errordetail

string

Mensaje de error interno o volcado de memoria de excepciones.

exceptiontype

string

Tipo de excepción.

RollingUpgradeActionType

La última acción realizada en la actualización gradual.

Nombre Tipo Description
Cancel

string

Start

string

RollingUpgradePolicy

Los parámetros de configuración usados al realizar una actualización gradual.

Nombre Tipo Description
enableCrossZoneUpgrade

boolean

Permitir que VMSS omita los límites de AZ al construir lotes de actualización. Tenga en cuenta el dominio de actualización y maxBatchInstancePercent para determinar el tamaño del lote.

maxBatchInstancePercent

integer

Porcentaje máximo de instancias de máquina virtual totales que se actualizarán simultáneamente mediante la actualización gradual en un lote. Dado que se trata de un número máximo de instancias incorrectas en lotes anteriores o futuros, puede provocar que el porcentaje de instancias de un lote disminuya para garantizar una mayor confiabilidad. El valor predeterminado de este parámetro es 20%.

maxSurge

boolean

Cree nuevas máquinas virtuales para actualizar el conjunto de escalado, en lugar de actualizar las máquinas virtuales existentes. Las máquinas virtuales existentes se eliminarán una vez creadas las nuevas máquinas virtuales para cada lote.

maxUnhealthyInstancePercent

integer

El porcentaje máximo de las instancias de máquina virtual totales del conjunto de escalado que pueden estar en mal estado simultáneamente, ya sea como resultado de la actualización o si se encuentra en un estado incorrecto por parte de las comprobaciones de estado de la máquina virtual antes de que se anule la actualización gradual. Esta restricción se comprobará antes de iniciar cualquier lote. El valor predeterminado de este parámetro es 20%.

maxUnhealthyUpgradedInstancePercent

integer

Porcentaje máximo de instancias de máquina virtual actualizadas que se pueden encontrar en un estado incorrecto. Esta comprobación se realizará después de actualizar cada lote. Si se supera este porcentaje alguna vez, se anula la actualización gradual. El valor predeterminado de este parámetro es 20%.

pauseTimeBetweenBatches

string

Tiempo de espera entre completar la actualización de todas las máquinas virtuales de un lote e iniciar el siguiente lote. La duración del tiempo debe especificarse en formato ISO 8601. El valor predeterminado es 0 segundos (PT0S).

prioritizeUnhealthyInstances

boolean

Actualice todas las instancias incorrectas de un conjunto de escalado antes de cualquier instancia correcta.

rollbackFailedInstancesOnPolicyBreach

boolean

Las instancias con error de reversión en el modelo anterior si se infringe la directiva de actualización gradual.

RollingUpgradeProgressInfo

Información sobre el número de instancias de máquina virtual en cada estado de actualización.

Nombre Tipo Description
failedInstanceCount

integer

Número de instancias que no se pudieron actualizar correctamente.

inProgressInstanceCount

integer

Número de instancias que se están actualizando actualmente.

pendingInstanceCount

integer

Número de instancias que aún no se han empezado a actualizar.

successfulInstanceCount

integer

Número de instancias que se han actualizado correctamente.

RollingUpgradeRunningStatus

Información sobre el estado de ejecución actual de la actualización general.

Nombre Tipo Description
code

RollingUpgradeStatusCode

Código que indica el estado actual de la actualización.

lastAction

RollingUpgradeActionType

La última acción realizada en la actualización gradual.

lastActionTime

string

Hora de la última acción de la actualización.

startTime

string

Hora de inicio de la actualización.

RollingUpgradeStatusCode

Código que indica el estado actual de la actualización.

Nombre Tipo Description
Cancelled

string

Completed

string

Faulted

string

RollingForward

string

RollingUpgradeStatusInfo

Estado de la actualización gradual del conjunto de escalado de máquinas virtuales más reciente.

Nombre Tipo Description
id

string

Identificador de recurso

location

string

Ubicación del recurso

name

string

Nombre del recurso

properties.error

ApiError

Detalles del error para esta actualización, si hay alguno.

properties.policy

RollingUpgradePolicy

Las directivas de actualización gradual aplicadas para esta actualización.

properties.progress

RollingUpgradeProgressInfo

Información sobre el número de instancias de máquina virtual en cada estado de actualización.

properties.runningStatus

RollingUpgradeRunningStatus

Información sobre el estado de ejecución actual de la actualización general.

tags

object

Etiquetas de recursos

type

string

Tipo de recurso