Package google.cloud.gdchardwaremanagement.v1alpha

색인

GDCHardwareManagement

GDC 하드웨어 관리 서비스입니다.

CancelOrder

rpc CancelOrder(CancelOrderRequest) returns (Operation)

주문을 취소합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.orders.submit

자세한 내용은 IAM 문서를 참조하세요.

CreateComment

rpc CreateComment(CreateCommentRequest) returns (Operation)

주문에 새 댓글을 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.comments.create

자세한 내용은 IAM 문서를 참조하세요.

CreateHardware

rpc CreateHardware(CreateHardwareRequest) returns (Operation)

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

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.hardware.create

자세한 내용은 IAM 문서를 참조하세요.

CreateHardwareGroup

rpc CreateHardwareGroup(CreateHardwareGroupRequest) returns (Operation)

지정된 주문에 새 하드웨어 그룹을 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.hardwareGroups.create

자세한 내용은 IAM 문서를 참조하세요.

CreateOrder

rpc CreateOrder(CreateOrderRequest) returns (Operation)

특정 프로젝트와 위치에 새 주문을 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.orders.create

자세한 내용은 IAM 문서를 참조하세요.

CreateSite

rpc CreateSite(CreateSiteRequest) returns (Operation)

특정 프로젝트와 위치에 새 사이트를 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.sites.create

자세한 내용은 IAM 문서를 참조하세요.

CreateZone

rpc CreateZone(CreateZoneRequest) returns (Operation)

특정 프로젝트와 위치에 새 영역을 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.zones.create

자세한 내용은 IAM 문서를 참조하세요.

DeleteHardware

rpc DeleteHardware(DeleteHardwareRequest) returns (Operation)

하드웨어를 삭제합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.hardware.delete

자세한 내용은 IAM 문서를 참조하세요.

DeleteHardwareGroup

rpc DeleteHardwareGroup(DeleteHardwareGroupRequest) returns (Operation)

하드웨어 그룹을 삭제합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.hardwareGroups.delete

자세한 내용은 IAM 문서를 참조하세요.

DeleteOrder

rpc DeleteOrder(DeleteOrderRequest) returns (Operation)

주문을 삭제합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.orders.delete

자세한 내용은 IAM 문서를 참조하세요.

DeleteSite

rpc DeleteSite(DeleteSiteRequest) returns (Operation)

사이트를 삭제합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.sites.delete

자세한 내용은 IAM 문서를 참조하세요.

DeleteZone

rpc DeleteZone(DeleteZoneRequest) returns (Operation)

영역을 삭제합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.zones.delete

자세한 내용은 IAM 문서를 참조하세요.

GetChangeLogEntry

rpc GetChangeLogEntry(GetChangeLogEntryRequest) returns (ChangeLogEntry)

주문 변경사항의 세부정보를 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.changeLogEntries.get

자세한 내용은 IAM 문서를 참조하세요.

GetComment

rpc GetComment(GetCommentRequest) returns (Comment)

댓글의 내용을 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.comments.get

자세한 내용은 IAM 문서를 참조하세요.

GetHardware

rpc GetHardware(GetHardwareRequest) returns (Hardware)

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

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.hardware.get

자세한 내용은 IAM 문서를 참조하세요.

GetHardwareGroup

rpc GetHardwareGroup(GetHardwareGroupRequest) returns (HardwareGroup)

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

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.hardwareGroups.get

자세한 내용은 IAM 문서를 참조하세요.

GetOrder

rpc GetOrder(GetOrderRequest) returns (Order)

주문의 세부정보를 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.orders.get

자세한 내용은 IAM 문서를 참조하세요.

GetSite

rpc GetSite(GetSiteRequest) returns (Site)

사이트의 세부정보를 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.sites.get

자세한 내용은 IAM 문서를 참조하세요.

GetSku

rpc GetSku(GetSkuRequest) returns (Sku)

SKU의 세부정보를 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.skus.get

자세한 내용은 IAM 문서를 참조하세요.

GetZone

rpc GetZone(GetZoneRequest) returns (Zone)

영역의 세부정보를 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.zones.get

자세한 내용은 IAM 문서를 참조하세요.

ListChangeLogEntries

rpc ListChangeLogEntries(ListChangeLogEntriesRequest) returns (ListChangeLogEntriesResponse)

주문에 적용된 변경사항을 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.changeLogEntries.list

자세한 내용은 IAM 문서를 참조하세요.

ListComments

rpc ListComments(ListCommentsRequest) returns (ListCommentsResponse)

주문에 대한 댓글을 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.comments.list

자세한 내용은 IAM 문서를 참조하세요.

ListHardware

rpc ListHardware(ListHardwareRequest) returns (ListHardwareResponse)

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

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.hardware.list

자세한 내용은 IAM 문서를 참조하세요.

ListHardwareGroups

rpc ListHardwareGroups(ListHardwareGroupsRequest) returns (ListHardwareGroupsResponse)

지정된 순서로 하드웨어 그룹을 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.hardwareGroups.list

자세한 내용은 IAM 문서를 참조하세요.

ListOrders

rpc ListOrders(ListOrdersRequest) returns (ListOrdersResponse)

특정 프로젝트와 위치의 주문을 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.orders.list

자세한 내용은 IAM 문서를 참조하세요.

ListSites

rpc ListSites(ListSitesRequest) returns (ListSitesResponse)

특정 프로젝트와 위치의 사이트를 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.sites.list

자세한 내용은 IAM 문서를 참조하세요.

ListSkus

rpc ListSkus(ListSkusRequest) returns (ListSkusResponse)

특정 프로젝트와 위치의 SKU를 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.skus.list

자세한 내용은 IAM 문서를 참조하세요.

ListZones

rpc ListZones(ListZonesRequest) returns (ListZonesResponse)

특정 프로젝트와 위치의 영역을 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.zones.list

자세한 내용은 IAM 문서를 참조하세요.

RecordActionOnComment

rpc RecordActionOnComment(RecordActionOnCommentRequest) returns (Comment)

댓글에 대한 조치를 기록합니다. 요청에 지정된 작업이 READ인 경우 댓글의 조회 시간이 요청이 수신된 시간으로 설정됩니다. 댓글이 이미 읽은 상태로 표시된 경우 후속 호출은 무시됩니다. 작업이 UNREAD인 경우 댓글에서 조회 시간이 삭제됩니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

RequestOrderDateChange

rpc RequestOrderDateChange(RequestOrderDateChangeRequest) returns (Operation)

단일 주문의 요청된 날짜 변경을 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.orders.update

자세한 내용은 IAM 문서를 참조하세요.

SignalZoneState

rpc SignalZoneState(SignalZoneStateRequest) returns (Operation)

영역의 상태를 알립니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.zones.update

자세한 내용은 IAM 문서를 참조하세요.

SubmitOrder

rpc SubmitOrder(SubmitOrderRequest) returns (Operation)

주문을 제출합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.orders.submit

자세한 내용은 IAM 문서를 참조하세요.

UpdateHardware

rpc UpdateHardware(UpdateHardwareRequest) returns (Operation)

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

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.hardware.update

자세한 내용은 IAM 문서를 참조하세요.

UpdateHardwareGroup

rpc UpdateHardwareGroup(UpdateHardwareGroupRequest) returns (Operation)

하드웨어 그룹의 파라미터를 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.hardwareGroups.update

자세한 내용은 IAM 문서를 참조하세요.

UpdateOrder

rpc UpdateOrder(UpdateOrderRequest) returns (Operation)

주문의 매개변수를 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.orders.update

자세한 내용은 IAM 문서를 참조하세요.

UpdateSite

rpc UpdateSite(UpdateSiteRequest) returns (Operation)

사이트의 파라미터를 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.sites.update

자세한 내용은 IAM 문서를 참조하세요.

UpdateZone

rpc UpdateZone(UpdateZoneRequest) returns (Operation)

영역의 파라미터를 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • gdchardwaremanagement.zones.update

자세한 내용은 IAM 문서를 참조하세요.

CancelOrderRequest

주문 취소 요청입니다.

필드
name

string

필수 항목입니다. 주문 이름입니다. 형식: projects/{project}/locations/{location}/orders/{order}

request_id

string

선택사항입니다. 이 요청의 선택적 고유 식별자입니다. AIP-155를 참고하세요.

ChangeLogEntry

주문에 대한 변경사항의 로그 항목입니다.

필드
name

string

식별자. 이 변경 로그 항목의 이름입니다. 형식: projects/{project}/locations/{location}/orders/{order}/changeLogEntries/{change_log_entry}

create_time

Timestamp

출력 전용입니다. 이 변경 로그 항목이 생성된 시간입니다.

labels

map<string, string>

선택사항입니다. 이 변경 로그 항목과 연결된 라벨(키-값 쌍)입니다. 라벨에 대한 자세한 내용은 라벨 만들기 및 관리를 참고하세요.

log

string

출력 전용입니다. 이 로그 항목의 콘텐츠입니다.

댓글

주문에 대한 의견입니다.

필드
name

string

식별자. 이 댓글의 이름입니다. 형식: projects/{project}/locations/{location}/orders/{order}/comments/{comment}

create_time

Timestamp

출력 전용입니다. 이 댓글이 생성된 시간입니다.

labels

map<string, string>

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

author

string

출력 전용입니다. 이 댓글 작성자의 사용자 이름입니다. 댓글을 만들 때 사용된 사용자 인증 정보에서 자동으로 채워집니다.

text

string

필수 항목입니다. 이 댓글의 텍스트입니다. 텍스트 길이는 1,000자(영문 기준) 이하여야 합니다.

customer_viewed_time

Timestamp

출력 전용입니다. 고객이 이 댓글을 처음 본 시간의 타임스탬프입니다. 댓글을 확인하지 않은 경우 이 타임스탬프는 설정되지 않습니다.

author_entity

Entity

출력 전용입니다. 작성자가 속한 법인입니다.

연락처

담당자의 연락처 세부정보입니다.

필드
given_name

string

필수 항목입니다. 연락처의 이름입니다.

family_name

string

선택사항입니다. 연락처의 성입니다.

email

string

필수 항목입니다. 연락처의 기본 이메일입니다.

secondary_emails[]

string

선택사항입니다. 연락처의 보조 이메일 전체 목록입니다.

phone

string

필수 항목입니다. 연락처의 전화번호입니다.

time_zone

TimeZone

선택사항입니다. 연락처의 시간대입니다.

reachable_times[]

TimePeriod

선택사항입니다. 연락처에 연락할 수 있는 시간대입니다. 이 필드가 비어 있으면 언제든지 연락할 수 있습니다.

notes

string

선택사항입니다. 연락처가 알림을 받고자 하는 방식을 자세히 설명하는 자유 형식 메모입니다. 예를 들어 선호하는 연락 방법이 있거나 후속 에스컬레이션에 참조로 포함되기를 원할 수 있습니다.

CreateCommentRequest

댓글 생성 요청입니다.

필드
parent

string

필수 항목입니다. 댓글을 작성할 주문입니다. 형식: projects/{project}/locations/{location}/orders/{order}

comment_id

string

선택사항입니다. 상위 범위 내에서 댓글을 고유하게 식별하는 데 사용되는 ID입니다. 이 필드는 최대 63자(영문 기준)여야 하며 소문자로 시작해야 합니다. 소문자, 숫자, -만 허용됩니다. - 문자는 첫 번째 또는 마지막 문자가 될 수 없습니다. 필드가 설정되지 않은 경우 시스템 생성 ID가 사용됩니다.

요청의 comment.name 필드는 무시됩니다.

comment

Comment

필수 항목입니다. 생성할 댓글입니다.

request_id

string

선택사항입니다. 이 요청의 선택적 고유 식별자입니다. AIP-155를 참고하세요.

CreateHardwareGroupRequest

하드웨어 그룹을 생성하기 위한 요청입니다.

필드
parent

string

필수 항목입니다. 하드웨어 그룹을 만들 순서입니다. 형식: projects/{project}/locations/{location}/orders/{order}

hardware_group_id

string

선택사항입니다. 상위 범위 내에서 HardwareGroup을 고유하게 식별하는 데 사용되는 ID입니다. 이 필드는 최대 63자(영문 기준)여야 하며 소문자로 시작해야 합니다. 소문자, 숫자, -만 허용됩니다. - 문자는 첫 번째 또는 마지막 문자가 될 수 없습니다. 필드가 설정되지 않은 경우 시스템 생성 ID가 사용됩니다.

요청의 hardware_group.name 필드는 무시됩니다.

hardware_group

HardwareGroup

필수 항목입니다. 만들 하드웨어 그룹입니다.

request_id

string

선택사항입니다. 이 요청의 선택적 고유 식별자입니다. AIP-155를 참고하세요.

CreateHardwareRequest

하드웨어 생성 요청입니다.

필드
parent

string

필수 항목입니다. 하드웨어를 생성할 프로젝트와 위치입니다. 형식: projects/{project}/locations/{location}

hardware_id

string

선택사항입니다. 상위 범위 내에서 하드웨어를 고유하게 식별하는 데 사용되는 ID입니다. 이 필드는 최대 63자(영문 기준)여야 하며 소문자로 시작해야 합니다. 소문자, 숫자, -만 허용됩니다. - 문자는 첫 번째 또는 마지막 문자가 될 수 없습니다. 필드가 설정되지 않은 경우 시스템 생성 ID가 사용됩니다.

요청의 hardware.name 필드는 무시됩니다.

hardware

Hardware

필수 항목입니다. 생성할 리소스입니다.

CreateOrderRequest

주문 생성 요청입니다.

필드
parent

string

필수 항목입니다. 주문을 생성할 프로젝트 및 위치입니다. 형식: projects/{project}/locations/{location}

order_id

string

선택사항입니다. 상위 범위 내에서 주문을 고유하게 식별하는 데 사용되는 ID입니다. 이 필드는 최대 63자(영문 기준)여야 하며 소문자로 시작해야 합니다. 소문자, 숫자, -만 허용됩니다. - 문자는 첫 번째 또는 마지막 문자가 될 수 없습니다. 필드가 설정되지 않은 경우 시스템 생성 ID가 사용됩니다.

요청의 order.name 필드는 무시됩니다.

order

Order

필수 항목입니다. 생성할 주문입니다.

request_id

string

선택사항입니다. 이 요청의 선택적 고유 식별자입니다. AIP-155를 참고하세요.

CreateSiteRequest

사이트 생성 요청입니다.

필드
parent

string

필수 항목입니다. 사이트를 만들 프로젝트와 위치입니다. 형식: projects/{project}/locations/{location}

site_id

string

선택사항입니다. 상위 범위 내에서 사이트를 고유하게 식별하는 데 사용되는 ID입니다. 이 필드는 최대 63자(영문 기준)여야 하며 소문자로 시작해야 합니다. 소문자, 숫자, -만 허용됩니다. - 문자는 첫 번째 또는 마지막 문자가 될 수 없습니다. 필드가 설정되지 않은 경우 시스템 생성 ID가 사용됩니다.

요청의 site.name 필드는 무시됩니다.

site

Site

필수 항목입니다. 만들 사이트입니다.

request_id

string

선택사항입니다. 이 요청의 선택적 고유 식별자입니다. AIP-155를 참고하세요.

CreateZoneRequest

영역 생성 요청입니다.

필드
parent

string

필수 항목입니다. 영역을 만들 프로젝트와 위치입니다. 형식: projects/{project}/locations/{location}

zone_id

string

선택사항입니다. 상위 범위 내에서 영역을 고유하게 식별하는 데 사용되는 ID입니다. 이 필드는 최대 63자(영문 기준)여야 하며 소문자로 시작해야 합니다. 소문자, 숫자, -만 허용됩니다. - 문자는 첫 번째 또는 마지막 문자가 될 수 없습니다. 필드가 설정되지 않은 경우 시스템 생성 ID가 사용됩니다.

요청의 zone.name 필드는 무시됩니다.

zone

Zone

필수 항목입니다. 만들 영역입니다.

request_id

string

선택사항입니다. 이 요청의 선택적 고유 식별자입니다. AIP-155를 참고하세요.

DeleteHardwareGroupRequest

하드웨어 그룹 삭제 요청입니다.

필드
name

string

필수 항목입니다. 하드웨어 그룹의 이름입니다. 형식: projects/{project}/locations/{location}/orders/{order}/hardwareGroups/{hardware_group}

request_id

string

선택사항입니다. 이 요청의 선택적 고유 식별자입니다. AIP-155를 참고하세요.

DeleteHardwareRequest

하드웨어 삭제 요청입니다.

필드
name

string

필수 항목입니다. 하드웨어의 이름입니다. 형식: projects/{project}/locations/{location}/hardware/{hardware}

request_id

string

선택사항입니다. 이 요청의 선택적 고유 식별자입니다. AIP-155를 참고하세요.

DeleteOrderRequest

주문 삭제 요청입니다.

필드
name

string

필수 항목입니다. 주문 이름입니다. 형식: projects/{project}/locations/{location}/orders/{order}

request_id

string

선택사항입니다. 이 요청의 선택적 고유 식별자입니다. AIP-155를 참고하세요.

force

bool

선택사항입니다. HardwareGroup과 같은 주문의 중첩된 리소스를 삭제하는 옵션입니다. true인 경우 이 주문의 중첩된 리소스도 삭제됩니다. 그렇지 않으면 주문에 중첩된 리소스가 없는 경우에만 요청이 성공합니다.

DeleteSiteRequest

사이트 삭제 요청입니다.

필드
name

string

필수 항목입니다. 사이트의 이름입니다. 형식: projects/{project}/locations/{location}/sites/{site}

request_id

string

선택사항입니다. 이 요청의 선택적 고유 식별자입니다. AIP-155를 참고하세요.

DeleteZoneRequest

영역 삭제 요청입니다.

필드
name

string

필수 항목입니다. 영역의 이름입니다. 형식: projects/{project}/locations/{location}/zones/{zone}

request_id

string

선택사항입니다. 이 요청의 선택적 고유 식별자입니다. AIP-155를 참고하세요.

측정기준

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

필드
width_inches

float

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

height_inches

float

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

depth_inches

float

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

항목

엔티티는 조직 또는 당사자를 나타내는 데 사용됩니다.

열거형
ENTITY_UNSPECIFIED 항목이 지정되지 않았습니다.
GOOGLE Google을 탭합니다.
CUSTOMER 고객
VENDOR 공급업체입니다.

GetChangeLogEntryRequest

변경 로그 항목을 가져오기 위한 요청입니다.

필드
name

string

필수 항목입니다. 변경 로그 항목의 이름입니다. 형식: projects/{project}/locations/{location}/orders/{order}/changeLogEntries/{change_log_entry}

GetCommentRequest

댓글을 가져오기 위한 요청입니다.

필드
name

string

필수 항목입니다. 댓글의 이름입니다. 형식: projects/{project}/locations/{location}/orders/{order}/comments/{comment}

GetHardwareGroupRequest

하드웨어 그룹을 가져오기 위한 요청입니다.

필드
name

string

필수 항목입니다. 하드웨어 그룹의 이름입니다. 형식: projects/{project}/locations/{location}/orders/{order}/hardwareGroups/{hardware_group}

GetHardwareRequest

하드웨어를 가져오기 위한 요청입니다.

필드
name

string

필수 항목입니다. 하드웨어의 이름입니다. 형식: projects/{project}/locations/{location}/hardware/{hardware}

GetOrderRequest

주문을 가져오는 요청입니다.

필드
name

string

필수 항목입니다. 리소스의 이름

GetSiteRequest

사이트를 가져오기 위한 요청입니다.

필드
name

string

필수 항목입니다. 사이트의 이름입니다. 형식: projects/{project}/locations/{location}/sites/{site}

GetSkuRequest

SKU를 가져오기 위한 요청입니다.

필드
name

string

필수 항목입니다. SKU 이름입니다. 형식: projects/{project}/locations/{location}/skus/{sku}

GetZoneRequest

영역을 가져오는 요청입니다.

필드
name

string

필수 항목입니다. 영역의 이름입니다. 형식: projects/{project}/locations/{location}/zones/{zone}

하드웨어

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

필드
name

string

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

display_name

string

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

create_time

Timestamp

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

update_time

Timestamp

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

labels

map<string, string>

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

order

string

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

hardware_group

string

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

site

string

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

state

State

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

ciq_uri

string

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

config

HardwareConfig

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

estimated_installation_date

Date

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

physical_info

HardwarePhysicalInfo

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

installation_info

HardwareInstallationInfo

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

zone

string

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

requested_installation_date
(deprecated)

Date

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

actual_installation_date

Date

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

machine_infos[]

MachineInfo

출력 전용입니다. 설정에 필요한 머신별 애셋 정보입니다.

estimated_delivery_date

Date

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

DiskInfo

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

필드
manufacturer

string

출력 전용입니다. 디스크 제조업체입니다.

slot

int32

출력 전용입니다. 디스크 슬롯 번호입니다.

serial_number

string

출력 전용입니다. 디스크 일련번호입니다.

psid

string

출력 전용입니다. 디스크 PSID입니다.

part_number

string

출력 전용입니다. 디스크 부품 번호입니다.

model_number

string

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

MacAddress

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

필드
address

string

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

type

AddressType

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

ipv4_address

string

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

AddressType

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

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

MachineInfo

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

필드
service_tag

string

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

mac_addresses[]

MacAddress

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

name

string

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

disk_infos[]

DiskInfo

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

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

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

HardwareConfig

GDC 하드웨어 구성입니다.

필드
sku

string

필수 항목입니다. 이 하드웨어의 SKU를 참조합니다. 이는 AIP-162에 정의된 대로 resource_name@revision_id 형식의 특정 SKU 개정판을 가리킬 수 있습니다. revision_id가 지정되지 않은 경우 최신 버전을 참조합니다.

power_supply

PowerSupply

필수 항목입니다. 이 하드웨어의 전원 공급 장치 유형입니다.

subscription_duration_months

int32

선택사항입니다. 하드웨어의 구독 기간(단위: 개월)입니다.

HardwareGroup

동일한 주문에 속하고, SKU가 동일하며, 동일한 사이트로 배송되는 하드웨어 그룹입니다.

필드
name

string

식별자. 이 하드웨어 그룹의 이름입니다. 형식: projects/{project}/locations/{location}/orders/{order}/hardwareGroups/{hardware_group}

create_time

Timestamp

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

update_time

Timestamp

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

labels

map<string, string>

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

hardware_count

int32

필수 항목입니다. 이 HardwareGroup의 하드웨어 수입니다.

config

HardwareConfig

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

site

string

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

state

State

출력 전용입니다. 이 HardwareGroup의 현재 상태입니다.

zone

string

선택사항입니다. 이 HardwareGroup의 하드웨어가 속한 영역의 이름입니다. 형식: projects/{project}/locations/{location}/zones/{zone}

requested_installation_date
(deprecated)

Date

선택사항입니다. 지원 중단됨: 이 값은 사용되지 않습니다. 대신 Order 리소스의 requested_installation_date 필드를 사용하세요.

HardwareGroup의 유효한 상태입니다.

열거형
STATE_UNSPECIFIED HardwareGroup의 상태가 지정되지 않았습니다.
ADDITIONAL_INFO_NEEDED 진행하려면 고객의 추가 정보가 필요합니다.
BUILDING Google에서 이 HardwareGroup의 하드웨어 빌드를 시작했습니다.
SHIPPING 하드웨어가 제작되어 발송 중입니다.
INSTALLING 하드웨어가 설치되고 있습니다.
PARTIALLY_INSTALLED HardwareGroup의 일부 하드웨어가 설치되었습니다.
INSTALLED HardwareGroup의 모든 하드웨어가 설치되었습니다.
FAILED 오류가 발생하여 고객의 개입이 필요합니다.

HardwareInstallationInfo

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

필드
rack_location

string

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

power_distance_meters

int32

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

switch_distance_meters

int32

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

rack_unit_dimensions

Dimensions

필수 항목입니다. 랙 유닛의 크기입니다.

rack_space

RackSpace

필수 항목입니다. 하드웨어에 할당된 랙 공간입니다.

rack_type

RackType

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

RackType

유효한 랙 유형입니다.

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

HardwareLocation

하나 이상의 하드웨어 위치를 나타냅니다.

필드
site

string

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

rack_location

string

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

rack_space[]

RackSpace

선택사항입니다. 랙에서 하드웨어가 차지하는 공간입니다. 설정되지 않은 경우 이 위치는 전체 랙으로 간주됩니다.

HardwarePhysicalInfo

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

필드
power_receptacle

PowerReceptacleType

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

voltage

Voltage

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

amperes

Amperes

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

암페어

유효한 암페어 값입니다.

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

NetworkUplinkType

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

열거형
RJ_45 RJ-45

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형

전압

유효한 전압 값입니다.

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

ListChangeLogEntriesRequest

변경 로그 항목을 나열하는 요청입니다.

필드
parent

string

필수 항목입니다. 변경 로그 항목을 나열할 순서입니다. 형식: projects/{project}/locations/{location}/orders/{order}

page_size

int32

선택사항입니다. 요청한 페이지 크기입니다. 서버에서 요청한 것보다 적은 항목을 반환할 수 있습니다. 지정하지 않으면 서버에서 적절한 기본값을 선택합니다.

page_token

string

선택사항. 서버에서 반환할 결과 페이지를 식별하는 토큰입니다.

filter

string

선택사항입니다. 필터링 조건입니다. AIP-160을 참조하세요.

order_by

string

선택사항입니다. 결과를 정렬하는 방법에 대한 힌트입니다.

ListChangeLogEntriesResponse

변경 로그 항목 목록입니다.

필드
change_log_entries[]

ChangeLogEntry

변경 로그 항목 목록입니다.

next_page_token

string

서버에서 반환할 결과 페이지를 식별하는 토큰입니다.

unreachable[]

string

도달할 수 없는 위치입니다.

ListCommentsRequest

댓글을 나열하는 요청입니다.

필드
parent

string

필수 항목입니다. 댓글을 나열할 주문입니다. 형식: projects/{project}/locations/{location}/orders/{order}

page_size

int32

선택사항입니다. 요청한 페이지 크기입니다. 서버에서 요청한 것보다 적은 항목을 반환할 수 있습니다. 지정하지 않으면 서버에서 적절한 기본값을 선택합니다.

page_token

string

선택사항. 서버에서 반환할 결과 페이지를 식별하는 토큰입니다.

filter

string

선택사항입니다. 필터링 조건입니다. AIP-160을 참조하세요.

order_by

string

선택사항입니다. 결과를 정렬하는 방법에 대한 힌트입니다.

ListCommentsResponse

댓글을 나열하는 요청입니다.

필드
comments[]

Comment

댓글 목록입니다.

next_page_token

string

서버에서 반환할 결과 페이지를 식별하는 토큰입니다.

unreachable[]

string

도달할 수 없는 위치입니다.

ListHardwareGroupsRequest

하드웨어 그룹을 나열하는 요청입니다.

필드
parent

string

필수 항목입니다. 하드웨어 그룹을 나열할 순서입니다. 형식: projects/{project}/locations/{location}/orders/{order}

page_size

int32

선택사항입니다. 요청한 페이지 크기입니다. 서버에서 요청한 것보다 적은 항목을 반환할 수 있습니다. 지정하지 않으면 서버에서 적절한 기본값을 선택합니다.

page_token

string

선택사항. 서버에서 반환할 결과 페이지를 식별하는 토큰입니다.

filter

string

선택사항입니다. 필터링 조건입니다. AIP-160을 참조하세요.

order_by

string

선택사항입니다. 결과를 정렬하는 방법에 대한 힌트입니다.

ListHardwareGroupsResponse

하드웨어 그룹 목록입니다.

필드
hardware_groups[]

HardwareGroup

하드웨어 그룹 목록입니다.

next_page_token

string

서버에서 반환할 결과 페이지를 식별하는 토큰입니다.

unreachable[]

string

도달할 수 없는 위치입니다.

ListHardwareRequest

하드웨어를 나열하는 요청입니다.

필드
parent

string

필수 항목입니다. 하드웨어를 나열할 프로젝트 및 위치입니다. 형식: projects/{project}/locations/{location}

모든 위치의 하드웨어를 나열하려면 위치를 - (하이픈 또는 대시 문자)으로 대체하고 응답 메시지에서 도달할 수 없는 필드를 확인합니다.

page_size

int32

선택사항입니다. 요청한 페이지 크기입니다. 서버에서 요청한 것보다 적은 항목을 반환할 수 있습니다. 지정하지 않으면 서버에서 적절한 기본값을 선택합니다.

page_token

string

선택사항. 서버에서 반환할 결과 페이지를 식별하는 토큰입니다.

filter

string

선택사항입니다. 필터링 조건입니다. AIP-160을 참조하세요.

order_by

string

선택사항입니다. 결과를 정렬하는 방법에 대한 힌트입니다.

ListHardwareResponse

하드웨어 목록입니다.

필드
hardware[]

Hardware

하드웨어 목록입니다.

next_page_token

string

서버에서 반환할 결과 페이지를 식별하는 토큰입니다.

unreachable[]

string

도달할 수 없는 위치입니다. 와일드 카드 위치 -에 대한 쿼리에만 사용됩니다. 비어 있지 않으면 결과가 불완전함을 나타냅니다.

ListOrdersRequest

주문을 나열하는 요청입니다.

필드
parent

string

필수 항목입니다. 주문을 나열할 프로젝트와 위치입니다. 형식: projects/{project}/locations/{location}

모든 위치의 주문을 나열하려면 위치를 - (하이픈 또는 대시 문자)으로 대체하고 응답 메시지에서 도달할 수 없음 필드를 확인합니다.

page_size

int32

선택사항입니다. 요청한 페이지 크기입니다. 서버에서 요청한 것보다 적은 항목을 반환할 수 있습니다. 지정하지 않으면 서버에서 적절한 기본값을 선택합니다.

page_token

string

선택사항. 서버에서 반환할 결과 페이지를 식별하는 토큰입니다.

filter

string

선택사항입니다. 필터링 조건입니다. AIP-160을 참조하세요.

order_by

string

선택사항입니다. 결과를 정렬하는 방법에 대한 힌트입니다.

ListOrdersResponse

주문 목록입니다.

필드
orders[]

Order

주문 목록입니다.

next_page_token

string

서버에서 반환할 결과 페이지를 식별하는 토큰입니다.

unreachable[]

string

도달할 수 없는 위치입니다. 와일드 카드 위치 -에 대한 쿼리에만 사용됩니다. 비어 있지 않으면 결과가 불완전함을 나타냅니다.

ListSitesRequest

사이트를 나열하는 요청입니다.

필드
parent

string

필수 항목입니다. 사이트를 나열할 프로젝트 및 위치입니다. 형식: projects/{project}/locations/{location}

모든 위치의 사이트를 나열하려면 위치를 - (하이픈 또는 대시 문자)으로 대체하고 응답 메시지에서 도달할 수 없는 필드를 확인합니다.

page_size

int32

선택사항입니다. 요청한 페이지 크기입니다. 서버에서 요청한 것보다 적은 항목을 반환할 수 있습니다. 지정하지 않으면 서버에서 적절한 기본값을 선택합니다.

page_token

string

선택사항. 서버에서 반환할 결과 페이지를 식별하는 토큰입니다.

filter

string

선택사항입니다. 필터링 조건입니다. AIP-160을 참조하세요.

order_by

string

선택사항입니다. 결과를 정렬하는 방법에 대한 힌트입니다.

ListSitesResponse

사이트 목록입니다.

필드
sites[]

Site

사이트 목록입니다.

next_page_token

string

서버에서 반환할 결과 페이지를 식별하는 토큰입니다.

unreachable[]

string

도달할 수 없는 위치입니다. 와일드 카드 위치 -에 대한 쿼리에만 사용됩니다. 비어 있지 않으면 결과가 불완전함을 나타냅니다.

ListSkusRequest

SKU를 나열하는 요청입니다.

필드
parent

string

필수 항목입니다. SKU를 나열할 프로젝트 및 위치입니다. 형식: projects/{project}/locations/{location}

모든 위치의 SKU를 나열하려면 위치를 - (하이픈 또는 대시 문자)으로 대체하고 응답 메시지에서 도달할 수 없는 필드를 확인합니다.

page_size

int32

선택사항입니다. 요청한 페이지 크기입니다. 서버에서 요청한 것보다 적은 항목을 반환할 수 있습니다. 지정하지 않으면 서버에서 적절한 기본값을 선택합니다.

page_token

string

선택사항. 서버에서 반환할 결과 페이지를 식별하는 토큰입니다.

filter

string

선택사항입니다. 필터링 조건입니다. AIP-160을 참조하세요.

order_by

string

선택사항입니다. 결과를 정렬하는 방법에 대한 힌트입니다.

ListSkusResponse

SKU 목록입니다.

필드
skus[]

Sku

SKU 목록입니다.

next_page_token

string

서버에서 반환할 결과 페이지를 식별하는 토큰입니다.

unreachable[]

string

도달할 수 없는 위치입니다. 와일드 카드 위치 -에 대한 쿼리에만 사용됩니다. 비어 있지 않으면 결과가 불완전함을 나타냅니다.

ListZonesRequest

영역을 나열하는 요청입니다.

필드
parent

string

필수 항목입니다. 영역을 나열할 프로젝트와 위치입니다. 형식: projects/{project}/locations/{location}

모든 위치의 영역을 나열하려면 위치를 - (하이픈 또는 대시 문자)으로 대체하고 응답 메시지에서 도달할 수 없는 필드를 확인합니다.

page_size

int32

선택사항입니다. 요청한 페이지 크기입니다. 서버에서 요청한 것보다 적은 항목을 반환할 수 있습니다. 지정하지 않으면 서버에서 적절한 기본값을 선택합니다.

page_token

string

선택사항. 서버에서 반환할 결과 페이지를 식별하는 토큰입니다.

filter

string

선택사항입니다. 필터링 조건입니다. AIP-160을 참조하세요.

order_by

string

선택사항입니다. 결과를 정렬하는 방법에 대한 힌트입니다.

ListZonesResponse

영역 목록입니다.

필드
zones[]

Zone

영역 목록입니다.

next_page_token

string

서버에서 반환할 결과 페이지를 식별하는 토큰입니다.

unreachable[]

string

도달할 수 없는 위치입니다. 와일드 카드 위치 -에 대한 쿼리에만 사용됩니다. 비어 있지 않으면 결과가 불완전함을 나타냅니다.

OperationMetadata

장기 실행 작업의 메타데이터를 나타냅니다.

필드
create_time

Timestamp

출력 전용입니다. 작업이 생성된 시간입니다.

end_time

Timestamp

출력 전용입니다. 작업 실행이 완료된 시간입니다.

target

string

출력 전용입니다. 작업 대상에 대한 서버 정의 리소스 경로입니다.

verb

string

출력 전용입니다. 작업에 의해 실행된 동사입니다.

status_message

string

출력 전용입니다. 상태에 대한 인간이 읽을 수 있는 상태입니다(존재하는 경우).

requested_cancellation

bool

출력 전용입니다. 사용자가 작업 취소를 요청했는지를 나타냅니다. 성공적으로 취소된 작업에는 google.rpc.Status.code가 1인 [Operation.error][] 값이 있습니다. 이는 Code.CANCELLED에 해당합니다.

api_version

string

출력 전용입니다. 작업을 시작하는 데 사용되는 API 버전입니다.

주문

GDC 하드웨어 주문입니다.

필드
name

string

식별자. 이 주문의 이름입니다. 형식: projects/{project}/locations/{location}/orders/{order}

display_name

string

선택사항입니다. 이 주문의 표시 이름입니다.

create_time

Timestamp

출력 전용입니다. 이 주문이 생성된 시간입니다.

update_time

Timestamp

출력 전용입니다. 이 주문이 마지막으로 업데이트된 시간입니다.

labels

map<string, string>

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

state

State

출력 전용입니다. 이 주문의 상태입니다. 주문 생성 시 상태가 DRAFT로 설정됩니다.

organization_contact

OrganizationContact

필수 항목입니다. 고객 연락처 정보입니다.

target_workloads[]

string

선택사항입니다. 이 주문의 대상이 되는 고객이 지정한 관심 워크로드입니다. 20개 이하의 요소를 포함해야 하며 각 요소의 길이는 50자 이하여야 합니다.

customer_motivation

string

선택사항입니다. 이 주문에 대한 고객의 동기에 관한 정보입니다. 이 필드의 길이는 1,000자(영문 기준) 이하여야 합니다.

fulfillment_time
(deprecated)

Timestamp

선택사항입니다. 지원 중단됨: 대신 customer_requested_installation_date를 사용하세요.

customer_requested_installation_date

Date

선택사항입니다. 고객이 이 주문의 설치 날짜를 요청했습니다.

region_code

string

필수 항목입니다. 이 주문이 배포될 유니코드 CLDR 지역 코드입니다. 유효한 CLDR 지역 코드 목록은 언어 하위 태그 등록소를 참고하세요.

order_form_uri

string

출력 전용입니다. 주문 양식 링크

type

Type

출력 전용입니다. 이 주문의 유형입니다.

submit_time

Timestamp

출력 전용입니다. 주문이 제출된 시간입니다. 주문이 제출될 때 현재 시간으로 자동 입력됩니다.

billing_id

string

출력 전용입니다. 이 주문에 대해 청구될 Google Cloud 결제 ID입니다.

existing_hardware[]

HardwareLocation

선택사항입니다. 이 주문의 일부로 삭제할 기존 하드웨어입니다. 참고: 별도의 합의가 없는 한 삭제된 하드웨어는 재활용됩니다.

deployment_type

DeploymentType

출력 전용입니다. 이 주문의 배포 유형입니다.

actual_installation_date

Date

출력 전용입니다. 이 주문의 실제 설치일입니다.

estimated_installation_date

Date

출력 전용입니다. 이 주문의 예상 설치일입니다.

estimated_delivery_date

Date

출력 전용입니다. 이 주문의 예상 배송일입니다.

migration

bool

선택사항입니다. 이 주문이 고객의 기존 인프라에서 이전된 것인지 여부입니다.

accepted_time

Timestamp

출력 전용입니다. 주문이 ACCEPTED 상태로 변경된 시간입니다.

requested_date_change

Date

출력 전용입니다. 고객 또는 Google이 예약된 설치 날짜를 설정하려는 날짜입니다.

vendor_notes

string

출력 전용입니다. 공급업체가 제공한 이 주문에 대한 참고사항입니다.

vendor_contact

OrganizationContact

출력 전용입니다. 이 주문에 할당된 SI의 연락처 정보입니다.

ai_capable

bool

출력 전용입니다. 이 주문이 GDC 소프트웨어에서 Gemini를 지원하는 하드웨어에 대한 주문인지 나타냅니다. 주문이 제출되면 자동으로 입력됩니다.

DeploymentType

배포의 유효한 유형입니다.

열거형
DEPLOYMENT_TYPE_UNSPECIFIED 배포 유형이 지정되지 않았습니다.
FULL_PRODUCTION SLO를 사용한 프로덕션 배포
PROOF_OF_CONCEPT 최선의 지원이 제공되고 SLO가 없는 배포
INTERNAL 최선의 지원이 제공되고 SLO가 없는 내부 배포
CUSTOMER_LAB Google에서 프로덕션 환경인 것처럼 지원하는 고객 실험실 배포

주문의 유효한 상태입니다.

열거형
STATE_UNSPECIFIED 주문 상태가 지정되지 않았습니다.
DRAFT 고객이 주문을 작성 중이며 아직 제출하지 않았습니다.
SUBMITTED 주문이 Google에 제출되었습니다.
INFO_COMPLETE 주문 처리에 필요한 고객 정보가 모두 완료되었습니다.
ACCEPTED Google에서 주문을 수락했습니다.
ADDITIONAL_INFO_NEEDED 주문에 고객의 추가 정보가 필요합니다.
BUILDING Google에서 주문의 하드웨어 제작을 시작했습니다.
SHIPPING 하드웨어가 제작되어 발송 중입니다.
INSTALLING 하드웨어가 설치되고 있습니다.
FAILED 주문을 처리하는 중에 오류가 발생했으며 고객의 개입이 필요합니다.
PARTIALLY_COMPLETED 주문이 부분적으로 완료되었습니다(일부 하드웨어가 배송 및 설치됨).
COMPLETED 주문이 완료되었습니다.
CANCELLED 주문이 취소되었습니다.

유형

주문의 유효한 유형입니다.

열거형
TYPE_UNSPECIFIED 주문 유형이 지정되지 않았습니다.
PAID 고객이 지불합니다.
POC 고객을 위한 개념 증명
UNPAID 청구되지 않음

OrganizationContact

고객 조직의 연락처 정보입니다.

필드
address

PostalAddress

필수 항목입니다. 조직의 주소입니다.

email

string

선택사항입니다. 조직의 이메일입니다.

phone

string

선택사항입니다. 조직의 전화번호입니다.

contacts[]

Contact

필수 항목입니다. 이 위치에 있는 조직의 개별 담당자입니다.

PowerSupply

전원 공급 장치 옵션입니다.

열거형
POWER_SUPPLY_UNSPECIFIED 전원 공급 장치가 지정되지 않았습니다.
POWER_SUPPLY_AC AC 전원 공급 장치
POWER_SUPPLY_DC DC 전원 공급 장치

RackSpace

랙의 연속된 공간을 나타냅니다.

필드
start_rack_unit

int32

필수 항목입니다. 랙 공간의 첫 번째 랙 유닛 (포함)입니다.

end_rack_unit

int32

필수 항목입니다. 랙 공간의 마지막 랙 유닛 (포함)입니다.

RecordActionOnCommentRequest

댓글에 대한 작업을 기록하기 위한 요청입니다.

필드
name

string

필수 항목입니다. 댓글의 이름입니다. 형식: projects/{project}/locations/{location}/orders/{order}/comments/{comment}

action_type

ActionType

필수 항목입니다. 기록된 작업의 작업 유형입니다.

ActionType

댓글의 유효한 작업 유형입니다.

열거형
ACTION_TYPE_UNSPECIFIED 작업이 지정되지 않았습니다.
READ 댓글을 읽음으로 표시합니다.
UNREAD 댓글을 읽지 않음으로 표시합니다.

RequestOrderDateChangeRequest

주문의 요청된 날짜를 변경하는 요청입니다.

필드
name

string

필수 항목입니다. 업데이트할 주문의 이름입니다. 형식: projects/{project}/locations/{location}/orders/{order}

requested_date

Date

필수 항목입니다. 고객 또는 Google이 예약된 설치 날짜를 설정하려는 날짜입니다.

SignalZoneStateRequest

구역의 상태를 알리는 요청입니다.

필드
name

string

필수 항목입니다. 영역의 이름입니다. 형식: projects/{project}/locations/{location}/zones/{zone}

request_id

string

선택사항입니다. 이 요청의 선택적 고유 식별자입니다. AIP-155를 참고하세요.

state_signal

StateSignal

선택사항입니다. 이 영역에 전송할 상태 신호입니다. state_signal 또는 provisioning_state_signal 중 하나만 설정해야 합니다.

provisioning_state_signal

ProvisioningStateSignal

선택사항입니다. 이 영역에 전송할 프로비저닝 상태 신호입니다. state_signal 또는 provisioning_state_signal 중 하나만 설정해야 합니다.

step

string

선택사항입니다. 실행 중인 단계입니다. state_signal이 FACTORY_TURNUP_CHECKS_STARTED 또는 FACTORY_TURNUP_CHECKS_FAILED인 경우 더 세부적인 상태를 제공합니다.

details

string

선택사항입니다. state_signal이 FACTORY_TURNUP_CHECKS_FAILED인 경우 오류 메시지와 같은 추가 세부정보

ProvisioningStateSignal

영역의 유효한 프로비저닝 상태 신호입니다.

열거형
PROVISIONING_STATE_SIGNAL_UNSPECIFIED 프로비저닝 상태 신호가 지정되지 않았습니다.
PROVISIONING_IN_PROGRESS 프로비저닝이 진행 중입니다.
PROVISIONING_COMPLETE 프로비저닝이 완료되었습니다.

StateSignal

영역의 유효한 상태 신호입니다.

열거형
STATE_SIGNAL_UNSPECIFIED 구역의 상태 신호가 지정되지 않았습니다.
FACTORY_TURNUP_CHECKS_STARTED 공장 턴업 검사가 시작되었습니다.
FACTORY_TURNUP_CHECKS_PASSED 사이트 턴업을 위해 영역이 준비되었습니다.
READY_FOR_SITE_TURNUP

사이트 턴업을 위해 영역이 준비되었습니다. 지원 중단되었지만 삭제되지는 않았습니다.

FACTORY_TURNUP_CHECKS_FAILED 영역이 공장 설정 확인에 실패했습니다.
VERIFY_CLUSTER_INTENT_PRESENCE 유효한 클러스터 인텐트가 있는지 확인합니다.

사이트

하드웨어가 설치될 실제 사이트입니다.

필드
name

string

식별자. 사이트 이름입니다. 형식: projects/{project}/locations/{location}/sites/{site}

display_name

string

선택사항입니다. 이 사이트의 표시 이름입니다.

description

string

선택사항입니다. 이 사이트에 대한 설명입니다.

create_time

Timestamp

출력 전용입니다. 이 사이트가 생성된 시간입니다.

update_time

Timestamp

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

labels

map<string, string>

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

organization_contact

OrganizationContact

필수 항목입니다. 이 사이트의 연락처 정보입니다.

google_maps_pin_uri

string

선택사항입니다. 사이트의 Google 지도 주소 위치로 연결되는 URL입니다. 예시 값은 https://goo.gl/maps/xxxxxxxxx입니다.

access_times[]

TimePeriod

선택사항입니다. 사이트에 액세스할 수 있는 기간입니다. 이 필드가 비어 있으면 사이트에 항상 액세스할 수 있습니다.

이 필드는 Google에서 초기 설치와 이후 하드웨어 유지보수를 예약하는 데 사용됩니다. 이 정보는 언제든지 업데이트할 수 있습니다. 예를 들어 초기 설치는 근무 외 시간에 요청되었지만 유지보수는 일반 영업시간에 실행해야 하는 경우 초기 설치가 완료된 후 액세스 시간을 업데이트해야 합니다.

notes

string

선택사항입니다. 이 사이트의 추가 참고사항입니다. 다음과 같은 정보를 포함해 주세요. - 보안 또는 액세스 제한 - 사이트를 방문하는 기술자에게 영향을 미치는 규정 - 장비 이동에 필요한 특별 절차 또는 승인 - 사이트 방문 시 담당자 참석 여부

customer_site_id

string

선택사항입니다. 이 사이트의 고객 정의 식별자입니다. 이 값은 고객의 자체 시스템에서 사이트를 식별하는 데 사용할 수 있습니다.

SKU

GDC 하드웨어의 재고 관리 단위 (SKU)입니다.

필드
name

string

식별자. 이 SKU의 이름입니다. 형식: projects/{project}/locations/{location}/skus/{sku}

display_name

string

출력 전용입니다. 이 SKU의 표시 이름입니다.

create_time

Timestamp

출력 전용입니다. 이 SKU가 생성된 시간입니다.

update_time

Timestamp

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

config

SkuConfig

출력 전용입니다. 이 SKU의 구성입니다.

instances[]

SkuInstance

출력 전용입니다. 이 SKU의 사용 가능한 인스턴스입니다. 이 필드는 SKU의 재고를 확인하는 데 사용해야 합니다.

description

string

출력 전용입니다. 이 SKU에 대한 설명입니다.

revision_id

string

출력 전용입니다. SKU 버전 ID입니다. config가 업데이트될 때마다 새 버전이 생성됩니다. 형식은 8자의 16진수 문자열입니다.

is_active

bool

출력 전용입니다. 이 버전이 활성 상태인지 여부를 나타내는 플래그입니다. 새 주문에는 활성 버전만 사용할 수 있습니다.

type

Type

출력 전용입니다. 이 SKU의 유형입니다.

vcpu_count

int32

출력 전용입니다. 이 SKU와 연결된 vCPU 수입니다.

hardware_count_ranges[]

Range

출력 전용입니다. 이 SKU를 사용하는 영역에서 허용되는 하드웨어 수의 포함 범위입니다.

범위

포함 범위입니다.

필드
min

int32

범위의 최솟값입니다.

max

int32

범위의 최댓값입니다.

유형

SKU의 유효한 유형입니다.

열거형
TYPE_UNSPECIFIED SKU 유형이 지정되지 않았습니다. 허용되지 않는 값입니다.
RACK 랙 SKU입니다.
SERVER 서버 SKU입니다.

SkuConfig

SKU 구성입니다.

필드
cpu

string

CPU 구성에 관한 정보입니다.

gpu

string

GPU 구성에 관한 정보입니다.

ram

string

RAM 구성에 관한 정보입니다.

storage

string

스토리지 구성에 관한 정보입니다.

SkuInstance

SKU의 특정 인스턴스입니다.

필드
region_code

string

이 인스턴스를 사용할 수 있는 유니코드 CLDR 리전 코드입니다.

power_supply

PowerSupply

이 인스턴스의 전원 공급 장치 유형입니다.

billing_sku

string

Cloud Billing API의 해당 SKU에 대한 참조입니다. 이 API를 사용하여 예상 가격 정보를 가져올 수 있습니다. 형식: services/{service}/skus/{sku}

billing_sku_per_vcpu

string

Cloud Billing API의 vCPU당 해당 SKU에 대한 참조입니다. 이 API를 사용하여 예상 가격 정보를 가져올 수 있습니다. 형식: services/{service}/skus/{sku}

subscription_duration_months

int32

하드웨어의 구독 기간(단위: 개월)입니다.

SubmitOrderRequest

주문 제출 요청입니다.

필드
name

string

필수 항목입니다. 주문 이름입니다. 형식: projects/{project}/locations/{location}/orders/{order}

request_id

string

선택사항입니다. 이 요청의 선택적 고유 식별자입니다. AIP-155를 참고하세요.

type

Type

선택사항입니다. 이 요청의 유형입니다. 설정되지 않은 경우 요청 유형은 INFO_PENDING으로 간주됩니다.

유형

유효한 제출 주문 요청 유형입니다.

열거형
TYPE_UNSPECIFIED 요청 유형이 지정되지 않았습니다. 사용하면 안 됩니다.
INFO_PENDING 이 요청 유형을 사용하여 주문을 제출하고 Google과 대화를 시작하세요. 제출 후에는 주문한 하드웨어의 번호나 SKU를 수정할 수 없습니다. 영역 네트워크 구성, 하드웨어 물리적 및 설치 정보 등 추가 정보를 제공해야 주문이 처리될 수 있습니다. SKU 유형이 RACK인 주문을 제출하는 경우 API 외부에서 추가 정보가 필요하므로 이 요청 유형을 사용하세요.
INFO_COMPLETE 주문 처리를 위해 주문을 제출할 준비가 되면 이 요청 유형을 사용하세요. INFO_PENDING에 필요한 정보 외에도 주문에는 영역 네트워크 구성, 하드웨어 물리적 및 설치 정보 등 필요한 모든 정보가 포함되어야 합니다. 주문 정보의 추가 변경은 더 이상 허용되지 않습니다.

서브넷

서브넷을 나타냅니다.

필드
address_range

string

필수 항목입니다. CIDR 표기법으로 표시된 이 서브넷의 주소 범위입니다.

default_gateway_ip_address

string

필수 항목입니다. 이 서브넷의 기본 게이트웨이입니다.

SubscriptionConfig

구독 구성을 저장하는 메시지입니다.

필드
subscription_id

string

출력 전용입니다. 정기 결제의 고유 식별자입니다.

billing_id

string

출력 전용입니다. 구독이 생성된 Google Cloud 결제 ID입니다.

state

SubscriptionState

출력 전용입니다. 정기 결제의 현재 상태입니다.

SubscriptionState

정기 결제의 상태를 나타내는 열거형입니다.

열거형
SUBSCRIPTION_STATE_UNSPECIFIED 상태가 지정되지 않았습니다.
ACTIVE 활성 상태는 정기 결제가 성공적으로 생성되었으며 청구가 진행 중임을 의미합니다.
INACTIVE 비활성은 구독이 생성되었지만 아직 청구가 시작되지 않았음을 의미합니다.
ERROR 정기 결제가 오류 상태입니다.
FAILED_TO_RETRIEVE 구독 상태를 가져오지 못했습니다. 일시적인 문제일 수 있습니다. 사용자가 요청을 다시 시도해야 합니다.
COMPLETED 종료일에 도달하여 구독이 완료되었습니다.

TimePeriod

일주일의 기간을 나타냅니다.

필드
start_time

TimeOfDay

필수 항목입니다. 기간의 시작입니다.

end_time

TimeOfDay

필수 항목입니다. 기간의 종료입니다.

days[]

DayOfWeek

필수 항목입니다. 기간이 활성화되는 요일입니다.

UpdateHardwareGroupRequest

하드웨어 그룹 업데이트 요청입니다.

필드
update_mask

FieldMask

필수 항목입니다. 이 업데이트로 덮어쓸 HardwareGroup의 필드를 지정하는 마스크입니다. update_mask에 지정된 필드는 전체 요청이 아닌 하드웨어 그룹을 기준으로 합니다. 마스크에 있으면 필드를 덮어씁니다. 마스크를 제공하지 않으면 모든 필드를 덮어씁니다.

hardware_group

HardwareGroup

필수 항목입니다. 업데이트할 하드웨어 그룹입니다.

request_id

string

선택사항입니다. 이 요청의 선택적 고유 식별자입니다. AIP-155를 참고하세요.

UpdateHardwareRequest

하드웨어 업데이트 요청입니다.

필드
update_mask

FieldMask

필수 항목입니다. 이 업데이트로 덮어쓸 하드웨어의 필드를 지정하는 마스크입니다. update_mask에 지정된 필드는 전체 요청이 아닌 하드웨어를 기준으로 합니다. 마스크에 있으면 필드를 덮어씁니다. 마스크를 제공하지 않으면 모든 필드를 덮어씁니다.

hardware

Hardware

필수 항목입니다. 업데이트할 하드웨어입니다.

request_id

string

선택사항입니다. 이 요청의 선택적 고유 식별자입니다. AIP-155를 참고하세요.

UpdateOrderRequest

주문을 업데이트하기 위한 요청입니다.

필드
update_mask

FieldMask

필수 항목입니다. 이 업데이트로 덮어쓸 주문의 필드를 지정하는 마스크입니다. update_mask에 지정된 필드는 전체 요청이 아닌 주문을 기준으로 합니다. 마스크에 있으면 필드를 덮어씁니다. 마스크를 제공하지 않으면 모든 필드를 덮어씁니다.

order

Order

필수 항목입니다. 업데이트할 주문입니다.

request_id

string

선택사항입니다. 이 요청의 선택적 고유 식별자입니다. AIP-155를 참고하세요.

UpdateSiteRequest

사이트 업데이트 요청입니다.

필드
update_mask

FieldMask

필수 항목입니다. 이 업데이트로 덮어쓸 사이트의 필드를 지정하는 마스크입니다. update_mask에 지정된 필드는 전체 요청이 아닌 해당 사이트를 기준으로 합니다. 마스크에 있으면 필드를 덮어씁니다. 마스크를 제공하지 않으면 모든 필드를 덮어씁니다.

site

Site

필수 항목입니다. 업데이트할 사이트입니다.

request_id

string

선택사항입니다. 이 요청의 선택적 고유 식별자입니다. AIP-155를 참고하세요.

UpdateZoneRequest

영역을 업데이트하기 위한 요청입니다.

필드
update_mask

FieldMask

필수 항목입니다. 이 업데이트로 덮어쓸 영역의 필드를 지정하는 마스크입니다. update_mask에 지정된 필드는 전체 요청이 아닌 영역을 기준으로 합니다. 마스크에 있으면 필드를 덮어씁니다. 마스크를 제공하지 않으면 모든 필드를 덮어씁니다.

zone

Zone

필수 항목입니다. 업데이트할 영역입니다.

request_id

string

선택사항입니다. 이 요청의 선택적 고유 식별자입니다. AIP-155를 참고하세요.

영역

하드웨어 세트를 보유하는 영역입니다.

필드
name

string

식별자. 이 영역의 이름입니다. 형식: projects/{project}/locations/{location}/zones/{zone}

create_time

Timestamp

출력 전용입니다. 이 영역이 생성된 시간입니다.

update_time

Timestamp

출력 전용입니다. 이 영역이 마지막으로 업데이트된 시간입니다.

labels

map<string, string>

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

display_name

string

선택사항입니다. 이 영역의 사용자 친화적인 표시 이름입니다.

state

State

출력 전용입니다. 이 영역의 현재 상태입니다.

contacts[]

Contact

필수 항목입니다. 지역 담당자 (이름, 이메일, 전화번호) 순서에 따라 달라짐: 목록의 첫 번째 연락처가 기본 연락처이고 두 번째 연락처가 보조 연락처입니다.

ciq_uri

string

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

network_config

ZoneNetworkConfig

선택사항입니다. 이 영역의 네트워킹 구성입니다.

globally_unique_id

string

출력 전용입니다. 이 Edge Zone에 대해 생성된 전역적으로 고유한 식별자입니다.

subscription_configs[]

SubscriptionConfig

출력 전용입니다. 이 영역의 구독 구성입니다.

provisioning_state

ProvisioningState

출력 전용입니다. MAC 주소와 같은 구성의 프로비저닝 상태입니다.

skip_cluster_provisioning

bool

선택사항입니다. 공장 턴업 중에 클러스터 프로비저닝 단계를 건너뛸지 여부입니다. true인 경우 고객 사이트에 영역의 하드웨어가 설치된 후에 Kubernetes 클러스터가 생성됨을 나타냅니다.

cluster_intent_required

bool

출력 전용입니다. 주문을 수락하기 전에 고객이 유효한 클러스터 의도를 제공해야 하는지 여부를 나타냅니다. true인 경우 클러스터 인텐트가 있어야 주문을 수락할 수 있습니다. 이는 조기 검증을 적용하고 구성 누락으로 인한 지연을 방지하는 데 사용됩니다.

cluster_intent_verified

bool

출력 전용입니다. 제공된 클러스터 인텐트가 성공적으로 검증되었는지 여부를 나타냅니다. 이 플래그는 주문을 수락하기 전에 클러스터 인텐트가 있는지 확인합니다.

ai_capable

bool

출력 전용입니다. 이 영역이 GDC 소프트웨어 클러스터의 Gemini용인지 나타냅니다.

ProvisioningState

MAC 주소와 같은 구성의 유효한 프로비저닝 상태입니다.

열거형
PROVISIONING_STATE_UNSPECIFIED 프로비저닝 상태가 지정되지 않았습니다.
PROVISIONING_REQUIRED 프로비저닝이 필요합니다. Google에서 설정합니다.
PROVISIONING_IN_PROGRESS 프로비저닝이 진행 중입니다. 고객이 설정합니다.
PROVISIONING_COMPLETE 프로비저닝이 완료되었습니다. 고객이 설정합니다.

영역의 유효한 상태입니다.

열거형
STATE_UNSPECIFIED 영역의 상태가 지정되지 않았습니다.
ADDITIONAL_INFO_NEEDED 진행하려면 고객의 추가 정보가 필요합니다.
PREPARING Google에서 구역을 준비하고 있습니다.
READY_FOR_CUSTOMER_FACTORY_TURNUP_CHECKS 공장 턴업이 완료되었습니다.
CUSTOMER_FACTORY_TURNUP_CHECKS_STARTED 영역에서 공장 설정 턴업 검사를 실행하고 있습니다.
READY_FOR_SITE_TURNUP 사이트 턴업을 위해 영역이 준비되었습니다.
CUSTOMER_FACTORY_TURNUP_CHECKS_FAILED 영역이 공장 설정 확인에 실패했습니다.
ACTIVE 영역을 사용할 수 있습니다.
CANCELLED 구간이 취소되었습니다.

ZoneNetworkConfig

영역의 네트워킹 구성입니다.

필드
machine_mgmt_ipv4_range

string

필수 항목입니다. 머신 관리용 IPv4 주소 블록입니다. 영역의 머신당 하나 이상의 주소를 할당할 수 있을 만큼 큰 비공개 RFC1918 또는 공개 CIDR 블록이어야 합니다. management_ipv4_subnet에 있어야 하며 다른 주소 범위와 분리되어야 합니다.

kubernetes_node_ipv4_range

string

필수 항목입니다. Kubernetes 노드의 IPv4 주소 블록입니다. 영역의 머신당 하나 이상의 주소를 할당할 수 있을 만큼 큰 비공개 RFC1918 또는 공개 CIDR 블록이어야 합니다. kubernetes_ipv4_subnet에 있어야 하며 다른 주소 범위와 분리되어야 합니다.

kubernetes_control_plane_ipv4_range

string

필수 항목입니다. Kubernetes 컨트롤 플레인의 IPv4 주소 블록입니다. 영역에서 클러스터당 하나 이상의 주소를 할당할 수 있을 만큼 큰 비공개 RFC1918 또는 공개 CIDR 블록이어야 합니다. kubernetes_ipv4_subnet에 있어야 하며 다른 주소 범위와 분리되어야 합니다.

management_ipv4_subnet

Subnet

필수 항목입니다. 관리 네트워크의 IPv4 서브넷입니다.

kubernetes_ipv4_subnet

Subnet

선택사항입니다. Kubernetes 네트워크의 IPv4 서브넷입니다. 지정하지 않으면 Kubernetes 서브넷이 관리 서브넷과 동일합니다.

dns_ipv4_addresses[]

string

선택사항입니다. DNS 네임서버입니다. GDC 인프라가 이 IP를 통해 DNS 쿼리를 확인합니다. 지정하지 않으면 Google DNS가 사용됩니다.

kubernetes_primary_vlan_id

int32

선택사항입니다. Kubernetes VLAN ID입니다. 기본적으로 기본 Kubernetes 네트워크를 포함한 Kubernetes 노드는 머신 관리 네트워크와 동일한 VLAN에 있습니다. 네트워크 세분화 목적을 위해 필요에 따라 분리할 수 있습니다.