A3 High または A3 Mega を使用して AI 最適化インスタンスを作成する

このドキュメントでは、A3 High または A3 Mega アクセラレータ最適化マシンタイプを使用するスタンドアロン仮想マシン（VM）インスタンスを作成する手順について説明します。マシンタイプの詳細については、Compute Engine ドキュメントの A3 High と A3 Mega をご覧ください。

VM またはクラスタを作成する他の方法については、概要をご覧ください。

始める前に

VM を作成する前に、次の手順を完了します（まだ完了していない場合）。

使用オプションを選択する: 選択した使用オプションによって、GPU リソースの取得方法と使用方法が決まります。
詳細については、使用オプションを選択するをご覧ください。
容量を取得する: 容量を取得するプロセスは、使用オプションごとに異なります。
選択した使用オプションの容量を取得するプロセスについては、容量の概要をご覧ください。

Select the tab for how you plan to use the samples on this page:

Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

gcloud

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

REST

このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。

Google Cloud CLI をインストールします。インストール後、次のコマンドを実行して Google Cloud CLI を初期化します。

gcloud init

外部 ID プロバイダ（IdP）を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。

詳細については、 Google Cloud 認証ドキュメントの REST を使用して認証するをご覧ください。

必要なロール

VM の作成に必要な権限を取得するには、プロジェクトに対する Compute インスタンス管理者（v1）（roles/compute.instanceAdmin.v1）IAM ロールを付与するよう管理者に依頼します。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。

この事前定義ロールには、VM の作成に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

VM を作成するには、次の権限が必要です。

プロジェクトに対する compute.instances.create
カスタムイメージを使用して VM を作成する: イメージに対する compute.images.useReadOnly
スナップショットを使用して VM を作成する: スナップショットに対する compute.snapshots.useReadOnly
インスタンステンプレートを使用して VM を作成する: インスタンステンプレートに対する compute.instanceTemplates.useReadOnly
VM のサブネットを指定する: プロジェクトまたは選択したサブネットに対する compute.subnetworks.use
VM の静的 IP アドレスを指定する: プロジェクトに対する compute.addresses.use
VPC ネットワークの使用時に VM に外部 IP アドレスを割り当てる: プロジェクトまたは選択したサブネットに対する compute.subnetworks.useExternalIp
VM にレガシーネットワークを割り当てる: プロジェクトに対する compute.networks.use
レガシーネットワークを使用する際に VM に外部 IP アドレスを割り当てる: プロジェクトに対する compute.networks.useExternalIp
VM の VM インスタンスメタデータを設定する: プロジェクトに対する compute.instances.setMetadata
VM にタグを設定する: VM に対する compute.instances.setTags
VM にラベルを設定する: VM に対する compute.instances.setLabels
VM が使用するサービスアカウントを設定する: VM に対する compute.instances.setServiceAccount
VM 用の新しいディスクを作成する: プロジェクトに対する compute.disks.create
既存のディスクを読み取り専用モードまたは読み取り / 書き込みモードでアタッチする: ディスクに対する compute.disks.use
既存のディスクを読み取り専用モードでアタッチする: ディスクに対する compute.disks.useReadOnly

これらの権限は、カスタムロールや他の事前定義ロールを使用して取得することもできます。

概要

a3h-or-a3m マシンタイプを使用してインスタンスを作成する手順は次のとおりです。

VPC ネットワークを作成する。
省略可: コンパクトプレースメントポリシーを作成する
インスタンスを作成する

VPC ネットワークを作成する

GPU VM の効率的な通信を有効にするには、管理ネットワークと 1 つ以上のデータネットワークを作成する必要があります。管理ネットワークは、外部アクセス（SSH など）と一般的なネットワーク通信のほとんどに使用されます。データネットワークは、異なる VM の GPU 間の高パフォーマンス通信（リモートダイレクトメモリアクセス（RDMA）トラフィックなど）に使用されます。

これらの VPC ネットワークでは、最大伝送単位（MTU）をより大きい値に設定することをおすすめします。MTU 値を大きくすると、パケットサイズが大きくなり、パケットヘッダーのオーバーヘッドが減少するため、ペイロードのデータスループットが向上します。 VPC ネットワークの作成方法の詳細については、ジャンボフレーム MTU ネットワークの作成と確認をご覧ください。

管理ネットワーク、サブネット、ファイアウォールルールを作成する

管理ネットワークを設定するには、次の手順で操作します。

networks create コマンドを使用して、管理ネットワークを作成します。

gcloud compute networks create NETWORK_NAME_PREFIX-mgmt-net \
    --project=PROJECT_ID \
    --subnet-mode=custom \
    --mtu=8244

networks subnets create コマンドを使用して、管理サブネットを作成します。

gcloud compute networks subnets create NETWORK_NAME_PREFIX-mgmt-sub \
    --project=PROJECT_ID \
    --network=NETWORK_NAME_PREFIX-mgmt-net \
    --region=REGION \
    --range=192.168.0.0/24

firewall-rules create コマンドを使用して、ファイアウォールルールを作成します。

管理ネットワークのファイアウォールルールを作成します。

gcloud compute firewall-rules create NETWORK_NAME_PREFIX-mgmt-internal \
    --project=PROJECT_ID \
    --network=NETWORK_NAME_PREFIX-mgmt-net \
    --action=ALLOW \
    --rules=tcp:0-65535,udp:0-65535,icmp \
    --source-ranges=192.168.0.0/16

tcp:22 ファイアウォールルールを作成して、SSH を使用して VM に接続できる送信元 IP アドレスを制限します。

gcloud compute firewall-rules create NETWORK_NAME_PREFIX-mgmt-external-ssh \
    --project=PROJECT_ID \
    --network=NETWORK_NAME_PREFIX-mgmt-net \
    --action=ALLOW \
    --rules=tcp:22 \
    --source-ranges=SSH_SOURCE_IP_RANGE

ネットワーク内のデータ転送の問題を確認するために使用できる icmp ファイアウォールルールを作成します。

gcloud compute firewall-rules create NETWORK_NAME_PREFIX-mgmt-external-ping \
    --project=PROJECT_ID \
    --network=NETWORK_NAME_PREFIX-mgmt-net \
    --action=ALLOW \
    --rules=icmp \
    --source-ranges=0.0.0.0/0

次のように置き換えます。

NETWORK_NAME_PREFIX: VPC ネットワークとサブネットに使用する名前の接頭辞。
PROJECT_ID: プロジェクト ID。
REGION: ネットワークを作成するリージョン。
SSH_SOURCE_IP_RANGE: CIDR 形式の IP 範囲。 SSH を使用して VM に接続できる送信元 IP アドレスを指定します。

データネットワーク、サブネット、ファイアウォールルールを作成する

データネットワークの数は、作成する GPU マシンのタイプによって異なります。

A3 Mega

A3 Mega には 8 つのデータネットワークが必要です。それぞれサブネットとファイアウォールルールを持つ 8 つのデータネットワークを作成するには、次のコマンドを使用します。

for N in $(seq 1 8); do
gcloud compute networks create NETWORK_NAME_PREFIX-data-net-$N \
    --project=PROJECT_ID \
    --subnet-mode=custom \
    --mtu=8244

gcloud compute networks subnets create NETWORK_NAME_PREFIX-data-sub-$N \
    --project=PROJECT_ID \
    --network=NETWORK_NAME_PREFIX-data-net-$N \
    --region=REGION \
    --range=192.168.$N.0/24

gcloud compute firewall-rules create NETWORK_NAME_PREFIX-data-internal-$N \
    --project=PROJECT_ID \
    --network=NETWORK_NAME_PREFIX-data-net-$N \
    --action=ALLOW \
    --rules=tcp:0-65535,udp:0-65535,icmp \
    --source-ranges=192.168.0.0/16
done

A3 High

A3 High には 4 つのデータネットワークが必要です。次のコマンドを使用して、それぞれサブネットとファイアウォールルールを持つ 4 つのデータネットワークを作成します。

for N in $(seq 1 4); do
gcloud compute networks create NETWORK_NAME_PREFIX-data-net-$N \
    --project=PROJECT_ID \
    --subnet-mode=custom \
    --mtu=8244

gcloud compute networks subnets create NETWORK_NAME_PREFIX-data-sub-$N \
    --project=PROJECT_ID \
    --network=NETWORK_NAME_PREFIX-data-net-$N \
    --region=REGION \
    --range=192.168.$N.0/24

gcloud compute firewall-rules create NETWORK_NAME_PREFIX-data-internal-$N \
    --project=PROJECT_ID \
    --network=NETWORK_NAME_PREFIX-data-net-$N \
    --action=ALLOW \
    --rules=tcp:0-65535,udp:0-65535,icmp \
    --source-ranges=192.168.0.0/16
done

省略可: コンパクトプレースメントポリシーを作成する

コンパクトプレースメントポリシーを作成して、VM の配置を指定できます。VM にコンパクトプレースメントポリシーを適用すると、Compute Engine は可能な限り互いに近接した VM をベストエフォートで作成しようとします。アプリケーションがレイテンシの影響を受けやすく、VM を互いに近接した位置に配置する必要がある（最大近接性）場合は、コンパクトプレースメントポリシーを作成する際に maxDistance フィールド（プレビュー）を指定します。maxDistance の値を小さくすると、VM が近接した位置に配置されますが、一部の VM が作成されない可能性も高くなります。

コンパクトプレースメントポリシーを作成するには、次のいずれかのオプションを選択します。

gcloud

コンパクトプレースメントポリシーを作成するには、gcloud beta compute resource-policies create group-placement コマンドを使用します。

gcloud beta compute resource-policies create group-placement POLICY_NAME \
    --collocation=collocated \
    --max-distance=MAX_DISTANCE \
    --region=REGION

次のように置き換えます。

POLICY_NAME: コンパクトプレースメントポリシーの名前。
MAX_DISTANCE: VM 間の最大距離構成。値は、VM を隣接するブロックに配置する場合は 3、VM を同じブロックに配置する場合は 2 にする必要があります。マシンシリーズごとの maxDistance でサポートされる VM の最大数については、Compute Engine ドキュメントのコンパクトプレースメントポリシーについてをご覧ください。
REGION: コンパクトプレースメントポリシーを作成するリージョン。使用するマシンタイプが利用可能なリージョンを指定します。リージョンの詳細については、リージョンおよびゾーン別の GPU の可用性をご覧ください。

REST

コンパクトプレースメントポリシーを作成するには、ベータ版の resourcePolicies.insert メソッドに POST リクエストを送信します。リクエストの本文に、COLLOCATED に設定された collocation フィールドと、maxDistance フィールドを配置します。

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/resourcePolicies
  {
    "name": "POLICY_NAME",
    "groupPlacementPolicy": {
      "collocation": "COLLOCATED",
      "maxDistance": MAX_DISTANCE
    }
  }

次のように置き換えます。

PROJECT_ID: プロジェクト ID
POLICY_NAME: コンパクトプレースメントポリシーの名前。
MAX_DISTANCE: VM 間の最大距離構成。値は、VM を隣接するブロックに配置する場合は 3、VM を同じブロックに配置する場合は 2 にする必要があります。マシンシリーズごとの maxDistance でサポートされる VM の最大数については、Compute Engine ドキュメントのコンパクトプレースメントポリシーについてをご覧ください。
REGION: コンパクトプレースメントポリシーを作成するリージョン。使用するマシンタイプが利用可能なリージョンを指定します。リージョンの詳細については、リージョンおよびゾーン別の GPU の可用性をご覧ください。

A3 High または A3 Mega を作成する

A3 High VM または A3 Mega VM を作成するには、次のいずれかの方法を使用します。コンパクトプレースメントポリシーを使用する場合は、Google Cloud CLI または REST を使用して VM を作成する必要があります。

次のコマンドは、インスタンスのアクセススコープも設定します。権限管理を簡素化するには、インスタンスのアクセススコープを cloud-platform アクセスに設定し、IAM ロールを使用してインスタンスがアクセスできるサービスを定義することをおすすめします。詳細については、スコープのベストプラクティスをご覧ください。

コンソール

Google Cloud コンソールで [インスタンスの作成] ページに移動します。

[インスタンスの作成] に移動
VM の名前を指定します。リソースの命名規則をご覧ください。
容量を予約するリージョンとゾーンを選択します。利用可能な GPU のリージョンとゾーンのリストをご覧ください。
[GPU] タブをクリックして、次の操作を行います。
1. [GPU のタイプ] リストで、GPU のタイプを選択します。
  - A3 High VM の場合は、NVIDIA H100 80GB を選択します。
  - A3 Mega VM の場合は、NVIDIA H100 MEGA 80GB を選択します。
2. [GPU の数] リストで、8 を選択します。
ナビゲーションメニューで [OS とストレージ] をクリックし、次の手順を完了します。
1. [変更] をクリックします。[ブートディスクの構成] ペインが開きます。
2. [公開イメージ] タブで、推奨イメージを選択します。推奨イメージの一覧については、オペレーティングシステムをご覧ください。
3. ブートディスクのオプションを確認するには、[選択] をクリックします。
サービスアカウントとアクセススコープを次のように構成します。インスタンスで実行されているワークロードは、アタッチされたサービスアカウントを使用して、他の Google Cloud サービスへのリクエストを承認します。
1. ナビゲーションメニューで [セキュリティ] をクリックします。
2. [サービスアカウント] リストで、使用するサービスアカウントを選択します。
3. [アクセススコープ] で、[すべての Cloud API に完全アクセス権を許可] オプションを選択します。このベストプラクティスをおすすめする理由は、サービスアカウントから IAM ロールを追加または削除することでアクセスを管理できるためです。詳細については、サービスアカウントをインスタンスに関連付けるをご覧ください。
マルチ NIC VM を作成する手順は次のとおりです。それ以外の場合は、単一 NIC VM を作成するため、これらの手順をスキップします。
1. ナビゲーションメニューで、[ネットワーキング] をクリックします。
2. [ネットワークインターフェース] セクションで、次の操作を行います。
  1. デフォルトのネットワークインターフェースを削除します。インターフェースを削除するには、[ 削除] をクリックします。
  2. [ネットワークインターフェースを追加] をクリックします。このオプションを使用して、前のセクションで作成した VPC ネットワークに接続するネットワークインターフェースを追加します。ネットワークインターフェースを追加する際は、次の点に注意してください。
    - ホスト間通信に使用されるネットワークインターフェースの場合は、[ネットワーク] リストと [サブネットワーク] リストから通常の VPC ネットワークとサブネットを選択し、[ネットワークインターフェースカード] リストで [gVNIC] を選択します。
    - GPUDirect-TCPXO（A3 Mega）または GPUDirect-TCPX（A3 High）を使用して GPU 間通信に使用されるネットワークインターフェースの場合は、インターフェースごとに対応する専用の VPC ネットワークとサブネットを選択し、これらのネットワークインターフェースの [ネットワークインターフェースカード] リストで [gVNIC] を選択します。
ナビゲーションメニューで、[詳細設定] をクリックします。次に、使用するプロビジョニングモデルの手順に沿って操作します。
Flex Start
1. [プロビジョニングモデル] セクションの [VM プロビジョニングモデル] リストで、[Flex Start] を選択します。
2. [時間数を入力] に、VM を実行する最大時間を入力します。値は 46 秒（0.01）から 7 日間（168、168 時間）の範囲で指定する必要があります。
3. [VM 作成の待機時間を設定する] を選択します。
  
  VM 作成リクエストが成功する可能性を高めるため、ワークロードのゾーン要件に基づいて次のいずれかの期間を指定します。
  - 厳しいゾーン要件があるワークロード: ワークロードで特定のゾーンに VM を作成する必要がある場合は、90 秒から 2 時間の間の期間を指定します。期間が長いほど、リソースを取得できる可能性が高くなります。
  - 厳密なゾーン要件のないワークロード: VM がリージョン内の任意のゾーンで実行できる場合は、期間を 0 秒に指定するか、[VM の作成の待機時間を設定する] チェックボックスをオフにします。このアクションは、リソースがすぐに使用可能な場合にのみ Compute Engine がリソースを割り当てることを指定します。リソースが使用できないため VM の作成リクエストが失敗した場合は、別のゾーンでリクエストを再試行します。
4. [VM の終了時] フィールドで、実行期間の終了時に VM を停止するか削除するかを選択します。
  - VM を削除するには、[削除] を選択します。
  - VM を停止するには、[停止] を選択します。
予約で制限
1. [予約を選択] をクリックします。この操作を行うと、選択したゾーンで使用可能な予約のリストを含むペインが開きます。予約リストで、次の操作を行います。
  1. VM に使用する予約を選択します。予約内の特定のブロックを選択することもできます。
  2. [選択] をクリックします。
スポット
1. [プロビジョニングモデル] セクションで、[VM プロビジョニングモデル] リストから [Spot] を選択します。
2. 省略可: Compute Engine が VM をプリエンプトしたときに実行される終了アクションを選択するには、次の手順を完了します。
  1. [VM プロビジョニングモデルの詳細設定] セクションを開きます。
  2. [VM の終了時] リストで、次のいずれかのオプションを選択します。
    プリエンプション中に VM を停止するには、[停止] を選択します（デフォルト）。
    
    プリエンプション中に VM を削除するには [削除] をクリックします。
VM を作成して起動するには、[作成] をクリックします。

gcloud

A3 High または A3 Mega VM を作成するには、gcloud compute instances create コマンドを使用します。

A3 Mega

VM を作成するには、gcloud compute instances create コマンドを使用します。

指定する必要があるパラメータは、このデプロイで使用している消費オプションによって異なります。消費オプションのプロビジョニングモデルに対応するタブを選択します。

Flex Start

gcloud compute instances create VM_NAME  \
    --machine-type=MACHINE_TYPE \
    --image-family=IMAGE_FAMILY \
    --image-project=IMAGE_PROJECT \
    --zone=ZONE \
    --boot-disk-type=DISK_TYPE \
    --boot-disk-size=DISK_SIZE \
    --scopes=cloud-platform \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-0,subnet=GVNIC_NAME_PREFIX-sub-0 \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-1,subnet=GVNIC_NAME_PREFIX-sub-1,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-2,subnet=GVNIC_NAME_PREFIX-sub-2,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-3,subnet=GVNIC_NAME_PREFIX-sub-3,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-4,subnet=GVNIC_NAME_PREFIX-sub-4,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-5,subnet=GVNIC_NAME_PREFIX-sub-5,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-6,subnet=GVNIC_NAME_PREFIX-sub-6,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-7,subnet=GVNIC_NAME_PREFIX-sub-7,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-8,subnet=GVNIC_NAME_PREFIX-sub-8,no-address \
    --reservation-affinity=none \
    --provisioning-model=FLEX_START \
    --request-valid-for-duration=REQUEST_VALID_FOR_DURATION \
    --max-run-duration=MAX_RUN_DURATION \
    --instance-termination-action=TERMINATION_ACTION \
    --maintenance-policy=TERMINATE

次のように置き換えます。

VM_NAME: VM の名前。
MACHINE_TYPE: VM に使用するマシンタイプ。詳細については、GPU マシンタイプをご覧ください。
IMAGE_FAMILY: 使用する OS イメージのイメージファミリー。A3 Mega マシンシリーズでは、cos-121-lts 以降の Container-Optimized OS イメージを使用して自動更新を無効にするか、rocky-linux-8-optimized-gcp-nvidia-580 Rocky Linux イメージを使用することを強くおすすめします。サポートされているオペレーティングシステムのリストについては、オペレーティングシステムの詳細をご覧ください。
IMAGE_PROJECT: OS イメージのプロジェクト ID。たとえば、cos-121-lts 以降の Container-Optimized OS イメージには cos-cloud を使用し、rocky-linux-8-optimized-gcp-nvidia-580 Rocky Linux イメージには rocky-linux-accelerator-cloud を使用します。
ZONE: 使用するマシンタイプが利用可能なゾーン。コンパクトプレースメントポリシーを指定する場合は、コンパクトプレースメントポリシーと同じリージョン内のゾーンを使用する必要があります。リージョンの詳細については、リージョンおよびゾーン別の GPU の可用性をご覧ください。
DISK_TYPE: ブートディスクのタイプ。hyperdisk-balanced の使用をおすすめします。
DISK_SIZE: ブートディスクのサイズ（GB）。
GVNIC_NAME_PREFIX: gVNIC を使用する標準の VPC ネットワークとサブネットの作成時に指定した名前の接頭辞。
REQUEST_VALID_FOR_DURATION: VM の作成リクエストの有効期間。値は、日数、時間、分、秒として指定し、その後にそれぞれ d、h、m、s を続ける必要があります。たとえば、30 分の場合は 30m と指定し、1 時間 2 分 3 秒の場合は 1h2m3s と指定します。

VM 作成リクエストが成功する可能性を高めるため、ワークロードのゾーン要件に基づいて次のいずれかの期間を指定します。
- 厳しいゾーン要件があるワークロード: ワークロードで特定のゾーンに VM を作成する必要がある場合は、90 秒（90s）から 2 時間（2h）の期間を指定します。期間が長いほど、リソースを取得できる可能性が高くなります。
- 厳密なゾーン要件のないワークロード: VM がリージョン内の任意のゾーンで実行できる場合は、期間を 0 秒（0s）に指定します。このアクションは、リソースがすぐに使用可能な場合にのみ Compute Engine がリソースを割り当てることを指定します。リソースが使用できないため VM の作成リクエストが失敗した場合は、別のゾーンでリクエストを再試行します。
MAX_RUN_DURATION: リクエストされた VM を実行する期間。値は、日数、時間、分、秒として指定し、その後にそれぞれ d、h、m、s を続ける必要があります。値は 10 分～7 日の範囲で指定してください。
TERMINATION_ACTION: 実行期間の終了時に Compute Engine によって VM を停止（STOP）するか削除（DELETE）するか。

予約で制限

コマンドを実行する前に、必要に応じてコンパクトプレースメントポリシーのフラグを追加します。

gcloud compute instances create VM_NAME  \
    --machine-type=MACHINE_TYPE \
    --image-family=IMAGE_FAMILY \
    --image-project=IMAGE_PROJECT \
    --zone=ZONE \
    --boot-disk-type=DISK_TYPE \
    --boot-disk-size=DISK_SIZE \
    --scopes=cloud-platform \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-0,subnet=GVNIC_NAME_PREFIX-sub-0 \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-1,subnet=GVNIC_NAME_PREFIX-sub-1,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-2,subnet=GVNIC_NAME_PREFIX-sub-2,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-3,subnet=GVNIC_NAME_PREFIX-sub-3,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-4,subnet=GVNIC_NAME_PREFIX-sub-4,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-5,subnet=GVNIC_NAME_PREFIX-sub-5,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-6,subnet=GVNIC_NAME_PREFIX-sub-6,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-7,subnet=GVNIC_NAME_PREFIX-sub-7,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-8,subnet=GVNIC_NAME_PREFIX-sub-8,no-address \
    --reservation-affinity=specific \
    --reservation=RESERVATION \
    --provisioning-model=RESERVATION_BOUND \
    --instance-termination-action=TERMINATION_ACTION \
    --maintenance-policy=TERMINATE \
    --restart-on-failure

次の手順を行います。

次のように置き換えます。
- VM_NAME: VM の名前。
- MACHINE_TYPE: VM に使用するマシンタイプ。詳細については、GPU マシンタイプをご覧ください。
- IMAGE_FAMILY: 使用する OS イメージのイメージファミリー。A3 Mega マシンシリーズでは、cos-121-lts 以降の Container-Optimized OS イメージを使用して自動更新を無効にするか、rocky-linux-8-optimized-gcp-nvidia-580 Rocky Linux イメージを使用することを強くおすすめします。サポートされているオペレーティングシステムのリストについては、オペレーティングシステムの詳細をご覧ください。
- IMAGE_PROJECT: OS イメージのプロジェクト ID。たとえば、cos-121-lts 以降の Container-Optimized OS イメージには cos-cloud を使用し、rocky-linux-8-optimized-gcp-nvidia-580 Rocky Linux イメージには rocky-linux-accelerator-cloud を使用します。
- ZONE: 使用するマシンタイプが利用可能なゾーン。コンパクトプレースメントポリシーを指定する場合は、コンパクトプレースメントポリシーと同じリージョン内のゾーンを使用する必要があります。リージョンの詳細については、リージョンおよびゾーン別の GPU の可用性をご覧ください。
- DISK_TYPE: ブートディスクのタイプ。hyperdisk-balanced の使用をおすすめします。
- DISK_SIZE: ブートディスクのサイズ（GB）。
- GVNIC_NAME_PREFIX: gVNIC を使用する標準の VPC ネットワークとサブネットの作成時に指定した名前の接頭辞。
- RESERVATION: 予約名または予約内の特定のブロック。予約名または使用可能なブロックを取得するには、予約容量を表示するをご覧ください。インスタンスの配置の要件に基づいて、次のいずれかを選択します。
  - 任意のブロックにインスタンスを作成するには:
```
projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME
```
    また、同じブロックに複数のインスタンスを作成するには、各インスタンスの作成時に、ブロックコロケーションを指定する同じコンパクトプレースメントポリシー（maxDistance=2）を適用します。これにより、ポリシーが予約に適用され、Compute Engine によって同じブロックにインスタンスが作成されます。
  - 特定のブロックにインスタンスを作成するには:
```
projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME/reservationBlocks/RESERVATION_BLOCK_NAME
```
  ヒント: 予約が現在のプロジェクトに存在する場合は、予約値の projects/RESERVATION_OWNER_PROJECT_ID/reservations/ を省略できます。
- TERMINATION_ACTION: 予約期間の終了時に Compute Engine によって VM を停止（STOP）するか削除（DELETE）するかの指定。
省略可: コンパクトプレースメントポリシーを使用することを選択した場合は、次のフラグをコマンドに追加します。
```
  --resource-policies=POLICY_NAME
```
次のように置き換えます。
- POLICY_NAME: コンパクトプレースメントポリシーの名前。
コマンドを実行します。

スポット

コマンドを実行する前に、必要に応じてコンパクトプレースメントポリシーのフラグを追加します。

gcloud compute instances create VM_NAME  \
    --machine-type=MACHINE_TYPE \
    --image-family=IMAGE_FAMILY \
    --image-project=IMAGE_PROJECT \
    --zone=ZONE \
    --boot-disk-type=DISK_TYPE \
    --boot-disk-size=DISK_SIZE \
    --scopes=cloud-platform \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-0,subnet=GVNIC_NAME_PREFIX-sub-0 \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-1,subnet=GVNIC_NAME_PREFIX-sub-1,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-2,subnet=GVNIC_NAME_PREFIX-sub-2,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-3,subnet=GVNIC_NAME_PREFIX-sub-3,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-4,subnet=GVNIC_NAME_PREFIX-sub-4,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-5,subnet=GVNIC_NAME_PREFIX-sub-5,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-6,subnet=GVNIC_NAME_PREFIX-sub-6,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-7,subnet=GVNIC_NAME_PREFIX-sub-7,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-8,subnet=GVNIC_NAME_PREFIX-sub-8,no-address \
    --provisioning-model=SPOT \
    --instance-termination-action=TERMINATION_ACTION \
    --maintenance-policy=TERMINATE \
    --no-restart-on-failure

次の手順を行います。

次のように置き換えます。
- VM_NAME: VM の名前。
- MACHINE_TYPE: VM に使用するマシンタイプ。詳細については、GPU マシンタイプをご覧ください。
- IMAGE_FAMILY: 使用する OS イメージのイメージファミリー。A3 Mega マシンシリーズでは、cos-121-lts 以降の Container-Optimized OS イメージを使用して自動更新を無効にするか、rocky-linux-8-optimized-gcp-nvidia-580 Rocky Linux イメージを使用することを強くおすすめします。サポートされているオペレーティングシステムのリストについては、オペレーティングシステムの詳細をご覧ください。
- IMAGE_PROJECT: OS イメージのプロジェクト ID。たとえば、cos-121-lts 以降の Container-Optimized OS イメージには cos-cloud を使用し、rocky-linux-8-optimized-gcp-nvidia-580 Rocky Linux イメージには rocky-linux-accelerator-cloud を使用します。
- ZONE: 使用するマシンタイプが利用可能なゾーン。コンパクトプレースメントポリシーを指定する場合は、コンパクトプレースメントポリシーと同じリージョン内のゾーンを使用する必要があります。リージョンの詳細については、リージョンおよびゾーン別の GPU の可用性をご覧ください。
- DISK_TYPE: ブートディスクのタイプ。hyperdisk-balanced の使用をおすすめします。
- DISK_SIZE: ブートディスクのサイズ（GB）。
- GVNIC_NAME_PREFIX: gVNIC を使用する標準の VPC ネットワークとサブネットの作成時に指定した名前の接頭辞。
- TERMINATION_ACTION: Compute Engine がインスタンスをプリエンプトするときに実行するアクション。STOP（デフォルト）または DELETE のいずれかです。
  
  重要: ご使用のアプリケーションでプリエンプションの処理が可能であることを確認してください。たとえば、インスタンスの作成時にシャットダウンスクリプトを指定してプリエンプションを処理します。シャットダウンスクリプトを使用してプリエンプションを処理する方法をご覧ください。
省略可: コンパクトプレースメントポリシーを使用することを選択した場合は、次のフラグをコマンドに追加します。
```
  --resource-policies=POLICY_NAME
```
次のように置き換えます。
- POLICY_NAME: コンパクトプレースメントポリシーの名前。
コマンドを実行します。

A3 High

VM を作成するには、gcloud compute instances create コマンドを使用します。

Flex Start

gcloud compute instances create VM_NAME  \
    --machine-type=MACHINE_TYPE \
    --image-family=IMAGE_FAMILY \
    --image-project=IMAGE_PROJECT \
    --zone=ZONE \
    --boot-disk-type=DISK_TYPE \
    --boot-disk-size=DISK_SIZE \
    --scopes=cloud-platform \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-0,subnet=GVNIC_NAME_PREFIX-sub-0 \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-1,subnet=GVNIC_NAME_PREFIX-sub-1,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-2,subnet=GVNIC_NAME_PREFIX-sub-2,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-3,subnet=GVNIC_NAME_PREFIX-sub-3,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-4,subnet=GVNIC_NAME_PREFIX-sub-4,no-address \
    --reservation-affinity=none \
    --provisioning-model=FLEX_START \
    --request-valid-for-duration=REQUEST_VALID_FOR_DURATION \
    --max-run-duration=MAX_RUN_DURATION \
    --instance-termination-action=TERMINATION_ACTION \
    --maintenance-policy=TERMINATE

次のように置き換えます。

VM_NAME: VM の名前。
MACHINE_TYPE: VM に使用するマシンタイプ。詳細については、GPU マシンタイプをご覧ください。
IMAGE_FAMILY: 使用する OS イメージのイメージファミリー。A3 High マシンシリーズでは、cos-121-lts 以降の Container-Optimized OS イメージを使用し、自動更新を無効にすることを強くおすすめします。サポートされているオペレーティングシステムのリストについては、オペレーティングシステムの詳細をご覧ください。
IMAGE_PROJECT: OS イメージのプロジェクト ID。たとえば、cos-121-lts 以降の Container-Optimized OS イメージには cos-cloud を使用します。
ZONE: 使用するマシンタイプが利用可能なゾーン。コンパクトプレースメントポリシーを指定する場合は、コンパクトプレースメントポリシーと同じリージョン内のゾーンを使用する必要があります。リージョンの詳細については、リージョンおよびゾーン別の GPU の可用性をご覧ください。
DISK_TYPE: ブートディスクのタイプ。hyperdisk-balanced の使用をおすすめします。
DISK_SIZE: ブートディスクのサイズ（GB）。
GVNIC_NAME_PREFIX: gVNIC を使用する標準の VPC ネットワークとサブネットの作成時に指定した名前の接頭辞。
REQUEST_VALID_FOR_DURATION: VM の作成リクエストの有効期間。値は、日数、時間、分、秒として指定し、その後にそれぞれ d、h、m、s を続ける必要があります。たとえば、30 分の場合は 30m と指定し、1 時間 2 分 3 秒の場合は 1h2m3s と指定します。

VM 作成リクエストが成功する可能性を高めるため、ワークロードのゾーン要件に基づいて次のいずれかの期間を指定します。
- 厳しいゾーン要件があるワークロード: ワークロードで特定のゾーンに VM を作成する必要がある場合は、90 秒（90s）から 2 時間（2h）の期間を指定します。期間が長いほど、リソースを取得できる可能性が高くなります。
- 厳密なゾーン要件のないワークロード: VM がリージョン内の任意のゾーンで実行できる場合は、期間を 0 秒（0s）に指定します。このアクションは、リソースがすぐに使用可能な場合にのみ Compute Engine がリソースを割り当てることを指定します。リソースが使用できないため VM の作成リクエストが失敗した場合は、別のゾーンでリクエストを再試行します。
MAX_RUN_DURATION: リクエストされた VM を実行する期間。値は、日数、時間、分、秒として指定し、その後にそれぞれ d、h、m、s を続ける必要があります。値は 10 分～7 日の範囲で指定してください。
TERMINATION_ACTION: 実行期間の終了時に Compute Engine によって VM を停止（STOP）するか削除（DELETE）するか。

予約で制限

コマンドを実行する前に、必要に応じてコンパクトプレースメントポリシーのフラグを追加します。

gcloud compute instances create VM_NAME  \
    --machine-type=MACHINE_TYPE \
    --image-family=IMAGE_FAMILY \
    --image-project=IMAGE_PROJECT \
    --zone=ZONE \
    --boot-disk-type=DISK_TYPE \
    --boot-disk-size=DISK_SIZE \
    --scopes=cloud-platform \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-0,subnet=GVNIC_NAME_PREFIX-sub-0 \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-1,subnet=GVNIC_NAME_PREFIX-sub-1,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-2,subnet=GVNIC_NAME_PREFIX-sub-2,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-3,subnet=GVNIC_NAME_PREFIX-sub-3,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-4,subnet=GVNIC_NAME_PREFIX-sub-4,no-address \
    --reservation-affinity=specific \
    --reservation=RESERVATION \
    --provisioning-model=RESERVATION_BOUND \
    --instance-termination-action=TERMINATION_ACTION \
    --maintenance-policy=TERMINATE \
    --restart-on-failure

次の手順を行います。

次のように置き換えます。
- VM_NAME: VM の名前。
- MACHINE_TYPE: VM に使用するマシンタイプ。詳細については、GPU マシンタイプをご覧ください。
- IMAGE_FAMILY: 使用する OS イメージのイメージファミリー。A3 High マシンシリーズでは、cos-121-lts 以降の Container-Optimized OS イメージを使用し、自動更新を無効にすることを強くおすすめします。サポートされているオペレーティングシステムのリストについては、オペレーティングシステムの詳細をご覧ください。
- IMAGE_PROJECT: OS イメージのプロジェクト ID。たとえば、cos-121-lts 以降の Container-Optimized OS イメージには cos-cloud を使用します。
- ZONE: 使用するマシンタイプが利用可能なゾーン。コンパクトプレースメントポリシーを指定する場合は、コンパクトプレースメントポリシーと同じリージョン内のゾーンを使用する必要があります。リージョンの詳細については、リージョンおよびゾーン別の GPU の可用性をご覧ください。
- DISK_TYPE: ブートディスクのタイプ。hyperdisk-balanced の使用をおすすめします。
- DISK_SIZE: ブートディスクのサイズ（GB）。
- GVNIC_NAME_PREFIX: gVNIC を使用する標準の VPC ネットワークとサブネットの作成時に指定した名前の接頭辞。
- RESERVATION: 予約名または予約内の特定のブロック。予約名または使用可能なブロックを取得するには、予約容量を表示するをご覧ください。インスタンスの配置の要件に基づいて、次のいずれかを選択します。
  - 任意のブロックにインスタンスを作成するには:
```
projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME
```
    また、同じブロックに複数のインスタンスを作成するには、各インスタンスの作成時に、ブロックコロケーションを指定する同じコンパクトプレースメントポリシー（maxDistance=2）を適用します。これにより、ポリシーが予約に適用され、Compute Engine によって同じブロックにインスタンスが作成されます。
  - 特定のブロックにインスタンスを作成するには:
```
projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME/reservationBlocks/RESERVATION_BLOCK_NAME
```
  ヒント: 予約が現在のプロジェクトに存在する場合は、予約値の projects/RESERVATION_OWNER_PROJECT_ID/reservations/ を省略できます。
- TERMINATION_ACTION: 予約期間の終了時に Compute Engine によって VM を停止（STOP）するか削除（DELETE）するかの指定。
省略可: コンパクトプレースメントポリシーを使用することを選択した場合は、次のフラグをコマンドに追加します。
```
  --resource-policies=POLICY_NAME
```
次のように置き換えます。
- POLICY_NAME: コンパクトプレースメントポリシーの名前。
コマンドを実行します。

スポット

コマンドを実行する前に、必要に応じてコンパクトプレースメントポリシーのフラグを追加します。

gcloud compute instances create VM_NAME  \
    --machine-type=MACHINE_TYPE \
    --image-family=IMAGE_FAMILY \
    --image-project=IMAGE_PROJECT \
    --zone=ZONE \
    --boot-disk-type=DISK_TYPE \
    --boot-disk-size=DISK_SIZE \
    --scopes=cloud-platform \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-0,subnet=GVNIC_NAME_PREFIX-sub-0 \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-1,subnet=GVNIC_NAME_PREFIX-sub-1,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-2,subnet=GVNIC_NAME_PREFIX-sub-2,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-3,subnet=GVNIC_NAME_PREFIX-sub-3,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-4,subnet=GVNIC_NAME_PREFIX-sub-4,no-address \
    --provisioning-model=SPOT \
    --instance-termination-action=TERMINATION_ACTION \
    --maintenance-policy=TERMINATE \
    --no-restart-on-failure

次の手順を行います。

次のように置き換えます。
- VM_NAME: VM の名前。
- MACHINE_TYPE: VM に使用するマシンタイプ。詳細については、GPU マシンタイプをご覧ください。
- IMAGE_FAMILY: 使用する OS イメージのイメージファミリー。A3 High マシンシリーズでは、cos-121-lts 以降の Container-Optimized OS イメージを使用し、自動更新を無効にすることを強くおすすめします。サポートされているオペレーティングシステムのリストについては、オペレーティングシステムの詳細をご覧ください。
- IMAGE_PROJECT: OS イメージのプロジェクト ID。たとえば、cos-121-lts 以降の Container-Optimized OS イメージには cos-cloud を使用します。
- ZONE: 使用するマシンタイプが利用可能なゾーン。コンパクトプレースメントポリシーを指定する場合は、コンパクトプレースメントポリシーと同じリージョン内のゾーンを使用する必要があります。リージョンの詳細については、リージョンおよびゾーン別の GPU の可用性をご覧ください。
- DISK_TYPE: ブートディスクのタイプ。hyperdisk-balanced の使用をおすすめします。
- DISK_SIZE: ブートディスクのサイズ（GB）。
- GVNIC_NAME_PREFIX: gVNIC を使用する標準の VPC ネットワークとサブネットの作成時に指定した名前の接頭辞。
- TERMINATION_ACTION: Compute Engine がインスタンスをプリエンプトするときに実行するアクション。STOP（デフォルト）または DELETE のいずれかです。
  
  重要: ご使用のアプリケーションでプリエンプションの処理が可能であることを確認してください。たとえば、インスタンスの作成時にシャットダウンスクリプトを指定してプリエンプションを処理します。シャットダウンスクリプトを使用してプリエンプションを処理する方法をご覧ください。
省略可: コンパクトプレースメントポリシーを使用することを選択した場合は、次のフラグをコマンドに追加します。
```
  --resource-policies=POLICY_NAME
```
次のように置き換えます。
- POLICY_NAME: コンパクトプレースメントポリシーの名前。
コマンドを実行します。

REST

A3 High VM または A3 Mega VM を作成するには、instances.insert メソッドに POST リクエストを送信します。

A3 Mega

VM を作成するには、instances.insert メソッドに POST リクエストを送信します。

Flex Start

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
  "machineType": "projects/PROJECT_ID/zones/ZONE/machineTypes/MACHINE_TYPE",
  "name": "VM_NAME",
  "disks":[
    {
      "boot":true,
      "initializeParams":{
        "diskSizeGb": "DISK_SIZE",
        "diskType": "DISK_TYPE",
        "sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
      },
      "mode": "READ_WRITE",
      "type": "PERSISTENT"
    }
  ],
  "serviceAccounts": [
    {
      "email": "default",
      "scopes": [
        "https://www.googleapis.com/auth/cloud-platform"
      ]
    }
  ],
  "networkInterfaces": [
    {
      "accessConfigs": [
        {
          "name": "external-nat",
          "type": "ONE_TO_ONE_NAT"
        }
      ],
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-0",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-0"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-1",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-1"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-2",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-2"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-3",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-3"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-4",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-4"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-5",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-5"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-6",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-6"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-7",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-7"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-8",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-8"
    }
  ],
  "reservationAffinity":{
    "consumeReservationType": "NO_RESERVATION",
  },
  "scheduling":{
    "provisioningModel": "FLEX_START",
    "requestValidForDuration": {
      "seconds": REQUEST_VALID_FOR_DURATION
    },
    "maxRunDuration": {
      "seconds": MAX_RUN_DURATION
    },
    "instanceTerminationAction": "TERMINATION_ACTION",
    "onHostMaintenance": "TERMINATE",
  }
}

次のように置き換えます。

PROJECT_ID: VM を作成するプロジェクトの ID。
ZONE: 使用するマシンタイプが利用可能なゾーン。コンパクトプレースメントポリシーを指定する場合は、コンパクトプレースメントポリシーと同じリージョン内のゾーンを使用する必要があります。リージョンの詳細については、リージョンおよびゾーン別の GPU の可用性をご覧ください。
MACHINE_TYPE: VM に使用するマシンタイプ。詳細については、GPU マシンタイプをご覧ください。
VM_NAME: VM の名前。
DISK_SIZE: ブートディスクのサイズ（GB）。
DISK_TYPE: ブートディスクのタイプ。hyperdisk-balanced の使用をおすすめします。
IMAGE_PROJECT: OS イメージのプロジェクト ID。たとえば、cos-121-lts 以降の Container-Optimized OS イメージには cos-cloud を使用し、rocky-linux-8-optimized-gcp-nvidia-580 Rocky Linux イメージには rocky-linux-accelerator-cloud を使用します。
IMAGE_FAMILY: 使用する OS イメージのイメージファミリー。A3 Mega マシンシリーズでは、cos-121-lts 以降の Container-Optimized OS イメージを使用して自動更新を無効にするか、rocky-linux-8-optimized-gcp-nvidia-580 Rocky Linux イメージを使用することを強くおすすめします。サポートされているオペレーティングシステムのリストについては、オペレーティングシステムの詳細をご覧ください。
NETWORK_PROJECT_ID: ネットワークのプロジェクト ID。
GVNIC_NAME_PREFIX: gVNIC を使用する標準の VPC ネットワークとサブネットの作成時に指定した名前の接頭辞。
REGION: サブネットワークのリージョン。
REQUEST_VALID_FOR_DURATION: VM の作成リクエストの有効期間（秒単位）。

VM 作成リクエストが成功する可能性を高めるため、ワークロードのゾーン要件に基づいて次のいずれかの期間を指定します。
- 厳しいゾーン要件があるワークロード: ワークロードで特定のゾーンに VM を作成する必要がある場合は、90 秒（90）から 2 時間（7200）の期間を指定します。期間が長いほど、リソースを取得できる可能性が高くなります。
- 厳密なゾーン要件のないワークロード: VM がリージョン内の任意のゾーンで実行できる場合は、期間を 0 秒（0）に指定します。このアクションは、リソースがすぐに使用可能な場合にのみ Compute Engine がリソースを割り当てることを指定します。リソースが使用できないため VM の作成リクエストが失敗した場合は、別のゾーンでリクエストを再試行します。
MAX_RUN_DURATION: リクエストされた VM を実行する期間。値は秒数としてフォーマットする必要があります。たとえば、86,400 秒（24 時間）の場合は 86400 を指定します。値は 10 分～7 日の範囲で指定してください。
TERMINATION_ACTION: 実行期間の終了時に Compute Engine によって VM を停止（STOP）するか削除（DELETE）するか。

予約で制限

リクエストを送信する前に、必要に応じて、コンパクトプレースメントポリシーのフィールドをリクエスト本文に追加します。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
  "machineType": "projects/PROJECT_ID/zones/ZONE/machineTypes/MACHINE_TYPE",
  "name": "VM_NAME",
  "disks":[
    {
      "boot":true,
      "initializeParams":{
        "diskSizeGb": "DISK_SIZE",
        "diskType": "DISK_TYPE",
        "sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
      },
      "mode": "READ_WRITE",
      "type": "PERSISTENT"
    }
  ],
  "serviceAccounts": [
    {
      "email": "default",
      "scopes": [
        "https://www.googleapis.com/auth/cloud-platform"
      ]
    }
  ],
  "networkInterfaces": [
    {
      "accessConfigs": [
        {
          "name": "external-nat",
          "type": "ONE_TO_ONE_NAT"
        }
      ],
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-0",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-0"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-1",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-1"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-2",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-2"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-3",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-3"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-4",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-4"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-5",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-5"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-6",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-6"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-7",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-7"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-8",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-8"
    }
  ],
  "reservationAffinity":{
    "consumeReservationType": "SPECIFIC_RESERVATION",
    "key": "compute.googleapis.com/reservation-name",
    "values":[
      "RESERVATION"
    ]
  },
  "scheduling":{
    "provisioningModel": "RESERVATION_BOUND",
    "instanceTerminationAction": "TERMINATION_ACTION",
    "onHostMaintenance": "TERMINATE",
    "automaticRestart": true
  }
}

次の手順を行います。

次のように置き換えます。
- PROJECT_ID: VM を作成するプロジェクトの ID。
- ZONE: 使用するマシンタイプが利用可能なゾーン。コンパクトプレースメントポリシーを指定する場合は、コンパクトプレースメントポリシーと同じリージョン内のゾーンを使用する必要があります。リージョンの詳細については、リージョンおよびゾーン別の GPU の可用性をご覧ください。
- MACHINE_TYPE: VM に使用するマシンタイプ。詳細については、GPU マシンタイプをご覧ください。
- VM_NAME: VM の名前。
- DISK_SIZE: ブートディスクのサイズ（GB）。
- DISK_TYPE: ブートディスクのタイプ。hyperdisk-balanced の使用をおすすめします。
- IMAGE_PROJECT: OS イメージのプロジェクト ID。たとえば、cos-121-lts 以降の Container-Optimized OS イメージには cos-cloud を使用し、rocky-linux-8-optimized-gcp-nvidia-580 Rocky Linux イメージには rocky-linux-accelerator-cloud を使用します。
- IMAGE_FAMILY: 使用する OS イメージのイメージファミリー。A3 Mega マシンシリーズでは、cos-121-lts 以降の Container-Optimized OS イメージを使用して自動更新を無効にするか、rocky-linux-8-optimized-gcp-nvidia-580 Rocky Linux イメージを使用することを強くおすすめします。サポートされているオペレーティングシステムのリストについては、オペレーティングシステムの詳細をご覧ください。
- NETWORK_PROJECT_ID: ネットワークのプロジェクト ID。
- GVNIC_NAME_PREFIX: gVNIC を使用する標準の VPC ネットワークとサブネットの作成時に指定した名前の接頭辞。
- REGION: サブネットワークのリージョン。
- RESERVATION: 予約名または予約内の特定のブロック。予約名または使用可能なブロックを取得するには、予約容量を表示するをご覧ください。インスタンスの配置の要件に基づいて、次のいずれかを選択します。
  - 任意のブロックにインスタンスを作成するには:
```
projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME
```
    また、同じブロックに複数のインスタンスを作成するには、各インスタンスの作成時に、ブロックコロケーションを指定する同じコンパクトプレースメントポリシー（maxDistance=2）を適用します。これにより、ポリシーが予約に適用され、Compute Engine によって同じブロックにインスタンスが作成されます。
  - 特定のブロックにインスタンスを作成するには:
```
projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME/reservationBlocks/RESERVATION_BLOCK_NAME
```
  ヒント: 予約が現在のプロジェクトに存在する場合は、予約値の projects/RESERVATION_OWNER_PROJECT_ID/reservations/ を省略できます。
- TERMINATION_ACTION: 予約期間の終了時に Compute Engine によって VM を停止（STOP）するか削除（DELETE）するかの指定。
省略可: コンパクトプレースメントポリシーを使用することを選択した場合は、リクエスト本文に次のフィールドを追加します。
```
  "resourcePolicies": [
    "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
  ]
```
次のように置き換えます。
- PROJECT_ID: コンパクトプレースメントポリシーのプロジェクト ID。
- REGION: コンパクトプレースメントポリシーのリージョン。
- POLICY_NAME: コンパクトプレースメントポリシーの名前。
リクエストを送信します。

スポット

リクエストを送信する前に、必要に応じて、コンパクトプレースメントポリシーのフィールドをリクエスト本文に追加します。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
  "machineType": "projects/PROJECT_ID/zones/ZONE/machineTypes/MACHINE_TYPE",
  "name": "VM_NAME",
  "disks":[
    {
      "boot":true,
      "initializeParams":{
        "diskSizeGb": "DISK_SIZE",
        "diskType": "DISK_TYPE",
        "sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
      },
      "mode": "READ_WRITE",
      "type": "PERSISTENT"
    }
  ],
  "serviceAccounts": [
    {
      "email": "default",
      "scopes": [
        "https://www.googleapis.com/auth/cloud-platform"
      ]
    }
  ],
  "networkInterfaces": [
    {
      "accessConfigs": [
        {
          "name": "external-nat",
          "type": "ONE_TO_ONE_NAT"
        }
      ],
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-0",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-0"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-1",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-1"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-2",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-2"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-3",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-3"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-4",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-4"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-5",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-5"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-6",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-6"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-7",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-7"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-8",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-8"
    }
  ],
  "scheduling":
  {
    "provisioningModel": "SPOT",
    "instanceTerminationAction": "TERMINATION_ACTION",
    "onHostMaintenance": "TERMINATE",
    "automaticRestart": false
  }
}

次の手順を行います。

次のように置き換えます。
- PROJECT_ID: VM を作成するプロジェクトの ID。
- ZONE: 使用するマシンタイプが利用可能なゾーン。コンパクトプレースメントポリシーを指定する場合は、コンパクトプレースメントポリシーと同じリージョン内のゾーンを使用する必要があります。リージョンの詳細については、リージョンおよびゾーン別の GPU の可用性をご覧ください。
- MACHINE_TYPE: VM に使用するマシンタイプ。詳細については、GPU マシンタイプをご覧ください。
- VM_NAME: VM の名前。
- DISK_SIZE: ブートディスクのサイズ（GB）。
- DISK_TYPE: ブートディスクのタイプ。hyperdisk-balanced の使用をおすすめします。
- IMAGE_PROJECT: OS イメージのプロジェクト ID。たとえば、cos-121-lts 以降の Container-Optimized OS イメージには cos-cloud を使用し、rocky-linux-8-optimized-gcp-nvidia-580 Rocky Linux イメージには rocky-linux-accelerator-cloud を使用します。
- IMAGE_FAMILY: 使用する OS イメージのイメージファミリー。A3 Mega マシンシリーズでは、cos-121-lts 以降の Container-Optimized OS イメージを使用して自動更新を無効にするか、rocky-linux-8-optimized-gcp-nvidia-580 Rocky Linux イメージを使用することを強くおすすめします。サポートされているオペレーティングシステムのリストについては、オペレーティングシステムの詳細をご覧ください。
- NETWORK_PROJECT_ID: ネットワークのプロジェクト ID。
- GVNIC_NAME_PREFIX: gVNIC を使用する標準の VPC ネットワークとサブネットの作成時に指定した名前の接頭辞。
- REGION: サブネットワークのリージョン。
- TERMINATION_ACTION: Compute Engine がインスタンスをプリエンプトするときに実行するアクション。STOP（デフォルト）または DELETE のいずれかです。
  
  重要: ご使用のアプリケーションでプリエンプションの処理が可能であることを確認してください。たとえば、インスタンスの作成時にシャットダウンスクリプトを指定してプリエンプションを処理します。シャットダウンスクリプトを使用してプリエンプションを処理する方法をご覧ください。
省略可: コンパクトプレースメントポリシーを使用することを選択した場合は、リクエスト本文に次のフィールドを追加します。
```
  "resourcePolicies": [
    "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
  ]
```
次のように置き換えます。
- PROJECT_ID: コンパクトプレースメントポリシーのプロジェクト ID。
- REGION: コンパクトプレースメントポリシーのリージョン。
- POLICY_NAME: コンパクトプレースメントポリシーの名前。
リクエストを送信します。

A3 High

VM を作成するには、instances.insert メソッドに POST リクエストを送信します。

Flex Start

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
  "machineType": "projects/PROJECT_ID/zones/ZONE/machineTypes/MACHINE_TYPE",
  "name": "VM_NAME",
  "disks":[
    {
      "boot":true,
      "initializeParams":{
        "diskSizeGb": "DISK_SIZE",
        "diskType": "DISK_TYPE",
        "sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
      },
      "mode": "READ_WRITE",
      "type": "PERSISTENT"
    }
  ],
  "serviceAccounts": [
    {
      "email": "default",
      "scopes": [
        "https://www.googleapis.com/auth/cloud-platform"
      ]
    }
  ],
  "networkInterfaces": [
    {
      "accessConfigs": [
        {
          "name": "external-nat",
          "type": "ONE_TO_ONE_NAT"
        }
      ],
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-0",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-0"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-1",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-1"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-2",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-2"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-3",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-3"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-4",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-4"
    }
  ],
  "reservationAffinity":{
    "consumeReservationType": "NO_RESERVATION",
  },
  "scheduling":{
    "provisioningModel": "FLEX_START",
    "requestValidForDuration": {
      "seconds": REQUEST_VALID_FOR_DURATION
    },
    "maxRunDuration": {
      "seconds": MAX_RUN_DURATION
    },
    "instanceTerminationAction": "TERMINATION_ACTION",
    "onHostMaintenance": "TERMINATE",
  }
}

次のように置き換えます。

PROJECT_ID: VM を作成するプロジェクトの ID。
ZONE: 使用するマシンタイプが利用可能なゾーン。コンパクトプレースメントポリシーを指定する場合は、コンパクトプレースメントポリシーと同じリージョン内のゾーンを使用する必要があります。リージョンの詳細については、リージョンおよびゾーン別の GPU の可用性をご覧ください。
MACHINE_TYPE: VM に使用するマシンタイプ。詳細については、GPU マシンタイプをご覧ください。
VM_NAME: VM の名前。
DISK_SIZE: ブートディスクのサイズ（GB）。
DISK_TYPE: ブートディスクのタイプ。hyperdisk-balanced の使用をおすすめします。
IMAGE_PROJECT: OS イメージのプロジェクト ID。たとえば、cos-121-lts 以降の Container-Optimized OS イメージには cos-cloud を使用します。
IMAGE_FAMILY: 使用する OS イメージのイメージファミリー。A3 High マシンシリーズでは、cos-121-lts 以降の Container-Optimized OS イメージを使用し、自動更新を無効にすることを強くおすすめします。サポートされているオペレーティングシステムのリストについては、オペレーティングシステムの詳細をご覧ください。
NETWORK_PROJECT_ID: ネットワークのプロジェクト ID。
GVNIC_NAME_PREFIX: gVNIC を使用する標準の VPC ネットワークとサブネットの作成時に指定した名前の接頭辞。
REGION: サブネットワークのリージョン。
REQUEST_VALID_FOR_DURATION: VM の作成リクエストの有効期間（秒単位）。

VM 作成リクエストが成功する可能性を高めるため、ワークロードのゾーン要件に基づいて次のいずれかの期間を指定します。
- 厳しいゾーン要件があるワークロード: ワークロードで特定のゾーンに VM を作成する必要がある場合は、90 秒（90）から 2 時間（7200）の期間を指定します。期間が長いほど、リソースを取得できる可能性が高くなります。
- 厳密なゾーン要件のないワークロード: VM がリージョン内の任意のゾーンで実行できる場合は、期間を 0 秒（0）に指定します。このアクションは、リソースがすぐに使用可能な場合にのみ Compute Engine がリソースを割り当てることを指定します。リソースが使用できないため VM の作成リクエストが失敗した場合は、別のゾーンでリクエストを再試行します。
MAX_RUN_DURATION: リクエストされた VM を実行する期間。値は秒数としてフォーマットする必要があります。たとえば、86,400 秒（24 時間）の場合は 86400 を指定します。値は 10 分～7 日の範囲で指定してください。
TERMINATION_ACTION: 実行期間の終了時に Compute Engine によって VM を停止（STOP）するか削除（DELETE）するか。

予約で制限

リクエストを送信する前に、必要に応じて、コンパクトプレースメントポリシーのフィールドをリクエスト本文に追加します。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
  "machineType": "projects/PROJECT_ID/zones/ZONE/machineTypes/MACHINE_TYPE",
  "name": "VM_NAME",
  "disks":[
    {
      "boot":true,
      "initializeParams":{
        "diskSizeGb": "DISK_SIZE",
        "diskType": "DISK_TYPE",
        "sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
      },
      "mode": "READ_WRITE",
      "type": "PERSISTENT"
    }
  ],
  "serviceAccounts": [
    {
      "email": "default",
      "scopes": [
        "https://www.googleapis.com/auth/cloud-platform"
      ]
    }
  ],
  "networkInterfaces": [
    {
      "accessConfigs": [
        {
          "name": "external-nat",
          "type": "ONE_TO_ONE_NAT"
        }
      ],
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-0",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-0"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-1",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-1"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-2",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-2"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-3",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-3"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-4",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-4"
    }
  ],
  "reservationAffinity":{
    "consumeReservationType": "SPECIFIC_RESERVATION",
    "key": "compute.googleapis.com/reservation-name",
    "values":[
      "RESERVATION"
    ]
  },
  "scheduling":{
    "provisioningModel": "RESERVATION_BOUND",
    "instanceTerminationAction": "TERMINATION_ACTION",
    "onHostMaintenance": "TERMINATE",
    "automaticRestart": true
  }
}

次の手順を行います。

次のように置き換えます。
- PROJECT_ID: VM を作成するプロジェクトの ID。
- ZONE: 使用するマシンタイプが利用可能なゾーン。コンパクトプレースメントポリシーを指定する場合は、コンパクトプレースメントポリシーと同じリージョン内のゾーンを使用する必要があります。リージョンの詳細については、リージョンおよびゾーン別の GPU の可用性をご覧ください。
- MACHINE_TYPE: VM に使用するマシンタイプ。詳細については、GPU マシンタイプをご覧ください。
- VM_NAME: VM の名前。
- DISK_SIZE: ブートディスクのサイズ（GB）。
- DISK_TYPE: ブートディスクのタイプ。hyperdisk-balanced の使用をおすすめします。
- IMAGE_PROJECT: OS イメージのプロジェクト ID。たとえば、cos-121-lts 以降の Container-Optimized OS イメージには cos-cloud を使用します。
- IMAGE_FAMILY: 使用する OS イメージのイメージファミリー。A3 High マシンシリーズでは、cos-121-lts 以降の Container-Optimized OS イメージを使用し、自動更新を無効にすることを強くおすすめします。サポートされているオペレーティングシステムのリストについては、オペレーティングシステムの詳細をご覧ください。
- NETWORK_PROJECT_ID: ネットワークのプロジェクト ID。
- GVNIC_NAME_PREFIX: gVNIC を使用する標準の VPC ネットワークとサブネットの作成時に指定した名前の接頭辞。
- REGION: サブネットワークのリージョン。
- RESERVATION: 予約名または予約内の特定のブロック。予約名または使用可能なブロックを取得するには、予約容量を表示するをご覧ください。インスタンスの配置の要件に基づいて、次のいずれかを選択します。
  - 任意のブロックにインスタンスを作成するには:
```
projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME
```
    また、同じブロックに複数のインスタンスを作成するには、各インスタンスの作成時に、ブロックコロケーションを指定する同じコンパクトプレースメントポリシー（maxDistance=2）を適用します。これにより、ポリシーが予約に適用され、Compute Engine によって同じブロックにインスタンスが作成されます。
  - 特定のブロックにインスタンスを作成するには:
```
projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME/reservationBlocks/RESERVATION_BLOCK_NAME
```
  ヒント: 予約が現在のプロジェクトに存在する場合は、予約値の projects/RESERVATION_OWNER_PROJECT_ID/reservations/ を省略できます。
- TERMINATION_ACTION: 予約期間の終了時に Compute Engine によって VM を停止（STOP）するか削除（DELETE）するかの指定。
省略可: コンパクトプレースメントポリシーを使用することを選択した場合は、リクエスト本文に次のフィールドを追加します。
```
  "resourcePolicies": [
    "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
  ]
```
次のように置き換えます。
- PROJECT_ID: コンパクトプレースメントポリシーのプロジェクト ID。
- REGION: コンパクトプレースメントポリシーのリージョン。
- POLICY_NAME: コンパクトプレースメントポリシーの名前。
リクエストを送信します。

スポット

リクエストを送信する前に、必要に応じて、コンパクトプレースメントポリシーのフィールドをリクエスト本文に追加します。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
  "machineType": "projects/PROJECT_ID/zones/ZONE/machineTypes/MACHINE_TYPE",
  "name": "VM_NAME",
  "disks":[
    {
      "boot":true,
      "initializeParams":{
        "diskSizeGb": "DISK_SIZE",
        "diskType": "DISK_TYPE",
        "sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
      },
      "mode": "READ_WRITE",
      "type": "PERSISTENT"
    }
  ],
  "serviceAccounts": [
    {
      "email": "default",
      "scopes": [
        "https://www.googleapis.com/auth/cloud-platform"
      ]
    }
  ],
  "networkInterfaces": [
    {
      "accessConfigs": [
        {
          "name": "external-nat",
          "type": "ONE_TO_ONE_NAT"
        }
      ],
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-0",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-0"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-1",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-1"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-2",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-2"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-3",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-3"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-4",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-4"
    }
  ],
  "scheduling":
  {
    "provisioningModel": "SPOT",
    "instanceTerminationAction": "TERMINATION_ACTION",
    "onHostMaintenance": "TERMINATE",
    "automaticRestart": false
  }
}

次の手順を行います。

次のように置き換えます。
- PROJECT_ID: VM を作成するプロジェクトの ID。
- ZONE: 使用するマシンタイプが利用可能なゾーン。コンパクトプレースメントポリシーを指定する場合は、コンパクトプレースメントポリシーと同じリージョン内のゾーンを使用する必要があります。リージョンの詳細については、リージョンおよびゾーン別の GPU の可用性をご覧ください。
- MACHINE_TYPE: VM に使用するマシンタイプ。詳細については、GPU マシンタイプをご覧ください。
- VM_NAME: VM の名前。
- DISK_SIZE: ブートディスクのサイズ（GB）。
- DISK_TYPE: ブートディスクのタイプ。hyperdisk-balanced の使用をおすすめします。
- IMAGE_PROJECT: OS イメージのプロジェクト ID。たとえば、cos-121-lts 以降の Container-Optimized OS イメージには cos-cloud を使用します。
- IMAGE_FAMILY: 使用する OS イメージのイメージファミリー。A3 High マシンシリーズでは、cos-121-lts 以降の Container-Optimized OS イメージを使用し、自動更新を無効にすることを強くおすすめします。サポートされているオペレーティングシステムのリストについては、オペレーティングシステムの詳細をご覧ください。
- NETWORK_PROJECT_ID: ネットワークのプロジェクト ID。
- GVNIC_NAME_PREFIX: gVNIC を使用する標準の VPC ネットワークとサブネットの作成時に指定した名前の接頭辞。
- REGION: サブネットワークのリージョン。
- TERMINATION_ACTION: Compute Engine がインスタンスをプリエンプトするときに実行するアクション。STOP（デフォルト）または DELETE のいずれかです。
  
  重要: ご使用のアプリケーションでプリエンプションの処理が可能であることを確認してください。たとえば、インスタンスの作成時にシャットダウンスクリプトを指定してプリエンプションを処理します。シャットダウンスクリプトを使用してプリエンプションを処理する方法をご覧ください。
省略可: コンパクトプレースメントポリシーを使用することを選択した場合は、リクエスト本文に次のフィールドを追加します。
```
  "resourcePolicies": [
    "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
  ]
```
次のように置き換えます。
- PROJECT_ID: コンパクトプレースメントポリシーのプロジェクト ID。
- REGION: コンパクトプレースメントポリシーのリージョン。
- POLICY_NAME: コンパクトプレースメントポリシーの名前。
リクエストを送信します。

A3 High または A3 Mega を使用して AI 最適化インスタンスを作成する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

始める前に

Console

gcloud

REST

必要なロール

必要な権限

概要

VPC ネットワークを作成する

管理ネットワーク、サブネット、ファイアウォール ルールを作成する

データ ネットワーク、サブネット、ファイアウォール ルールを作成する

A3 Mega

A3 High

省略可: コンパクト プレースメント ポリシーを作成する

gcloud

REST

A3 High または A3 Mega を作成する

コンソール

Flex Start

予約で制限

スポット

gcloud

A3 Mega

Flex Start

予約で制限

スポット

A3 High

Flex Start

予約で制限

スポット

REST

A3 Mega

Flex Start

予約で制限

スポット

A3 High

Flex Start

予約で制限

スポット

次のステップ

A3 High または A3 Mega を使用して AI 最適化インスタンスを作成する

管理ネットワーク、サブネット、ファイアウォールルールを作成する

データネットワーク、サブネット、ファイアウォールルールを作成する

省略可: コンパクトプレースメントポリシーを作成する