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

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Solo salida. Fecha y hora en que se actualizó este hardware por última vez.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
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

object (Date)

Es opcional. Fecha de instalación solicitada para este hardware. Este campo se completa automáticamente cuando se acepta el pedido, si el HardwareGroup del hardware lo especifica. El cliente también puede completarlo.
actualInstallationDate

object (Date)

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

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 Tomacorriente europeo estándar.

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)

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.

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.