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.
| Aktion | Beschreibung |
|---|---|
| Stoppen |
Stoppen Sie den Server mit einem Soft-Stopp oder einem Hard-Stopp.
|
| 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. |
| 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.
- Gehen Sie im IBM Cloud-Dashboard zum Navigationsmenü
>
VPC > Compute > Bare-Metal-Server.
- Klicken Sie auf der Seite Bare Metal Servers auf das Symbol ‚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.
- Gehen Sie in der IBM Cloud-Konsole zum Navigationsmenü
> Infrastruktur
> Compute > Bare-Metal-Server
- 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.
-
Gehen Sie in der IBM Cloud-Konsole zum Navigationsmenü
> Infrastruktur
> Compute > Bare-Metal-Server
-
Klicken Sie auf den Namen des Bare-Metal-Servers, den Sie neu starten wollen.
-
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.
- 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.
- Im Dashboard IBM Cloud
, zum Navigationsmenü-
> Infrastruktur-
> Compute > Bare-Metal-Server
- Klicken Sie auf den Namen des Bare-Metal-Servers, den Sie neu starten wollen.
- Klicken Sie auf Aktionen... und dann auf Warmstart.
Bare-Metal-Server über die Benutzerschnittstelle stoppen und starten
- Gehen Sie in der IBM Cloud-Konsole zum Navigationsmenü
> Infrastruktur
> Compute > Bare-Metal-Server
- Klicken Sie auf den Namen des Bare-Metal-Servers, den Sie starten oder stoppen möchten.
- 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.
-
Gehen Sie in der IBM Cloud-Konsole zum Navigationsmenü
> Infrastruktur
> Compute > Bare-Metal-Server
-
Klicken Sie auf den Namen des Bare-Metal-Servers, den Sie neu initialisieren möchten.
-
Klicken Sie auf Aktionen… und anschließend auf Neu initialisieren.
Löschen eines Bare-Metal-Servers über die Benutzeroberfläche
- Gehen Sie in der IBM Cloud-Konsole zum Navigationsmenü
> Infrastruktur
> Compute > Bare-Metal-Server
- Klicken Sie auf den Namen des Bare-Metal-Servers, den Sie löschen wollen.
- 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).
- Gehen Sie in der IBM Cloud-Konsole zum Navigationsmenü
Symbol > Infrastruktur
> Compute > Bare-Metal-Server.
- Klicken Sie auf den Namen des Bare-Metal-Servers, zu dem Sie CSPM hinzufügen möchten.
- Wechseln Sie auf der Detailseite zur Registerkarte Integrationen.
- Klicken Sie unter Cloud Security Posture Management auf Add CSPM.
- 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.
--profileGibt den Namen eines vorhandenen Bare-Metal-Profils an.--zoneGibt den Namen einer Zone an, zum Beispielus-south-2.--outputGibt das Ausgabeformat an. NurJSONwird unterstützt.-q, --quietUnterdrü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.
SERVERGibt den Namen des Bare-Metal-Servers anNAMEID, Name oder CRN des vertrauenswürdigen ProfilsMETADATAdie Angabe vontrueoderfalseaktiviert oder deaktiviert den MetadatendienstPROTOCOLgibt 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.
SERVERGibt den Namen des Bare-Metal-Servers an.IMAGEgibt das Image des Betriebssystems an.KEYSgibt die SSH-Schlüssel an.DATAgibt alle optionalen Benutzerdaten an.PROFILEID, 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.
nameGibt den Namen des Bare-Metal-Servers anmetadata_servicegibt 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.
nameGibt den Namen des Bare-Metal-Servers animagegibt das Betriebssystem-Image ankeysgibt die SSH-Schlüssel anuser_dataGibt alle optionalen Benutzerdaten andefault_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.
SERVERGibt den Namen des Bare-Metal-Servers anrestartgibt 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.
SERVERGibt den Namen des Bare-Metal-Servers anstopoderstartgibt die Aktion für den Server anhardist spezifisch für das Anhalten des Servers und gibt die Art des Anhaltens an. Die Angabe vonhardhält den Server sofort an undsoftfä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.
SERVERGibt den Namen des Bare-Metal-Servers anDATAGibt alle optionalen Benutzerdaten anKEYSgibt die SSH-Schlüssel anIMAGEgibt das Betriebssystem-Image anDefault Trusted Profilegibt 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.
hardgibt einhardLöschen an, das den Server sofort anhält und löscht. Die andere Option istsoftlöschen, wodurch das Betriebssystem heruntergefahren wird.
Eine vollständige Liste der Befehlsoptionen finden Sie unter ibm_is_bare_metal_server.