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)
    }
  ]
}
字段
name

string

标识符。相应硬件的名称。格式：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)

仅限输出。启动所需的每台机器资产信息。

州

硬件的有效状态。

枚举
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

 更新硬件参数。