REST Resource: projects.locations.hardware

リソース: Hardware

サイトに設置されたハードウェアのインスタンス。

JSON 表現 
{
  "name": string,
  "displayName": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "order": string,
  "hardwareGroup": string,
  "site": string,
  "state": enum (State),
  "ciqUri": string,
  "config": {
    object (HardwareConfig)
  },
  "estimatedInstallationDate": {
    object (Date)
  },
  "physicalInfo": {
    object (HardwarePhysicalInfo)
  },
  "installationInfo": {
    object (HardwareInstallationInfo)
  },
  "zone": string,
  "requestedInstallationDate": {
    object (Date)
  },
  "actualInstallationDate": {
    object (Date)
  },
  "machineInfos": [
    {
      object (MachineInfo)
    }
  ],
  "estimatedDeliveryDate": {
    object (Date)
  },
  "aiCapable": boolean,
  "subscriptionConfigs": [
    {
      object (SubscriptionConfig)
    }
  ],
  "operations": [
    {
      object (ResourceOperation)
    }
  ]
}
フィールド
name

string

ID。このハードウェアの名前。形式: projects/{project}/locations/{location}/hardware/{hardware}
displayName

string

省略可。このハードウェアの表示名。
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"。
labels

map (key: string, value: string)

省略可。このハードウェアに関連付けられたラベル（Key-Value ペア）。ラベルの詳細については、ラベルの作成と管理をご覧ください。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }。
order

string

必須。このハードウェアが属する注文の名前。形式: projects/{project}/locations/{location}/orders/{order}
hardwareGroup

string

出力専用。このハードウェアが属するハードウェア グループの名前。形式: projects/{project}/locations/{location}/orders/{order}/hardwareGroups/{hardwareGroup}
site

string

必須。このハードウェアが属するサイトの名前。形式: projects/{project}/locations/{location}/sites/{site}
state

enum (State)

出力専用。このハードウェアの現在の状態。
ciqUri

string

出力専用。このハードウェアのお客様情報アンケート（CIQ）シートへのリンク。
config

object (HardwareConfig)

必須。このハードウェアの構成。
estimatedInstallationDate

object (Date)

出力専用。このハードウェアの設置予定日。
physicalInfo

object (HardwarePhysicalInfo)

省略可。このハードウェアの物理的特性。
installationInfo

object (HardwareInstallationInfo)

省略可。このハードウェアの設置に関する情報。
zone

string

必須。このハードウェアが属するゾーンの名前。形式: projects/{project}/locations/{location}/zones/{zone}
requestedInstallationDate
(deprecated)

object (Date)

省略可。非推奨: リクエストされた設置日は Order リソースに移動しました。代わりに、Order リソースで customerRequestedInstallationDate を使用してください。
actualInstallationDate

object (Date)

出力専用。このハードウェアの実際の設置日。Google が記入します。
machineInfos[]

object (MachineInfo)

省略可。ターンアップに必要なマシンごとのアセット情報。
estimatedDeliveryDate

object (Date)

出力専用。ハードウェアの配送予定日。
aiCapable

boolean

出力専用。このハードウェアが GDC ソフトウェアの Gemini 用かどうかを示します。
subscriptionConfigs[]

object (SubscriptionConfig)

出力専用。このハードウェアのサブスクリプション構成。
operations[]

object (ResourceOperation)

出力専用。ハードウェアで実行されたすべてのオペレーションのリスト。

状態

ハードウェアの有効な状態。

列挙型
STATE_UNSPECIFIED ハードウェアの状態が指定されていません。
ADDITIONAL_INFO_NEEDED 次のステップに進むためにお客様からの追加情報が必要な場合
BUILDING Google は、このハードウェアのハードウェアの構築を開始しました。
SHIPPING ハードウェアは製造済みで、現在発送中です。
INSTALLING ハードウェアの設置中です。
INSTALLED ハードウェアが設置されている。
FAILED エラーが発生し、お客様の対応が必要です。
INFO_COMPLETE ハードウェアに必要な情報がすべて含まれている。
READY_FOR_PROVISIONING ハードウェアのプロビジョニングの準備が完了しました。
PROVISIONING_STARTED ハードウェアのプロビジョニングが開始されました。
PROVISIONING_FAILED ハードウェアのプロビジョニングに失敗しました。

HardwarePhysicalInfo

ハードウェアの物理的特性。

JSON 表現 
{
  "powerReceptacle": enum (PowerReceptacleType),
  "networkUplink": enum (NetworkUplinkType),
  "voltage": enum (Voltage),
  "amperes": enum (Amperes)
}
フィールド
powerReceptacle

enum (PowerReceptacleType)

必須。コンセントの種類。
voltage

enum (Voltage)

必須。電源の電圧。
amperes

enum (Amperes)

必須。電源のアンペア数。

PowerReceptacleType

有効なコンセントの種類。

列挙型
POWER_RECEPTACLE_TYPE_UNSPECIFIED 施設のプラグの種類が指定されていません。
NEMA_5_15 NEMA 5-15。
C_13 C13.
STANDARD_EU

非推奨: 代わりに TYPE_G_BS1363、CEE_7_3、CEE_7_5、TYPE_F のいずれかを使用してください。
TYPE_G_BS1363 タイプ G / BS1363。
CEE_7_3 C 7/3。
CEE_7_5 C 7/5。
TYPE_F タイプ F。

NetworkUplinkType

有効なネットワーク アップリンク タイプ。

列挙型
RJ_45 RJ-45。

電圧

有効な電圧値。

列挙型
VOLTAGE_UNSPECIFIED 電圧が指定されていません。
VOLTAGE_110 120V。
VOLTAGE_220 220V。

アンペア

有効なアンペア値。

列挙型
AMPERES_UNSPECIFIED アンペア数が指定されていません。
AMPERES_15 15A.

HardwareInstallationInfo

ハードウェアの設置に関する情報。

JSON 表現 
{
  "rackLocation": string,
  "powerDistanceMeters": integer,
  "switchDistanceMeters": integer,
  "rackUnitDimensions": {
    object (Dimensions)
  },
  "rackSpace": {
    object (RackSpace)
  },
  "rackType": enum (RackType)
}
フィールド
rackLocation

string

省略可。サイト内のラックの場所（例: 2 階、201 号室、7 列目、3 ラック）。
powerDistanceMeters

integer

必須。コンセントからの距離（メートル）。
switchDistanceMeters

integer

必須。ネットワーク スイッチからの距離（メートル）。
rackUnitDimensions

object (Dimensions)

省略可。ラックユニットのサイズ。
rackSpace

object (RackSpace)

省略可。ハードウェアに割り当てられたラックスペース。
rackType

enum (RackType)

必須。ラックのタイプ。

ディメンション

オブジェクトの寸法を表します。

JSON 表現 
{
  "widthInches": number,
  "heightInches": number,
  "depthInches": number
}
フィールド
widthInches

number

必須。幅（インチ単位）。
heightInches

number

必須。身長（インチ）。
depthInches

number

必須。深さ（インチ）。

RackType

有効なラックタイプ。

列挙型
RACK_TYPE_UNSPECIFIED ラックのタイプが指定されていません。
TWO_POST 2 ポストラック。
FOUR_POST 4 ポストラック。

MachineInfo

個々のマシンのベンダーがターンアップ時に提供する情報。

JSON 表現 
{
  "serviceTag": string,
  "macAddresses": [
    {
      object (MacAddress)
    }
  ],
  "name": string,
  "diskInfos": [
    {
      object (DiskInfo)
    }
  ],
  "machineType": enum (MachineType),
  "tpmEkCertHash": string,
  "gpuSerialNumbers": [
    string
  ],
  "cpuSerialNumbers": [
    string
  ],
  "memoryInfos": [
    {
      object (MemoryInfo)
    }
  ],
  "idracMacAddress": string,
  "nicSerialNumbers": [
    string
  ]
}
フィールド
serviceTag

string

省略可。マシンのサービスタグ。
macAddresses[]

object (MacAddress)

出力専用。関連付けられた各 MAC アドレス。
name

string

出力専用。マシン名。
diskInfos[]

object (DiskInfo)

省略可。インストールされている各ディスクの情報。
machineType

enum (MachineType)

省略可。マシンタイプ。GDC ソフトウェアで Gemini を実行するハードウェアに必要です。
tpmEkCertHash

string

省略可。TPM EK 証明書ハッシュ。ハードウェアの修理時に必要です。
gpuSerialNumbers[]

string

省略可。GPU のシリアル番号。ハードウェアの修理時に必要です。
cpuSerialNumbers[]

string

省略可。CPU のシリアル番号。ハードウェアの修理時に必要です。
memoryInfos[]

object (MemoryInfo)

省略可。インストールされている各メモリの情報。ハードウェアの修理時に必要です。
idracMacAddress

string

省略可。iDRAC MAC アドレス。ハードウェアの修理時に必要です。
nicSerialNumbers[]

string

省略可。NIC のシリアル番号。ハードウェアの修理時に必要です。

MacAddress

マシンの MAC アドレスを説明するメッセージ。

JSON 表現 
{
  "address": string,
  "type": enum (AddressType),
  "ipv4Address": string
}
フィールド
address

string

出力専用。アドレス文字列。
type

enum (AddressType)

出力専用。この MAC アドレスのアドレス タイプ。
ipv4Address

string

出力専用。MAC アドレスに関連付けられている静的 IP アドレス（使用されている場合）。VIRTUAL MAC アドレス タイプにのみ適用されます。

AddressType

さまざまなタイプの MAC アドレスの列挙型。

列挙型
ADDRESS_TYPE_UNSPECIFIED 住所のタイプが指定されていません。
NIC ネットワーク インターフェース カードのアドレス。
BMC ベースボード管理コントローラの住所。
VIRTUAL 仮想インターフェースのアドレス。

DiskInfo

マシン上の個々のディスクに関する情報。

JSON 表現 
{
  "manufacturer": string,
  "slot": integer,
  "serialNumber": string,
  "psid": string,
  "partNumber": string,
  "modelNumber": string
}
フィールド
manufacturer

string

省略可。ディスクのメーカー。
slot

integer

省略可。ディスク スロット番号。
serialNumber

string

省略可。ディスクのシリアル番号。
psid

string

省略可。ディスクの PSID。
partNumber

string

省略可。ディスクの部品番号。
modelNumber

string

省略可。ディスクのモデル番号。

MachineType

Gemini on GDC Software に使用されるマシンタイプの列挙型。

列挙型
MACHINE_TYPE_UNSPECIFIED マシンタイプが指定されていません。
DELL_XE9680 Dell XE9680 サーバー。
DELL_XE9780 Dell XE9780 サーバー。

MemoryInfo

マシン上の個々のメモリに関する情報。

JSON 表現 
{
  "serialNumber": string,
  "sizeBytes": string,
  "partNumber": string
}
フィールド
serialNumber

string

省略可。メモリのシリアル番号。
sizeBytes

string (int64 format)

省略可。メモリサイズ。
partNumber

string

省略可。メモリの部品番号。

ResourceOperation

リソースの進行中のオペレーションを表します

JSON 表現 
{
  "uid": string,
  "state": enum (State),
  "type": enum (Type),
  "stateHistory": [
    {
      object (StateHistoryEntry)
    }
  ],
  "requiresReTurnup": boolean
}
フィールド
uid

string

出力専用。オペレーション ID。
state

enum (State)

出力専用。オペレーションの状態。
type

enum (Type)

出力専用。操作のタイプ。
stateHistory[]

object (StateHistoryEntry)

出力専用。オペレーションの状態履歴。
requiresReTurnup

boolean

出力専用。再ターンアップが必要かどうかを示すフラグ。

状態

オペレーションの状態の列挙型。

列挙型
STATE_UNSPECIFIED オペレーションの状態が指定されていません。
AWAITING_CUSTOMER_INPUT 操作は顧客の入力を待っています。
PROGRESSING オペレーションは実行中です。
COMPLETED 操作は完了しました。

タイプ

オペレーション タイプの列挙型。

列挙型
TYPE_UNSPECIFIED 指定されていないオペレーション タイプ。
REPAIR 修復オペレーション。

StateHistoryEntry

オペレーション状態の履歴のエントリ。

JSON 表現 
{
  "state": enum (State),
  "updateTime": string,
  "reason": string,
  "responsibleEntity": enum (Entity)
}
フィールド
state

enum (State)

出力専用。オペレーションの状態。
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"。
reason

string

出力専用。状態変更の理由。
responsibleEntity

enum (Entity)

出力専用。状態を変更したエンティティ。

メソッド

changeSubscription

 ハードウェアのサブスクリプション構成を更新します。

create

 指定されたプロジェクトとロケーションに新しいハードウェアを作成します。

delete

 ハードウェアを削除します。

get

 ハードウェアの詳細を取得します。

list

 指定されたプロジェクトとロケーションのハードウェアを一覧表示します。

patch

 ハードウェア パラメータを更新します。

signal

 ハードウェアの状態を通知します。