Vorbereitende Schritte

1. Stellen Sie sicher, dass Sie Ihre API-Umgebung eingerichtet haben. Weitere Information finden Sie unter API- und CLI-Umgebung einrichten.

   Um mehr über die API zu erfahren, klicken Sie auf den Link Beispiel-API-Aufruf abrufen auf den Erstellungsseiten in der IBM Cloud®-Konsole. Daraufhin wird die korrekte Abfolge der API-Anforderungen angezeigt, sodass Sie die ausgeführten Aktionen und deren Abhängigkeiten besser nachvollziehen können.

2. Erstellen Sie unbedingt eine VPC und ein Teilnetz, bevor Sie einen Bare-Metal-Server erstellen.

Informationen für den Bare-Metal-Server zusammenstellen

Bevor Sie die API zum Erstellen eines Bare-Metal-Servers verwenden, entnehmen Sie bitte der folgenden Tabelle die erforderlichen Informationen.

Sie können einen Bare Metal Server von einem available, partially_available (Image ist noch nicht in allen Zonen verfügbar) oder deprecated Image bereitstellen. Weitere Informationen zu Image-Lebenszyklen finden Sie unter Benutzerdefinierter Image-Lebenszyklus.

Erstellen eines Bare-Metal-Servers mit der API

Nachdem Sie alle Informationen zusammengestellt haben, senden Sie eine API-Anfrage zum Erstellen eines Bare-Metal-Servers, um einen Bare-Metal-Server zu erstellen.

• Für die x86-Architektur können Sie einen Bare-Metal-Server mit der folgenden Beispielkonfiguration erstellen:

  • ESXi-Image-ID: r006-31c8ca90-2623-48d7-8cf7-737be6fc4c3e
  • SSH-Schlüssel-ID: "a6b1a881-2ce8-41a3-80fc-36316a73f803"
  • Name des Bare-Metal-Servers: "my-bare-metal-server"
  • Primäre Netzschnittstelle mit den folgenden Konfigurationen:
    • Zuordnung von VLAN mit der ID '4' zulässig
    • Name: "my-primary-network-interface"
    • Teilnetz-ID: "7ec86020-1c6e-4889-b3f0-a15f2e50f87e"
  • Sekundäre VLAN-Schnittstelle mit der ID '4' VLAN-Schnittstelle ist variabel
  • Profilname: "bx2d-metal-192x768"
  • Zone: "us-south-1"
  • Metadatendienst: aktiviert
  • Protokoll des Metadatendienstes: "https"

  Die API-Anforderung hierfür sieht in etwa so aus:

  curl -X POST "$vpc_api_endpoint/v1/bare_metal_servers?version=2021-03-09&generation=2" \
  -H "Authorization: Bearer $iam_token" \
  -d '{
      "initialization": {
          "image": {
          "id": "r006-31c8ca90-2623-48d7-8cf7-737be6fc4c3e"
          },
          "keys": [
          {"id": "a6b1a881-2ce8-41a3-80fc-36316a73f803"}
          ]
          "default_trusted_profile": {
             "auto_link": true,
             "target": {
             "crn": "crn:v1:bluemix:public:iam-identity::a/aa2432b1fa4d4ace891e9b80fc104e34::profile:Profile-e9001353-12e5-41b7-a6bb-11de58dcbfea"
          }
        }
      },
      "primary_network_interface": {
          "interface_type": "pci",
          "name": "my-primary-network-interface",
          "subnet": {
          "id": "7ec86020-1c6e-4889-b3f0-a15f2e50f87e"
          },
          "allowed_vlans": [4]
      },
      "network_interfaces":[
         {
          "interface_type": "vlan",
          "name": "my-vlan-interface",
          "allow_interface_to_float": true,
          "subnet": {
          "id": "2302-6d5fe694-12f7-4161-b979-21bb4e872696"
           },
          "vlan": 4
         }
      ],
       "name": "my-bare-metal-server",
       "profile": {
           "name": "bx2d-metal-192x768"
       "metadata_service": {
        "enabled": true,
        "protocol": "https"
     }
       },
       "zone": {
           "name": "us-south-1"
       }
     }' | jq
  

  Die Beispielanforderung verwendet das JSON-Verarbeitungsprogramm jq, um die Antwort zu formatieren. jq ist ein Drittanbieter-Tool, das unter der MIT-Lizenz lizenziert ist. jq ist möglicherweise nicht auf allen VPC-Images vorinstalliert, die bei der Erstellung eines Bare-Metal-Servers verfügbar sind. Sie können den Befehl so anpassen, dass ein anderes Parsing-Tool verwendet wird, oder entfernen, um " | jq" eine unformatierte Antwort zu erhalten.

  Sie sehen eine Antwort, die dem folgenden Beispiel ähnelt:

  "bandwidth": 100000,
  "boot_target": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/bare_metal_servers/2302-5e095b83-ceb4-49b5-9699-0aa5a2c996a4/disks/2302-3744f199-6ccc-4698-8772-bb3937348c96",
    "id": "2302-3744f199-6ccc-4698-8772-bb3937348c96",
    "name": "zipfile-delude-slang-knoll",
    "resource_type": "bare_metal_server_disk"
  },
  "cpu": {
    "architecture": "amd64",
    "core_count": 96,
    "socket_count": 4,
    "threads_per_core": 2
  },
  "created_at": "2021-03-12T09:29:17.000Z",
  "crn": "crn:[...]",
  "disks": [
    {
      "allowed_use": {
        "api_version": "2025-03-31",
        "bare_metal_server": "true"
      },
      "created_at": "2021-03-12T09:29:17.000Z",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/bare_metal_servers/2302-5e095b83-ceb4-49b5-9699-0aa5a2c996a4/disks/2302-3744f199-6ccc-4698-8772-bb3937348c96",
      "id": "2302-3744f199-6ccc-4698-8772-bb3937348c96",
      "interface_type": "sata",
      "name": "zipfile-delude-slang-knoll",
      "resource_type": "bare_metal_server_disk",
      "size": 960
    },
    {
      "created_at": "2021-03-12T09:29:17.000Z",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/bare_metal_servers/2302-5e095b83-ceb4-49b5-9699-0aa5a2c996a4/disks/2302-86003aba-47db-4d07-bd76-62e00cca83e5",
      "id": "2302-86003aba-47db-4d07-bd76-62e00cca83e5",
      "interface_type": "nvme",
      "name": "elderly-mountain-trout-opponent",
      "resource_type": "bare_metal_server_disk",
      "size": 3200
    },
    {
      "created_at": "2021-03-12T09:29:17.000Z",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/bare_metal_servers/2302-5e095b83-ceb4-49b5-9699-0aa5a2c996a4/disks/2302-8372237f-77cb-47e4-9c61-b9d19ddfdbcd",
      "id": "2302-8372237f-77cb-47e4-9c61-b9d19ddfdbcd",
      "interface_type": "nvme",
      "name": "could-kilt-twisty-unloaded",
      "resource_type": "bare_metal_server_disk",
      "size": 3200
    },
    {
      "created_at": "2021-03-12T09:29:17.000Z",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/bare_metal_servers/2302-5e095b83-ceb4-49b5-9699-0aa5a2c996a4/disks/2302-e544d72d-ca08-4924-b748-a8f67b66286d",
      "id": "2302-e544d72d-ca08-4924-b748-a8f67b66286d",
      "interface_type": "nvme",
      "name": "wildcat-impromptu-dribble-hesitate",
      "resource_type": "bare_metal_server_disk",
      "size": 3200
    },
    {
      "created_at": "2021-03-12T09:29:17.000Z",
      "href": "us-south.iaas.cloud.ibm.com/v1/bare_metal_servers/2302-5e095b83-ceb4-49b5-9699-0aa5a2c996a4/disks/2302-de34647b-e7fb-405b-85af-d28c6dfe142c",
      "id": "2302-de34647b-e7fb-405b-85af-d28c6dfe142c",
      "interface_type": "nvme",
      "name": "imperfect-stimulate-culpable-thumb",
      "resource_type": "bare_metal_server_disk",
      "size": 3200
    }
  ],
  "enable_secure_boot": false,
  "href": "https://us-south.iaas.cloud.ibm.com/v1/bare_metal_servers/2302-5e095b83-ceb4-49b5-9699-0aa5a2c996a4",
  "id": "2302-5e095b83-ceb4-49b5-9699-0aa5a2c996a4",
  "memory": 768,
  "name": "my-bare-metal-server",
  "network_interfaces": [
    {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/bare_metal_servers/2302-5e095b83-ceb4-49b5-9699-0aa5a2c996a4/network_interfaces/2302-c094c123-5c82-49a2-8bb7-847bd3a7b62d",
      "id": "2302-c094c123-5c82-49a2-8bb7-847bd3a7b62d",
      "name": "my-primary-network-interface",
      "primary_ipv4_address": "10.240.128.5",
      "resource_type": "network_interface",
      "subnet": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/2302-6d5fe694-12f7-4161-b979-21bb4e872696",
        "id": "7ec86020-1c6e-4889-b3f0-a15f2e50f87e",
        "name": "my-subnet"
      }
    },
    {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/bare_metal_servers/2302-5e095b83-ceb4-49b5-9699-0aa5a2c996a4/network_interfaces/2302-edd97be7-588e-4f0b-a875-7e0bec68f767",
      "id": "2302-edd97be7-588e-4f0b-a875-7e0bec68f767",
      "name": "my-vlan-interface",
      "primary_ipv4_address": "",
      "resource_type": "network_interface",
      "subnet": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/2302-6d5fe694-12f7-4161-b979-21bb4e872696",
        "id": "7ec86020-1c6e-4889-b3f0-a15f2e50f87e",
        "name": "my-subnet"
      }
    }
  ],
  "primary_network_interface": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/bare_metal_servers/2302-5e095b83-ceb4-49b5-9699-0aa5a2c996a4/network_interfaces/2302-c094c123-5c82-49a2-8bb7-847bd3a7b62d",
    "id": "2302-c094c123-5c82-49a2-8bb7-847bd3a7b62d",
    "name": "my-primary-network-interface",
    "primary_ipv4_address": "10.240.128.5",
    "resource_type": "network_interface",
    "subnet": {
      "crn": "crn:[...]",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/2302-6d5fe694-12f7-4161-b979-21bb4e872696",
      "id": "7ec86020-1c6e-4889-b3f0-a15f2e50f87e",
      "name": "my-subnet"
    }
  },
  "profile": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/bare_metal_server/profiles/bx2d-metal-192x768",
    "name": "bx2d-metal-192x768"
  },
  "resource_group": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/resource_groups/823edda102129f3232a0dc0655fcff94",
    "id": "823edda102129f3232a0dc0655fcff94",
    "name": "Default"
  },
  "resource_type": "bare_metal_server",
  "status": "pending",
  "status_reasons": [],
  "trusted_platform_module": {
    "enabled": false,
    "mode": ""
  },
  "vpc": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/r006-96cb322a-6a59-4ac4-8783-1f059f87e4a9",
    "id": "r006-96cb322a-6a59-4ac4-8783-1f059f87e4a9",
    "name": "my-vpc"
  },
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1"
  }
  

Der Status wird als Ausstehend angezeigt, bis der Server erstellt ist.

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

Server anzeigen

Wenn sich der Serverstatus in „Aktiv“ ändert, verwenden Sie die folgende Anforderung, um den Server anzuzeigen.

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"

Vorbereitende Schritte

1. Stellen Sie sicher, dass Sie Ihre CLI-Umgebung eingerichtet haben.
2. Erstellen Sie unbedingt eine VPC und ein Teilnetz, bevor Sie einen Bare-Metal-Server erstellen.

Weitere Informationen finden Sie im Abschnitt VPC-Ressource verwenden mithilfe der Befehlszeilenschnittstelle erstellen.

Informationen zum Erstellen eines Bare-Metal-Servers zusammenstellen

Bevor Sie einen Bare-Metal-Server mit der Befehlszeilenschnittstelle erstellen können, müssen Sie die benötigten Informationen zusammenstellen.

Sie können einen Bare Metal Server von einem available, partially_available (Image ist noch nicht in allen Zonen verfügbar) oder deprecated Image bereitstellen. Weitere Informationen zu Image-Lebenszyklen finden Sie unter Benutzerdefinierter Image-Lebenszyklus.

Bare-Metal-Server erstellen

Sobald Sie alle Informationen zur Hand haben, können Sie einen Bare-Metal-Server über die Befehlszeilenschnittstelle erstellen.

Beispielsweise können Sie einen Bare-Metal-Server mit der folgenden Konfiguration erstellen:

• x86-Architektur:

  • ESXi-Image-ID: r006-31c8ca90-2623-48d7-8cf7-737be6fc4c3e

  • SSH-Schlüssel-ID: "a6b1a881-2ce8-41a3-80fc-36316a73f803"

  • Name des Bare-Metal-Servers: "my-bare-metal-server"

  • Primäre Netzschnittstelle mit den folgenden Konfigurationen:

    • VLAN mit der ID „4“ für den Anschluss an den Server
    • Name: "my-primary-network-interface"
    • Teilnetz-ID: "7ec86020-1c6e-4889-b3f0-a15f2e50f87e"

  • Sekundäre VLAN-Schnittstelle mit der ID '4' VLAN-Schnittstelle ist variabel

  • Profilname: "bx2d-metal-192x768"

  • Zone: "us-south-1"

  • Metadaten: "true"

  • Protokoll: "https"

  • Standardmäßig vertrauenswürdiges Profil autolink: "wahr"

  ibmcloud is bare-metal-server-create --name my-bare-metal-server --zone us-south-1 --profile mx2-metal-96x768 --image r006-31c8ca90-2623-48d7-8cf7-737be6fc4c3e --keys a6b1a881-2ce8-41a3-80fc-36316a73f803 --metadata-service true --metadata-service-protocol https --default-trusted-profile default-trusted-profile-name --default-trusted-profile-auto-link true --pnic-subnet 7ec86020-1c6e-4889-b3f0-a15f2e50f87e –pnic-name my-primary-network-interface --pnic-allowed-vlans 4 --network-interfaces '[{"name": "my-vlan-interface", "interface_type": "vlan", "vlan": 4, "allow_interface_to_float": true, "subnet": {"id":"7ec86020-1c6e-4889-b3f0-a15f2e50f87e"}}]' --output JSON
  

Server anzeigen

Wenn sich der Serverstatus in Aktiv ändert, können Sie ihn mit folgendem Befehl anzeigen.

ibmcloud is bare-metal-server $bare_metal_server_id --output JSON