Package google.cloud.gdchardwaremanagement.v1alpha

索引

GDCHardwareManagement

GDC Hardware Management 服務。

CreateComment

rpc CreateComment(CreateCommentRequest) returns (Operation)

在訂單上建立新留言。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱驗證總覽一文。

IAM 權限

需要 parent 資源的下列 IAM 權限：

  • gdchardwaremanagement.comments.create

詳情請參閱 IAM 說明文件。
CreateHardware

rpc CreateHardware(CreateHardwareRequest) returns (Operation)

在指定專案和位置建立新硬體。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱驗證總覽一文。

IAM 權限

需要 parent 資源的下列 IAM 權限：

  • gdchardwaremanagement.hardware.create

詳情請參閱 IAM 說明文件。
CreateHardwareGroup

rpc CreateHardwareGroup(CreateHardwareGroupRequest) returns (Operation)

在指定訂單中建立新的硬體群組。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱驗證總覽一文。

IAM 權限

需要 parent 資源的下列 IAM 權限：

  • gdchardwaremanagement.hardwareGroups.create

詳情請參閱 IAM 說明文件。
CreateOrder

rpc CreateOrder(CreateOrderRequest) returns (Operation)

在指定專案和位置建立新訂單。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱驗證總覽一文。

IAM 權限

需要 parent 資源的下列 IAM 權限：

  • gdchardwaremanagement.orders.create

詳情請參閱 IAM 說明文件。
CreateSite

rpc CreateSite(CreateSiteRequest) returns (Operation)

在指定專案和位置建立新網站。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱驗證總覽一文。

IAM 權限

需要 parent 資源的下列 IAM 權限：

  • gdchardwaremanagement.sites.create

詳情請參閱 IAM 說明文件。
CreateZone

rpc CreateZone(CreateZoneRequest) returns (Operation)

在指定專案和位置中建立新區域。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱驗證總覽一文。

IAM 權限

需要 parent 資源的下列 IAM 權限：

  • gdchardwaremanagement.zones.create

詳情請參閱 IAM 說明文件。
DeleteHardware

rpc DeleteHardware(DeleteHardwareRequest) returns (Operation)

刪除硬體。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱驗證總覽一文。

IAM 權限

需要 name 資源的下列 IAM 權限：

  • gdchardwaremanagement.hardware.delete

詳情請參閱 IAM 說明文件。
DeleteHardwareGroup

rpc DeleteHardwareGroup(DeleteHardwareGroupRequest) returns (Operation)

刪除硬體群組。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱驗證總覽一文。

IAM 權限

需要 name 資源的下列 IAM 權限：

  • gdchardwaremanagement.hardwareGroups.delete

詳情請參閱 IAM 說明文件。
DeleteOrder

rpc DeleteOrder(DeleteOrderRequest) returns (Operation)

刪除訂單。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱驗證總覽一文。

IAM 權限

需要 name 資源的下列 IAM 權限：

  • gdchardwaremanagement.orders.delete

詳情請參閱 IAM 說明文件。
DeleteZone

rpc DeleteZone(DeleteZoneRequest) returns (Operation)

刪除區域。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱驗證總覽一文。

IAM 權限

需要 name 資源的下列 IAM 權限：

  • gdchardwaremanagement.zones.delete

詳情請參閱 IAM 說明文件。
GetChangeLogEntry

rpc GetChangeLogEntry(GetChangeLogEntryRequest) returns (ChangeLogEntry)

取得訂單變更的詳細資料。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱驗證總覽一文。

IAM 權限

需要 name 資源的下列 IAM 權限：

  • gdchardwaremanagement.changeLogEntries.get

詳情請參閱 IAM 說明文件。
GetComment

rpc GetComment(GetCommentRequest) returns (Comment)

取得留言內容。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱驗證總覽一文。

IAM 權限

需要 name 資源的下列 IAM 權限：

  • gdchardwaremanagement.comments.get

詳情請參閱 IAM 說明文件。
GetHardware

rpc GetHardware(GetHardwareRequest) returns (Hardware)

取得硬體詳細資料。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱驗證總覽一文。

IAM 權限

需要 name 資源的下列 IAM 權限：

  • gdchardwaremanagement.hardware.get

詳情請參閱 IAM 說明文件。
GetHardwareGroup

rpc GetHardwareGroup(GetHardwareGroupRequest) returns (HardwareGroup)

取得硬體群組的詳細資料。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱驗證總覽一文。

IAM 權限

需要 name 資源的下列 IAM 權限：

  • gdchardwaremanagement.hardwareGroups.get

詳情請參閱 IAM 說明文件。
GetOrder

rpc GetOrder(GetOrderRequest) returns (Order)

取得訂單詳細資料。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱驗證總覽一文。

IAM 權限

需要 name 資源的下列 IAM 權限：

  • gdchardwaremanagement.orders.get

詳情請參閱 IAM 說明文件。
GetSite

rpc GetSite(GetSiteRequest) returns (Site)

取得網站的詳細資料。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱驗證總覽一文。

IAM 權限

需要 name 資源的下列 IAM 權限：

  • gdchardwaremanagement.sites.get

詳情請參閱 IAM 說明文件。
GetSku

rpc GetSku(GetSkuRequest) returns (Sku)

取得 SKU 的詳細資料。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱驗證總覽一文。

IAM 權限

需要 name 資源的下列 IAM 權限：

  • gdchardwaremanagement.skus.get

詳情請參閱 IAM 說明文件。
GetZone

rpc GetZone(GetZoneRequest) returns (Zone)

取得區域的詳細資料。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱驗證總覽一文。

IAM 權限

需要 name 資源的下列 IAM 權限：

  • gdchardwaremanagement.zones.get

詳情請參閱 IAM 說明文件。
ListChangeLogEntries

rpc ListChangeLogEntries(ListChangeLogEntriesRequest) returns (ListChangeLogEntriesResponse)

列出訂單的變更內容。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱驗證總覽一文。

IAM 權限

需要 parent 資源的下列 IAM 權限：

  • gdchardwaremanagement.changeLogEntries.list

詳情請參閱 IAM 說明文件。
ListComments

rpc ListComments(ListCommentsRequest) returns (ListCommentsResponse)

列出訂單的註解。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱驗證總覽一文。

IAM 權限

需要 parent 資源的下列 IAM 權限：

  • gdchardwaremanagement.comments.list

詳情請參閱 IAM 說明文件。
ListHardware

rpc ListHardware(ListHardwareRequest) returns (ListHardwareResponse)

列出指定專案和位置中的硬體。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱驗證總覽一文。

IAM 權限

需要 parent 資源的下列 IAM 權限：

  • gdchardwaremanagement.hardware.list

詳情請參閱 IAM 說明文件。
ListHardwareGroups

rpc ListHardwareGroups(ListHardwareGroupsRequest) returns (ListHardwareGroupsResponse)

依指定順序列出硬體群組。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱驗證總覽一文。

IAM 權限

需要 parent 資源的下列 IAM 權限：

  • gdchardwaremanagement.hardwareGroups.list

詳情請參閱 IAM 說明文件。
ListOrders

rpc ListOrders(ListOrdersRequest) returns (ListOrdersResponse)

列出指定專案和位置的訂單。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱驗證總覽一文。

IAM 權限

需要 parent 資源的下列 IAM 權限：

  • gdchardwaremanagement.orders.list

詳情請參閱 IAM 說明文件。
ListSites

rpc ListSites(ListSitesRequest) returns (ListSitesResponse)

列出指定專案和位置中的網站。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱驗證總覽一文。

IAM 權限

需要 parent 資源的下列 IAM 權限：

  • gdchardwaremanagement.sites.list

詳情請參閱 IAM 說明文件。
ListSkus

rpc ListSkus(ListSkusRequest) returns (ListSkusResponse)

列出指定專案和位置的 SKU。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱驗證總覽一文。

IAM 權限

需要 parent 資源的下列 IAM 權限：

  • gdchardwaremanagement.skus.list

詳情請參閱 IAM 說明文件。
ListZones

rpc ListZones(ListZonesRequest) returns (ListZonesResponse)

列出指定專案和位置中的區域。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱驗證總覽一文。

IAM 權限

需要 parent 資源的下列 IAM 權限：

  • gdchardwaremanagement.zones.list

詳情請參閱 IAM 說明文件。
SubmitOrder

rpc SubmitOrder(SubmitOrderRequest) returns (Operation)

提交訂單。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱驗證總覽一文。

IAM 權限

需要 name 資源的下列 IAM 權限：

  • gdchardwaremanagement.orders.submit

詳情請參閱 IAM 說明文件。
UpdateHardware

rpc UpdateHardware(UpdateHardwareRequest) returns (Operation)

更新硬體參數。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱驗證總覽一文。

IAM 權限

需要 name 資源的下列 IAM 權限：

  • gdchardwaremanagement.hardware.update

詳情請參閱 IAM 說明文件。
UpdateHardwareGroup

rpc UpdateHardwareGroup(UpdateHardwareGroupRequest) returns (Operation)

更新硬體群組的參數。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱驗證總覽一文。

IAM 權限

需要 name 資源的下列 IAM 權限：

  • gdchardwaremanagement.hardwareGroups.update

詳情請參閱 IAM 說明文件。
UpdateOrder

rpc UpdateOrder(UpdateOrderRequest) returns (Operation)

更新訂單的參數。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱驗證總覽一文。

IAM 權限

需要 name 資源的下列 IAM 權限：

  • gdchardwaremanagement.orders.update

詳情請參閱 IAM 說明文件。
UpdateSite

rpc UpdateSite(UpdateSiteRequest) returns (Operation)

更新網站的參數。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱驗證總覽一文。

IAM 權限

需要 name 資源的下列 IAM 權限：

  • gdchardwaremanagement.sites.update

詳情請參閱 IAM 說明文件。
UpdateZone

rpc UpdateZone(UpdateZoneRequest) returns (Operation)

更新可用區的參數。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱驗證總覽一文。

IAM 權限

需要 name 資源的下列 IAM 權限：

  • gdchardwaremanagement.zones.update

詳情請參閱 IAM 說明文件。

ChangeLogEntry

訂單變更的記錄項目。

欄位
name

string

ID。這項變更記錄項目的名稱。格式：projects/{project}/locations/{location}/orders/{order}/changeLogEntries/{change_log_entry}
create_time

Timestamp

僅供輸出。建立這項變更記錄項目的時間。
labels

map<string, string>

選用。與這個變更記錄項目相關聯的標籤，以鍵/值組合形式呈現。如要進一步瞭解標籤，請參閱「建立及管理標籤」。
log

string

僅供輸出。這項記錄項目的內容。

註解

訂單備註。

欄位
name

string

ID。這項註解的名稱。格式：projects/{project}/locations/{location}/orders/{order}/comments/{comment}
create_time

Timestamp

僅供輸出。建立這則留言的時間。
labels

map<string, string>

選用。與這個註解相關聯的標籤，以鍵/值組合的形式呈現。如要進一步瞭解標籤，請參閱「建立及管理標籤」。
author

string

僅供輸出。這則留言的作者使用者名稱。系統會根據建立留言時使用的憑證自動填入這項資訊。
text

string

這是必要旗標，這則留言的文字。文字長度必須 <= 1000 個半形字元。

聯絡人

聯絡窗口的聯絡資料。

欄位
given_name

string

這是必要旗標，聯絡人的名字。
family_name

string

選用。聯絡人的姓氏。
email

string

這是必要旗標，聯絡人的電子郵件地址。
phone

string

這是必要旗標，聯絡人的電話號碼。
time_zone

TimeZone

選用。聯絡人的時區。
reachable_times[]

TimePeriod

選用。聯絡人可聯絡的時間範圍。如果這個欄位空白，表示隨時都能聯絡到聯絡人。

CreateCommentRequest

建立留言的要求。

欄位
parent

string

這是必要旗標，要在哪個訂單建立留言。格式：projects/{project}/locations/{location}/orders/{order}
comment_id

string

選用。用來在父項範圍內明確識別留言的 ID。這個欄位最多可包含 63 個字元，且開頭必須為小寫字元。只能使用小寫字元、數字和 -。「-」字元不得為第一個或最後一個字元。如果未設定這個欄位，系統會使用產生的 ID。

系統會忽略要求中的 comment.name 欄位。
comment

Comment

這是必要旗標，要建立的留言。
request_id

string

選用。這項要求的選用專屬 ID。請參閱 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

選用。這項要求的選用專屬 ID。請參閱 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

選用。這項要求的選用專屬 ID。請參閱 AIP-155。

CreateSiteRequest

建立網站的要求。

欄位
parent

string

這是必要旗標，要在哪個專案和位置建立網站。格式：projects/{project}/locations/{location}
site_id

string

選用。用於在父項範圍內專屬識別網站的 ID。這個欄位最多可包含 63 個字元，且開頭必須為小寫字元。只能使用小寫字元、數字和 -。「-」字元不得為第一個或最後一個字元。如果未設定這個欄位，系統會使用產生的 ID。

系統會忽略要求中的 site.name 欄位。
site

Site

這是必要旗標，要建立的網站。
request_id

string

選用。這項要求的選用專屬 ID。請參閱 AIP-155。

CreateZoneRequest

建立區域的要求。

欄位
parent

string

這是必要旗標，要在其中建立可用區的專案和位置。格式：projects/{project}/locations/{location}
zone_id

string

選用。用來在父項範圍內，唯一識別區域的 ID。這個欄位最多可包含 63 個字元，且開頭必須為小寫字元。只能使用小寫字元、數字和 -。「-」字元不得為第一個或最後一個字元。如果未設定這個欄位，系統會使用產生的 ID。

系統會忽略要求中的 zone.name 欄位。
zone

Zone

這是必要旗標，要建立的可用區。
request_id

string

選用。這項要求的選用專屬 ID。請參閱 AIP-155。

DeleteHardwareGroupRequest

要求刪除硬體群組。

欄位
name

string

這是必要旗標，硬體群組的名稱。格式：projects/{project}/locations/{location}/orders/{order}/hardwareGroups/{hardware_group}
request_id

string

選用。這項要求的選用專屬 ID。請參閱 AIP-155。

DeleteHardwareRequest

要求刪除硬體。

欄位
name

string

這是必要旗標，硬體名稱。格式：projects/{project}/locations/{location}/hardware/{hardware}
request_id

string

選用。這項要求的選用專屬 ID。請參閱 AIP-155。

DeleteOrderRequest

要求刪除訂單。

欄位
name

string

這是必要旗標，訂單名稱。格式：projects/{project}/locations/{location}/orders/{order}
request_id

string

選用。這項要求的選用專屬 ID。請參閱 AIP-155。
force

bool

選用。可刪除訂單中的任何巢狀資源，例如 HardwareGroup。如果為 true，系統也會刪除這項訂單的所有巢狀資源。否則，只有在訂單沒有巢狀資源時，要求才會成功。

DeleteZoneRequest

要求刪除區域。

欄位
name

string

這是必要旗標，區域名稱。格式：projects/{project}/locations/{location}/zones/{zone}
request_id

string

選用。這項要求的選用專屬 ID。請參閱 AIP-155。

維度

代表物件的尺寸。

欄位
width_inches

float

這是必要旗標，寬度 (以英吋為單位)。
height_inches

float

這是必要旗標，身高 (吋)。
depth_inches

float

這是必要旗標，深度 (以英吋為單位)。

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

ID。這項硬體的名稱。格式：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

Date

選用。這項硬體要求的安裝日期。如果硬體的 HardwareGroup 指定此項目，系統會在接受訂單時自動填入。顧客也可以填寫這份表單。
actual_installation_date

Date

僅供輸出。這項硬體的實際安裝日期。由 Google 填入。

狀態

硬體的有效狀態。

列舉
STATE_UNSPECIFIED 未指定硬體狀態。
ADDITIONAL_INFO_NEEDED 我們需要顧客提供更多資訊，才能繼續處理。
BUILDING Google 已開始為這項硬體建構硬體。
SHIPPING 硬體已建構完成，目前正在運送中。
INSTALLING 正在安裝硬體。
INSTALLED 硬體已安裝完畢。
FAILED 發生錯誤，需要顧客介入處理。

HardwareConfig

GDC 硬體的設定。

欄位
sku

string

這是必要旗標，這項硬體的 SKU 參考資料。這可以指向特定 SKU 修訂版本，格式為 resource_name@revision_id，如 AIP-162 中所定義。如果未指定 revision_id，則是指最新修訂版本。
power_supply

PowerSupply

這是必要旗標，這項硬體的電源供應器類型。
subscription_duration_months

int32

選用。硬體的訂閱期限 (以月為單位)。

HardwareGroup

同一筆訂單中的一組硬體，具有相同 SKU，且運送至同一地點。

欄位
name

string

ID。這個硬體群組的名稱。格式：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

Date

選用。這個 HardwareGroup 中硬體的所要求安裝日期。由消費者填寫。

狀態

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 兩柱型機架。
FOUR_POST 四柱型機架。

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 標準歐洲插座。

電壓

有效電壓值。

列舉
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}
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

僅供輸出。識別使用者是否要求取消作業。成功取消的作業會具有 [Operation.error][] 值，且 google.rpc.Status.code 為 1，也就是 Code.CANCELLED。
api_version

string

僅供輸出。用於啟動作業的 API 版本。

訂單

GDC 硬體訂單。

欄位
name

string

ID。這項訂單的名稱。格式：projects/{project}/locations/{location}/orders/{order}
display_name

string

選用。這項訂單的顯示名稱。
create_time

Timestamp

僅供輸出。建立這筆訂單的時間。
update_time

Timestamp

僅供輸出。上次更新這筆訂單的時間。
labels

map<string, string>

選用。與這個訂單相關聯的標籤，以鍵/值組合的形式呈現。如要進一步瞭解標籤，請參閱「建立及管理標籤」。
state

State

僅供輸出。這筆訂單的狀態。建立訂單時，狀態會設為「草稿」。
organization_contact

OrganizationContact

這是必要旗標，顧客聯絡資訊。
target_workloads[]

string

選用。這筆訂單指定的目標工作負載。其中必須包含 <= 20 個元素，且每個元素的長度必須 <= 50 個字元。
customer_motivation

string

這是必要旗標，客戶下單的動機。這個欄位的長度必須 <= 1000 個字元。
fulfillment_time

Timestamp

這是必要旗標，客戶指定的訂單履行期限。
region_code

string

這是必要旗標，要部署這項訂單的 Unicode CLDR 區域代碼。如需有效的 CLDR 區域代碼清單，請參閱語言子標記登錄。
order_form_uri

string

僅供輸出。訂單表單連結。
type

Type

僅供輸出。這項訂單的類型。
submit_time

Timestamp

僅供輸出。提交訂單的時間。提交訂單時，系統會自動填入目前時間。
billing_id

string

這是必要旗標，這筆訂單的 Google Cloud 帳單 ID。
existing_hardware[]

HardwareLocation

選用。現有硬體將於本次訂單中移除。注意：除非另有協議，否則移除的硬體都會回收。

狀態

訂單的有效狀態。

列舉
STATE_UNSPECIFIED 未指定訂單狀態。
DRAFT 顧客正在草擬訂單，尚未提交。
SUBMITTED 訂單已提交給 Google。
ACCEPTED Google 已接受訂單。
ADDITIONAL_INFO_NEEDED 訂單需要顧客提供更多資訊。
BUILDING Google 已開始為訂單建構硬體。
SHIPPING 硬體已建構完成，目前正在運送中。
INSTALLING 正在安裝硬體。
FAILED 處理訂單時發生錯誤，需要客戶介入處理。
PARTIALLY_COMPLETED 訂單已部分完成，也就是已送達並安裝部分硬體。
COMPLETED 訂單已完成。
CANCELLED 訂單已取消。

類型

訂單的有效類型。

列舉
TYPE_UNSPECIFIED 未指定訂單類型。
PAID 由消費者支付。
POC 為客戶提供概念驗證。

OrganizationContact

客戶機構的聯絡資訊。

欄位
address

PostalAddress

這是必要旗標，機構地址。
email

string

選用。機構的電子郵件地址。
phone

string

選用。機構的電話號碼。
contacts[]

Contact

這是必要旗標，機構中這個地點的個別聯絡窗口。

PowerSupply

電源供應器選項。

列舉
POWER_SUPPLY_UNSPECIFIED 未指定電源供應器。
POWER_SUPPLY_AC AC 電源供應器。
POWER_SUPPLY_DC 直流電源供應器。

RackSpace

代表機架中的連續空間。

欄位
start_rack_unit

int32

這是必要旗標，機架空間的第一個機架單位 (含)。
end_rack_unit

int32

這是必要旗標，機架空間的最後一個機架單位 (含)。

網站

安裝硬體的實體地點。

欄位
name

string

ID。網站名稱。格式：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 地圖地址位置網址。範例值為 https://goo.gl/maps/xxxxxxxxx。
access_times[]

TimePeriod

選用。網站可存取的時段。如果這個欄位留空，網站隨時都能存取。
notes

string

選用。這個地點的額外附註。請提供以下資訊： - 安全或存取限制 - 影響技術人員現場作業的任何法規 - 搬運設備所需的任何特殊程序或核准 - 現場作業期間是否會有代表在場

SKU

GDC 硬體的存貨單位 (SKU)。

欄位
name

string

ID。這個 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 個字元的十六進位字串。
is_active

bool

僅供輸出。此標記用於指出這個修訂版本是否有效。只有有效修訂版本才能用於新訂單。
type

Type

僅供輸出。這個 SKU 的類型。
vcpu_count

int32

僅供輸出。與這個 SKU 相關聯的 vCPU 數量。

類型

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

這個執行個體可用的 Unicode 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

選用。這項要求的選用專屬 ID。請參閱 AIP-155。

子網路

代表子網路。

欄位
address_range

string

這是必要旗標，這個子網路的位址範圍 (以 CIDR 標記法表示)。
default_gateway_ip_address

string

這是必要旗標，這個子網路的預設閘道。

TimePeriod

代表一週內的時間範圍。

欄位
start_time

TimeOfDay

這是必要旗標，時間範圍的開始時間。
end_time

TimeOfDay

這是必要旗標，時間範圍的結束時間。
days[]

DayOfWeek

這是必要旗標，時段生效的星期幾。

UpdateHardwareGroupRequest

更新硬體群組的要求。

欄位
update_mask

FieldMask

這是必要旗標，遮罩，用於指定要透過這次更新覆寫的 HardwareGroup 欄位。update_mask 中指定的欄位與硬體群組相關，而非完整要求。如果欄位位於遮罩中，系統會覆寫該欄位。如未提供遮罩，系統會覆寫所有欄位。
hardware_group

HardwareGroup

這是必要旗標，要更新的硬體群組。
request_id

string

選用。這項要求的選用專屬 ID。請參閱 AIP-155。

UpdateHardwareRequest

更新硬體的要求。

欄位
update_mask

FieldMask

這是必要旗標，遮罩，用於指定要透過這次更新覆寫的硬體欄位。update_mask 中指定的欄位與硬體相關，而非完整要求。如果欄位位於遮罩中，系統會覆寫該欄位。如未提供遮罩，系統會覆寫所有欄位。
hardware

Hardware

這是必要旗標，要更新的硬體。
request_id

string

選用。這項要求的選用專屬 ID。請參閱 AIP-155。

UpdateOrderRequest

更新訂單的要求。

欄位
update_mask

FieldMask

這是必要旗標，遮罩，用於指定要透過這次更新覆寫的訂單欄位。update_mask 中指定的欄位與訂單相關，而非完整要求。如果欄位位於遮罩中，系統會覆寫該欄位。如未提供遮罩，系統會覆寫所有欄位。
order

Order

這是必要旗標，要更新的訂單。
request_id

string

選用。這項要求的選用專屬 ID。請參閱 AIP-155。

UpdateSiteRequest

更新網站的要求。

欄位
update_mask

FieldMask

這是必要旗標，遮罩，用於指定要透過這項更新覆寫的網站欄位。update_mask 中指定的欄位與網站相關，而非完整要求。如果欄位位於遮罩中，系統會覆寫該欄位。如未提供遮罩，系統會覆寫所有欄位。
site

Site

這是必要旗標，要更新的網站。
request_id

string

選用。這項要求的選用專屬 ID。請參閱 AIP-155。

UpdateZoneRequest

更新區域的要求。

欄位
update_mask

FieldMask

這是必要旗標，遮罩，用於指定要透過這次更新覆寫的區域欄位。update_mask 中指定的欄位與區域相關，而非完整要求。如果欄位位於遮罩中，系統會覆寫該欄位。如未提供遮罩，系統會覆寫所有欄位。
zone

Zone

這是必要旗標，要更新的區域。
request_id

string

選用。這項要求的選用專屬 ID。請參閱 AIP-155。

可用區

可用區包含一組硬體。

欄位
name

string

ID。這個區域的名稱。格式：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

選用。這個可用區的網路設定。

狀態

可用區的有效狀態。

列舉
STATE_UNSPECIFIED 未指定可用區狀態。
ADDITIONAL_INFO_NEEDED 我們需要顧客提供更多資訊，才能繼續處理。
PREPARING Google 正在準備區域。
ACTIVE 現在可以使用 Zone。
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 子網路會與管理子網路相同。