Managing Bare Metal Servers for VPC

You can manage your IBM Cloud® Bare Metal Servers for VPC by performing tasks such as start, stop, restart, and delete bare metal server.

You can perform the following actions by using the UI, API, or CLI:

Table 1. Actions available for bare metal servers
Action	Description
Stop	Stop the server using a soft stop or a hard stop. Soft stop can take a few seconds to several minutes to stop shut down the server, depending on the state of the operating system. If the operating system is not responding and the soft stop can not complete, a hard stop is required. Hard stop shuts down the bare metal server immediately. This prevents the operating system from shutting down gracefully.
Start	Start a stopped server. This action is not available if the status is Running.
Reboot	Immediately powers off a running server and then powers it back on.
Delete	To delete a server, the server must be powered off. If the server has a floating IP address, the floating IP address must be unassociated or released before the server is deleted. The delete action permanently removes a server and its connected vNIC, boot volume, and data from your account.

Managing bare metal servers by using the UI

You can view and manage your bare metal server from the Bare metal servers page in the IBM Cloud dashboard.

To manage your servers, complete the following steps.

In IBM Cloud dashboard, go to Navigation Menu icon > VPC Infrastructure > Compute > Bare metal servers.
On the Bare metal servers page, click the Actions icon for the server that you want to manage. You can perform the following actions:

Viewing your bare metal servers

You can view the summary of all bare metal server on the bare metal server page, or you can click an individual server name to view details and make changes. From the details page, you can also view the associated network interface, access its subnet, and reserve or delete a floating IP address.

In the IBM Cloud dashboard , go to Navigation Menu icon > VPC Infrastructure > Compute > Bare metal servers
Click the name of the bare metal server that you want to view.

Rebooting a bare metal server

The reboot action immediately powers off and powers on the bare metal server.

In the IBM Cloud dashboard , go to Navigation Menu icon > VPC Infrastructure > Compute > Bare metal servers
Click the name of the bare metal server that you want to reboot.
Click Actions..., then click Reboot.

Stopping and starting a bare metal server

In the IBM Cloud dashboard , go to Navigation Menu icon > VPC Infrastructure > Compute > Bare metal servers
Click the name of the bare metal server that you want to start or stop.
Click Actions..., then click Stop or Start. When selecting Stop, select hard stop or soft stop. The instance will soft stop by default.

Billing continues after the bare metal server is stopped.

Deleting a bare metal server

In the IBM Cloud dashboard , go to Navigation Menu icon > VPC Infrastructure > Compute > Bare metal servers
Click the name of the bare metal server that you want to delete.
Click Actions..., then click Delete.

The delete action permanently removes a server and its connected vNIC, boot volume, and data from your account.

Managing your bare metal server by using the CLI

Viewing your bare metal servers

Use the following command to list all bare metal servers:

ibmcloud is bare-metal-servers [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups]

Use the following command to retrieve a bare metal server:

ibmcloud is bare-metal-server $bare_metal_server_id

Rebooting a bare metal server

Use the following CLI command to reboot your bare metal server.

ibmcloud is bare-metal-server-restart $bare_metal_server_id [-f, --force] [-q, --quiet]

The [-f, --force] flag forces the operation without confirmation.

Stopping and starting a bare metal server

Use the following CLI command to stop and start your bare metal server.

To stop the bare metal server:

ibmcloud is bare-metal-server-stop $bare_metal_server_id [--type soft | hard] [-f, --force] [-q, --quiet]

To start the bare metal server:

ibmcloud is bare-metal-server-start $bare_metal_server_id [-q, --quiet]

Billing continues after the bare metal server is stopped.

Deleting a bare metal server by using the CLI

Use the following CLI command to delete your bare metal server.

ibmcloud is bare-metal-server-delete $bare_metal_server_id

The delete action permanently removes a server and its connected vNIC, boot volume, and data from your account.

Managing your bare metal server by using the API

Viewing your bare metal servers

Use the following API request to list all bare metal servers:

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

Use the following API request to retrieve a bare metal server:

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

For more information of the API requests, see List all bare metal servers and Retrieve a bare metal server.

Rebooting the bare metal server

Use the following API request to reboot your bare metal server.

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

For more information of the API request, see Restart a bare metal server.

Stopping and starting a bare metal server

Use the following API requests to stop or start a bare metal server.

Stopping the bare metal server

Use the following API request to stop your bare metal server.

You must specify the type for the stop action in the data payload. soft tells the running operating system to stop and shut down cleanly. hard immediately stops the bare metal server.

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

Billing continues after the bare metal server is stopped.

For more information about the API request, see Stop a bare metal server.

Starting the bare metal server

Use the following API request to start your bare metal server.

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

For more information about the API request, see Start a bare metal server.

Deleting a bare metal server by using the API

Use the following API request to delete your bare metal server.

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

The delete action permanently removes a server and its connected vNIC, boot volume, and data from your account.

For more information about the API request, see Delete a bare metal server.