UIで予約に仮想サーバーインスタンスをアタッチする

仮想サーバーを予約に接続できます。

1. IBM Cloud コンソール で、「 ナビゲーションメニュー 」アイコン（ > インフラ > 予約 ）をクリックします。
2. 「予約の詳細」ページで予約を選択します。
3. 仮想サーバーのリストから、 「アクション」 >「 接続」をクリックします。
4. 予約にアタッチするサーバーを選択し、[アタッチ] をクリックします。

UI を使用した予約からのサーバーの切り離し

予約から仮想サーバーを切り離すことができます。

1. IBM Cloud コンソール で、「 ナビゲーションメニュー 」アイコン（ > インフラ > 予約 ）をクリックします。
2. 仮想サーバーのリストまたは「予約の詳細」ページで、切り離すサーバーをクリックしてから、 「アクション」 > 「切り離し」 をクリックします。
3. 確認するには、 「切り離し」 をクリックします。

インスタンスが停止され、開始された場合、たとえ期限切れの予約を指していても、開始は許可され、従量課金で課金される。

UI を使用して予約を削除する

予約を削除することができます。

1. IBM Cloud コンソール で、「 ナビゲーションメニュー 」アイコン（ > インフラ > 予約 ）をクリックします。
2. 予約リストで、 「アクション」 > 「予約の削除」 をクリックします。
3. 確認するには、 「削除」 をクリックします。

予約のアクティブ化

コマンド・ライン・インターフェース (CLI) を使用して予約をアクティブ化できます。 CLI を使用して特定の予約をアクティブ化するには、 ibmcloud is reservation-activate コマンドを使用します。 取得する特定の予約の RESERVATION_NAME を使用して、特定の予約の名前または ID を指定する必要があります。

ibmcloud is reservation-activate RESERVATION

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

ibmcloud is reservation-activate b4735ce6-f83d-45d1-b41b-4d47451c8396
Activating reservation b4735ce6-f83d-45d1-b41b-4d47451c8396 under account ACCOUNT as user user@ibm.com...
Successfully activated reservation.

以下の引数およびオプション値が使用される

• 予約：予約IDまたは予約名。
• --output: 出力形式を指定してください。JSONのみがサポートされています。 次のいずれか: JSON。
• -q, --quiet: 詳細な出力を抑制する

予約付きインスタンスの取得

コマンド・ライン・インターフェース (CLI) を使用して、リージョン内の予約済みインスタンスを取得できます。 CLI を使用して特定のインスタンス予約を取得するには、 ibmcloud is instance コマンドを使用します。 取得したい特定のインスタンスの名前またはIDを INSTANCE_NAME。

ibmcloud is instance INSTANCE_NAME

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

ibmcloud is instance instance-cli-test-patch-reservation-1
Getting instance instance-cli-test-patch-reservation-1 under account VPCUI-DEV as user user@ibm.com...
ID                aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa
Name              aaa-default-reservation-2
CRN               crn:v1:bluemix:public:is:jp-tok:a/823bd195e9fd4f0db40ac2e1bffef3e0::reservation:aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa
Status            active
Zone              us-east-1
Lifecycle state   stable
Affinity Policy   open
Resource group    -
Profile Name      mx2-2x16
Created At        2023-06-05T10:41:51.401+05:30
Expiration        At                         Policy   Term
                  2026-08-28T05:11:51.401Z   renew    three_year
Capacity          Allocated   Available   Total   Used   Status
                  8           8           8       0      -

予約の削除

コマンド・ライン・インターフェース (CLI) を使用して、リージョン内の予約を IBM Cloud VPC 削除できます。 CLI を使用して予約を削除するには、 ibmcloud is reservation-delete コマンドを使用します。 削除する特定の予約の RESERVATION_NAME を使用して、特定の予約の名前または ID を指定する必要があります。

ibmcloud is reservation-delete RESERVATION_NAME

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

ibmcloud is reservation-delete e9e537f0-59f5-4759-b06e-86bb5cd4068e
This will delete reservation e9e537f0-59f5-4759-b06e-86bb5cd4068e and cannot be undone. Continue [y/N] ?> y
Deleting reservation e9e537f0-59f5-4759-b06e-86bb5cd4068e under account ACCOUNT as user user@ibm.com...
OK
Reservation e9e537f0-59f5-4759-b06e-86bb5cd4068e is deleted.

以下の引数およびオプション値が使用される

• RESERVATION1: 予約のIDまたは名前。
• RESERVATION2: 予約のIDまたは名前。
• --force, -f: 確認なしで操作を強制実行する
• --output: 出力形式を指定してください。JSONのみがサポートされています。 次のいずれか: JSON。
• -q, --quiet: 詳細な出力を抑制します。

すべての予約を表示する

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

ibmcloud is reservations

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

ibmcloud is reservations
Listing reservations in all resource groups and region us-south under account VPCUI-DEV as user user@ibm.com...
ID                                          Name                     Status    Zone         Profile    Resource group
0735_73b1e3e5-10a2-44b0-a113-c8d6cd8c42e7   reservation-cli-test-1   active    us-south-3   cx2-2x4    Default
0735_4e245881-c9c8-49f3-a21b-d890a13835bb   reservation-cli-test-3   active    us-south-3   cx2-2x4    Default

予約の検索

コマンド・ライン・インターフェース (CLI) を使用して、リージョン内の特定の IBM Cloud VPC 予約を取得できます。 CLI を使用して特定の予約を取得するには、 ibmcloud is reservation コマンドを使用します。 取得する特定の予約の RESERVATION_NAME を使用して、特定の予約の名前または ID を指定する必要があります。

ibmcloud is reservation RESERVATION_NAME

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

ibmcloud is reservation aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa
Getting reservation aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa under account ACCOUNT as user user@ibm.com...
ID                aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa
Name              aaa-default-reservation-2
CRN               crn:v1:bluemix:public:is:jp-tok:a/823bd195e9fd4f0db40ac2e1bffef3e0::reservation:aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa
Status            active
Zone              us-east-1
Lifecycle state   stable
Affinity Policy   open
Resource group    -
Profile Name      mx2-2x16
Created At        2023-06-05:10:41:51.401+05:30
Expiration        At                         Policy   Term
                  2026-08-28T05:11:51.401Z   renew    three_year
Capacity          Allocated   Available   Total   Used   Status
                  8           8           8       0      -

予約の更新

コマンドラインインタフェース（CLI）を使用して、リージョン内の特定のIBM Cloud VPC予約を更新できます。 CLI を使用して特定の予約を更新するには、 ibmcloud is reservation-update コマンドを使用します。 更新する特定の予約の RESERVATION_NAME を使用して、特定の予約の名前または ID を指定する必要があります。 予約の名前を変更するには、 --name オプションで NEW_NAME 変数を使用します。

ibmcloud is reservation-update RESERVATION_NAME [--name NEW_NAME]

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

ibmcloud is reservation-update aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa --name aaa-default-reservation-2-renamed
Updating reservation aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa under account ACCOUNT as user user@ibm.com...
ID                aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa
Name              aaa-default-reservation-2-renamed
CRN               crn:v1:bluemix:public:is:us-east:a/823bd195e9fd4f0db40ac2e1bffef3e0::reservation:aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa
Status            active
Zone              us-east-1
Lifecycle state   stable
Affinity Policy   open
Resource group    -
Profile Name      mx2-2x16
Created At        2023-06-14T10:58:17.92+05:30
Expiration        At                         Policy    Term
                  2026-08-28T05:28:17.920Z   release   three_year
Capacity          Allocated   Available   Total   Used   Status
                  5           -           5       -      -

以下の引数およびオプション値が使用される

• --name: 予約の新しい名称。
• --capacity: この予約の収容人数の設定。
• --term: 予約期間。 次のいずれか: one_year、three_year。
• --profile: この予約に使用するプロファイル名。
• --profile-resource-type: プロファイルのリソースタイプ。 以下のいずれか: instance_profile。
• ---expiration-policy：コミットされた使用期間が終了したときに適用されるポリシー。 以下のいずれか: release、renew。
• --output: 出力形式を指定してください。JSONのみがサポートされています。 次のいずれか: JSON。
• -q, --quiet: 詳細な出力を抑制します。

すべての予約を表示する

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

すべての予約をリストするには、 GET /reservations 要求を指定します。 以下の例を参照してください。

curl -X GET "$vpc_api_endpoint/v1/reservations?version=2024-01-27&generation=2" -H "Authorization: Bearer $iam_token"

予約は、最初に create_at プロパティー値でソートされます。 最新の予約が最初にリストされます。 予約に同じ created_at プロパティー値がある場合、それらの予約は name プロパティー値でソートされます。 予約リストのデフォルトは50件ですが、最大100件まで増やすことができます。

以下のプロパティー値を使用して、リストをさらにフィルターに掛けることができます。

• name
• resource_group.id
• zone.name

予約の削除

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

DELETE /reservation リクエストを指定して予約を削除する。 以下の例を参照してください。

curl -X DELETE "$vpc_api_endpoint/v1/reservations/$id?version=2024-01-27&generation=2" - H "Authorization: Bearer $iam_token"

予約の検索

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

特定の予約を取得するために'GET /reservation/{id} リクエストを指定します。'id は取得する予約の予約識別子です。 識別子は URL にある。 以下の例を参照してください。

curl -X GET "$vpc_api_endpoint/v1/reservations/$id?version=2024-01-27&generation=2" - H "Authorization: Bearer $iam_token"

予約の更新

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

特定の予約を更新するための PATCH /reservations/{id} 要求を指定します。ここで、 id は、取得する予約の予約 ID です。 識別子は URL にある。 以下の例を参照してください。

curl -X PATCH "$vpc_api_endpoint/v1/reservations/$id?version=2024-01-27&generation=2" -H "Authorization: Bearer $iam_token" -d '{
      "committed_use": {
        "expiration_policy": "release"
      }
    }'

予約の有効化

アプリケーション・プログラミング・インターフェース（API）を使用することで、地域内の特定のIBM Cloud VPC予約をアクティブにすることができます。 APIを使用して特定の予約を有効にするには、Activate a reservation を使用してください。

特定の予約を更新するための POST /reservations/{id}/activate 要求を指定します。ここで、 id は、取得する予約の予約 ID です。 識別子は URL にある。 以下の例を参照してください。

curl -X POST "$vpc_api_endpoint/v1/reservations/$id/activate?version=2024-01-27&generation=2" -H "Authorization: Bearer $iam_token"