メソッド: projects.patchJobs.execute

パッチジョブを作成、実行して、VM インスタンスにパッチを適用します。

HTTP リクエスト

POST https://osconfig.googleapis.com/v1beta/{parent=projects/*}/patchJobs:execute

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
parent

string

必須。このパッチを projects/* の形式で実行するプロジェクト

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現

{
      "description": string,
      "instanceFilter": {
        object (PatchInstanceFilter)
      },
      "patchConfig": {
        object (PatchConfig)
      },
      "duration": string,
      "dryRun": boolean,
      "displayName": string
    }
フィールド
description

string

パッチジョブの説明。説明の長さは 1,024 文字までに制限されています。

instanceFilter

PatchInstanceFilterobject ()

必須。明示的に、またはゾーンやラベルなどの条件でフィルタされる、パッチを適用するインスタンス。

patchConfig

PatchConfigobject ()

適用されているパッチ構成。省略した場合、インスタンスにはデフォルトの構成を使用してパッチが適用されます。

duration

Durationstring ( format)

パッチジョブの期間。期間が終了すると、パッチジョブがタイムアウトします。

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

dryRun

boolean

このパッチがドライランのみの場合、インスタンスは接続されますが何も実行されません。

displayName

string

このパッチジョブの表示名。一意である必要はありません。

レスポンスの本文

成功した場合、レスポンスの本文には PatchJob のインスタンスが含まれます。

承認スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/cloud-platform

詳細については、認証の概要をご覧ください。

IAM 権限

parent リソースに対する次の Cloud IAM 権限が必要です。

  • osconfig.patchJobs.exec

詳細については、Cloud IAM ドキュメントをご覧ください。

試してみる