REST Resource: projects.locations.hardware

리소스: Hardware

사이트에 설치된 하드웨어 인스턴스입니다.

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)
    }
  ]
}
필드
name

string

식별자. 이 하드웨어의 이름입니다. 형식: projects/{project}/locations/{location}/hardware/{hardware}
displayName

string

선택사항입니다. 이 하드웨어의 표시 이름입니다.
createTime

string (Timestamp format)

출력 전용입니다. 이 하드웨어가 생성된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
updateTime

string (Timestamp format)

출력 전용입니다. 이 하드웨어가 마지막으로 업데이트된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
labels

map (key: string, value: string)

선택사항입니다. 이 하드웨어와 연결된 라벨(키-값 쌍)입니다. 라벨에 대한 자세한 내용은 라벨 만들기 및 관리를 참고하세요.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
order

string

필수 항목입니다. 이 하드웨어가 속한 주문의 이름입니다. 형식: projects/{project}/locations/{location}/orders/{order}
hardwareGroup

string

출력 전용입니다. 이 하드웨어가 속한 하드웨어 그룹의 이름입니다. 형식: projects/{project}/locations/{location}/orders/{order}/hardwareGroups/{hardwareGroup}
site

string

필수 항목입니다. 이 하드웨어가 속한 사이트의 이름입니다. 형식: projects/{project}/locations/{location}/sites/{site}
state

enum (State)

출력 전용입니다. 이 하드웨어의 현재 상태입니다.
ciqUri

string

출력 전용입니다. 이 하드웨어의 고객 접수 설문지 (CIQ) 시트로 연결되는 링크입니다.
config

object (HardwareConfig)

필수 항목입니다. 이 하드웨어의 구성입니다.
estimatedInstallationDate

object (Date)

출력 전용입니다. 이 하드웨어의 예상 설치일입니다.
physicalInfo

object (HardwarePhysicalInfo)

선택사항입니다. 이 하드웨어의 물리적 속성입니다.
installationInfo

object (HardwareInstallationInfo)

선택사항입니다. 이 하드웨어 설치에 관한 정보입니다.
zone

string

필수 항목입니다. 이 하드웨어가 속한 영역의 이름입니다. 형식: projects/{project}/locations/{location}/zones/{zone}
requestedInstallationDate
(deprecated)

object (Date)

선택사항입니다. 지원 중단됨: 요청된 설치 날짜가 주문 리소스로 이동되었습니다. 대신 주문 리소스에 customerRequestedInstallationDate를 사용하세요.
actualInstallationDate

object (Date)

출력 전용입니다. 이 하드웨어의 실제 설치 날짜입니다. Google에서 입력합니다.
machineInfos[]

object (MachineInfo)

선택사항입니다. 설정에 필요한 머신별 애셋 정보입니다.
estimatedDeliveryDate

object (Date)

출력 전용입니다. 하드웨어의 예상 배송일입니다.
aiCapable

boolean

출력 전용입니다. 이 하드웨어가 GDC 소프트웨어의 Gemini용인지 나타냅니다.
subscriptionConfigs[]

object (SubscriptionConfig)

출력 전용입니다. 이 하드웨어의 정기 결제 구성입니다.
operations[]

object (ResourceOperation)

출력 전용입니다. 하드웨어에서 실행된 모든 작업의 목록입니다.

주

하드웨어의 유효한 상태입니다.

열거형
STATE_UNSPECIFIED 하드웨어 상태가 지정되지 않았습니다.
ADDITIONAL_INFO_NEEDED 진행하려면 고객의 추가 정보가 필요합니다.
BUILDING Google에서 이 하드웨어의 하드웨어 빌드를 시작했습니다.
SHIPPING 하드웨어가 제작되어 발송 중입니다.
INSTALLING 하드웨어가 설치되고 있습니다.
INSTALLED 하드웨어가 설치되었습니다.
FAILED 오류가 발생하여 고객의 개입이 필요합니다.
INFO_COMPLETE 하드웨어에 필요한 정보가 모두 있습니다.
READY_FOR_PROVISIONING 하드웨어가 프로비저닝 준비가 되었습니다.
PROVISIONING_STARTED 하드웨어 프로비저닝이 시작되었습니다.
PROVISIONING_FAILED 하드웨어 프로비저닝에 실패했습니다.

HardwarePhysicalInfo

하드웨어의 물리적 속성입니다.

JSON 표현 
{
  "powerReceptacle": enum (PowerReceptacleType),
  "networkUplink": enum (NetworkUplinkType),
  "voltage": enum (Voltage),
  "amperes": enum (Amperes)
}
필드
powerReceptacle

enum (PowerReceptacleType)

필수 항목입니다. 전원 콘센트 유형입니다.
voltage

enum (Voltage)

필수 항목입니다. 전원 공급 장치의 전압입니다.
amperes

enum (Amperes)

필수 항목입니다. 전원 공급 장치의 암페어입니다.

PowerReceptacleType

유효한 전원 콘센트 유형입니다.

열거형
POWER_RECEPTACLE_TYPE_UNSPECIFIED 시설 플러그 유형이 지정되지 않았습니다.
NEMA_5_15 NEMA 5-15
C_13 C13.
STANDARD_EU

지원 중단됨: 대신 TYPE_G_BS1363, CEE_7_3, CEE_7_5 또는 TYPE_F를 사용하세요.
TYPE_G_BS1363 G 유형 / BS1363
CEE_7_3 C 7/3.
CEE_7_5 C 7/5.
TYPE_F F형

NetworkUplinkType

유효한 네트워크 업링크 유형입니다.

열거형
RJ_45 RJ-45

전압

유효한 전압 값입니다.

열거형
VOLTAGE_UNSPECIFIED 전압이 지정되지 않았습니다.
VOLTAGE_110 120V
VOLTAGE_220 220V

암페어

유효한 암페어 값입니다.

열거형
AMPERES_UNSPECIFIED 암페어가 지정되지 않았습니다.
AMPERES_15 15A.

HardwareInstallationInfo

하드웨어 설치 정보입니다.

JSON 표현 
{
  "rackLocation": string,
  "powerDistanceMeters": integer,
  "switchDistanceMeters": integer,
  "rackUnitDimensions": {
    object (Dimensions)
  },
  "rackSpace": {
    object (RackSpace)
  },
  "rackType": enum (RackType)
}
필드
rackLocation

string

선택사항입니다. 사이트의 랙 위치입니다(예: 2층, 201호, 7열, 3번 랙).
powerDistanceMeters

integer

필수 항목입니다. 전원 콘센트로부터의 거리(미터)입니다.
switchDistanceMeters

integer

필수 항목입니다. 네트워크 스위치로부터의 거리(미터)입니다.
rackUnitDimensions

object (Dimensions)

선택사항입니다. 랙 유닛의 크기입니다.
rackSpace

object (RackSpace)

선택사항입니다. 하드웨어에 할당된 랙 공간입니다.
rackType

enum (RackType)

필수 항목입니다. 랙 유형입니다.

측정기준

객체의 크기를 나타냅니다.

JSON 표현 
{
  "widthInches": number,
  "heightInches": number,
  "depthInches": number
}
필드
widthInches

number

필수 항목입니다. 너비(인치)입니다.
heightInches

number

필수 항목입니다. 높이(인치)입니다.
depthInches

number

필수 항목입니다. 깊이(인치)입니다.

RackType

유효한 랙 유형입니다.

열거형
RACK_TYPE_UNSPECIFIED 랙 유형이 지정되지 않았습니다.
TWO_POST 기둥이 2개인 랙
FOUR_POST 4기둥 랙

MachineInfo

턴업 중에 공급업체가 제공하는 개별 머신에 관한 정보입니다.

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
  ]
}
필드
serviceTag

string

선택사항입니다. 머신 서비스 태그입니다.
macAddresses[]

object (MacAddress)

출력 전용입니다. 연결된 각 MAC 주소
name

string

출력 전용입니다. 머신 이름입니다.
diskInfos[]

object (DiskInfo)

선택사항입니다. 설치된 각 디스크의 정보입니다.
machineType

enum (MachineType)

선택사항입니다. 머신 유형 GDC 소프트웨어에서 Gemini를 실행하는 하드웨어에 필요합니다.
tpmEkCertHash

string

선택사항입니다. TPM EK 인증서 해시입니다. 하드웨어 수리 중에 필요합니다.
gpuSerialNumbers[]

string

선택사항입니다. GPU 일련번호입니다. 하드웨어 수리 중에 필요합니다.
cpuSerialNumbers[]

string

선택사항입니다. CPU 일련번호입니다. 하드웨어 수리 중에 필요합니다.
memoryInfos[]

object (MemoryInfo)

선택사항입니다. 설치된 각 메모리의 정보입니다. 하드웨어 수리 중에 필요합니다.
idracMacAddress

string

선택사항입니다. iDRAC MAC 주소입니다. 하드웨어 수리 중에 필요합니다.
nicSerialNumbers[]

string

선택사항입니다. NIC 일련번호입니다. 하드웨어 수리 중에 필요합니다.

MacAddress

머신의 MAC 주소를 설명하는 메시지입니다.

JSON 표현 
{
  "address": string,
  "type": enum (AddressType),
  "ipv4Address": string
}
필드
address

string

출력 전용입니다. 주소 문자열입니다.
type

enum (AddressType)

출력 전용입니다. 이 MAC 주소의 주소 유형입니다.
ipv4Address

string

출력 전용입니다. MAC 주소와 연결된 고정 IP 주소 (사용된 경우)입니다. 가상 MAC 주소 유형에만 적용됩니다.

AddressType

다양한 유형의 MAC 주소의 열거형입니다.

열거형
ADDRESS_TYPE_UNSPECIFIED 지정되지 않은 주소 유형입니다.
NIC 네트워크 인터페이스 카드의 주소입니다.
BMC 베이스보드 관리 컨트롤러의 주소입니다.
VIRTUAL 가상 인터페이스의 주소입니다.

DiskInfo

머신의 개별 디스크에 관한 정보입니다.

JSON 표현 
{
  "manufacturer": string,
  "slot": integer,
  "serialNumber": string,
  "psid": string,
  "partNumber": string,
  "modelNumber": string
}
필드
manufacturer

string

선택사항입니다. 디스크 제조업체입니다.
slot

integer

선택사항입니다. 디스크 슬롯 번호입니다.
serialNumber

string

선택사항입니다. 디스크 일련번호입니다.
psid

string

선택사항입니다. 디스크 PSID입니다.
partNumber

string

선택사항입니다. 디스크 부품 번호입니다.
modelNumber

string

선택사항입니다. 디스크 모델 번호입니다.

MachineType

GDC 소프트웨어의 Gemini에 사용되는 머신 유형의 enum입니다.

열거형
MACHINE_TYPE_UNSPECIFIED 지정되지 않은 머신 유형입니다.
DELL_XE9680 Dell XE9680 서버
DELL_XE9780 Dell XE9780 서버

MemoryInfo

머신에 있는 개별 메모리에 관한 정보입니다.

JSON 표현 
{
  "serialNumber": string,
  "sizeBytes": string,
  "partNumber": string
}
필드
serialNumber

string

선택사항입니다. 메모리 일련번호입니다.
sizeBytes

string (int64 format)

선택사항입니다. 메모리 크기입니다.
partNumber

string

선택사항입니다. 메모리 부품 번호입니다.

ResourceOperation

리소스의 진행 중인 작업을 나타냅니다.

JSON 표현 
{
  "uid": string,
  "state": enum (State),
  "type": enum (Type),
  "stateHistory": [
    {
      object (StateHistoryEntry)
    }
  ],
  "requiresReTurnup": boolean
}
필드
uid

string

출력 전용입니다. 작업 ID입니다.
state

enum (State)

출력 전용입니다. 작업 상태입니다.
type

enum (Type)

출력 전용입니다. 작업 유형입니다.
stateHistory[]

object (StateHistoryEntry)

출력 전용입니다. 작업의 상태 기록입니다.
requiresReTurnup

boolean

출력 전용입니다. 다시 켜야 하는지 여부를 나타내는 플래그입니다.

주

작업 상태의 열거형입니다.

열거형
STATE_UNSPECIFIED 지정되지 않은 작업 상태입니다.
AWAITING_CUSTOMER_INPUT 작업에서 고객 입력을 기다리는 중입니다.
PROGRESSING 작업이 진행 중입니다.
COMPLETED 작업이 완료되었습니다.

유형

작업 유형의 enum입니다.

열거형
TYPE_UNSPECIFIED 지정되지 않은 작업 유형입니다.
REPAIR 복구 작업입니다.

StateHistoryEntry

작업 상태 기록 항목입니다.

JSON 표현 
{
  "state": enum (State),
  "updateTime": string,
  "reason": string,
  "responsibleEntity": enum (Entity)
}
필드
state

enum (State)

출력 전용입니다. 작업 상태입니다.
updateTime

string (Timestamp format)

출력 전용입니다. 작업 상태가 업데이트된 타임스탬프입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
reason

string

출력 전용입니다. 상태 변경 이유입니다.
responsibleEntity

enum (Entity)

출력 전용입니다. 상태를 변경한 항목입니다.

메서드

changeSubscription

 하드웨어의 정기 결제 구성을 업데이트합니다.

create

 특정 프로젝트와 위치에 새 하드웨어를 만듭니다.

delete

 하드웨어를 삭제합니다.

get

 하드웨어 세부정보를 가져옵니다.

list

 특정 프로젝트와 위치의 하드웨어를 나열합니다.

patch

 하드웨어 매개변수를 업데이트합니다.

signal

 하드웨어의 상태를 신호로 알립니다.