訂購硬體

本頁面說明如何訂購 Google Distributed Cloud connected 硬體。Distributed Cloud connected 適用於下列國家/地區：

• 澳洲
• 奧地利
• 比利時
• 巴西
• 加拿大
• 智利
• 丹麥
• 芬蘭
• 法國
• 德國
• 香港
• 日本
• 印度
• 印尼
• 義大利
• 馬來西亞
• 墨西哥
• 荷蘭
• 挪威
• 波蘭
• 沙烏地阿拉伯
• 新加坡
• 韓國
• 西班牙
• 瑞典
• 瑞士
• 英國
• 美國
• 烏拉圭

訂購硬體前，請務必符合 Distributed Cloud 連線安裝規定。

Distributed Cloud connected 採購模型

您可以根據業務需求，透過下列任一方式訂購 Distributed Cloud connected 硬體：

• Google 擁有的硬體。您可以直接向 Google 訂購 Distributed Cloud connected 硬體。在這種情況下，Google 會提供、維護、維修及停用 Distributed Cloud 連線硬體。合約結束後，Google 會收回 Distributed Cloud 硬體，並銷毀儲存在其中的所有資料。

• 客戶自行提供的硬體。與 Google 討論符合業務需求的部署設定後，您可以向 Google 認證的系統整合商 (SI) 訂購 Distributed Cloud 連線。在這種情況下，您擁有 Distributed Cloud connected 硬體。系統整合商會與您和 Google 合作，部署、維修及停用硬體。合約結束時，系統整合商會清除 Distributed Cloud 連線硬體中的所有 Google 軟體和您的資料。然後就能重複使用或丟棄硬體。這類採購方式僅適用於 Distributed Cloud 連線伺服器。

Distributed Cloud connected 硬體變體

Distributed Cloud connected 伺服器硬體提供下列外型規格：

• Distributed Cloud connected 伺服器 G1。一組三台 Dell XR11 1U 機架式電腦。詳情請參閱「Distributed Cloud connected 伺服器 G1 硬體」。

• Distributed Cloud connected 伺服器 G2。Dell XR8000r 機箱，其中裝有三個 XR8610t 機器滑軌。詳情請參閱「Distributed Cloud connected 伺服器 G2 硬體」。

如需 Distributed Cloud connected 伺服器 SKU 清單，請參閱 Distributed Cloud connected 定價。

必要條件

本節說明 Google Cloud 設定需求，以及訂購硬體前需要收集的資訊。

Google Cloud 設定

開始之前，請確認您具備必要權限，且 API 已在專案中啟用。 Google Cloud 無論是直接透過 Google Cloud 控制台下單，還是透過整合式 API 下單，都必須完成這些步驟。

• Google Cloud 專案：您必須擁有專案，且管理員已授權啟用 Distributed Cloud Hardware Management API。 Google Cloud 如要進一步瞭解如何建立專案，請參閱「建立專案」一文。 Google Cloud您用來管理叢集的專案，必須與訂購硬體時使用的專案相同。

• Distributed Cloud Hardware Management API：您需要啟用 Distributed Cloud Hardware Management API。前往Google Cloud 控制台的「GDC Hardware Management API」頁面。請視需要點選「啟用」來啟用 API。

  前往 GDC Hardware Management API

• IAM 角色：如要訂購硬體，您必須具備「GDC Hardware Management Admin」(gdchardwaremanagement.admin) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。

• 合約規定：Google 必須先收到有效且已簽署的合約，以及帳單 ID，才能處理履行要求。詳情請參閱「找出 Cloud Billing 帳戶 ID」。

聯絡人

如要下單，請提供下列聯絡人資訊：

• 訂購聯絡人：負責管理貴機構 Distributed Cloud connected 硬體部署作業的人員。提供公司代表，以便我們聯絡並完成銷售與簽約程序。

• 網站聯絡人：負責所選部署網站的人員。 Google 會與這位聯絡人聯絡，安排並完成 Distributed Cloud 連結網路硬體的運送作業。此外，這個人也會與 Google 或 Google 認證的系統整合商協調硬體維修和停用事宜。

• 區域和網路聯絡人：負責將 Distributed Cloud connected 硬體整合至部署地點現有網路和電源基礎架構的人員。如有需要，這名人員也會協助共同排解問題。

網站資訊

下單前，請先收集下列資訊：

• 訂單 ID：這個 Distributed Cloud connected 硬體訂單的 ID，系統會根據訂單名稱自動產生訂單 ID，但您可以視需要修改訂單 ID。

• 網站 ID：這個 Distributed Cloud connected 硬體訂單的部署網站有意義的 ID。

• 可用區 ID：目標 Distributed Cloud connected 可用區的 ID。如果每個網站只部署一個區域，請使用網站 ID 做為區域 ID。

• 部署國家/地區：要部署硬體的國家/地區。國家/地區會影響帳單幣別和硬體供應情形。如要在多個位置訂購硬體，請分別為各國家/地區建立訂單。

• 區域：儲存訂單和顧客資料的地理位置。選取即可確保資料保留在所選區域，以利遵守法規。

• 公司資訊：下單時，您必須提供公司名稱、電子郵件地址、電話號碼和帳單地址。

網路設定資訊

下單時，您需要選取網路設定。請參閱下表資訊，瞭解下單時需要提供的網路設定。

網路類型	IP 設定名稱	說明
機器管理網路	以 CIDR 標記法表示的 IPv4 機器管理位址	每個伺服器都有一個 Distributed Cloud 管理流量專用的 IP 位址。這個區塊會設定用於這項工作的機器管理子網路 IP 位址。
	以 CIDR 標記法表示的 IPv4 機器管理子網路	分配給 Distributed Cloud 管理流量的子網路。流量包括 Distributed Cloud 基礎架構軟體更新，以及基礎架構記錄和指標。這個子網路必須夠大，足以涵蓋機器管理的 IPv4 位址區塊，以及機器管理子網路的預設閘道。
	機器管理子網路的預設閘道	機器管理子網路內的閘道 IP 位址
Kubernetes 節點流量	以 CIDR 標記法表示的 IPv4 Kubernetes 節點位址	每個伺服器都有一個 Kubernetes 相關流量專用的 IP 位址。這個區塊會設定 Kubernetes 子網路的 IP 位址，用於 Kubernetes 相關流量。
	Kubernetes 控制層 VIP 的 IPv4 位址區塊 (CIDR 標記法)	在邊緣可用區建立的每個 Kubernetes 叢集都會有一個控制層 VIP (從這個位址區塊指派)。如果您只會在邊緣可用區建立一個叢集，可以使用 /32 位址區塊。否則，位址區塊必須更大。
	採用 CIDR 標記法的 IPv4 Kubernetes 子網路	為 Kubernetes 流量分配的子網路。流量包括容器下載、Kubernetes 主要網路、Kubernetes 記錄和指標，以及 Kubernetes 控制層流量。如果留空，這個子網路預設會是 IPv4 機器管理子網路。您也可以在這個欄位中指定個別子網路。這個子網路必須夠大，足以涵蓋 Kubernetes 節點流量的 IPv4 位址區塊、Kubernetes 控制層 VIP 的 IPv4 位址區塊、Kubernetes 子網路的預設閘道，以及預定的主要網路負載平衡器 VIP。如未指定，這個值會與管理網路值相同。
	Kubernetes 子網路的預設閘道	Kubernetes 子網路內的閘道 IP 位址。如果留空，這個欄位預設會是「機器管理子網路的預設閘道」。
	Kubernetes 主要 VLAN ID	根據預設，Kubernetes 節點 (包括主要 Kubernetes 網路) 會與機器管理網路位於相同的 VLAN。如要將網路分成不同的區隔，可以選擇分隔這些網路。
DNS 名稱伺服器	DNS 名稱伺服器 1	DNS 名稱伺服器 IP。Distributed Cloud 基礎架構會透過這些 IP 解析 DNS 查詢。如未指定，則會使用 Google DNS。
	DNS 名稱伺服器 2	DNS 名稱伺服器 IP。Distributed Cloud 基礎架構會透過這些 IP 解析 DNS 查詢。如未指定，則會使用 Google DNS。

使用 Google Cloud 控制台訂購 Distributed Cloud connected 硬體

1. 前往 Google Cloud 控制台的「Orders」(訂單) 頁面。

   前往「訂單」頁面

2. 選取目標 Google Cloud 專案。

3. 按一下「建立單一訂單」。

4. 在「訂單詳細資料」表單中，輸入您在本文件「必要條件」一節中收集的訂單詳細資料。按一下「繼續」。

   注意： 在「訂單詳細資料」頁面輸入資訊後，按一下「儲存為草稿」即可儲存訂單草稿。這個選項適用於訂單程序的每個步驟。

5. 在「選取硬體」表單中，選取伺服器設定、節點數量和訂閱月數。

   • 如果是標準叢集，「節點數量」的預設值為 3。單一節點選項僅適用於許可清單上的客戶。

   • 為避免訂單遭拒或延遲出貨，你提供的詳細資料必須與簽署的 Google 合約一致。

   • 填妥表單後，按一下「繼續」。

6. 在「新增網站資訊」表單中，新增 Distributed Cloud connected 硬體的運送和安裝地點資訊。您可以新增網站或選擇現有網站。完成後，按一下「繼續」。

7. 在「新增區域資訊」表單中，新增區域或選取現有區域。

   • 在「叢集佈建」部分，如果您打算自行設定叢集，請選取「我會在自己的網站設定叢集」。如要讓 Google 為您設定叢集，您必須提供叢集意圖，Google 才能在交付訂購項目時，供應預先設定好的叢集。

   • 如要將區域中的硬體連線至 Google Cloud 網路，請務必填寫「網路設定」部分。如要進一步瞭解選項，請參閱本文的「網路設定資訊」一節。

     • 你可以將訂單儲存為草稿，並讓區域和電視網代表輸入資訊。否則請提供必要的 IP 網路資訊。

     • 在「為 IP 位址選取偏好的範本」部分，選取符合需求的範本。這些範本有助於確保提供正確的 IP 詳細資料。如要手動輸入 IP 位址，請選取「自訂 IP」。

   • 填妥表單後，按一下「繼續」。

8. 在「安裝需求」表單中，輸入實體地點需求，然後按一下「繼續」。

9. 在「查看詳細資料並提交」中，確認訂單詳細資料正確無誤，然後按一下「建立」。點選「建立」後，訂單會進入審查程序。業務代表會審查您的申請，並與您聯絡以完成訂單。 Google Cloud 代表會執行下列作業：

   • 請根據業務需求，完成硬體設定。
   • 收集有關當地網路、 Google Cloud 專案、安裝地點，以及安裝需求中列出的其他需求資訊。
   • 在交付 Distributed Cloud 硬體前，使用這項資訊進行設定。

您要求的安裝日期會自動設為第一個可行的日期，通常是 Google 接受訂單後的 45 天。

使用 GDC Hardware Management API 訂購 Distributed Cloud connected 硬體

預先發布版

這項功能 適用《服務專屬條款》。 正式發布前的功能是按照「原樣」提供，支援範圍可能有限。 詳情請參閱推出階段說明。

您可以使用 GDC 硬體管理 API，以程式輔助方式訂購 Distributed Cloud 硬體。訂單代表您有意部署 Distributed Cloud connected。訂單必須包含下列資訊，這些資訊會在 Distributed Cloud 連線部署的整個生命週期中使用：

• 訂單管理和運送聯絡窗口
• 送貨地點地址和任何與送貨相關的資訊
• 硬體設定
• 網路設定

您必須與 Google 業務代表合作，填寫客戶資訊問卷 (CIQ)，並完成 Distributed Cloud 連結部署的範圍和設定。

啟用 GDC Hardware Management API

如要使用 GDC Hardware Management API，必須先在目標專案中啟用這項 API。Google Cloud 如要這樣做，請完成本節中的步驟。

控制台

1. 前往 Google Cloud 控制台的「GDC Hardware Management API」頁面。

   啟用 API

2. 按一下「啟用」。

gcloud

使用下列指令：

gcloud services enable gdchardwaremanagement.googleapis.com

訂單結構

如要使用 GDC Hardware Management API 下單，您必須建立 Order 資源，以及 Order 資源參照的隨附 Site、Zone 和 Hardware 資源。然後將 Order 資源提交給 Google。這些資源支援標準 CRUD 作業。每個資源的名稱都是路徑，包含目標 Google Cloud 專案 ID 和 Google Cloud 區域。

這些資源具有下列功能。如要進一步瞭解如何使用 GDC Hardware Management API，請參閱 Google Distributed Cloud CLI 和 API 參考資料。

• Order。這項資源會要求建立一或多個 Distributed Cloud 區域。建立這項資源時，系統會指派一個名稱，可透過 create_order_response.name 欄位存取。Order 資源名稱的格式如下：

  `projects/`PROJECT_ID`/locations/`REGION`/orders/`ORDER_ID

  其中：

  • PROJECT_ID：目標 Google Cloud 專案的 ID。
  • REGION：要部署 Distributed Cloud 區域的 Google Cloud 區域。
  • ORDER_ID：用於識別這筆訂單的專屬 ID。如果省略，系統會自動產生值。建議您提供由小寫英文字母、數字和破折號組成的專屬訂單 ID 值。否則，建立訂單的呼叫失敗可能會產生重複訂單。

• Site。這項資源代表您要部署 Distributed Cloud 硬體的實際位置。這項資源包括負責協調初始交付和後續維護作業的聯絡人資訊。這個聯絡人可能與訂單上提供的聯絡人不同。

• Hardware。這項資源會例項化 Distributed Cloud connected SKU，並代表 Distributed Cloud 伺服器或機架。每個 Hardware 資源都會參照相關聯的 Order、Site 和 Zone 資源。如要查看可用的 SKU，請使用 ListSkus API 呼叫。

• Zone。這項資源會指定 Distributed Cloud 連線機器和相關聯叢集的網路設定。Distributed Cloud 可用區涵蓋一或多個 Distributed Cloud connected 機架，或部署在您所在位置的所有 Distributed Cloud connected 伺服器。

將 Order 資源提交給 Google 後，如果狀態從 DRAFT 變更為 SUBMITTED 或 INFO_COMPLETE，大部分的欄位值都會變成唯讀。

訂單生命週期

Order 資源可處於 State 中列出的其中一種狀態。相關人員可以在訂單中留下留言，這些留言會以 Comment 資源的形式，巢狀儲存在對應的 Order 資源下。您可以透過 GDC 硬體管理 API 和 Google Cloud 控制台讀取及提交註解。

GDC 硬體管理 API 支援下列訂單生命週期作業：

• 建立並提交訂單。你可以立即建立並提交訂單，也可以逐步建立訂單，並將訂單儲存為 DRAFT 狀態，等到準備好再提交。本指南的其餘部分會說明這項程序。

• 查看訂單狀態。如果訂單是透過 類型 INFO_COMPLETE提交，且您已與 Google 簽訂合約，訂單會依序進入下列狀態：ACCEPTED, BUILDING, SHIPPING、INSTALLING 和 COMPLETED.。相關聯的 Zone 和 Hardware 資源狀態會與 Order 資源同步更新。

• 解決訂單問題。如果我們需要您提供更多資訊，或您尚未與 Google 簽訂合約，訂單會進入 ADDITIONAL_INFO_NEEDED 狀態，等待透過留言解決問題。 請查看留言中的進一步指示，如果對後續步驟有任何疑問，請與 Google 聯絡。

• 刪除未提交的訂單。您可以透過 DELETE 呼叫刪除未提交的訂單。

• 修改已提交的訂單。您可以使用各自的 PATCH 呼叫，修改已提交的訂單、網站和區域。提交後可編輯的欄位如下：

  • 所有資源：display_name、labels
  • 訂單：organization_contact
  • 網站：access_times，organization_contact 的大部分欄位，但不包括網站地址
  • 硬體：requested_installation_date 如果至少符合下列其中一項條件：
    • 新日期與目前日期相隔超過 45 天
    • 新 requested_installation_date 晚於目前的 requested_installation_date and estimated_installation_date 為空
    • 新 requested_installation_date晚於目前 requested_installation_date，且 estimated_installation_date 至少是 7 天後

  訂單提交後，其他資訊就無法修改，但你可以透過留言要求 Google 協助修改。

• 取消已提交的訂單。如要取消已提交的訂單，請在訂單中新增留言，要求取消訂單。

選取目標 Google Cloud 專案

Google Cloud 專案是封裝一組 Google Cloud 資源的建構體，可供您使用這些資源，並為這些資源建立存取權控管和帳單規則。

建議您為每個管理網域 (例如國家/地區或公司部門) 和高階用途 (例如邊緣與核心) 建立個別專案，並透過該專案管理網域的 Distributed Cloud 連線部署作業。 Google Cloud Google Cloud

Google Cloud 專案可讓您執行下列管理工作：

• 訂購 Distributed Cloud connected 硬體。
• 設定 Distributed Cloud 連結叢集，並在機群中註冊。
• 管理軟體推出作業。
• 在 Cloud Storage 中管理 Distributed Cloud 連線資料。
• 在 Secret Manager 中管理 Distributed Cloud 連線憑證。
• 在 Cloud Monitoring 中管理 Distributed Cloud connected 記錄和指標。

確切的 Google Cloud 專案拓撲取決於您的業務需求。建議您避免跨專案依附元件，並一律在每個 Google Cloud 專案中建立及使用資源。

在特定 Google Cloud 專案中訂購的硬體，一律會在該 Google Cloud 專案中管理。

選取目標 Google Cloud 區域

Distributed Cloud 連線部署的 Google Cloud 區域具體選擇，取決於您的業務需求和目標地理位置的法律影響。

如果您要將 Distributed Cloud 連線部署作業整合至現有的多區域Google Cloud 足跡，建議您將每個 Distributed Cloud 連線區域對應至託管該區域依附元件的 Google Cloud 區域。

如果您未將 Distributed Cloud 連線部署作業與現有 Google Cloud足跡整合，建議您多元化選擇 Google Cloud 區域，以提高可靠性。例如：

• 將每個 Distributed Cloud connected 可用區對應至最接近的支援 Google Cloud 區域。這樣一來，管理層故障的影響範圍就會限制在單一地理區域。

• 在多個 Google Cloud 區域中，將 Distributed Cloud 連結至 Stripe。這會限制受管理平面故障影響的 Distributed Cloud connected 區域數量，但受影響的區域會分布在較大的地理區域。

  Distributed Cloud connected 支援下列 Google Cloud 區域：

• 亞洲：asia-east1、asia-east2、asia-northeast1、asia-northeast3、asia-south1、asia-south2、asia-southeast1、asia-southeast2

• 歐洲：europe-central2、europe-north1、europe-west1、europe-west2、europe-west3、europe-west4、europe-west6、europe-west8、europe-west9

• 中東：me-central1、me-west1

• 大洋洲：australia-southeast1

• 北美：northamerica-northeast1、northamerica-northeast2、us-central1、us-central2、us-east1、us-east4、us-east5、us-east7、us-south1、us-west1、us-west2、us-west3、us-west4、us-west8

• 南美洲：southamerica-east1、southamerica-west1

設定環境

開始之前，請先完成下列必要條件：

1. 設定 Python 開發環境。

2. 使用下列指令安裝 GDC Hardware Management API 用戶端程式庫：

   python3 -m pip install google-cloud-gdchardwaremanagement
   

3. 在目標 Google Cloud 專案中啟用 GDC Hardware Management API。

使用 GDC Hardware Management API 建立及提交 Distributed Cloud connected 硬體訂單

本節的步驟是範例，說明如何使用 GDC Hardware Management API，向 Google 建立及提交 Order 資源。如要完成本節中的步驟，您必須在專案中具備「GDC 硬體管理管理員」(roles/gdchardwaremanagement.admin) 角色。 Google Cloud 如要瞭解可用型別和方法的詳細資料，請參閱 Python 用戶端程式庫參考資料。

1. 建立 Order 資源。例如：

   import datetime
   from google.cloud import gdchardwaremanagement_v1alpha
   from google.protobuf.timestamp_pb2 import Timestamp
   from google.type import postal_address_pb2
   
   client = gdchardwaremanagement_v1alpha.GDCHardwareManagementClient()
   
   contact = gdchardwaremanagement_v1alpha.Contact(
       given_name="John",
       family_name="Customer",
       email="[e-mail]",
       phone="[phone]",
   )
   
   organization_contact = gdchardwaremanagement_v1alpha.OrganizationContact(
       address=postal_address_pb2.PostalAddress(
           organization="Example Organization",
           address_lines=["1800 Amphibious Blvd."],
           locality="Mountain View",
           administrative_area="CA",
           postal_code="94045",
           region_code="US",
       ),
       contacts=[contact],
   )
   
   order = gdchardwaremanagement_v1alpha.Order(
       organization_contact=organization_contact,
       customer_motivation="I like Google Distributed Cloud!",
       fulfillment_time=Timestamp(
           seconds=int(datetime.datetime(2024, 11, 22, 9, 0).timestamp()),
       ),
       region_code="US",
   )
   
   create_order_response = client.create_order(
       request=gdchardwaremanagement_v1alpha.CreateOrderRequest(
           parent="projects/myProject/locations/us-east1",
           order_id="myOrderID",
           order=order,
       ),
   ).result()

   訂單現在處於 DRAFT 狀態，且已指派儲存在 create_order_response.name 欄位中的資源名稱。修改或追蹤這項訂單的狀態時，請使用這個資源名稱。

2. 建立 Site 資源。例如：

   site = gdchardwaremanagement_v1alpha.Site(
       organization_contact=organization_contact,
       google_maps_pin_uri="https://maps.app.goo.gl/z7bE8z8fffg6Sri46",
   )
   
   create_site_response = client.create_site(
       request=gdchardwaremanagement_v1alpha.CreateSiteRequest(
           parent="projects/myProject/locations/us-east1",
           site_id="mySite",
           site=site,
       ),
   ).result()

3. 建立 Zone 資源。例如：

   zone = gdchardwaremanagement_v1alpha.Zone(
       contacts=[contact],
       network_config=gdchardwaremanagement_v1alpha.ZoneNetworkConfig(
           management_ipv4_subnet=gdchardwaremanagement_v1alpha.Subnet(
               address_range="192.0.2.0/24",
               default_gateway_ip_address="192.0.2.1",
           ),
           machine_mgmt_ipv4_range="192.0.2.8/29",
           kubernetes_ipv4_subnet=gdchardwaremanagement_v1alpha.Subnet(
               address_range="203.0.113.0/24",
               default_gateway_ip_address="203.0.113.1",
           ),
           kubernetes_node_ipv4_range="203.0.113.8/29",
           kubernetes_control_plane_ipv4_range="203.0.113.16/29",
       ),
   )
   
   create_zone_response = client.create_zone(
       request=gdchardwaremanagement_v1alpha.CreateZoneRequest(
           parent="projects/myProject/locations/us-east1",
           zone_id="myZone",
           zone=zone,
       ),
   ).result()

4. 建立 Hardware 資源。您必須為 Distributed Cloud connected 部署中的每部機器指定不重複的 hardware_id 值。例如：

   from google.type import date_pb2
   
   hardware = gdchardwaremanagement_v1alpha.Hardware(
       order=create_order_response.name,
       site=create_site_response.name,
       zone=create_zone_response.name,
       config=gdchardwaremanagement_v1alpha.HardwareConfig(
           sku="projects/myProject/locations/us-east1/skus/gdce-server-l",
           power_supply=gdchardwaremanagement_v1alpha.types.PowerSupply.POWER_SUPPLY_AC,
       ),
       physical_info=gdchardwaremanagement_v1alpha.HardwarePhysicalInfo(
           power_receptacle=gdchardwaremanagement_v1alpha.types.HardwarePhysicalInfo.PowerReceptacleType.NEMA_5_15,
           network_uplink=gdchardwaremanagement_v1alpha.types.HardwarePhysicalInfo.NetworkUplinkType.RJ_45,
           voltage=gdchardwaremanagement_v1alpha.types.HardwarePhysicalInfo.Voltage.VOLTAGE_110,
           amperes=gdchardwaremanagement_v1alpha.types.HardwarePhysicalInfo.Amperes.AMPERES_15,
       ),
       installation_info=gdchardwaremanagement_v1alpha.HardwareInstallationInfo(
           rack_location="Floor 2, Room 201, Row 7, Rack 3",
           power_distance_meters=2,
           switch_distance_meters=2,
           rack_unit_dimensions=gdchardwaremanagement_v1alpha.Dimensions(
               width_inches=19,
               height_inches=1.75,
               depth_inches=30,
           ),
           rack_space=gdchardwaremanagement_v1alpha.RackSpace(
               start_rack_unit=12,
               end_rack_unit=12,
           ),
           rack_type=gdchardwaremanagement_v1alpha.types.HardwareInstallationInfo.RackType.FOUR_POST,
       ),
       requested_installation_date=date_pb2.Date(year=2024, month=11, day=22),
   )
   
   create_hardware_response = client.create_hardware(
       request=gdchardwaremanagement_v1alpha.CreateHardwareRequest(
           parent="projects/myProject/locations/us-east1",
           hardware_id="machineHardwareID",
           hardware=hardware,
       ),
   ).result()

5. 將 Order 資源提交給 Google：

   submit_order_response = client.submit_order(
       request=gdchardwaremanagement_v1alpha.SubmitOrderRequest(
           name=create_order_response.name,
           type_=gdchardwaremanagement_v1alpha.types.SubmitOrderRequest.Type.INFO_COMPLETE,
       ),
   ).result()

   INFO_COMPLETE 的提交類型表示您已在 Zone 和 Hardware 資源中提供所有必要資訊。如有任何欄位值遺漏，提交作業就會失敗，並顯示描述問題的錯誤訊息。如要與 Google 展開對話，但不想完整填寫訂單，請提交狀態為 INFO_PENDING 的訂單，略過這些驗證。

測試

如要提交測試訂單，請與 Google 聯絡，取得沙箱環境的存取權。 專案或機構獲得存取權後，您可以使用以 fake- 前置字元識別的測試 SKU。測試訂單會經歷上述階段，但不會觸發貨幣費用或硬體出貨。

疑難排解

本節說明最常見的錯誤、原因和可用的解決方法。

發生錯誤：400 FAILED_PRECONDITION

如果 API 呼叫的回應包含 400 錯誤碼和 FAILED_PRECONDITION 狀態，請確認要求適用於您嘗試完成的操作。無效要求的例子包括：提交缺少欄位或值的 Order 資源，或是嘗試刪除與先前提交的 Order 資源相關聯的 Hardware 資源。

發生錯誤：400 INVALID_ARGUMENT

如果 API 呼叫的回應中包含 400 錯誤碼和 INVALID_ARGUMENT 狀態，請檢查欄位名稱和值是否不正確，或與預期類型不符，以及是否有遺漏值。如果您在 PATCH 要求中使用 updateMask，且 updateMask 中指定的一或多個欄位無效，也可能會收到這項錯誤。

如要解決這個問題，請參閱 GDC Hardware Management API，確認所有欄位名稱和值 (包括格式) 皆正確無誤。如果使用 JSON 酬載，請確認酬載中包含所有必要資訊。

發生錯誤：401 UNAUTHENTICATED

如果 API 呼叫的回應包含 UNAUTHENTICATED 狀態和 401 錯誤代碼，請檢查驗證設定。詳情請參閱「設定應用程式預設憑證」。

發生錯誤：403 PERMISSION_DENIED

如果 API 呼叫的回應中包含 403 錯誤代碼和 PERMISSION_DENIED 狀態，請檢查用於發出 API 呼叫的服務帳戶是否具備足夠的權限，可存取目標物件和資源。此外，也請確認憑證正確無誤且未過期。

發生錯誤：404 NOT_FOUND

如果 API 呼叫的回應包含 404 錯誤代碼和 NOT_FOUND 狀態，請檢查 API 呼叫中指定的資源名稱和路徑是否有效。請參閱「GDC Hardware Management API」，確認要求網址結構正確，且網址中包含的所有欄位都有效。

追蹤訂單狀態

你可以在 Google Cloud 控制台的「訂單」頁面中追蹤訂單狀態。下表列出可能狀態及其意義。

UI 狀態	意義
草稿	訂單會儲存為草稿。
審核中	訂單已提交，Google 正在審查。
已接受	Google 已接受訂單，準備出貨。
建構硬體	硬體是在 Google 或合作夥伴的設施中建構及佈建。
運送硬體	硬體正在運送至提供的地點地址。
安裝中	硬體將安裝在您提供的地點地址。
處理中	訂單已部分完成。例如，已送達並安裝部分硬體。
已完成	訂單已完成。
缺少資訊	我們需要您提供其他資訊。
敬請採取行動	由於發生重大基礎問題，因此需要立即處理。
已取消	訂單遭到拒絕。

後續步驟

• 在 Google Distributed Cloud connected 上部署工作負載