Antes de Iniciar

1. Certifique-se de configurar o seu ambiente de API. Para obter mais informações, consulte Configurando o seu ambiente de API e CLI.

   Para saber mais sobre a API, clique em “Obter um exemplo de chamada de API” nas páginas de criação do console do IBM Cloud®. É possível visualizar a sequência correta de solicitações de API e entender melhor as ações e suas dependências.

2. Certifique-se de criar uma VPC e uma sub-rede antes de criar um servidor bare metal.

Reunindo informações para o servidor bare metal

Antes de usar a API para criar um servidor bare metal, consulte a tabela a seguir para obter as informações necessárias.

Você pode provisionar um servidor bare metal a partir de uma imagem available, partially_available (a imagem ainda não está disponível em todas as zonas) ou deprecated. Para obter mais informações sobre ciclos de vida de imagens, consulte Ciclo de vida de imagens personalizadas.

Criação de um servidor bare metal com a API

Depois de ter todas as informações, faça uma solicitação à API “Criar servidor bare metal” para criar um servidor bare metal.

• Para uma arquitetur x86, você pode criar um servidor bare metal com a seguinte configuração de exemplo:

  • ID da imagem do ESXi: " r006-31c8ca90-2623-48d7-8cf7-737be6fc4c3e "
  • ID de chave SSH: "a6b1a881-2ce8-41a3-80fc-36316a73f803"
  • Nome do servidor bare metal: "my-bare-metal-server"
  • Uma interface de rede primária com as configurações a seguir:
    • Permite que a VLAN com o ID de "4" seja anexada
    • Nome: "my-primary-network-interface"
    • ID de sub-rede: "7ec86020-1c6e-4889-b3f0-a15f2e50f87e"
  • Uma interface VLAN secundária com ID "4". Essa interface VLAN é flutuante.
  • Nome do perfil: "bx2d-metal-192x768"
  • Zona: "us-south-1"
  • Serviço de metadados: ativado
  • Protocolo de serviço de metadados: "https"

  A solicitação de API é semelhante 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
  

  A solicitação de exemplo usa o utilitário de processamento JSON jq para formatar a resposta. jq é uma ferramenta de terceiros licenciada sob a licença MIT. jq pode não vir pré-instalado em todas as imagens VPC disponíveis quando você cria um servidor bare metal. Você pode modificar o comando para usar outra ferramenta de análise ou remover " | jq" para receber uma resposta sem formatação.

  Você vê uma resposta semelhante ao exemplo a seguir:

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

O status fica como “Pendente” até que o servidor seja criado.

Para obter mais informações sobre a solicitação de API, consulte Criar um servidor bare metal.

Visualizando seu servidor

Quando o status do servidor mudar para "Em execução", use a solicitação a seguir para visualizá-lo.

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"

Antes de Iniciar

1. Certifique-se de configurar o seu ambiente CLI.
2. Certifique-se de criar uma VPC e uma sub-rede antes de criar um servidor bare metal.

Para obter mais informações, consulte Usando a CLI para criar recursos de VPC.

Reunindo informações para criar um servidor bare metal

Para poder usar a CLI para criar o servidor bare metal, deve-se reunir as informações que são necessárias.

Você pode provisionar um servidor bare metal a partir de uma imagem available, partially_available (a imagem ainda não está disponível em todas as zonas) ou deprecated. Para obter mais informações sobre ciclos de vida de imagens, consulte Ciclo de vida de imagens personalizadas.

Criando um servidor bare metal

Depois de ter todas as informações prontas, é possível usar a CLI para criar um servidor bare metal.

Por exemplo, é possível criar um servidor bare metal com a configuração a seguir:

• Para a arquitetura x86:

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

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

  • Nome do servidor bare metal: "my-bare-metal-server"

  • Uma interface de rede primária com as configurações a seguir:

    • VLAN com o ID de "4" para anexar ao servidor
    • Nome: "my-primary-network-interface"
    • ID de sub-rede: "7ec86020-1c6e-4889-b3f0-a15f2e50f87e"

  • Uma interface VLAN secundária com ID "4". Essa interface VLAN é flutuante.

  • Nome do perfil: "bx2d-metal-192x768"

  • Zona: "us-south-1"

  • Metadados: "true"

  • Protocolo: "https"

  • Autolink do perfil confiável padrão: "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
  

Visualizando seu servidor

Quando o status do servidor mudar para Em execução, use o comando a seguir para visualizá-lo.

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