Partager via


Virtual Machine Scale Set Rolling Upgrades - Get Latest

Obtient l’état de la dernière mise à niveau propagée du groupe de machines virtuelles identiques.

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

RollingUpgradeStatusInfo

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

VirtualMachineScaleSetRollingUpgrade_GetLatest_MaximumSet_Gen
VirtualMachineScaleSetRollingUpgrade_GetLatest_MinimumSet_Gen

VirtualMachineScaleSetRollingUpgrade_GetLatest_MaximumSet_Gen

Exemple de requête

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

Exemple de réponse

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

Exemple de requête

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

Exemple de réponse

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

Définitions

Nom Description
ApiError

Erreur d’API.

ApiErrorBase

Base d’erreurs d’API.

CloudError

Réponse d’erreur du service de calcul.

InnerError

Détails de l’erreur interne.

RollingUpgradeActionType

Dernière action effectuée sur la mise à niveau propagée.

RollingUpgradePolicy

Paramètres de configuration utilisés lors de l’exécution d’une mise à niveau propagée.

RollingUpgradeProgressInfo

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

RollingUpgradeRunningStatus

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

RollingUpgradeStatusCode

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

RollingUpgradeStatusInfo

État de la dernière mise à niveau propagée 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.

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.

RollingUpgradeActionType

Dernière action effectuée sur la mise à niveau propagée.

Valeur Description
Cancel
Start

RollingUpgradePolicy

Paramètres de configuration utilisés lors de l’exécution d’une mise à niveau propagée.

Nom Type Description
enableCrossZoneUpgrade

boolean

Autorisez VMSS à ignorer les limites AZ lors de la construction de lots de mise à niveau. Prenez en compte le domaine de mise à jour et maxBatchInstancePercent pour déterminer la taille du lot.

maxBatchInstancePercent

integer

Pourcentage maximal d’instances de machines virtuelles totales qui seront mises à niveau simultanément par la mise à niveau propagée dans un lot. Comme il s’agit d’un nombre maximal d’instances non saines dans les lots précédents ou futurs, le pourcentage d’instances d’un lot peut diminuer pour garantir une fiabilité plus élevée. La valeur par défaut de ce paramètre est 20%.

maxSurge

boolean

Créez de nouvelles machines virtuelles pour mettre à niveau le groupe identique, au lieu de mettre à jour les machines virtuelles existantes. Les machines virtuelles existantes seront supprimées une fois les nouvelles machines virtuelles créées pour chaque lot.

maxUnhealthyInstancePercent

integer

Pourcentage maximal des instances de machine virtuelle totales dans le groupe identique qui peuvent être simultanément non saines, soit en raison d’une mise à niveau, soit en étant trouvées dans un état non sain par les vérifications d’intégrité de la machine virtuelle avant l’abandon de la mise à niveau propagée. Cette contrainte sera vérifiée avant de démarrer un lot. La valeur par défaut de ce paramètre est 20%.

maxUnhealthyUpgradedInstancePercent

integer

Pourcentage maximal d’instances de machine virtuelle mises à niveau qui peuvent être trouvées dans un état non sain. Cette vérification se produit après la mise à niveau de chaque lot. Si ce pourcentage est jamais dépassé, la mise à jour propagée abandonne. La valeur par défaut de ce paramètre est 20%.

pauseTimeBetweenBatches

string

Délai d’attente entre la fin de la mise à jour pour toutes les machines virtuelles d’un lot et le démarrage du lot suivant. La durée doit être spécifiée au format ISO 8601. La valeur par défaut est de 0 secondes (PT0S).

prioritizeUnhealthyInstances

boolean

Mettez à niveau toutes les instances non saines dans un groupe identique avant toutes les instances saines.

rollbackFailedInstancesOnPolicyBreach

boolean

Échec de restauration des instances dans le modèle précédent si la stratégie de mise à niveau propagée est enfreinte.

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.

RollingUpgradeRunningStatus

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

Nom Type Description
code

RollingUpgradeStatusCode

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

lastAction

RollingUpgradeActionType

Dernière action effectuée sur la mise à niveau propagée.

lastActionTime

string

Heure de la dernière action de la mise à niveau.

startTime

string

Heure de début de la mise à niveau.

RollingUpgradeStatusCode

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

Valeur Description
Cancelled
Completed
Faulted
RollingForward

RollingUpgradeStatusInfo

État de la dernière mise à niveau propagée du groupe de machines virtuelles identiques.

Nom Type Description
id

string

ID de ressource

location

string

Emplacement des ressources

name

string

Nom de la ressource

properties.error

ApiError

Détails de l’erreur pour cette mise à niveau, le cas échéant.

properties.policy

RollingUpgradePolicy

Stratégies de mise à niveau propagées appliquées pour cette mise à niveau.

properties.progress

RollingUpgradeProgressInfo

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

properties.runningStatus

RollingUpgradeRunningStatus

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

tags

object

Balises de ressource

type

string

Type de ressource