UI を使用した予約のプロビジョニング

IBM Cloud では、以下の手順に従って予約をプロビジョニングしてください。

1. IBM Cloud コンソール で、「 ナビゲーションメニュー 」アイコン（ > インフラ > 予約 ）をクリックします。
2. 新規予約を作成するには、 「作成」 をクリックします。
3. 「VPC の新規予約 (New reservation for VPC)」 ページで、以下の情報を入力または選択します。

4. 「 予約を作成 」をクリックしてください。

予約の有効期限が切れると、予約に接続されているサーバーは、予約期間の満了または非更新時に割引なしのオンデマンド料金に変換され、消費分は毎月請求されます。

UI を使用した予約への既存の仮想サーバーの接続

予約のアタッチポリシーが制限されている場合は、既存の仮想サーバーを予約にアタッチできます。 既存のすべての仮想サーバーは、同じプロファイル、サイズ、場所、手動添付ポリシーでなければならないことに留意してください。

自動アタッチポリシーを持つ仮想サーバーは、自動アタッチポリシーを持つ予約に自動的にアタッチします。

既存の仮想サーバーを予約にアタッチするには、以下の手順を実行します。

1. 仮想サーバーのリストから、 「接続」 をクリックします。
2. サーバーを接続する予約を選択し、接続をクリックします。

既存のベアメタルサーバーをUIで予約にアタッチする

既存のベアメタルサーバーを予約にアタッチすることができます。 予約にアタッチされるすべての既存のベアメタルサーバーは、同じプロファイル、サイズ、場所、および手動アタッチポリシーでなければならないことに留意してください。

自動アタッチメントポリシーを持つベアメタルサーバーは、自動アタッチメントポリシーを持つ予約に自動的にアタッチする。

以下の手順を使用して、既存のベアメタルサーバーを、自動アタッチポリシーを持つ予約にアタッチします。

1. ベアメタルサーバーのリストから、アタッチをクリックします。
2. サーバーを接続する予約を選択し、接続をクリックします。

CLI を使用した予約のプロビジョニング

コマンド・ライン・インターフェース (CLI) を使用して予約をプロビジョンできます。 ユーザー・タグまたはアクセス管理タグを使用してリソースを管理する場合は、 タグの処理 を参照してください。

{: tag-deprecated} [は非推奨となりました]。 IBM Cloud CLI は、 LinuxONE （ s390x プロセッサアーキテクチャ）ではサポートされていません（ ）。 ただし、サポートされている他のプラットフォームに CLI をインストールし、それを LinuxONE (s390x プロセッサー・アーキテクチャー) 仮想サーバー・インスタンスで使用することはできます。

CLI を使用した予約のプロビジョニング

コマンド・ライン・インターフェース (CLI) を使用して、リージョン内に IBM Cloud VPC 予約を作成できます。 CLI を使用して予約を作成するには、 ibmcloud is reservation-create コマンドを使用します。

1. 関連する詳細を指定した以下のコマンドを使用して、予約をプロビジョンします。

ibmcloud is reservation-create --capacity NUMBER --term TIME --profile PROFILE --profile-resource-type PROFILE_TYPE --zone ZONE --name NAME

以下の例を参照してください。

ibmcloud is reservation-create --capacity 10 --term one_year --profile ba2-2x8 --profile-resource-type instance_profile --zone us-east-1 --name reservation-mock-test-1
Creating reservation with name reservation-mock-test-1 under account ACCOUNT as user user@ibm.com...
ID                22d3ec3b-d798-454a-ad88-fe608ae86ad6
Name              reservation-mock-test-1
CRN               crn:v1:bluemix:public:is:us-east:a/823bd195e9fd4f0db40ac2e1bffef3e0::reservation:22d3ec3b-d798-454a-ad88-fe608ae86ad6
Status            active
Zone              us-east-1
Lifecycle state   stable
Affinity Policy   open
Resource group    -
Profile Name      ba2-2x8
Created At        2023-07-21T10:54:46.29+05:30
Expiration        At   Policy   Term
                  -    -        one_year
Capacity          Allocated   Available   Total   Used   Status
                  10          -           10      -      -

以下の引数とオプション値が使用される：

• --name: 予約の新しい名称。
• --capacity: この予約の収容人数の設定。
• --term: 予約期間。 次のいずれか: one_year、three_year。
• --profile: この予約に使用するプロファイル名。
• --profile-resource-type: プロファイルのリソースタイプ。 以下のいずれか: instance_profile。
• --zone: ゾーン名
• ---affinity-policy：この予約のアフィニティポリシー。
• --expiration-policy: コミットされた利用期間が満了した際に適用されるポリシー。 以下のいずれか: release、renew。
• --resource-group-id: リソースグループのID。 このIDは、 --resource-group-name と互いに排他的です。
• --resource-group-name: リソースグループの名前。 この名前は、 --resource-group-id と互いに排他的です。
• --output: 出力形式を指定してください。JSONのみがサポートされています。 次のいずれか: JSON。
• -q, --quiet: 詳細な出力を抑制します。

ibmcloud is instance-update <instance-name> --reservation-affinity-policy manual --reservation-affinity-pool <reservation-name>

ibmcloud is bare-metal-server-update SERVER [--name NEW_NAME] [--enable-secure-boot false | true] [--tpm-mode tpm_2 | disabled] [--bandwidth BANDWIDTH] [--reservation-affinity-policy disabled | manual] [--reservation-affinity-pool RESERVATION_AFFINITY_POOL] [--output JSON] [-q, --quiet]

API を使用した予約の作成

アプリケーション・プログラミング・インターフェース (API) を使用して、領域内に IBM Cloud VPC 予約を作成できます。 API を使用して予約を作成するには、 「予約の作成」 を使用します。

Post /reservations 要求を指定して、新規予約を作成します。 以下の例を参照してください。

curl -X POST "$vpc_api_endpoint/v1/reservations?version=2024-01-27&generation=2" -H "Authorization: Bearer $iam_token" -d '{
      "capacity": {
        "total": 10
      },
      "committed_use": {
        "expiration_policy": "renew",
        "term": "one_year"
      },
      "name": "my-reservation",
      "profile": {
        "name": "bx2-4x16",
        "resource_type": "instance_profile"
      },
      "zone": {
        "name": "us-south-1"
      }
    }'

Terraform を使用した予約の作成

Terraform を使用して予約を作成できます。

provider "ibm" {
  region = "us-south"
}

resource "ibm_is_reservation" "example" {
capacity {
 total = 5
}
committed_use {
 term = "one_year"
}
profile {
 name          = "ba2-2x8"
 resource_type = "instance_profile"
}
zone = "us-east-3"
name = "reservation-terraform-1"
}