単一プロジェクトの予約を作成する

このドキュメントでは、単一プロジェクトの予約を作成する方法について説明します。予約は、同じプロジェクト内の仮想マシン（VM）インスタンスでのみ使用できます。予約の詳細については、Compute Engine ゾーンリソースの予約をご覧ください。

予約を作成するその他の方法については、次のページをご覧ください。

現在のプロジェクトに 1 年間または 3 年間のコミットメントがある場合、予約したリソースには該当する確約利用割引が自動的に適用されます。コミットメントの購入時に、予約を作成してコミットメントに関連付けることもできます。詳細については、予約をコミットメントに関連付けるをご覧ください。
複数のプロジェクトで使用できる予約を作成するには、共有予約を作成するをご覧ください。

始める前に

予約に関する要件と制限事項を確認します。
まだ設定していない場合は、認証を設定します。認証とは、Google Cloud サービスと API にアクセスするために ID を確認するプロセスです。ローカル開発環境からコードまたはサンプルを実行するには、次のように Compute Engine に対する認証を行います。

このページのサンプルをどのように使うかに応じて、タブを選択してください。
コンソール

Google Cloud コンソールを使用して Google Cloud サービスと API にアクセスする場合、認証を設定する必要はありません。
gcloud
1. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. デフォルトのリージョンとゾーンを設定します。
Terraform

このページの Terraform サンプルをローカル開発環境から使用するには、gcloud CLI をインストールして初期化し、自身のユーザー認証情報を使用してアプリケーションのデフォルト認証情報を設定してください。
1. Install the Google Cloud CLI.
2. To initialize the gcloud CLI, run the following command:
  gcloud init
3. If you're using a local shell, then create local authentication credentials for your user account:
  gcloud auth application-default login
  You don't need to do this if you're using Cloud Shell.
詳細については、ローカル開発環境の認証の設定をご覧ください。
REST

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

必要なロール

単一プロジェクトの予約の作成に必要な権限を取得するために、プロジェクトに対する Compute 管理者（roles/compute.admin）の IAM ロールの付与を管理者に依頼してください。ロールの付与の詳細については、アクセスの管理をご覧ください。

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

必要な権限

単一プロジェクトの予約を作成するには、次の権限が必要です。

プロジェクトに対する compute.reservations.create
インスタンステンプレートを指定するには: インスタンステンプレートに対する compute.instanceTemplates.useReadOnly 権限

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

単一プロジェクトの予約を作成する

このセクションでは、単一プロジェクトの予約を作成する方法について説明します。

予約を使用するには、VM がその予約と完全に一致するプロパティが必要です。予約する VM のプロパティを指定するには、このドキュメントの次のいずれかのセクションを選択します。

推奨: インスタンステンプレートを指定する

このセクションでは、インスタンステンプレートを使用して予約のプロパティを定義する方法について説明します。インスタンステンプレートを使用すると、予約のプロパティと、同じ場所で予約を使用できる VM を定義できます。
プロパティを直接指定する

このセクションでは、予約のプロパティを直接定義する方法について説明します。この方法では、VM と予約のプロパティが正確に一致していることを手動で確認する必要があります。プロパティが一致しない場合は使用できません。

デフォルトでは、一致するプロパティを持つすべての VM が予約を自動的に使用できます。予約の使用を制御する場合は、次のいずれかを行います。

このドキュメントの次のセクションで説明するように、予約を作成して、その特定の予約をターゲットとする VM のみが使用できるようにします。次に、その特定の予約を使用するように VM を構成します。
予約を使用できない VM を構成します。

また、単一プロジェクトの予約を作成するときにコンパクトプレースメントポリシーを指定できます。コンパクトプレースメントポリシーでは、ネットワークレイテンシを短縮するために、VM を相互にできるだけ近づけることを指定します。

インスタンステンプレートを指定する

インスタンステンプレートを指定して予約を作成するときにエラーが発生しないようにするには、次の点を確認してください。

インスタンステンプレート内のリソースと同じリージョンとゾーンに予約を作成します。インスタンステンプレートで指定されているリージョンリソースやゾーンリソース（マシンタイプや Persistent Disk ボリュームなど）によって、テンプレートの使用はそれらのリソースが存在するロケーションに限定されます。たとえば、インスタンステンプレートでゾーン us-central1-a の既存の Persistent Disk ボリュームを指定した場合、同じゾーンでのみ予約を作成できます。既存のテンプレートに、特定のリージョンまたはゾーンにテンプレートをバインドするリソースが指定されているかどうかを確認するには、インスタンステンプレートについての情報を確認し、その中のリージョンリソースまたはゾーンリソースへの参照を探します。
インスタンステンプレートでコンパクトプレースメントポリシーを指定する場合は、コンパクトプレースメントポリシーにサポートされているマシンタイプもテンプレートで指定するようにしてください。この条件を満たしていない場合、予約の作成は失敗します。

インスタンステンプレートを指定して単一プロジェクトの予約を作成するには、次のいずれかの方法を選択します。

コンソール

Google Cloud コンソールの [予約] ページに移動します。

[予約] に移動
[オンデマンド予約] タブ（デフォルト）で、[ 予約を作成] をクリックします。

[予約の作成] ページが開きます。
[名前] フィールドに、予約の名前を入力します。
リソースを予約するリージョンとゾーンを選択します。
[共有タイプ] セクションで [ローカル]（デフォルト）をクリックします。
[VM インスタンスでの使用] セクションで、次のオプションのいずれかを選択します。
- 一致する VM がこの予約を自動的に使用できるようにするには、[予約を自動的に使用する] を選択します（デフォルト）。
- 特にこの予約名を対象にし、条件を満たしている VM を作成する場合にのみ、この予約のリソースを使用するには、[特定の予約を選択する] を選択します。
  
  注: インスタンステンプレートで A3 マシンタイプまたはコンパクトプレースメントポリシーを指定する場合は、[特定の予約を選択する] を選択する必要があります。そうでない場合は、エラーが発生します。
[VM インスタンスの数] フィールドに、予約する VM の数を入力します。
[マシンの構成] セクションで、次の操作を行います。
1. 既存のインスタンステンプレートから VM のプロパティを指定するには、[インスタンステンプレートを使用] を選択します。
2. [インスタンステンプレート] フィールドで、任意のインスタンステンプレートを選択します。リージョンインスタンステンプレートを選択した場合は、インスタンステンプレートのリージョン内のリソースのみを予約できます。
[自動削除] セクションで自動削除オプションを有効にして、Compute Engine が特定の日時に予約を自動的に削除するようにできます。予約を自動的に削除すると、予約の使用を停止したときに不要な料金が発生しないようにできます。
予約を作成するには、[作成] をクリックします。

[予約] ページが開きます。単一プロジェクトの予約の作成が完了するまでに、最長 1 分かかることがあります。

gcloud

単一プロジェクトの予約を作成するには、gcloud compute reservations create コマンドを使用します。

オプションのフラグを使用せずにインスタンステンプレートを指定して単一プロジェクトの予約を作成するには、次のコマンドを実行します。

gcloud compute reservations create RESERVATION_NAME \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --vm-count=NUMBER_OF_VMS \
    --zone=ZONE

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

RESERVATION_NAME: 作成する予約の名前。
PROJECT_ID: インスタンステンプレートが存在しており、リソースを予約するプロジェクトの ID。
LOCATION: インスタンステンプレートのロケーション。次のいずれかの値を指定します。
- グローバルインスタンステンプレートの場合: global
- リージョンインスタンステンプレートの場合: regions/REGION。REGION は、インスタンステンプレートが配置されているリージョンに置き換えます。リージョンインスタンステンプレートを指定する場合は、テンプレートのリージョンと同じリージョン内の VM のみを予約できます。
INSTANCE_TEMPLATE_NAME: 既存のインスタンステンプレートの名前。インスタンステンプレートで A3 マシンタイプまたはコンパクトプレースメントポリシーを指定する場合は、--require-specific-reservation フラグを含める必要があります。これは、この予約を対象とする VM のみがこの予約を使用できることを意味します。詳細については、特定の予約から VM を使用するをご覧ください。
NUMBER_OF_VMS: 予約する VM の数。
ZONE: リソースを予約するゾーン。

たとえば、グローバルインスタンステンプレートを指定してゾーン us-central1-a で 10 個の VM の予約を作成するには、次のコマンドを実行します。

gcloud compute reservations create my-reservation \
    --source-instance-template=projects/example-project/global/example-instance-template \
    --vm-count=10 \
    --zone=us-central1-a

必要に応じて、以下の 1 つ以上の操作を行うことができます。

この予約を対象とする VM のみがこの予約を使用できることを指定するには、--require-specific-reservation フラグを指定します。

gcloud compute reservations create RESERVATION_NAME \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --require-specific-reservation \
    --vm-count=NUMBER_OF_VMS \
    --zone=ZONE

Compute Engine で予約を自動的に削除できるようにするには、次のいずれかのメソッドを選択します。

プレビュー — The --delete-at-time and --delete-after-duration flags

この機能には、サービス固有の利用規約の「一般的なサービス規約」の「pre-GA サービス規約」が適用されます。 pre-GA の機能は「現状有姿」で利用できますが、サポートが制限される場合があります。詳しくは、リリースステージの説明をご覧ください。
- 特定の日時に予約を削除するには、--delete-at-time フラグを指定して gcloud beta compute reservations create コマンドを使用します。
```
gcloud beta compute reservations create RESERVATION_NAME \
    --delete-at-time=DELETE_AT_TIME \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --vm-count=NUMBER_OF_VMS \
    --zone=ZONE
```
  DELETE_AT_TIME は、RFC 3339 タイムスタンプ形式の日時に置き換えます。これは次のようにする必要があります。 none YYYY-MM-DDTHH:MM:SSOFFSET
  
  次のように置き換えます。
  - YYYY-MM-DD: 4 桁の年、2 桁の月、その月の 2 桁の日をハイフン（-）で区切った日付。
  - HH:MM:SS: 24 時間制の 2 桁の時間、2 桁の分、2 桁の秒をコロン（:）で区切った時刻。
  - OFFSET: 協定世界時（UTC）のオフセット形式で示されるタイムゾーン。たとえば、太平洋標準時（PST）を使用する場合は -08:00 を指定します。オフセットを使用しない場合は、Z を指定します。
- 特定の期間の経過後に予約を削除するには、--delete-after-duration フラグを指定して gcloud beta compute reservations create コマンドを使用します。
```
gcloud beta compute reservations create RESERVATION_NAME \
    --delete-after-duration=DELETE_AFTER_DURATION \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --vm-count=NUMBER_OF_VMS \
    --zone=ZONE
```
  DELETE_AFTER_DURATION は、期間（日、時、分、秒）に置き換えます。たとえば、30 分の場合は 30m を指定し、1 日、2 時間、3 分、4 秒の場合は 1d2h3m4s を指定します。

REST

単一プロジェクトの予約を作成するには、reservations.insert メソッドに POST リクエストを行います。

オプションのフラグを使用せずにインスタンステンプレートを指定して単一プロジェクトの予約を作成するには、次の POST リクエストを送信します。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations

{
  "name": "RESERVATION_NAME",
  "specificReservation": {
    "count": "NUMBER_OF_VMS",
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME"
  }
}

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

PROJECT_ID: リソースを予約する、インスタンステンプレートが存在するプロジェクトの ID。
ZONE: リソースを予約するゾーン。
RESERVATION_NAME: 作成する予約の名前。
NUMBER_OF_VMS: 予約する VM の数。
LOCATION: インスタンステンプレートのロケーション。次のいずれかの値を指定します。
- グローバルインスタンステンプレートの場合: global
- リージョンインスタンステンプレートの場合: regions/REGION。REGION は、インスタンステンプレートが配置されているリージョンに置き換えます。リージョンインスタンステンプレートを指定する場合は、テンプレートのリージョンと同じリージョン内の VM のみを予約できます。
INSTANCE_TEMPLATE_NAME: 既存のインスタンステンプレートの名前。インスタンステンプレートで A3 マシンタイプまたはコンパクトプレースメントポリシーを指定する場合は、リクエスト本文に specificReservationRequired フィールドを含め、このフィールドを true に設定する必要があります。これは、この予約を対象とする VM のみがこの予約を使用できることを意味します。詳細については、特定の予約から VM を使用するをご覧ください。

たとえば、グローバルインスタンステンプレートを指定してゾーン us-central1-a で 10 個の VM の予約を作成するには、次の POST リクエストを送信します。

POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations

{
  "name": "my-reservation",
  "specificReservation": {
    "count": "10",
    "sourceInstanceTemplate": "projects/example-project/global/instanceTemplates/example-instance-template"
  }
}

必要に応じて、以下の 1 つ以上の操作を行うことができます。

この予約を対象とする VM のみがこの予約を使用できることを指定するには、リクエスト本文に specificReservationRequired フィールドを含め、このフィールドを true に設定します。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations

{
  "name": "RESERVATION_NAME",
  "specificReservation": {
    "count": "NUMBER_OF_VMS",
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME"
  },
  "specificReservationRequired": true
}

Compute Engine で予約を自動的に削除できるようにするには、次のいずれかのメソッドを選択します。

プレビュー — The deleteAtTime and deleteAfterDuration fields

この機能には、サービス固有の利用規約の「一般的なサービス規約」の「pre-GA サービス規約」が適用されます。 pre-GA の機能は「現状有姿」で利用できますが、サポートが制限される場合があります。詳しくは、リリースステージの説明をご覧ください。
- 特定の日時の予約を削除するには、beta.reservations.insert メソッドに POST リクエストを送信します。リクエスト本文に、deleteAtTime フィールドを含めます。
```
POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations

{
  "deleteAtTime": "DELETE_AT_TIME",
  "name": "RESERVATION_NAME",
  "specificReservation": {
    "count": "NUMBER_OF_VMS",
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME"
  }
}
```
  DELETE_AT_TIME は、RFC 3339 タイムスタンプ形式の日時に置き換えます。これは次のようにする必要があります。
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
  次のように置き換えます。
  - YYYY-MM-DD: 4 桁の年、2 桁の月、その月の 2 桁の日をハイフン（-）で区切った日付。
  - HH:MM:SS: 24 時間制の 2 桁の時間、2 桁の分、2 桁の秒をコロン（:）で区切った時刻。
  - OFFSET: 協定世界時（UTC）のオフセット形式で示されるタイムゾーン。たとえば、太平洋標準時（PST）を使用する場合は -08:00 を指定します。オフセットを使用しない場合は、Z を指定します。
- 特定の期間の経過後に予約を削除するには、beta.reservations.insert メソッドに POST リクエストを送信します。リクエスト本文に、deleteAfterDuration フィールドを含めます。
```
POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations

{
  "deleteAfterDuration": {
    "seconds": "DELETE_AFTER_DURATION"
  },
  "name": "RESERVATION_NAME",
  "specificReservation": {
    "count": "NUMBER_OF_VMS",
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME"
  }
}
```
  DELETE_AFTER_DURATION は期間（秒単位）に置き換えます。たとえば、86,400 秒（1 日）の場合は 86400 を指定します。

プロパティを直接指定する

プロパティを直接指定して単一プロジェクトの予約を作成するには、次のいずれかの方法を選択します。

コンソール

Google Cloud コンソールの [予約] ページに移動します。

[予約] に移動
[オンデマンド予約] タブ（デフォルト）で、[ 予約を作成] をクリックします。

[予約の作成] ページが開きます。
[名前] フィールドに、予約の名前を入力します。
リソースを予約するリージョンとゾーンを選択します。
[共有タイプ] セクションで [ローカル]（デフォルト）をクリックします。
[VM インスタンスでの使用] セクションで、次のオプションのいずれかを選択します。
- 一致する VM がこの予約を自動的に使用できるようにするには、[予約を自動的に使用する] を選択します（デフォルト）。
- 特にこの予約名を対象にし、条件を満たしている VM を作成する場合にのみ、この予約のリソースを使用するには、[特定の予約を選択する] を選択します。
  
  注: 予約で A3 マシンタイプまたはコンパクトプレースメントポリシーを指定する場合は、[特定の予約を選択する] を選択する必要があります。そうでない場合は、エラーが発生します。
[VM インスタンスの数] フィールドに、予約する VM の数を入力します。
[マシンの構成] セクションで、[マシンタイプを指定] を選択し、次の項目を指定します。
1. [マシンファミリー]、[シリーズ]、[マシンタイプ] の各フィールドで、マシンファミリー、シリーズ、マシンタイプを選択します。
2. 省略可: 最小 CPU プラットフォームを指定するか、GPU を N1 VM に接続するには、次の操作を行います。
  1. [CPU プラットフォームと GPU] セクションを展開するには、展開矢印をクリックします。
  2. 省略可: 最小 CPU プラットフォームを指定するには、[CPU プラットフォーム] リストでオプションを選択します。
  3. 省略可: N1 VM に GPU を接続するには、[GPU を追加] をクリックします。次に、[GPU タイプ] フィールドと [GPU の数] フィールドで、各 N1 VM に接続する GPU のタイプと数を選択します。
3. 省略可: ローカル SSD ディスクを追加するには、次の操作を行います。
  1. [ディスクの数] フィールドで、各 VM のローカル SSD ディスクの数を選択します。
  2. [インターフェースタイプ] フィールドで、ローカル SSD ディスクのインターフェースを選択します。
4. 省略可: 要件を満たす予約のコンパクトプレースメントポリシーを指定するには、[グループプレースメントポリシーを選択または作成します] リストをクリックして、次のいずれかの操作を行います。
  - コンパクトプレースメントポリシーを作成してこの予約で指定するには、次の操作を行います。
    
    重要: この方法を使用すると、指定されていない max-distance を含むコンパクトプレースメントポリシーのみを作成できます。max-distance の値が 3 または 2 の新しいコンパクトプレースメントポリシーを指定する場合は、個別のコンパクトプレースメントポリシーを作成し、既存のコンパクトプレースメントポリシーを選択する必要があります。
    1. [グループプレースメントポリシーを作成] をクリックします。
      
      [グループプレースメントポリシーを作成] ペインが表示されます。
    2. [ポリシー名] フィールドに、ポリシーの名前を入力します。
    3. [作成] をクリックします。
      
      コンパクトプレースメントポリシーの作成には数秒かかることがあります。
  - それ以外の場合は、既存のコンパクトプレースメントポリシーを選択します。
[自動削除] セクションで自動削除オプションを有効にして、Compute Engine が特定の日時に予約を自動的に削除するようにできます。予約を自動的に削除すると、予約の使用を停止したときに不要な料金が発生しないようにできます。
予約を作成するには、[作成] をクリックします。

単一プロジェクトの予約の作成が完了するまでに時間がかかることがあります。この操作により、[予約] ページにリダイレクトされます。

gcloud

単一プロジェクトの予約を作成するには、gcloud compute reservations create コマンドを使用します。

オプションのフラグを使用せずにプロパティを直接指定して、単一プロジェクトの予約を作成するには、次のコマンドを実行します。

gcloud compute reservations create RESERVATION_NAME \
    --machine-type=MACHINE_TYPE \
    --vm-count=NUMBER_OF_VMS \
    --zone=ZONE

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

RESERVATION_NAME: 作成する予約の名前。
MACHINE_TYPE: 各 VM に使用するマシンタイプ。A3 マシンタイプを指定する場合は、--require-specific-reservation フラグを含める必要があります。これは、この予約を対象とする VM のみがこの予約を使用できることを意味します。詳細については、特定の予約から VM を使用するをご覧ください。
NUMBER_OF_VMS: 予約する VM の数。
ZONE: リソースを予約するゾーン。

たとえば、ゾーン us-central1-a で 10 個の VM（各 VM は、4 つの vCPU を備えた事前定義されたマシンタイプ N2 を使用）の予約を作成するには、次のコマンドを実行します。

gcloud compute reservations create my-reservation \
    --machine-type=n2-standard-4 \
    --vm-count=10 \
    --zone=us-central1-a

必要に応じて、以下の 1 つ以上の操作を行うことができます。

予約済みの N1 VM に GPU を接続するには、--accelerator フラグを指定します。
```
gcloud compute reservations create RESERVATION_NAME \
    --accelerator=count=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE
    --machine-type=MACHINE_TYPE \
    --vm-count=NUMBER_OF_VMS \
    --zone=ZONE
```
次のように置き換えます。
- NUMBER_OF_ACCELERATORS: 追加する GPU の数（予約済み VM あたり）。
- ACCELERATOR_TYPE: N1 VM でサポートされている GPU モデル。リソースを予約するゾーンで GPU モデルを使用できることを確認します。この条件を満たしていない場合、予約の作成は失敗します。
予約する各 VM に 1 つ以上のローカル SSD ディスクを追加するには、1 つ以上の --local-ssd フラグを指定します。ローカル SSD ディスクは 24 個まで指定できます。各ローカル SSD ディスクは 375 GB です。

たとえば、予約の作成時に 2 つのローカル SSD を指定するには、次のように 2 つの --local-ssd フラグを指定します。
```
gcloud compute reservations create RESERVATION_NAME \
    --local-ssd=size=375,interface=INTERFACE_1 \
    --local-ssd=size=375,interface=INTERFACE_2 \
    --machine-type=MACHINE_TYPE \
    --vm-count=NUMBER_OF_VMS \
    --zone=ZONE
```
INTERFACE_1 と INTERFACE_2 は、各ローカル SSD ディスクで使用するインターフェースのタイプに置き換えます。次のいずれかの値を指定します。
- NVME ディスクインターフェース: nvme
- SCSI ディスクインターフェース: scsi
予約済み VM に指定したマシンタイプが、選択したディスクインターフェースをサポートしていることを確認します。この条件を満たしていない場合、予約の作成は失敗します。詳細については、ディスクインターフェースの選択方法をご覧ください。
予約する VM でゾーンのデフォルトの CPU プラットフォームではなく、特定の最小 CPU プラットフォームを使用するには、--min-cpu-platform フラグを指定します。
```
gcloud compute reservations create RESERVATION_NAME \
    --machine-type=MACHINE_TYPE \
    --min-cpu-platform="MIN_CPU_PLATFORM" \
    --vm-count=NUMBER_OF_VMS \
    --zone=ZONE
```
MIN_CPU_PLATFORM は、最小 CPU プラットフォームに置き換えます。リソースを予約するゾーンで CPU プラットフォームが使用可能であることを確認するには、ゾーンごとに使用可能な CPU プラットフォームを表示します。

この予約を対象とする VM のみがこの予約を使用できることを指定するには、--require-specific-reservation フラグを指定します。

gcloud compute reservations create RESERVATION_NAME \
    --machine-type=MACHINE_TYPE \
    --require-specific-reservation \
    --vm-count=NUMBER_OF_VMS \
    --zone=ZONE

VM 間のネットワークレイテンシを短縮するためにコンパクトプレースメントポリシーを指定するには、--resource-policies=policy フラグを指定します。
```
gcloud compute reservations create RESERVATION_NAME \
    --machine-type=MACHINE_TYPE \
    --resource-policies=policy=COMPACT_PLACEMENT_POLICY_NAME \
    --require-specific-reservation \
    --vm-count=NUMBER_OF_VMS \
    --zone=ZONE
```
COMPACT_PLACEMENT_POLICY_NAME は、既存のコンパクトプレースメントポリシーの名前に置き換えます。また、コンパクトプレースメントポリシーを指定する単一プロジェクト予約を作成するときにエラーを回避するため、次の項目を指定します。
- コンパクトプレースメントポリシーでサポートされているマシンタイプと VM の最大数。
- コンパクトプレースメントポリシーが配置されているリージョン内のゾーン。
- --require-specific-reservation フラグ。これは、この予約を対象とする VM のみがこの予約を使用できることを意味します。
Compute Engine で予約を自動的に削除できるようにするには、次のいずれかのメソッドを選択します。

プレビュー — The --delete-at-time and --delete-after-duration flags

この機能には、サービス固有の利用規約の「一般的なサービス規約」の「pre-GA サービス規約」が適用されます。 pre-GA の機能は「現状有姿」で利用できますが、サポートが制限される場合があります。詳しくは、リリースステージの説明をご覧ください。
- 特定の日時に予約を削除するには、--delete-at-time フラグを指定して gcloud beta compute reservations create コマンドを使用します。
```
gcloud beta compute reservations create RESERVATION_NAME \
    --delete-at-time=DELETE_AT_TIME \
    --machine-type=MACHINE_TYPE \
    --vm-count=NUMBER_OF_VMS \
    --zone=ZONE
```
  DELETE_AT_TIME は、RFC 3339 タイムスタンプ形式の日時に置き換えます。これは次のようにする必要があります。
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
  次のように置き換えます。
  - YYYY-MM-DD: 4 桁の年、2 桁の月、その月の 2 桁の日をハイフン（-）で区切った日付。
  - HH:MM:SS: 24 時間制の 2 桁の時間、2 桁の分、2 桁の秒をコロン（:）で区切った時刻。
  - OFFSET: 協定世界時（UTC）のオフセット形式で示されるタイムゾーン。たとえば、太平洋標準時（PST）を使用する場合は -08:00 を指定します。オフセットを使用しない場合は、Z を指定します。
- 特定の期間の経過後に予約を削除するには、--delete-after-duration フラグを指定して gcloud beta compute reservations create コマンドを使用します。
```
gcloud beta compute reservations create RESERVATION_NAME \
    --delete-after-duration=DELETE_AFTER_DURATION \
    --machine-type=MACHINE_TYPE \
    --vm-count=NUMBER_OF_VMS \
    --zone=ZONE
```
  DELETE_AFTER_DURATION は、期間（日、時、分、秒）に置き換えます。たとえば、30 分の場合は 30m を指定し、1 日、2 時間、3 分、4 秒の場合は 1d2h3m4s を指定します。

Terraform

単一プロジェクトの予約を作成するには、google_compute_reservation Terraform リソースを使用します。

たとえば、2 つの vCPU を備えた 1 つの N2 事前定義マシンタイプに単一プロジェクトの予約を作成するには、次のリソースを使用します。


resource "google_compute_reservation" "default" {
  name = "gce-reservation-local"
  zone = "us-central1-a"

  /**
   * To specify a single-project reservation, omit the share_settings block
   * (default) or set the share_type field to LOCAL.
   */
  share_settings {
    share_type = "LOCAL"
  }

  specific_reservation {
    count = 1
    instance_properties {
      machine_type = "n2-standard-2"
    }
  }

  /**
   * To let VMs with affinity for any reservation consume this reservation, omit
   * the specific_reservation_required field (default) or set it to false.
   */
  specific_reservation_required = false
}

Terraform の使用方法の詳細については、Google Cloud で Terraform を使用するをご覧ください。

REST

単一プロジェクトの予約を作成するには、reservations.insert メソッドに POST リクエストを行います。

オプションフィールドを使用せずにプロパティを直接指定して、単一プロジェクトの予約を作成するには、次の POST リクエストを送信します。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations

{
  "name": "RESERVATION_NAME",
  "specificReservation": {
    "count": "NUMBER_OF_VMS",
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    }
  }
}

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

PROJECT_ID: リソースを予約するプロジェクトの ID。
ZONE: リソースを予約するゾーン。
RESERVATION_NAME: 作成する予約の名前。
NUMBER_OF_VMS: 予約する VM の数。
MACHINE_TYPE: 各 VM に使用するマシンタイプ。A3 マシンタイプを指定する場合は、リクエスト本文に specificReservationRequired フィールドを含め、フィールドを true に設定する必要があります。これは、この予約を対象とする VM のみがこの予約を使用できることを意味します。詳細については、特定の予約から VM を使用するをご覧ください。

たとえば、ゾーン us-central1-a で 10 個の VM（各 VM は、4 つの vCPU を備えた事前定義されたマシンタイプ N2 を使用）の予約を作成するには、次の POST リクエストを送信します。

POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations

{
  "name": "my-reservation",
  "specificReservation": {
    "count": "10",
    "instanceProperties": {
      "machineType": "n2-standard-4",
    }
  }
}

必要に応じて、以下の 1 つ以上の操作を行うことができます。

予約済みの N1 VM に GPU を接続するには、リクエスト本文に guestAccelerators フィールドを含めます。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations

{
  "name": "RESERVATION_NAME",
  "specificReservation": {
    "count": "NUMBER_OF_VMS",
    "instanceProperties": {
      "guestAccelerators": [
        {
          "acceleratorCount": NUMBER_OF_ACCELERATORS,
          "acceleratorType": "ACCELERATOR_TYPE"
        }
      ],
      "machineType": "MACHINE_TYPE"
    }
  }
}

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

NUMBER_OF_ACCELERATORS: 追加する GPU の数（予約済み VM あたり）。
ACCELERATOR_TYPE: N1 VM でサポートされている GPU モデル。リソースを予約するゾーンで GPU モデルを使用できることを確認します。この条件を満たしていない場合、予約の作成は失敗します。

予約する各 VM に 1 つ以上のローカル SSD ディスクを追加するには、リクエスト本文に localSsds フィールドを含めます。ローカル SSD ディスクは 24 個まで指定できます。各ローカル SSD ディスクは 375 GB です。

たとえば、予約の作成時に 2 つのローカル SSD ディスクを指定するには、次のようにリクエストを送信します。
```
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations

{
  "name": "RESERVATION_NAME",
  "specificReservation": {
    "count": "NUMBER_OF_VMS",
    "instanceProperties": {
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_1"
        },
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_2"
        }
      ],
      "machineType": "MACHINE_TYPE"
    }
  }
}
```
INTERFACE_1 と INTERFACE_2 は、各ローカル SSD ディスクで使用するインターフェースのタイプに置き換えます。次のいずれかの値を指定します。
- NVME ディスクインターフェース: NVME
- SCSI ディスクインターフェース: SCSI
予約済み VM に指定したマシンタイプが、選択したディスクインターフェースをサポートしていることを確認します。この条件を満たしていない場合、予約の作成は失敗します。詳細については、ディスクインターフェースの選択方法をご覧ください。
予約する VM でゾーンのデフォルトの CPU プラットフォームではなく、特定の最小 CPU プラットフォームを使用するには、リクエスト本文に minCpuPlatform フィールドを含めます。
```
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations

{
  "name": "RESERVATION_NAME",
  "specificReservation": {
    "count": "NUMBER_OF_VMS",
    "instanceProperties": {
      "machineType": "MACHINE_TYPE",
      "minCpuPlatform": "MIN_CPU_PLATFORM"
    }
  }
}
```
MIN_CPU_PLATFORM は、最小 CPU プラットフォームに置き換えます。リソースを予約するゾーンで CPU プラットフォームが使用可能であることを確認するには、ゾーンごとに使用可能な CPU プラットフォームを表示します。
予約する VM 間のネットワークレイテンシを短縮するためにコンパクトプレースメントポリシーを指定するには、リクエスト本文に resourcePolicies フィールドを含めます。
```
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations

{
  "name": "RESERVATION_NAME",
  "resourcePolicies": {
    "policy" : "projects/example-project/regions/REGION/resourcePolicies/COMPACT_PLACEMENT_POLICY_NAME"
  },
  "specificReservation": {
    "count": "NUMBER_OF_VMS",
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    }
  },
  "specificReservationRequired": true
}
```
次のように置き換えます。
- REGION: コンパクトプレースメントポリシーが存在するリージョン。予約は、プレースメントポリシーのリージョン内でのみ作成できます。
- COMPACT_PLACEMENT_POLICY_NAME: 既存のコンパクトプレースメントポリシーの名前。
また、コンパクトプレースメントポリシーを指定する単一プロジェクト予約を作成するときにエラーを回避するため、次の項目を指定します。
- コンパクトプレースメントポリシーでサポートされているマシンタイプ。
- true に設定されている specificReservationRequired フィールド。これは、この予約を対象とする VM のみがこの予約を使用できることを意味します。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations

{
  "name": "RESERVATION_NAME",
  "specificReservation": {
    "count": "NUMBER_OF_VMS",
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    }
  },
  "specificReservationRequired": true
}

Compute Engine で予約を自動的に削除できるようにするには、次のいずれかのメソッドを選択します。

プレビュー — The deleteAtTime and deleteAfterDuration fields

この機能には、サービス固有の利用規約の「一般的なサービス規約」の「pre-GA サービス規約」が適用されます。 pre-GA の機能は「現状有姿」で利用できますが、サポートが制限される場合があります。詳しくは、リリースステージの説明をご覧ください。
- 特定の日時の予約を削除するには、beta.reservations.insert メソッドに POST リクエストを送信します。リクエスト本文に、deleteAtTime フィールドを含めます。
```
POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations

{
  "deleteAtTime": "DELETE_AT_TIME",
  "name": "RESERVATION_NAME",
  "specificReservation": {
    "count": "NUMBER_OF_VMS",
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    }
  }
}
```
  DELETE_AT_TIME は、RFC 3339 タイムスタンプ形式の日時に置き換えます。これは次のようにする必要があります。
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
  次のように置き換えます。
  - YYYY-MM-DD: 4 桁の年、2 桁の月、その月の 2 桁の日をハイフン（-）で区切った日付。
  - HH:MM:SS: 24 時間制の 2 桁の時間、2 桁の分、2 桁の秒をコロン（:）で区切った時刻。
  - OFFSET: 協定世界時（UTC）のオフセット形式で示されるタイムゾーン。たとえば、太平洋標準時（PST）を使用する場合は -08:00 を指定します。オフセットを使用しない場合は、Z を指定します。
- 特定の期間の経過後に予約を削除するには、beta.reservations.insert メソッドに POST リクエストを送信します。リクエスト本文に、deleteAfterDuration フィールドを含めます。
```
POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations

{
  "deleteAfterDuration": {
    "seconds": "DELETE_AFTER_DURATION"
  },
  "name": "RESERVATION_NAME",
  "specificReservation": {
    "count": "NUMBER_OF_VMS",
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    }
  }
}
```
  DELETE_AFTER_DURATION は期間（秒単位）に置き換えます。たとえば、86,400 秒（1 日）の場合は 86400 を指定します。

トラブルシューティング

予約の作成に関するトラブルシューティング方法を確認してください。

次のステップ

予約を表示する方法を確認する。
コミットメントに予約を関連付ける方法を学習する。
予約を使用する方法を学習する。
予約の使用量をモニタリングする方法を確認する。

単一プロジェクトの予約を作成する

始める前に

コンソール

gcloud

Terraform

REST

必要なロール

必要な権限

単一プロジェクトの予約を作成する

インスタンス テンプレートを指定する

コンソール

gcloud

REST

プロパティを直接指定する

コンソール

gcloud

Terraform

REST

トラブルシューティング

次のステップ

インスタンステンプレートを指定する