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)
    }
  ]
}
欄位
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
(deprecated)

object (Date)

選用。已淘汰：所要求的安裝日期已移至 Order 資源。請改用 Order 資源的 customerRequestedInstallationDate。
actualInstallationDate

object (Date)

僅供輸出。這項硬體的實際安裝日期。由 Google 填入。
machineInfos[]

object (MachineInfo)

選用。啟動時需要每部機器的資產資訊。
estimatedDeliveryDate

object (Date)

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

boolean

僅供輸出。指出此硬體是否適用於 Gemini on GDC Software。
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 Type G / BS1363。
CEE_7_3 C 7/3。
CEE_7_5 C 7/5。
TYPE_F Type 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 兩柱型機架。
FOUR_POST 四柱型機架。

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

 表示硬體狀態。