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

省略可。パッチデプロイの説明。説明の長さは 1,024 文字までに制限されています。

instanceFilter

PatchInstanceFilterobject ()

必須。パッチを適用する VM インスタンス。

patchConfig

PatchConfigobject ()

省略可。適用されるパッチ構成。

duration

Durationstring ( format)

省略可。パッチの期間。期間が終了すると、パッチがタイムアウトします。

小数 9 桁まで、「s」で終わる秒単位の期間(例: "3.5s")。

createTime

Timestampstring ( format)

出力のみ。パッチデプロイが作成された時刻。タイムスタンプは RFC3339 テキスト形式です。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒。例: "2014-10-02T15:01:23.045123456Z"

updateTime

Timestampstring ( format)

出力のみ。パッチデプロイが最後に更新された時刻。タイムスタンプは RFC3339 テキスト形式です。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒。例: "2014-10-02T15:01:23.045123456Z"

lastExecuteTime

Timestampstring ( format)

出力のみ。このデプロイによってパッチジョブが最後に開始された時刻。タイムスタンプは RFC3339 テキスト形式です。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒。例: "2014-10-02T15:01:23.045123456Z"

共用体フィールド schedule。パッチのスケジュール。schedule は次のいずれかになります。
oneTimeSchedule

OneTimeScheduleobject ()

必須。1 回限りの実行をスケジュールします。

recurringSchedule

RecurringScheduleobject ()

必須。定期的な実行をスケジュールします。

OneTimeSchedule

1 回限りのパッチデプロイの時間を設定します。タイムスタンプは RFC3339 テキスト形式です。

JSON 表現

{
      "executeTime": string
    }
フィールド
executeTime

Timestampstring ( format)

必須。希望するパッチジョブの実行時間。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒。例: "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「Zulu」形式のタイムスタンプ。精度はナノ秒。例: "2014-10-02T15:01:23.045123456Z"

endTime

Timestampstring ( format)

省略可。定期的なパッチデプロイのスケジュールがアクティブでなくなる終了時間。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒。例: "2014-10-02T15:01:23.045123456Z"

timeOfDay

TimeOfDayobject ()

必須。定期的なデプロイを実行する時刻。

frequency

Frequencyenum ()

必須。この定期的なスケジュールの頻度単位。

lastExecuteTime

Timestampstring ( format)

出力のみ。最後のパッチジョブが正常に実行された時刻。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒。例: "2014-10-02T15:01:23.045123456Z"

nextExecuteTime

Timestampstring ( format)

出力のみ。次のパッチジョブの実行がスケジュールされる時刻。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒。例: "2014-10-02T15:01:23.045123456Z"

共用体フィールド schedule_config。この定期的なスケジュールの構成。構成は頻度と一致する必要があります。schedule_config は次のいずれかになります。
weekly

WeeklyScheduleobject ()

必須。週 1 回の実行でスケジュールします。

monthly

MonthlyScheduleobject ()

必須。月 1 回の実行でスケジュールします。

TimeZone

IANA タイムゾーン データベースのタイムゾーンを表します。

JSON 表現

{
      "id": string,
      "version": string
    }
フィールド
id

string

IANA タイムゾーン データベースのタイムゾーン(例: "America/New_York")。

version

string

省略可。IANA タイムゾーン データベースのバージョン番号(例: "2019a")。

TimeOfDay

1 日のうちの時間を表します。日付とタイムゾーンは重要ではないか、他の場所で指定されています。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 がうるう秒を許可する場合、値 60 が許可されます。

nanos

integer

秒の小数部分(ナノ秒単位)。0~999,999,999 である必要があります。

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

月単位のスケジュールを表します。有効な毎月のスケジュールの例は、「月の第 3 火曜日」や「月の 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。月に 1 日。day_of_month は次のいずれかになります。
weekDayOfMonth

WeekDayOfMonthobject ()

必須。月の平日。

monthDay

integer

必須。月の 1 日。1-31 は 1~31 日目を示します。-1 は月の最終日を示します。対象日がない月はスキップされます。たとえば、「毎月 31 日」に実行するスケジュールは 2 月、4 月、6 月などには実行されません。

WeekDayOfMonth

月の 1 曜日を表します。たとえば、「第 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 パッチデプロイのページを取得します。