Método: projects.patchJobs.execute

Corrija instâncias de VMs criando e executando um job de patch.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O projeto no qual executar este patch no formato projects/*

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON

{
  "description": string,
  "instanceFilter": {
    object (PatchInstanceFilter)
  },
  "patchConfig": {
    object (PatchConfig)
  },
  "duration": string,
  "dryRun": boolean,
  "displayName": string
}
Campos
description

string

Descrição do job de patch. O tamanho da descrição é limitado a 1.024 caracteres.

instanceFilter

object (PatchInstanceFilter)

Obrigatório. Instâncias que terão patch aplicado, explicitamente ou filtradas por alguns critérios, como zona ou rótulos.

patchConfig

object (PatchConfig)

Configuração de patch sendo aplicada. Se forem omitidas, as instâncias serão atualizadas com o uso das configurações padrão.

duration

string (Duration format)

Duração do job de patch. Depois que a duração terminar, o tempo de espera do job de patch expirará.

Uma duração em segundos com até nove dígitos fracionários, encerrada por "s". Exemplo: "3.5s".

dryRun

boolean

Se esse patch for apenas uma simulação, instâncias serão contatadas, mas não farão nada.

displayName

string

Nome de exibição deste job de patch. Isso não precisa ser exclusivo.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de PatchJob.

Escopos de autorização

Requer o seguinte escopo do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

Permissões do IAM

Exige a seguinte permissão do Cloud IAM no recurso parent:

  • osconfig.patchJobs.exec

Para mais informações, consulte a documentação do Cloud IAM.

Faça um teste