REST Resource: projects.locations.hardware

Recurso: Hardware

Uma instância de hardware instalada em um site.

Representação 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

Identificador. Nome do hardware. Formato: projects/{project}/locations/{location}/hardware/{hardware}
displayName

string

Opcional. Nome de exibição do hardware.
createTime

string (Timestamp format)

Apenas saída. Data e hora em que esse hardware foi criado.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Apenas saída. Hora em que o hardware foi atualizado pela última vez.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
labels

map (key: string, value: string)

Opcional. Rótulos associados a este hardware como pares de chave-valor. Para mais informações sobre rótulos, consulte Criar e gerenciar rótulos.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
order

string

Obrigatório. Nome do pedido a que este hardware pertence. Formato: projects/{project}/locations/{location}/orders/{order}
hardwareGroup

string

Apenas saída. Nome do grupo de hardware a que este hardware pertence. Formato: projects/{project}/locations/{location}/orders/{order}/hardwareGroups/{hardwareGroup}
site

string

Obrigatório. Nome do site a que o hardware pertence. Formato: projects/{project}/locations/{location}/sites/{site}
state

enum (State)

Apenas saída. Estado atual do hardware.
ciqUri

string

Apenas saída. Link para a planilha do Questionário de admissão do cliente (CIQ) deste hardware.
config

object (HardwareConfig)

Obrigatório. Configuração para este hardware.
estimatedInstallationDate

object (Date)

Apenas saída. Data estimada de instalação do hardware.
physicalInfo

object (HardwarePhysicalInfo)

Opcional. Propriedades físicas do hardware.
installationInfo

object (HardwareInstallationInfo)

Opcional. Informações para instalação desse hardware.
zone

string

Obrigatório. Nome da zona a que o hardware pertence. Formato: projects/{project}/locations/{location}/zones/{zone}
requestedInstallationDate

object (Date)

Opcional. Data de instalação solicitada para este hardware. Se não for especificado, esse campo será preenchido automaticamente com o fulfillmentTime do pedido no momento do envio ou com o requestedInstallationDate do HardwareGroup no momento da aceitação do pedido.
actualInstallationDate

object (Date)

Apenas saída. Data de instalação real deste hardware. Preenchido pelo Google.
machineInfos[]

object (MachineInfo)

Apenas saída. Informações de recursos por máquina necessárias para o aumento.
estimatedDeliveryDate

object (Date)

Apenas saída. A data de entrega estimada do hardware.

Estado

Estados válidos para hardware.

Tipos enumerados
STATE_UNSPECIFIED O estado do hardware não foi especificado.
ADDITIONAL_INFO_NEEDED Precisamos de mais informações do cliente para continuar.
BUILDING O Google iniciou a fabricação do hardware.
SHIPPING O hardware foi fabricado e está sendo enviado.
INSTALLING O hardware está sendo instalado.
INSTALLED O hardware foi instalado.
FAILED Ocorreu um erro e é necessária a intervenção do cliente.

HardwarePhysicalInfo

Propriedades físicas de um hardware.

Representação JSON 
{
  "powerReceptacle": enum (PowerReceptacleType),
  "networkUplink": enum (NetworkUplinkType),
  "voltage": enum (Voltage),
  "amperes": enum (Amperes)
}
Campos
powerReceptacle

enum (PowerReceptacleType)

Obrigatório. O tipo de receptáculo de energia.
voltage

enum (Voltage)

Obrigatório. Tensão da fonte de alimentação.
amperes

enum (Amperes)

Obrigatório. Amperagem da fonte de alimentação.

PowerReceptacleType

Tipos válidos de receptáculo de energia.

Tipos enumerados
POWER_RECEPTACLE_TYPE_UNSPECIFIED O tipo de tomada do local não foi especificado.
NEMA_5_15 NEMA 5-15.
C_13 C13.
STANDARD_EU

Tomada europeia padrão.
TYPE_G_BS1363 Tipo G / BS1363.
CEE_7_3 C 7/3.
CEE_7_5 C 7/5.
TYPE_F Tipo F.

NetworkUplinkType

Tipos válidos de uplink de rede.

Tipos enumerados
RJ_45 RJ-45.

Tensão

Valores de tensão válidos.

Tipos enumerados
VOLTAGE_UNSPECIFIED A tensão não foi especificada.
VOLTAGE_110 120V.
VOLTAGE_220 220V.

Amperes

Valores de amperes válidos.

Tipos enumerados
AMPERES_UNSPECIFIED A amperagem não foi especificada.
AMPERES_15 15A.

HardwareInstallationInfo

Informações para instalação de um hardware.

Representação JSON 
{
  "rackLocation": string,
  "powerDistanceMeters": integer,
  "switchDistanceMeters": integer,
  "rackUnitDimensions": {
    object (Dimensions)
  },
  "rackSpace": {
    object (RackSpace)
  },
  "rackType": enum (RackType)
}
Campos
rackLocation

string

Obrigatório. Localização do rack no site, por exemplo, 2º andar, sala 201, linha 7, rack 3.
powerDistanceMeters

integer

Obrigatório. Distância da tomada em metros.
switchDistanceMeters

integer

Obrigatório. Distância do switch de rede em metros.
rackUnitDimensions

object (Dimensions)

Obrigatório. Dimensões da unidade de rack.
rackSpace

object (RackSpace)

Obrigatório. Espaço do rack alocado para o hardware.
rackType

enum (RackType)

Obrigatório. Tipo de rack.

Dimensões

Representa as dimensões de um objeto.

Representação JSON 
{
  "widthInches": number,
  "heightInches": number,
  "depthInches": number
}
Campos
widthInches

number

Obrigatório. Largura em polegadas.
heightInches

number

Obrigatório. Altura em polegadas.
depthInches

number

Obrigatório. Profundidade em polegadas.

RackType

Tipos de rack válidos.

Tipos enumerados
RACK_TYPE_UNSPECIFIED O tipo de rack não foi especificado.
TWO_POST Rack de dois postes.
FOUR_POST Rack de quatro postes.

MachineInfo

Informações sobre fornecedores de máquinas individuais que serão fornecidas durante a ativação.

Representação JSON 
{
  "serviceTag": string,
  "macAddresses": [
    {
      object (MacAddress)
    }
  ],
  "name": string,
  "diskInfos": [
    {
      object (DiskInfo)
    }
  ]
}
Campos
serviceTag

string

Apenas saída. Tag de serviço da máquina.
macAddresses[]

object (MacAddress)

Apenas saída. Cada endereço MAC associado.
name

string

Apenas saída. Nome da máquina.
diskInfos[]

object (DiskInfo)

Apenas saída. Informações de cada disco instalado.

MacAddress

Mensagem para descrever o endereço MAC de uma máquina.

Representação JSON 
{
  "address": string,
  "type": enum (AddressType),
  "ipv4Address": string
}
Campos
address

string

Apenas saída. String de endereço.
type

enum (AddressType)

Apenas saída. Tipo de endereço para este endereço MAC.
ipv4Address

string

Apenas saída. Endereço IP estático (se usado) associado ao endereço MAC. Aplicável somente ao tipo de endereço MAC VIRTUAL.

AddressType

Enumeração para os diferentes tipos de endereço MAC.

Tipos enumerados
ADDRESS_TYPE_UNSPECIFIED Tipo de endereço não especificado.
NIC Endereço de uma placa de rede.
BMC Endereço de um controlador de gerenciamento de placa-mãe.
VIRTUAL Endereço de uma interface virtual.

DiskInfo

Informações sobre discos individuais em uma máquina.

Representação JSON 
{
  "manufacturer": string,
  "slot": integer,
  "serialNumber": string,
  "psid": string,
  "partNumber": string,
  "modelNumber": string
}
Campos
manufacturer

string

Apenas saída. Fabricante do disco.
slot

integer

Apenas saída. Número do slot do disco.
serialNumber

string

Apenas saída. Número de série do disco.
psid

string

Apenas saída. PSID do disco.
partNumber

string

Apenas saída. Número da peça do disco.
modelNumber

string

Apenas saída. Número do modelo do disco.

Métodos

create

 Cria um novo hardware em determinado projeto e local.

delete

 Exclui o hardware.

get

 Recebe detalhes do hardware.

list

 Lista o hardware em um determinado projeto e local.

patch

 Atualiza os parâmetros de hardware.