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

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

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

열거형
STATE_UNSPECIFIED 하드웨어 상태가 지정되지 않았습니다.
ADDITIONAL_INFO_NEEDED 진행하려면 고객의 추가 정보가 필요합니다.
BUILDING Google에서 이 하드웨어의 하드웨어 빌드를 시작했습니다.
SHIPPING 하드웨어가 제작되어 발송 중입니다.
INSTALLING 하드웨어가 설치되고 있습니다.
INSTALLED 하드웨어가 설치되었습니다.
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)
    }
  ]
}
필드
serviceTag

string

출력 전용입니다. 머신 서비스 태그입니다.

macAddresses[]

object (MacAddress)

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

name

string

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

diskInfos[]

object (DiskInfo)

출력 전용입니다. 설치된 각 디스크의 정보입니다.

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

출력 전용입니다. 디스크 모델 번호입니다.

메서드

create

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

delete

하드웨어를 삭제합니다.

get

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

list

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

patch

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