REST Resource: projects.locations.hardware

Recurso: Hardware

Es una instancia de hardware instalada en un sitio.

Representación 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)
  }
}
Campos
name

string

Es el identificador. Es el nombre de este hardware. Formato: projects/{project}/locations/{location}/hardware/{hardware}
displayName

string

Es opcional. Es el nombre visible de este hardware.
createTime

string (Timestamp format)

Solo salida. Es la hora en la que se creó este hardware.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo salida. Es la hora en la que se actualizó este hardware por última vez.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "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)

Es opcional. Son las etiquetas asociadas con este hardware como pares clave-valor. Para obtener más información sobre las etiquetas, consulta Crea y administra etiquetas.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
order

string

Es opcional. Es el nombre del pedido al que pertenece este hardware. Formato: projects/{project}/locations/{location}/orders/{order}
hardwareGroup

string

Solo salida. Es el nombre del grupo de hardware al que pertenece este hardware. Formato: projects/{project}/locations/{location}/orders/{order}/hardwareGroups/{hardwareGroup}
site

string

Obligatorio. Es el nombre del sitio al que pertenece este hardware. Formato: projects/{project}/locations/{location}/sites/{site}
state

enum (State)

Solo salida. Es el estado actual de este hardware.
ciqUri

string

Solo salida. Vínculo a la hoja del Cuestionario de admisión del cliente (CIQ) para este hardware.
config

object (HardwareConfig)

Obligatorio. Configuración de este hardware.
estimatedInstallationDate

object (Date)

Solo salida. Es la fecha de instalación estimada para este hardware.
physicalInfo

object (HardwarePhysicalInfo)

Es opcional. Son las propiedades físicas de este hardware.
installationInfo

object (HardwareInstallationInfo)

Es opcional. Información para la instalación de este hardware.
zone

string

Obligatorio. Es el nombre de la zona a la que pertenece este hardware. Formato: projects/{project}/locations/{location}/zones/{zone}
requestedInstallationDate
(deprecated)

object (Date)

Es opcional. Obsoleto: La fecha de instalación solicitada se movió al recurso Order. En su lugar, usa customerRequestedInstallationDate en el recurso Order.
actualInstallationDate

object (Date)

Solo salida. Es la fecha de instalación real de este hardware. Google lo completa.
machineInfos[]

object (MachineInfo)

Es opcional. Información de los recursos de la máquina necesaria para la activación.
estimatedDeliveryDate

object (Date)

Solo salida. Es la fecha de entrega estimada del hardware.
aiCapable

boolean

Solo salida. Indica si este hardware es para Gemini en el software de GDC.
subscriptionConfigs[]

object (SubscriptionConfig)

Solo salida. Son los parámetros de configuración de la suscripción para este hardware.
operations[]

object (ResourceOperation)

Solo salida. Es la lista de todas las operaciones realizadas en el hardware.
errors[]

object (Status)

Solo salida. Son los errores que se encontraron durante la activación del intent de hardware. Los metadatos de ErrorInfo incluirán la marca de tiempo y si el error se puede reintentar.
shippingInfo

object (ShippingInfo)

Solo salida. Información de envío de este hardware.

Estado

Estados válidos para el hardware.

Enums
STATE_UNSPECIFIED No se especifica el estado del hardware.
ADDITIONAL_INFO_NEEDED Se requiere más información del cliente para avanzar.
BUILDING Google comenzó a fabricar el Hardware.
SHIPPING Se compiló el hardware y se está enviando.
INSTALLING Se está instalando el hardware.
INSTALLED Se instaló el hardware.
FAILED Se produjo un error y se requiere la intervención del cliente.
INFO_COMPLETE El hardware tiene toda la información requerida.
READY_FOR_PROVISIONING El hardware está listo para el aprovisionamiento.
PROVISIONING_STARTED Se inició el aprovisionamiento del hardware.
PROVISIONING_FAILED No se pudo aprovisionar el hardware.
AWAITING_IDENTIFIERS Se deben agregar los identificadores del hardware.
READY_FOR_BOOTSTRAP El hardware está listo para el arranque.

HardwarePhysicalInfo

Son las propiedades físicas de un hardware.

Representación JSON 
{
  "powerReceptacle": enum (PowerReceptacleType),
  "networkUplink": enum (NetworkUplinkType),
  "voltage": enum (Voltage),
  "amperes": enum (Amperes)
}
Campos
powerReceptacle

enum (PowerReceptacleType)

Obligatorio. Es el tipo de tomacorriente.
voltage

enum (Voltage)

Obligatorio. Voltaje de la fuente de alimentación.
amperes

enum (Amperes)

Obligatorio. Amperios de la fuente de alimentación.

PowerReceptacleType

Tipos de tomacorrientes válidos.

Enums
POWER_RECEPTACLE_TYPE_UNSPECIFIED No se especificó el tipo de enchufe de la instalación.
NEMA_5_15 NEMA 5-15.
C_13 C13.
STANDARD_EU

Obsoleto: Usa TYPE_G_BS1363, CEE_7_3, CEE_7_5 o TYPE_F en su lugar.
TYPE_G_BS1363 Tipo G / BS1363.
CEE_7_3 C 7/3.
CEE_7_5 C 7/5.
TYPE_F Tipo F.

NetworkUplinkType

Tipos de enlace de subida de red válidos.

Enums
RJ_45 RJ-45.

Voltaje

Valores de voltaje válidos.

Enums
VOLTAGE_UNSPECIFIED No se especificó el voltaje.
VOLTAGE_110 120 V.
VOLTAGE_220 220 V.

Amperes

Valores de amperios válidos.

Enums
AMPERES_UNSPECIFIED No se especificó el amperaje.
AMPERES_15 15A.

HardwareInstallationInfo

Información para la instalación de un hardware.

Representación JSON 
{
  "rackLocation": string,
  "powerDistanceMeters": integer,
  "switchDistanceMeters": integer,
  "rackUnitDimensions": {
    object (Dimensions)
  },
  "rackSpace": {
    object (RackSpace)
  },
  "rackType": enum (RackType)
}
Campos
rackLocation

string

Es opcional. Ubicación del bastidor en el sitio, p.ej., piso 2, sala 201, fila 7, bastidor 3.
powerDistanceMeters

integer

Obligatorio. Es la distancia desde el tomacorriente en metros.
switchDistanceMeters

integer

Obligatorio. Es la distancia desde el switch de red en metros.
rackUnitDimensions

object (Dimensions)

Es opcional. Son las dimensiones de la unidad de bastidores.
rackSpace

object (RackSpace)

Es opcional. Es el espacio de bastidor asignado para el hardware.
rackType

enum (RackType)

Obligatorio. Es el tipo de bastidor.

Dimensiones

Representa las dimensiones de un objeto.

Representación JSON 
{
  "widthInches": number,
  "heightInches": number,
  "depthInches": number
}
Campos
widthInches

number

Obligatorio. Ancho en pulgadas.
heightInches

number

Obligatorio. Es la altura en pulgadas.
depthInches

number

Obligatorio. Profundidad en pulgadas.

RackType

Son los tipos de bastidores válidos.

Enums
RACK_TYPE_UNSPECIFIED No se especificó el tipo de bastidor.
TWO_POST Bastidor de dos postes
FOUR_POST Bastidor de cuatro postes.

MachineInfo

Información sobre las máquinas individuales que los proveedores proporcionarán durante la activación.

Representación 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
  ]
}
Campos
serviceTag

string

Es opcional. Es la etiqueta de servicio de la máquina.
macAddresses[]

object (MacAddress)

Solo salida. Cada dirección MAC asociada
name

string

Solo salida. Es el nombre de la máquina.
diskInfos[]

object (DiskInfo)

Es opcional. Información sobre cada disco instalado.
machineType

enum (MachineType)

Es opcional. Tipo de máquina. Es obligatorio para el hardware que ejecuta Gemini en el software de GDC.
tpmEkCertHash

string

Es opcional. Hash del certificado de EK del TPM. Se requiere durante la reparación del hardware.
gpuSerialNumbers[]

string

Es opcional. Son los números de serie de las GPU. Se requiere durante la reparación del hardware.
cpuSerialNumbers[]

string

Es opcional. Son los números de serie de la CPU. Se requiere durante la reparación del hardware.
memoryInfos[]

object (MemoryInfo)

Es opcional. Información sobre cada memoria instalada. Se requiere durante la reparación del hardware.
idracMacAddress

string

Opcional. Dirección MAC de iDRAC. Se requiere durante la reparación del hardware.
nicSerialNumbers[]

string

Es opcional. Son los números de serie de la NIC. Se requiere durante la reparación del hardware.

MacAddress

Es el mensaje para describir la dirección MAC de una máquina.

Representación JSON 
{
  "address": string,
  "type": enum (AddressType),
  "ipv4Address": string
}
Campos
address

string

Solo salida. Es la cadena de dirección.
type

enum (AddressType)

Solo salida. Es el tipo de dirección para esta dirección MAC.
ipv4Address

string

Solo salida. Dirección IP estática (si se usa) que está asociada con la dirección MAC. Solo se aplica al tipo de dirección MAC VIRTUAL.

AddressType

Enum para los diferentes tipos de direcciones MAC.

Enums
ADDRESS_TYPE_UNSPECIFIED Indica que no se especificó el tipo de dirección.
NIC Es la dirección de una tarjeta de interfaz de red.
BMC Es la dirección de un controlador de administración de placa base.
VIRTUAL Es la dirección de una interfaz virtual.

DiskInfo

Información sobre los discos individuales de una máquina.

Representación JSON 
{
  "manufacturer": string,
  "slot": integer,
  "serialNumber": string,
  "psid": string,
  "partNumber": string,
  "modelNumber": string
}
Campos
manufacturer

string

Es opcional. Es el fabricante del disco.
slot

integer

Es opcional. Es el número de ranura del disco.
serialNumber

string

Es opcional. Es el número de serie del disco.
psid

string

Es opcional. PSID del disco.
partNumber

string

Es opcional. Es el número de pieza del disco.
modelNumber

string

Es opcional. Es el número de modelo del disco.

MachineType

Enum para los tipos de máquinas que se usan para Gemini en GDC Software.

Enums
MACHINE_TYPE_UNSPECIFIED Es el tipo de máquina no especificado.
DELL_XE9680 Servidor Dell XE9680.
DELL_XE9780 Servidor Dell XE9780

MemoryInfo

Información sobre las memorias individuales de una máquina.

Representación JSON 
{
  "serialNumber": string,
  "sizeBytes": string,
  "partNumber": string
}
Campos
serialNumber

string

Es opcional. Es el número de serie de la memoria.
sizeBytes

string (int64 format)

Es opcional. Tamaño de la memoria.
partNumber

string

Es opcional. Es el número de pieza de la memoria.

ShippingInfo

ShippingInfo describe la información de logística de un envío.

Representación JSON 
{
  "carrier": enum (Carrier),
  "trackingId": string
}
Campos
carrier

enum (Carrier)

Solo salida. Es la empresa de transporte que hace el envío.
trackingId

string

Solo salida. Es el ID de seguimiento del envío.

Proveedor

Lista de operadores.

Enums
CARRIER_UNSPECIFIED Operador no especificado.
FEDEX Empresa de transporte FedEx.
UPS UPS de la empresa de transporte.
USPS Empresa de transporte: USPS.

Métodos

changeSubscription

 Actualiza la configuración de la suscripción de un hardware.

create

 Crea hardware nuevo en un proyecto y una ubicación determinados.

delete

 Borra el hardware.

get

 Obtiene los detalles del hardware.

list

 Enumera el hardware en una ubicación y un proyecto determinados.

patch

 Actualiza los parámetros de hardware.

signal

 Indica el estado de un hardware.

validate

 Valida una configuración de hardware proporcionada como datos JSON.