REST Resource: projects.locations.hardware

• 资源：硬件
  • JSON 表示法
• 州/省/直辖市/自治区
• HardwarePhysicalInfo
  • JSON 表示法
• PowerReceptacleType
• NetworkUplinkType
• 电压
• 安培
• HardwareInstallationInfo
  • JSON 表示法
• 维度
  • JSON 表示法
• RackType
• MachineInfo
  • JSON 表示法
• MacAddress
  • JSON 表示法
• AddressType
• DiskInfo
  • JSON 表示法
• MachineType
• MemoryInfo
  • JSON 表示法
• ResourceOperation
  • JSON 表示法
• 州/省/直辖市/自治区
• 类型
• StateHistoryEntry
  • JSON 表示法
• 方法

资源：硬件

安装在现场的硬件实例。

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 标识符。相应硬件的名称。格式：projects/{project}/locations/{location}/hardware/{hardware}
displayName	string 可选。相应硬件的显示名称。
createTime	string (Timestamp format) 仅限输出。相应硬件的创建时间。 采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 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 规范化（即转换为 UTC 零时区格式并在末尾附加 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 仅限输出。指示相应硬件是否适用于 GDC 软件上的 Gemini。
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) 必需。电源插座类型。
networkUplink	enum (NetworkUplinkType) 必需。上行网络连接的类型。
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

有效的网络上行类型。

枚举
NETWORK_UPLINK_TYPE_UNSPECIFIED	未指定网络上行类型。
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) 可选。机器类型。对于在 GDC 软件上运行 Gemini 的硬件，此项是必需的。
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

用于 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 可选。内存部件号。

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 规范化（即转换为 UTC 零时区格式并在末尾附加 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	表示硬件的状态。