REST 资源:projects.patchDeployments

资源:PatchDeployment

补丁程序部署是各个修补作业用于完成修补的配置。这些配置包括实例过滤条件、软件包代码库设置和时间表。

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.
    }
字段
name

string

项目中补丁程序部署资源的唯一名称。补丁程序部署名称的格式为:projects/{project_id}/patchDeployments/{patchDeploymentId}。当您创建新的补丁程序部署时,系统会忽略此字段。

description

string

可选。补丁程序部署的说明。说明的长度不得超过 1024 个字符。

instanceFilter

PatchInstanceFilterobject ()

必需。要修补的虚拟机实例。

patchConfig

PatchConfigobject ()

可选。所应用的补丁程序配置。

duration

Durationstring ( format)

可选。修补作业的时长。该时长终结后,修补作业会超时。

该时长以秒为单位,最多包含九个小数位,以“s”结尾。示例:"3.5s"

createTime

Timestampstring ( format)

仅供输出。创建补丁程序部署的时间。时间戳采用 RFC3339 文本格式。

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒。示例:"2014-10-02T15:01:23.045123456Z"

updateTime

Timestampstring ( format)

仅供输出。上次更新补丁程序部署的时间。时间戳采用 RFC3339 文本格式。

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒。示例:"2014-10-02T15:01:23.045123456Z"

lastExecuteTime

Timestampstring ( format)

仅供输出。此部署上次启动修补作业的时间。时间戳采用 RFC3339 文本格式。

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒。示例:"2014-10-02T15:01:23.045123456Z"

联合字段 schedule。修补作业的时间表。schedule 只能是下列其中一项:
oneTimeSchedule

OneTimeScheduleobject ()

必需。安排修补作业仅执行一次。

recurringSchedule

RecurringScheduleobject ()

必需。安排修补作业定期执行。

OneTimeSchedule

设置一次性补丁程序部署的时间。时间戳采用 RFC3339 文本格式。

JSON 表示法

{
      "executeTime": string
    }
字段
executeTime

Timestampstring ( format)

必需。所需的修补作业执行时间。

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒。示例:"2014-10-02T15:01:23.045123456Z"

RecurringSchedule

设置周期性补丁程序部署的时间。

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.
    }
字段
timeZone

TimeZoneobject ()

必需。指定与 timeOfDay 相对的时区。夏令时规则取决于所选时区。

startTime

Timestampstring ( format)

可选。周期性时间表生效的时间。默认为补丁程序部署的 createTime

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒。示例:"2014-10-02T15:01:23.045123456Z"

endTime

Timestampstring ( format)

可选。周期性补丁程序部署时间表的结束时间不再有效。

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒。示例:"2014-10-02T15:01:23.045123456Z"

timeOfDay

TimeOfDayobject ()

必需。一天中运行周期性部署的时间。

frequency

Frequencyenum ()

必需。此周期性时间表的频率单位。

lastExecuteTime

Timestampstring ( format)

仅供输出。最后一个修补作业成功运行的时间。

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒。示例:"2014-10-02T15:01:23.045123456Z"

nextExecuteTime

Timestampstring ( format)

仅供输出。安排的下一个修补作业的运行时间。

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒。示例:"2014-10-02T15:01:23.045123456Z"

联合字段 schedule_config。此周期性时间表的配置。配置必须与频率匹配。schedule_config 只能是下列其中一项:
weekly

WeeklyScheduleobject ()

必需。安排每周执行。

monthly

MonthlyScheduleobject ()

必需。安排每月执行。

TimeZone

表示 IANA 时区数据库中的时区。

JSON 表示法

{
      "id": string,
      "version": string
    }
字段
id

string

IANA 时区数据库中的时区,例如“America/New_York”。

version

string

可选。IANA 时区数据库版本号,例如“2019a”。

TimeOfDay

表示一天中的某个时间。日期和时区不重要,或在别处指定。API 可以选择允许闰秒。相关类型为 google.type.Dategoogle.protobuf.Timestamp

JSON 表示法

{
      "hours": integer,
      "minutes": integer,
      "seconds": integer,
      "nanos": integer
    }
字段
hours

integer

一天中的小时(采用 24 小时制)。值应为 0 到 23。对于业务结束时间等场景,API 可以选择允许“24:00:00”一值。

minutes

integer

一天中某小时的分钟数。值必须是介于 0 和 59 之间的数字。

seconds

integer

时间的秒数部分。通常必须是介于 0 和 59 之间的数字。如果 API 允许闰秒,则 API 可以允许 60 一值。

nanos

integer

秒数的小数部分(以纳秒为单位)。值必须是介于 0 和 999999999 之间的数字。

Frequency

指定周期性补丁程序部署的频率。

枚举
FREQUENCY_UNSPECIFIED 无效。必须指定频率。
WEEKLY 表示频率应以周为单位。
MONTHLY 表示频率应以月为单位。

WeeklySchedule

表示每周时间表。

JSON 表示法

{
      "dayOfWeek": enum (DayOfWeek)
    }
字段
dayOfWeek

DayOfWeekenum ()

必需。星期几。

DayOfWeek

表示一周中的某一天。

枚举
DAY_OF_WEEK_UNSPECIFIED 未指定星期几。
MONDAY 星期一。
TUESDAY 星期二。
WEDNESDAY 星期三。
THURSDAY 星期四。
FRIDAY 星期五。
SATURDAY 星期六。
SUNDAY 星期日。

MonthlySchedule

表示每月时间表。有效每月时间表的示例为“当月的第三个星期二”或“当月 15 号”。

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.
    }
字段
联合字段 day_of_month。一个月中的某一天。day_of_month 只能是下列其中一项:
weekDayOfMonth

WeekDayOfMonthobject ()

必需。一个月中的星期几。

monthDay

integer

必需。当月的某一天。1-31 表示第 1 天到第 31 天。-1 表示当月的最后一天。系统会跳过没有该目标日期的月份。例如,“每月 31 日”运行的时间表不会在 2 月、4 月、6 月等月份运行。

WeekDayOfMonth

表示一个月中的某个星期几。例如,“第 4 个星期日”。

JSON 表示法

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

integer

必需。一个月中的第几周。1-4 表示当月的第 1 到第 4 周。-1 表示当月的最后一周。

dayOfWeek

DayOfWeekenum ()

必需。星期几。

方法

create

创建 OS Config 补丁程序部署。

delete

删除 OS Config 补丁程序部署。

get

获取 OS Config 补丁程序部署。

list

获取 OS Config 补丁程序部署页面。