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. Nombre de este hardware. Formato: projects/{project}/locations/{location}/hardware/{hardware}
displayName

string

Es opcional. Nombre visible de este hardware.
createTime

string (Timestamp format)

Solo salida. Fecha y hora en 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. Fecha y hora en 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. Nombre del grupo de hardware al que pertenece este hardware. Formato: projects/{project}/locations/{location}/orders/{order}/hardwareGroups/{hardwareGroup}
site

string

Obligatorio. 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. Es la configuración de este hardware.
estimatedInstallationDate

object (Date)

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

object (HardwarePhysicalInfo)

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

object (HardwareInstallationInfo)

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

string

Obligatorio. 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 trasladó al recurso Order. En su lugar, usa customerRequestedInstallationDate en el recurso Order.
actualInstallationDate

object (Date)

Solo salida. Fecha de instalación real de este hardware. Google completa este campo.
machineInfos[]

object (MachineInfo)

Es opcional. Es la información de los activos por máquina que se necesita para el lanzamiento.
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 suscripción para este hardware.
operations[]

object (ResourceOperation)

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

object (Status)

Solo salida. Son los errores que se produjeron durante la activación de la intención de hardware. Los metadatos de ErrorInfo incluirán la marca de tiempo y si el error se puede volver a intentar.
shippingInfo

object (ShippingInfo)

Solo salida. Es la información de envío de este hardware.

Estado

Estados válidos para el hardware.

Enums
STATE_UNSPECIFIED El estado del hardware no está especificado.
ADDITIONAL_INFO_NEEDED Se requiere más información del cliente para avanzar.
BUILDING Google comenzó a fabricar hardware para este dispositivo.
SHIPPING El hardware se fabricó 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 Comenzó el aprovisionamiento de hardware.
PROVISIONING_FAILED No se pudo aprovisionar el hardware.
AWAITING_IDENTIFIERS Es necesario agregar los identificadores del hardware.
READY_FOR_BOOTSTRAP El hardware está listo para el inicio.

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

Son los 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

Son los 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

Amperios

Valores de amperios válidos.

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

HardwareInstallationInfo

Es la 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 rack en el sitio, p.ej., piso 2, habitación 201, fila 7, rack 3.
powerDistanceMeters

integer

Obligatorio. Distancia desde el tomacorriente en metros
switchDistanceMeters

integer

Obligatorio. Distancia desde el switch de red en metros.
rackUnitDimensions

object (Dimensions)

Es opcional. 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 estructura.

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. Altura en pulgadas.
depthInches

number

Obligatorio. Profundidad en pulgadas.

RackType

Son los tipos de soporte válidos.

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

MachineInfo

Es la información sobre los proveedores de máquinas individuales que se proporcionará durante la puesta en marcha.

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. Nombre de la máquina.
diskInfos[]

object (DiskInfo)

Es opcional. Es la información de cada disco instalado.
machineType

enum (MachineType)

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

string

Es opcional. Es el hash del certificado de clave externa del TPM. Se requiere durante la reparación del hardware.
gpuSerialNumbers[]

string

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

string

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

object (MemoryInfo)

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

string

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

string

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

MacAddress

Es un 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 una cadena de dirección.
type

enum (AddressType)

Solo salida. Tipo de dirección para esta dirección MAC.
ipv4Address

string

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

AddressType

Es una enumeración para los diferentes tipos de direcciones MAC.

Enums
ADDRESS_TYPE_UNSPECIFIED Tipo de dirección sin especificar.
NIC Es la dirección de una tarjeta de interfaz de red.
BMC Es la dirección de un controlador de administración de la placa base.
VIRTUAL Es la dirección de una interfaz virtual.

DiskInfo

Es 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. Número de ranura del disco.
serialNumber

string

Es opcional. Número de serie del disco.
psid

string

Es opcional. Es el 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

Es una enumeración de los tipos de máquinas que se usan para Gemini en el software de GDC.

Enums
MACHINE_TYPE_UNSPECIFIED Tipo de máquina sin especificar.
DELL_XE9680 Servidor Dell XE9680.
DELL_XE9780 Servidor Dell XE9780.

MemoryInfo

Es información sobre los recuerdos individuales en una máquina.

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

string

Es opcional. Número de serie de la memoria.
sizeBytes

string (int64 format)

Es opcional. Tamaño de la memoria.
partNumber

string

Es opcional. Número de pieza de la memoria.

ShippingInfo

ShippingInfo describe la información 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 del envío.
trackingId

string

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

Proveedor

Es la lista de empresas de transporte.

Enums
CARRIER_UNSPECIFIED No se especificó el operador.
FEDEX Es el operador FedEx.
UPS Es el operador UPS.
USPS Operador USPS.

Métodos

changeSubscription

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

create

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

delete

 Borra hardware.

get

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