REST Resource: projects.locations.privateClouds.upgrades

リソース: Upgrade

プライベート クラウドのアップグレードについて説明します。

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 のリソース名。リソース名は、https://cloud.google.com/apis/design/resource_names の規則に従ったスキームレス URI です。（例: 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)

出力専用。出力のみ。アップグレードの推定合計時間。この情報は、中断を最小限に抑えるためにアップグレードを計画またはスケジュールするために使用できます。推定所要時間はあくまで目安です。実際のアップグレード時間は異なる場合があります。

s で終わる小数 9 桁までの秒単位の期間。例: "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 正規化され、小数点以下は 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)

必須。ウィンドウが開始する時刻（UTC）。
duration

string (Duration format)

必須。ウィンドウの期間。ウィンドウの最大許容期間は 24 時間です。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"。

DayOfWeek

曜日を表します。

列挙型
DAY_OF_WEEK_UNSPECIFIED 曜日は指定されていません。
MONDAY 月曜日
TUESDAY 火曜日
WEDNESDAY Wednesday
THURSDAY 木曜日
FRIDAY 金曜日
SATURDAY 土曜日
SUNDAY 日曜日

TimeOfDay

1 日のうちの時間を表します。日付とタイムゾーンは重要ではないか、他の場所で指定されています。API は、うるう秒を許可するようにできます。関連する型は、google.type.Date と google.protobuf.Timestamp です。

JSON 表現 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
フィールド
hours

integer

1 日の時間（24 時間形式）。0 以上にする必要があります。通常は 23 以下にする必要があります。API ではビジネスの終了時間などのシナリオにおいて、値 "24:00:00" を許可することもできます。
minutes

integer

1 時間の分。0 以上 59 以下にする必要があります。
seconds

integer

1 分の秒数。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

出力専用。アップグレード アクティビティには、1 週間の最小時間数を割り当てる必要があります。これは最小値であり、スケジュールでは週単位の時間をさらに割り当てることができます。
rescheduleDateRange

object (Interval)

出力専用。出力のみ。この範囲内で開始されるアップグレードのみを再スケジュールできます。
disallowedIntervals[]

object (WeeklyTimeInterval)

出力専用。出力のみ。メンテナンスの時間枠が許可されていない期間のリスト。これらの間隔と重複する時間枠は無効と見なされます。

間隔

時間間隔を表します。開始日時を示す Timestamp（この日時を含む）と終了日時を示す Timestamp（この日時を含まない）としてエンコードされます。

開始日時は終了日時以前にする必要があります。開始日時と終了日時が同じ場合、時間間隔は空になります（どの時間とも一致しません）。開始日時と終了日時が両方とも指定されていない場合、その時間間隔はすべての時間と一致します。

JSON 表現 
{
  "startTime": string,
  "endTime": string
}
フィールド
startTime

string (Timestamp format)

省略可。時間間隔の開始日時（この日時を含む）。

指定した場合、開始日時と同じかそれ以降の Timestamp がこの時間間隔に一致します。

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)

省略可。時間間隔の終了日時（この日時を含まない）。

指定した場合、終了時刻より前の Timestamp がこの時間間隔に一致します。

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

曜日をまたぐ時間間隔を表します。現地時間のタイムゾーンがサポートされるまでは、この間隔は 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 Upgrade Coordinator
NSXT_EDGE NSX-T Edge クラスタ
NSXT_MGR NSXT Manager/管理プレーン
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 はアップグレードの現在の状態を定義します

列挙型
STATE_UNSPECIFIED デフォルト値。この値は使用しないでください。
RUNNING コンポーネントのアップグレードが進行中
PAUSED コンポーネントのアップグレードが一時停止しています。アップグレード ジョブが再開されると再開されます
SUCCEEDED コンポーネントのアップグレードが正常に完了しました
FAILED コンポーネントのアップグレードが失敗しました。アップグレードが再開されると再開に移行し、再開されない場合はそのままになります
NOT_STARTED コンポーネントのアップグレードがまだ開始されていない
NOT_APPLICABLE このアップグレードでは、コンポーネントのアップグレードは適用されません。スキップされます。

メソッド

get

 リソース名でプライベート クラウド Upgrade リソースを取得します。

list

 指定されたプライベート クラウドの過去、進行中、今後の Upgrades を一覧表示します。

patch

 プライベート クラウドの Upgrade リソースを更新します。