Package google.cloud.gdchardwaremanagement.v1alpha

索引

GDCHardwareManagement

GDC Hardware Management 服務。

CancelOrder

rpc CancelOrder(CancelOrderRequest) returns (Operation)

取消訂單。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。

IAM 權限

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

  • gdchardwaremanagement.orders.submit

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

rpc ChangeHardwareSubscription(ChangeHardwareSubscriptionRequest) returns (Operation)

更新硬體的訂閱設定。

授權範圍

需要下列 OAuth 範圍：

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

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

rpc CreateZoneOperation(CreateZoneOperationRequest) returns (Operation)

在指定可用區中建立新的 ZoneOperation。

授權範圍

需要下列 OAuth 範圍：

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

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

rpc DeleteZoneOperation(DeleteZoneOperationRequest) returns (Operation)

刪除單一 ZoneOperation。

授權範圍

需要下列 OAuth 範圍：

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

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

rpc GetZoneOperation(GetZoneOperationRequest) returns (ZoneOperation)

取得單一 ZoneOperation 的詳細資料。

授權範圍

需要下列 OAuth 範圍：

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

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

rpc ListZoneOperations(ListZoneOperationsRequest) returns (ListZoneOperationsResponse)

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

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
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。
RequestOrderDateChange

rpc RequestOrderDateChange(RequestOrderDateChangeRequest) returns (Operation)

更新單一訂單的所要求日期異動。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。

IAM 權限

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

  • gdchardwaremanagement.orders.update

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

rpc SignalHardwareState(SignalHardwareStateRequest) returns (Operation)

表示硬體狀態。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。

IAM 權限

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

  • gdchardwaremanagement.hardware.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 說明文件。
UpdateZoneOperation

rpc UpdateZoneOperation(UpdateZoneOperationRequest) returns (Operation)

更新單一 ZoneOperation 的參數。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
ValidateHardware

rpc ValidateHardware(ValidateHardwareRequest) returns (Operation)

驗證以 JSON 資料形式提供的硬體設定。這個方法會執行靜態檢查，不會建立或修改任何資源

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。

BGPConfig

邊界閘道通訊協定 (BGP) 設定。

欄位
asn

string

這是必要旗標，BGP 自治系統編號 (ASN)。
l3_peer_ips[]

string

這是必要旗標，BGP 對等互連 IP。至少需要兩個 L3 對等互連 IP。

CancelOrderRequest

要求取消訂單。

欄位
name

string

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

string

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

電信業者

電信業者清單。

列舉
CARRIER_UNSPECIFIED 未指定貨運公司。
FEDEX 貨運公司 FedEx。
UPS 貨運公司 UPS。
USPS 貨運公司：USPS。

ChangeHardwareSubscriptionRequest

要求變更硬體的訂閱設定。

欄位
name

string

這是必要旗標，要更新的硬體名稱。
term_end_behavior

TermEndBehavior

這是必要旗標，訂閱方案在約期結束時的行為。

TermEndBehavior

訂閱方案的約期結束行為。

列舉
TERM_END_BEHAVIOR_UNSPECIFIED 未指定學期結束行為。
TERMINATE_AT_TERM_END 終止行為為 TERMINATE_AT_TERM_END。

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

選用。聯絡人的主要電子郵件地址。
email_list[]

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

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

CreateZoneOperationRequest

建立 ZoneOperation 的要求訊息。

欄位
parent

string

這是必要旗標，表示將建立這項作業的父項區域。格式：projects/{project}/locations/{location}/zones/{zone}
zone_operation_id

string

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

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

ZoneOperation

這是必要旗標，要建立的區域作業。
request_id

string

選用。(選用) 用於識別要求的 ID。指定專屬要求 ID，這樣一來，如果必須重試要求，伺服器就會知道要忽略已完成的要求。伺服器會保證至少在第一次要求後的 60 分鐘內，

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。

DeleteZoneOperationRequest

要求刪除 ZoneOperation 的訊息。

欄位
name

string

這是必要旗標，資源名稱。格式：projects/{project}/locations/{location}/zones/{zone}/ops/{zone_operation}
request_id

string

選用。(選用) 用於識別要求的 ID。指定專屬要求 ID，這樣一來，如果必須重試要求，伺服器就會知道要忽略已完成的要求。伺服器會保證至少在第一次要求後的 60 分鐘內，

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}

GetZoneOperationRequest

要求訊息，用於取得 ZoneOperation。

欄位
name

string

這是必要旗標，資源名稱。格式：projects/{project}/locations/{location}/zones/{zone}/ops/{zone_operation}

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
(deprecated)

Date

選用。已淘汰：所要求的安裝日期已移至 Order 資源。請改用 Order 資源的 customer_requested_installation_date。
actual_installation_date

Date

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

MachineInfo

選用。啟動時需要每部機器的資產資訊。
estimated_delivery_date

Date

僅供輸出。硬體的預計送達日期。
ai_capable

bool

僅供輸出。指出這項硬體是否適用於 Gemini on GDC Software。
subscription_configs[]

SubscriptionConfig

僅供輸出。這項硬體的訂閱設定。
operations[]

ResourceOperation

僅供輸出。對硬體執行的所有作業清單。
errors[]

Status

僅供輸出。硬體意圖啟動期間發生的錯誤。ErrorInfo 中繼資料會包含時間戳記，以及錯誤是否可重試。
shipping_info

ShippingInfo

僅供輸出。這項硬體的運送資訊。

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

選用。每個已安裝磁碟的資訊。
machine_type

MachineType

選用。機型。如要在硬體上執行 Gemini on GDC Software，這是必要操作。
tpm_ek_cert_hash

string

選用。TPM EK 憑證雜湊。維修硬體時必填。
gpu_serial_numbers[]

string

選用。GPU 序號。維修硬體時必填。
cpu_serial_numbers[]

string

選用。CPU 序號。維修硬體時必填。
memory_infos[]

MemoryInfo

選用。每個已安裝記憶體的資訊。維修硬體時必填。
idrac_mac_address

string

選填。iDRAC MAC 位址。維修硬體時必填。
nic_serial_numbers[]

string

選用。NIC 序號。維修硬體時必填。

MachineType

用於 Gemini on GDC Software 的機器類型列舉。

列舉
MACHINE_TYPE_UNSPECIFIED 未指定機型。
DELL_XE9680 Dell XE9680 伺服器。
DELL_XE9780 Dell XE9780 伺服器。

MemoryInfo

機器上個別記憶體的相關資訊。

欄位
serial_number

string

選用。記憶體序號。
size_bytes

int64

選用。記憶體大小。
part_number

string

選用。記憶體零件編號。

狀態

硬體的有效狀態。

列舉
STATE_UNSPECIFIED 未指定硬體狀態。
ADDITIONAL_INFO_NEEDED 我們需要顧客提供更多資訊，才能繼續處理。
BUILDING Google 已開始為這項硬體建構硬體。
SHIPPING 硬體已建構完成，目前正在運送中。
INSTALLING 正在安裝硬體。
INSTALLED 硬體已安裝完畢。
FAILED 發生錯誤，需要顧客介入處理。
INFO_COMPLETE 硬體具備所有必要資訊。
READY_FOR_PROVISIONING 硬體已可佈建。
PROVISIONING_STARTED 硬體已開始佈建。
PROVISIONING_FAILED 硬體佈建失敗。
AWAITING_IDENTIFIERS 硬體必須新增 ID。
READY_FOR_BOOTSTRAP 硬體已可啟動。

HardwareConfig

GDC 硬體的設定。

欄位
sku

string

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

PowerSupply

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

int32

選用。硬體訂閱時間長度 (以月為單位)。
auto_renewal

bool

選用。指出硬體訂閱方案是否會在約期結束時自動續訂。如果所選 SKU 支援自動續約，即可設定。

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

已淘汰：請改用 TYPE_G_BS1363、CEE_7_3、CEE_7_5 或 TYPE_F。
TYPE_G_BS1363 Type G / BS1363。
CEE_7_3 C 7/3。
CEE_7_5 CEE 7/5。
TYPE_F Type 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}

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

未排序的清單。無法連線的位置。僅適用於對萬用字元位置 - 的查詢。如果這個欄位不是空白，表示結果不完整。

ListZoneOperationsRequest

列出 ZoneOperations 的要求訊息。

欄位
parent

string

這是必要旗標，ListZoneOperationsRequest 的父項值。格式：projects/{project}/locations/{location}/zones/{zone}
page_size

int32

選用。要傳回的資源數量上限。服務傳回的產品數量可能會少於這個值。如未指定，最多將傳回 50 項資源。許可的最大值為 1000；超出的數值將一律指定為 1000。
page_token

string

選用。屬於接收自前一個 ListZoneOperations 呼叫的網頁權杖。提供此項目即可擷取後續網頁。
filter

string

選用。正在篩選結果。
order_by

string

選用。結果排序方式的提示。

ListZoneOperationsResponse

ListZoneOperations 的回應訊息。

欄位
zone_operations[]

ZoneOperation

指定集合中的資源。
next_page_token

string

可做為 page_token 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。
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

選用。客戶聯絡資訊。如果訂單在 GDC 軟體上放送 Gemini，則為選填；否則為必填。
target_workloads[]

string

選用。這筆訂單指定的目標工作負載。這個屬性最多可包含 20 個元素，每個元素的長度不得超過 50 個字元。
customer_motivation

string

選用。客戶下單的動機。這個欄位的長度必須 <= 1000 個字元。
fulfillment_time
(deprecated)

Timestamp

選用。已淘汰：請改用 customer_requested_installation_date。
customer_requested_installation_date

Date

選用。這筆訂單的客戶要求安裝日期。
region_code

string

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

string

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

Type

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

Timestamp

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

string

僅供輸出。這筆訂單的 Google Cloud Billing ID。
existing_hardware[]

HardwareLocation

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

DeploymentType

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

Date

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

Date

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

Date

僅供輸出。這筆訂單的預計送達日期。
migration

bool

選用。這筆訂單是否為從客戶現有基礎架構遷移而來。
accepted_time

Timestamp

僅供輸出。訂單移至「已接受」狀態的時間。
requested_date_change

Date

僅供輸出。客戶或 Google 要設定排定安裝日期的日期。
vendor_notes

string

僅供輸出。供應商為這項訂單提供的附註。
vendor_contact

OrganizationContact

僅供輸出。指派給這筆訂單的 SI 聯絡資訊。
ai_capable

bool

僅供輸出。指出這項訂單是否適用於支援 GDC 軟體上 Gemini 的硬體。成功提交訂單後，系統會自動填入。
requested_delivery_date

Date

選用。顧客可以透過這個欄位指定硬體送達日期。

DeploymentType

部署作業的有效類型。

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

狀態

訂單的有效狀態。

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

RequestOrderDateChangeRequest

要求變更訂單的預計送達日期。

欄位
name

string

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

Date

這是必要旗標，客戶或 Google 要設定排定安裝日期的日期。
reason

Reason

選用。要求變更日期的原因。
reason_details

string

選用。如果要求變更日期的原因是「其他」，則必須填寫這個欄位。

原因

要求變更日期的正當理由。

列舉
REASON_UNSPECIFIED 未指定日期變更原因。
REASON_SITE_NOT_READY 網站尚未準備就緒，無法安裝。
REASON_FACILITY_ACCESS_ISSUE 有設施進出問題。
REASON_CONSTRUCTION_OR_RENOVATION_DELAY 施工或整修有延誤。
REASON_POINT_OF_CONTACT_UNAVAILABLE 聯絡窗口無法配合。
REASON_SCHEDULE_CONFLICT 行程有衝突。
REASON_SPECIFIED_INCORRECT_DATE 先前指定的要求日期不正確。
REASON_OTHER 其他原因。

ResourceOperation

代表資源的進行中作業

欄位
uid

string

僅供輸出。作業 ID。
state

State

僅供輸出。作業狀態。
type

Type

僅供輸出。作業類型。
state_history[]

StateHistoryEntry

僅供輸出。作業的狀態記錄。
requires_re_turnup

bool

僅供輸出。指出是否需要重新啟動的旗標。

狀態

作業狀態的列舉。

列舉
STATE_UNSPECIFIED 未指定作業狀態。
AWAITING_CUSTOMER_INPUT 這項作業正在等待顧客輸入內容。
PROGRESSING 作業正在進行中。
COMPLETED 作業完成。

StateHistoryEntry

作業狀態記錄的項目。

欄位
state

State

僅供輸出。作業狀態。
update_time

Timestamp

僅供輸出。作業狀態的更新時間戳記。
reason

string

僅供輸出。狀態變更的原因。
responsible_entity

Entity

僅供輸出。變更狀態的實體。

類型

作業類型。日後可能會在這個列舉中新增值。

列舉
TYPE_UNSPECIFIED 未指定作業類型。
REPAIR 修復作業。
SUSPEND 暫停作業。
RESUME 繼續作業。

ShippingInfo

ShippingInfo 說明出貨的物流資訊。

欄位
carrier

Carrier

僅供輸出。貨運公司。
tracking_id

string

僅供輸出。貨品的追蹤 ID。

SignalHardwareStateRequest

要求發出硬體狀態信號。

欄位
name

string

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

string

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

StateSignal

選用。指定要為這項硬體傳送的狀態信號。
operation_type

Type

選用。指定要發出狀態信號的作業類型。如未指定類型，系統會假設信號用於初始佈建。
re_turnup_required

bool

選用。指出在完成維修程序時是否需要重新啟動。

StateSignal

硬體的有效狀態信號。

列舉
STATE_SIGNAL_UNSPECIFIED 未指定硬體的狀態信號。
READY_FOR_PROVISIONING 硬體已可佈建。

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 區域未通過出廠檢查。
VERIFY_CLUSTER_INTENT_PRESENCE 確認有有效的叢集意圖。
SITE_VALIDATION_PASSED 網站驗證已通過所有檢查。
SITE_VALIDATION_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。這項資訊可用於在顧客自己的系統中識別網站。
installation_requirements_met

bool

選用。指出顧客的網站是否符合所有安裝規定。

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 時，可用區允許的硬體數量範圍 (含上限和下限)。
ai_capable

bool

僅供輸出。這個 SKU 是否適用於在 GDC 軟體上執行 Gemini 的硬體。
customer_sourced

bool

僅供輸出。這個 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 Billing ID。
state

SubscriptionState

僅供輸出。訂閱方案的目前狀態。
start_time

Timestamp

僅供輸出。訂閱的開始時間。

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。

UpdateZoneOperationRequest

用於更新 ZoneOperation 的要求訊息。

欄位
update_mask

FieldMask

選用。欄位遮罩用於指定更新作業要在 ZoneOperation 資源中覆寫的欄位。update_mask 中指定的欄位與資源相關，而非完整要求。如果欄位位於遮罩中，系統會覆寫該欄位。如果使用者未提供遮罩，系統會覆寫所有欄位。
zone_operation

ZoneOperation

這是必要旗標，要更新的資源。
request_id

string

選用。(選用) 用於識別要求的 ID。指定專屬要求 ID，這樣一來，如果必須重試要求，伺服器就會知道要忽略已完成的要求。伺服器會保證至少在第一次要求後的 60 分鐘內，

UpdateZoneRequest

更新區域的要求。

欄位
update_mask

FieldMask

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

Zone

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

string

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

ValidateHardwareRequest

驗證硬體的要求。

欄位
parent

string

這是必要旗標，要驗證硬體的專案和位置。格式：projects/{project}/locations/{location}
data

Struct

這是必要旗標，要驗證的資料。其中包含驗證類型 (BOM、BMC、NW) 和平台資訊，內含驗證所需的詳細資料。Sample JSON: { "validation_type": "BOM", "machine_spec": "DellXE9680Spec", "platform_info": { "bom_validation_info": { "bios_version": { "cmd": "echo 2.6.3", "failed": false, "rc": 0.0, "stderr": "", "stdout": "2.6.3" } } } }

ValidateHardwareResponse

ValidateHardware 方法的回應訊息。

欄位
validation_results[]

ValidationResult

驗證結果。

ValidationResult

驗證結果。

欄位
type

string

驗證類型。
status

string

驗證狀態。
message

string

驗證結果的訊息。
resolutions[]

string

選用。建議的驗證失敗解決方式。

可用區

可用區：一組硬體。

欄位
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 位址。
skip_cluster_provisioning

bool

選用。是否要在工廠啟動期間略過叢集佈建步驟。如果為 true，表示 Kubernetes 叢集會在可用區的硬體安裝在客戶端後建立。
cluster_intent_required

bool

僅供輸出。指出顧客是否必須先提供有效的叢集意圖，才能接受訂單。如為 true，必須先設定叢集意圖，才能接受訂單。這項功能可用於強制執行初步驗證，避免因缺少設定而導致延遲。
cluster_intent_verified

bool

僅供輸出。指出提供的叢集意圖是否已成功驗證。這個標記可確保叢集意圖存在，才能接受訂單。
ai_capable

bool

選用。指出這個區域是否適用於 GDC 軟體叢集上的 Gemini。
intel_pccs_key

string

選用。Intel 平台設定和認證服務 (PCCS) 金鑰，用於佈建及認證 AI 加速器硬體。用於在 GDC 軟體叢集上提供 Gemini 的區域。
current_resource_operation

ResourceOperation

僅供輸出。該區域目前的資源作業。
resource_operations[]

ResourceOperation

選用。對區域執行的所有資源作業清單。
errors[]

Status

僅供輸出。區域啟動期間發生的錯誤。ErrorInfo 中繼資料會包含時間戳記，以及錯誤是否可重試。
site

string

選用。指定這個區域中硬體所在的網站名稱。格式：projects/{project}/locations/{location}/sites/{site} Gemini on GDC 軟體區域必須使用此格式。

ProvisioningState

設定 (例如 MAC 位址) 的有效佈建狀態。

列舉
PROVISIONING_STATE_UNSPECIFIED 未指定佈建狀態。
PROVISIONING_REQUIRED 必須佈建。由 Google 設定。
PROVISIONING_IN_PROGRESS 正在佈建，由顧客設定。
PROVISIONING_COMPLETE 佈建完成。由顧客設定。

狀態

區域的有效狀態。

列舉
STATE_UNSPECIFIED 未指定可用區狀態。
ADDITIONAL_INFO_NEEDED 我們需要顧客提供更多資訊，才能繼續處理。
INFO_COMPLETE 專區提供開始準備專區所需的所有資訊。
PREPARING Google 正在準備區域。
READY_FOR_CUSTOMER_FACTORY_TURNUP_CHECKS 工廠啟動成功。
CUSTOMER_FACTORY_TURNUP_CHECKS_STARTED 可用區正在執行工廠啟動檢查。
READY_FOR_PROVISIONING 區域已可佈建。
READY_FOR_SITE_TURNUP 區域已準備好啟用網站。
PROVISIONING_STARTED 系統已開始佈建區域。
PROVISIONING_FAILED 區域佈建失敗。
OFFLINE 區域處於離線狀態。
CUSTOMER_FACTORY_TURNUP_CHECKS_FAILED 區域未通過出廠檢查。
ACTIVE 現在可以使用 Zone 了。
CANCELLED 已取消區域。
AWAITING_HARDWARE 區域正在等待硬體關聯。

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。如要將網路分成不同的區隔，可以選擇分隔該節點與網路。
ai_capable_ipv4_subnet

Subnet

選用。為在 GDC 軟體叢集上提供 Gemini 服務的區域設定 IPv4 子網路。所提供範圍的最後一個 /29 子網路會保留給 DHCP 使用。
bgp_config

BGPConfig

選用。這個可用區的邊界閘道通訊協定 (BGP) 專屬設定。用於在 GDC 軟體叢集上提供 Gemini 的區域。
top_level_domain

string

選用。這個可用區的自訂頂層網域。用於在 GDC 軟體叢集上提供 Gemini 的區域。
tor_switch_type

string

選用。客戶 ToR 轉換類型的其他資訊。用於在 GDC 軟體叢集上提供 Gemini 的區域。
boundary_proxy_public_ipv4_range

string

選用。採用 CIDR 標記法的邊界 Proxy 公用 IPv4 範圍。目前預期為 /32。用於在 GDC 軟體叢集上提供 Gemini 的區域。
boundary_proxy_private_edge_core_ipv4_range

string

選用。邊界 Proxy 私人邊緣至核心 IPv4 範圍，採用 CIDR 標記法。目前預期為 /32。用於在 GDC 軟體叢集上提供 Gemini 的區域。
boundary_proxy_private_core_edge_ipv4_range

string

選用。邊界 Proxy 私人核心到邊緣的 IPv4 範圍，採用 CIDR 標記法。目前預期為 /32。用於在 GDC 軟體叢集上提供 Gemini 的區域。
bastion_host_public_ipv4_range

string

選用。以 CIDR 標記法表示的堡壘主機公開 IPv4 範圍。目前預期為 /32。用於在 GDC 軟體叢集上提供 Gemini 的區域。
bastion_host_private_ipv4_range

string

選用。以 CIDR 標記法表示的堡壘主機私人 IPv4 範圍。目前預期為 /32。用於在 GDC 軟體叢集上提供 Gemini 的區域。
tls_public_root_certificate_pem

string

選用。PEM 格式的 TLS 公開根憑證。用於在 GDC 軟體叢集上提供 Gemini 的區域。

ZoneOperation

代表區域的作業。

欄位
name

string

ID。作業名稱。格式：「projects/{project}/locations/{location}/zones/{zone}/ops/{zone_operation}」
create_time

Timestamp

僅供輸出。這項作業的建立時間。
update_time

Timestamp

僅供輸出。上次更新這項作業的時間。
labels

map<string, string>

選用。與這項作業相關聯的標籤，以鍵/值組合形式呈現。
type

Type

這是必要旗標，不可變動。這項作業的類型。
impacted_hardware[]

string

選用。受此區域作業影響的硬體。
state

State

僅供輸出。作業的狀態。
current_step

ZoneOperationStep

僅供輸出。作業的目前步驟。
step_history[]

ZoneOperationStep

僅供輸出。作業的步驟記錄。
etag

string

選用。根據 go/ccfe-etag 新增 etag。

狀態

區域作業的有效狀態。

列舉
STATE_UNSPECIFIED 未設定州別。
RUNNING 作業正在進行中。
SUCCEEDED 作業已順利完成。
FAILED 作業失敗。
CANCELLED 作業已取消。

類型

作業類型。

列舉
TYPE_UNSPECIFIED 未設定類型。
EXPANSION 可用區擴充作業。

ZoneOperationStep

代表工作流程步驟。

欄位
state

StepState

僅供輸出。工作流程步驟的狀態。
start_time

Timestamp

僅供輸出。工作流程步驟的開始時間。
end_time

Timestamp

僅供輸出。工作流程步驟的結束時間。
error

Status

僅供輸出。工作流程步驟失敗時的錯誤訊息。
聯集欄位 step_type。步驟類型。step_type 只能是下列其中一個設定：
expansion_step

ExpansionStep

EXPANSION 作業類型的步驟。

ExpansionStep

EXPANSION 工作流程的有效步驟。

列舉
EXPANSION_STEP_UNSPECIFIED 未指定步驟。
PREPARING_ZONE 更新邏輯啟用作業的區域意圖。
HW_ID_UPDATE 使用 ID 更新硬體清單。

StepState

工作流程步驟的有效狀態。

列舉
STEP_STATE_UNSPECIFIED 未指定工作流程步驟狀態。
PENDING 步驟正在等待開始。
RUNNING 步驟執行中。
SUCCEEDED 步驟已順利完成。
FAILED 步驟失敗。
SKIPPED 已略過這個步驟。