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)
    }
  ],
  "errors": [
    {
      object (Status)
    }
  ],
  "shippingInfo": {
    object (ShippingInfo)
  }
}
フィールド
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)

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

object (Status)

出力専用。ハードウェア インテントのターンアップ中に発生したエラー。ErrorInfo メタデータには、タイムスタンプとエラーが再試行可能かどうかが含まれます。
shippingInfo

object (ShippingInfo)

出力専用。このハードウェアの配送情報。

状態

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

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

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)

省略可。マシンタイプ。Gemini on GDC Software を実行するハードウェアに必要です。
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

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

ShippingInfo

ShippingInfo は、配送の物流情報を記述します。

JSON 表現 
{
  "carrier": enum (Carrier),
  "trackingId": string
}
フィールド
carrier

enum (Carrier)

出力専用。配送業者。
trackingId

string

出力専用。配送のトラッキング ID。

携帯通信会社

運送業者のリスト。

列挙型
CARRIER_UNSPECIFIED 携帯通信会社が指定されていません。
FEDEX 配送業者は FedEx です。
UPS 配送業者は UPS です。
USPS 運送業者は USPS です。

メソッド

changeSubscription

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

create

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

delete

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

get

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

list

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

patch

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

signal

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

validate

 JSON データとして提供されたハードウェア構成を検証します。