REST Resource: projects.locations.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

出力専用。このハードウェアが Gemini on GDC ソフトウェア用かどうかを示します。
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 ソフトウェアを実行するハードウェアに必要です。
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

GDC ソフトウェアの Gemini で使用されるマシンタイプの列挙型。

列挙型
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 データとして提供されたハードウェア構成を検証します。