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 |
---|---|---|---|---|
resource
|
path | True |
string |
Nombre del grupo de recursos. |
subscription
|
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. |
vm
|
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 |
Aceptar |
|
Other Status Codes |
Respuesta de error que describe el motivo del error de la operación. |
Seguridad
azure_auth
Flujo OAuth2 de Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nombre | Description |
---|---|
user_impersonation | suplantación de su cuenta de usuario |
Ejemplos
Virtual |
Virtual |
VirtualMachineScaleSet_GetOSUpgradeHistory_MaximumSet_Gen
Sample Request
GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaa/osUpgradeHistory?api-version=2024-03-01
Sample Response
{
"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
Sample Request
GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaaaaaaaaaa/osUpgradeHistory?api-version=2024-03-01
Sample Response
{
"value": [
{}
]
}
Definiciones
Nombre | Description |
---|---|
Api |
Error de api. |
Api |
Base de errores de api. |
Cloud |
Respuesta de error del servicio Compute. |
Image |
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. |
Inner |
Detalles del error interno. |
Rollback |
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. |
Rolling |
Información sobre el número de instancias de máquina virtual en cada estado de actualización. |
Upgrade |
Respuesta de la operación del historial de actualizaciones del sistema operativo del conjunto de escalado de máquinas virtuales. |
Upgrade |
Describe cada actualización del sistema operativo en el conjunto de escalado de máquinas virtuales. |
Upgrade |
Información sobre el estado actual de ejecución de la actualización general. |
Upgrade |
Invocador de la operación de actualización |
Upgrade |
Código que indica el estado actual de la actualización. |
Virtual |
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 |
Detalles del error de api |
|
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 |
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 |
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 |
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 |
Detalles del error de esta actualización si hay alguno. |
|
progress |
Recuentos de las máquinas virtuales en cada estado. |
|
rollbackInfo |
Información sobre la reversión del sistema operativo si se realiza |
|
runningStatus |
Información sobre el estado general de la operación de actualización. |
|
startedBy |
Invocador de la operación de actualización |
|
targetImageReference |
Detalles de referencia de imagen |
UpgradeOperationHistoryStatus
Información sobre el estado actual de ejecución de la actualización general.
Nombre | Tipo | Description |
---|---|---|
code |
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 |
Lista de actualizaciones del sistema operativo realizadas en el conjunto de escalado de máquinas virtuales. |