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)
    }
  ]
}
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. Heure à laquelle ce matériel a été créé.

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. 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 libellés, consultez Créer et gérer des libellés.

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

string

Obligatoire. Nom de la commande à laquelle appartient ce matériel. 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'accueil des clients (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 pour 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" (Commande).
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 composants 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 le logiciel GDC.
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.

État

États valides pour le matériel.

Enums
STATE_UNSPECIFIED L'état du matériel n'est pas spécifié.
ADDITIONAL_INFO_NEEDED Nous avons besoin d'informations supplémentaires de la part du client pour progresser.
BUILDING Google a commencé à fabriquer du matériel pour cet appareil.
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 l'intervention du client est requise.
INFO_COMPLETE Le matériel contient 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 Le provisionnement du matériel a échoué.

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 C 7/3.
CEE_7_5 C 7/5.
TYPE_F Type F.

NetworkUplinkType

Types de liaison montante 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 sur 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 machines individuelles que les fournisseurs fourniront 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. Numéro de série 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 pour chaque disque installé.
machineType

enum (MachineType)

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

string

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

string

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

string

Facultatif. Numéros de série du processeur Obligatoire lors de la réparation du matériel.
memoryInfos[]

object (MemoryInfo)

Facultatif. Informations pour chaque module de mémoire installé. Obligatoire lors de la réparation du matériel.
idracMacAddress

string

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

string

Facultatif. Numéros de série des cartes d'interface réseau. Obligatoire 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 (le cas échéant) associée à l'adresse MAC. Applicable uniquement au type d'adresse MAC virtuelle.

AddressType

Énumération pour les 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 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. Numéro de référence du disque.
modelNumber

string

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

MachineType

Enum pour les types de machines utilisés pour Gemini sur le logiciel GDC.

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.

ResourceOperation

Représente une opération en cours pour une ressource.

Représentation JSON 
{
  "uid": string,
  "state": enum (State),
  "type": enum (Type),
  "stateHistory": [
    {
      object (StateHistoryEntry)
    }
  ],
  "requiresReTurnup": boolean
}
Champs
uid

string

Uniquement en sortie. ID de l'opération.
state

enum (State)

Uniquement en sortie. État de l'opération.
type

enum (Type)

Uniquement en sortie. Type d'opération.
stateHistory[]

object (StateHistoryEntry)

Uniquement en sortie. Historique des états de l'opération.
requiresReTurnup

boolean

Uniquement en sortie. Indicateur permettant de savoir si une réactivation est requise.

État

Énumération pour les états d'opération.

Enums
STATE_UNSPECIFIED État de l'opération non spécifié.
AWAITING_CUSTOMER_INPUT L'opération est en attente d'une action du client.
PROGRESSING L'opération est en cours.
COMPLETED L'opération est terminée.

Type

Énumération des types d'opération.

Enums
TYPE_UNSPECIFIED Type d'opération non spécifié.
REPAIR Opération de réparation.

StateHistoryEntry

Entrée pour l'historique de l'état de l'opération.

Représentation JSON 
{
  "state": enum (State),
  "updateTime": string,
  "reason": string,
  "responsibleEntity": enum (Entity)
}
Champs
state

enum (State)

Uniquement en sortie. État de l'opération.
updateTime

string (Timestamp format)

Uniquement en sortie. Code temporel de la dernière mise à jour de l'état de l'opération.

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

string

Uniquement en sortie. Motif du changement d'état.
responsibleEntity

enum (Entity)

Uniquement en sortie. Entité ayant modifié l'état.

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 informations sur le matériel.

list

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

patch

 Met à jour les paramètres matériels.

signal

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