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)
    }
  ]
}
フィールド
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

object (Date)

省略可。このハードウェアの設置希望日。指定しない場合、送信時に注文の fulfillmentTime から、または注文の承認時に HardwareGroup の requestedInstallationDate から自動的に入力されます。
actualInstallationDate

object (Date)

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

object (MachineInfo)

出力専用。ターンアップに必要なマシンごとのアセット情報。

状態

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

列挙型
STATE_UNSPECIFIED ハードウェアの状態が指定されていません。
ADDITIONAL_INFO_NEEDED 次のステップに進むためにお客様からの追加情報が必要な場合
BUILDING Google は、このハードウェアのハードウェアの構築を開始しました。
SHIPPING ハードウェアは製造済みで、現在発送中です。
INSTALLING ハードウェアの設置中です。
INSTALLED ハードウェアが設置されている。
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 ヨーロッパの標準コンセント。

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)
    }
  ]
}
フィールド
serviceTag

string

出力専用。マシンのサービスタグ。
macAddresses[]

object (MacAddress)

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

string

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

object (DiskInfo)

出力専用。インストールされている各ディスクの情報。

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

出力専用。ディスクのモデル番号。

メソッド

create

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

delete

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

get

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

list

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

patch

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