UI を使用してベアメタルサーバーを再初期化する

サーバーが停止され、ローカル ストレージがプロビジョニングされている場合にのみ、サーバーを再初期化できます。 または、サーバーの状態が failed ライフサイクル状態のステータス理由は cannot_reinitialize。 ベアメタル サーバーが再初期化されると、ブート ディスクの内容が消去され、指定されたオペレーティング システムがインストールされます。 サーバーは同じ物理ノード、インターフェース、IP アドレス、およびリソース ID を保持します。 セカンダリドライブ上のデータは保存されます。

1. IBM Cloud コンソールで、 [ナビゲーション] > [インフラストラクチャ] > [コンピュート] > [ベアメタルサーバー] の順に選択します

2. 再初期化したいベアメタルサーバーの名前をクリックしてください。

3. [ アクション...] をクリックし、[ 再初期化 ] をクリックします。

CLI を使用してベアメタルサーバーの容量を確認する

CLI を使用してベアメタルサーバーの容量を確認するには、 ibmcloud is bare-metal-server-capacities コマンドを実行します。 このコマンドによって返される情報はあくまで参考用であり、容量の割り当ては行われません。 容量情報が表示され、利用可能なノードのみが含まれます。 他の場所に割り当てられているノードや、その他の理由で利用できないノードは、容量情報に含まれません。

必要に応じて、 --profile オプションでベアメタルサーバーのプロファイルを指定したり、 --zone オプションでゾーンを指定したり、あるいはその両方を指定して、結果をフィルタリングすることができます。

ibmcloud is bare-metal-server-capacities [--profile PROFILE] [--zone ZONE] [--output JSON] [-q, --quiet]

ibmcloud is bare-metal-server-capacities コマンドを使用する際は、以下のオプションを指定できます。

• --profile 既存のベアメタルプロファイルの名前を指定します。
• --zone ゾーン名を指定します。例： us-south-2。
• --output 出力形式を指定します。 JSON のみがサポートされています。
• -q, --quiet 詳細な出力を抑制します。

以下の出力例をご覧ください：

Profile Name  Availability Zones
profile-1     us-south-1,us-south-3
profile-2     us-south-2,us-south-3

CLI を使用してベアメタルサーバーを再初期化する

サーバーが停止され、ローカル ストレージがプロビジョニングされている場合にのみ、サーバーを再初期化できます。 または、サーバーの状態が failed ライフサイクル状態のステータス理由は cannot_reinitialize。 ベアメタル サーバーが再初期化されると、ブート ディスクの内容が消去され、指定されたオペレーティング システムがインストールされます。 サーバーは同じ物理ノード、インターフェース、IP アドレス、およびリソース ID を保持します。 セカンダリドライブ上のデータは保存されます。

CLIを使用してベアメタルサーバーを再初期化するには、ibmcloud is bare-metal-server-initialization-replace 指示。

ibmcloud is bare-metal-server-initialization-replace SERVER --image IMAGE ---keys KEYS --user-data DATA [--default-trusted-profile DEFAULT_TRUSTED_PROFILE [--default-trusted-profile-auto-link true]]

ベアメタルサーバーを再初期化するときに使用する以下の変数を指定します。

• SERVER ベアメタルサーバーの名前を指定します。
• IMAGE はオペレーティング・システム・イメージを指定する。
• KEYS はSSHキーを指定する。
• DATA は任意のユーザーデータを指定する。
• PROFILE 信頼されたプロファイルの ID、名前、または CRN。
• DEFAULT_TRUSTED_PROFILE は、デフォルトの信頼済みプロファイル自動リンクパラメータを変更します。

default_trusted_profileを使用する場合、ベアメタルサーバーの再初期化には、default_trusted_profileに定義されたものと同じauto_linkパラメータが含まれ、再初期化プロセスの一環として信頼済みプロファイルをベアメタルサーバーにリンクするかどうかを決定します。 再初期化プロセスの前にベアメタルサーバーにリンクされていた信頼済みプロファイルは、リンクされたままです。 再初期化プロセスでは、IAM信頼済みプロファイルへのリンクは削除されない。 信頼済みプロファイルがベアメタルサーバーにリンクされたままにならないようにするには、"auto_link "パラメーターをfalseに変更します。

コマンドオプションの完全なリストについては、 ibmcloud はベアメタルサーバーの初期化の置き換えです。

CLI を使用したベアメタル・サーバーの削除

CLI を使用してベアメタルサーバーを削除するには、ibmcloud is bare-metal-server-delete コマンドを使用します。 ベアメタルサーバーのIDまたは名前を SERVER 変数で指定します。

ibmcloud is bare-metal-server-delete SERVER

削除アクションは、サーバーとそのインスタンスに接続している vNIC、ブート・ボリューム、データをアカウントから永久に削除します。

コマンド・オプションの完全なリストについては、 ibmcloud is bare-metal-server-delete を参照してください。

API を使用してベアメタルサーバーの容量を確認する

API を使用してベアメタルサーバーの容量を確認するには、 GET /bare_metal_server/capacities を使用してください。 このコマンドによって返される情報はあくまで参考用であり、容量の割り当ては行われません。 容量情報が表示され、利用可能なノードのみが含まれます。 他の場所に割り当てられているノードや、その他の理由で利用できないノードは、容量情報に含まれません。

必要に応じて、 profile.name プロパティでベアメタルサーバーのプロファイルを指定したり、 zone.name プロパティでゾーンを指定したり、あるいはその両方を指定して、結果をフィルタリングすることができます。

curl -X GET "$vpc_api_endpoint/v1/bare_metal_server/capacities?version=2026-05-05&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d "zone.name=us-south-1" \
-d "profile.name=myprofile"

ベアメタルサーバーの容量をフィルタリングするために使用するプロパティの値を、以下のように指定してください。

• profile.name: コレクションを、 profile.name プロパティが指定されたプロファイル名と一致するリソースに絞り込みます。
• zone.name: コレクションを、 zone.name プロパティの値が指定された名前と完全に一致するリソースに絞り込みます。

以下の出力例をご覧ください：

Profile Name  Availability Zones
profile-1     us-south-1,us-south-3
profile-2     us-south-2,us-south-3

APIリクエストの詳細については、「 ベアメタルサーバーの容量一覧 」を参照してください

API を使用してベアメタルサーバーを再初期化する

APIを使用してベアメタルサーバーを再初期化するには、ベアメタルサーバー初期化 を使用します。

サーバーが停止され、ローカル ストレージがプロビジョニングされている場合にのみ、サーバーを再初期化できます。 または、サーバーの状態が failed ライフサイクル状態のステータス理由は cannot_reinitialize。 ベアメタル サーバーが再初期化されると、ブート ディスクの内容が消去され、指定されたオペレーティング システムがインストールされます。 サーバーは同じ物理ノード、インターフェース、IP アドレス、およびリソース ID を保持します。 セカンダリドライブ上のデータは保存されます。

指定する PUT /bare_metal_servers/{id}/initialization ベアメタル サーバーの再初期化を要求します。

curl -X PUT "$vpc_api_endpoint/v1/bare_metal_servers/$bare_metal_server_id/initialization?version=2021-03-09&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
	  "image": {
		"id": $image
	  },
	  "keys": [
		{
			"id": $key
		}
	  ],
	  "default_trusted_profile": {
		"auto_link": true,
		"target": {
			"id": $trusted_profile
		}
	  }
}'

ベアメタルサーバーを再初期化するときに使用する以下のプロパティ値を指定します。

• name ベアメタルサーバーの名前を指定します
• image オペレーティングシステムイメージを指定します
• keys SSHキーを指定する
• user_data オプションのユーザーデータを指定します
• default_trusted_profile デフォルトの信頼できるプロファイルを変更または削除する

default_trusted_profile を使用する場合、ベアメタルサーバーの再初期化には、 default_trusted_profile に定義されているのと同じ "auto_link" パラメーターが含まれ、再初期化プロセスの一環として信頼済みプロファイルをベアメタルサーバーにリンクするかどうかを決定します。 再初期化プロセスの前にベアメタルサーバーにリンクされていた信頼済みプロファイルは、リンクされたままです。 再初期化プロセスでは、IAM信頼済みプロファイルへのリンクは削除されない。 信頼済みプロファイルがベアメタルサーバーにリンクされたままにならないようにするには、 "auto_link" パラメータを false に変更します。

Terraformを使ってベアメタルサーバーを表示する

Terraformを使ってベアメタルサーバーを表示するには、ibm_is_bare_metal_server リソースを使います。

data "ibm_is_bare_metal_server" "example" {
  identifier        = "9328-9849-9849-9849"
}

詳細は ibm_is_bare_metal_server を参照してください。

すべてのベアメタルサーバーのリストを表示するには、ibm_is_bare_metal_servers リソースを使用します。

data "ibm_is_bare_metal_servers" "example" {
}

詳細は、ibm_is_bare_metal_servers を参照してください。

Terraformを使ったベアメタルサーバーの再起動

Terraformを使ってベアメタルサーバーを再起動するには、ibm_is_bare_metal_server_action リソースを使う必要があります。

resource "ibm_is_bare_metal_server_action" "bms_action" {
  bare_metal_server = SERVER
  action            = "restart"
}

ベアメタルサーバーを再初期化するときに使用する以下の変数を指定します。

• SERVER ベアメタルサーバーの名前を指定します
• restart はサーバーのアクションを指定します

コマンドオプションの完全なリストは、ibm_is_bare_metal_server_action を参照してください。

Terraformを使ったベアメタルサーバーの停止と起動

Terraformを使ってベアメタルサーバーを停止するには、ibm_is_bare_metal_server_action リソースを使う必要があります。

resource "ibm_is_bare_metal_server_action" "bms_action" {
  bare_metal_server = SERVER
  action            = "stop"
  stop_type         = "hard"
}

Terraformを使ってベアメタルサーバーを起動するには、ibm_is_bare_metal_server_action リソースを使う必要があります。

resource "ibm_is_bare_metal_server_action" "bms_action" {
  bare_metal_server = SERVER
  action            = "stop"
  delete_type       = "hard"
}

ベアメタルサーバーを再初期化するときに使用する以下の変数を指定します。

• SERVER ベアメタルサーバーの名前を指定します
• stop または start はサーバーのアクションを指定します
• hard はサーバーの停止に特有で、停止のタイプを示します。 hard を指定すると直ちにサーバーを停止し、soft を指定するとオペレーティングシステムをシャットダウンする。

コマンドオプションの完全なリストは、ibm_is_bare_metal_server_action を参照してください。

Terraformを使ったベアメタルサーバーの再初期化

サーバーが停止され、ローカル ストレージがプロビジョニングされている場合にのみ、サーバーを再初期化できます。 または、サーバーの状態が failed ライフサイクル状態のステータス理由は cannot_reinitialize。 ベアメタル サーバーが再初期化されると、ブート ディスクの内容が消去され、指定されたオペレーティング システムがインストールされます。 サーバーは同じ物理ノード、インターフェース、IP アドレス、およびリソース ID を保持します。 セカンダリドライブ上のデータは保存されます。

Terraformを使ってベアメタルサーバーを再初期化するには、リソースコマンド ibm_is_bare_metal_server_initialization を使う必要がある。

resource "ibm_is_bare_metal_server_initialization" "reinitialize" {
  bare_metal_server = SERVER
  user_data         = DATA
  keys              = KEYS
  image             = "IMAGE"
  default_trusted_profile {
      auto_link = true
      target {
          id = "Profile-a2075c9d-c69f-404f-8488-7962a383059c"
      }
  }
}

ベアメタルサーバーを再初期化するときに使用する以下の変数を指定します。

• SERVER ベアメタルサーバーの名前を指定します
• DATA オプションのユーザーデータを指定します
• KEYS SSHキーを指定する
• IMAGE オペレーティングシステムイメージを指定します
• Default Trusted Profile 自動リンクが有効かどうかを指定する

同じ物理ノード、インターフェイス、IPアドレス、リソースIDを保持することもできますが、lifecycle プロパティを使用することで、これらの変更を避けることもできます。

コマンドオプションの完全なリストは、ibm_is_bare_metal_server_initialization を参照してください。

resource "ibm_is_bare_metal_server_initialization" "reinitialize" {
  bare_metal_server = SERVER
  user_data         = DATA
  keys              = KEYS
  image             = "IMAGE"
}
## to avoid changes on the ibm_is_bare_metal_server resource, use lifecycle meta argument ignore_changes
resource "ibm_is_bare_metal_server" "bms" {
  ....
  lifecycle{
    ignore_changes = [ image, keys, user_data ]
  }
}

Terraform を使用してベアメタルサーバーを削除する

Terraformを使ってベアメタルサーバーのリソースを削除するには、ibm_is_bare_metal_server リソースを使う必要があります。

resource "ibm_is_bare_metal" "server" {
  delete_type          = "hard"
}

ベアメタルサーバーを削除する際に使用する以下の変数を指定します。

• hard は、サーバーを直ちに停止して削除する hard 削除を指定します。 もうひとつのオプションは soft deleteで、これはオペレーティングシステムをシャットダウンする。

コマンドオプションの完全なリストは、ibm_is_bare_metal_server を参照してください。