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

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
RequestOrderDateChange

rpc RequestOrderDateChange(RequestOrderDateChangeRequest) returns (Operation)

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

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。

IAM 權限

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

  • gdchardwaremanagement.orders.update

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

這是必要旗標，這則留言的文字。文字長度不得超過 1,000 個半形字元。
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 資源的 customer_requested_installation_date。
actual_installation_date

Date

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

MachineInfo

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

Date

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

bool

僅供輸出。指出這項硬體是否適用於 Gemini on GDC 軟體。
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 位址 (如有使用)。僅適用於 VIRTUAL 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

選用。機型。在 GDC 軟體上執行 Gemini 的硬體必須符合這項條件。
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 C 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}

如要列出所有位置的硬體，請將位置替換為 - (連字號或破折號字元)，並查看回應訊息中的無法連線欄位。
page_size

int32

選用。要求的頁面大小。伺服器傳回的項目數量可能少於要求數量。如未指定，伺服器會選擇適當的預設值。
page_token

string

選用。用來識別伺服器應傳回哪一頁結果的權杖。
filter

string

選用。篩選條件。請參閱 AIP-160。
order_by

string

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

ListHardwareResponse

硬體清單。

欄位
hardware[]

Hardware

硬體清單。
next_page_token

string

用來識別伺服器應傳回哪一頁結果的權杖。
unreachable[]

string

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

ListOrdersRequest

列出訂單的要求。

欄位
parent

string

這是必要旗標，要列出訂單的專案和位置。格式：projects/{project}/locations/{location}

如要列出所有位置的訂單，請將位置替換為 - (連字號或破折號字元)，並查看回應訊息中的無法連線欄位。
page_size

int32

選用。要求的頁面大小。伺服器傳回的項目數量可能少於要求數量。如未指定，伺服器會選擇適當的預設值。
page_token

string

選用。用來識別伺服器應傳回哪一頁結果的權杖。
filter

string

選用。篩選條件。請參閱 AIP-160。
order_by

string

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

ListOrdersResponse

訂單清單。

欄位
orders[]

Order

訂單清單。
next_page_token

string

用來識別伺服器應傳回哪一頁結果的權杖。
unreachable[]

string

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

ListSitesRequest

列出網站的要求。

欄位
parent

string

這是必要旗標，要列出網站的專案和位置。格式：projects/{project}/locations/{location}

如要列出所有位置的站點，請將位置替換為 - (連字號或破折號字元)，並查看回應訊息中的無法連線欄位。
page_size

int32

選用。要求的頁面大小。伺服器傳回的項目數量可能少於要求數量。如未指定，伺服器會選擇適當的預設值。
page_token

string

選用。用來識別伺服器應傳回哪一頁結果的權杖。
filter

string

選用。篩選條件。請參閱 AIP-160。
order_by

string

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

ListSitesResponse

網站清單。

欄位
sites[]

Site

網站清單。
next_page_token

string

用來識別伺服器應傳回哪一頁結果的權杖。
unreachable[]

string

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

ListSkusRequest

列出 SKU 的要求。

欄位
parent

string

這是必要旗標，要列出 SKU 的專案和位置。格式：projects/{project}/locations/{location}

如要列出所有位置的 SKU，請將位置替換為 - (連字號或破折號字元)，並查看回應訊息中的無法連線欄位。
page_size

int32

選用。要求的頁面大小。伺服器傳回的項目數量可能少於要求數量。如未指定，伺服器會選擇適當的預設值。
page_token

string

選用。用來識別伺服器應傳回哪一頁結果的權杖。
filter

string

選用。篩選條件。請參閱 AIP-160。
order_by

string

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

ListSkusResponse

SKU 清單。

欄位
skus[]

Sku

SKU 清單。
next_page_token

string

用來識別伺服器應傳回哪一頁結果的權杖。
unreachable[]

string

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

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}

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

選用。客戶聯絡資訊。如果訂單用於 Gemini on GDC Software，則為選填，否則為必填。
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

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

Date

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

string

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

OrganizationContact

僅供輸出。指派給這筆訂單的系統整合商聯絡資訊。
ai_capable

bool

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

Date

選用。客戶可以使用這個欄位指定硬體送達日期。

DeploymentType

有效的部署作業類型。

列舉
DEPLOYMENT_TYPE_UNSPECIFIED 未指定部署類型。
FULL_PRODUCTION 含有服務等級目標的正式環境部署作業。
PROOF_OF_CONCEPT 部署作業，提供盡力支援，不含服務水準目標。
INTERNAL 內部部署，提供盡力支援，不含服務水準目標。
CUSTOMER_LAB 客戶實驗室部署作業，我們支援的方式與正式環境相同。
INTERNAL_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 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

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

原因

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

列舉
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。請注意，您必須提供更多資訊 (例如可用區網路設定、硬體實體和安裝資訊等)，這筆訂單才能出貨。如果您要提交機架 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 「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

僅供輸出。為這個邊緣可用區產生的全域專屬 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

選用。指出這個可用區是否用於 Gemini on GDC Software 叢集。
intel_pccs_key

string

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

ResourceOperation

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

ResourceOperation

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

Status

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

string

選用。指定這個可用區中硬體所在的地點名稱。格式：projects/{project}/locations/{location}/sites/{site}。Gemini on GDC Software 可用區必須提供這項資訊。

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 可以使用這個可用區。
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

選用。為 Gemini on GDC Software 叢集提供服務的可用區 IPv4 子網路。指定範圍的最後一個 /29 子網路會保留給 DHCP。
bgp_config

BGPConfig

選用。這個可用區的邊界閘道通訊協定 (BGP) 專屬設定。由在 GDC Software 叢集提供 Gemini 服務的可用區使用。
top_level_domain

string

選用。這個區域的自訂頂層網域。由在 GDC Software 叢集提供 Gemini 服務的可用區使用。
tor_switch_type

string

選用。客戶 ToR 交換器類型的其他資訊。由在 GDC Software 叢集提供 Gemini 服務的可用區使用。
boundary_proxy_public_ipv4_range

string

選用。邊界 Proxy 公開 IPv4 範圍 (CIDR 標記法)。目前應為 /32。由在 GDC Software 叢集提供 Gemini 服務的可用區使用。
boundary_proxy_private_edge_core_ipv4_range

string

選用。邊界 Proxy 私人邊緣至核心 IPv4 範圍 (採用 CIDR 標記法)。目前應為 /32。由在 GDC Software 叢集提供 Gemini 服務的可用區使用。
boundary_proxy_private_core_edge_ipv4_range

string

選用。邊界 Proxy 私人核心至邊緣 IPv4 範圍 (採用 CIDR 標記法)。目前應為 /32。由在 GDC Software 叢集提供 Gemini 服務的可用區使用。
bastion_host_public_ipv4_range

string

選用。以 CIDR 標記法表示的堡壘主機公開 IPv4 範圍。目前應為 /32。由在 GDC Software 叢集提供 Gemini 服務的可用區使用。
bastion_host_private_ipv4_range

string

選用。以 CIDR 標記法表示的堡壘主機私人 IPv4 範圍。目前應為 /32。由在 GDC Software 叢集提供 Gemini 服務的可用區使用。
tls_public_root_certificate_pem

string

選用。PEM 格式的 TLS 公開根憑證。由在 GDC Software 叢集提供 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

選用。Adding an etag based on go/ccfe-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 已略過這個步驟。