ハードウェアを注文

このページでは、Google Distributed Cloud 接続ハードウェアを注文する方法について説明します。Distributed Cloud Connected は、次の国でご利用いただけます。

• オーストラリア
• オーストリア
• ベルギー
• ブラジル
• カナダ
• チリ
• デンマーク
• フィンランド
• フランス
• ドイツ
• 香港
• 日本
• インド
• インドネシア
• イタリア
• マレーシア
• メキシコ
• オランダ
• ノルウェー
• ポーランド
• サウジアラビア
• シンガポール
• 韓国
• スペイン
• スウェーデン
• スイス
• 英国
• 米国
• ウルグアイ

ハードウェアを注文する前に、Distributed Cloud 接続のインストール要件を満たす必要があります。

Distributed Cloud コネクテッドの調達モデル

ビジネス要件に基づいて、次のいずれかの方法で Distributed Cloud コネクテッド ハードウェアを注文できます。

• Google 所有のハードウェア。Distributed Cloud コネクテッド ハードウェアは、Google から直接注文できます。このシナリオでは、Google が Distributed Cloud 接続ハードウェアの調達、メンテナンス、修理、廃止を行います。契約が終了すると、Google は Distributed Cloud ハードウェアを回収し、保存されているすべてのデータを破棄します。

• お客様が調達したハードウェア。ビジネス要件に合ったデプロイ構成について Google と協議した後、Google 認定のシステム インテグレータ（SI）に Distributed Cloud Connected を注文できます。このシナリオでは、Distributed Cloud 接続ハードウェアを所有しています。SI は、お客様と Google と連携して、ハードウェアのデプロイ、修理、廃止を行います。契約が終了すると、SI は Distributed Cloud に接続されたハードウェアからすべての Google ソフトウェアとデータを消去します。その後、ハードウェアを再利用または廃棄できます。このタイプの調達は、Distributed Cloud 接続サーバーでのみ使用できます。

Distributed Cloud コネクテッド ハードウェアのバリエーション

Distributed Cloud 接続サーバーのハードウェアは、次のフォーム ファクタで利用できます。

• Distributed Cloud 接続サーバー G1。3 台の Dell XR11 1U ラックマウント マシンのグループ。詳細については、Distributed Cloud 接続サーバー G1 ハードウェアをご覧ください。

• Distributed Cloud 接続サーバー G2。3 つの XR8610t マシンスレッドが搭載された Dell XR8000r シャーシ。詳細については、Distributed Cloud 接続サーバー G2 ハードウェアをご覧ください。

Distributed Cloud コネクテッド サーバーの SKU のリストについては、Distributed Cloud コネクテッドの料金をご覧ください。

前提条件

このセクションでは、 Google Cloud の設定要件と、ハードウェアを注文する前に収集する必要がある情報について説明します。

Google Cloud setup

始める前に、必要な権限があり、 Google Cloud プロジェクトで API が有効になっていることを確認してください。これらの手順は、 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 ハードウェア管理管理者（gdchardwaremanagement.admin）IAM ロールが付与されている必要があります。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。

• 契約上の要件: Google がフルフィルメント リクエストを処理するには、有効な署名済み契約と請求先 ID が必要です。詳細については、Cloud 請求先アカウント ID を確認するをご覧ください。

コンタクト

注文するには、次の連絡先をご提供いただく必要があります。

• 注文担当者: 組織での Distributed Cloud コネクテッド ハードウェアのデプロイの管理を担当するユーザー。販売プロセスと契約プロセスを遂行するために Google が連絡を取ることができる会社の担当者を指定してください。

• サイトの連絡先: 選択したデプロイ サイトの担当者。Google はこの担当者に連絡して、Distributed Cloud 接続ハードウェアの配送のスケジュールを設定し、完了します。また、この担当者は、ハードウェアの修理や廃止について Google または Google 認定の SI と連携します。

• ゾーンとネットワークの担当者: Distributed Cloud 接続ハードウェアをデプロイ サイトの既存のネットワークと電力インフラストラクチャに統合する担当者。また、必要に応じて共同トラブルシューティングもサポートします。

サイト情報

注文する前に、次の情報を収集します。

• 注文 ID: この Distributed Cloud コネクテッド ハードウェアの注文を識別する意味のある ID。注文 ID は注文名に基づいて自動的に生成されますが、必要に応じて変更できます。

• サイト ID: この Distributed Cloud コネクテッド ハードウェアの注文のデプロイ サイトのわかりやすい ID。

• ゾーン識別子: ターゲットの Distributed Cloud コネクテッド ゾーンのわかりやすい識別子。サイトごとに 1 つのゾーンのみをデプロイする場合は、サイト ID をゾーン ID として使用します。

• デプロイ国: ハードウェアがデプロイされる国。国によって、お支払い通貨とハードウェアの利用可否が決まります。複数のロケーションでハードウェアを注文する場合は、国ごとに個別の注文を作成してください。

• リージョン: 注文データと顧客データが保存される地理的位置。この選択により、選択したリージョン内にデータが保持されるため、コンプライアンス要件への準拠に役立ちます。

• 会社情報: ご注文の際は、会社名、メールアドレス、電話番号、請求先住所をご提供いただく必要があります。

ネットワーク構成情報

注文する際は、ネットワーク構成を選択する必要があります。次の表の情報を使用して、注文時に指定する必要があるネットワーク構成を確認してください。

ネットワークの種類	IP 構成名	説明
マシン管理ネットワーク	IPv4 マシン管理アドレス（CIDR 表記）	各サーバーに、Distributed Cloud 管理トラフィック用の IP アドレスがあります。このブロックでは、このタスクで使用されるマシン管理サブネットの IP アドレスを構成します。
	CIDR 表記の IPv4 マシン管理サブネット	Distributed Cloud 管理トラフィック用に割り当てられたサブネット。トラフィックには、Distributed Cloud インフラストラクチャのソフトウェア アップデートとインフラストラクチャのログと指標が含まれます。このサブネットは、マシン管理用の IPv4 アドレス ブロックとマシン管理サブネットのデフォルト ゲートウェイが収まる大きさにする必要があります。
	マシン管理サブネットのデフォルト ゲートウェイ	マシン管理サブネット内のゲートウェイ IP アドレス
Kubernetes ノードのトラフィック	IPv4 Kubernetes ノードアドレス（CIDR 表記）	各サーバーに、Kubernetes 関連トラフィック用の IP アドレスがあります。このブロックでは、Kubernetes 関連トラフィックに使用される Kubernetes サブネットの IP アドレスを構成します。
	Kubernetes コントロール プレーン VIP の IPv4 アドレス ブロック（CIDR 表記）	エッジゾーンで作成された Kubernetes クラスタには、このアドレス ブロックから 1 つのコントロール プレーン VIP が割り当てられます。エッジゾーンに作成するクラスタが 1 つだけの場合は、/32 アドレス ブロックを使用できます。それ以外の場合、アドレス ブロックはより大きくする必要があります。
	IPv4 Kubernetes サブネット（CIDR 表記）	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 接続ハードウェアを注文する

1. Google Cloud コンソールで、[注文] ページに移動します。

   [注文] に移動

2. ターゲットの Google Cloud プロジェクトを選択します。

3. [単一の注文を作成] をクリックします。

4. [Order details] フォームに、このドキュメントの前提条件セクションで収集した注文の詳細を入力します。[続行] をクリックします。

   注: [注文の詳細] ページで情報を入力した後、[下書きとして保存] をクリックして注文の下書きを保存できます。このオプションは、注文プロセスのすべてのステップで利用できます。

5. [Select hardware] フォームで、サーバー構成、ノード数、サブスクリプションの月数を選択します。

   • 標準クラスタの場合、[ノード数] のデフォルト値は 3 です。シングルノード オプションは、許可リストに登録されているお客様のみが利用できます。

   • 注文の不承認や履行の遅延を避けるため、ご提供いただく詳細は、署名済みの Google 契約と一致している必要があります。

   • フォームの入力が完了したら、[続行] をクリックします。

6. [サイト情報を追加] フォームで、Distributed Cloud 接続ハードウェアが配送され、設置されるサイトに関する情報を追加します。新しいサイトを追加することも、既存のサイトを選択することもできます。完了したら、[続行] をクリックします。

7. [ゾーン情報を追加] フォームで、新しいゾーンを追加するか、既存のゾーンを選択します。

   • [クラスタ プロビジョニング] で、クラスタを自分で構成する場合は、[自身のサイトでクラスタを構成する] を選択します。Google にクラスタを構成してもらう場合は、Google が事前構成されたクラスタで注文を処理できるように、クラスタのインテントを指定する必要があります。

   • ゾーン内のハードウェアを Google Cloud ネットワークに接続するには、[ネットワーク構成] セクションの情報が必要です。オプションの詳細については、このドキュメントのネットワーク構成情報のセクションをご覧ください。

     • 注文を下書きとして保存し、ゾーンとネットワークの担当者に情報を入力してもらうことができます。それ以外の場合は、必要な IP ネットワーク情報を提供します。

     • [IP アドレスに使用するテンプレートを選択します] で、要件に一致するテンプレートを選択します。テンプレートを使用すると、正しい IP の詳細情報を確実に提供できます。IP アドレスを手動で入力するには、[カスタム IP] を選択します。

   • フォームの入力が完了したら、[続行] をクリックします。

8. [設置要件] フォームに物理サイトの要件を入力し、[続行] をクリックします。

9. [Review details and submit] で、注文の詳細が正しいことを確認し、[Create] をクリックします。[作成] をクリックすると、注文は審査中になります。 Google Cloud 営業担当者が送信内容を確認し、注文を完了するためにご連絡します。担当者は次の操作を行います。

   • ビジネス要件を確認して、ハードウェア構成を最終決定します。
   • インストール要件に記載されているローカル ネットワーク、 Google Cloud プロジェクト、インストール サイト、その他の要件に関する詳細情報を収集します。
   • この情報を使用して、配送前に Distributed Cloud ハードウェアを構成します。

設置希望日は、通常、Google がご注文を承諾してから 45 日後以降の最初の設置可能な日付に自動的に設定されます。

GDC Hardware Management API を使用して Distributed Cloud コネクテッド ハードウェアを注文する

プレビュー版

この機能は、 サービス固有の規約の対象となります。 pre-GA の機能は「現状のまま」で提供されるものであり、サポートが制限されることがあります。 詳細については、リリース ステージの説明をご覧ください。

GDC Hardware Management API を使用すると、Distributed Cloud ハードウェアの注文をプログラムで実行できます。注文は、Distributed Cloud コネクテッドをデプロイする意思を示すものです。注文には、Distributed Cloud 接続デプロイのライフサイクル全体で使用される次の情報を含める必要があります。

• 注文管理と配送に関する連絡先
• 配送先の住所と配送に関連する情報
• ハードウェア構成
• ネットワークの構成

Google の営業担当者と協力して、顧客情報アンケート（CIQ）に回答し、Distributed Cloud 接続デプロイのスコープと構成を確定する必要があります。

GDC Hardware Management API を有効にする

GDC Hardware Management 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。このリソースは、1 つ以上の 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 接続 SKU をインスタンス化し、Distributed Cloud サーバーまたはラックを表します。各 Hardware リソースは、関連付けられた Order、Site、Zone リソースを参照します。使用可能な SKU を確認するには、ListSkus API 呼び出しを使用します。

• Zone。このリソースは、Distributed Cloud 接続マシンと関連付けられたクラスタのネットワーク構成を指定します。Distributed Cloud ゾーンは、1 つ以上の Distributed Cloud 接続ラック、またはお客様のロケーションにデプロイされたすべての Distributed Cloud 接続サーバー マシンをカバーします。

Order リソースを Google に送信し、そのステータスが DRAFT から SUBMITTED または INFO_COMPLETE に変更されると、ほとんどのフィールド値が読み取り専用になります。

注文のライフサイクル

Order リソースは、State に記載されている状態のいずれかになります。関係者は注文にコメントを残すことができます。コメントは、対応する Order リソースの下にネストされた Comment リソースとして保存されます。GDC ハードウェア管理 API と Google Cloud コンソールの両方で、コメントの読み取りと送信が可能です。

GDC Hardware Management 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 のほとんどのフィールド（サイトのアドレスは除く）
  • ハードウェア: 次の少なくとも 1 つに該当する場合は requested_installation_date。
    • 新しい日付が 45 日以上先である
    • 新しい requested_installation_date が現在の requested_installation_date より後で、estimated_installation_date が空の場合
    • 新しい requested_installation_date が現在の requested_installation_date より遅く、estimated_installation_date が現在から 7 日以上先である

  注文の送信後に変更できるのは、この情報のみです。その他の情報を変更する場合は、コメントを記入して Google に依頼してください。

• 送信済みの注文をキャンセルします。送信済みの注文をキャンセルするには、キャンセルをリクエストするコメントを追加します。

ターゲット Google Cloud プロジェクトを選択する

Google Cloud プロジェクトは、一連の Google Cloud リソースをカプセル化し、それらを使用できるようにし、それらのリソースのアクセス制御と課金のルールを確立する構成要素です。

国や企業部門などの管理ドメインごと、またエッジとコアなどのハイレベルのユースケースごとに個別の Google Cloud プロジェクトを作成し、その Google Cloud プロジェクトを通じてドメインの Distributed Cloud 接続デプロイを管理することをおすすめします。

Google Cloud プロジェクトでは、次の管理タスクを実行できます。

• Distributed Cloud コネクテッド ハードウェアを注文します。
• Distributed Cloud 接続クラスタを構成し、フリートに登録します。
• ソフトウェアのロールアウトを管理する。
• Cloud Storage で Distributed Cloud 接続データを管理する。
• Secret Manager で Distributed Cloud コネクテッドの認証情報を管理します。
• Cloud Monitoring で Distributed Cloud 接続ログと指標を管理します。

実際の 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 コネクテッド ゾーンを、最も近いサポートされている Google Cloud リージョンにマッピングします。これにより、管理プレーンの障害の影響を単一の地理的リージョンに限定できます。

• 複数のリージョンにまたがって Distributed Cloud コネクテッドをストライピングします。 Google Cloud これにより、管理プレーンの障害の影響を受ける Distributed Cloud 接続ゾーンの数が制限されますが、影響を受けるゾーンはより広い地理的リージョンに分散されます。

  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 コネクテッド ハードウェアの注文を作成して送信する

このセクションの手順は、GDC Hardware Management API を使用して Order リソースを作成し、Google に送信する方法を示す例です。このセクションの手順を完了するには、 Google Cloud プロジェクトに GDC ハードウェア管理管理者（roles/gdchardwaremanagement.admin）ロールが必要です。使用可能な型とメソッドの詳細については、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 コネクテッド デプロイの各マシンに一意の 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 呼び出しに対するレスポンスで FAILED_PRECONDITION ステータスとともに 400 エラーコードを受け取った場合は、完了しようとしているオペレーションに対してリクエストが有効であることを確認してください。無効なリクエストの例としては、フィールドまたは値が欠落している Order リソースを送信する、以前に送信された Order リソースに関連付けられている Hardware リソースを削除しようとするなどがあります。

エラー: 400 INVALID_ARGUMENT

API 呼び出しに対するレスポンスで INVALID_ARGUMENT ステータスとともに 400 エラーコードが返された場合は、フィールド名が正しくない、値が想定される型と一致しない、値が欠落しているなどの問題がないか確認してください。PATCH リクエストで updateMask を使用し、updateMask で指定された 1 つ以上のフィールドが無効な場合にも、このエラーが発生することがあります。

この問題を解決するには、GDC ハードウェア管理 API を参照して、すべてのフィールド名と値（形式を含む）が正しいことを確認します。JSON ペイロードを使用している場合は、必要な情報がすべてペイロードに含まれていることを確認します。

エラー: 401 UNAUTHENTICATED

API 呼び出しに対するレスポンスで UNAUTHENTICATED ステータスとともに 401 エラーコードを受け取った場合は、認証構成を確認してください。詳細については、アプリケーションのデフォルト認証情報を設定するをご覧ください。

エラー: 403 PERMISSION_DENIED

API 呼び出しに対するレスポンスで PERMISSION_DENIED ステータスとともに 403 エラーコードが返された場合は、API 呼び出しに使用されたサービス アカウントに、ターゲット オブジェクトとリソースにアクセスするための十分な権限があるかどうかを確認します。また、認証情報が正しく、期限切れになっていないことを確認します。

エラー: 404 NOT_FOUND

API 呼び出しに対するレスポンスで NOT_FOUND ステータスとともに 404 エラーコードを受け取った場合は、API 呼び出しで指定されたリソース名とパスが有効であることを確認します。GDC ハードウェア管理 API を参照して、リクエスト URL が正しく構造化され、URL に含まれるすべてのフィールドが有効であることを確認します。

注文ステータスを追跡する

注文のステータスは、 Google Cloud コンソールの [注文] ページで確認できます。次の表に、ステータスとその意味を示します。

UI ステータス	意味
下書き	注文が下書きとして保存されます。
審査中	注文が送信され、Google による審査が行われています。
承認	Google がフルフィルメントの注文を受け付けました。
ハードウェアの構築	ハードウェアは Google またはパートナーの施設で構築およびプロビジョニングされています。
ハードウェアの配送	ハードウェアは指定されたサイトの住所に配送中です。
インストール中	ハードウェアは、指定されたサイトの住所に設置されます。
処理中	注文が一部完了しています。たとえば、一部のハードウェアの配送と設置が完了しました。
完了	注文が完了しました。
情報不足	お客様からの追加情報が必要です。
ご対応のお願い	根本的な重大な問題があるため、早急な対応が必要です。
キャンセル済み	注文は拒否されました。

次のステップ

• Google Distributed Cloud コネクテッドにワークロードをデプロイする