시작하기 전에

1. API 환경을 설정했는지 확인하십시오. 자세한 정보는 API 및 CLI 환경 설정을 참조하십시오.

   API에 대해 자세히 알아보려면, IBM Cloud® 콘솔의 생성 페이지에서 ‘API 호출 예제 보기’를 클릭하세요. 올바른 API 요청 순서를 확인하고 작업 및 종속성을 보다 잘 이해할 수 있습니다.

2. 베어메탈 서버를 작성하기 전에 VPC 및 서브넷을 작성해야 합니다.

베어메탈 서버에 대한 정보 수집

API를 사용하여 베어 메탈 서버를 생성하기 전에, 다음 표에서 필요한 정보를 확인하십시오.

available, partially_available (아직 모든 영역에서 이미지를 사용할 수 없음) 또는 deprecated 이미지에서 베어메탈 서버를 프로비저닝할 수 있습니다. 이미지 라이프사이클에 대한 자세한 내용은 사용자 지정 이미지 라이프사이클을 참조하세요.

API를 사용하여 베어 메탈 서버 생성하기

모든 정보를 준비한 후, 베어 메탈 서버 생성 API 요청을 보내 베어 메탈 서버를 생성하십시오.

• x86 아키텍처의 경우, 다음 예시 구성을 사용하여 베어 메탈 서버를 생성할 수 있습니다

  • ESXi 이미지 ID: " r006-31c8ca90-2623-48d7-8cf7-737be6fc4c3e "
  • SSH 키 ID: "a6b1a881-2ce8-41a3-80fc-36316a73f803"
  • 베어메탈 서버의 이름: "my-bare-metal-server"
  • 다음 구성을 사용하는 기본 네트워크 인터페이스:
    • ID가 "4"인 VLAN이 연결할 수 있도록 허용함
    • 이름: "my-primary-network-interface"
    • 서브넷 ID: "7ec86020-1c6e-4889-b3f0-a15f2e50f87e"
  • ID가 "4"인 보조 VLAN 인터페이스. 이 VLAN 인터페이스는 부동 가능합니다.
  • 프로파일 이름: "bx2d-metal-192x768"
  • 구역: "us-south-1"
  • 메타데이터 서비스: 사용
  • 메타데이터 서비스 프로토콜: "https"

  API 요청은 다음과 유사합니다.

  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
  

  예제 요청에서는 JSON 처리 유틸리티 jq 를 사용하여 응답 형식을 지정합니다. jq 은 MIT 라이선스에 따라 라이선스가 부여된 타사 도구입니다. jq 베어 메탈 서버를 만들 때 사용 가능한 모든 VPC 이미지에 사전 설치되어 있지 않을 수 있습니다. 다른 파싱 도구를 사용하도록 명령어를 수정하거나, 서식이 적용되지 않은 응답을 받으려면 " | jq" 을 제거할 수 있습니다.

  다음 예시와 비슷한 응답이 표시됩니다:

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

서버가 생성될 때까지 상태는 “대기 중”으로 표시됩니다.

이 API 요청에 대한 자세한 정보는 베어메탈 서버 작성을 참조하십시오.

서버 보기

서버 상태가 "실행 중"으로 변경되면 다음 요청을 사용하여 확인하십시오.

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"

시작하기 전에

1. CLI 환경을 설정했는지 확인하십시오.
2. 베어메탈 서버를 작성하기 전에 VPC 및 서브넷을 작성해야 합니다.

자세한 정보는 CLI를 사용한 VPC 리소스 작성을 참조하십시오.

베어메탈 서버를 작성하기 위한 정보 수집

CLI를 사용하여 베어메탈 서버를 작성하려면 먼저 필요한 정보를 수집해야 합니다.

available, partially_available (아직 모든 영역에서 이미지를 사용할 수 없음) 또는 deprecated 이미지에서 베어메탈 서버를 프로비저닝할 수 있습니다. 이미지 라이프사이클에 대한 자세한 내용은 사용자 지정 이미지 라이프사이클을 참조하세요.

베어메탈 서버 작성

모든 정보가 준비되고 나면 CLI를 사용하여 베어메탈 서버를 작성할 수 있습니다.

예를 들어, 다음 구성을 사용하여 베어메탈 서버를 작성할 수 있습니다.

• x86 아키텍처의 경우:

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

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

  • 베어메탈 서버의 이름: "my-bare-metal-server"

  • 다음 구성을 사용하는 기본 네트워크 인터페이스:

    • 서버에 연결할 ID가 "4"인 VLAN
    • 이름: "my-primary-network-interface"
    • 서브넷 ID: "7ec86020-1c6e-4889-b3f0-a15f2e50f87e"

  • ID가 "4"인 보조 VLAN 인터페이스. 이 VLAN 인터페이스는 부동 가능합니다.

  • 프로파일 이름: "bx2d-metal-192x768"

  • 구역: "us-south-1"

  • 메타데이터: "true"

  • 프로토콜: "https"

  • 기본 신뢰할 수 있는 프로필 자동 링크: "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
  

서버 보기

서버 상태가 실행 중으로 변경되면 다음 명령을 사용하여 확인하십시오.

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