Partager via


Virtual Machine Scale Sets - Get OS Upgrade History

Obtient la liste des mises à niveau du système d’exploitation sur une instance de groupe identique de machines virtuelles.

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

Paramètres URI

Nom Dans Obligatoire Type Description
resourceGroupName
path True

string

Nom du groupe de ressources.

subscriptionId
path True

string

Informations d’identification d’abonnement qui identifient de manière unique l’abonnement Microsoft Azure. L’ID d’abonnement fait partie de l’URI de chaque appel de service.

vmScaleSetName
path True

string

Nom du groupe de machines virtuelles identiques.

api-version
query True

string

Version de l’API cliente.

Réponses

Nom Type Description
200 OK

VirtualMachineScaleSetListOSUpgradeHistory

D’ACCORD

Other Status Codes

CloudError

Réponse d’erreur décrivant pourquoi l’opération a échoué.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation emprunter l’identité de votre compte d’utilisateur

Exemples

VirtualMachineScaleSet_GetOSUpgradeHistory_MaximumSet_Gen
VirtualMachineScaleSet_GetOSUpgradeHistory_MinimumSet_Gen

VirtualMachineScaleSet_GetOSUpgradeHistory_MaximumSet_Gen

Exemple de requête

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

Exemple de réponse

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

Exemple de requête

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

Exemple de réponse

{
  "value": [
    {}
  ]
}

Définitions

Nom Description
ApiError

Erreur d’API.

ApiErrorBase

Base d’erreurs d’API.

CloudError

Réponse d’erreur du service de calcul.

ImageReference

Spécifie des informations sur l’image à utiliser. Vous pouvez spécifier des informations sur les images de plateforme, les images de la Place de marché ou les images de machine virtuelle. Cet élément est requis lorsque vous souhaitez utiliser une image de plateforme, une image de la Place de marché ou une image de machine virtuelle, mais n’est pas utilisé dans d’autres opérations de création. REMARQUE : l’éditeur et l’offre de référence d’image ne peuvent être définis que lorsque vous créez le groupe identique.

InnerError

Détails de l’erreur interne.

RollbackStatusInfo

Informations sur la restauration sur les instances de machine virtuelle ayant échoué après une opération de mise à niveau du système d’exploitation.

RollingUpgradeProgressInfo

Informations sur le nombre d’instances de machine virtuelle dans chaque état de mise à niveau.

UpgradeOperationHistoricalStatusInfo

Réponse de l’opération d’historique de mise à niveau du système d’exploitation du groupe de machines virtuelles identiques.

UpgradeOperationHistoricalStatusInfoProperties

Décrit chaque mise à niveau du système d’exploitation sur le groupe de machines virtuelles identiques.

UpgradeOperationHistoryStatus

Informations sur l’état d’exécution actuel de la mise à niveau globale.

UpgradeOperationInvoker

Appelant de l’opération de mise à niveau

UpgradeState

Code indiquant l’état actuel de la mise à niveau.

VirtualMachineScaleSetListOSUpgradeHistory

Liste de la réponse de l’opération d’historique de mise à niveau du système d’exploitation du groupe de machines virtuelles identiques.

ApiError

Erreur d’API.

Nom Type Description
code

string

Code d’erreur.

details

ApiErrorBase[]

Détails de l’erreur api

innererror

InnerError

Erreur interne de l’API

message

string

Message d’erreur.

target

string

Cible de l’erreur particulière.

ApiErrorBase

Base d’erreurs d’API.

Nom Type Description
code

string

Code d’erreur.

message

string

Message d’erreur.

target

string

Cible de l’erreur particulière.

CloudError

Réponse d’erreur du service de calcul.

Nom Type Description
error

ApiError

Erreur d’API.

ImageReference

Spécifie des informations sur l’image à utiliser. Vous pouvez spécifier des informations sur les images de plateforme, les images de la Place de marché ou les images de machine virtuelle. Cet élément est requis lorsque vous souhaitez utiliser une image de plateforme, une image de la Place de marché ou une image de machine virtuelle, mais n’est pas utilisé dans d’autres opérations de création. REMARQUE : l’éditeur et l’offre de référence d’image ne peuvent être définis que lorsque vous créez le groupe identique.

Nom Type Description
communityGalleryImageId

string

Spécifie l’ID unique de l’image de la galerie de communautés pour le déploiement de machines virtuelles. Cette opération peut être extraite de l’appel GET de la galerie de la communauté.

exactVersion

string

Spécifie en nombres décimaux, la version de l’image de plateforme ou de la place de marché utilisée pour créer la machine virtuelle. Ce champ en lecture seule diffère de « version », uniquement si la valeur spécifiée dans le champ « version » est « latest ».

id

string

ID de ressource

offer

string

Spécifie l’offre de l’image de plateforme ou de la place de marché utilisée pour créer la machine virtuelle.

publisher

string

Éditeur d’images.

sharedGalleryImageId

string

Spécifie l’ID unique de l’image de galerie partagée pour le déploiement de machines virtuelles. Cette opération peut être extraite de l’appel GET de l’image de galerie partagée.

sku

string

Référence SKU d’image.

version

string

Spécifie la version de l’image de plateforme ou de la place de marché utilisée pour créer la machine virtuelle. Les formats autorisés sont Major.Minor.Build ou « latest ». Les nombres principaux, mineurs et build sont des nombres décimaux. Spécifiez « latest » pour utiliser la dernière version d’une image disponible au moment du déploiement. Même si vous utilisez la « dernière version », l’image de machine virtuelle ne sera pas automatiquement mise à jour après le déploiement même si une nouvelle version devient disponible. N’utilisez pas le champ « version » pour le déploiement d’images de galerie, l’image de la galerie doit toujours utiliser le champ « ID » pour le déploiement, pour utiliser la version la plus récente de l’image de la galerie, il vous suffit de définir « /subscriptions/{subscriptionId}/resourceGroupName}/{resourceGroupName}/providers/Microsoft.Compute/galleryName}/images/{imageName} » dans le champ « id » sans entrée de version.

InnerError

Détails de l’erreur interne.

Nom Type Description
errordetail

string

Message d’erreur interne ou vidage d’exception.

exceptiontype

string

Type d’exception.

RollbackStatusInfo

Informations sur la restauration sur les instances de machine virtuelle ayant échoué après une opération de mise à niveau du système d’exploitation.

Nom Type Description
failedRolledbackInstanceCount

integer

Nombre d’instances qui n’ont pas pu être restauration.

rollbackError

ApiError

Détails de l’erreur si la restauration du système d’exploitation a échoué.

successfullyRolledbackInstanceCount

integer

Nombre d’instances qui ont été restaurées avec succès.

RollingUpgradeProgressInfo

Informations sur le nombre d’instances de machine virtuelle dans chaque état de mise à niveau.

Nom Type Description
failedInstanceCount

integer

Nombre d’instances qui n’ont pas pu être mises à niveau correctement.

inProgressInstanceCount

integer

Nombre d’instances en cours de mise à niveau.

pendingInstanceCount

integer

Nombre d’instances qui n’ont pas encore commencé à être mises à niveau.

successfulInstanceCount

integer

Nombre d’instances qui ont été correctement mises à niveau.

UpgradeOperationHistoricalStatusInfo

Réponse de l’opération d’historique de mise à niveau du système d’exploitation du groupe de machines virtuelles identiques.

Nom Type Description
location

string

Emplacement des ressources

properties

UpgradeOperationHistoricalStatusInfoProperties

Informations sur les propriétés de l’opération de mise à niveau.

type

string

Type de ressource

UpgradeOperationHistoricalStatusInfoProperties

Décrit chaque mise à niveau du système d’exploitation sur le groupe de machines virtuelles identiques.

Nom Type Description
error

ApiError

Détails de l’erreur pour cette mise à niveau s’il y en a un.

progress

RollingUpgradeProgressInfo

Nombre de machines virtuelles dans chaque état.

rollbackInfo

RollbackStatusInfo

Informations sur la restauration du système d’exploitation en cas d’exécution

runningStatus

UpgradeOperationHistoryStatus

Informations sur l’état global de l’opération de mise à niveau.

startedBy

UpgradeOperationInvoker

Appelant de l’opération de mise à niveau

targetImageReference

ImageReference

Informations de référence sur l’image

UpgradeOperationHistoryStatus

Informations sur l’état d’exécution actuel de la mise à niveau globale.

Nom Type Description
code

UpgradeState

Code indiquant l’état actuel de la mise à niveau.

endTime

string

Heure de fin de la mise à niveau.

startTime

string

Heure de début de la mise à niveau.

UpgradeOperationInvoker

Appelant de l’opération de mise à niveau

Nom Type Description
Platform

string

Unknown

string

User

string

UpgradeState

Code indiquant l’état actuel de la mise à niveau.

Nom Type Description
Cancelled

string

Completed

string

Faulted

string

RollingForward

string

VirtualMachineScaleSetListOSUpgradeHistory

Liste de la réponse de l’opération d’historique de mise à niveau du système d’exploitation du groupe de machines virtuelles identiques.

Nom Type Description
nextLink

string

URI permettant d’extraire la page suivante de l’historique de mise à niveau du système d’exploitation. Appelez ListNext() avec ceci pour extraire la page suivante de l’historique des mises à niveau.

value

UpgradeOperationHistoricalStatusInfo[]

Liste des mises à niveau du système d’exploitation effectuées sur le groupe de machines virtuelles identiques.