REST Resource: projects.locations.hardware

Ressource: Hardware

Eine Instanz von Hardware, 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)
    }
  ]
}
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. Der 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 der letzten Aktualisierung dieser Hardware.

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

Erforderlich. Name des Auftrags, zu dem 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 der Website, zu der diese Hardware gehört. Format: projects/{project}/locations/{location}/sites/{site}

state

enum (State)

Nur Ausgabe. Der aktuelle Status dieser Hardware.

ciqUri

string

Nur Ausgabe. Link zum CIQ-Tabellenblatt (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 Eigenschaften 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. Veraltet: Das angeforderte Installationsdatum wurde in die Order-Ressource verschoben. Verwenden Sie stattdessen customerRequestedInstallationDate für die Order-Ressource.

actualInstallationDate

object (Date)

Nur Ausgabe. Das tatsächliche Installationsdatum für diese Hardware. Wird von Google ausgefüllt.

machineInfos[]

object (MachineInfo)

Optional. Informationen zum Maschinen-Asset, die für die Inbetriebnahme erforderlich sind.

estimatedDeliveryDate

object (Date)

Nur Ausgabe. Das voraussichtliche Lieferdatum der Hardware.

aiCapable

boolean

Nur Ausgabe. Gibt an, ob diese Hardware für Gemini auf GDC-Software vorgesehen ist.

subscriptionConfigs[]

object (SubscriptionConfig)

Nur Ausgabe. Abo-Konfigurationen für diese Hardware.

operations[]

object (ResourceOperation)

Nur Ausgabe. Liste aller Vorgänge, die auf der Hardware ausgeführt wurden.

Bundesland

Gültige Status für Hardware.

Enums
STATE_UNSPECIFIED Der Status der Hardware ist nicht angegeben.
ADDITIONAL_INFO_NEEDED Damit wir mit der Bearbeitung fortfahren können, sind weitere Informationen vom Kunden erforderlich.
BUILDING Google hat mit der Entwicklung der Hardware für dieses Gerät begonnen.
SHIPPING Die Hardware wurde gefertigt 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 Hardware wird bereitgestellt.
PROVISIONING_FAILED Die Hardwarebereitstellung ist fehlgeschlagen.

HardwarePhysicalInfo

Physische Eigenschaften der 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 Typen von Netzsteckdosen.

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

Eingestellt: 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 Die Spannung ist nicht angegeben.
VOLTAGE_110 120 V.
VOLTAGE_220 220 V.

Ampere

Gültige Ampere-Werte.

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 auf dem Gelände, z. B. 2. Etage, 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 Rackplatz.

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 Rack-Typen.

Enums
RACK_TYPE_UNSPECIFIED Der 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 zugeordnete MAC-Adresse.

name

string

Nur Ausgabe. Computername.

diskInfos[]

object (DiskInfo)

Optional. Informationen für jede installierte Festplatte.

machineType

enum (MachineType)

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

tpmEkCertHash

string

Optional. TPM-EK-Zertifikats-Hash. Erforderlich bei der Reparatur von Hardware.

gpuSerialNumbers[]

string

Optional. GPU-Seriennummern Erforderlich bei der Reparatur von Hardware.

cpuSerialNumbers[]

string

Optional. CPU-Seriennummern. Erforderlich bei der Reparatur von Hardware.

memoryInfos[]

object (MemoryInfo)

Optional. Informationen zu jedem installierten Arbeitsspeicher. Erforderlich bei der Reparatur von Hardware.

idracMacAddress

string

Optional. iDRAC-MAC-Adresse. Erforderlich bei der Reparatur von Hardware.

nicSerialNumbers[]

string

Optional. Seriennummern der Netzwerkkarte. Erforderlich bei der Reparatur von Hardware.

MacAddress

Nachricht zur Beschreibung der MAC-Adresse eines Computers.

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. Die statische IP-Adresse (falls verwendet), die der MAC-Adresse zugeordnet ist. Gilt nur für den VIRTUAL-MAC-Adresstyp.

AddressType

Enumeration 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 Festplatten 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 Laufwerkslots.

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

Enumeration für Maschinentypen, die für Gemini auf 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 Erinnerungen 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.

ResourceOperation

Stellt einen laufenden Vorgang für eine Ressource dar

JSON-Darstellung
{
  "uid": string,
  "state": enum (State),
  "type": enum (Type),
  "stateHistory": [
    {
      object (StateHistoryEntry)
    }
  ],
  "requiresReTurnup": boolean
}
Felder
uid

string

Nur Ausgabe. Vorgangs-ID.

state

enum (State)

Nur Ausgabe. Vorgangsstatus.

type

enum (Type)

Nur Ausgabe. Vorgangstyp.

stateHistory[]

object (StateHistoryEntry)

Nur Ausgabe. Statusverlauf für den Vorgang.

requiresReTurnup

boolean

Nur Ausgabe. Ein Flag, das angibt, ob eine erneute Inbetriebnahme erforderlich ist.

Bundesland

Enum für Vorgangsstatus.

Enums
STATE_UNSPECIFIED Nicht angegebener Vorgangsstatus.
AWAITING_CUSTOMER_INPUT Der Vorgang wartet auf eine Eingabe des Kunden.
PROGRESSING Der Vorgang wird ausgeführt.
COMPLETED Der Vorgang ist abgeschlossen.

Typ

Enum für Vorgangstypen.

Enums
TYPE_UNSPECIFIED Nicht angegebener Vorgangstyp.
REPAIR Reparaturvorgang.

StateHistoryEntry

Eintrag für den Verlauf des Betriebsstatus.

JSON-Darstellung
{
  "state": enum (State),
  "updateTime": string,
  "reason": string,
  "responsibleEntity": enum (Entity)
}
Felder
state

enum (State)

Nur Ausgabe. Vorgangsstatus.

updateTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel der letzten Aktualisierung des Vorgangsstatus.

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"

reason

string

Nur Ausgabe. Grund für die Statusänderung.

responsibleEntity

enum (Entity)

Nur Ausgabe. Entität, die den Status geändert hat.

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 angegebenen Projekt und an einem angegebenen Standort auf.

patch

Aktualisiert Hardwareparameter.

signal

Gibt den Status einer Hardware an.