Bare Metal Servers for VPC 관리

IBM Cloud® ( Bare Metal Servers for VPC )을 관리하려면 서버 시작, 중지, 펌웨어 업데이트, 재부팅, 재초기화, 베어 메탈 서버 삭제 등의 작업을 수행할 수 있습니다.

UI, CLI 및 API를 사용하여 다음 작업을 완료할 수 있습니다.

베어메탈 서버에 사용할 수 있는 작업
조치 설명
중지

소프트 정지 또는 하드 정지를 사용하여 서버를 중지합니다.

  • 소프트 정지는 운영 체제의 상태에 따라 서버를 종료하는 데 몇 초에서 몇 분 정도 걸릴 수 있습니다. 운영 체제가 응답하지 않고 소프트 스톱을 완료할 수 없는 경우 하드 스톱이 필요합니다.
  • 하드 스톱은 베어메탈 서버를 즉시 종료합니다. 이 방법은 운영 체제가 정상적으로 종료되는 것을 방지합니다.
시작 중지된 서버를 시작하십시오. 상태가 ‘실행 중 ’인 경우 이 작업을 수행할 수 없습니다.
펌웨어 업데이트 서버가 중지된 상태에서 펌웨어 업데이트가 가능한 경우, 이 옵션이 표시됩니다.

펌웨어 업데이트를 선택하면, 펌웨어 업데이트에 대한 추가 정보가 담긴 안내 메시지가 표시됩니다. 업데이트가 완료되면 서버를 시작할 수 있습니다. 이 옵션은 기본적으로 선택됩니다.

펌웨어 업데이트를 계속할지, 아니면 취소할지 선택할 수 있습니다.
중요: 펌웨어 업데이트를 진행하기 전에 서버를 백업하는 것이 좋습니다.

재부트 실행 중인 서버의 전원을 즉시 껐다가 다시 켭니다.
재초기화 서버가 중지된 경우에만 서버를 다시 초기화할 수 있습니다. 또는 서버 상태가 다음과 같은 경우 다시 초기화할 수 있습니다.failed 수명 주기 상태의 상태 이유는 다음과 같습니다.cannot_reinitialize. 베어메탈 서버가 다시 초기화되면 부팅 디스크의 내용이 지워지고 지정된 운영 체제가 설치됩니다. 서버는 동일한 물리적 노드, 인터페이스, IP 주소 및 리소스 ID를 유지합니다. 보조 드라이브의 데이터는 보존됩니다.
삭제 서버를 삭제하려면 서버의 전원을 꺼야 합니다. 서버에 유동 IP 주소가 있는 경우 서버가 삭제되기 전에 유동 IP 주소가 연관되지 않거나 릴리스되어야 합니다. 삭제 조치는 서버 및 연결된 vNIC, 부트 볼륨, 데이터를 사용자 계정에서 영구적으로 제거합니다.

베어 메탈 서버를 관리하려면 다음 작업이 포함된 IAM 역할이 필요합니다. 자세한 정보는 VPC 인프라 서비스에 대한 IAM 액세스 관리 를 참조하십시오.

  • is.bare-metal-server.bare-metal-server.list
  • is.bare-metal-server.bare-metal-server.read
  • is.bare-metal-server.bare-metal-server.delete
  • is.bare-metal-server.bare-metal-server.update
  • is.bare-metal-server.bare-metal-server.operate
  • is.key.key.operate
  • is.image.image.operate
  • is.bare-metal-server.bare-metal-server-firmware.update (펌웨어 업데이트에 필요)
  • is.bare-metal-server.initialization.update (서버를 다시 초기화하는 데 필요)

UI를 사용하여 베어메탈 서버 관리

IBM Cloud 콘솔의 ‘ 베어 메탈 서버 ’ 페이지에서 베어 메탈 서버를 확인하고 관리할 수 있습니다.

서버를 관리하려면 다음 단계를 완료하십시오.

  1. IBM Cloud 대시보드 에서 탐색 메뉴 아이콘메뉴 아이콘 > 인프라 VPC 아이콘 > 컴퓨팅 > 베어메탈 서버 으로 이동합니다.
  2. 베어메탈 서버 페이지에서 관리할 서버에 대한 조치 아이콘 추가 조치 아이콘을 클릭하십시오. 다음과 같은 작업을 수행할 수 있습니다:

UI를 사용하여 베어 메탈 서버 확인하기

베어메탈 서버 페이지에서 모든 베어메탈 서버의 요약을 볼 수 있으며 개별 서버 이름을 클릭하여 세부사항을 보고 변경할 수 있습니다. 세부사항 페이지에서 연관된 네트워크 인터페이스를 보고, 해당 서브넷에 액세스하고, Sapphire Rapids 서버에서 네트워크 대역폭을 변경하고, 부동 IP 주소를 예약하거나 삭제할 수도 있습니다.

사파이어 래피즈 베어메탈 서버의 조정 가능한 네트워크 대역폭은 미국 남부 (댈러스) 에서만 사용 가능합니다.

  1. IBM Cloud 콘솔 에서 ‘ 탐색 메뉴 ’ 아이콘으로 이동하세요. 메뉴 아이콘 > 인프라 VPC 아이콘 > 컴퓨팅 > 베어메탈 서버
  2. 볼 베어메탈 서버의 이름을 클릭하십시오.

UI를 사용하여 베어메탈 서버의 펌웨어 업데이트

이 조치는 서버가 중지되고 펌웨어 업데이트가 사용 가능한 경우에만 표시됩니다. 펌웨어를 업데이트하기 전에 서버를 백업해 두는 것이 좋습니다.

  1. IBM Cloud 콘솔 에서 ‘ 탐색 메뉴 ’ 아이콘으로 이동하세요. 메뉴 아이콘 > 인프라 VPC 아이콘 > 컴퓨팅 > 베어메탈 서버

  2. 재부팅할 베어메탈 서버의 이름을 클릭하십시오.

  3. 조치 ... 를 클릭한 후 펌웨어 업데이트를 클릭하십시오.

    펌웨어를 업데이트하도록 선택하면 다음 메시지가 수신됩니다.

    이 옵션은 서버의 BIOS 및 BMC 펌웨어를 업데이트합니다. 계속하기 전에 서버를 백업하십시오. 프로세스 중에 서버가 중지되어 사용할 수 없습니다.

업데이트 완료 후 서버 시작이 기본적으로 선택되어 있습니다. 서버를 다시 시작하지 않으려면 확인을 제거하십시오.

  1. 진행 을 클릭하여 펌웨어 업데이트를 시작하십시오. 업데이트를 취소하려면 ‘취소’를 클릭하세요.

UI를 사용하여 베어 메탈 서버 재부팅하기

재부팅 조치는 베어메탈 서버의 전원을 즉시 끈 후 다시 켭니다.

  1. IBM Cloud 대시보드 외부 링크 아이콘 에서 ‘ 탐색 메뉴 ’ 아이콘으로 이동하세요. 메뉴 아이콘 > 인프라 VPC 아이콘 > 컴퓨팅 > 베어메탈 서버
  2. 재부팅할 베어메탈 서버의 이름을 클릭하십시오.
  3. **조치...**를 클릭한 후 다시 부팅을 클릭하십시오.

UI를 사용하여 베어메탈 서버 중지 및 시작

  1. IBM Cloud 콘솔 에서 ‘ 탐색 메뉴 ’ 아이콘으로 이동하세요. 메뉴 아이콘 > 인프라 VPC 아이콘 > 컴퓨팅 > 베어메탈 서버
  2. 시작 또는 중지할 베어메탈 서버의 이름을 클릭하십시오.
  3. **조치...**를 클릭한 후 중지 또는 시작을 클릭하십시오. 정지를 선택하면 하드 정지 또는 소프트 정지를 선택합니다. 인스턴스는 기본적으로 소프트 중지됩니다.

비용 청구는 베어메탈 서버가 중지된 후에도 계속됩니다.

UI를 사용하여 베어 메탈 서버를 재초기화합니다

서버가 중지되고 로컬 스토리지가 프로비저닝된 경우에만 서버를 다시 초기화할 수 있습니다. 또는 서버 상태가 다음과 같은 경우 다시 초기화할 수 있습니다.failed 수명 주기 상태의 상태 이유는 다음과 같습니다.cannot_reinitialize. 베어메탈 서버가 다시 초기화되면 부팅 디스크의 내용이 지워지고 지정된 운영 체제가 설치됩니다. 서버는 동일한 물리적 노드, 인터페이스, IP 주소 및 리소스 ID를 유지합니다. 보조 드라이브의 데이터는 보존됩니다.

  1. IBM Cloud 콘솔 에서 ‘ 탐색 메뉴 ’ 아이콘으로 이동하세요. 메뉴 아이콘 > 인프라 VPC 아이콘 > 컴퓨팅 > 베어메탈 서버

  2. 재초기화하려는 베어 메탈 서버의 이름을 클릭하십시오.

  3. '작업...'을 클릭한 다음, '재초기화'를 클릭합니다.

UI를 사용하여 베어 메탈 서버 삭제하기

  1. IBM Cloud 콘솔 에서 ‘ 탐색 메뉴 ’ 아이콘으로 이동하세요. 메뉴 아이콘 > 인프라 VPC 아이콘 > 컴퓨팅 > 베어메탈 서버
  2. 삭제할 베어메탈 서버의 이름을 클릭하십시오.
  3. **조치...**를 클릭한 후 삭제를 클릭하십시오.

삭제 조치는 서버 및 연결된 vNIC, 부트 볼륨, 데이터를 사용자 계정에서 영구적으로 제거합니다.

콘솔에서 CSPM 추가하기

이 옵션을 선택하면 모든 리소스에 CSPM을 제공하기 위한 구성으로 워크로드 보호 베어메탈 서버가 생성됩니다. 워크로드 보호 베어메탈 서버가 이미 존재하는 경우 이 옵션을 사용할 수 없습니다. 자세한 내용은 IBM Cloud Security Posture Management(CSPM )을 참조하세요.

  1. IBM Cloud 콘솔 에서 탐색 메뉴 아이콘 메뉴 아이콘 > 인프라 VPC 아이콘 > 컴퓨팅 > 베어메탈 서버 으로 이동합니다.
  2. CSPM을 추가하려는 베어 메탈 서버의 이름을 클릭하십시오.
  3. 세부 정보 페이지에서 연동 탭으로 이동합니다.
  4. 클라우드 보안 태세 관리에서 CSPM 추가를 클릭합니다.
  5. CSPM(클라우드 보안 태세 관리) 추가에서 만들기를 클릭합니다.

이 설정은 계정의 기존 워크로드 보호 인스턴스에 CSPM을 추가합니다. 자세한 내용은 IBM Cloud 에 대한 CSPM(클라우드 Security Posture Management)구현을 참조하세요.

CLI를 사용하여 베어메탈 서버 관리

CLI를 사용하여 베어 메탈 서버 확인하기

CLI를 사용하여 모든 베어메탈 서버를 나열하려면 ibmcloud is bare-metal-servers 명령을 사용하십시오. 특정 베어메탈 서버를 검색하려면 SERVER 변수를 사용하여 베어메탈 서버의 ID 또는 이름을 지정하십시오.

ibmcloud is bare-metal-server SERVER

명령 옵션의 전체 목록은 ibmcloud is bare-metal-server 를 참조하십시오.

CLI를 사용하여 베어 메탈 서버 재부팅하기

CLI를 사용하여 베어메탈 서버를 재부팅하려면 ibmcloud is bare-metal-server-restart 명령을 사용하세요. SERVER 변수를 사용하여 베어메탈 서버의 ID 또는 이름을 지정하십시오.

ibmcloud is bare-metal-server-restart SERVER

[-f, --force] 플래그는 확인 없이 오퍼레이션의 강제 실행을 표시합니다.

CLI를 사용하여 베어메탈 서버 중지 및 시작

CLI를 사용하여 베어메탈 서버를 중지하고 시작하려면 ibmcloud is bare-metal-server-stop 또는 ibmcloud is bare-metal-server-start 명령을 사용하세요. SERVER 변수를 사용하여 베어메탈 서버의 ID 또는 이름을 지정하십시오.

데이터 페이로드에서 중지 조치를 위해 type을(를) 지정해야 합니다. soft은(는) 실행 중인 운영 체제가 중지되고 완전히 종료되도록 지시합니다. hard은(는) Bare Metal 서버를 즉시 중지합니다.

베어 메탈 서버를 중지하려면 다음 명령어를 사용하십시오.

ibmcloud is bare-metal-server-stop SERVER --type soft

베어메탈 서버를 시작하려면 다음 명령을 사용합니다.

ibmcloud is bare-metal-server-start SERVER

베어 메탈 서버가 중지된 후에도 요금이 계속 청구됩니다.

명령 옵션의 전체 목록은 ibmcloud is bare-metal-server-restart를 참조하세요.

CLI를 사용하여 베어 메탈 서버 용량 확인하기

CLI를 사용하여 베어 메탈 서버 용량을 확인하려면 ibmcloud is bare-metal-server-capacities 명령을 사용하십시오. 이 명령을 통해 반환되는 정보는 참고용일 뿐이며, 용량을 할당하지는 않습니다. 용량 정보가 표시되며, 여기에는 사용 가능한 노드만 포함됩니다. 다른 곳에 할당되었거나 그 밖의 이유로 사용할 수 없는 노드는 용량 정보에 포함되지 않습니다.

선택적으로 --profile 옵션을 사용하여 베어 메탈 서버 프로필을 지정하거나, --zone 옵션을 사용하여 존을 지정하거나, 또는 두 가지 모두를 지정하여 결과를 필터링할 수 있습니다.

ibmcloud is bare-metal-server-capacities [--profile PROFILE] [--zone ZONE] [--output JSON] [-q, --quiet]

ibmcloud is bare-metal-server-capacities 명령을 사용할 때 다음 옵션을 지정할 수 있습니다.

  • --profile 기존 베어 메탈 프로필의 이름을 지정합니다.
  • --zone 존의 이름을 지정합니다(예: us-south-2).
  • --output 출력 형식을 지정합니다. JSON만 지원됩니다.
  • -q, --quiet 자세한 출력 정보를 억제합니다.

다음 출력 예시를 참조하십시오:

Profile Name  Availability Zones
profile-1     us-south-1,us-south-3
profile-2     us-south-2,us-south-3

CLI를 사용하여 베어 메탈 서버 업데이트하기

CLI를 사용하여 베어메탈 서버를 업데이트하려면 ibmcloud is bare-metal-server-update 명령을 사용합니다.

베어메탈 서버를 다시 초기화할 때 사용할 다음 변수를 지정합니다.

  • SERVER 베어 메탈 서버의 이름을 지정합니다
  • NAME 신뢰할 수 있는 프로필의 ID, 이름 또는 CRN
  • METADATA true 또는 false 을 지정하면 메타데이터 서비스가 활성화 또는 비활성화됩니다
  • PROTOCOL 메타데이터 서비스를 위한 프로토콜을 지정합니다.
ibmcloud is bare-metal-server-update SERVER --name NAME --enable-secure-boot true --metadata-service true --metadata-service-protocol https

명령 옵션의 전체 목록은 ibmcloud is bare-metal-server-update를 참조하세요.

CLI를 사용하여 베어 메탈 서버를 재초기화합니다

서버가 중지되고 로컬 스토리지가 프로비저닝된 경우에만 서버를 다시 초기화할 수 있습니다. 또는 서버 상태가 다음과 같은 경우 다시 초기화할 수 있습니다.failed 수명 주기 상태의 상태 이유는 다음과 같습니다.cannot_reinitialize. 베어메탈 서버가 다시 초기화되면 부팅 디스크의 내용이 지워지고 지정된 운영 체제가 설치됩니다. 서버는 동일한 물리적 노드, 인터페이스, IP 주소 및 리소스 ID를 유지합니다. 보조 드라이브의 데이터는 보존됩니다.

CLI를 사용하여 베어메탈 서버를 다시 초기화하려면 다음을 사용하세요.ibmcloud is bare-metal-server-initialization-replace 명령.

ibmcloud is bare-metal-server-initialization-replace SERVER --image IMAGE ---keys KEYS --user-data DATA [--default-trusted-profile DEFAULT_TRUSTED_PROFILE [--default-trusted-profile-auto-link true]]

베어메탈 서버를 다시 초기화할 때 사용할 다음 변수를 지정합니다.

  • SERVER 베어 메탈 서버의 이름을 지정합니다.
  • IMAGE 는 운영 체제 이미지를 지정합니다.
  • KEYS 는 SSH 키를 지정합니다.
  • DATA 는 선택적 사용자 데이터를 지정합니다.
  • PROFILE 신뢰할 수 있는 프로파일의 ID, 이름 또는 CRN입니다.
  • DEFAULT_TRUSTED_PROFILE 기본 신뢰할 수 있는 프로필 자동 링크 매개변수를 변경합니다.

기본_트러스티드_프로필을 사용하는 경우 베어메탈 서버를 다시 초기화할 때 기본_트러스티드_프로필에 정의된 것과 동일한 자동 링크 매개변수가 포함되어 재초기화 프로세스의 일부로 신뢰할 수 있는 프로필을 베어메탈 서버에 연결할지 여부를 결정합니다. 재초기화 프로세스 전에 이전에 베어메탈 서버에 연결되었던 신뢰할 수 있는 프로필은 계속 연결되어 있습니다. 재초기화 프로세스는 IAM 신뢰할 수 있는 프로필에 대한 링크를 제거하지 않습니다. 신뢰할 수 있는 프로필이 베어메탈 서버에 연결된 상태로 유지되지 않도록 하려면 "auto_link" 매개변수를 false로 변경하세요.

명령 옵션의 전체 목록은 다음을 참조하세요. ibmcloud는 베어메탈 서버 초기화 교체입니다..

CLI를 사용하여 베어메탈 서버의 펌웨어 업데이트

CLI(명령줄 인터페이스)를 사용하여 베어메탈 서버의 펌웨어를 업데이트할 수 있습니다. 중지되어 있고 펌웨어 업데이트를 사용할 수 있는 베어메탈 서버에서만 펌웨어를 업데이트할 수 있습니다. 펌웨어를 업데이트하기 전에 서버를 백업해 두는 것이 좋습니다.

CLI를 사용하여 베어메탈 서버의 펌웨어를 업데이트하려면 ibmcloud is bare-metal-server-firmware-update 명령을 사용하십시오. SERVER 변수를 사용하여 베어메탈 서버의 ID 또는 이름을 지정합니다.

auto-start 의 기본값은 true 입니다. 펌웨어가 업데이트된 후 베어메탈 서버가 시작되지 않도록 하려면 이 값을 false 로 변경해야 합니다.

ibmcloud is bare-metal-server-firmware-update SERVER --auto-start true

이 명령을 실행하면 펌웨어 업데이트를 진행할지 여부를 확인하는 메시지가 표시됩니다.

이 옵션은 서버의 BIOS 및 BMC 펌웨어를 업그레이드합니다. 계속하기 전에 서버를 백업하십시오. 이 작업이 진행되는 동안 서버를 사용할 수 없습니다. 계속하시겠습니까 (y/n)?

명령 옵션의 전체 목록은 ibmcloud is bare-metal-server-firmware-update 를 참조하십시오.

CLI를 사용하여 베어메탈 서버 삭제

CLI를 사용하여 베어메탈 서버를 삭제하려면 ibmcloud is bare-metal-server-delete 명령을 사용하세요. SERVER 변수를 사용하여 베어메탈 서버의 ID 또는 이름을 지정합니다.

ibmcloud is bare-metal-server-delete SERVER

삭제 조치는 서버 및 연결된 vNIC, 부트 볼륨, 데이터를 사용자 계정에서 영구적으로 제거합니다.

명령 옵션의 전체 목록은 ibmcloud is bare-metal-server-delete 를 참조하십시오.

API를 사용하여 베어메탈 서버 관리

API를 사용하여 베어 메탈 서버 확인하기

API를 사용하여 모든 베어메탈 서버를 나열하려면 모든 베어메탈 서버 나열 을 사용하십시오.

GET /bare_metal_servers 요청을 지정하여 모든 베어메탈 서버를 나열하십시오.

curl -X GET "$vpc_api_endpoint/v1/bare_metal_servers?version=2021-03-09&generation=2" \
-H "Authorization: Bearer $iam_token"

API를 사용하여 베어 메탈 서버를 복구합니다

API를 사용하여 베어메탈 서버를 검색하려면 바이어메탈 서버 검색 를 사용하세요.

GET /bare_metal_servers/{id} 요청을 지정하여 특정 베어 메탈 서버를 검색합니다. 여기서 id 는 검색하려는 베어 메탈 서버의 식별자입니다.

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"

API 요청에 대한 자세한 정보는 모든 베어메탈 서버 나열베어메탈 서버 검색을 참조하십시오.

API를 사용하여 베어 메탈 서버 용량 확인하기

API를 사용하여 베어 메탈 서버 용량을 확인하려면 GET /bare_metal_server/capacities 을 사용하십시오. 이 명령을 통해 반환되는 정보는 참고용일 뿐이며, 용량을 할당하지는 않습니다. 용량 정보가 표시되며, 여기에는 사용 가능한 노드만 포함됩니다. 다른 곳에 할당되었거나 그 밖의 이유로 사용할 수 없는 노드는 용량 정보에 포함되지 않습니다.

선택적으로 profile.name 속성을 사용하여 베어 메탈 서버 프로필을 지정하거나, zone.name 속성을 사용하여 영역을 지정하거나, 또는 두 가지를 모두 지정하여 결과를 필터링할 수 있습니다.

curl -X GET "$vpc_api_endpoint/v1/bare_metal_server/capacities?version=2026-05-05&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d "zone.name=us-south-1" \
-d "profile.name=myprofile"

베어 메탈 서버 용량을 필터링하는 데 사용할 다음 속성 값을 지정하십시오.

  • profile.name: 컬렉션에서 ‘ profile.name ’ 속성이 지정된 프로필 이름과 일치하는 리소스만 필터링합니다.
  • zone.name: 컬렉션에서 zone.name 속성의 값이 지정된 이름과 정확히 일치하는 리소스만 필터링합니다.

다음 출력 예시를 참조하십시오:

Profile Name  Availability Zones
profile-1     us-south-1,us-south-3
profile-2     us-south-2,us-south-3

API 요청에 대한 자세한 내용은 ‘베어 메탈 서버의 용량 목록’을 참조하십시오

API를 사용하여 베어 메탈 서버 재부팅하기

API를 사용하여 베어메탈 서버를 재부팅하려면 바이어메탈 서버 재시작 를 사용하세요.

특정 베어 메탈 서버를 다시 시작하기 위한 POST /bare_metal_servers/{id}/restart 요청을 지정합니다. 여기서 id 는 다시 시작하려는 베어 메탈 서버의 식별자입니다.

curl -X POST "$vpc_api_endpoint/v1/bare_metal_servers/$bare_metal_server_id/restart?version=2021-03-09&generation=2" \
-H "Authorization: Bearer $iam_token"

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

API를 사용하여 베어메탈 서버 중지 및 시작

API를 사용하여 베어메탈 서버를 중지하거나 시작하려면 바이어메탈 서버 중지바이어메탈 서버 시작 를 사용하세요.

베어메탈 서버를 중지하거나 시작하려면 다음 API 요청을 사용하십시오.

API를 사용하여 베어 메탈 서버 중지하기

POST /bare_metal_servers/{id}/stop 요청을 지정하여 특정 베어 메탈 서버를 중지합니다. 여기서 id 는 중지하려는 베어 메탈 서버의 식별자입니다.

데이터 페이로드에서 중지 조치를 위해 type을(를) 지정해야 합니다. soft은(는) 실행 중인 운영 체제가 중지되고 완전히 종료되도록 지시합니다. hard은(는) Bare Metal 서버를 즉시 중지합니다.

curl -X POST "$vpc_api_endpoint/v1/bare_metal_servers/$bare_metal_server_id/stop?version=2021-03-09&generation=2" \
-H "Authorization: Bearer $iam_token"
-d '{
        "type": "soft"
}'

비용 청구는 베어메탈 서버가 중지된 후에도 계속됩니다.

API 요청에 대한 자세한 정보는 베어메탈 서버 중지를 참조하십시오.

API를 사용하여 베어 메탈 서버 시작하기

POST /bare_metal_servers/{id}/start 요청을 지정하여 특정 베어 메탈 서버를 시작합니다. 여기서 id 는 시작하려는 베어 메탈 서버의 식별자입니다.

curl -X POST "$vpc_api_endpoint/v1/bare_metal_servers/$bare_metal_server_id/start?version=2021-03-09&generation=2" \
-H "Authorization: Bearer $iam_token"

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

API를 사용하여 베어 메탈 서버 업데이트하기

특정 베어메탈 서버를 업데이트하려면 PATCH /bare_metal_servers/{id} 요청을 지정하세요. 여기서 id 은 업데이트하려는 베어메탈 서버의 식별자입니다.

curl -X PATCH "$vpc_api_endpoint/v1/bare_metal_servers/$bare_metal_server_id?version=2025-05-13&generation=2" -H "Authorization: Bearer $iam_token" -d '{
  "name": "my-bare-metal-server-updated"
  "metadata_service": {
     "enabled": true,
     "protocol": "https"
  }
}'

베어메탈 서버를 업데이트할 때 사용할 다음 속성 값을 지정합니다.

  • name 베어 메탈 서버의 이름을 지정합니다
  • metadata_service 는 서비스 활성화 여부와 사용할 프로토콜을 지정합니다.

API 요청에 대한 자세한 내용은 ‘베어 메탈 서버 업데이트’를 참조하십시오.

API를 사용하여 베어 메탈 서버를 재초기화합니다

API를 사용하여 베어메탈 서버를 다시 초기화하려면 베어메탈 서버 초기화 를 사용하세요.

서버가 중지되고 로컬 스토리지가 프로비저닝된 경우에만 서버를 다시 초기화할 수 있습니다. 또는 서버 상태가 다음과 같은 경우 다시 초기화할 수 있습니다.failed 수명 주기 상태의 상태 이유는 다음과 같습니다.cannot_reinitialize. 베어메탈 서버가 다시 초기화되면 부팅 디스크의 내용이 지워지고 지정된 운영 체제가 설치됩니다. 서버는 동일한 물리적 노드, 인터페이스, IP 주소 및 리소스 ID를 유지합니다. 보조 드라이브의 데이터는 보존됩니다.

지정 PUT /bare_metal_servers/{id}/initialization 베어메탈 서버를 다시 초기화하도록 요청합니다.

curl -X PUT "$vpc_api_endpoint/v1/bare_metal_servers/$bare_metal_server_id/initialization?version=2021-03-09&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
	  "image": {
		"id": $image
	  },
	  "keys": [
		{
			"id": $key
		}
	  ],
	  "default_trusted_profile": {
		"auto_link": true,
		"target": {
			"id": $trusted_profile
		}
	  }
}'

베어메탈 서버를 다시 초기화할 때 사용할 다음 속성 값을 지정합니다.

  • name 베어 메탈 서버의 이름을 지정합니다
  • image 운영 체제 이미지를 지정합니다.
  • keys SSH 키를 지정합니다
  • user_data 선택적 사용자 데이터를 지정합니다.
  • default_trusted_profile 기본 신뢰할 수 있는 프로필을 변경하거나 제거합니다

default_trusted_profile 를 사용하는 경우 베어메탈 서버를 재초기화할 때 default_trusted_profile 에 정의된 것과 동일한 "auto_link" 매개변수가 포함되어 재초기화 프로세스의 일부로 신뢰할 수 있는 프로필을 베어메탈 서버에 연결할지 여부를 결정합니다. 재초기화 프로세스 전에 이전에 베어메탈 서버에 연결되었던 신뢰할 수 있는 프로필은 계속 연결되어 있습니다. 재초기화 프로세스는 IAM 신뢰할 수 있는 프로필에 대한 링크를 제거하지 않습니다. 신뢰할 수 있는 프로필이 베어메탈 서버에 연결된 상태로 유지되지 않도록 하려면 "auto_link" 매개변수를 false 로 변경하세요.

API를 사용하여 베어메탈 서버의 펌웨어 업데이트

중지되어 있고 펌웨어 업데이트를 사용할 수 있는 베어메탈 서버에서만 펌웨어를 업데이트할 수 있습니다. 펌웨어를 업데이트하기 전에 서버를 백업하는 것이 좋습니다. API를 사용하여 펌웨어를 업데이트하려면 베어 메탈 서버용 펌웨어 업데이트 를 사용하세요.

특정 베어 메탈 서버의 펌웨어를 업데이트하기 위한 POST /bare_metal_servers/{id}/firmware/update 요청을 지정합니다. 여기서 id 는 업데이트하려는 베어 메탈 서버의 식별자입니다.

auto_start 의 기본값은 true 입니다. 펌웨어 업데이트 후 베어메탈 서버를 시작하지 않으려면 이 값을 false 으로 변경해야 합니다.

curl -X POST "$vpc_api_endpoint/v1/bare_metal_servers/$bare_metal_server_id/firmware/update?version=$tomorrow&generation=2&maturity=beta" -H "Authorization: Bearer $iam_token" -d '{
  "auto_start": false
}'

API를 사용하여 베어메탈 서버 삭제

API를 사용하여 베어메탈 서버를 삭제하려면 베어메탈 서버 삭제 를 사용하세요.

DELETE /bare_metal_servers/{id} 요청을 지정하여 특정 베어 메탈 서버를 삭제합니다. 여기서 id 는 삭제하려는 베어 메탈 서버의 식별자입니다.

curl -X DELETE "$vpc_api_endpoint/v1/bare_metal_servers/$bare_metal_server_id?version=2021-03-09&generation=2" \
-H "Authorization: Bearer $iam_token"

삭제 조치는 서버 및 연결된 vNIC, 부트 볼륨, 데이터를 사용자 계정에서 영구적으로 제거합니다.

Terraform을 활용한 베어메탈 서버 관리

Terraform for VPC를 설정했는지 확인하십시오.

Terraform을 사용하여 베어메탈 서버 보기

Terraform을 사용하여 베어메탈 서버를 보려면 ibm_is_bare_metal_server 리소스를 사용하세요.

data "ibm_is_bare_metal_server" "example" {
  identifier        = "9328-9849-9849-9849"
}

자세한 내용은 ibm_is_bare_metal_server 를 참조하세요.

모든 베어 메탈 서버의 목록을 보려면 ibm_is_bare_metal_servers 리소스를 사용하세요.

data "ibm_is_bare_metal_servers" "example" {
}

자세한 내용은 ibm_is_bare_metal_servers 를 참조하세요.

Terraform을 사용하여 베어메탈 서버 재시작하기

Terraform을 사용하여 베어메탈 서버를 다시 시작하려면 ibm_is_bare_metal_server_action 리소스를 사용해야 합니다.

resource "ibm_is_bare_metal_server_action" "bms_action" {
  bare_metal_server = SERVER
  action            = "restart"
}

베어메탈 서버를 다시 초기화할 때 사용할 다음 변수를 지정합니다.

  • SERVER 베어 메탈 서버의 이름을 지정합니다
  • restart 은 서버에 대한 작업을 지정합니다

명령 옵션의 전체 목록은 ibm_is_bare_metal_server_action 를 참조하세요.

Terraform을 사용하여 베어메탈 서버 중지 및 시작하기

Terraform을 사용하여 베어메탈 서버를 중지하려면 ibm_is_bare_metal_server_action 리소스를 사용해야 합니다.

resource "ibm_is_bare_metal_server_action" "bms_action" {
  bare_metal_server = SERVER
  action            = "stop"
  stop_type         = "hard"
}

Terraform을 사용하여 베어메탈 서버를 시작하려면 ibm_is_bare_metal_server_action 리소스를 사용해야 합니다.

resource "ibm_is_bare_metal_server_action" "bms_action" {
  bare_metal_server = SERVER
  action            = "stop"
  delete_type       = "hard"
}

베어메탈 서버를 다시 초기화할 때 사용할 다음 변수를 지정합니다.

  • SERVER 베어 메탈 서버의 이름을 지정합니다
  • stop 또는 start 는 서버에 대한 작업을 지정합니다
  • hard 은 서버를 중지하는 데 특화되어 있으며 중지 유형을 나타냅니다. hard 를 지정하면 서버가 즉시 중지되고 soft 은 운영 체제가 종료됩니다.

명령 옵션의 전체 목록은 ibm_is_bare_metal_server_action 를 참조하세요.

Terraform을 사용하여 베어메탈 서버 초기화하기

서버가 중지되고 로컬 스토리지가 프로비저닝된 경우에만 서버를 다시 초기화할 수 있습니다. 또는 서버 상태가 다음과 같은 경우 다시 초기화할 수 있습니다.failed 수명 주기 상태의 상태 이유는 다음과 같습니다.cannot_reinitialize. 베어메탈 서버가 다시 초기화되면 부팅 디스크의 내용이 지워지고 지정된 운영 체제가 설치됩니다. 서버는 동일한 물리적 노드, 인터페이스, IP 주소 및 리소스 ID를 유지합니다. 보조 드라이브의 데이터는 보존됩니다.

Terraform을 사용하여 베어메탈 서버를 다시 초기화하려면 리소스 명령 ibm_is_bare_metal_server_initialization 을 사용해야 합니다.

resource "ibm_is_bare_metal_server_initialization" "reinitialize" {
  bare_metal_server = SERVER
  user_data         = DATA
  keys              = KEYS
  image             = "IMAGE"
  default_trusted_profile {
      auto_link = true
      target {
          id = "Profile-a2075c9d-c69f-404f-8488-7962a383059c"
      }
  }
}

베어메탈 서버를 다시 초기화할 때 사용할 다음 변수를 지정합니다.

  • SERVER 베어 메탈 서버의 이름을 지정합니다
  • DATA 선택적 사용자 데이터를 지정합니다.
  • KEYS SSH 키를 지정합니다
  • IMAGE 운영 체제 이미지를 지정합니다.
  • Default Trusted Profile 자동 링크 활성화 여부를 지정합니다

동일한 물리적 노드, 인터페이스, IP 주소 및 리소스 ID를 유지할 수 있지만 lifecycle 속성을 사용하여 이러한 변경을 피하도록 선택할 수도 있습니다.

명령 옵션의 전체 목록은 ibm_is_bare_metal_server_initialization 를 참조하세요.

resource "ibm_is_bare_metal_server_initialization" "reinitialize" {
  bare_metal_server = SERVER
  user_data         = DATA
  keys              = KEYS
  image             = "IMAGE"
}
## to avoid changes on the ibm_is_bare_metal_server resource, use lifecycle meta argument ignore_changes
resource "ibm_is_bare_metal_server" "bms" {
  ....
  lifecycle{
    ignore_changes = [ image, keys, user_data ]
  }
}

Terraform을 사용하여 베어메탈 서버 삭제하기

Terraform을 사용하여 베어메탈 서버 리소스를 삭제하려면 ibm_is_bare_metal_server 리소스를 사용해야 합니다.

resource "ibm_is_bare_metal" "server" {
  delete_type          = "hard"
}

베어메탈 서버를 삭제할 때 사용할 다음 변수를 지정합니다.

  • hard 은 서버를 즉시 중지하고 삭제하는 hard 삭제를 지정합니다. 다른 옵션은 운영 체제를 종료하는 soft 삭제입니다.

명령 옵션의 전체 목록은 ibm_is_bare_metal_server 를 참조하세요.