REST Resource: projects.locations.privateClouds.upgrades

Recurso: Upgrade

Describe la actualización de la nube privada.

Representación 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

Solo salida. Es el identificador. Es el nombre del recurso de la nube privada Upgrade. Los nombres de recursos son URIs sin esquema que siguen las convenciones que se indican en https://cloud.google.com/apis/design/resource_names. Por ejemplo: projects/my-project/locations/us-west1-a/privateClouds/my-cloud/upgrades/my-upgrade
createTime

string (Timestamp format)

Solo salida. Solo salida. Es la fecha y hora de creación de este recurso.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo salida. Solo salida. Es la fecha y hora de la última actualización de este recurso.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Solo salida. Solo salida. Es la hora de finalización de la actualización.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
state

enum (State)

Solo salida. Es el estado actual de la actualización.
type

enum (Type)

Solo salida. Solo salida. Es el tipo de actualización.
description

string

Solo salida. Solo salida. Es la descripción de la actualización. Se usa para proporcionar información adicional sobre la actualización de la nube privada, como el propósito de la actualización, los cambios incluidos en ella o cualquier otra información relevante sobre la actualización.
estimatedDuration

string (Duration format)

Solo salida. Solo salida. Es la duración total estimada de la actualización. Esta información se puede usar para planificar o programar actualizaciones y minimizar las interrupciones. Ten en cuenta que la duración estimada es solo una aproximación. La duración real de la actualización puede variar.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".
schedule

object (Schedule)

Son los detalles de la programación de la actualización.
version

string

Solo salida.

etag

string

Es el ETag del recurso de actualización. Si se proporciona en la actualización, debe coincidir con la ETag del servidor.
uid

string

Solo salida. Es el identificador único generado por el sistema para el recurso.
componentUpgrades[]

object (VmwareUpgradeComponent)

Solo salida. Solo salida. Es la lista de actualizaciones de componentes.
startVersion

string

Solo salida. Solo salida. La versión de inicio
targetVersion

string

Solo salida. Solo salida. La versión de destino

Estado

Son los estados posibles de la nube privada Upgrade.

Enums
STATE_UNSPECIFIED Es el valor predeterminado. Este valor nunca debe usarse.
SCHEDULED La actualización está programada, pero aún no comenzó.
ONGOING La actualización está en curso y aún no se completó.
SUCCEEDED La actualización se completó correctamente.
PAUSED La actualización está en pausa.
FAILED No se pudo completar la actualización.
CANCELLING Se está cancelando la actualización.
CANCELLED Se canceló la actualización.
RESCHEDULING Se está reprogramando la actualización.

Tipo

Son los tipos de actualización posibles. Se pueden agregar más tipos en el futuro.

Enums
TYPE_UNSPECIFIED Es el valor predeterminado. Este valor nunca debe usarse.
VSPHERE_UPGRADE Actualización de los componentes de VMware cuando hay disponible una versión principal 7.0u2 -> 7.0u3.
VSPHERE_PATCH Aplicación de parches a los componentes de VMware cuando hay una versión secundaria disponible 7.0u2c -> 7.0u2d.
WORKAROUND Las soluciones alternativas son correcciones urgentes para vulnerabilidades o problemas que se aplican para mitigar la vulnerabilidad o el problema conocidos hasta que se lanza un parche o una actualización. La descripción de la actualización tendrá más detalles.
FIRMWARE_UPGRADE Actualización de firmware para el producto de VMware que se usa en la nube privada.
SWITCH_UPGRADE Cambiar de actualización
OTHER Es el tipo de actualización que no se incluye en ninguna otra categoría.
INFRASTRUCTURE_UPGRADE Actualización de la infraestructura en el mantenimiento de nodos de BM.

Programar

Programación de la actualización.

Representación JSON 
{
  "startTime": string,
  "weeklyWindows": [
    {
      object (TimeWindow)
    }
  ],
  "constraints": {
    object (Constraints)
  },
  "editWindow": {
    object (Interval)
  },
  "lastEditor": enum (Editor)
}
Campos
startTime

string (Timestamp format)

Obligatorio. Es la fecha y hora de inicio programadas para la actualización.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
weeklyWindows[]

object (TimeWindow)

Obligatorio. Son los períodos semanales en los que se realizan las actividades de actualización. El servidor realiza actividades de actualización durante estos períodos para minimizar las interrupciones.
constraints

object (Constraints)

Solo salida. Solo salida. Son las restricciones aplicadas a la programación. Estas restricciones deben aplicarse en el momento de cualquier reprogramación.
editWindow

object (Interval)

Solo salida. Solo salida. El programa está abierto para realizar ediciones durante este intervalo o ventana.
lastEditor

enum (Editor)

Solo salida. Solo salida. Indica quién editó el programa de actualización más recientemente. El valor se actualiza cada vez que se reprograma la actualización.

TimeWindow

Representa el período para realizar actividades de actualización.

Representación JSON 
{
  "dayOfWeek": enum (DayOfWeek),
  "startTime": {
    object (TimeOfDay)
  },
  "duration": string
}
Campos
dayOfWeek

enum (DayOfWeek)

Obligatorio. Día de la semana para este período.
startTime

object (TimeOfDay)

Obligatorio. Fecha y hora en UTC en que comienza el período.
duration

string (Duration format)

Obligatorio. Es la duración del período. La duración máxima permitida para cualquier ventana es de 24 horas.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

DayOfWeek

Representa un día de la semana.

Enumeraciones
DAY_OF_WEEK_UNSPECIFIED No se especifica el día de la semana.
MONDAY Lunes
TUESDAY Martes
WEDNESDAY Miércoles
THURSDAY Jueves
FRIDAY Viernes
SATURDAY Sábado
SUNDAY Domingo

TimeOfDay

Representa una hora del día. La fecha y la zona horaria no son significativas o se especifican en otro lugar. Una API puede optar por permitir segundos bisiestos. Los tipos relacionados son google.type.Date y google.protobuf.Timestamp.

Representación JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Campos
hours

integer

Horas de un día en formato de 24 horas. Debe ser mayor o igual que 0 y, por lo general, debe ser menor o igual que 23. Una API puede permitir el valor “24:00:00” para casos como el horario de cierre de empresas.
minutes

integer

Minutos de una hora. Debe ser mayor o igual que 0 y menor o igual que 59.
seconds

integer

Segundos de un minuto. Debe ser mayor o igual que 0 y, por lo general, debe ser menor o igual que 59. Una API puede permitir el valor 60 si permite segundos bisiestos.
nanos

integer

Fracciones de segundos, en nanosegundos. Debe ser mayor o igual que 0 y menor o igual que 999,999,999.

Limitaciones

Son las restricciones que se aplicarán mientras se edita una programación. Estas restricciones garantizan que se cumplan los requisitos específicos de Upgrade.

Representación JSON 
{
  "minHoursDay": integer,
  "minHoursWeek": integer,
  "rescheduleDateRange": {
    object (Interval)
  },
  "disallowedIntervals": [
    {
      object (WeeklyTimeInterval)
    }
  ]
}
Campos
minHoursDay

integer

Solo salida. Se debe asignar una cantidad mínima de horas para las actividades de actualización de cada día seleccionado. Este es un mínimo; el programa de actualización puede asignar más horas para el día determinado.
minHoursWeek

integer

Solo salida. Se debe asignar la cantidad mínima de horas semanales para las actividades de actualización. Este es solo un mínimo; el programa puede asignar más horas semanales.
rescheduleDateRange

object (Interval)

Solo salida. Solo salida. El usuario solo puede reprogramar una actualización que comience dentro de este período.
disallowedIntervals[]

object (WeeklyTimeInterval)

Solo salida. Solo salida. Es una lista de intervalos en los que no se permiten los períodos de mantenimiento. Cualquier período que se superponga con alguno de estos intervalos se considerará no válido.

Intervalo

Representa un intervalo de tiempo, codificado como una marca de tiempo de inicio (inclusiva) y una marca de tiempo de finalización (exclusiva).

El inicio debe ser menor o igual que el final. Cuando el inicio es igual al final, el intervalo está vacío (no coincide con ninguna hora). Cuando no se especifican el inicio ni el final, el intervalo coincide con cualquier hora.

Representación JSON 
{
  "startTime": string,
  "endTime": string
}
Campos
startTime

string (Timestamp format)

Opcional. Es el inicio inclusivo del intervalo.

Si se especifica, la marca de tiempo que coincida con este intervalo deberá ser igual o posterior al inicio.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Opcional. Es el final exclusivo del intervalo.

Si se especifica, la marca de tiempo que coincida con este intervalo deberá ser anterior al final.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

WeeklyTimeInterval

Representa un intervalo de tiempo que abarca días de la semana. Hasta que se admitan las zonas horarias locales, este intervalo se expresará en UTC.

Representación JSON 
{
  "startDay": enum (DayOfWeek),
  "startTime": {
    object (TimeOfDay)
  },
  "endDay": enum (DayOfWeek),
  "endTime": {
    object (TimeOfDay)
  }
}
Campos
startDay

enum (DayOfWeek)

Solo salida. Día en que comienza el intervalo.
startTime

object (TimeOfDay)

Solo salida. Es la hora del día de inicio en la que comienza el intervalo.
endDay

enum (DayOfWeek)

Solo salida. Día en que finaliza el intervalo. Puede ser igual al día de inicio.
endTime

object (TimeOfDay)

Solo salida. Hora del día de finalización en la que termina el intervalo.

Editor

Valores posibles de quién editó el programa de actualización. El valor identifica grupos o entidades en lugar de personas.

Enums
EDITOR_UNSPECIFIED Es el valor predeterminado. Este valor nunca debe usarse.
SYSTEM El sistema o el servicio interno programan la actualización.
USER El usuario final programa la actualización.

VmwareUpgradeComponent

Recurso de actualización por componente

Representación JSON 
{
  "componentType": enum (VmwareComponentType),
  "state": enum (State)
}
Campos
componentType

enum (VmwareComponentType)

Solo salida. Tipo de componente
state

enum (State)

Solo salida. Es el estado de actualización del componente.

VmwareComponentType

Tipo de componente de VMware

Enums
VMWARE_COMPONENT_TYPE_UNSPECIFIED Es el valor predeterminado. Este valor nunca debe usarse.
VCENTER vcenter
ESXI Nodos de ESXi y nodos de transporte
NSXT_UC Coordinador de actualización de NSX-T
NSXT_EDGE Clúster de NSX-T Edge
NSXT_MGR Administradores o plano de administración de NSXT
HCX hcx
VSAN Clúster de vSAN
DVS Interruptor de DVS
NAMESERVER_VM VMs de Nameserver
KMS_VM VM de KMS que se usa para la encriptación de vSAN
WITNESS_VM VM testigo en caso de PC de expansión
NSXT nsxt
CLUSTER El clúster se usa en el caso de BM.
VM_TOOLS VMware Tools

Estado

El estado define el estado actual de una actualización.

Enums
STATE_UNSPECIFIED Es el valor predeterminado. Este valor nunca debe usarse.
RUNNING La actualización del componente está en curso
PAUSED Se pausó la actualización del componente. Se reanudará cuando se reanude el trabajo de actualización
SUCCEEDED La actualización del componente se completó correctamente
FAILED No se pudo actualizar el componente. Se reanudará si se reanuda la actualización o permanecerá como está.
NOT_STARTED Aún no comenzó la actualización del componente
NOT_APPLICABLE La actualización del componente no se aplica en esta actualización. Se omitirá.

Métodos

get

 Recupera un recurso Upgrade de nube privada por su nombre de recurso.

list

 Enumera los Upgrades pasados, en curso y próximos para la nube privada determinada.

patch

 Actualiza el recurso Upgrade de la nube privada.