REST Resource: projects.locations.hardware

Ressource: Hardware

Eine Hardwareinstanz, die an einem Standort installiert ist.

JSON-Darstellung 
{
  "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)
    }
  ],
  "errors": [
    {
      object (Status)
    }
  ],
  "shippingInfo": {
    object (ShippingInfo)
  }
}
Felder
name

string

ID. Name dieser Hardware. Format: projects/{project}/locations/{location}/hardware/{hardware}
displayName

string

Optional. Anzeigename für diese Hardware.
createTime

string (Timestamp format)

Nur Ausgabe. Zeitpunkt, zu dem diese Hardware erstellt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
updateTime

string (Timestamp format)

Nur Ausgabe. Zeitpunkt, zu dem diese Hardware zuletzt aktualisiert wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
labels

map (key: string, value: string)

Optional. Labels, die dieser Hardware als Schlüssel/Wert-Paare zugeordnet sind. Weitere Informationen zu Labels finden Sie unter Labels erstellen und verwalten.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
order

string

Optional. Name der Bestellung, zu der diese Hardware gehört. Format: projects/{project}/locations/{location}/orders/{order}
hardwareGroup

string

Nur Ausgabe. Name der Hardwaregruppe, zu der diese Hardware gehört. Format: projects/{project}/locations/{location}/orders/{order}/hardwareGroups/{hardwareGroup}
site

string

Erforderlich. Name des Standorts, zu dem diese Hardware gehört. Format: projects/{project}/locations/{location}/sites/{site}
state

enum (State)

Nur Ausgabe. Aktueller Status dieser Hardware.
ciqUri

string

Nur Ausgabe. Link zum CIQ-Formular (Customer Intake Questionnaire) für diese Hardware.
config

object (HardwareConfig)

Erforderlich. Konfiguration für diese Hardware.
estimatedInstallationDate

object (Date)

Nur Ausgabe. Geschätztes Installationsdatum für diese Hardware.
physicalInfo

object (HardwarePhysicalInfo)

Optional. Physische Attribute dieser Hardware.
installationInfo

object (HardwareInstallationInfo)

Optional. Informationen zur Installation dieser Hardware.
zone

string

Erforderlich. Name der Zone, zu der diese Hardware gehört. Format: projects/{project}/locations/{location}/zones/{zone}
requestedInstallationDate
(deprecated)

object (Date)

Optional. Eingestellt: Das gewünschte Installationsdatum wurde in die Ressource „Order“ verschoben. Verwenden Sie stattdessen customerRequestedInstallationDate für die Order-Ressource.
actualInstallationDate

object (Date)

Nur Ausgabe. Tatsächliches Installationsdatum für diese Hardware. Von Google ausgefüllt.
machineInfos[]

object (MachineInfo)

Optional. Informationen zu den einzelnen Maschinen-Assets, die für die Aktivierung erforderlich sind.
estimatedDeliveryDate

object (Date)

Nur Ausgabe. Das voraussichtliche Lieferdatum der Hardware.
aiCapable

boolean

Nur Ausgabe. Gibt an, ob diese Hardware für Gemini on GDC Software bestimmt ist.
subscriptionConfigs[]

object (SubscriptionConfig)

Nur Ausgabe. Abokonfigurationen für diese Hardware.
operations[]

object (ResourceOperation)

Nur Ausgabe. Liste aller an der Hardware ausgeführten Vorgänge.
errors[]

object (Status)

Nur Ausgabe. Die Fehler, die beim Aktivieren des Hardware-Intents aufgetreten sind. Die ErrorInfo-Metadaten enthalten einen Zeitstempel und Informationen dazu, ob der Fehler wiederholt werden kann.
shippingInfo

object (ShippingInfo)

Nur Ausgabe. Versandinformationen für diese Hardware.

Bundesland

Gültige Status für Hardware.

Enums
STATE_UNSPECIFIED Der Status der Hardware ist nicht angegeben.
ADDITIONAL_INFO_NEEDED Der Kunde muss weitere Informationen bereitstellen, damit die Anfrage bearbeitet werden kann.
BUILDING Google hat mit der Entwicklung von Hardware für diese Hardware begonnen.
SHIPPING Die Hardware wurde gebaut und wird versendet.
INSTALLING Die Hardware wird installiert.
INSTALLED Die Hardware wurde installiert.
FAILED Es ist ein Fehler aufgetreten und der Kunde muss eingreifen.
INFO_COMPLETE Die Hardware enthält alle erforderlichen Informationen.
READY_FOR_PROVISIONING Die Hardware kann bereitgestellt werden.
PROVISIONING_STARTED Die Bereitstellung der Hardware hat begonnen.
PROVISIONING_FAILED Hardwarebereitstellung fehlgeschlagen.
AWAITING_IDENTIFIERS Die Kennungen der Hardware müssen hinzugefügt werden.
READY_FOR_BOOTSTRAP Die Hardware ist für den Bootstrap bereit.

HardwarePhysicalInfo

Physische Eigenschaften einer Hardware.

JSON-Darstellung 
{
  "powerReceptacle": enum (PowerReceptacleType),
  "networkUplink": enum (NetworkUplinkType),
  "voltage": enum (Voltage),
  "amperes": enum (Amperes)
}
Felder
powerReceptacle

enum (PowerReceptacleType)

Erforderlich. Der Typ der Netzsteckdose.
voltage

enum (Voltage)

Erforderlich. Spannung des Netzteils.
amperes

enum (Amperes)

Erforderlich. Ampere des Netzteils.

PowerReceptacleType

Gültige Netzsteckdosentypen.

Enums
POWER_RECEPTACLE_TYPE_UNSPECIFIED Steckertyp der Einrichtung ist nicht angegeben.
NEMA_5_15 NEMA 5-15.
C_13 C13.
STANDARD_EU

Verworfen: Verwenden Sie stattdessen TYPE_G_BS1363, CEE_7_3, CEE_7_5 oder TYPE_F.
TYPE_G_BS1363 Typ G / BS1363
CEE_7_3 C 7/3.
CEE_7_5 C 7/5.
TYPE_F Typ F.

NetworkUplinkType

Gültige Uplink-Typen des Netzwerks.

Enums
RJ_45 RJ-45.

Spannung

Gültige Spannungswerte.

Enums
VOLTAGE_UNSPECIFIED Spannung ist nicht angegeben.
VOLTAGE_110 120 V.
VOLTAGE_220 220 V.

Ampere

Gültige Amperewerte.

Enums
AMPERES_UNSPECIFIED Ampere ist nicht angegeben.
AMPERES_15 15A.

HardwareInstallationInfo

Informationen zur Installation von Hardware.

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

string

Optional. Standort des Racks am Standort, z.B. Etage 2, Raum 201, Reihe 7, Rack 3.
powerDistanceMeters

integer

Erforderlich. Entfernung zur Steckdose in Metern.
switchDistanceMeters

integer

Erforderlich. Entfernung vom Netzwerkschalter in Metern.
rackUnitDimensions

object (Dimensions)

Optional. Abmessungen der Rackeinheit.
rackSpace

object (RackSpace)

Optional. Für die Hardware zugewiesener Rackbereich.
rackType

enum (RackType)

Erforderlich. Typ des Racks.

Dimensionen

Stellt die Abmessungen eines Objekts dar.

JSON-Darstellung 
{
  "widthInches": number,
  "heightInches": number,
  "depthInches": number
}
Felder
widthInches

number

Erforderlich. Breite in Zoll.
heightInches

number

Erforderlich. Größe in Zoll.
depthInches

number

Erforderlich. Tiefe in Zoll.

RackType

Gültige Racktypen.

Enums
RACK_TYPE_UNSPECIFIED Racktyp ist nicht angegeben.
TWO_POST Rack mit zwei Pfosten.
FOUR_POST Rack mit vier Pfosten.

MachineInfo

Informationen zu einzelnen Maschinen, die Anbieter während der Inbetriebnahme bereitstellen.

JSON-Darstellung 
{
  "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
  ]
}
Felder
serviceTag

string

Optional. Service-Tag der Maschine.
macAddresses[]

object (MacAddress)

Nur Ausgabe. Jede verknüpfte MAC-Adresse.
name

string

Nur Ausgabe. Name der Maschine.
diskInfos[]

object (DiskInfo)

Optional. Informationen zu jedem installierten Laufwerk.
machineType

enum (MachineType)

Optional. Maschinentyp. Erforderlich für Hardware, auf der Gemini on GDC Software ausgeführt wird.
tpmEkCertHash

string

Optional. TPM-EK-Zertifikat-Hash. Erforderlich während der Hardwarereparatur.
gpuSerialNumbers[]

string

Optional. GPU-Seriennummern. Erforderlich während der Hardwarereparatur.
cpuSerialNumbers[]

string

Optional. CPU-Seriennummern. Erforderlich während der Hardwarereparatur.
memoryInfos[]

object (MemoryInfo)

Optional. Informationen zu jedem installierten Arbeitsspeicher. Erforderlich während der Hardwarereparatur.
idracMacAddress

string

Optional. iDRAC-MAC-Adresse. Erforderlich während der Hardwarereparatur.
nicSerialNumbers[]

string

Optional. NIC-Seriennummern. Erforderlich während der Hardwarereparatur.

MacAddress

Nachricht, die die MAC-Adresse einer Maschine beschreibt.

JSON-Darstellung 
{
  "address": string,
  "type": enum (AddressType),
  "ipv4Address": string
}
Felder
address

string

Nur Ausgabe. Adressstring.
type

enum (AddressType)

Nur Ausgabe. Adresstyp für diese MAC-Adresse.
ipv4Address

string

Nur Ausgabe. Statische IP-Adresse (falls verwendet), die der MAC-Adresse zugeordnet ist. Gilt nur für den MAC-Adresstyp VIRTUAL.

AddressType

Enum für die verschiedenen Arten von MAC-Adressen.

Enums
ADDRESS_TYPE_UNSPECIFIED Nicht angegebener Adresstyp.
NIC Adresse einer Netzwerkkarte.
BMC Adresse eines Baseboard Management Controllers.
VIRTUAL Adresse einer virtuellen Schnittstelle.

DiskInfo

Informationen zu einzelnen Laufwerken auf einem Computer.

JSON-Darstellung 
{
  "manufacturer": string,
  "slot": integer,
  "serialNumber": string,
  "psid": string,
  "partNumber": string,
  "modelNumber": string
}
Felder
manufacturer

string

Optional. Hersteller des Laufwerks.
slot

integer

Optional. Nummer des Laufwerksteckplatzes.
serialNumber

string

Optional. Seriennummer des Laufwerks.
psid

string

Optional. PSID des Laufwerks.
partNumber

string

Optional. Teilenummer des Laufwerks.
modelNumber

string

Optional. Modellnummer des Laufwerks.

MachineType

Enum für Maschinentypen, die für Gemini on GDC Software verwendet werden.

Enums
MACHINE_TYPE_UNSPECIFIED Nicht angegebener Maschinentyp.
DELL_XE9680 Dell XE9680-Server.
DELL_XE9780 Dell XE9780-Server.

MemoryInfo

Informationen zu einzelnen Arbeitsspeichern auf einem Computer.

JSON-Darstellung 
{
  "serialNumber": string,
  "sizeBytes": string,
  "partNumber": string
}
Felder
serialNumber

string

Optional. Seriennummer des Arbeitsspeichers.
sizeBytes

string (int64 format)

Optional. Arbeitsspeichergröße
partNumber

string

Optional. Teilenummer des Arbeitsspeichers.

ShippingInfo

„ShippingInfo“ beschreibt die Logistikinformationen für eine Sendung.

JSON-Darstellung 
{
  "carrier": enum (Carrier),
  "trackingId": string
}
Felder
carrier

enum (Carrier)

Nur Ausgabe. Das Transportunternehmen der Sendung.
trackingId

string

Nur Ausgabe. Die Tracking-ID der Sendung.

Mobilfunkanbieter

Liste der Mobilfunkanbieter.

Enums
CARRIER_UNSPECIFIED Mobilfunkanbieter nicht angegeben.
FEDEX Mobilfunkanbieter FedEx.
UPS Transportunternehmen: UPS.
USPS Transportunternehmen: USPS.

Methoden

changeSubscription

 Aktualisiert die Abokonfiguration für eine Hardware.

create

 Erstellt neue Hardware in einem bestimmten Projekt und an einem bestimmten Standort.

delete

 Löscht Hardware.

get

 Ruft Hardwaredetails ab.

list

 Listet Hardware in einem bestimmten Projekt und an einem bestimmten Standort auf.

patch

 Aktualisiert Hardwareparameter.

signal

 Gibt den Status einer Hardware an.

validate

 Validiert eine als JSON-Daten bereitgestellte Hardwarekonfiguration.