Recurso REST: projects.patchDeployments

Recurso: PatchDeployment

As implantações de patch são configurações que os jobs de patch individuais usam para executar um patch. Essas configurações incluem um filtro de instância, as configurações do repositório de pacotes e uma programação. Para mais informações sobre como criar e gerenciar implantações de patch, consulte Como programar jobs de patch.

Representação 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.
}
Campos
name

string

Nome exclusivo do recurso de implantação de patch no projeto. O nome de implantação do patch está no formato: projects/{project_id}/patchDeployments/{patchDeploymentId}. Esse campo é ignorado quando você cria uma nova implantação de patch.

description

string

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

instanceFilter

object (PatchInstanceFilter)

Obrigatório. Instâncias de VM para patch.

patchConfig

object (PatchConfig)

Opcional. Configuração de patch aplicada.

duration

string (Duration format)

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

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

createTime

string (Timestamp format)

Apenas saída. Hora em que a implantação do patch foi criada. O carimbo de data/hora está no formato de texto RFC3339.

Um carimbo de data/hora no formato UTC “Zulu” RFC3339, medido com precisão de nanossegundos. Exemplo: "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Apenas saída. Hora em que a implantação do patch foi atualizada pela última vez. O carimbo de data/hora está no formato de texto RFC3339.

Um carimbo de data/hora no formato UTC “Zulu” RFC3339, medido com precisão de nanossegundos. Exemplo: "2014-10-02T15:01:23.045123456Z".

lastExecuteTime

string (Timestamp format)

Apenas saída. A última vez em que um patch foi iniciado por esta implantação. O carimbo de data/hora está no formato de texto RFC3339.

Um carimbo de data/hora no formato UTC “Zulu” RFC3339, medido com precisão de nanossegundos. Exemplo: "2014-10-02T15:01:23.045123456Z".

Campo de união schedule. Programação do patch. schedule pode ser apenas de um dos tipos a seguir:
oneTimeSchedule

object (OneTimeSchedule)

Obrigatório. Programe execuções únicas.

recurringSchedule

object (RecurringSchedule)

Obrigatório. Programe execuções recorrentes.

OneTimeSchedule

Define o horário para uma implantação de patch único. O carimbo de data/hora está no formato de texto RFC3339.

Representação JSON

{
  "executeTime": string
}
Campos
executeTime

string (Timestamp format)

Obrigatório. O tempo de execução do job de patch desejado.

Um carimbo de data/hora no formato UTC “Zulu” RFC3339, medido com precisão de nanossegundos. Exemplo: "2014-10-02T15:01:23.045123456Z".

RecurringSchedule

Define o horário para implantações de patch recorrente.

Representação 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.
}
Campos
timeZone

object (TimeZone)

Obrigatório. Define o fuso horário que o timeOfDay está relacionado. As regras para o horário de verão são determinadas pelo fuso horário escolhido.

startTime

string (Timestamp format)

Opcional. O horário em que a programação recorrente se torna efetiva. Para a implantação do patch usa-se o padrão createTime.

Um carimbo de data/hora no formato UTC “Zulu” RFC3339, medido com precisão de nanossegundos. Exemplo: "2014-10-02T15:01:23.045123456Z".

endTime

string (Timestamp format)

Opcional. O horário final em que a programação de implantação de patch recorrente não está mais ativo.

Um carimbo de data/hora no formato UTC “Zulu” RFC3339, medido com precisão de nanossegundos. Exemplo: "2014-10-02T15:01:23.045123456Z".

timeOfDay

object (TimeOfDay)

Obrigatório. Horário do dia para executar uma implantação recorrente.

frequency

enum (Frequency)

Obrigatório. A unidade para a frequência desta programação recorrente.

lastExecuteTime

string (Timestamp format)

Apenas saída. A hora em que o último job de patch foi executado.

Um carimbo de data/hora no formato UTC “Zulu” RFC3339, medido com precisão de nanossegundos. Exemplo: "2014-10-02T15:01:23.045123456Z".

nextExecuteTime

string (Timestamp format)

Apenas saída. A hora em que o próximo job de patch será programado.

Um carimbo de data/hora no formato UTC “Zulu” RFC3339, medido com precisão de nanossegundos. Exemplo: "2014-10-02T15:01:23.045123456Z".

Campo de união schedule_config. Configurações para esta programação recorrente. As configurações precisam corresponder à frequência. schedule_config pode ser apenas de um dos tipos a seguir:
weekly

object (WeeklySchedule)

Obrigatório. Programar com execuções semanais.

monthly

object (MonthlySchedule)

Obrigatório. Programar com execuções mensais.

Frequência

Especifica a frequência das implantações de patch recorrente.

Enums
FREQUENCY_UNSPECIFIED Inválido. Uma frequência precisa ser especificada.
WEEKLY Indica que a frequência deve ser expressa em termos de semanas.
MONTHLY Indica que a frequência deve ser expressa em termos de meses.

WeeklySchedule

Representa uma programação semanal.

Representação JSON

{
  "dayOfWeek": enum (DayOfWeek)
}
Campos
dayOfWeek

enum (DayOfWeek)

Obrigatório. Dia da semana

MonthlySchedule

Representa uma programação mensal. Um exemplo de uma programação mensal válida é "na terceira terça-feira do mês" ou "no dia 15 do mês".

Representação 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.
}
Campos
Campo de união day_of_month. Um dia no mês. day_of_month pode ser apenas de um dos tipos a seguir:
weekDayOfMonth

object (WeekDayOfMonth)

Obrigatório. Dia da semana em um mês.

monthDay

integer

Obrigatório. Um dia no mês. 1-31 indica do 1º ao 31º dia. -1 indica o último dia do mês. Os meses sem o dia definido serão ignorados. Por exemplo, uma programação para ser executada "todos os meses no dia 31" não será executada em fevereiro, abril, junho etc.

WeekDayOfMonth

Representa um dia da semana em um mês. Por exemplo, "o 4º domingo".

Representação JSON

{
  "weekOrdinal": integer,
  "dayOfWeek": enum (DayOfWeek)
}
Campos
weekOrdinal

integer

Obrigatório. Número da semana em um mês. 1-4 indica da 1ª a 4ª semana do mês. -1 indica a última semana do mês.

dayOfWeek

enum (DayOfWeek)

Obrigatório. Um dia da semana.

Métodos

create

Crie uma implantação de patch da configuração do sistema operacional.

delete

Exclua uma implantação de patch da Configuração do SO.

get

Receba uma implantação de patch da Configuração do SO.

list

Receba uma página de implantações de patch da Configuração do SO.