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)
  }
}
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)

Uniquement en sortie. 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.

É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.

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

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

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

object (RackSpace)

Obligatoire. 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)
    }
  ]
}
Champs
serviceTag

string

Uniquement en sortie. 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)

Uniquement en sortie. Informations pour chaque disque installé.

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

Uniquement en sortie. Fabricant du disque.
slot

integer

Uniquement en sortie. Numéro de l'emplacement du disque.
serialNumber

string

Uniquement en sortie. Numéro de série du disque.
psid

string

Uniquement en sortie. PSID du disque.
partNumber

string

Uniquement en sortie. Numéro de référence du disque.
modelNumber

string

Uniquement en sortie. Numéro de modèle du disque.

Méthodes

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.