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

Obligatorio. 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 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 suscripción para este hardware.
operations[]

object (ResourceOperation)

Solo salida. Es una lista de todas las operaciones realizadas en el 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 el 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 El hardware comenzó el aprovisionamiento.
PROVISIONING_FAILED No se pudo aprovisionar el hardware.

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. 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. 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 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. Es la 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 Es un 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. 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. 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.

ResourceOperation

Representa una operación en curso para un recurso

Representación JSON 
{
  "uid": string,
  "state": enum (State),
  "type": enum (Type),
  "stateHistory": [
    {
      object (StateHistoryEntry)
    }
  ],
  "requiresReTurnup": boolean
}
Campos
uid

string

Solo salida. Es el ID de la operación.
state

enum (State)

Solo salida. Es el estado de la operación.
type

enum (Type)

Solo salida. Es el tipo de operación.
stateHistory[]

object (StateHistoryEntry)

Solo salida. Es el historial de estados de la operación.
requiresReTurnup

boolean

Solo salida. Es una marca que indica si se requiere un nuevo lanzamiento.

Estado

Es una enumeración para los estados de la operación.

Enums
STATE_UNSPECIFIED No se especificó el estado de la operación.
AWAITING_CUSTOMER_INPUT La operación está esperando la entrada del cliente.
PROGRESSING La operación está en curso.
COMPLETED Se completó la operación.

Tipo

Es un enum para los tipos de operación.

Enums
TYPE_UNSPECIFIED Tipo de operación sin especificar.
REPAIR Operación de reparación.

StateHistoryEntry

Es una entrada para el historial del estado de la operación.

Representación JSON 
{
  "state": enum (State),
  "updateTime": string,
  "reason": string,
  "responsibleEntity": enum (Entity)
}
Campos
state

enum (State)

Solo salida. Es el estado de la operación.
updateTime

string (Timestamp format)

Solo salida. Es la marca de tiempo en la que se actualizó el estado de la operación.

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

string

Solo salida. Es el motivo del cambio de estado.
responsibleEntity

enum (Entity)

Solo salida. Es la entidad que cambió el estado.

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