Prima di iniziare

1. Assicurati di configurare il tuo ambiente API. Per ulteriori informazioni, vedi Configurazione del tuo ambiente API e CLI.

   Per saperne di più sull'API, fare clic su Ottieni una chiamata API di esempio nelle pagine di creazione della console IBM Cloud®. Puoi visualizzare la sequenza corretta di richieste API e comprendere meglio le azioni e le loro dipendenze.

2. Assicurati di creare un VPC e una sottorete prima di creare un server bare metal.

Raccolta di informazioni per il server bare metal

Prima di utilizzare l'API per creare un server bare metal, consulta la seguente tabella per le informazioni richieste.

È possibile eseguire il provisioning di un server bare metal da un'immagine available, partially_available (l'immagine non è ancora disponibile in tutte le zone) o deprecated. Per ulteriori informazioni sui cicli di vita delle immagini, vedere Ciclo di vita dell'immagine personalizzato.

Creazione di un server bare metal tramite l'API

Una volta raccolte tutte le informazioni, effettua una richiesta API "Crea server bare metal " per creare un server bare metal.

• Per l'architettura x86, puoi creare un server bare metal con la seguente configurazione di esempio:

  • ID immagine ESXi: "r006-31c8ca90-2623-48d7-8cf7-737be6fc4c3e"
  • ID chiave SSH: "a6b1a881-2ce8-41a3-80fc-36316a73f803"
  • Nome del server bare metal: "my-bare-metal-server"
  • Un'interfaccia di rete primaria con le configurazioni seguenti:
    • Consente a VLAN con l'ID "4" di essere collegato
    • Nome: "my - primary - network - interface"
    • ID sottorete:7ec86020-1c6e-4889-b3f0-a15f2e50f87e"
  • Un'interfaccia VLAN secondaria con ID "4". Questa interfaccia VLAN è mobile.
  • Nome profilo: "bx2d-metal-192x768"
  • Zona: " us-south-1 "
  • Servizio metadati: abilitato
  • Protocollo del servizio metadati: "https"

  La richiesta API è simile a:

  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
  

  La richiesta di esempio utilizza l'utilità di elaborazione JSON jq per formattare la risposta. jq è uno strumento di terze parti concesso in licenza MIT. jq potrebbe non essere preinstallato su tutte le immagini VPC disponibili quando si crea un server bare metal. È possibile modificare il comando per utilizzare un altro strumento di analisi o rimuovere " | jq" per ricevere una risposta non formattata.

  Viene visualizzata una risposta simile all'esempio seguente:

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

Lo stato rimane "In attesa" fino alla creazione del server.

Per ulteriori informazioni sulla richiesta API, consulta Crea un server bare metal.

Visualizzazione del server

Quando lo stato del server diventa "In esecuzione", utilizzare la seguente richiesta per visualizzarlo.

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"

Prima di iniziare

1. Assicurati di configurare il tuo ambiente CLI.
2. Assicurati di creare un VPC e una sottorete prima di creare un server bare metal.

Per ulteriori informazioni, consulta Utilizzo della CLI per creare le risorse VPC.

Raccolta di informazioni per la creazione di un server bare metal

Prima di poter usare la CLI per creare il server bare metal, devi raccogliere le informazioni necessarie.

È possibile eseguire il provisioning di un server bare metal da un'immagine available, partially_available (l'immagine non è ancora disponibile in tutte le zone) o deprecated. Per ulteriori informazioni sui cicli di vita delle immagini, vedere Ciclo di vita dell'immagine personalizzato.

Creazione di un server bare metal

Una volta pronte tutte le informazioni, puoi utilizzare la CLI per creare un server bare metal.

Ad esempio, puoi creare un server bare metal con la seguente configurazione:

• Per l'architettura x86:

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

  • ID chiave SSH: "a6b1a881-2ce8-41a3-80fc-36316a73f803"

  • Nome del server bare metal: "my-bare-metal-server"

  • Un'interfaccia di rete primaria con le configurazioni seguenti:

    • VLAN con l'ID "4" da collegare al server
    • Nome: "my - primary - network - interface"
    • ID sottorete:7ec86020-1c6e-4889-b3f0-a15f2e50f87e"

  • Un'interfaccia VLAN secondaria con ID "4". Questa interfaccia VLAN è mobile.

  • Nome profilo: "bx2d-metal-192x768"

  • Zona: " us-south-1 "

  • Metadati: "true"

  • Protocollo: "https"

  • Profilo attendibile predefinito autolink: "true"

  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
  

Visualizzazione del server

Quando lo stato del server viene modificato in In esecuzione, utilizzare il seguente comando per visualizzarlo.

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