Compartir a través de


Virtual Machine Scale Sets - Get OS Upgrade History

Obtiene la lista de actualizaciones del sistema operativo en una instancia de conjunto de escalado de máquinas virtuales.

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

VirtualMachineScaleSetListOSUpgradeHistory

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

VirtualMachineScaleSet_GetOSUpgradeHistory_MaximumSet_Gen
VirtualMachineScaleSet_GetOSUpgradeHistory_MinimumSet_Gen

VirtualMachineScaleSet_GetOSUpgradeHistory_MaximumSet_Gen

Solicitud de ejemplo

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

Respuesta de muestra

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

Solicitud de ejemplo

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

Respuesta de muestra

{
  "value": [
    {}
  ]
}

Definiciones

Nombre Description
ApiError

Error de api.

ApiErrorBase

Base de errores de api.

CloudError

Respuesta de error del servicio Compute.

ImageReference

Especifica información sobre la imagen que se va a usar. Puede especificar información sobre imágenes de plataforma, imágenes de Marketplace o imágenes de máquina virtual. Este elemento es necesario cuando desea usar una imagen de plataforma, una imagen de Marketplace o una imagen de máquina virtual, pero no se usa en otras operaciones de creación. NOTA: El publicador y la oferta de referencia de imágenes solo se pueden establecer al crear el conjunto de escalado.

InnerError

Detalles del error interno.

RollbackStatusInfo

Información sobre la reversión en instancias de máquina virtual con errores después de una operación de actualización del sistema operativo.

RollingUpgradeProgressInfo

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

UpgradeOperationHistoricalStatusInfo

Respuesta de la operación del historial de actualizaciones del sistema operativo del conjunto de escalado de máquinas virtuales.

UpgradeOperationHistoricalStatusInfoProperties

Describe cada actualización del sistema operativo en el conjunto de escalado de máquinas virtuales.

UpgradeOperationHistoryStatus

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

UpgradeOperationInvoker

Invocador de la operación de actualización

UpgradeState

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

VirtualMachineScaleSetListOSUpgradeHistory

Lista de respuesta de la operación del historial de actualizaciones del sistema operativo del conjunto de escalado de máquinas virtuales.

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.

ImageReference

Especifica información sobre la imagen que se va a usar. Puede especificar información sobre imágenes de plataforma, imágenes de Marketplace o imágenes de máquina virtual. Este elemento es necesario cuando desea usar una imagen de plataforma, una imagen de Marketplace o una imagen de máquina virtual, pero no se usa en otras operaciones de creación. NOTA: El publicador y la oferta de referencia de imágenes solo se pueden establecer al crear el conjunto de escalado.

Nombre Tipo Description
communityGalleryImageId

string

Se especificó el identificador único de la imagen de la galería de la comunidad para la implementación de máquinas virtuales. Esto se puede capturar desde la llamada GET de la imagen de la galería de la comunidad.

exactVersion

string

Especifica en números decimales, la versión de la imagen de plataforma o la imagen de Marketplace usada para crear la máquina virtual. Este campo de solo lectura difiere de "version", solo si el valor especificado en el campo "version" es "latest".

id

string

Id. de recurso

offer

string

Especifica la oferta de la imagen de plataforma o la imagen de Marketplace usada para crear la máquina virtual.

publisher

string

Publicador de imágenes.

sharedGalleryImageId

string

Se especificó el identificador único de la imagen de la galería compartida para la implementación de la máquina virtual. Esto se puede capturar desde la llamada GET de imagen de la galería compartida.

sku

string

SKU de imagen.

version

string

Especifica la versión de la imagen de plataforma o de la imagen de Marketplace que se usa para crear la máquina virtual. Los formatos permitidos son Major.Minor.Build o "latest". Major, Minor y Build son números decimales. Especifique "más reciente" para usar la versión más reciente de una imagen disponible en el momento de la implementación. Incluso si usa "latest", la imagen de máquina virtual no se actualizará automáticamente después de la hora de implementación incluso si hay disponible una nueva versión. No use el campo "version" para la implementación de imágenes de la galería, la imagen de la galería siempre debe usar el campo "id" para la implementación, para usar la versión "latest" de la imagen de la galería, simplemente establezca "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/gallerys/{galleryName}/{imageName}" en el campo "id" sin entrada de versión.

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.

RollbackStatusInfo

Información sobre la reversión en instancias de máquina virtual con errores después de una operación de actualización del sistema operativo.

Nombre Tipo Description
failedRolledbackInstanceCount

integer

Número de instancias que no se pudieron revertir.

rollbackError

ApiError

Detalles del error si se produjo un error en la reversión del sistema operativo.

successfullyRolledbackInstanceCount

integer

Número de instancias que se han revertido correctamente.

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.

UpgradeOperationHistoricalStatusInfo

Respuesta de la operación del historial de actualizaciones del sistema operativo del conjunto de escalado de máquinas virtuales.

Nombre Tipo Description
location

string

Ubicación de los recursos

properties

UpgradeOperationHistoricalStatusInfoProperties

Información sobre las propiedades de la operación de actualización.

type

string

Tipo de recurso

UpgradeOperationHistoricalStatusInfoProperties

Describe cada actualización del sistema operativo en el conjunto de escalado de máquinas virtuales.

Nombre Tipo Description
error

ApiError

Detalles del error de esta actualización si hay alguno.

progress

RollingUpgradeProgressInfo

Recuentos de las máquinas virtuales en cada estado.

rollbackInfo

RollbackStatusInfo

Información sobre la reversión del sistema operativo si se realiza

runningStatus

UpgradeOperationHistoryStatus

Información sobre el estado general de la operación de actualización.

startedBy

UpgradeOperationInvoker

Invocador de la operación de actualización

targetImageReference

ImageReference

Detalles de referencia de imagen

UpgradeOperationHistoryStatus

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

Nombre Tipo Description
code

UpgradeState

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

endTime

string

Hora de finalización de la actualización.

startTime

string

Hora de inicio de la actualización.

UpgradeOperationInvoker

Invocador de la operación de actualización

Nombre Tipo Description
Platform

string

Unknown

string

User

string

UpgradeState

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

Nombre Tipo Description
Cancelled

string

Completed

string

Faulted

string

RollingForward

string

VirtualMachineScaleSetListOSUpgradeHistory

Lista de respuesta de la operación del historial de actualizaciones del sistema operativo del conjunto de escalado de máquinas virtuales.

Nombre Tipo Description
nextLink

string

El URI para capturar la página siguiente del historial de actualizaciones del sistema operativo. Llame a ListNext() con esto para capturar la página siguiente del historial de actualizaciones.

value

UpgradeOperationHistoricalStatusInfo[]

Lista de actualizaciones del sistema operativo realizadas en el conjunto de escalado de máquinas virtuales.