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

僅供輸出。ID。私有雲的資源名稱 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 正規化，並使用 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 正規化，並使用 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 正規化，並使用 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)

僅供輸出。僅供輸出。預估升級總時長。這項資訊可用於規劃或安排升級作業，盡量減少中斷情況。請注意，預估時間僅為估計值，實際升級時間可能有所不同。

時間長度以秒為單位，最多可有 9 個小數位數，並應以「s」結尾，例如："3.5s"。
schedule

object (Schedule)

升級排程詳細資料。
version

string

僅供輸出。
etag

string

升級資源的 etag。如果更新時提供這項資訊，則必須與伺服器的 etag 相符。
uid

string

僅供輸出。系統為資源產生的專屬 ID。
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 正規化，並使用 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 小時。

時間長度以秒為單位，最多可有 9 個小數位數，並應以「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 允許閏秒，則可允許值為 60。
nanos

integer

秒數的小數，以奈秒為單位。必須大於或等於 0，且小於或等於 999,999,999。

限制

編輯排程時要套用的限制。這些限制可確保符合Upgrade特定需求。

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

integer

僅供輸出。您必須為所選的每一天，分配至少幾小時來進行升級活動。這是最低時數，升級時間表可能會為指定日期分配更多時數。
minHoursWeek

integer

僅供輸出。升級活動每週至少須分配 20 小時。這只是最低時數，時間表可指派更多每週時數。
rescheduleDateRange

object (Interval)

僅供輸出。僅供輸出。使用者只能重新安排在此時間範圍內開始的升級作業。
disallowedIntervals[]

object (WeeklyTimeInterval)

僅供輸出。僅供輸出。維護期間不得使用的時間間隔清單。凡是與上述任何間隔重疊的時間範圍，都會視為無效。

時間間隔

代表時間間隔，編碼以一個時間戳記開始 (含)，一個時間戳記結束 (不含)。

開始時間必須小於或等於結束時間。如果開始時間等於結束時間，間隔會是空白 (不符合任何時間)。如果開始和結束時間都未指定，則間隔會符合任何時間。

JSON 表示法 
{
  "startTime": string,
  "endTime": string
}
欄位
startTime

string (Timestamp format)

選用。間隔的開始時間 (含)。

如果指定了這個值，符合此間隔的時間戳記必須等於或晚於開始時間。

使用 RFC 3339，產生的輸出內容一律會經過 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 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

WeeklyTimeInterval

代表一段時間間隔，涵蓋一週的某幾天。在支援當地時區前，這個間隔會以世界標準時間為準。

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 Edge 叢集
NSXT_MGR NSX-T 管理工具/管理層
HCX hcx
VSAN VSAN 叢集
DVS DVS 切換
NAMESERVER_VM 網域名稱伺服器 VM
KMS_VM 用於 vSAN 加密的 KMS VM
WITNESS_VM 在延展 PC 的情況下，見證 VM
NSXT nsxt
CLUSTER 叢集用於 BM
VM_TOOLS VMware Tools。

狀態

「狀態」定義升級的目前狀態

列舉
STATE_UNSPECIFIED 預設值。請一律不要使用這個值。
RUNNING 正在升級元件
PAUSED 元件升級作業已暫停。升級作業繼續執行時，就會繼續
SUCCEEDED 元件升級作業已順利完成
FAILED 元件升級失敗。如果升級作業繼續執行，這個狀態會變更為「繼續」，否則會維持不變
NOT_STARTED 元件升級尚未開始
NOT_APPLICABLE 本次升級不適用於元件升級。系統會略過該檔案。

方法

get

 依資源名稱擷取 Private Cloud Upgrade 資源。

list

 列出指定私有雲的過去、進行中和即將進行的 Upgrades。

patch

 更新私有雲 Upgrade 資源。