REST Resource: projects.locations.hardware

Ressource : Hardware

Instance de matériel installée sur un site.

Représentation 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)
    }
  ],
  "errors": [
    {
      object (Status)
    }
  ],
  "shippingInfo": {
    object (ShippingInfo)
  }
}
Champs
name

string

Identifiant. Nom de ce matériel. Format : projects/{project}/locations/{location}/hardware/{hardware}
displayName

string

Facultatif. Nom à afficher pour ce matériel.
createTime

string (Timestamp format)

Uniquement en sortie. Date et heure de création de ce matériel.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Uniquement en sortie. Date et heure de la dernière mise à jour de ce matériel.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
labels

map (key: string, value: string)

Facultatif. Étiquettes associées à ce matériel sous forme de paires clé/valeur. Pour en savoir plus sur les étiquettes, consultez Créer et gérer des étiquettes.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
order

string

Facultatif. Nom de la commande à laquelle ce matériel appartient. Format : projects/{project}/locations/{location}/orders/{order}
hardwareGroup

string

Uniquement en sortie. Nom du groupe de matériel auquel appartient ce matériel. Format : projects/{project}/locations/{location}/orders/{order}/hardwareGroups/{hardwareGroup}
site

string

Obligatoire. Nom du site auquel appartient ce matériel. Format : projects/{project}/locations/{location}/sites/{site}
state

enum (State)

Uniquement en sortie. État actuel de ce matériel.
ciqUri

string

Uniquement en sortie. Lien vers la feuille du questionnaire d'admission client (CIQ) pour ce matériel.
config

object (HardwareConfig)

Obligatoire. Configuration de ce matériel.
estimatedInstallationDate

object (Date)

Uniquement en sortie. Date d'installation estimée de ce matériel.
physicalInfo

object (HardwarePhysicalInfo)

Facultatif. Propriétés physiques de ce matériel.
installationInfo

object (HardwareInstallationInfo)

Facultatif. Informations sur l'installation de ce matériel.
zone

string

Obligatoire. Nom de la zone à laquelle appartient ce matériel. Format : projects/{project}/locations/{location}/zones/{zone}
requestedInstallationDate
(deprecated)

object (Date)

Facultatif. Obsolète : la date d'installation demandée a été déplacée vers la ressource Order. Utilisez plutôt customerRequestedInstallationDate sur la ressource Order.
actualInstallationDate

object (Date)

Uniquement en sortie. Date d'installation réelle de ce matériel. Rempli par Google.
machineInfos[]

object (MachineInfo)

Facultatif. Informations sur les éléments par machine nécessaires pour la mise en service.
estimatedDeliveryDate

object (Date)

Uniquement en sortie. Date de livraison estimée du matériel.
aiCapable

boolean

Uniquement en sortie. Indique si ce matériel est destiné à Gemini sur GDC Software.
subscriptionConfigs[]

object (SubscriptionConfig)

Uniquement en sortie. Configurations d'abonnement pour ce matériel.
operations[]

object (ResourceOperation)

Uniquement en sortie. Liste de toutes les opérations effectuées sur le matériel.
errors[]

object (Status)

Uniquement en sortie. Erreurs rencontrées lors de l'activation de l'intent matériel. Les métadonnées ErrorInfo incluent un code temporel et indiquent si l'erreur peut être relancée.
shippingInfo

object (ShippingInfo)

Uniquement en sortie. Informations de livraison pour ce matériel.

État

États valides pour le matériel.

Enums
STATE_UNSPECIFIED L'état du matériel n'est pas spécifié.
ADDITIONAL_INFO_NEEDED Le client doit fournir des informations supplémentaires pour que nous puissions avancer.
BUILDING Google a commencé à fabriquer le matériel pour ce matériel.
SHIPPING Le matériel a été fabriqué et est en cours d'expédition.
INSTALLING Le matériel est en cours d'installation.
INSTALLED Le matériel a été installé.
FAILED Une erreur s'est produite et nécessite l'intervention du client.
INFO_COMPLETE Le matériel dispose de toutes les informations requises.
READY_FOR_PROVISIONING Le matériel est prêt à être provisionné.
PROVISIONING_STARTED Le provisionnement du matériel a commencé.
PROVISIONING_FAILED Échec du provisionnement du matériel.
AWAITING_IDENTIFIERS Les identifiants du matériel doivent être ajoutés.
READY_FOR_BOOTSTRAP Le matériel est prêt pour l'amorçage.

HardwarePhysicalInfo

Propriétés physiques d'un matériel.

Représentation JSON 
{
  "powerReceptacle": enum (PowerReceptacleType),
  "networkUplink": enum (NetworkUplinkType),
  "voltage": enum (Voltage),
  "amperes": enum (Amperes)
}
Champs
powerReceptacle

enum (PowerReceptacleType)

Obligatoire. Type de prise d'alimentation.
voltage

enum (Voltage)

Obligatoire. Tension de l'alimentation.
amperes

enum (Amperes)

Obligatoire. Intensité de l'alimentation.

PowerReceptacleType

Types de prises d'alimentation valides.

Enums
POWER_RECEPTACLE_TYPE_UNSPECIFIED Le type de fiche d'alimentation de l'installation n'est pas spécifié.
NEMA_5_15 NEMA 5-15.
C_13 C13.
STANDARD_EU

Obsolète : veuillez utiliser TYPE_G_BS1363, CEE_7_3, CEE_7_5 ou TYPE_F à la place.
TYPE_G_BS1363 Type G / BS1363.
CEE_7_3 CEE 7/3.
CEE_7_5 C 7/5.
TYPE_F Type F.

NetworkUplinkType

Types de liaisons montantes réseau valides.

Enums
RJ_45 RJ-45.

Tension

Valeurs de tension valides.

Enums
VOLTAGE_UNSPECIFIED La tension n'est pas spécifiée.
VOLTAGE_110 120 V.
VOLTAGE_220 220 V.

Ampères

Valeurs d'ampères valides.

Enums
AMPERES_UNSPECIFIED L'intensité n'est pas spécifiée.
AMPERES_15 15A.

HardwareInstallationInfo

Informations pour l'installation d'un matériel.

Représentation JSON 
{
  "rackLocation": string,
  "powerDistanceMeters": integer,
  "switchDistanceMeters": integer,
  "rackUnitDimensions": {
    object (Dimensions)
  },
  "rackSpace": {
    object (RackSpace)
  },
  "rackType": enum (RackType)
}
Champs
rackLocation

string

Facultatif. Emplacement du rack sur le site (par exemple, étage 2, salle 201, rangée 7, rack 3).
powerDistanceMeters

integer

Obligatoire. Distance de la prise électrique (en mètres).
switchDistanceMeters

integer

Obligatoire. Distance du commutateur réseau (en mètres).
rackUnitDimensions

object (Dimensions)

Facultatif. Dimensions de l'unité de rack.
rackSpace

object (RackSpace)

Facultatif. Espace de rack alloué au matériel.
rackType

enum (RackType)

Obligatoire. Type de rack.

Dimensions

Représente les dimensions d'un objet.

Représentation JSON 
{
  "widthInches": number,
  "heightInches": number,
  "depthInches": number
}
Champs
widthInches

number

Obligatoire. Largeur en pouces.
heightInches

number

Obligatoire. Taille en pouces.
depthInches

number

Obligatoire. Profondeur en pouces.

RackType

Types de racks valides.

Enums
RACK_TYPE_UNSPECIFIED Le type de rack n'est pas spécifié.
TWO_POST Rack à deux montants.
FOUR_POST Rack à quatre montants.

MachineInfo

Informations sur les fournisseurs de machines individuelles qui seront fournies lors de la mise en service.

Représentation 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
  ]
}
Champs
serviceTag

string

Facultatif. Tag de service de la machine.
macAddresses[]

object (MacAddress)

Uniquement en sortie. Chaque adresse MAC associée.
name

string

Uniquement en sortie. Nom de la machine.
diskInfos[]

object (DiskInfo)

Facultatif. Informations sur chaque disque installé.
machineType

enum (MachineType)

Facultatif. Type de machine. Requis pour le matériel exécutant Gemini sur le logiciel GDC.
tpmEkCertHash

string

Facultatif. Hachage du certificat EK du TPM. Requis lors de la réparation du matériel.
gpuSerialNumbers[]

string

Facultatif. Numéros de série des GPU. Requis lors de la réparation du matériel.
cpuSerialNumbers[]

string

Facultatif. Numéros de série des processeurs. Requis lors de la réparation du matériel.
memoryInfos[]

object (MemoryInfo)

Facultatif. Informations sur chaque mémoire installée. Requis lors de la réparation du matériel.
idracMacAddress

string

Facultatif. Adresse MAC iDRAC. Requis lors de la réparation du matériel.
nicSerialNumbers[]

string

Facultatif. Numéros de série des cartes d'interface réseau. Requis lors de la réparation du matériel.

MacAddress

Message décrivant l'adresse MAC d'une machine.

Représentation JSON 
{
  "address": string,
  "type": enum (AddressType),
  "ipv4Address": string
}
Champs
address

string

Uniquement en sortie. Chaîne d'adresse.
type

enum (AddressType)

Uniquement en sortie. Type d'adresse pour cette adresse MAC.
ipv4Address

string

Uniquement en sortie. Adresse IP statique (si elle est utilisée) associée à l'adresse MAC. Applicable uniquement au type d'adresse MAC VIRTUELLE.

AddressType

Énumération des différents types d'adresses MAC.

Enums
ADDRESS_TYPE_UNSPECIFIED Type d'adresse non spécifié.
NIC Adresse d'une carte d'interface réseau.
BMC Adresse d'un contrôleur de gestion de la carte mère.
VIRTUAL Adresse d'une interface virtuelle.

DiskInfo

Informations sur les disques individuels d'une machine.

Représentation JSON 
{
  "manufacturer": string,
  "slot": integer,
  "serialNumber": string,
  "psid": string,
  "partNumber": string,
  "modelNumber": string
}
Champs
manufacturer

string

Facultatif. Fabricant du disque.
slot

integer

Facultatif. Numéro de l'emplacement du disque.
serialNumber

string

Facultatif. Numéro de série du disque.
psid

string

Facultatif. PSID du disque.
partNumber

string

Facultatif. Référence du disque.
modelNumber

string

Facultatif. Numéro de modèle du disque.

MachineType

Énumération des types de machines utilisés pour Gemini sur GDC Software.

Enums
MACHINE_TYPE_UNSPECIFIED Type de machine non spécifié.
DELL_XE9680 Serveur Dell XE9680.
DELL_XE9780 Serveur Dell XE9780.

MemoryInfo

Informations sur les mémoires individuelles d'une machine.

Représentation JSON 
{
  "serialNumber": string,
  "sizeBytes": string,
  "partNumber": string
}
Champs
serialNumber

string

Facultatif. Numéro de série de la mémoire.
sizeBytes

string (int64 format)

Facultatif. Taille de la mémoire.
partNumber

string

Facultatif. Référence de la mémoire.

ShippingInfo

"ShippingInfo" décrit les informations logistiques d'un envoi.

Représentation JSON 
{
  "carrier": enum (Carrier),
  "trackingId": string
}
Champs
carrier

enum (Carrier)

Uniquement en sortie. Transporteur de l'envoi.
trackingId

string

Uniquement en sortie. ID de suivi de l'envoi.

Opérateur

Liste des opérateurs.

Enums
CARRIER_UNSPECIFIED Opérateur non spécifié.
FEDEX Transporteur : FedEx.
UPS Transporteur : UPS.
USPS Transporteur : USPS.

Méthodes

changeSubscription

 Met à jour la configuration de l'abonnement pour un matériel.

create

 Crée du matériel dans un projet et un emplacement donnés.

delete

 Supprime le matériel.

get

 Récupère les détails du matériel.

list

 Répertorie le matériel d'un projet et d'un emplacement donnés.

patch

 Met à jour les paramètres matériels.

signal

 Signale l'état d'un matériel.

validate

 Valide une configuration matérielle fournie sous forme de données JSON.