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

Solo salida. 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.

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.

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

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

Obligatorio. Son las dimensiones de la unidad de bastidores.
rackSpace

object (RackSpace)

Obligatorio. 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)
    }
  ]
}
Campos
serviceTag

string

Solo salida. 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)

Solo salida. Es la información de cada disco instalado.

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

Solo salida. Fabricante del disco.
slot

integer

Solo salida. Número de ranura del disco.
serialNumber

string

Solo salida. Número de serie del disco.
psid

string

Solo salida. Es el PSID del disco.
partNumber

string

Solo salida. Es el número de pieza del disco.
modelNumber

string

Solo salida. Número de modelo del disco.

Métodos

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.