Package google.cloud.gdchardwaremanagement.v1alpha

索引

GDCHardwareManagement

GDC Hardware Management 服務。

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，系統會將留言中的檢視時間設為收到要求的時間。如果留言已標示為已讀，系統會忽略後續呼叫。如果動作為「未讀」，系統會從留言中清除查看時間。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
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 說明文件。

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 個半形字元。
customer_viewed_time

Timestamp

僅供輸出。顧客首次查看這則留言的時間戳記。如果未查看留言，系統就會取消設定這個時間戳記。
author_entity

Entity

僅供輸出。作者所屬的實體。

聯絡人

聯絡窗口的聯絡資料。

欄位
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，系統也會刪除這項訂單的所有巢狀資源。否則，只有在訂單沒有巢狀資源時，要求才會成功。

DeleteSiteRequest

刪除網站的要求。

欄位
name

string

這是必要旗標，網站名稱。格式：projects/{project}/locations/{location}/sites/{site}
request_id

string

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

DeleteZoneRequest

要求刪除區域。

欄位
name

string

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

string

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

維度

代表物件的尺寸。

欄位
width_inches

float

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

float

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

float

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

實體

實體用於表示機構或當事人。

列舉
ENTITY_UNSPECIFIED 未指定實體。
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

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

選用。這項硬體要求的安裝日期。如未指定，系統會在提交時自動填入訂單的 fulfillment_time，或在接受訂單時填入 HardwareGroup 的 requested_installation_date。
actual_installation_date

Date

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

MachineInfo

僅供輸出。啟動時需要每部機器的資產資訊。

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 參考資料。這可以指向特定 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}

如要列出所有地點的硬體，請將地點替換為 - (連字號或破折號字元)，並檢查回應訊息中的 unreachable 欄位。
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}

如要列出所有地點的訂單，請將地點替換為 - (連字號或破折號字元)，並檢查回應訊息中的 unreachable 欄位。
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}

如要列出所有位置的區域，請將位置替換為 - (連字號或破折號字元)，並檢查回應訊息中的 unreachable 欄位。
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

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

DeploymentType

僅供輸出。這項訂單的部署類型。
actual_installation_date

Date

僅供輸出。這項訂單的實際安裝日期。
estimated_installation_date

Date

僅供輸出。這項訂單的預計安裝日期。

DeploymentType

部署作業的有效類型。

列舉
DEPLOYMENT_TYPE_UNSPECIFIED 未指定部署類型。
FULL_PRODUCTION 使用服務等級目標部署正式版。
PROOF_OF_CONCEPT 部署時盡量提供支援，但不保證服務水準。
INTERNAL 內部部署，盡量提供支援，不提供服務水準目標。
CUSTOMER_LAB 我們支援客戶實驗室部署作業，就像支援正式環境一樣。

狀態

訂單的有效狀態。

列舉
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 直流電源供應器。

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 將留言標示為未讀。

SignalZoneStateRequest

要求發出區域狀態信號。

欄位
name

string

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

string

選用。這項要求的選用專屬 ID。請參閱 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 區域未通過工廠啟動檢查。

網站

安裝硬體的實體地點。

欄位
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

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

Google 會使用這個欄位排定初始安裝時間，以及後續的硬體維護時間。你隨時可以更新這項設定。舉例來說，如果要求在非營業時間進行初始安裝，但維護作業應在正常營業時間內執行，您應在初始安裝完成後更新存取時間。
notes

string

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

string

選用。這個網站的客戶定義 ID。這項資訊可用於在顧客的系統中識別網站。

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 數量。
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

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

Type

選用。這項要求的類型。如未設定，系統會假設要求類型為 INFO_PENDING。

類型

可提交訂單要求的有效類型。

列舉
TYPE_UNSPECIFIED 未指定要求類型。請勿使用這項功能。
INFO_PENDING 使用這類要求提交訂單，並與 Google 展開對話。提交後，您將無法修改訂購的硬體數量或 SKU。請注意，您必須提供更多資訊 (例如區域網路設定、硬體實體和安裝資訊等)，我們才能處理這項訂單。如果您要為 RACK 類型的 SKU 提交訂單，請使用這個要求類型，因為 API 以外還需要其他資訊。
INFO_COMPLETE 當您準備好要提交訂單以利出貨時，請使用這類要求。除了 INFO_PENDING 要求的資訊外，訂單也必須包含所有必要資訊，例如區域網路設定、硬體實體和安裝資訊等。訂單資訊一經提交，就不得再進行任何變更。

子網路

代表子網路。

欄位
address_range

string

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

string

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

SubscriptionConfig

用於儲存訂閱項目設定的訊息。

欄位
subscription_id

string

僅供輸出。訂閱項目的專屬 ID。
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

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

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

string

僅供輸出。系統為這個 Edge Zone 產生的全域專屬 ID。
subscription_configs[]

SubscriptionConfig

僅供輸出。這個可用區的訂閱設定。
provisioning_state

ProvisioningState

僅供輸出。設定 (例如 MAC 位址) 的佈建狀態。

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 Zone 正在執行工廠啟動檢查。
READY_FOR_SITE_TURNUP 區域已準備好啟用網站。
CUSTOMER_FACTORY_TURNUP_CHECKS_FAILED 區域未通過工廠啟動檢查。
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 子網路會與管理子網路相同。
dns_ipv4_addresses[]

string

選用。DNS 網域名稱伺服器。GDC 基礎架構會透過這些 IP 解析 DNS 查詢。如未指定，則會使用 Google DNS。
kubernetes_primary_vlan_id

int32

選用。Kubernetes VLAN ID。根據預設，Kubernetes 節點 (包括主要 Kubernetes 網路) 會與機器管理網路位於相同的 VLAN。如要將網路分成不同的區隔，可以選擇分隔該節點與網路。