REST Resource: projects.locations.privateClouds.upgrades

资源：升级

介绍了私有云升级。

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
}
字段
name

string

仅限输出。标识符。私有云 Upgrade 的资源名称。资源名称是无方案 URI，遵循 https://cloud.google.com/apis/design/resource_names 中的惯例。例如：projects/my-project/locations/us-west1-a/privateClouds/my-cloud/upgrades/my-upgrade
createTime

string (Timestamp format)

仅限输出。仅限输出。相应资源的创建时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
updateTime

string (Timestamp format)

仅限输出。仅限输出。相应资源的上次更新时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
endTime

string (Timestamp format)

仅限输出。仅限输出。升级的结束时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
state

enum (State)

仅限输出。升级的当前状态。
type

enum (Type)

仅限输出。仅限输出。升级类型。
description

string

仅限输出。仅限输出。升级说明。用于提供有关私有云升级的其他信息，例如升级的目的、升级中包含的更改或有关升级的任何其他相关信息。
estimatedDuration

string (Duration format)

仅限输出。仅限输出。升级的估计总时长。您可以利用这些信息来规划或安排升级，以最大限度减少中断。请注意，预计时长只是估算值。实际升级时长可能会有所不同。

该时长以秒为单位，最多包含九个小数位，以“s”结尾。示例："3.5s"。
schedule

object (Schedule)

升级的时间安排详情。
version

string

仅限输出。
etag

string

升级资源的 etag。如果在更新时提供，则必须与服务器的 ETag 相匹配。
uid

string

仅限输出。系统为资源生成的唯一标识符。
componentUpgrades[]

object (VmwareUpgradeComponent)

仅限输出。仅限输出。组件升级列表。
startVersion

string

仅限输出。仅限输出。起始版本
targetVersion

string

仅限输出。仅限输出。目标版本

州

私有云 Upgrade 的可能状态。

枚举
STATE_UNSPECIFIED 默认值。不应使用此值。
SCHEDULED 升级已安排，但尚未开始。
ONGOING 升级目前正在进行中，尚未完成。
SUCCEEDED 升级已成功完成。
PAUSED 升级目前已暂停。
FAILED 升级失败。
CANCELLING 正在取消升级。
CANCELLED 升级已取消。
RESCHEDULING 正在重新安排升级时间。

类型

可能的升级类型。未来可以添加更多类型。

枚举
TYPE_UNSPECIFIED 默认值。不应使用此值。
VSPHERE_UPGRADE 在有主要版本可用时升级 VMware 组件。7.0u2 -> 7.0u3。
VSPHERE_PATCH 在次要版本可用时，对 VMware 组件进行修补。7.0u2c -> 7.0u2d。
WORKAROUND 解决方法是针对漏洞或问题的临时修复，用于缓解已知漏洞或问题，直到发布补丁或更新为止。升级说明中会提供更多详细信息。
FIRMWARE_UPGRADE 私有云中使用的 VMware 产品的固件升级。
SWITCH_UPGRADE 交换机升级。
OTHER 不属于任何其他类别的升级类型。
INFRASTRUCTURE_UPGRADE BM 节点维护中的基础设施升级。

时间表

安排升级时间。

JSON 表示法 
{
  "startTime": string,
  "weeklyWindows": [
    {
      object (TimeWindow)
    }
  ],
  "constraints": {
    object (Constraints)
  },
  "editWindow": {
    object (Interval)
  },
  "lastEditor": enum (Editor)
}
字段
startTime

string (Timestamp format)

必需。升级的预定开始时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
weeklyWindows[]

object (TimeWindow)

必需。升级活动的每周时间窗口。服务器会在这些时间窗口内执行升级活动，以尽量减少中断。
constraints

object (Constraints)

仅限输出。仅限输出。应用于日程的限制。这些限制应在任何重新安排时间时适用。
editWindow

object (Interval)

仅限输出。仅限输出。在此时间间隔或窗口期间，您可以修改日程。
lastEditor

enum (Editor)

仅限输出。仅限输出。指明最近编辑升级时间表的人员。每当升级重新安排时间时，该值都会更新。

TimeWindow

表示执行升级活动的时间窗口。

JSON 表示法 
{
  "dayOfWeek": enum (DayOfWeek),
  "startTime": {
    object (TimeOfDay)
  },
  "duration": string
}
字段
dayOfWeek

enum (DayOfWeek)

必需。相应窗口的星期几。
startTime

object (TimeOfDay)

必需。时段开始时间（世界协调时间）。
duration

string (Duration format)

必需。窗口的时长。任何窗口允许的最大时长为 24 小时。

该时长以秒为单位，最多包含九个小数位，以“s”结尾。示例："3.5s"。

DayOfWeek

表示星期几。

枚举
DAY_OF_WEEK_UNSPECIFIED 未指定星期几。
MONDAY 星期一
TUESDAY 星期二
WEDNESDAY 星期三
THURSDAY 星期四
FRIDAY 星期五
SATURDAY 星期六
SUNDAY 星期日

TimeOfDay

表示一天中的某个时间。日期和时区不重要，或在别处指定。API 可以选择允许闰秒。相关类型为 google.type.Date 和 google.protobuf.Timestamp。

JSON 表示法 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
字段
hours

integer

一天中的小时（采用 24 小时制）。必须大于或等于 0，且通常必须小于或等于 23。对于业务结束时间等场景，API 可以选择允许“24:00:00”一值。
minutes

integer

一小时中的分钟数。必须大于或等于 0，且小于或等于 59。
seconds

integer

一分钟中的秒数。必须大于或等于 0，通常必须小于或等于 59。如果 API 允许闰秒，则 API 可以允许 60 一值。
nanos

integer

秒数的小数部分（以纳秒为单位）。必须大于或等于 0，且小于或等于 999,999,999。

限制条件

在修改日程时要应用的限制。这些限制条件可确保满足Upgrade特定要求。

JSON 表示法 
{
  "minHoursDay": integer,
  "minHoursWeek": integer,
  "rescheduleDateRange": {
    object (Interval)
  },
  "disallowedIntervals": [
    {
      object (WeeklyTimeInterval)
    }
  ]
}
字段
minHoursDay

integer

仅限输出。必须为每个所选日期的升级活动分配最少的小时数。这是最低限度；升级时间表可以为指定日期分配更多小时。
minHoursWeek

integer

仅限输出。必须为升级活动分配每周最少的小时数。这只是最低限度，时间表可以安排更多每周小时数。
rescheduleDateRange

object (Interval)

仅限输出。仅限输出。用户只能重新安排在此时间范围内开始的升级。
disallowedIntervals[]

object (WeeklyTimeInterval)

仅限输出。仅限输出。不允许进行维护的时间段列表。与上述任何时间段重叠的任何时间窗口都将被视为无效。

间隔

表示时间间隔，以开始时间戳（含）和结束时间戳（不含）的形式编码。

开始时间必须早于或等于结束时间。如果开始时间与结束时间相同，则时间间隔为空（不会匹配任何时间）。如果开始时间和结束时间都未指定，则时间间隔会匹配任何时间。

JSON 表示法 
{
  "startTime": string,
  "endTime": string
}
字段
startTime

string (Timestamp format)

可选。时间间隔的开始时间（含）。

如果指定，则与此时间间隔匹配的时间戳必须等于或晚于开始时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
endTime

string (Timestamp format)

可选。时间间隔的结束时间（不含）。

如果指定，则与此时间间隔匹配的时间戳必须早于结束时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

WeeklyTimeInterval

表示一个时间间隔，跨越一周中的几天。在支持本地时区之前，此时间间隔采用的是 UTC。

JSON 表示法 
{
  "startDay": enum (DayOfWeek),
  "startTime": {
    object (TimeOfDay)
  },
  "endDay": enum (DayOfWeek),
  "endTime": {
    object (TimeOfDay)
  }
}
字段
startDay

enum (DayOfWeek)

仅限输出。间隔的开始日期。
startTime

object (TimeOfDay)

仅限输出。开始日期当天间隔的开始时间。
endDay

enum (DayOfWeek)

仅限输出。间隔结束的日期。可以与开始日期相同。
endTime

object (TimeOfDay)

仅限输出。结束日期当天的时间间隔结束时间。

编辑者

谁修改了升级计划的值。该值用于标识群组或实体，而不是个人。

枚举
EDITOR_UNSPECIFIED 默认值。不应使用此值。
SYSTEM 升级由系统或内部服务安排。
USER 升级由最终用户安排。

VmwareUpgradeComponent

每个组件的升级资源

JSON 表示法 
{
  "componentType": enum (VmwareComponentType),
  "state": enum (State)
}
字段
componentType

enum (VmwareComponentType)

仅限输出。组件类型
state

enum (State)

仅限输出。组件的升级状态。

VmwareComponentType

VMware 组件的类型

枚举
VMWARE_COMPONENT_TYPE_UNSPECIFIED 默认值。不应使用此值。
VCENTER vcenter
ESXI ESXi 节点 + 传输节点
NSXT_UC NSX-T 升级协调器
NSXT_EDGE NSX-T 边缘集群
NSXT_MGR NSXT 管理器/管理平面
HCX hcx
VSAN VSAN 集群
DVS DVS 开关
NAMESERVER_VM 域名服务器虚拟机
KMS_VM 用于 VSAN 加密的 KMS 虚拟机
WITNESS_VM 在拉伸 PC 的情况下，见证虚拟机
NSXT nsxt
CLUSTER 在 BM 的情况下使用集群
VM_TOOLS VMware Tools。

州

State 用于定义升级的当前状态

枚举
STATE_UNSPECIFIED 默认值。不应使用此值。
RUNNING 组件正在升级
PAUSED 相应组件的升级已暂停。将在升级作业恢复后恢复
SUCCEEDED 组件升级已成功完成
FAILED 组件升级失败。如果升级恢复，则会改为“恢复”；否则保持不变
NOT_STARTED 组件的升级尚未开始
NOT_APPLICABLE 相应组件的升级不适用于此次升级。系统将跳过该文件。

方法

get

 按资源名称检索私有云 Upgrade 资源。

list

 列出指定私有云的过去、正在进行和即将进行的 Upgrades。

patch

 更新私有云 Upgrade 资源。