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)
  },
  "aiCapable": boolean,
  "subscriptionConfigs": [
    {
      object (SubscriptionConfig)
    }
  ],
  "operations": [
    {
      object (ResourceOperation)
    }
  ]
}
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
(deprecated)

object (Date)

Opcional. Descontinuado: a data de instalação solicitada foi movida para o recurso "Pedido". Use customerRequestedInstallationDate no recurso "Order".
actualInstallationDate

object (Date)

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

object (MachineInfo)

Opcional. 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.
aiCapable

boolean

Apenas saída. Indica se o hardware é para o Gemini no software GDC.
subscriptionConfigs[]

object (SubscriptionConfig)

Apenas saída. Configurações de assinatura para este hardware.
operations[]

object (ResourceOperation)

Apenas saída. Lista de todas as operações realizadas no 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.
INFO_COMPLETE O hardware tem todas as informações necessárias.
READY_FOR_PROVISIONING O hardware está pronto para provisionamento.
PROVISIONING_STARTED O hardware começou o provisionamento.
PROVISIONING_FAILED Falha no provisionamento de hardware.

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

Descontinuado. Use TYPE_G_BS1363, CEE_7_3, CEE_7_5 ou TYPE_F.
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

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

Opcional. Dimensões da unidade de rack.
rackSpace

object (RackSpace)

Opcional. 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)
    }
  ],
  "machineType": enum (MachineType),
  "tpmEkCertHash": string,
  "gpuSerialNumbers": [
    string
  ],
  "cpuSerialNumbers": [
    string
  ],
  "memoryInfos": [
    {
      object (MemoryInfo)
    }
  ],
  "idracMacAddress": string,
  "nicSerialNumbers": [
    string
  ]
}
Campos
serviceTag

string

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

Opcional. Informações de cada disco instalado.
machineType

enum (MachineType)

Opcional. Tipo de máquina. Obrigatório para hardware que executa o Gemini no software GDC.
tpmEkCertHash

string

Opcional. Hash do certificado EK do TPM. Obrigatório durante o conserto do hardware.
gpuSerialNumbers[]

string

Opcional. Números de série da GPU. Obrigatório durante o conserto do hardware.
cpuSerialNumbers[]

string

Opcional. Números de série da CPU. Obrigatório durante o conserto do hardware.
memoryInfos[]

object (MemoryInfo)

Opcional. Informações sobre cada memória instalada. Obrigatório durante o conserto do hardware.
idracMacAddress

string

Opcional. Endereço MAC do iDRAC. Obrigatório durante o conserto do hardware.
nicSerialNumbers[]

string

Opcional. Números de série da NIC. Obrigatório durante o conserto do hardware.

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

Opcional. Fabricante do disco.
slot

integer

Opcional. Número do slot do disco.
serialNumber

string

Opcional. Número de série do disco.
psid

string

Opcional. PSID do disco.
partNumber

string

Opcional. Número da peça do disco.
modelNumber

string

Opcional. Número do modelo do disco.

MachineType

Enumeração para tipos de máquina usados no Gemini no software GDC.

Tipos enumerados
MACHINE_TYPE_UNSPECIFIED Tipo de máquina não especificado.
DELL_XE9680 Servidor Dell XE9680.
DELL_XE9780 Servidor Dell XE9780.

MemoryInfo

Informações sobre memórias individuais em uma máquina.

Representação JSON 
{
  "serialNumber": string,
  "sizeBytes": string,
  "partNumber": string
}
Campos
serialNumber

string

Opcional. Número de série da memória.
sizeBytes

string (int64 format)

Opcional. Tamanho da memória.
partNumber

string

Opcional. Número da peça de memória.

ResourceOperation

Representa uma operação em andamento para um recurso.

Representação JSON 
{
  "uid": string,
  "state": enum (State),
  "type": enum (Type),
  "stateHistory": [
    {
      object (StateHistoryEntry)
    }
  ],
  "requiresReTurnup": boolean
}
Campos
uid

string

Apenas saída. ID da operação.
state

enum (State)

Apenas saída. Estado da operação.
type

enum (Type)

Apenas saída. Tipo de operação.
stateHistory[]

object (StateHistoryEntry)

Apenas saída. Histórico de estado da operação.
requiresReTurnup

boolean

Apenas saída. Uma flag para indicar se é necessário um novo aumento.

Estado

Enumeração para estados de operação.

Tipos enumerados
STATE_UNSPECIFIED Estado de operação não especificado.
AWAITING_CUSTOMER_INPUT A operação está aguardando entrada do cliente.
PROGRESSING A operação está em andamento.
COMPLETED A operação foi concluída.

Tipo

Enumeração para tipos de operação.

Tipos enumerados
TYPE_UNSPECIFIED Tipo de operação não especificado.
REPAIR Operação de reparo.

StateHistoryEntry

Entrada para o histórico de estados da operação.

Representação JSON 
{
  "state": enum (State),
  "updateTime": string,
  "reason": string,
  "responsibleEntity": enum (Entity)
}
Campos
state

enum (State)

Apenas saída. Estado da operação.
updateTime

string (Timestamp format)

Apenas saída. Carimbo de data/hora em que o estado da operação foi atualizado.

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

string

Apenas saída. Motivo da mudança de estado.
responsibleEntity

enum (Entity)

Apenas saída. Entidade que mudou o estado.

Métodos

changeSubscription

 Atualiza a configuração de assinatura de um hardware.

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.

signal

 Sinaliza o estado de um hardware.