REST Resource: projects.locations.hardware

Risorsa: Hardware

Un'istanza di hardware installata in un sito.

Rappresentazione 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)
    }
  ],
  "estimatedDeliveryDate": {
    object (Date)
  }
}
Campi
name

string

Identificatore. Il nome di questo hardware. Formato: projects/{project}/locations/{location}/hardware/{hardware}
displayName

string

Facoltativo. Nome visualizzato per questo hardware.
createTime

string (Timestamp format)

Solo output. Ora in cui è stato creato questo hardware.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo output. Ora dell'ultimo aggiornamento di questo hardware.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
labels

map (key: string, value: string)

Facoltativo. Etichette associate a questo hardware come coppie chiave-valore. Per saperne di più sulle etichette, consulta Creare e gestire le etichette.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
order

string

Obbligatorio. Il nome dell'ordine a cui appartiene questo hardware. Formato: projects/{project}/locations/{location}/orders/{order}
hardwareGroup

string

Solo output. Nome del gruppo hardware a cui appartiene questo hardware. Formato: projects/{project}/locations/{location}/orders/{order}/hardwareGroups/{hardwareGroup}
site

string

Obbligatorio. Nome del sito a cui appartiene questo hardware. Formato: projects/{project}/locations/{location}/sites/{site}
state

enum (State)

Solo output. Stato attuale di questo hardware.
ciqUri

string

Solo output. Link al foglio del questionario di acquisizione del cliente (CIQ) per questo hardware.
config

object (HardwareConfig)

Obbligatorio. Configurazione per questo hardware.
estimatedInstallationDate

object (Date)

Solo output. Data di installazione stimata per questo hardware.
physicalInfo

object (HardwarePhysicalInfo)

Facoltativo. Proprietà fisiche di questo hardware.
installationInfo

object (HardwareInstallationInfo)

Facoltativo. Informazioni per l'installazione di questo hardware.
zone

string

Obbligatorio. Nome della zona a cui appartiene questo hardware. Formato: projects/{project}/locations/{location}/zones/{zone}
requestedInstallationDate
(deprecated)

object (Date)

Facoltativo. Ritirato: la data di installazione richiesta è stata spostata nella risorsa Order. Utilizza customerRequestedInstallationDate nella risorsa Order.
actualInstallationDate

object (Date)

Solo output. Data di installazione effettiva di questo hardware. Compilato da Google.
machineInfos[]

object (MachineInfo)

Solo output. Informazioni sugli asset per macchina necessarie per l'attivazione.
estimatedDeliveryDate

object (Date)

Solo output. La data di consegna stimata dell'hardware.

Stato

Stati validi per l'hardware.

Enum
STATE_UNSPECIFIED Lo stato dell'hardware non è specificato.
ADDITIONAL_INFO_NEEDED Per procedere, sono necessarie ulteriori informazioni da parte del cliente.
BUILDING Google ha iniziato a produrre hardware per questo hardware.
SHIPPING L'hardware è stato costruito e verrà spedito.
INSTALLING L'hardware è in fase di installazione.
INSTALLED L'hardware è stato installato.
FAILED Si è verificato un errore ed è necessario l'intervento del cliente.

HardwarePhysicalInfo

Proprietà fisiche di un hardware.

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

enum (PowerReceptacleType)

Obbligatorio. Il tipo di presa di alimentazione.
voltage

enum (Voltage)

Obbligatorio. Tensione dell'alimentazione.
amperes

enum (Amperes)

Obbligatorio. Ampere dell'alimentazione.

PowerReceptacleType

Tipi di prese di alimentazione validi.

Enum
POWER_RECEPTACLE_TYPE_UNSPECIFIED Il tipo di presa della struttura non è specificato.
NEMA_5_15 NEMA 5-15.
C_13 C13.
STANDARD_EU

Ritirato: utilizza TYPE_G_BS1363, CEE_7_3, CEE_7_5 o TYPE_F.
TYPE_G_BS1363 Tipo G / BS1363.
CEE_7_3 C 7/3.
CEE_7_5 C 7/5.
TYPE_F Tipo F.

NetworkUplinkType

Tipi di uplink di rete validi.

Enum
RJ_45 RJ-45.

Tensione

Valori di tensione validi.

Enum
VOLTAGE_UNSPECIFIED La tensione non è specificata.
VOLTAGE_110 120V.
VOLTAGE_220 220V.

Ampere

Valori di ampere validi.

Enum
AMPERES_UNSPECIFIED Gli ampere non sono specificati.
AMPERES_15 15A.

HardwareInstallationInfo

Informazioni per l'installazione di un hardware.

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

string

Obbligatorio. Posizione del rack nel sito, ad es. Piano 2, Stanza 201, Fila 7, Rack 3.
powerDistanceMeters

integer

Obbligatorio. Distanza dalla presa di corrente in metri.
switchDistanceMeters

integer

Obbligatorio. Distanza dallo switch di rete in metri.
rackUnitDimensions

object (Dimensions)

Obbligatorio. Dimensioni dell'unità rack.
rackSpace

object (RackSpace)

Obbligatorio. Spazio rack allocato per l'hardware.
rackType

enum (RackType)

Obbligatorio. Tipo di rack.

Dimensioni

Rappresenta le dimensioni di un oggetto.

Rappresentazione JSON 
{
  "widthInches": number,
  "heightInches": number,
  "depthInches": number
}
Campi
widthInches

number

Obbligatorio. Larghezza in pollici.
heightInches

number

Obbligatorio. Altezza in pollici.
depthInches

number

Obbligatorio. Profondità in pollici.

RackType

Tipi di rack validi.

Enum
RACK_TYPE_UNSPECIFIED Il tipo di rack non è specificato.
TWO_POST Rack a due montanti.
FOUR_POST Rack a quattro montanti.

MachineInfo

Informazioni sui singoli fornitori di macchine che verranno fornite durante l'attivazione.

Rappresentazione JSON 
{
  "serviceTag": string,
  "macAddresses": [
    {
      object (MacAddress)
    }
  ],
  "name": string,
  "diskInfos": [
    {
      object (DiskInfo)
    }
  ]
}
Campi
serviceTag

string

Solo output. Tag di servizio della macchina.
macAddresses[]

object (MacAddress)

Solo output. Ogni indirizzo MAC associato.
name

string

Solo output. Nome della macchina.
diskInfos[]

object (DiskInfo)

Solo output. Informazioni per ogni disco installato.

MacAddress

Messaggio per descrivere l'indirizzo MAC di una macchina.

Rappresentazione JSON 
{
  "address": string,
  "type": enum (AddressType),
  "ipv4Address": string
}
Campi
address

string

Solo output. Stringa dell'indirizzo.
type

enum (AddressType)

Solo output. Tipo di indirizzo per questo indirizzo MAC.
ipv4Address

string

Solo output. Indirizzo IP statico (se utilizzato) associato all'indirizzo MAC. Applicabile solo per il tipo di indirizzo MAC VIRTUAL.

AddressType

Enumerazione per i diversi tipi di indirizzo MAC.

Enum
ADDRESS_TYPE_UNSPECIFIED Tipo di indirizzo non specificato.
NIC Indirizzo di una scheda di interfaccia di rete.
BMC Indirizzo di un controller di gestione della scheda madre.
VIRTUAL Indirizzo di un'interfaccia virtuale.

DiskInfo

Informazioni sui singoli dischi di una macchina.

Rappresentazione JSON 
{
  "manufacturer": string,
  "slot": integer,
  "serialNumber": string,
  "psid": string,
  "partNumber": string,
  "modelNumber": string
}
Campi
manufacturer

string

Solo output. Produttore del disco.
slot

integer

Solo output. Numero dello slot del disco.
serialNumber

string

Solo output. Numero di serie del disco.
psid

string

Solo output. PSID del disco.
partNumber

string

Solo output. Codice articolo del disco.
modelNumber

string

Solo output. Numero di modello del disco.

Metodi

create

 Crea un nuovo hardware in un progetto e una località specifici.

delete

 Elimina l'hardware.

get

 Recupera i dettagli hardware.

list

 Elenca l'hardware in un progetto e una località specifici.

patch

 Aggiorna i parametri hardware.