Ressource REST : projects.patchDeployments

Ressource : PatchDeployment

Les déploiements de correctifs sont des configurations que les tâches d'application de correctifs individuelles utilisent pour effectuer un correctif. Ces configurations incluent un filtre d'instance, des paramètres de dépôt de packages et un planning.

Représentation JSON

{
      "name": string,
      "description": string,
      "instanceFilter": {
        object (PatchInstanceFilter)
      },
      "patchConfig": {
        object (PatchConfig)
      },
      "duration": string,
      "createTime": string,
      "updateTime": string,
      "lastExecuteTime": string,

      // Union field schedule can be only one of the following:
      "oneTimeSchedule": {
        object (OneTimeSchedule)
      },
      "recurringSchedule": {
        object (RecurringSchedule)
      }
      // End of list of possible types for union field schedule.
    }
Champs
name

string

Nom unique de la ressource de déploiement de correctifs dans un projet. Le nom du déploiement des correctifs se présente au format suivant : projects/{project_id}/patchDeployments/{patchDeploymentId}. Ce champ est ignoré lorsque vous créez un déploiement de correctifs.

description

string

Facultatif. Description du déploiement des correctifs. La longueur de la description est limitée à 1 024 caractères.

instanceFilter

PatchInstanceFilterobject ()

Obligatoire. Instances de VM à corriger.

patchConfig

PatchConfigobject ()

Facultatif. Configuration du correctif appliquée.

duration

Durationstring ( format)

Facultatif. Durée du correctif. Une fois la durée écoulée, le correctif expire.

Durée en secondes avec neuf chiffres au maximum après la virgule. Se termine par "s". Example : "3.5s".

createTime

Timestampstring ( format)

Uniquement en sortie. Heure à laquelle le déploiement de correctifs a été créé. L'horodatage est au format texte RFC3339.

Horodatage au format RFC3339 UTC "Zulu", précis à la nanoseconde près. Exemple : "2014-10-02T15:01:23.045123456Z".

updateTime

Timestampstring ( format)

Uniquement en sortie. Heure de la dernière mise à jour du déploiement de correctifs. L'horodatage est au format texte RFC3339.

Horodatage au format RFC3339 UTC "Zulu", précis à la nanoseconde près. Exemple : "2014-10-02T15:01:23.045123456Z".

lastExecuteTime

Timestampstring ( format)

Uniquement en sortie. La dernière fois qu'une tâche d'application de correctifs a été lancée par ce déploiement. L'horodatage est au format texte RFC3339.

Horodatage au format RFC3339 UTC "Zulu", précis à la nanoseconde près. Exemple : "2014-10-02T15:01:23.045123456Z".

Champ d'union schedule. Planification du correctif. schedule ne peut être qu'un des éléments suivants :
oneTimeSchedule

OneTimeScheduleobject ()

Obligatoire. Planification d'une exécution ponctuelle.

recurringSchedule

RecurringScheduleobject ()

Obligatoire. Planification d'exécutions récurrentes.

OneTimeSchedule

Définit l'heure d'un déploiement de correctifs ponctuel. L'horodatage est au format texte RFC3339.

Représentation JSON

{
      "executeTime": string
    }
Champs
executeTime

Timestampstring ( format)

Obligatoire. Durée d'exécution souhaitée de la tâche d'application de correctifs.

Horodatage au format RFC3339 UTC "Zulu", précis à la nanoseconde près. Exemple : "2014-10-02T15:01:23.045123456Z".

RecurringSchedule

Définit l'heure pour les déploiements de correctifs récurrents.

Représentation JSON

{
      "timeZone": {
        object (TimeZone)
      },
      "startTime": string,
      "endTime": string,
      "timeOfDay": {
        object (TimeOfDay)
      },
      "frequency": enum (Frequency),
      "lastExecuteTime": string,
      "nextExecuteTime": string,

      // Union field schedule_config can be only one of the following:
      "weekly": {
        object (WeeklySchedule)
      },
      "monthly": {
        object (MonthlySchedule)
      }
      // End of list of possible types for union field schedule_config.
    }
Champs
timeZone

TimeZoneobject ()

Obligatoire. Définit le fuseau horaire associé à timeOfDay. Les règles relatives à l'heure d'été sont déterminées par le fuseau horaire choisi.

startTime

Timestampstring ( format)

Facultatif. Heure d'entrée en vigueur du calendrier récurrent. Valeur par défaut : createTime du déploiement de correctifs.

Horodatage au format RFC3339 UTC "Zulu", précis à la nanoseconde près. Exemple : "2014-10-02T15:01:23.045123456Z".

endTime

Timestampstring ( format)

Facultatif. Heure de fin à laquelle un calendrier récurrent de déploiement de correctifs n'est plus actif.

Horodatage au format RFC3339 UTC "Zulu", précis à la nanoseconde près. Exemple : "2014-10-02T15:01:23.045123456Z".

timeOfDay

TimeOfDayobject ()

Obligatoire. Heure de la journée pour exécuter un déploiement récurrent.

frequency

Frequencyenum ()

Obligatoire. Unité de fréquence de ce calendrier récurrent.

lastExecuteTime

Timestampstring ( format)

Uniquement en sortie. Heure à laquelle la dernière tâche d'application de correctifs s'est exécutée correctement.

Horodatage au format RFC3339 UTC "Zulu", précis à la nanoseconde près. Exemple : "2014-10-02T15:01:23.045123456Z".

nextExecuteTime

Timestampstring ( format)

Uniquement en sortie. Heure à laquelle la prochaine tâche d'application de correctifs est planifiée.

Horodatage au format RFC3339 UTC "Zulu", précis à la nanoseconde près. Exemple : "2014-10-02T15:01:23.045123456Z".

Champ d'union schedule_config. Configurations pour ce calendrier récurrent. Les configurations doivent correspondre à la fréquence. schedule_config ne peut être qu'un des éléments suivants :
weekly

WeeklyScheduleobject ()

Obligatoire. Calendrier avec des exécutions hebdomadaires.

monthly

MonthlyScheduleobject ()

Obligatoire. Calendrier avec des exécutions mensuelles.

TimeZone

Représente un fuseau horaire de la base de données des fuseaux horaires IANA.

Représentation JSON

{
      "id": string,
      "version": string
    }
Champs
id

string

Fuseau horaire de la base de données des fuseaux horaires IANA, par exemple "America/New_York".

version

string

Facultatif. Numéro de version de la base de données des fuseaux horaires IANA, par exemple "2019a".

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

Heure de la journée au format 24 heures. Elle doit être comprise entre 0 à 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 de l'heure de la journée. Elles doivent être comprises entre 0 à 59.

seconds

integer

Secondes de l'heure de la journée. Elles doivent normalement être comprises entre 0 et 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 comprise entre 0 et 999 999 999.

Fréquence

Indique la fréquence des déploiements de correctifs récurrents.

Enums
FREQUENCY_UNSPECIFIED Non valide. Une fréquence doit être spécifiée.
WEEKLY Indique que la fréquence doit être exprimée en semaines.
MONTHLY Indique que la fréquence doit être exprimée en mois.

WeeklySchedule

Représente un calendrier hebdomadaire.

Représentation JSON

{
      "dayOfWeek": enum (DayOfWeek)
    }
Champs
dayOfWeek

DayOfWeekenum ()

Obligatoire. Jour de la semaine.

DayOfWeek

Représente un jour de la semaine.

Enums
DAY_OF_WEEK_UNSPECIFIED Le jour de la semaine non spécifié.
MONDAY Le lundi de la semaine.
TUESDAY Le mardi de la semaine.
WEDNESDAY Le mercredi de la semaine.
THURSDAY Le jeudi de la semaine.
FRIDAY Le vendredi de la semaine.
SATURDAY Le samedi de la semaine.
SUNDAY Le dimanche de la semaine.

MonthlySchedule

Représente un calendrier mensuel. Par exemple, un calendrier mensuel valide est "le troisième mardi du mois" ou "le 15 du mois".

Représentation JSON

{

      // Union field day_of_month can be only one of the following:
      "weekDayOfMonth": {
        object (WeekDayOfMonth)
      },
      "monthDay": integer
      // End of list of possible types for union field day_of_month.
    }
Champs
Champ d'union day_of_month. Un jour par mois. day_of_month ne peut être qu'un des éléments suivants :
weekDayOfMonth

WeekDayOfMonthobject ()

Obligatoire. Jour de la semaine par mois.

monthDay

integer

Obligatoire. Un jour par mois. 1-31 indique un jour du 1er au 31. -1 indique le dernier jour du mois. Les mois sans date cible seront ignorés. Par exemple, un calendrier fixé "le 31 de chaque mois n'exécutera pas de déploiement en février, avril, juin, etc.

WeekDayOfMonth

Représente un jour de la semaine par mois, par exemple, "le 4e dimanche".

Représentation JSON

{
      "weekOrdinal": integer,
      "dayOfWeek": enum (DayOfWeek)
    }
Champs
weekOrdinal

integer

Obligatoire. Numéro de la semaine dans un mois. 1-4 indique une semaine de la première à la quatrième. -1 indique la dernière semaine du mois.

dayOfWeek

DayOfWeekenum ()

Obligatoire. Un jour de la semaine.

Méthodes

create

Créez un déploiement de correctifs OS Config.

delete

Supprimez un déploiement de correctif OS Config.

get

Obtenez un déploiement de correctif OS Config.

list

Obtenez une page de déploiements de correctifs OS Config.