Avant de commencer

1. Vérifiez que vous avez configuré votre environnement d'API. Pour plus d'informations, voir Configuration de votre environnement d'API et d'interface de ligne de commande.

   Pour en savoir plus sur l'API, cliquez sur Obtenir un exemple d'appel API dans les pages de création de la console d' IBM Cloud®. Vous pouvez afficher la séquence correcte des demandes d'API et mieux comprendre les actions et leurs dépendances.

2. Veillez à créer un VPC et un sous-réseau avant de créer un serveur bare metal.

Collecte d'informations pour le serveur bare metal

Avant d'utiliser l'API pour créer un serveur bare metal, consultez le tableau suivant pour connaître les informations requises.

Vous pouvez approvisionner un serveur bare metal à partir d'une image available, partially_available (l'image n'est pas encore disponible dans toutes les zones) ou deprecated. Pour plus d'informations sur les cycles de vie des images, voir Personnaliser le cycle de vie des images.

Création d'un serveur bare metal à l'aide de l'API

Une fois que vous disposez de toutes les informations nécessaires, effectuez une requête API Créer un serveur bare metal pour créer un serveur bare metal.

• Pour l'architecture x86, vous pouvez créer un serveur bare metal avec la configuration suivante à titre d'exemple :

  • ID de l'image ESXi : r006-31c8ca90-2623-48d7-8cf7-737be6fc4c3e
  • ID de clé SSH : "a6b1a881-2ce8-41a3-80fc-36316a73f803"
  • Nom du serveur bare metal : "my-bare-metal-server"
  • Une interface réseau principale avec les configurations suivantes :
    • Permet de connecter un VLAN avec l'ID "4"
    • Nom : "my-primary-network-interface"
    • ID de sous-réseau : "7ec86020-1c6e-4889-b3f0-a15f2e50f87e"
  • Une interface VLAN secondaire avec l'ID "4". Cette interface VLAN est flottante.
  • Nom de profil : "bx2d-metal-192x768"
  • Zone : "us-south-1"
  • Service de métadonnées : activé
  • Protocole du service de métadonnées : "https"

  La demande d'API est similaire à celle-ci :

  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 demande d'exemple utilise l'utilitaire de traitement JSON jq pour formater la réponse. jq est un outil tiers sous licence MIT. jq peut ne pas être préinstallé sur toutes les images VPC disponibles lorsque vous créez un serveur bare metal. Vous pouvez modifier la commande pour utiliser un autre outil d'analyse syntaxique ou supprimer " | jq" afin d'obtenir une réponse non formatée.

  Vous voyez s'afficher une réponse similaire à l'exemple suivant :

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

Le statut En attente s'affiche jusqu'à ce que le serveur soit créé.

Pour plus d'informations sur la demande d'API, voir Créer un serveur bare metal.

Affichage de votre serveur

Lorsque le statut du serveur devient « En cours d'exécution », utilisez la demande suivante pour l'afficher.

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"

Avant de commencer

1. Assurez-vous que vous avez configuré votre environnement CLI.
2. Veillez à créer un VPC et un sous-réseau avant de créer un serveur bare metal.

Pour plus d'informations, voir Utilisation de l'interface de ligne de commande pour créer des ressources VPC.

Collecte d'informations pour créer un serveurbare metal

Pour pouvoir utiliser l'interface de ligne de commande afin de créer un serveur bare metal, vous devez rassembler les informations nécessaires.

Vous pouvez approvisionner un serveur bare metal à partir d'une image available, partially_available (l'image n'est pas encore disponible dans toutes les zones) ou deprecated. Pour plus d'informations sur les cycles de vie des images, voir Personnaliser le cycle de vie des images.

Création d'un serveur bare metal

Une fois que toutes les informations sont prêtes, vous pouvez utiliser l'interface de ligne de commande pour créer un serveur bare metal.

Par exemple, vous pouvez créer un serveur bare metal avec la configuration suivante :

• Pour l'architecture x86:

  • ID de l'image ESXi : r006-31c8ca90-2623-48d7-8cf7-737be6fc4c3e

  • ID de clé SSH : "a6b1a881-2ce8-41a3-80fc-36316a73f803"

  • Nom du serveur bare metal : "my-bare-metal-server"

  • Une interface réseau principale avec les configurations suivantes :

    • VLAN avec l'ID « 4 » à connecter au serveur
    • Nom : "my-primary-network-interface"
    • ID de sous-réseau : "7ec86020-1c6e-4889-b3f0-a15f2e50f87e"

  • Une interface VLAN secondaire avec l'ID "4". Cette interface VLAN est flottante.

  • Nom de profil : "bx2d-metal-192x768"

  • Zone : "us-south-1"

  • Métadonnées : "true"

  • Protocole : "https"

  • Profil de confiance par défaut 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
  

Affichage de votre serveur

Lorsque le statut du serveur devient En cours d'exécution, utilisez la commande suivante pour l'afficher.

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