Method: projects.patchJobs.execute

Patch VM instances by creating and running a patch job.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The project in which to run this patch in the form projects/*

Request body

The request body contains data with the following structure:

JSON representation
{
  "description": string,
  "instanceFilter": {
    object (PatchInstanceFilter)
  },
  "patchConfig": {
    object (PatchConfig)
  },
  "duration": string,
  "dryRun": boolean,
  "displayName": string,
  "rollout": {
    object (PatchRollout)
  }
}
Fields
description

string

Description of the patch job. Length of the description is limited to 1024 characters.

instanceFilter

object (PatchInstanceFilter)

Required. Instances to patch, either explicitly or filtered by some criteria such as zone or labels.

patchConfig

object (PatchConfig)

Patch configuration being applied. If omitted, instances are patched using the default configurations.

duration

string (Duration format)

Duration of the patch job. After the duration ends, the patch job times out.

A duration in seconds with up to nine fractional digits, terminated by 's'. Example: "3.5s".

dryRun

boolean

If this patch is a dry-run only, instances are contacted but will do nothing.

displayName

string