- Resource: PatchDeployment
- OneTimeSchedule
- RecurringSchedule
- Frequency
- WeeklySchedule
- MonthlySchedule
- WeekDayOfMonth
- Methods
Resource: PatchDeployment
Patch deployments are configurations that individual patch jobs use to complete a patch. These configurations include instance filter, package repository settings, and a schedule. For more information about creating and managing patch deployments, see Scheduling patch jobs.
JSON representation | |
---|---|
{ "name": string, "description": string, "instanceFilter": { object ( |
Fields | ||
---|---|---|
name |
Unique name for the patch deployment resource in a project. The patch deployment name is in the form: |
|
description |
Optional. Description of the patch deployment. Length of the description is limited to 1024 characters. |
|
instanceFilter |
Required. VM instances to patch. |
|
patchConfig |
Optional. Patch configuration that is applied. |
|
duration |
Optional. Duration of the patch. After the duration ends, the patch times out. A duration in seconds with up to nine fractional digits, terminated by ' |
|
createTime |
Output only. Time the patch deployment was created. Timestamp is in RFC3339 text format. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
|
updateTime |
Output only. Time the patch deployment was last updated. Timestamp is in RFC3339 text format. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
|
lastExecuteTime |
Output only. The last time a patch job was started by this deployment. Timestamp is in RFC3339 text format. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
|
rollout |
Optional. Rollout strategy of the patch job. |
|
Union field schedule . Schedule for the patch. schedule can be only one of the following: |
||
oneTimeSchedule |
Required. Schedule a one-time execution. |
|
recurringSchedule |
Required. Schedule recurring executions. |
OneTimeSchedule
Sets the time for a one time patch deployment. Timestamp is in RFC3339 text format.
JSON representation | |
---|---|
{ "executeTime": string } |
Fields | |
---|---|
executeTime |
Required. The desired patch job execution time. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
RecurringSchedule
Sets the time for recurring patch deployments.
JSON representation | |
---|---|
{ "timeZone": { object ( |
Fields | ||
---|---|---|
timeZone |
Required. Defines the time zone that |
|
startTime |
Optional. The time that the recurring schedule becomes effective. Defaults to A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
|
endTime |
Optional. The end time at which a recurring patch deployment schedule is no longer active. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
|
timeOfDay |
Required. Time of the day to run a recurring deployment. |
|
frequency |
Required. The frequency unit of this recurring schedule. |
|
lastExecuteTime |
Output only. The time the last patch job ran successfully. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
|
nextExecuteTime |
Output only. The time the next patch job is scheduled to run. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
|
Union field schedule_config . Configurations for this recurring schedule. Configurations must match frequency. schedule_config can be only one of the following: |
||
weekly |
Required. Schedule with weekly executions. |
|
monthly |
Required. Schedule with monthly executions. |
Frequency
Specifies the frequency of the recurring patch deployments.
Enums | |
---|---|
FREQUENCY_UNSPECIFIED |
Invalid. A frequency must be specified. |
WEEKLY |
Indicates that the frequency should be expressed in terms of weeks. |
MONTHLY |
Indicates that the frequency should be expressed in terms of months. |
WeeklySchedule
Represents a weekly schedule.
JSON representation | |
---|---|
{
"dayOfWeek": enum ( |
Fields | |
---|---|
dayOfWeek |
Required. Day of the week. |
MonthlySchedule
Represents a monthly schedule. An example of a valid monthly schedule is "on the third Tuesday of the month" or "on the 15th of the month".
JSON representation | |
---|---|
{ // Union field |
Fields | ||
---|---|---|
Union field day_of_month . One day in a month. day_of_month can be only one of the following: |
||
weekDayOfMonth |
Required. Week day in a month. |
|
monthDay |
Required. One day of the month. 1-31 indicates the 1st to the 31st day. -1 indicates the last day of the month. Months without the target day will be skipped. For example, a schedule to run "every month on the 31st" will not run in February, April, June, etc. |
WeekDayOfMonth
Represents one week day in a month. An example is "the 4th Sunday".
JSON representation | |
---|---|
{
"weekOrdinal": integer,
"dayOfWeek": enum ( |
Fields | |
---|---|
weekOrdinal |
Required. Week number in a month. 1-4 indicates the 1st to 4th week of the month. -1 indicates the last week of the month. |
dayOfWeek |
Required. A day of the week. |
Methods |
|
---|---|
|
Create an OS Config patch deployment. |
|
Delete an OS Config patch deployment. |
|
Get an OS Config patch deployment. |
|
Get a page of OS Config patch deployments. |