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 para cada llamada al 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

Aceptar

Other Status Codes

CloudError

Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo 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 suplantación de su 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 actual de ejecución 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

El mensaje de error.

target

string

Destino del error determinado.

ApiErrorBase

Base de errores de api.

Nombre Tipo Description
code

string

Código de error.

message

string

El mensaje de error.

target

string

Destino del error determinado.

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 la 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 máximo, las instancias incorrectas en lotes anteriores o futuros pueden 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

Porcentaje máximo de las instancias de máquina virtual totales en el 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 este porcentaje se supera 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 las instancias correctas.

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 han empezado a actualizarse.

successfulInstanceCount

integer

Número de instancias que se han actualizado correctamente.

RollingUpgradeRunningStatus

Información sobre el estado actual de ejecución 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

Id. de recurso

location

string

Ubicación de los recursos

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 actual de ejecución de la actualización general.

tags

object

Etiquetas del recurso

type

string

Tipo de recurso