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)
  }
}
欄位
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 組合清單的物件，範例：{ "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)

僅供輸出。啟動時需要每部機器的資產資訊。
estimatedDeliveryDate

object (Date)

僅供輸出。硬體的預計送達日期。

狀態

硬體的有效狀態。

列舉
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 兩柱型機架。
FOUR_POST 四柱型機架。

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 位址 (如有)。僅適用於虛擬 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

 更新硬體參數。