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)
  },
  "aiCapable": boolean,
  "subscriptionConfigs": [
    {
      object (SubscriptionConfig)
    }
  ],
  "operations": [
    {
      object (ResourceOperation)
    }
  ]
}
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)

Facoltativo. Informazioni sugli asset per macchina necessarie per l'attivazione.
estimatedDeliveryDate

object (Date)

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

boolean

Solo output. Indica se questo hardware è per Gemini su GDC Software.
subscriptionConfigs[]

object (SubscriptionConfig)

Solo output. Configurazioni degli abbonamenti per questo hardware.
operations[]

object (ResourceOperation)

Solo output. Elenco di tutte le operazioni eseguite sull'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.
INFO_COMPLETE L'hardware contiene tutte le informazioni richieste.
READY_FOR_PROVISIONING L'hardware è pronto per il provisioning.
PROVISIONING_STARTED L'hardware ha iniziato il provisioning.
PROVISIONING_FAILED Il provisioning dell'hardware non è riuscito.

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

Facoltativo. 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)

Facoltativo. Dimensioni dell'unità rack.
rackSpace

object (RackSpace)

Facoltativo. 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)
    }
  ],
  "machineType": enum (MachineType),
  "tpmEkCertHash": string,
  "gpuSerialNumbers": [
    string
  ],
  "cpuSerialNumbers": [
    string
  ],
  "memoryInfos": [
    {
      object (MemoryInfo)
    }
  ],
  "idracMacAddress": string,
  "nicSerialNumbers": [
    string
  ]
}
Campi
serviceTag

string

Facoltativo. Tag di servizio della macchina.
macAddresses[]

object (MacAddress)

Solo output. Ogni indirizzo MAC associato.
name

string

Solo output. Nome della macchina.
diskInfos[]

object (DiskInfo)

Facoltativo. Informazioni per ogni disco installato.
machineType

enum (MachineType)

Facoltativo. Tipo di macchina. Obbligatorio per l'hardware che esegue Gemini su GDC Software.
tpmEkCertHash

string

Facoltativo. Hash del certificato EK del TPM. Obbligatorio durante la riparazione dell'hardware.
gpuSerialNumbers[]

string

Facoltativo. Numeri di serie delle GPU. Obbligatorio durante la riparazione dell'hardware.
cpuSerialNumbers[]

string

Facoltativo. Numeri di serie della CPU. Obbligatorio durante la riparazione dell'hardware.
memoryInfos[]

object (MemoryInfo)

Facoltativo. Informazioni su ogni memoria installata. Obbligatorio durante la riparazione dell'hardware.
idracMacAddress

string

(Facoltativo) Indirizzo MAC iDRAC. Obbligatorio durante la riparazione dell'hardware.
nicSerialNumbers[]

string

Facoltativo. Numeri di serie NIC. Obbligatorio durante la riparazione dell'hardware.

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

Facoltativo. Produttore del disco.
slot

integer

Facoltativo. Numero dello slot del disco.
serialNumber

string

Facoltativo. Numero di serie del disco.
psid

string

Facoltativo. PSID del disco.
partNumber

string

Facoltativo. Codice articolo del disco.
modelNumber

string

Facoltativo. Numero di modello del disco.

MachineType

Enumerazione per i tipi di macchine utilizzati per Gemini su GDC Software.

Enum
MACHINE_TYPE_UNSPECIFIED Tipo di macchina non specificato.
DELL_XE9680 Server Dell XE9680.
DELL_XE9780 Server Dell XE9780.

MemoryInfo

Informazioni sulle singole memorie di una macchina.

Rappresentazione JSON 
{
  "serialNumber": string,
  "sizeBytes": string,
  "partNumber": string
}
Campi
serialNumber

string

Facoltativo. Numero di serie della memoria.
sizeBytes

string (int64 format)

Facoltativo. Dimensioni memoria.
partNumber

string

Facoltativo. Numero di parte della memoria.

ResourceOperation

Rappresenta un'operazione in corso per una risorsa

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

string

Solo output. ID operazione.
state

enum (State)

Solo output. Stato operazione.
type

enum (Type)

Solo output. Tipo di operazione.
stateHistory[]

object (StateHistoryEntry)

Solo output. Cronologia degli stati dell'operazione.
requiresReTurnup

boolean

Solo output. Un flag che indica se è necessario un riavvio.

Stato

Enumerazione per gli stati dell'operazione.

Enum
STATE_UNSPECIFIED Stato dell'operazione non specificato.
AWAITING_CUSTOMER_INPUT L'operazione è in attesa dell'input del cliente.
PROGRESSING L'operazione è in corso.
COMPLETED L'operazione è completata.

Tipo

Enum per i tipi di operazioni.

Enum
TYPE_UNSPECIFIED Tipo di operazione non specificato.
REPAIR Operazione di riparazione.

StateHistoryEntry

Voce per la cronologia dello stato dell'operazione.

Rappresentazione JSON 
{
  "state": enum (State),
  "updateTime": string,
  "reason": string,
  "responsibleEntity": enum (Entity)
}
Campi
state

enum (State)

Solo output. Stato operazione.
updateTime

string (Timestamp format)

Solo output. Timestamp dell'aggiornamento dello stato dell'operazione.

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".
reason

string

Solo output. Motivo della modifica dello stato.
responsibleEntity

enum (Entity)

Solo output. L'entità che ha modificato lo stato.

Metodi

changeSubscription

 Aggiorna la configurazione dell'abbonamento per un hardware.

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.

signal

 Indica lo stato di un hardware.