Bare Metal Servers für VPC verwalten

Sie können Ihren IBM Cloud® unter Bare Metal Servers for VPC verwalten, indem Sie Aufgaben wie Starten, Stoppen, Aktualisieren der Firmware, Neustarten, Neuinitialisieren und Löschen des Bare-Metal-Servers ausführen.

Sie können die folgenden Aktionen über die Benutzeroberfläche, die Befehlszeilenschnittstelle und die API ausführen.

Verfügbare Aktionen für Bare-Metal-Server
Aktion Beschreibung
Stoppen

Stoppen Sie den Server mit einem Soft-Stopp oder einem Hard-Stopp.

  • Ein Soft-Stopp kann je nach Zustand des Betriebssystems einige Sekunden bis zu mehreren Minuten dauern, um den Server herunterzufahren. Wenn das Betriebssystem nicht reagiert und der Soft-Stopp nicht abgeschlossen werden kann, ist ein Hard-Stopp erforderlich.
  • Hard-Stopp schaltet den Bare-Metal-Server sofort ab. Diese Methode verhindert, dass das Betriebssystem ordnungsgemäß heruntergefahren werden kann.
Starten Starten Sie einen gestoppten Server. Diese Aktion ist nicht verfügbar, wenn der Status Wird ausgeführt lautet.
Firmware aktualisieren Wenn der Server angehalten ist und ein Firmware-Update verfügbar ist, wird diese Option angezeigt.

Wenn Sie sich für die Aktualisierung der Firmware entscheiden, wird eine Meldung angezeigt, die Ihnen weitere Details zur Firmware-Aktualisierung liefert. Sie können den Server starten, wenn die Aktualisierung abgeschlossen ist. Diese Option ist standardmäßig ausgewählt.

Sie können wählen, ob Sie mit dem Firmware-Update fortfahren oder den Vorgang abbrechen möchten.
Wichtig: Es wird empfohlen, vor jedem Firmware-Update eine Sicherungskopie Ihres Servers zu erstellen.

Neu starten Schaltet einen laufenden Server sofort aus und anschließend wieder ein.
Reinitialisieren Sie können den Server nur neu initialisieren, wenn er gestoppt ist. Oder Sie können den Server neu initialisieren, wenn der Serverstatus failed und der Lebenszyklusstatus hat den Statusgrund cannot_reinitialize. Wenn der Bare-Metal-Server neu initialisiert wird, wird der Inhalt der Startdiskette gelöscht und das angegebene Betriebssystem installiert. Der Server behält denselben physischen Knoten, dieselben Schnittstellen, IP-Adressen und Ressourcen-IDs. Daten auf sekundären Laufwerken bleiben erhalten.
Löschen Um einen Server zu löschen, muss der Server ausgeschaltet sein. Wenn der Server über eine variable IP-Adresse verfügt, muss die Zuordnung für diese aufgehoben oder diese freigegeben werden, bevor der Server gelöscht wird. Mit der Löschaktion werden ein Server und der verbundene vNIC, der Bootdatenträger und die Daten permanent aus Ihrem Konto entfernt.

Um Ihre Bare-Metal-Server zu verwalten, benötigen Sie eine IAM-Rolle, die die folgenden Aktionen umfasst. Weitere Informationen finden Sie unter IAM-Zugriff für VPC-Infrastrukturservices verwalten.

  • is.bare-metal-server.bare-metal-server.list
  • is.bare-metal-server.bare-metal-server.read
  • is.bare-metal-server.bare-metal-server.delete
  • is.bare-metal-server.bare-metal-server.update
  • is.bare-metal-server.bare-metal-server.operate
  • is.key.key.operate
  • is.image.image.operate
  • is.bare-metal-server.bare-metal-server-firmware.update (erforderlich zum Aktualisieren der Firmware)
  • is.bare-metal-server.initialization.update (erforderlich, um den Server neu zu initialisieren)

Bare-Metal-Server über die Benutzerschnittstelle verwalten

Sie können einen Bare-Metal-Server auf der Seite Bare-Metal-Server in der IBM Cloud-Konsole anzeigen und verwalten.

Führen Sie die folgenden Schritte aus, um die Server zu verwalten.

  1. Gehen Sie im IBM Cloud-Dashboard zum Navigationsmenü-Symbol > Symbol Infrastruktur VPC > Compute > Bare-Metal-Server.
  2. Klicken Sie auf der Seite Bare Metal Servers auf das Symbol ‚Aktionen‘ Symbol für weitere Aktionen für den Server, den Sie verwalten wollen. Sie können die folgenden Aktionen ausführen:

Anzeigen Ihrer Bare-Metal-Server über die Benutzeroberfläche

Sie können die Zusammenfassung aller Bare-Metal-Server auf der Seite mit den Bare-Metal-Servern anzeigen oder auf einen Servernamen klicken, um Details anzuzeigen und Änderungen vorzunehmen. Auf der Detailseite können Sie außerdem die zugehörige Netzwerkschnittstelle anzeigen, auf ihr Subnetz zugreifen, die Netzwerkbandbreite auf Sapphire Rapids-Servern ändern und eine Floating-IP-Adresse reservieren oder löschen.

Die anpassbare Netzwerkbandbreite für Bare-Metal-Server von Sapphire Rapids ist nur im Süden der USA (Dallas) verfügbar.

  1. Gehen Sie in der IBM Cloud-Konsole zum Navigationsmenü-Symbol > Infrastruktur-VPC-Symbol > Compute > Bare-Metal-Server
  2. Klicken Sie auf den Namen des Bare-Metal-Servers, den Sie anzeigen möchten.

Firmware für einen Bare-Metal-Server über die Benutzerschnittstelle aktualisieren

Diese Aktion wird nur angezeigt, wenn der Server gestoppt wurde und ein Firmware-Update verfügbar ist. Es wird empfohlen, vor jedem Firmware-Update eine Sicherungskopie Ihres Servers zu erstellen.

  1. Gehen Sie in der IBM Cloud-Konsole zum Navigationsmenü-Symbol > Infrastruktur-VPC-Symbol > Compute > Bare-Metal-Server

  2. Klicken Sie auf den Namen des Bare-Metal-Servers, den Sie neu starten wollen.

  3. Klicken Sie auf Aktionen ... und anschließend auf Firmware aktualisieren.

    Sie erhalten die folgende Nachricht, wenn Sie die Aktualisierung der Firmware auswählen.

    Mit dieser Option werden die BIOS- und BMC-Firmware auf Ihrem Server aktualisiert. Sichern Sie Ihren Server, bevor Sie fortfahren. Der Server wird angehalten und ist während des Vorgangs nicht verfügbar.

Server nach Abschluss der Aktualisierung starten ist standardmäßig ausgewählt. Entfernen Sie die Markierung, wenn der Server nicht erneut gestartet werden soll.

  1. Klicken Sie auf Fortfahren, um das Firmware-Update zu starten. Klicken Sie auf Abbrechen, um die Aktualisierung abzubrechen.

Neustart eines Bare-Metal-Servers über die Benutzeroberfläche

Die Aktion für den Neustart schaltet den Bare-Metal-Server sofort aus und wieder ein.

  1. Im Dashboard IBM Cloud Symbol für externe Links, zum Navigationsmenü- Symbol > Infrastruktur- VPC-Symbol > Compute > Bare-Metal-Server
  2. Klicken Sie auf den Namen des Bare-Metal-Servers, den Sie neu starten wollen.
  3. Klicken Sie auf Aktionen... und dann auf Warmstart.

Bare-Metal-Server über die Benutzerschnittstelle stoppen und starten

  1. Gehen Sie in der IBM Cloud-Konsole zum Navigationsmenü-Symbol > Infrastruktur-VPC-Symbol > Compute > Bare-Metal-Server
  2. Klicken Sie auf den Namen des Bare-Metal-Servers, den Sie starten oder stoppen möchten.
  3. Klicken Sie auf Aktionen... und dann auf Stoppen oder Starten. Wenn Sie Stopp wählen, können Sie zwischen hartem und weichem Stopp wählen. Die Instanz wird standardmäßig sanft gestoppt.

Die Abrechnung wird fortgesetzt, nachdem der Bare-Metal-Server gestoppt wurde.

Neuinitialisierung eines Bare-Metal-Servers über die Benutzeroberfläche

Sie können den Server nur erneut initialisieren, wenn er angehalten und mit lokalem Speicher ausgestattet ist. Oder Sie können den Server neu initialisieren, wenn der Serverstatus failed und der Lebenszyklusstatus hat den Statusgrund cannot_reinitialize. Wenn der Bare-Metal-Server neu initialisiert wird, wird der Inhalt der Startdiskette gelöscht und das angegebene Betriebssystem installiert. Der Server behält denselben physischen Knoten, dieselben Schnittstellen, IP-Adressen und Ressourcen-IDs. Daten auf sekundären Laufwerken bleiben erhalten.

  1. Gehen Sie in der IBM Cloud-Konsole zum Navigationsmenü-Symbol > Infrastruktur-VPC-Symbol > Compute > Bare-Metal-Server

  2. Klicken Sie auf den Namen des Bare-Metal-Servers, den Sie neu initialisieren möchten.

  3. Klicken Sie auf Aktionen… und anschließend auf Neu initialisieren.

Löschen eines Bare-Metal-Servers über die Benutzeroberfläche

  1. Gehen Sie in der IBM Cloud-Konsole zum Navigationsmenü-Symbol > Infrastruktur-VPC-Symbol > Compute > Bare-Metal-Server
  2. Klicken Sie auf den Namen des Bare-Metal-Servers, den Sie löschen wollen.
  3. Klicken Sie auf Aktionen... und anschließend auf Löschen.

Mit der Löschaktion werden ein Server und der verbundene vNIC, der Bootdatenträger und die Daten permanent aus Ihrem Konto entfernt.

Hinzufügen von CSPM in der Konsole

Wenn Sie diese Option wählen, wird ein Bare-Metal-Server für den Workload-Schutz mit den Konfigurationen erstellt, die CSPM für alle Ressourcen bereitstellen. Wenn bereits ein Workload-Schutz-Bare-Metal-Server vorhanden ist, ist diese Option nicht verfügbar. Weitere Informationen finden Sie unter IBM Cloud Security Posture Management(CSPM).

  1. Gehen Sie in der IBM Cloud-Konsole zum Navigationsmenü- Symbol > Infrastruktur-VPC-Symbol > Compute > Bare-Metal-Server.
  2. Klicken Sie auf den Namen des Bare-Metal-Servers, zu dem Sie CSPM hinzufügen möchten.
  3. Wechseln Sie auf der Detailseite zur Registerkarte Integrationen.
  4. Klicken Sie unter Cloud Security Posture Management auf Add CSPM.
  5. Klicken Sie im Fenster Cloud Security Posture Management (CSPM) hinzufügen auf Erstellen.

Diese Einstellung fügt CSPM zu einer vorhandenen Workload Protection-Instanz für Ihr Konto hinzu. Weitere Informationen finden Sie unter Implementierung von CSPM(Cloud Security Posture Management)für IBM Cloud.

Bare-Metal-Server über die Befehlszeilenschnittstelle verwalten

Anzeigen Ihrer Bare-Metal-Server mithilfe der CLI

Verwenden Sie den Befehl ibmcloud is bare-metal-servers, um alle Bare-Metal-Server über die Befehlszeilenschnittstelle aufzulisten. Um einen bestimmten Bare-Metal-Server abzurufen, geben Sie die ID oder den Namen des Bare-Metal-Servers mit der Variablen SERVER an.

ibmcloud is bare-metal-server SERVER

Eine vollständige Liste der Befehlsoptionen finden Sie unter ibmcloud is bare-metal-server.

Neustart eines Bare-Metal-Servers über die Befehlszeilenschnittstelle (CLI)

Um Ihren Bare Metal Server über die CLI neu zu starten, verwenden Sie den Befehl ibmcloud is bare-metal-server-restart. Geben Sie die ID oder den Namen des Bare-Metal-Servers mit der Variablen SERVER an.

ibmcloud is bare-metal-server-restart SERVER

Das Flag [-f, --force] gibt an, dass die Operation ohne Bestätigung erzwungen wird.

Bare-Metal-Server über die Befehlszeilenschnittstelle stoppen und starten

Um Ihren Bare Metal Server über die CLI zu stoppen und zu starten, verwenden Sie den Befehl ibmcloud is bare-metal-server-stop oder ibmcloud is bare-metal-server-start. Geben Sie die ID oder den Namen des Bare-Metal-Servers mit der Variablen SERVER an.

Sie müssen type für die Stoppaktion in den Datennutzdaten angeben. soft weist das aktive Betriebssystem an, ordnungsgemäß zu stoppen und herunterzufahren. hard stoppt den Bare-Metal-Server sofort.

Um den Bare-Metal-Server anzuhalten, verwenden Sie den folgenden Befehl.

ibmcloud is bare-metal-server-stop SERVER --type soft

Um den Bare-Metal-Server zu starten, verwenden Sie den folgenden Befehl.

ibmcloud is bare-metal-server-start SERVER

Die Abrechnung läuft auch nach dem Stillstand des Bare-Metal-Servers weiter.

Eine vollständige Liste der Befehlsoptionen finden Sie unter ibmcloud is bare-metal-server-restart.

Anzeigen der Kapazität von Bare-Metal-Servern mithilfe der CLI

Um die Kapazität von Bare-Metal-Servern über die CLI anzuzeigen, verwenden Sie den Befehl ibmcloud is bare-metal-server-capacities. Die mit diesem Befehl zurückgegebenen Informationen dienen lediglich zu Informationszwecken und führen nicht zur Zuweisung von Kapazitäten. Es werden Kapazitätsinformationen angezeigt, die ausschließlich die verfügbaren Knoten umfassen. Knoten, die anderweitig zugewiesen sind oder aus anderen Gründen nicht verfügbar sind, werden in den Kapazitätsangaben nicht berücksichtigt.

Optional können Sie die Ergebnisse filtern, indem Sie mit der --profile Option ein Bare-Metal-Server-Profil, mit der --zone Option eine Zone oder beides angeben.

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

Bei der Verwendung des Befehls ibmcloud is bare-metal-server-capacities stehen Ihnen die folgenden Optionen zur Verfügung.

  • --profile Gibt den Namen eines vorhandenen Bare-Metal-Profils an.
  • --zone Gibt den Namen einer Zone an, zum Beispiel us-south-2.
  • --output Gibt das Ausgabeformat an. Nur JSON wird unterstützt.
  • -q, --quiet Unterdrückt ausführliche Ausgaben.

Siehe das folgende Ausgabebeispiel:

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

Aktualisieren eines Bare-Metal-Servers mithilfe der CLI

Um Ihren Bare-Metal-Server über die CLI zu aktualisieren, verwenden Sie den Befehl ibmcloud is bare-metal-server-update.

Geben Sie die folgenden Variablen an, die bei der Neuinitialisierung des Bare-Metal-Servers verwendet werden sollen.

  • SERVER Gibt den Namen des Bare-Metal-Servers an
  • NAME ID, Name oder CRN des vertrauenswürdigen Profils
  • METADATA die Angabe von true oder false aktiviert oder deaktiviert den Metadatendienst
  • PROTOCOL gibt an, welches Protokoll für den Metadatendienst verwendet werden soll.
ibmcloud is bare-metal-server-update SERVER --name NAME --enable-secure-boot true --metadata-service true --metadata-service-protocol https

Eine vollständige Liste der Befehlsoptionen finden Sie unter ibmcloud is bare-metal-server-update.

Neuinitialisierung eines Bare-Metal-Servers über die CLI

Sie können den Server nur erneut initialisieren, wenn er angehalten und mit lokalem Speicher ausgestattet ist. Oder Sie können den Server neu initialisieren, wenn der Serverstatus failed und der Lebenszyklusstatus hat den Statusgrund cannot_reinitialize. Wenn der Bare-Metal-Server neu initialisiert wird, wird der Inhalt der Startdiskette gelöscht und das angegebene Betriebssystem installiert. Der Server behält denselben physischen Knoten, dieselben Schnittstellen, IP-Adressen und Ressourcen-IDs. Daten auf sekundären Laufwerken bleiben erhalten.

Um einen Bare-Metal-Server über die CLI neu zu initialisieren, verwenden Sie den ibmcloud is bare-metal-server-initialization-replace Befehl.

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]]

Geben Sie die folgenden Variablen an, die bei der Neuinitialisierung des Bare-Metal-Servers verwendet werden sollen.

  • SERVER Gibt den Namen des Bare-Metal-Servers an.
  • IMAGE gibt das Image des Betriebssystems an.
  • KEYS gibt die SSH-Schlüssel an.
  • DATA gibt alle optionalen Benutzerdaten an.
  • PROFILE ID, Name oder CRN des vertrauenswürdigen Profils.
  • DEFAULT_TRUSTED_PROFILE ändert den Standardparameter für die automatische Verknüpfung vertrauenswürdiger Profile.

Wenn Sie ein default_trusted_profile verwenden, wird bei der Neuinitialisierung des Bare-Metal-Servers derselbe auto_link-Parameter verwendet, der für das default_trusted_profile definiert wurde, um zu bestimmen, ob das vertrauenswürdige Profil mit dem Bare-Metal-Server als Teil des Neuinitialisierungsprozesses verknüpft wird. Vertrauenswürdige Profile, die vor der Neuinitialisierung mit dem Bare Metal Server verknüpft waren, bleiben verknüpft. Bei der Neuinitialisierung wird die Verknüpfung mit vertrauenswürdigen IAM-Profilen nicht entfernt. Um zu verhindern, dass das vertrauenswürdige Profil mit dem Bare-Metal-Server verknüpft bleibt, ändern Sie den Parameter "auto_link" in false.

Eine vollständige Liste der Befehlsoptionen finden Sie unter ibmcloud ist Bare-Metal-Server-Initialisierung-Ersetzen.

Firmware für einen Bare-Metal-Server über die Befehlszeilenschnittstelle aktualisieren

Sie können die Firmware für Ihre Bare-Metal-Server über die Befehlszeilenschnittstelle (CLI) aktualisieren. Sie können die Firmware nur auf einem Bare-Metal-Server aktualisieren, der angehalten wurde und für den Firmware-Updates verfügbar sind. Es wird empfohlen, vor jedem Firmware-Update eine Sicherungskopie Ihres Servers zu erstellen.

Verwenden Sie den Befehl ibmcloud is bare-metal-server-firmware-update, um die Firmware für den Bare-Metal-Server über die Befehlszeilenschnittstelle zu aktualisieren. Geben Sie die ID oder den Namen des Bare Metal Servers mit der Variablen SERVER an.

Der Standardwert für auto-start ist true. Wenn der Bare-Metal-Server nicht gestartet werden soll, nachdem die Firmware aktualisiert wurde, müssen Sie diesen Wert in false ändern.

ibmcloud is bare-metal-server-firmware-update SERVER --auto-start true

Nach der Eingabe dieses Befehls erhalten Sie eine Meldung, in der Sie gefragt werden, ob Sie mit der Aktualisierung der Firmware fortfahren möchten.

Mit dieser Option wird die BIOS- und BMC-Firmware auf Ihrem Server aktualisiert. Erstellen Sie ein Backup des Servers, bevor Sie fortfahren. Der Server ist während des Vorgangs nicht verfügbar. Fortfahren (j/n)?

Eine vollständige Liste der Befehlsoptionen enthält ibmcloud is bare-metal-server-firmware-update.

Bare-Metal-Server über die Befehlszeilenschnittstelle löschen

Um Ihren Bare Metal Server über die CLI zu löschen, verwenden Sie den Befehl ibmcloud is bare-metal-server-delete. Geben Sie die ID oder den Namen des Bare Metal Servers mit der Variablen SERVER an.

ibmcloud is bare-metal-server-delete SERVER

Mit der Löschaktion werden ein Server und der verbundene vNIC, der Bootdatenträger und die Daten permanent aus Ihrem Konto entfernt.

Eine vollständige Liste der Befehlsoptionen finden Sie unter ibmcloud is bare-metal-server-delete.

Bare-Metal-Server über die API verwalten

Anzeigen Ihrer Bare-Metal-Server mithilfe der API

Verwenden Sie Alle Bare-Metal-Server auflisten, um alle Bare-Metal-Server mithilfe der API aufzulisten.

Geben Sie eine Anforderung GET /bare_metal_servers an, um alle Bare-Metal-Server aufzulisten.

curl -X GET "$vpc_api_endpoint/v1/bare_metal_servers?version=2021-03-09&generation=2" \
-H "Authorization: Bearer $iam_token"

Abrufen eines Bare-Metal-Servers mithilfe der API

Um einen Bare-Metal-Server über die API abzurufen, verwenden Sie Abrufen eines Bare-Metal-Servers.

Geben Sie eine GET /bare_metal_servers/{id}-Anfrage an, um einen bestimmten Bare-Metal-Server abzurufen, wobei id der Bezeichner des Bare-Metal-Servers ist, den Sie abrufen.

curl -X GET "$vpc_api_endpoint/v1/bare_metal_servers/$bare_metal_server_id?version=2021-03-09&generation=2" \
-H "Authorization: Bearer $iam_token"

Weitere Informationen zu den API-Anforderungen finden Sie unter Alle Bare-Metal-Server auflisten und Bare-Metal-Server abrufen.

Anzeigen der Kapazität von Bare-Metal-Servern mithilfe der API

Um die Kapazität von Bare-Metal-Servern über die API abzurufen, verwenden Sie GET /bare_metal_server/capacities. Die mit diesem Befehl zurückgegebenen Informationen dienen lediglich zu Informationszwecken und führen nicht zur Zuweisung von Kapazitäten. Es werden Kapazitätsinformationen angezeigt, die ausschließlich die verfügbaren Knoten umfassen. Knoten, die anderweitig zugewiesen sind oder aus anderen Gründen nicht verfügbar sind, werden in den Kapazitätsangaben nicht berücksichtigt.

Optional können Sie die Ergebnisse filtern, indem Sie ein Bare-Metal-Server-Profil mit der Eigenschaft profile.name, eine Zone mit der Eigenschaft zone.name oder beides angeben.

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"

Geben Sie die folgenden Eigenschaftswerte an, um die Kapazitäten der Bare-Metal-Server zu filtern.

  • profile.name: Filtert die Sammlung nach Ressourcen, deren Eigenschaft profile.name mit dem angegebenen Profilnamen übereinstimmt.
  • zone.name: Filtert die Sammlung nach Ressourcen, deren Eigenschaft zone.name genau dem angegebenen Namen entspricht.

Siehe das folgende Ausgabebeispiel:

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

Weitere Informationen zu den API-Anfragen finden Sie unter Kapazitäten für Bare-Metal-Server auflisten

Neustart des Bare-Metal-Servers mithilfe der API

Um einen Bare Metal Server über die API neu zu starten, verwenden Sie Neustart eines Bare Metal Servers.

Geben Sie eine POST /bare_metal_servers/{id}/restart-Anfrage an, um einen bestimmten Bare-Metal-Server neu zu starten, wobei id die Kennung des Bare-Metal-Servers ist, den Sie neu starten.

curl -X POST "$vpc_api_endpoint/v1/bare_metal_servers/$bare_metal_server_id/restart?version=2021-03-09&generation=2" \
-H "Authorization: Bearer $iam_token"

Weitere Informationen zur API-Anforderung finden Sie unter Bare-Metal-Server erneut starten.

Bare-Metal-Server über die API stoppen und starten

Um einen Bare Metal Server über die API anzuhalten oder zu starten, verwenden Sie Bare Metal Server anhalten und Bare Metal Server starten.

Verwenden Sie für das Stoppen oder Starten eines Bare-Metal-Servers die folgende API-Anforderung:

Den Bare-Metal-Server mithilfe der API anhalten

Geben Sie eine POST /bare_metal_servers/{id}/stop-Anfrage an, um einen bestimmten Bare-Metal-Server zu stoppen, wobei id die Kennung des Bare-Metal-Servers ist, den Sie stoppen möchten.

Sie müssen type für die Stoppaktion in den Datennutzdaten angeben. soft weist das aktive Betriebssystem an, ordnungsgemäß zu stoppen und herunterzufahren. hard stoppt den Bare-Metal-Server sofort.

curl -X POST "$vpc_api_endpoint/v1/bare_metal_servers/$bare_metal_server_id/stop?version=2021-03-09&generation=2" \
-H "Authorization: Bearer $iam_token"
-d '{
        "type": "soft"
}'

Die Abrechnung wird fortgesetzt, nachdem der Bare-Metal-Server gestoppt wurde.

Weitere Informationen zur API-Anforderung finden Sie unter Bare-Metal-Server stoppen.

Starten des Bare-Metal-Servers mithilfe der API

Geben Sie eine POST /bare_metal_servers/{id}/start-Anfrage an, um einen bestimmten Bare-Metal-Server zu starten, wobei id die Kennung des Bare-Metal-Servers ist, den Sie starten.

curl -X POST "$vpc_api_endpoint/v1/bare_metal_servers/$bare_metal_server_id/start?version=2021-03-09&generation=2" \
-H "Authorization: Bearer $iam_token"

Weitere Informationen zur API-Anforderung finden Sie unter Bare-Metal-Server starten.

Aktualisieren eines Bare-Metal-Servers mithilfe der API

Geben Sie eine PATCH /bare_metal_servers/{id} Anfrage zur Aktualisierung eines bestimmten Bare-Metal-Servers an, wobei id die Kennung des zu aktualisierenden Bare-Metal-Servers ist.

curl -X PATCH "$vpc_api_endpoint/v1/bare_metal_servers/$bare_metal_server_id?version=2025-05-13&generation=2" -H "Authorization: Bearer $iam_token" -d '{
  "name": "my-bare-metal-server-updated"
  "metadata_service": {
     "enabled": true,
     "protocol": "https"
  }
}'

Geben Sie die folgenden Eigenschaftswerte an, die bei der Aktualisierung des Bare-Metal-Servers verwendet werden sollen.

  • name Gibt den Namen des Bare-Metal-Servers an
  • metadata_service gibt an, ob der Dienst aktiviert ist und welches Protokoll verwendet werden soll.

Weitere Informationen zur API-Anfrage finden Sie unter Bare-Metal-Server aktualisieren.

Neuinitialisierung eines Bare-Metal-Servers mithilfe der API

Um Ihren Bare Metal Server über die API neu zu initialisieren, verwenden Sie Bare Metal Server Initialisierung.

Sie können den Server nur erneut initialisieren, wenn er angehalten und mit lokalem Speicher ausgestattet ist. Oder Sie können den Server neu initialisieren, wenn der Serverstatus failed und der Lebenszyklusstatus hat den Statusgrund cannot_reinitialize. Wenn der Bare-Metal-Server neu initialisiert wird, wird der Inhalt der Startdiskette gelöscht und das angegebene Betriebssystem installiert. Der Server behält denselben physischen Knoten, dieselben Schnittstellen, IP-Adressen und Ressourcen-IDs. Daten auf sekundären Laufwerken bleiben erhalten.

Geben Sie einen PUT /bare_metal_servers/{id}/initialization Anforderung zur Neuinitialisierung des Bare-Metal-Servers.

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
		}
	  }
}'

Geben Sie die folgenden Eigenschaftswerte an, die bei der Neuinitialisierung des Bare-Metal-Servers verwendet werden sollen.

  • name Gibt den Namen des Bare-Metal-Servers an
  • image gibt das Betriebssystem-Image an
  • keys gibt die SSH-Schlüssel an
  • user_data Gibt alle optionalen Benutzerdaten an
  • default_trusted_profile ändert oder entfernt das standardmäßige vertrauenswürdige Profil

Wenn Sie default_trusted_profile verwenden, wird bei der Neuinitialisierung des Bare-Metal-Servers derselbe Parameter "auto_link" verwendet, der für default_trusted_profile definiert ist, um zu bestimmen, ob das vertrauenswürdige Profil mit dem Bare-Metal-Server als Teil des Neuinitialisierungsprozesses verknüpft wird. Vertrauenswürdige Profile, die vor der Neuinitialisierung mit dem Bare Metal Server verknüpft waren, bleiben verknüpft. Bei der Neuinitialisierung wird die Verknüpfung mit vertrauenswürdigen IAM-Profilen nicht entfernt. Um zu verhindern, dass das vertrauenswürdige Profil mit dem Bare-Metal-Server verknüpft bleibt, ändern Sie den Parameter "auto_link" in false.

Firmware für einen Bare-Metal-Server über die API aktualisieren

Sie können die Firmware nur auf einem Bare-Metal-Server aktualisieren, der angehalten wurde und für den Firmware-Updates verfügbar sind. Es wird empfohlen, eine Sicherungskopie Ihres Servers zu erstellen, bevor Sie die Firmware aktualisieren. Um die Firmware über die API zu aktualisieren, verwenden Sie Firmware für einen Bare Metal Server aktualisieren.

Geben Sie eine Anfrage an POST /bare_metal_servers/{id}/firmware/update, um die Firmware für einen bestimmten Bare-Metal-Server zu aktualisieren, wobei id die Kennung des Bare-Metal-Servers ist, den Sie aktualisieren.

Der Standardwert für auto_start ist true. Wenn Sie nicht möchten, dass der Bare-Metal-Server nach dem Firmware-Update gestartet wird, müssen Sie diesen Wert auf false ändern.

curl -X POST "$vpc_api_endpoint/v1/bare_metal_servers/$bare_metal_server_id/firmware/update?version=$tomorrow&generation=2&maturity=beta" -H "Authorization: Bearer $iam_token" -d '{
  "auto_start": false
}'

Bare-Metal-Server über die API löschen

Um einen Bare Metal Server über die API zu löschen, verwenden Sie Löschen eines Bare Metal Servers.

Geben Sie eine DELETE /bare_metal_servers/{id}-Anfrage zum Löschen eines bestimmten Bare-Metal-Servers an, wobei id die Kennung des zu löschenden Bare-Metal-Servers ist.

curl -X DELETE "$vpc_api_endpoint/v1/bare_metal_servers/$bare_metal_server_id?version=2021-03-09&generation=2" \
-H "Authorization: Bearer $iam_token"

Mit der Löschaktion werden ein Server und der verbundene vNIC, der Bootdatenträger und die Daten permanent aus Ihrem Konto entfernt.

Verwaltung von Bare-Metal-Servern mit Terraform

Stellen Sie sicher, dass Sie Terraform for VPC eingerichtet haben.

Ansicht Ihrer Bare-Metal-Server mithilfe von Terraform

Um einen Bare-Metal-Server über Terraform anzuzeigen, verwenden Sie die Ressource ibm_is_bare_metal_server.

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

Weitere Informationen finden Sie unter ibm_is_bare_metal_server.

Um eine Liste aller Bare-Metal-Server anzuzeigen, verwenden Sie die Ressource ibm_is_bare_metal_servers.

data "ibm_is_bare_metal_servers" "example" {
}

Weitere Informationen finden Sie unter ibm_is_bare_metal_servers.

Neustart eines Bare-Metal-Servers mithilfe von Terraform

Um einen Bare-Metal-Server mithilfe von Terraform neu zu starten, müssen Sie die ibm_is_bare_metal_server_action-Ressource verwenden.

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

Geben Sie die folgenden Variablen an, die bei der Neuinitialisierung des Bare-Metal-Servers verwendet werden sollen.

  • SERVER Gibt den Namen des Bare-Metal-Servers an
  • restart gibt die Aktion für den Server an

Eine vollständige Liste der Befehlsoptionen finden Sie unter ibm_is_bare_metal_server_action.

Stoppen und Starten eines Bare-Metal-Servers mit Terraform

Um einen Bare Metal Server mit Terraform zu stoppen, müssen Sie die ibm_is_bare_metal_server_action Ressource verwenden.

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

Um einen Bare Metal Server mit Terraform zu starten, müssen Sie die ibm_is_bare_metal_server_action Ressource verwenden.

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

Geben Sie die folgenden Variablen an, die bei der Neuinitialisierung des Bare-Metal-Servers verwendet werden sollen.

  • SERVER Gibt den Namen des Bare-Metal-Servers an
  • stop oder start gibt die Aktion für den Server an
  • hard ist spezifisch für das Anhalten des Servers und gibt die Art des Anhaltens an. Die Angabe von hard hält den Server sofort an und soft fährt das Betriebssystem herunter.

Eine vollständige Liste der Befehlsoptionen finden Sie unter ibm_is_bare_metal_server_action.

Reinitialisierung eines Bare-Metal-Servers mit Terraform

Sie können den Server nur erneut initialisieren, wenn er angehalten und mit lokalem Speicher ausgestattet ist. Oder Sie können den Server neu initialisieren, wenn der Serverstatus failed und der Lebenszyklusstatus hat den Statusgrund cannot_reinitialize. Wenn der Bare-Metal-Server neu initialisiert wird, wird der Inhalt der Startdiskette gelöscht und das angegebene Betriebssystem installiert. Der Server behält denselben physischen Knoten, dieselben Schnittstellen, IP-Adressen und Ressourcen-IDs. Daten auf sekundären Laufwerken bleiben erhalten.

Um einen Bare-Metal-Server mithilfe von Terraform neu zu initialisieren, müssen Sie den Ressourcenbefehl ibm_is_bare_metal_server_initialization verwenden.

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"
      }
  }
}

Geben Sie die folgenden Variablen an, die bei der Neuinitialisierung des Bare-Metal-Servers verwendet werden sollen.

  • SERVER Gibt den Namen des Bare-Metal-Servers an
  • DATA Gibt alle optionalen Benutzerdaten an
  • KEYS gibt die SSH-Schlüssel an
  • IMAGE gibt das Betriebssystem-Image an
  • Default Trusted Profile gibt an, ob die automatische Verknüpfung aktiviert ist

Sie können zwar denselben physischen Knoten, dieselben Schnittstellen, IP-Adressen und Ressourcen-IDs beibehalten, aber Sie können diese Änderungen auch vermeiden, indem Sie die Eigenschaft lifecycle verwenden.

Eine vollständige Liste der Befehlsoptionen finden Sie unter 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 ]
  }
}

Löschen eines Bare-Metal-Servers mit Terraform

Um eine Bare Metal Server Ressource mit Terraform zu löschen, müssen Sie die ibm_is_bare_metal_server Ressource verwenden.

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

Geben Sie die folgenden Variablen an, die beim Löschen des Bare-Metal-Servers verwendet werden sollen.

  • hard gibt ein hard Löschen an, das den Server sofort anhält und löscht. Die andere Option ist soft löschen, wodurch das Betriebssystem heruntergefahren wird.

Eine vollständige Liste der Befehlsoptionen finden Sie unter ibm_is_bare_metal_server.