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

string

标识符。相应硬件的名称。格式：projects/{project}/locations/{location}/hardware/{hardware}
displayName

string

可选。相应硬件的显示名称。
createTime

string (Timestamp format)

仅限输出。相应硬件的创建时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
updateTime

string (Timestamp format)

仅限输出。相应硬件上次更新的时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
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)

可选。相应硬件的请求安装日期。如果硬件的 HardwareGroup 指定了此属性，则在接受订单时会自动填充此属性。也可以由客户填写。
actualInstallationDate

object (Date)

仅限输出。相应硬件的实际安装日期。由 Google 填写。

州

硬件的有效状态。

枚举
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 四立柱机架。

方法

create

 在给定的项目和位置中创建新硬件。

delete

 删除硬件。

get

 获取硬件详细信息。

list

 列出给定项目和位置中的硬件。

patch

 更新硬件参数。