REST Resource: projects.locations.privateClouds.upgrades

Recurso: Upgrade

Descreve o upgrade da nuvem privada.

Representação JSON 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "endTime": string,
  "state": enum (State),
  "type": enum (Type),
  "description": string,
  "estimatedDuration": string,
  "schedule": {
    object (Schedule)
  },
  "version": string,
  "etag": string,
  "uid": string,
  "componentUpgrades": [
    {
      object (VmwareUpgradeComponent)
    }
  ],
  "startVersion": string,
  "targetVersion": string
}
Campos
name

string

Apenas saída. Identificador. O nome do recurso da nuvem privada Upgrade. Os nomes de recursos são URIs sem esquema que seguem as convenções em https://cloud.google.com/apis/design/resource_names. Por exemplo: projects/my-project/locations/us-west1-a/privateClouds/my-cloud/upgrades/my-upgrade
createTime

string (Timestamp format)

Apenas saída. Somente saída. Hora de criação deste recurso.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Apenas saída. Somente saída. A última atualização deste recurso.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Apenas saída. Somente saída. Horário de término do upgrade.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
state

enum (State)

Apenas saída. O estado atual do upgrade.
type

enum (Type)

Apenas saída. Somente saída. O tipo de upgrade.
description

string

Apenas saída. Somente saída. A descrição do upgrade. Usado para fornecer mais informações sobre a atualização da nuvem privada, como a finalidade, as mudanças incluídas ou outras informações relevantes.
estimatedDuration

string (Duration format)

Apenas saída. Somente saída. A duração total estimada do upgrade. Essas informações podem ser usadas para planejar ou programar upgrades e minimizar interrupções. A duração estimada é apenas uma estimativa. A duração real do upgrade pode variar.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".
schedule

object (Schedule)

Programe os detalhes do upgrade.
version

string

Apenas saída.

etag

string

O ETag do recurso de upgrade. Se esses dados forem fornecidos durante a atualização, eles precisarão corresponder ao etag do servidor.
uid

string

Apenas saída. Identificador exclusivo gerado pelo sistema para o recurso.
componentUpgrades[]

object (VmwareUpgradeComponent)

Apenas saída. Somente saída. A lista de upgrades de componentes.
startVersion

string

Apenas saída. Somente saída. A versão inicial
targetVersion

string

Apenas saída. Somente saída. A versão de destino

Estado

Estados possíveis da nuvem privada Upgrade.

Tipos enumerados
STATE_UNSPECIFIED O valor padrão. Esse valor nunca pode ser usado.
SCHEDULED O upgrade está programado, mas ainda não começou.
ONGOING O upgrade está em andamento e ainda não foi concluído.
SUCCEEDED O upgrade foi concluído.
PAUSED O upgrade está pausado.
FAILED O upgrade falhou.
CANCELLING O upgrade está em processo de cancelamento.
CANCELLED O upgrade é cancelado.
RESCHEDULING O upgrade está sendo reprogramado.

Tipo

Possíveis tipos de upgrade. Mais tipos podem ser adicionados no futuro.

Tipos enumerados
TYPE_UNSPECIFIED O valor padrão. Esse valor nunca pode ser usado.
VSPHERE_UPGRADE Upgrade de componentes do VMware quando uma versão principal está disponível. 7.0u2 -> 7.0u3.
VSPHERE_PATCH Aplicação de patch em componentes do VMware quando uma versão secundária está disponível. 7.0u2c -> 7.0u2d.
WORKAROUND As soluções alternativas são hotfixes para vulnerabilidades ou problemas aplicados para mitigar a vulnerabilidade ou o problema conhecido até que um patch ou uma atualização seja lançada. A descrição do upgrade terá mais detalhes.
FIRMWARE_UPGRADE Upgrade de firmware para o produto VMware usado na nuvem privada.
SWITCH_UPGRADE Alternar upgrade.
OTHER O tipo de upgrade que não se enquadra em nenhuma outra categoria.
INFRASTRUCTURE_UPGRADE Upgrade de infraestrutura na manutenção de nós do BM.

Programar

Programe o upgrade.

Representação JSON 
{
  "startTime": string,
  "weeklyWindows": [
    {
      object (TimeWindow)
    }
  ],
  "constraints": {
    object (Constraints)
  },
  "editWindow": {
    object (Interval)
  },
  "lastEditor": enum (Editor)
}
Campos
startTime

string (Timestamp format)

Obrigatório. O horário de início programado para o upgrade.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
weeklyWindows[]

object (TimeWindow)

Obrigatório. Períodos semanais para atividades de upgrade. O servidor realiza atividades de upgrade durante essas janelas de tempo para minimizar as interrupções.
constraints

object (Constraints)

Apenas saída. Somente saída. Restrições aplicadas ao cronograma. Essas restrições precisam ser aplicáveis no momento de qualquer reagendamento.
editWindow

object (Interval)

Apenas saída. Somente saída. O horário fica aberto para edições durante esse intervalo ou janela.
lastEditor

enum (Editor)

Apenas saída. Somente saída. Indica quem editou a programação de upgrade mais recentemente. O valor é atualizado sempre que o upgrade é reagendado.

TimeWindow

Representa o período para realizar atividades de upgrade.

Representação JSON 
{
  "dayOfWeek": enum (DayOfWeek),
  "startTime": {
    object (TimeOfDay)
  },
  "duration": string
}
Campos
dayOfWeek

enum (DayOfWeek)

Obrigatório. Dia da semana para esta janela.
startTime

object (TimeOfDay)

Obrigatório. Horário em UTC em que a janela começa.
duration

string (Duration format)

Obrigatório. A duração da janela. A duração máxima permitida para qualquer janela é de 24 horas.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

DayOfWeek

Representa um dia da semana.

Enums
DAY_OF_WEEK_UNSPECIFIED O dia da semana não é especificado.
MONDAY Segunda-feira
TUESDAY Terça-feira
WEDNESDAY Quarta-feira
THURSDAY Quinta-feira
FRIDAY Sexta-feira
SATURDAY Sábado
SUNDAY Domingo

TimeOfDay

Representa um horário do dia. A data e o fuso horário não são relevantes ou são especificados em outro lugar. Uma API pode permitir segundos bissextos. Os tipos relacionados são google.type.Date e google.protobuf.Timestamp.

Representação JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Campos
hours

integer

Horas de um dia no formato de 24 horas. Precisa ser maior ou igual a 0 e geralmente menor ou igual a 23. Uma API pode permitir o valor "24:00:00" para o horário de fechamento da empresa, por exemplo.
minutes

integer

Minutos de uma hora. Precisa ser maior ou igual a 0 e menor ou igual a 59.
seconds

integer

Segundos de um minuto. Precisa ser maior ou igual a 0 e normalmente menor ou igual a 59. Uma API pode permitir o valor 60 se permitir segundos bissextos.
nanos

integer

Frações de segundos, em nanossegundos. Precisa ser maior ou igual a 0 e menor ou igual a 999.999.999.

Restrições

Restrições a serem aplicadas ao editar uma programação. Essas restrições garantem que Upgrade requisitos específicos sejam atendidos.

Representação JSON 
{
  "minHoursDay": integer,
  "minHoursWeek": integer,
  "rescheduleDateRange": {
    object (Interval)
  },
  "disallowedIntervals": [
    {
      object (WeeklyTimeInterval)
    }
  ]
}
Campos
minHoursDay

integer

Apenas saída. O número mínimo de horas precisa ser alocado para as atividades de upgrade em cada dia selecionado. Esse é um mínimo. A programação de upgrade pode alocar mais horas para o dia em questão.
minHoursWeek

integer

Apenas saída. O número mínimo de horas semanais precisa ser alocado para as atividades de upgrade. Esse é apenas um mínimo. A programação pode atribuir mais horas semanais.
rescheduleDateRange

object (Interval)

Apenas saída. Somente saída. O usuário só pode reagendar uma atualização que comece dentro desse período.
disallowedIntervals[]

object (WeeklyTimeInterval)

Apenas saída. Somente saída. Uma lista de intervalos em que as janelas de manutenção não são permitidas. Qualquer período que se sobreponha a um desses intervalos será considerado inválido.

Intervalo

Representa um intervalo de tempo, codificado como um início de carimbo de data/hora (incluído) e um fim de carimbo de data/hora (não incluído).

O início precisa ser menor ou igual ao fim. Quando o início é igual ao fim, o intervalo fica vazio (não corresponde a nenhum horário). Quando o início e o fim não são especificados, o intervalo corresponde a qualquer momento.

Representação JSON 
{
  "startTime": string,
  "endTime": string
}
Campos
startTime

string (Timestamp format)

Opcional. Início inclusivo do intervalo.

Se especificado, um carimbo de data/hora correspondente a esse intervalo precisará ser igual ou posterior ao início.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Opcional. Fim exclusivo do intervalo.

Se especificado, um carimbo de data/hora correspondente a esse intervalo precisará ser anterior ao fim.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

WeeklyTimeInterval

Representa um intervalo de tempo que abrange dias da semana. Até que os fusos horários locais sejam aceitos, esse intervalo estará em UTC.

Representação JSON 
{
  "startDay": enum (DayOfWeek),
  "startTime": {
    object (TimeOfDay)
  },
  "endDay": enum (DayOfWeek),
  "endTime": {
    object (TimeOfDay)
  }
}
Campos
startDay

enum (DayOfWeek)

Apenas saída. O dia em que o intervalo começa.
startTime

object (TimeOfDay)

Apenas saída. O horário do dia de início em que o intervalo começa.
endDay

enum (DayOfWeek)

Apenas saída. O dia em que o intervalo termina. Pode ser igual ao dia de início.
endTime

object (TimeOfDay)

Apenas saída. O horário do dia de término em que o intervalo termina.

Editor

Valores possíveis de quem editou o valor da programação de upgrade. Identifica grupos ou entidades em vez de indivíduos.

Tipos enumerados
EDITOR_UNSPECIFIED O valor padrão. Esse valor nunca pode ser usado.
SYSTEM O upgrade é programado pelo sistema ou serviço interno.
USER O upgrade é programado pelo usuário final.

VmwareUpgradeComponent

Por recurso de upgrade de componente

Representação JSON 
{
  "componentType": enum (VmwareComponentType),
  "state": enum (State)
}
Campos
componentType

enum (VmwareComponentType)

Apenas saída. Tipo de componente
state

enum (State)

Apenas saída. Estado do upgrade do componente.

VmwareComponentType

O tipo de componente do VMware

Tipos enumerados
VMWARE_COMPONENT_TYPE_UNSPECIFIED O valor padrão. Esse valor nunca pode ser usado.
VCENTER vcenter
ESXI nós do ESXi + nós de transporte
NSXT_UC coordenador de upgrade do nsxt
NSXT_EDGE Cluster de bordas do NSX-T
NSXT_MGR Gerentes/plano de gerenciamento do NSX-T
HCX hcx
VSAN Cluster VSAN
DVS Chave DVS
NAMESERVER_VM VMs do servidor de nomes
KMS_VM VM do KMS usada para criptografia vsan
WITNESS_VM VM de testemunha em caso de PC estendido
NSXT nsxt
CLUSTER O cluster é usado no caso do BM
VM_TOOLS VMware Tools.

Estado

O estado define o estado atual de um upgrade.

Tipos enumerados
STATE_UNSPECIFIED O valor padrão. Esse valor nunca pode ser usado.
RUNNING O upgrade do componente está em andamento
PAUSED O upgrade do componente está pausado. Será retomado quando o job de upgrade for retomado
SUCCEEDED O upgrade do componente foi concluído.
FAILED Falha no upgrade do componente. Ele vai mudar para "Retomar" se o upgrade for retomado ou permanecer como está.
NOT_STARTED O upgrade do componente ainda não começou
NOT_APPLICABLE O upgrade do componente não é aplicável neste upgrade. Ele será ignorado.

Métodos

get

 Recupera um recurso Upgrade de nuvem privada pelo nome do recurso.

list

 Lista os Upgrades passados, em andamento e futuros da nuvem privada especificada.

patch

 Atualize o recurso Upgrade da nuvem privada.