REST Resource: projects.locations.hardware

Resource: Hardware

An instance of hardware installed at a site.

JSON representation 
{
  "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)
  }
}
Fields
name

string

Identifier. Name of this hardware. Format: projects/{project}/locations/{location}/hardware/{hardware}
displayName

string

Optional. Display name for this hardware.
createTime

string (Timestamp format)

Output only. Time when this hardware was created.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Output only. Time when this hardware was last updated.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".
labels

map (key: string, value: string)

Optional. Labels associated with this hardware as key value pairs. For more information about labels, see Create and manage labels.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
order

string

Required. Name of the order that this hardware belongs to. Format: projects/{project}/locations/{location}/orders/{order}
hardwareGroup

string

Output only. Name for the hardware group that this hardware belongs to. Format: projects/{project}/locations/{location}/orders/{order}/hardwareGroups/{hardwareGroup}
site

string

Required. Name for the site that this hardware belongs to. Format: projects/{project}/locations/{location}/sites/{site}
state

enum (State)

Output only. Current state for this hardware.
ciqUri

string

Output only. Link to the Customer Intake Questionnaire (CIQ) sheet for this Hardware.
config

object (HardwareConfig)

Required. Configuration for this hardware.
estimatedInstallationDate

object (Date)

Output only. Estimated installation date for this hardware.
physicalInfo

object (HardwarePhysicalInfo)

Optional. Physical properties of this hardware.
installationInfo

object (HardwareInstallationInfo)

Optional. Information for installation of this hardware.
zone

string

Required. Name for the zone that this hardware belongs to. Format: projects/{project}/locations/{location}/zones/{zone}
requestedInstallationDate

object (Date)

Optional. Requested installation date for this hardware. This is auto-populated when the order is accepted, if the hardware's HardwareGroup specifies this. It can also be filled in by the customer.
actualInstallationDate

object (Date)

Output only. Actual installation date for this hardware. Filled in by Google.

State

Valid states for hardware.

Enums
STATE_UNSPECIFIED State of the Hardware is unspecified.
ADDITIONAL_INFO_NEEDED More information is required from the customer to make progress.
BUILDING Google has initiated building hardware for this Hardware.
SHIPPING The hardware has been built and is being shipped.
INSTALLING The hardware is being installed.
INSTALLED The hardware has been installed.
FAILED An error occurred and customer intervention is required.

HardwarePhysicalInfo

Physical properties of a hardware.

JSON representation 
{
  "powerReceptacle": enum (PowerReceptacleType),
  "networkUplink": enum (NetworkUplinkType),
  "voltage": enum (Voltage),
  "amperes": enum (Amperes)
}
Fields
powerReceptacle

enum (PowerReceptacleType)

Required. The power receptacle type.
voltage

enum (Voltage)

Required. Voltage of the power supply.
amperes

enum (Amperes)

Required. Amperes of the power supply.

PowerReceptacleType

Valid power receptacle types.

Enums
POWER_RECEPTACLE_TYPE_UNSPECIFIED Facility plug type is unspecified.
NEMA_5_15 NEMA 5-15.
C_13 C13.
STANDARD_EU Standard european receptacle.

NetworkUplinkType

Valid network uplink types.

Enums
RJ_45 RJ-45.

Voltage

Valid voltage values.

Enums
VOLTAGE_UNSPECIFIED Voltage is unspecified.
VOLTAGE_110 120V.
VOLTAGE_220 220V.

Amperes

Valid amperes values.

Enums
AMPERES_UNSPECIFIED Amperes is unspecified.
AMPERES_15 15A.

HardwareInstallationInfo

Information for installation of a Hardware.

JSON representation 
{
  "rackLocation": string,
  "powerDistanceMeters": integer,
  "switchDistanceMeters": integer,
  "rackUnitDimensions": {
    object (Dimensions)
  },
  "rackSpace": {
    object (RackSpace)
  },
  "rackType": enum (RackType)
}
Fields
rackLocation

string

Optional. Location of the rack in the site e.g. Floor 2, Room 201, Row 7, Rack 3.
powerDistanceMeters

integer

Required. Distance from the power outlet in meters.
switchDistanceMeters

integer

Required. Distance from the network switch in meters.
rackUnitDimensions

object (Dimensions)

Required. Dimensions of the rack unit.
rackSpace

object (RackSpace)

Required. Rack space allocated for the hardware.
rackType

enum (RackType)

Required. Type of the rack.

Dimensions

Represents the dimensions of an object.

JSON representation 
{
  "widthInches": number,
  "heightInches": number,
  "depthInches": number
}
Fields
widthInches

number

Required. Width in inches.
heightInches

number

Required. Height in inches.
depthInches

number

Required. Depth in inches.

RackType

Valid rack types.

Enums
RACK_TYPE_UNSPECIFIED Rack type is unspecified.
TWO_POST Two post rack.
FOUR_POST Four post rack.

Methods

create

 Creates new hardware in a given project and location.

delete

 Deletes hardware.

get

 Gets hardware details.

list

 Lists hardware in a given project and location.

patch

 Updates hardware parameters.