REST Resource: projects.locations.privateClouds.upgrades

Ressource : Upgrade

Décrit la mise à niveau du cloud privé.

Représentation JSON 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "endTime": string,
  "state": enum (State),
  "type": enum (Type),
  "description": string,
  "estimatedDuration": string,
  "schedule": {
    object (Schedule)
  },
  "version": string,
  "etag": string,
  "uid": string,
  "componentUpgrades": [
    {
      object (VmwareUpgradeComponent)
    }
  ],
  "startVersion": string,
  "targetVersion": string
}
Champs
name

string

Uniquement en sortie. Identifiant. Nom de ressource du cloud privé Upgrade. Les noms de ressources sont des URI sans schéma qui suivent les conventions décrites sur https://cloud.google.com/apis/design/resource_names. Par exemple : projects/my-project/locations/us-west1-a/privateClouds/my-cloud/upgrades/my-upgrade.
createTime

string (Timestamp format)

Uniquement en sortie. Uniquement en sortie. Heure de création de cette ressource.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Uniquement en sortie. Uniquement en sortie. Heure de la dernière mise à jour de cette ressource.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Uniquement en sortie. Uniquement en sortie. Heure de fin de la mise à niveau.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
state

enum (State)

Uniquement en sortie. État actuel de la mise à niveau.
type

enum (Type)

Uniquement en sortie. Uniquement en sortie. Type de mise à niveau.
description

string

Uniquement en sortie. Uniquement en sortie. Description de la mise à niveau. Ces informations supplémentaires concernent la mise à niveau du cloud privé (objectif, modifications incluses, etc.).
estimatedDuration

string (Duration format)

Uniquement en sortie. Uniquement en sortie. Durée totale estimée de la mise à niveau. Ces informations peuvent être utilisées pour planifier ou programmer des mises à niveau afin de minimiser les perturbations. Veuillez noter que la durée estimée n'est qu'une estimation. La durée réelle de la mise à niveau peut varier.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"
schedule

object (Schedule)

Détails de la planification de la migration.
version

string

Uniquement en sortie.

etag

string

Etag de la ressource de mise à niveau. Si elle est fournie lors d'une mise à jour, elle doit correspondre à celle du serveur.
uid

string

Uniquement en sortie. Identifiant unique généré par le système pour la ressource.
componentUpgrades[]

object (VmwareUpgradeComponent)

Uniquement en sortie. Uniquement en sortie. Liste des mises à niveau de composants.
startVersion

string

Uniquement en sortie. Uniquement en sortie. Version de départ
targetVersion

string

Uniquement en sortie. Uniquement en sortie. Version cible

État

États possibles du cloud privé Upgrade.

Enums
STATE_UNSPECIFIED Valeur par défaut. Cette valeur ne doit jamais être utilisée.
SCHEDULED La migration est planifiée, mais n'a pas encore commencé.
ONGOING La mise à niveau est en cours et n'est pas encore terminée.
SUCCEEDED La migration a bien été effectuée.
PAUSED La mise à niveau est actuellement suspendue.
FAILED La mise à niveau a échoué.
CANCELLING La mise à niveau est en cours d'annulation.
CANCELLED La mise à niveau est annulée.
RESCHEDULING La migration est en cours de reprogrammation.

Type

Types de mise à niveau possibles. D'autres types pourront être ajoutés à l'avenir.

Enums
TYPE_UNSPECIFIED Valeur par défaut. Cette valeur ne doit jamais être utilisée.
VSPHERE_UPGRADE Mise à niveau des composants VMware lorsqu'une version majeure est disponible. 7.0u2 → 7.0u3.
VSPHERE_PATCH Application de correctifs aux composants VMware lorsqu'une version mineure est disponible. 7.0u2c → 7.0u2d.
WORKAROUND Les solutions de contournement sont des correctifs rapides pour les failles ou les problèmes. Elles sont appliquées pour atténuer les failles ou les problèmes connus jusqu'à ce qu'un correctif ou une mise à jour soit publié. La description de la mise à niveau vous fournira plus de détails.
FIRMWARE_UPGRADE Mise à niveau du micrologiciel pour le produit VMware utilisé dans le cloud privé.
SWITCH_UPGRADE Changer de mise à niveau.
OTHER Type de mise à niveau qui ne rentre dans aucune autre catégorie.
INFRASTRUCTURE_UPGRADE Mise à niveau de l'infrastructure lors de la maintenance des nœuds BM.

Planification

Planifiez la migration.

Représentation JSON 
{
  "startTime": string,
  "weeklyWindows": [
    {
      object (TimeWindow)
    }
  ],
  "constraints": {
    object (Constraints)
  },
  "editWindow": {
    object (Interval)
  },
  "lastEditor": enum (Editor)
}
Champs
startTime

string (Timestamp format)

Obligatoire. Date et heure de début planifiées pour la mise à niveau.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
weeklyWindows[]

object (TimeWindow)

Obligatoire. Fenêtres temporelles hebdomadaires pour les activités de migration. Le serveur effectue les activités de mise à niveau pendant ces périodes afin de minimiser les perturbations.
constraints

object (Constraints)

Uniquement en sortie. Uniquement en sortie. Contraintes appliquées à la programmation. Ces contraintes doivent être applicables au moment de la reprogrammation.
editWindow

object (Interval)

Uniquement en sortie. Uniquement en sortie. La programmation peut être modifiée pendant cet intervalle de temps ou cette période.
lastEditor

enum (Editor)

Uniquement en sortie. Uniquement en sortie. Indique qui a modifié le calendrier de mise à niveau le plus récemment. La valeur est mise à jour chaque fois que la migration est reportée.

TimeWindow

Représente la période pendant laquelle effectuer les activités de mise à niveau.

Représentation JSON 
{
  "dayOfWeek": enum (DayOfWeek),
  "startTime": {
    object (TimeOfDay)
  },
  "duration": string
}
Champs
dayOfWeek

enum (DayOfWeek)

Obligatoire. Jour de la semaine pour cette période.
startTime

object (TimeOfDay)

Obligatoire. Heure de début de la période au format UTC.
duration

string (Duration format)

Obligatoire. Durée de la fenêtre. La durée maximale autorisée pour une fenêtre est de 24 heures.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

DayOfWeek

Représente un jour de la semaine.

Enums
DAY_OF_WEEK_UNSPECIFIED Le jour de la semaine n'est pas spécifié.
MONDAY Lundi
TUESDAY Mardi
WEDNESDAY Mercredi
THURSDAY Jeudi
FRIDAY Vendredi
SATURDAY Samedi
SUNDAY Dimanche

TimeOfDay

Représente une heure de la journée. La date et le fuseau horaire sont spécifiés ailleurs, ou ne sont pas significatifs. Une API peut choisir d'autoriser des secondes intercalaires. Les types associés sont google.type.Date et google.protobuf.Timestamp.

Représentation JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Champs
hours

integer

Heures de la journée au format 24 heures. Doit être supérieur ou égal à 0 et généralement inférieur ou égal à 23. Une API peut choisir d'autoriser la valeur "24:00:00" pour des cas tels que l'heure de fermeture des bureaux.
minutes

integer

Minutes d'une heure. Doit être supérieur ou égal à 0 et inférieur ou égal à 59.
seconds

integer

Secondes d'une minute. Doit être supérieur ou égal à 0 et généralement inférieur ou égal à 59. Une API peut autoriser la valeur 60 si elle autorise les secondes intercalaires.
nanos

integer

Fractions de secondes, en nanosecondes. La valeur doit être supérieure ou égale à 0 et inférieure ou égale à 999 999 999.

Contraintes

Contraintes à appliquer lors de la modification d'une planification. Ces contraintes permettent de s'assurer que les exigences spécifiques de Upgrade sont respectées.

Représentation JSON 
{
  "minHoursDay": integer,
  "minHoursWeek": integer,
  "rescheduleDateRange": {
    object (Interval)
  },
  "disallowedIntervals": [
    {
      object (WeeklyTimeInterval)
    }
  ]
}
Champs
minHoursDay

integer

Uniquement en sortie. Un nombre minimal d'heures doit être alloué aux activités de mise à niveau pour chaque jour sélectionné. Il s'agit d'un minimum. Le calendrier de migration peut prévoir plus d'heures pour le jour donné.
minHoursWeek

integer

Uniquement en sortie. Le nombre minimal d'heures hebdomadaires doit être alloué aux activités de mise à niveau. Il s'agit d'un minimum. Le planning peut attribuer plus d'heures par semaine.
rescheduleDateRange

object (Interval)

Uniquement en sortie. Uniquement en sortie. L'utilisateur ne peut reporter une mise à niveau que si elle commence dans cette plage.
disallowedIntervals[]

object (WeeklyTimeInterval)

Uniquement en sortie. Uniquement en sortie. Liste des intervalles pendant lesquels les intervalles de maintenance ne sont pas autorisés. Toute période qui chevauche l'un de ces intervalles sera considérée comme non valide.

Intervalle

Représente un intervalle de temps, encodé sous la forme d'un code temporel de début (inclusif) et d'un code temporel de fin (exclusif).

La valeur de début doit être inférieure ou égale à celle de fin. Lorsque la valeur de début est la même que la valeur de fin, l'intervalle est vide (il ne correspond à aucune durée). Lorsque les heures de début et de fin ne sont pas spécifiées, l'intervalle couvre toutes les heures.

Représentation JSON 
{
  "startTime": string,
  "endTime": string
}
Champs
startTime

string (Timestamp format)

Facultatif. Valeur de début (inclusive) de l'intervalle.

Si elle est spécifiée, un code temporel correspondant à cet intervalle devra être égal ou postérieur à l'heure de début.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Facultatif. Valeur de fin (exclusive) de l'intervalle.

Si elle est spécifiée, un code temporel correspondant à cet intervalle devra être antérieur à l'heure de fin.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

WeeklyTimeInterval

Représente un intervalle de temps, couvrant plusieurs jours de la semaine. Tant que les fuseaux horaires locaux ne seront pas pris en charge, cet intervalle sera exprimé en UTC.

Représentation JSON 
{
  "startDay": enum (DayOfWeek),
  "startTime": {
    object (TimeOfDay)
  },
  "endDay": enum (DayOfWeek),
  "endTime": {
    object (TimeOfDay)
  }
}
Champs
startDay

enum (DayOfWeek)

Uniquement en sortie. Jour de début de l'intervalle.
startTime

object (TimeOfDay)

Uniquement en sortie. Heure de début de l'intervalle le jour de début.
endDay

enum (DayOfWeek)

Uniquement en sortie. Jour de fin de l'intervalle. Elle peut être identique au jour de début.
endTime

object (TimeOfDay)

Uniquement en sortie. Heure de fin de l'intervalle le dernier jour.

Éditeur

Valeurs possibles pour "Qui a modifié le calendrier de migration" : la valeur identifie des groupes ou des entités plutôt que des personnes.

Enums
EDITOR_UNSPECIFIED Valeur par défaut. Cette valeur ne doit jamais être utilisée.
SYSTEM La mise à niveau est planifiée par le système ou un service interne.
USER La mise à niveau est planifiée par l'utilisateur final.

VmwareUpgradeComponent

Ressource de mise à niveau par composant

Représentation JSON 
{
  "componentType": enum (VmwareComponentType),
  "state": enum (State)
}
Champs
componentType

enum (VmwareComponentType)

Uniquement en sortie. Type de composant
state

enum (State)

Uniquement en sortie. État de mise à niveau du composant.

VmwareComponentType

Type de composant VMware

Enums
VMWARE_COMPONENT_TYPE_UNSPECIFIED Valeur par défaut. Cette valeur ne doit jamais être utilisée.
VCENTER vcenter
ESXI Nœuds ESXi + nœuds de transport
NSXT_UC Coordinateur de mise à niveau NSX-T
NSXT_EDGE Cluster de périphéries NSX-T
NSXT_MGR Gestionnaires/plan de gestion NSXT
HCX hcx
VSAN Cluster VSAN
DVS Contacteur DVS
NAMESERVER_VM VM de serveur de noms
KMS_VM VM KMS utilisée pour le chiffrement vSAN
WITNESS_VM VM témoin en cas de PC étendu
NSXT nsxt
CLUSTER Le clustering est utilisé en cas de requête large.
VM_TOOLS VMware Tools

État

L'état définit l'état actuel d'une mise à niveau.

Enums
STATE_UNSPECIFIED Valeur par défaut. Cette valeur ne doit jamais être utilisée.
RUNNING La mise à niveau du composant est en cours
PAUSED La mise à niveau du composant est suspendue. Reprendront lorsque le job de mise à niveau reprendra
SUCCEEDED La mise à niveau du composant a bien été effectuée.
FAILED La mise à niveau du composant a échoué. Cette option passera à "Reprendre" si la mise à niveau est reprise ou restera telle quelle.
NOT_STARTED La mise à niveau du composant n'a pas encore commencé
NOT_APPLICABLE La mise à niveau des composants n'est pas applicable dans cette mise à niveau. Il sera ignoré.

Méthodes

get

 Récupère une ressource Upgrade de cloud privé par son nom de ressource.

list

 Liste les Upgrades passées, en cours et à venir pour le cloud privé donné.

patch

 Mettez à jour la ressource Upgrade du cloud privé.